Create new shipment

To use this endpoint an “allocation” must exist for the order that’s being shipped. When an order is placed, fabric sends allocation details to external merchant system to create order fulfillment requirement details in an external system. With reference to the allocation that’s being shipped, users of this POST API can create shipment details for allocations.

Note: Shipment ID generated as part of the response is required for subsequent calls such as Acknowledge shipment (POST /shipments/{shipmentId}/acknowledge) and Get shipment (GET /shipments/{shipmentId}).

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-fabric-tenant-id

string

required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

x-fabric-channel-id

string

required

x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.

x-fabric-request-id

string

Unique request ID

Body

application/json

Details to create shipment

allocationId

string

required

Allocation ID for this shipment, generated by the fabric Allocation service through Create allocation (internal) endpoint, which occurs prior to Shipment Creation. This is mandatory to create a new shipment.

Example:

"112345678912340"

shipmentNumber

string

required

Merchant-defined shipment identifier

Example:

"78974156816152"

attributes

object

Merchant-defined custom attributes. This is a placeholder for addition info (in key: value pairs)

Example:

{ "attribute1": "value" }

cartons

object[]

Carton details

Carton details

Show child attributes

cartons.cartonNumber

string

Merchant-defined unique identifier. This can optionally be generated by fabric by using the resource generator feature of the Configuration service.

Example:

"1"

cartons.cartonType

string

Carton type

Example:

"Package"

cartons.estimatedDeliveryDate

string

Estimated delivery date given by carrier (UTC). It's based on several factors including selected shipping method and delivery location.

Example:

"2023-03-26T07:58:30.996Z"

cartons.estimatedShipDate

string

Estimated ship date given by carrier (UTC)

Example:

"2023-03-25T07:58:30.996Z"

cartons.items

object[]

Item

Item details

Show child attributes

cartons.items.lineItemId

string

required

Unique number assigned by merchant to identify each item in an order. When this value isn't provided, fabric will auto generate (in UUID format) during order creation.

Example:

"1"

cartons.items.shippedQuantity

integer

required

Shipped quantity of given item

Required range: x >= 0

Example:

2

cartons.items.attributes

object

Merchant-defined custom attributes. This is a placeholder for addition info (in key: value pairs)

Example:

{ "attribute1": "value" }

cartons.items.fees

object[]

Return fee details

Return fee details

Show child attributes

cartons.items.fees.amount

number

Merchant-defined return amount

Example:

34.56

cartons.items.fees.name

string

Fee name

Example:

"RETURN_FEE"

cartons.items.fees.reason

string

Merchant-defined return reason

Example:

"Return fee"

cartons.items.fees.type

enum<string>

Return fee type

Available options:

TAX,

DISCOUNT,

FEE,

ITEM,

ADJUSTMENT

Example:

"FEE"

cartons.items.giftCards

object[]

Gift card details

Gift card details

Show child attributes

cartons.items.giftCards.amount

number

Gift card amount

Example:

50

cartons.items.giftCards.giftCardNumber

string

Gift card number

Example:

"453456765"

cartons.items.itemId

integer

Unique item identifier from fabric Products service

Example:

100023

cartons.items.orderId

string

24-character system-generated ID displayed in the response of Create Order endpoint - POST /orders

Example:

"6413e370cb0dc859b6c0dcb0"

cartons.items.orderNumber

string

Merchant-defined order identifier

Example:

"309020213"

cartons.items.orderedQuantity

integer

Ordered quantity of given item

Required range: x >= 0

Example:

2

cartons.items.refundAmount

number

Return amount. Applicable for return shipment scenarios.

Example:

10

cartons.items.returnQuantity

integer

Returned quantity of given item. Applicable for return shipment scenarios.

Required range: x >= 0

Example:

1

cartons.items.returnRequestCounter

integer

Number of times return request is made for the given order. Applicable only for return shipment scenario.

Example:

1

cartons.items.segment

string

Item segment

Example:

"segment"

cartons.items.sku

string

Stock keeping unit (SKU), unique item identifier

Example:

"SKU0023"

cartons.items.uom

string

Unit in which a product is measured or sold. UOM can be set to 'each' (EA) or GAL (Gallon), DZ (Dozen), etc.

Example:

"EA"

cartons.items.vendorId

string

Vendor ID. Applicable in dropshipping scenarios to indicate the vendor responsible for the given item.

Example:

"56"

