Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

FieldTypeComment
labelshashthis hash contains all the labels for the various fields below. This hash is powerful because it contains the mappings you specify in the back end "screen branding' section. See the order labels section for individual listings.
merchantIdstringyour merchant id
customerProfileIdintcustomer's internal identifier
orderIdstringorder id
rejectedbooleantrue if the order was rejected
themeCodestringthe theme code applied to this order. See screen branding. This code is often used when creating buy links to apply the proper look and feel to an order page. Some merchants only have one theme. Some merchants have 50.
creationDatestringISO-8601 format. When the order was created
creationDateFormattedstringDD-MMM-YYYY format. When the order was created
shipOnDatestringISO-8601 format. When the order was requested to ship on.
shipOnDateFormattedstringDD-MMM-YYYY format. When the order was requested to ship on.
saturdayDeliverybooleantrue if the order is set for Saturday delivery
rejectedDatestringISO-8601 format. When the order was rejected (null if it hasn't been)
rejectedDateFormattedstringDD-MMM-YYYY format of when the order was rejected, if it was.
quoteExpirationDatestringISO-8601 format. If this order is a quote, when the quote expires.
quoteExpirationDateFormattedstringDD-MMM-YYYY format. If this order is a quote, when the quote expires.
statusstringCompleted, Rejected, Quote Sent, Quote Requested, Pre-Order Item, Pending
testOrderbooleantrue if this order was a test
shippingMethodstring a bare bones description of the shipping method
shippingMethodNamestring a friendly version of the shipping method. This should be preferred for display over shippingMethod
shippingMethodDetailedstringan elaborate string contain shippingMethodName and any features such as lift gates and ship to residential,  
shippingMethodCompanystringUPS, FedEx, etc. 
shipping3rdPartyAccountNumberstring
emailstring
ccEmailsstring[ ]an array of email addresses who were cc'd on the order.  
giftEmailstringthe gift recipient's email address 
billToCompanystring
billToTitlestring
billToFirstNamestring
billToLastNamestring
billToAddress1string
billToAddress2string
billToCitystring
billToStatestring
billToPostalCodestring
billToCountrystring
billToDayPhonestring
billToEveningPhonestring
shipToCompanystring
shipToTitlestring
shipToFirstNamestring
shipToLastNamestring
shipToAddress1string
shipToAddress2string
shipToCitystring
shipToStatestring
shipToPostalCodestring
shipToCountrystring
shipToDayPhonestring
shipToEveningPhonestring
giftbooleantrue if the order is a gift
liftGatebooleantrue if the order requires a lift gate to deliver.
shipToResidentialbooleantrue if the delivery is a residence
hidePaymentInformationbooleanwhether or not to show payment information. Imagine the scenario where the cost is zero and/or gift certificates were used.
refundPresentbooleanduplicate of hasRefund. Use hasRefund, as this field is deprecated and will be removed without warning.
taxShippingbooleanis shipping taxed? this affects the display of subtotal information (tax before subtotal or subtotal before tax).
taxCountystring
referralCodestring
advertisingSourcestring
paymentMethodstring

Credit Card, PayPal Order, etc.

Supported payment methods as of 6/2013 (list may change):

Check
Credit Card
Credit Card Fax In
PayPal
eCheck
Purchase Order
Unknown
Money Order
Wire Transfer
COD
CASH
SafetyPay
Amazon SC
SkyMall
Smart Bargains
Sofort
Quote Request

paymentNotestringA friendly working of the paymentMethod. For display purposes, use this value instead of paymentMethod. It will always read the same or better.
cardTypestringThe type of credit card used. VISA, MasterCard, etc.
cardNumberstringmasked. last four digits.
couponsCouponThe coupon class contains two simple fields: code and description
itemsItem[ ]The items for this order
giftWrapTitlestringthe name of the gift wrap
giftWrapCost / giftWrapCostFormattednumber / string
hasDiscountbooleantrue if a discount was made somewhere (often useful for adding an extra table column, etc.)
hasRefundbooleantrue if a refund was made somewhere (often useful for adding an extra table column, etc.)
subtotalBeforeDiscount / subtotalBeforeDiscountFormattednumber / string
discount / discountFormattednumber / string
subtotal / subtotalFormattednumber / stringsubtotal with any discounts and refunds already applied
subtotalRefunded / subtotalRefundedFormattednumber / string
taxRate / taxRateFormattednumber / string
shippingHandlingDiscount / shippingHandlingDiscountFormattednumber / string
shippingHandlingTotal / shippingHandlingTotalFormattednumber / stringtotal with any discounts and refunds already applied.
shippingHandlingRefunded / shippingHandlingRefundedFormattednumber / string
tax / taxFormattednumber / stringtax with any refund already applied
taxRefunded / taxRefundedFormattednumber / string
giftCharge / giftChargeFormattednumber / string
surcharge / surchargeFormattednumber / string
showBuysafebooleantrue if this order used buySAFE and the amounts should be shown.
buysafeCost / buysafeCostFormattednumber / string
buysafeRefunded / buysafeRefundedFormattednumber / string
showInsureShipboolean

true if this order used InsureShip and the amounts should be shown.

Note

InsureShip is no longer available. This would only apply to old legacy orders. It's doubtful you need to consider this field.

insureShipCost / insureShipCostFormattednumber / stringinsure ship cost
insureShipRefunded / insureShipRefundedFormattednumber / stringvalue of any insure ship refunded
total / totalFormattednumber / stringgrand total
totalRefunded / totalRefundedFormattednumber / stringof the total, this amount was refunded
showCurrencyWarningbooleantrue if the currency warning (next line) should be shown.
currencyWarningstringthis is the standard currency warning if the order was placed in a different currnency. It contains a nicely formatted message to show to the customer.
giftCertificateCodestringthe gift certificate code. If the gift certificate was a credit card type, the code will be masked.
giftCertificateAmount / giftCertificateAmountFormattednumber / stringthe amount used of the gift certificate
giftMessagestring[ ]

array of gift message lines

when this field was entered, newlines were captured to preserve the look. so this field is an array of strings broken by newlines. You may join them or iterate them as desired.

specialInstructionsstring[ ]

array of special instructions text

when this field was entered, newlines were captured to preserve the look. so this field is an array of strings broken by newlines. You may join them or iterate them as desired.

commentsstring[ ]

array of comments

when this field was entered, newlines were captured to preserve the look. so this field is an array of strings broken by newlines. You may join them or iterate them as desired.

trackingNumbersstring[ ]array of tracking numbers
orderCaseCaseSee the case object above. If there is a case (customer feedback) associated with this order, it will be populated in this value.

...