AfterShip Shipping Common Scenario

This document will describe several common usage scenarios for AfterShip Shipping, provided for your reference.


The first step is to import your order into AfterShip system, you can import the your order with order endpoints.

FieldDescriptionSample
source_idThe unique identifier of the order. For most of the case it should be the same as the order ID of your system.CM1011
numberThe order nameCM1011
currencyThe curreny of the orderUSD
statusThe status of the orderopen
financial_statusThe status of payments associated with the orderpaid
fulfillment_statusThe status of fulfillment associated with the orderunfulfilled
order_totalThe total price of the order9.5
itemsItems of order-
items.*.source_idA unique identifier for the line item in your system9716591689898
items.*.titleThe title of the product variantMobile Phone Case
items.*.quantityThe number of items that have been purchased1
items.*.fulfillable_quantityTotal items available to fulfill1
items.*.origin_country_regionThe origin country of this productHKG
items.*.unit_pricefieldThe price of the item before discounts and taxes applies5
items.*.unit_weightThe item's weight-
items.*.unit_weight.unitThe weight unitlb
items.*.unit_weight.valueThe weight value10
customerCustomer information object-
customer.first_nameThe customer's first nameJohn
customer.last_nameThe customer's last nameDoe
customer.emailsThe customer's email array["[email protected]"]
source_created_atThe date and time (ISO 8601 format) when an order was created2023-02-16T01:00:10Z
source_updated_atThe date and time (ISO 8601 format) when an order was updated.2023-02-16T01:00:10Z
shipping_addressShipping address object-
shipping_address.first_nameThe customer’s first nameJohn
shipping_address.last_nameThe customer’s last nameDoe
shipping_address.address_line_1The customer's mailing address28292 Daugherty Orchard
shipping_address.cityThe customer’s city, town, or villageacramento
shipping_address.stateThe customer’s region name. Typically a province, a state, or a prefectureCA
shipping_address.country_regionThe customer's country or regionUSA
shipping_address.postal_codeThe customer’s postal code, also known as zip, postcode, Eircode, etc94209
shipping_address.emailThe unique email address of the customer[email protected]
shipping_address.typeThe type of addressbusiness

Here is a sample request for creating orders, along with the payload required to use AfterShip Shipping:

After successfully importing the orders as detailed in the previous example, you can proceed to manage the imported orders and create labels in the AfterShip Shipping. Please be aware that some carriers might demand additional fields to generate labels. If you encounter issues creating labels for imported orders, do not hesitate to contact us for support.