cartons.promisedDeliveryDate

string

Promised delivery date given by seller (UTC)

Example:

"2023-03-26T07:58:30.996Z"

cartons.shipmentCarrier

string

Shipment carrier

Example:

"FEDEX"

cartons.shipmentMethod

string

Shipment method

Example:

"ground"

cartons.tracking

object[]

Tracking details

Shipment tracking details

Show child attributes

cartons.tracking.event

string

Shipment-specific event. Mandatory in the request body of Update shipment tracking - POST /shipments/actions/update-tracking endpoint

Example:

"picked up"

cartons.tracking.eventId

string

Event ID provided by carrier

Example:

"627963716b19511e8a3a631b"

cartons.tracking.eventRecordedAt

string

Time event was recorded (UTC)

Example:

"2019-09-30T07:58:30.996Z"

cartons.tracking.location

string

Delivery location

Example:

"Reno, NV"

cartons.tracking.notes

object

Attributes to save any additional info

Show child attributes

cartons.tracking.notes.{key}

string

Attributes to save any additional info

Example:

"{\"description\":\"Shipment picked up\"}"

Example:

{ "description": "Shipment picked up" }

cartons.tracking.shipmentCarrier

string

Shipment carrier

Example:

"FEDEX"

cartons.trackingNumber

string

Merchant-defined shipment tracking number for the given carton. Used for tracking shipment, also for updating tracking status of given carton.

Example:

"1Z999AA10123456784"

cartons.trackingURL

string

Shipment tracking URL for the given carton

Example:

"https://fedex.com/tracking"

cartons.weight

string

Carton weight

Example:

"500 gram"

invoiceId

string

Invoice ID generated from fabric Invoice service during shipment creation. Note: Invoices are only created for Shipments where merchants have payment Capture at Shipment feature enabled. The value will be “Null” if merchants don't have “Capture at Shipment” feature enabled.

Example:

"63ef4360aafa8a7f5247fe48"

locationNumber

string

Unique value to identify ship-from location. This must be the locationNumber stored in the fabric Location service.

Example:

"132412"

locationType

string

Location type, such as distribution center (DC) or warehouse. This must be the type stored in the fabric Location service.

Example:

"DC"

masterTrackingNumber

string

Master tracking number for all cartons in the shipment

Example:

"TX112345678"

poNumber

string

Merchant-defined purchase order number

Example:

"1125"

recipients

object[]

Recipient details

Shipment recipient details

Show child attributes

recipients.email

string

Recipient's email

Example:

"[e-mail]"

recipients.name

object

Contact person's name

Show child attributes

recipients.name.firstName

string

Contact person's first name

Example:

"Alex"

recipients.name.lastName

string

Contact person's last name

Example:

"Doe"

recipients.name.middleName

string

Contact person's middle name or initial

Example:

"E"

recipients.phone

object

Contact person's phone details

Show child attributes

recipients.phone.number

string

Contact person's phone number

Example:

"123-456-7890"

recipients.phone.type

enum<string>

Contact number type

Available options:

MOBILE,

HOME,

BUSINESS

Example:

"MOBILE"

reshipmentReasonCode

string

Reshipment reason code

Example:

"Order is missing"

scratchedItems

object[]

Scratched items

Details of scratched items in shipment

Show child attributes

scratchedItems.lineItemId

string

required

Unique number assigned by merchant to identify each item in an order. When this value isn't provided, fabric will auto generate (in UUID format) during order creation.

Example:

"2"

scratchedItems.quantity

integer

default:

0

required

Number of scratched items

Example:

1

scratchedItems.reasonCode

string

required

The primary reason code for the item scratch.

Example:

"ReasonCode23454"

scratchedItems.attributes

object

Merchant-defined custom attributes. This is a placeholder for addition info (in key: value pairs)

Example:

{ "attribute1": "value" }

scratchedItems.itemId

integer

Unique item identifier

Example:

100043

scratchedItems.sku

string

Stock keeping unit (SKU), unique item identifier

Example:

"SKU00043"

scratchedItems.subReasonCode

string

The sub-reason code for the item scratch.

Example:

"SubReasonCode23242"

scratchedItems.uom

string

Unit in which a product is measured or sold. UOM can be set to 'each' (EA) or GAL (Gallon), DZ (Dozen), etc.

Example:

"EA"

shipToAddress

object

Address details

Show child attributes

shipToAddress.addressLine1

string

required

Address line 1

