Order Definition

Orders returned by the Tophatter Merchant API have the following fields:

Field	Name
`order_id`	The ID of the order.
`status`	The status of the order. The status will be one of: `refunded`, `shipped` (already fulfilled), or `paid` (ready to fulfill).
`carrier`	The carrier (USPS, China EMS, etc) used to ship this order. The list of accepted carries can be found here.
`tracking_number`	The tracking number provided by the carrier when this order was shipped.
`service_type`	The granularity of tracking updates the carrier will provide for this tracking number. The list of supported service types per carrier can be found here. The full set of service types can be found here.
`fulfillment_partner`	The 3PL or warehouse partner being used to fulfill this order. Example: `noram`.
`product_name`	The name of the product.
`product_identifier`	The unique id of the product.
`product_internal_id`	Tophatter's internal identifier for the product.
`variation_identifier`	The unique id of the product variation selected by the customer during the checkout process.
`variation_internal_id`	Tophatter's internal identifier for the product variation chosen by the customer during the checkout process.
`customer_id`	The unique ID of the customer.
`customer_name`	The full name of the customer.
`address1`	Shipping address line 1.
`address2`	Shipping address line 2.
`city`	Shipping address city.
`state`	Shipping address state.
`postal_code`	Shipping address postal code.
`country`	Shipping address country.
`available_refunds`	The partial refunds available for this order. When you wish to partially refund an order you must specify on or more of these fees to refund. See the refund an order documentation for more info.
`refund_amount`	The amount refunded to the customer for this order.
`disbursement_amount`	The total amount that will be paid out (disbursed) to the seller for this order.
`seller_fees_amount`	The total amount of the fees charged to the seller for this order.
`seller_fees`	The breakdown of the fees charged to the seller for this order.
`upsells`	The upsells for this product that were purchased by the customer.
`product_quantity`	The quantity of product for this order. If a buyer purchased Buy One Get One same price then the `product_quantity` for the order will be 2.
`created_at`	The date and time the order was created in PDT (UTC -7).
`paid_at`	The date and time the order was paid by the customer in PDT (UTC -7).
`fulfillment_due_date`	The date by which this order must be fulfilled. If the order is not fulfilled by this date then it is considered late and the customer will be refunded upon request.
`refunded_at`	The date and time the order was refunded to the customer in PDT (UTC -7). If the order has not been refunded this field will be `null`.
`canceled_at`	The date and time order was canceled by the customer in PDT (UTC -7). If the order has not been canceled this field will be `null`.

Examples

{  
    "order_id": 59010920,
    "status": "paid",
    "carrier": null,
   	"service_type": null,
    "tracking_number": null,
    "product_name": "Nintendo Switch - Neon Blue and Red Joy-Con",
    "product_identifier": "B01MUAGZ49",
    "product_internal_id": 9871345,
    "variation_identifier": "B01MUAGZ49",
    "variation_internal_id": 85741897,
    "customer_id": 19724374,
    "customer_name": "John Doe",
    "address1": "123 Main Street",
    "address2": "Apartment 42",
    "city": "Denver",
    "state": "CO",
    "postal_code": "80219",
    "country": "USA",
    "available_refunds": {  
       "buyer_fee": 275.0
    },
    "refund_amount": 0,
    "disbursement_amount": "239.22",
    "seller_fees_amount": 35.78,
    "seller_fees": [  
       {  
          "type": "commission_fee",
          "amount": 27.5
       },
       {  
          "type": "processing_fee",
          "amount": 8.28
       }
    ],
   	"upsells": [],
   	"product_quantity":1,
    "created_at": "2018-03-29T17:04:17-07:00",
   	"updated_at": "2018-09-26T11:05:09-07:00",
    "paid_at": "2018-03-29T17:04:20-07:00",
    "fulfillment_due_date": "2018-04-04",
    "refunded_at": null,
    "canceled_at": null
 }

Order Statuses

Orders will have one of the following statuses:

refunded: The order has been refunded.
shipped: The order has been fulfilled.
paid: The order is waiting to be fulfilled.