Example:

"123 Main St."

shipToAddress.city

string

required

City name

Example:

"Seattle"

shipToAddress.countryCode

string

required

ISO 3166-1 alpha-2 based country code

Example:

"US"

shipToAddress.latitude

number

required

Address latitude, used with longitude to specify the address location. Decimal degrees format; negative is degrees South. **Note:**Value must be between -90 and 90, both inclusive.

Example:

47.6205

shipToAddress.longitude

number

required

Address longitude, used with latitude to specify the address location. Decimal degrees format; negative is degrees South. **Note:**Value must be between -180 and 180, both inclusive.

Example:

-122.3493

shipToAddress.postalCode

string

required

Postal or ZIP code

Example:

"98121"

shipToAddress.region

string

required

Region or state

Example:

"WA"

shipToAddress.type

string

required

Address type

Example:

"Home"

shipToAddress.addressLine2

string

Address line 2

Example:

"Suite 100"

shipToAddress.addressLine3

string

Address line 3

Example:

"Seventh floor"

shipToAddress.addressLine4

string

Address line 4

Example:

"Attention: Pat E. Kake"

shipToAddress.email

string

Contact person's email

Example:

"[e-mail]"

shipToAddress.name

object

Contact person's name

Show child attributes

shipToAddress.name.firstName

string

Contact person's first name

Example:

"Alex"

shipToAddress.name.lastName

string

Contact person's last name

Example:

"Doe"

shipToAddress.name.middleName

string

Contact person's middle name or initial

Example:

"E"

shipToAddress.phone

object

Contact person's phone details

Show child attributes

shipToAddress.phone.number

string

Contact person's phone number

Example:

"123-456-7890"

shipToAddress.phone.type

enum<string>

Contact number type

Available options:

MOBILE,

HOME,

BUSINESS

Example:

"MOBILE"

shipToId

string

Ship-to ID generated in the response of Create Shipping endpoint of Shipping service

Example:

"sg6683620405"

shipmentId

string

Shipment's autogenerated unique id

Example:

"627963716b19511e8a3a631b"

shippedAt

string

Order shipment time (UTC)

Example:

"2023-04-06T07:58:30.996Z"

statusCode

enum<string>

Current shipment status (fabric-defined codes). For standard shipments, the initial status would be SHIPMENT_CREATED. For pickup shipment, the initial status would be PICKUP_CREATED and once the customer picks up, the status changes to PICKUP_COMPLETED

Available options:

SHIPMENT_CREATED,

SHIPMENT_UPDATED,

SHIPMENT_CANCELLED,

PICKUP_CREATED,

PICKUP_COMPLETED,

SHIPMENT_RETURN_PENDING,

SHIPMENT_RETURN_RECEIVED,

SHIPMENT_PARTIALLY_DELIVERED,

SHIPMENT_DELIVERED,

SHIPMENT_ERROR

Example:

"SHIPMENT_CREATED"

subtype

string

Shipment subtype. Free-form text to add another layer of classification, if required.

Example:

"COD"

totalCartons

integer

Total number of cartons in the given shipment.

Example:

2

type

enum<string>

Shipment types

Available options:

STANDARD,

RESHIP,

RETURN,

SCRATCH,

PENDING_RETURN,

PICKUP,

TRANSFER

Example:

"STANDARD"

vendorId

string

Vendor ID. Applicable in dropshipping scenarios to indicate the vendor responsible for the given item.

Example:

"56"

Response

201

application/json

Created

Shipment details

version

integer

required

The current version of the shipment document. This integer indicates the number of times the shipment has been updated by any operation.

Example:

2

allocationId

string

System-generated allocation ID (UUID) from the Create allocation endpoint of fabric Allocation service. It refers to the given shipment. Note: Allocation occurs prior to Shipment Creation. allocationId is mandatory to create a Shipment.

Example:

"6413e3d3fd03a35efccb426e"

auditLogs

object[]

Audit log details

Details for updating shipment

Show child attributes

auditLogs.auditId

string

System-generated audit ID (UUID format)

Example:

"a05b72dc-78d8-4ea4-90fc-2fe6a1fe1111"

auditLogs.auditType

string

Audit type such as cancel, return, etc.

Example:

"CANCEL"

auditLogs.auditedAt

string

Audit time (UTC)

Example:

"2023-03-12T09:24:54.804Z"

auditLogs.employeeId

string

Employee (ID or name) who made the last update

Example:

"6227"

auditLogs.lineItemId

string

Merchant-defined unique identifier for each item in an order. When omitted, fabric will generate it during order creation, in UUID format.

Example:

"b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569"

auditLogs.note

string

Additional info, if any

Example:

"Note"

auditLogs.reasonCode

string

Merchant-defined reason code, varies from merchant to merchant

Example:

"Scratched item"

auditLogs.source

string

Merchant-defined source from where the update was initiated. There are no predefined values; possible values could be Customer Service Representative (CSR), Point-of-Sale (POS), etc.

Example:

"POS"

auditLogs.subReasonCode

string

Merchant-defined sub reason code; provides more clarity to audit reason

Example:

"Scratched item"

auditLogs.updatedFields

object[]

Audit log for change history

Audit log for change history

Show child attributes

auditLogs.updatedFields.fieldName

string

Field or property name that was updated

Example:

"UOM"

auditLogs.updatedFields.fieldOriginalValue

string

Original value of fieldName before it was updated

Example:

"PK"

cartons

object[]

Carton details

Carton details

Show child attributes

cartons.cartonNumber

string

Merchant-defined unique identifier. This can optionally be generated by fabric by using the resource generator feature of the Configuration service.

Example:

"1"

cartons.cartonType

string

Carton type

Example:

"Package"

cartons.estimatedDeliveryDate

string

Estimated delivery date given by carrier based on several factors including selected shipping method and delivery location (UTC).

Example:

"2023-04-26T07:58:30.996Z"

cartons.estimatedShipmentDate

string

Estimated ship date given by seller based on availability of items, their processing time, delivery location, and selected shipping method (UTC).

Example:

"2023-03-25T07:58:30.996Z"

cartons.items

object[]

Carton item details

Details of item in shipment

Show child attributes

cartons.items.fees

object[]

Fee details

Return fee details

Show child attributes

cartons.items.fees.amount

number

Merchant-defined return amount

Example:

34.56

cartons.items.fees.name

string

Fee name

Example:

"RETURN_FEE"

cartons.items.fees.reason

string

Merchant-defined return reason

Example:

"Return fee"

cartons.items.fees.type

enum<string>

Return fee type

Available options:

TAX,

DISCOUNT,

FEE,

ITEM,

ADJUSTMENT

Example:

"FEE"

cartons.items.giftCards

object[]

Gift card details

Gift card details

Show child attributes

cartons.items.giftCards.amount

number

Gift card amount

Example:

50

cartons.items.giftCards.giftCardActivatedAt

string

Time gift card was activated (UTC)

Example:

"2023-04-26T07:58:30.996Z"

cartons.items.giftCards.giftCardActivationRequestedAt

string

Time of placing gift card activation request (UTC)

Example:

"2023-03-26T07:58:30.996Z"

cartons.items.giftCards.giftCardNumber

string

Gift card number

Example:

"453456765"

cartons.items.giftCards.giftCardStatus

enum<string>

Gift card status

Available options:

PENDING_ACTIVATION,

ACTIVE,

FAILED

Example:

"ACTIVE"

cartons.items.itemId

integer

Unique item identifier

Example:

100023

cartons.items.lineItemId

string

Unique number assigned by merchant to identify each item in an order. When this value isn't provided, fabric will auto generate (in UUID format) during order creation.

Example:

"1"

cartons.items.orderId

string

24-character order ID generated in the response of Create Order endpoint - POST /orders

Example:

"6413e370cb0dc859b6c0dcb0"

cartons.items.orderNumber

string

Merchant-defined order identifier

Example:

"309020213"

cartons.items.orderedQuantity

integer

default:

0

Ordered quantity of given item

Example:

2

cartons.items.refundAmount

number

Refund amount for returned items

Example:

10

cartons.items.returnQuantity

integer

default:

0

Returned quantity of given item

Example:

1

cartons.items.segment

string

Item segment

Example:

"segment"

cartons.items.shipmentLineItemId

string

Unique number assigned by merchant to identify item in a shipment. When this value isn't provided, fabric will auto generate it (UUID format) during shipment.

Example:

"607f1f77bcf86cd799439011"

cartons.items.shippedQuantity

integer

default:

0

Shipped quantity of given item

Example:

2

cartons.items.sku

string

Stock keeping unit (SKU), unique item identifier

Example:

"SKU0023"

cartons.items.uom

string

Unit in which a product is measured or sold. UOM can be set to 'each' (EA) or GAL (Gallon), DZ (Dozen), etc.

Example:

"EA"

cartons.items.vendorId

string

Vendor ID. Applicable in dropshipping scenarios to indicate the vendor responsible for the given item.

Example:

"vend12346667"

cartons.promisedDeliveryDate

string

Promised delivery date given by seller (UTC)

Example:

"2023-03-26T07:58:30.996Z"

cartons.shipmentCarrier

string

Shipment carrier name

Example:

"FEDEX"

cartons.shipmentMethod

string

Shipment method

Example:

"ground"

cartons.tracking

object[]

Carton tracking details

Shipment tracking details

Show child attributes

cartons.tracking.event

string

Shipment-specific event. Mandatory in the request body of Update shipment tracking - POST /shipments/actions/update-tracking endpoint

Example:

"picked up"

cartons.tracking.eventId

string

Event ID provided by carrier

Example:

"627963716b19511e8a3a631b"

cartons.tracking.eventRecordedAt

string

Time event was recorded (UTC)

Example:

"2019-09-30T07:58:30.996Z"

cartons.tracking.location

string

Delivery location

Example:

"Reno, NV"

cartons.tracking.notes

object

Attributes to save any additional info

Show child attributes

cartons.tracking.notes.{key}

string

Attributes to save any additional info

Example:

"{\"description\":\"Shipment picked up\"}"

Example:

{ "description": "Shipment picked up" }

cartons.tracking.shipmentCarrier

string

Shipment carrier

Example:

"FEDEX"

cartons.trackingNumber

string

Carton tracking number. There is a single tracking number per carton

Example:

"1Z999AA10123456784"

cartons.trackingURL

string

Carton tracking URL

Example:

"https://example.com/tracking"

cartons.weight

string

Carton weight

Example:

"500 grams"

createdAt

string

Shipment creation time (UTC)

Example:

"2023-04-06T07:58:30.996Z"

invoiceId

string

Invoice ID generated from fabric Invoice service during shipment creation. Note: Invoices are only created for Shipments where merchants have payment Capture at Shipment feature enabled. The value will be “Null” if merchants don't have “Capture at Shipment” feature enabled.

Example:

"63ef4360aafa8a7f5247fe48"

locationNumber

string

Unique value to identify ship-from location. This must be the locationNumber stored in the fabric Location service.

Example:

"132412"

locationType

string

Location type, such as distribution center (DC) or warehouse

Example:

"DC"

masterTrackingNumber

string

Master tracking number for all cartons in the shipment

Example:

"TX112345678"

orderNumbers

string[]

List of order numbers associated with a shipment. Note: Currently, a shipment can be associated with only one order. In the future, this property will support a scenario where a customer places a second order for the same product immediately after their first order. Multiple order numbers can be linked to one shipment in such cases.

poNumber

string

Merchant-defined purchase order number

Example:

"1125"

recipients

object[]

Recipient details

Shipment recipient details

Show child attributes

recipients.email

string

Recipient's email

Example:

"[e-mail]"

recipients.name

object

Contact person's name

Show child attributes

recipients.name.firstName

string

Contact person's first name

Example:

"Alex"

recipients.name.lastName

string

Contact person's last name

Example:

"Doe"

recipients.name.middleName

string

Contact person's middle name or initial

Example:

"E"

recipients.phone

object

Contact person's phone details

Show child attributes

recipients.phone.number

string

Contact person's phone number

Example:

"123-456-7890"

recipients.phone.type

enum<string>

Contact number type

Available options:

MOBILE,

HOME,

BUSINESS

Example:

"MOBILE"

reshipmentReasonCode

string

The reshipment reason code.

Example:

"Order is missing"

scratchedItems

object[]

Details of scratched items

Customer may cancel allocation line items as part of the shipment post request. In fabric Shipments service, this is called 'Scratched Items' or 'scratchedItems'.

Show child attributes

scratchedItems.reasonCode

string

required

Reason code for scratch

Example:

"ReasonCode23454"

scratchedItems.itemId

integer

Unique item identifier

Example:

100043

scratchedItems.lineItemId

string

Unique number assigned by merchant to identify each item in an order. When this value isn't provided, fabric will auto generate it (in UUID format) during order creation.

Example:

"2"

scratchedItems.orderId

string

24-character ID displayed in the response of Create Order endpoint - POST /orders

Example:

"6413e370cb0dc859b6c0dcb0"

scratchedItems.quantity

integer

default:

0

Number of scratched items

Example:

1

scratchedItems.sku

string

Stock keeping unit (SKU), unique item identifier

Example:

"SKU00043"

scratchedItems.subReasonCode

string

Sub-reason code

Example:

"SubReasonCode23242"

scratchedItems.uom

string

Unit in which a product is measured or sold. UOM can be set to 'each' (EA) or GAL (Gallon), DZ (Dozen), etc.

Example:

"EA"

shipToAddress

object

Address details

Show child attributes

shipToAddress.addressLine1

string

required

Address line 1

Example:

"123 Main St."

shipToAddress.city

string

required

City name

Example:

"Seattle"

shipToAddress.countryCode

string

required

ISO 3166-1 alpha-2 based country code

Example:

"US"

shipToAddress.latitude

number

required

Address latitude, used with longitude to specify the address location. Decimal degrees format; negative is degrees South. **Note:**Value must be between -90 and 90, both inclusive.

Example:

47.6205

shipToAddress.longitude

number

required

Address longitude, used with latitude to specify the address location. Decimal degrees format; negative is degrees South. **Note:**Value must be between -180 and 180, both inclusive.

Example:

-122.3493

shipToAddress.postalCode

string

required

Postal or ZIP code

Example:

"98121"

shipToAddress.region

string

required

Region or state

Example:

"WA"

shipToAddress.type

string

required

Address type

Example:

"Home"

shipToAddress.addressLine2

string

Address line 2

Example:

"Suite 100"

shipToAddress.addressLine3

string

Address line 3

Example:

"Seventh floor"

shipToAddress.addressLine4

string

Address line 4

Example:

"Attention: Pat E. Kake"

shipToAddress.email

string

Contact person's email

Example:

"[e-mail]"

shipToAddress.name

object

Contact person's name

Show child attributes

shipToAddress.name.firstName

string

Contact person's first name

Example:

"Alex"

shipToAddress.name.lastName

string

Contact person's last name

Example:

"Doe"

shipToAddress.name.middleName

string

Contact person's middle name or initial

Example:

"E"

shipToAddress.phone

object

Contact person's phone details

Show child attributes

shipToAddress.phone.number

string

Contact person's phone number

Example:

"123-456-7890"

shipToAddress.phone.type

enum<string>

Contact number type

Available options:

MOBILE,

HOME,

BUSINESS

Example:

"MOBILE"

shipToId

string

Ship-to ID generated in the response of Create shipping endpoint of Shipping service

Example:

"1"

shipmentId

string

System-generated shipment ID (UUID)

Example:

"627963716b19511e8a3a631b"

shipmentNumber

string

Merchant-defined unique shipment identifier. Note: It can be optionally generated by fabric by using resource generator feature in the Configuration service

Example:

"78974156816152"

shippedAt

string

Order shipment time (UTC)

Example:

"2023-04-06T07:58:30.996Z"

statusCode

enum<string>

Current shipment status (fabric-defined codes). Note: For standard shipments, the status would be SHIPMENT_CREATED. For pickup shipment, the initial status would be PICKUP_CREATED and once the customer picks up, the status changes to PICKUP_COMPLETED

Available options:

SHIPMENT_CREATED,

SHIPMENT_UPDATED,

SHIPMENT_CANCELLED,

PICKUP_CREATED,

PICKUP_COMPLETED,

SHIPMENT_DELIVERED,

SHIPMENT_RETURN_PENDING,

SHIPMENT_RETURN_RECEIVED,

SHIPMENT_PARTIALLY_DELIVERED

Example:

"SHIPMENT_CREATED"

subtype

string

Shipment subtype, for another layer of classification. There are no pre-defined values; the possible value is Cash On Delivery (COD)

Example:

"COD"

totalCartons

integer

Total number of cartons in the given shipment. There can be only one carton per trackingNumber.

Example:

2

type

enum<string>

Shipment types

Available options:

STANDARD,

RESHIP,

RETURN,

SCRATCH,

PENDING_RETURN,

PICKUP,

TRANSFER

Example:

"STANDARD"

updatedAt

string

Time of last update to shipment (UTC)

Example:

"2023-04-06T07:58:30.996Z"

vendorId

string

Vendor ID. Applicable in dropshipping scenarios to indicate the vendor responsible for the given item.

Example:

"56"