Vendor Direct Fulfillment Shipping API v2021-12-28 Reference
Access a Direct Fulfillment vendor's shipping data.
Overview
Use the Selling Partner API for Direct Fulfillment Shipping to access a direct fulfillment vendor's shipping data.
Version information
Version : 2021-12-28
Contact information
Contact : Selling Partner API Developer Support
Contact URL : https://sellercentral.amazon.com/gp/mws/contactus.html
License information
License : Apache License 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0
URI scheme
Host : sellingpartnerapi-na.amazon.com
Schemes : HTTPS
Consumes
application/json
Produces
application/json
Operations
getShippingLabels
submitShippingLabelRequest
getShippingLabel
createShippingLabels
submitShipmentConfirmations
submitShipmentStatusUpdates
getCustomerInvoices
getCustomerInvoice
getPackingSlips
getPackingSlip
createContainerLabel
Paths
getShippingLabels
GET /vendor/directFulfillment/shipping/2021-12-28/shippingLabels
Operation: getShippingLabels
Description
Returns a list of shipping labels created during the time frame that you specify. Use the createdAfter and createdBefore parameters to define the time frame. You must use both of these parameters. The date range to search must not be more than seven days.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| Query | shipFromPartyId optional | The vendor warehouseId for order fulfillment. If not specified, the result contains orders for all warehouses. | string | - |
| Query | limit optional | The limit to the number of records returned. Minimum : 1 Maximum : 100 | integer | - |
| Query | createdAfter required | Shipping labels that became available after this date and time will be included in the result. Values are in ISO 8601 date-time format. | string (date-time) | - |
| Query | createdBefore required | Shipping labels that became available before this date and time will be included in the result. Values are in ISO 8601 date-time format. | string (date-time) | - |
| Query | sortOrder optional | The sort order creation date. You can choose between ascending (ASC) or descending (DESC) sort order. | enum (SortOrder) | "ASC" |
| Query | nextToken optional | Used for pagination when there are more ship labels than the specified result size limit. The token value is returned in the previous API call. | string | - |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | ShippingLabelList |
For error status codes, descriptions and schemas, see Error responses and schemas.
submitShippingLabelRequest
POST /vendor/directFulfillment/shipping/2021-12-28/shippingLabels
Operation: submitShippingLabelRequest
Description
Creates a shipping label for a purchase order and returns a transactionId for reference.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Body | body required | The request body that contains the shipping labels data. | SubmitShippingLabelsRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | TransactionReference |
For error status codes, descriptions and schemas, see Error responses and schemas.
getShippingLabel
GET /vendor/directFulfillment/shipping/2021-12-28/shippingLabels/{purchaseOrderNumber}
Operation: getShippingLabel
Description
Returns a shipping label for the purchaseOrderNumber that you specify.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Path | purchaseOrderNumber required | The purchase order number for which you want to return the shipping label. It should be the same purchaseOrderNumber that you received in the order. | string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | ShippingLabel |
For error status codes, descriptions and schemas, see Error responses and schemas.
createShippingLabels
POST /vendor/directFulfillment/shipping/2021-12-28/shippingLabels/{purchaseOrderNumber}
Operation: createShippingLabels
Description
Creates shipping labels for a purchase order and returns the labels.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Path | purchaseOrderNumber required | The purchase order number for which you want to return the shipping labels. It should be the same number as the purchaseOrderNumber in the order. | string |
| Body | body required | The request payload that contains the parameters for creating shipping labels. | CreateShippingLabelsRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | ShippingLabel |
For error status codes, descriptions and schemas, see Error responses and schemas.
submitShipmentConfirmations
POST /vendor/directFulfillment/shipping/2021-12-28/shipmentConfirmations
Operation: submitShipmentConfirmations
Description
Submits one or more shipment confirmations for vendor orders.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Body | body required | Request body containing the shipment confirmations data. | SubmitShipmentConfirmationsRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | TransactionReference |
For error status codes, descriptions and schemas, see Error responses and schemas.
submitShipmentStatusUpdates
POST /vendor/directFulfillment/shipping/2021-12-28/shipmentStatusUpdates
Operation: submitShipmentStatusUpdates
Description
This operation is only to be used by Vendor-Own-Carrier (VOC) vendors. Calling this API submits a shipment status update for the package that a vendor has shipped. It will provide the Amazon customer visibility on their order, when the package is outside of Amazon Network visibility.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Body | body required | Request body that contains the shipment status update data. | SubmitShipmentStatusUpdatesRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 202 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | TransactionReference |
For error status codes, descriptions and schemas, see Error responses and schemas.
getCustomerInvoices
GET /vendor/directFulfillment/shipping/2021-12-28/customerInvoices
Operation: getCustomerInvoices
Description
Returns a list of customer invoices created during a time frame that you specify. You define the time frame using the createdAfter and createdBefore parameters. You must use both of these parameters. The date range to search must be no more than 7 days.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Query | shipFromPartyId optional | The vendor warehouseId for order fulfillment. If not specified, the result will contain orders for all warehouses. | string |
| Query | limit optional | The limit to the number of records returned Minimum : 1 Maximum : 100 | integer |
| Query | createdAfter required | Orders that became available after this date and time will be included in the result. Values are in ISO 8601 date-time format. | string (date-time) |
| Query | createdBefore required | Orders that became available before this date and time will be included in the result. Values are in ISO 8601 date-time format. | string (date-time) |
| Query | sortOrder optional | Sort ASC or DESC by order creation date. | enum (SortOrder) |
| Query | nextToken optional | Used for pagination when there are more orders than the specified result size limit. The token value is returned in the previous API call. | string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | CustomerInvoiceList |
For error status codes, descriptions and schemas, see Error responses and schemas.
getCustomerInvoice
GET /vendor/directFulfillment/shipping/2021-12-28/customerInvoices/{purchaseOrderNumber}
Operation: getCustomerInvoice
Description
Returns a customer invoice based on the purchaseOrderNumber that you specify.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Path | purchaseOrderNumber required | Purchase order number of the shipment for which to return the invoice. | string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | CustomerInvoice |
For error status codes, descriptions and schemas, see Error responses and schemas.
getPackingSlips
GET /vendor/directFulfillment/shipping/2021-12-28/packingSlips
Operation: getPackingSlips
Description
Returns a list of packing slips for the purchase orders that match the criteria specified. Date range to search must not be more than 7 days.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema | Default |
|---|---|---|---|---|
| Query | shipFromPartyId optional | The vendor warehouseId for order fulfillment. If not specified, the result contains orders for all warehouses. | string | - |
| Query | limit optional | The maximum number of records to return. Minimum : 1 Maximum : 100 | integer | - |
| Query | createdAfter required | Packing slips that become available after this date and time will be included in the result. Values are in ISO 8601 date-time format. | string (date-time) | - |
| Query | createdBefore required | Packing slips that became available before this date and time will be included in the result. Values are in ISO 8601 date-time format. | string (date-time) | - |
| Query | sortOrder optional | The packing slip creation dates, which are sorted by ascending or descending order. | enum (SortOrder) | "ASC" |
| Query | nextToken optional | Used for pagination when there are more packing slips than the specified result size limit. The token value is returned in the previous API call. | string | - |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | PackingSlipList |
For error status codes, descriptions and schemas, see Error responses and schemas.
getPackingSlip
GET /vendor/directFulfillment/shipping/2021-12-28/packingSlips/{purchaseOrderNumber}
Operation: getPackingSlip
Description
Returns a packing slip based on the purchaseOrderNumber that you specify.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values then those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Path | purchaseOrderNumber required | The purchaseOrderNumber for the packing slip that you want. | string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | PackingSlip |
For error status codes, descriptions and schemas, see Error responses and schemas.
createContainerLabel
POST /vendor/directFulfillment/shipping/2021-12-28/containerLabel
Operation: createContainerLabel
Description
Creates a container (pallet) label for the associated shipment package.
Usage Plan:
| Rate (requests per second) | Burst |
|---|---|
| 10 | 10 |
The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Body | body required | Request body containing the container label data. | CreateContainerLabelRequest |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. Headers : x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation. x-amzn-RequestId (string) : Unique request reference identifier. | CreateContainerLabelResponse |
For error status codes, descriptions and schemas, see Error responses and schemas.
Error Responses and Schemas
This table contains HTTP status codes and associated information for error responses.
| HTTP Code | Description | Schema |
|---|---|---|
| 400 | Request has missing or invalid parameters and cannot be parsed. Headers: x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation. x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 401 | The request's Authorization header is not formatted correctly or does not contain a valid token. Headers: x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 403 | Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. Headers: x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 404 | The resource specified does not exist. Headers: x-amzn-RateLimit-Limit (string):Your rate limit (requests per second) for this operation. x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 409 | The request conflicts with the current state of the resource (shipment). Headers: x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 413 | The request size exceeded the maximum accepted size. Headers: x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 415 | The request payload is in an unsupported format. Headers: x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 429 | The frequency of requests was greater than allowed. Headers: x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 500 | An unexpected condition occurred that prevented the server from fulfilling the request. Headers: x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
| 503 | Temporary overloading or maintenance of the server. Headers: x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
Definitions
PackingSlip
Packing slip information.
| Name | Description | Schema |
|---|---|---|
| purchaseOrderNumber required | Purchase order number of the shipment that the packing slip is for. Pattern : "^[a-zA-Z0-9]+$" | string |
| content required | A Base64 string of the packing slip PDF. | string |
| contentType optional | The format of the file such as PDF, JPEG etc. | enum (ContentType) |
PackingSlipList
A list of packing slips.
| Name | Description | Schema |
|---|---|---|
| pagination optional | The pagination elements required to retrieve the remaining data. | Pagination |
| packingSlips optional | An array of packing slip objects. | < PackingSlip > array |
CreateShippingLabelsRequest
The request body for the createShippingLabels operation.
| Name | Description | Schema |
|---|---|---|
| sellingParty required | ID of the selling party or vendor. | PartyIdentification |
| shipFromParty required | Warehouse code of vendor. | PartyIdentification |
| containers optional | A list of the packages in this shipment. | < Container > array |
SubmitShippingLabelsRequest
The request schema for the submitShippingLabelRequest operation.
| Name | Description | Schema |
|---|---|---|
| shippingLabelRequests optional | An array of shipping label requests you want to process. | < ShippingLabelRequest > array |
ShippingLabelRequest
Represents the request payload to create a shipping label. Contains the purchase order number, selling party, ship from party, and a list of containers or packages in the shipment.
| Name | Description | Schema |
|---|---|---|
| purchaseOrderNumber required | The purchase order number of the order for which to create a shipping label. Pattern : "^[a-zA-Z0-9]+$" | string |
| sellingParty required | The ID of the selling party or vendor. | PartyIdentification |
| shipFromParty required | The warehouse code of the vendor. | PartyIdentification |
| containers optional | A list of the packages in this shipment. | < Container > array |
Item
Details of the item being shipped.
| Name | Description | Schema |
|---|---|---|
| itemSequenceNumber required | The sequence number of the item. The number must be the same as the order number of the item. | integer |
| buyerProductIdentifier optional | The buyer's Amazon Standard Identification Number (ASIN) of an item. Either buyerProductIdentifier or vendorProductIdentifier is required. | string |
| vendorProductIdentifier optional | An item's product identifier, which the vendor selects. This identifier should be the same as the identifier, such as a SKU, in the purchase order. | string |
| shippedQuantity required | The total quantity of items that are in this shipment. | ItemQuantity |
PackedItem
Represents an item packed into a container for shipping.
| Name | Description | Schema |
|---|---|---|
| itemSequenceNumber required | The sequence number of the item. The number must be the same as the order number of the item. | integer |
| buyerProductIdentifier optional | The buyer's Amazon Standard Identification Number (ASIN) of an item. Either buyerProductIdentifier or vendorProductIdentifier is required. | string |
| pieceNumber optional | The piece number of the item in this container. This is required when the item is split across different containers. | integer |
| vendorProductIdentifier optional | An item's product identifier, which the vendor selects. This identifier should be the same as the identifier, such as a SKU, in the purchase order. | string |
| packedQuantity required | The total quantity of items that are packed in the shipment. | ItemQuantity |
PartyIdentification
The name, address, and tax details of a party.
| Name | Description | Schema |
|---|---|---|
| partyId required | The identifier of the party. | string |
| address optional | The address of the party. | Address |
| taxRegistrationDetails optional | The tax registration details of the party. | < TaxRegistrationDetails > array |
ShipmentDetails
Details about a shipment.
| Name | Description | Schema |
|---|---|---|
| shippedDate required | The date of the shipment's departure from vendor's location. Vendors send ASNs within 30 minutes of departure from their warehouse/distribution center or six hours prior to the appointment time at the Amazon destination warehouse. The shipped date mentioned in the shipment confirmation cannot be in the future. | string (date-time) |
| shipmentStatus required | The shipment status. | enum (ShipmentStatus) |
| isPriorityShipment optional | Provide the priority of the shipment. | boolean |
| vendorOrderNumber optional | The vendor order number is a unique identifier generated by a vendor for their reference. | string |
| estimatedDeliveryDate optional | The date on which the shipment is expected to reach the buyer's warehouse. The date is estimated based on the average transit time between the ship-from location and the destination. Usually, the exact appointment time is unknown when creating the shipment confirmation and is later provided by the buyer. | string (date-time) |
StatusUpdateDetails
Details for the shipment status update given by the vendor for the specific package.
| Name | Description | Schema |
|---|---|---|
| trackingNumber required | The shipment tracking number is required for every package and should match the trackingNumber sent for the shipment confirmation. | string |
| statusCode required | The shipment status code for the package that provides transportation information for Amazon tracking systems and the final customer. For more information, refer to the Additional Fields Explanation. | string |
| reasonCode required | Provides a reason code for the package status that provides additional information about the transportation status. For more information, refer to the Additional Fields Explanation. | string |
| statusDateTime required | The date and time when the shipment status was updated. Values are in ISO 8601 date-time format, with UTC time zone or UTC offset. For example, 2020-07-16T23:00:00Z or 2020-07-16T23:00:00+01:00. | string (date-time) |
| statusLocationAddress required | Address of the party. | Address |
| shipmentSchedule optional | Details about the estimated delivery window. | ShipmentSchedule |
TaxRegistrationDetails
Tax registration details of the entity.
| Name | Description | Schema |
|---|---|---|
| taxRegistrationType optional | Tax registration type for the entity. | enum (TaxRegistrationType) |
| taxRegistrationNumber required | Tax registration number for the party. For example, VAT ID. | string |
| taxRegistrationAddress optional | Address associated with the tax registration number. | Address |
| taxRegistrationMessages optional | Tax registration message that can be used for additional tax related details. | string |
Address
Address of the party.
| Name | Description | Schema |
|---|---|---|
| name required | The name of the person, business or institution at that address. | string |
| addressLine1 required | First line of the address. | string |
| addressLine2 optional | Additional street address information, if required. | string |
| addressLine3 optional | Additional street address information, if required. | string |
| city optional | The city where the person, business or institution is located. | string |
| county optional | The county where person, business or institution is located. | string |
| district optional | The district where person, business or institution is located. | string |
| stateOrRegion optional | The state or region where person, business or institution is located. | string |
| postalCode optional | The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation. | string |
| countryCode required | The two-letter country code in ISO 3166-1 alpha-2 format. | string |
| phone optional | The phone number of the person, business or institution located at that address. | string |
ShipmentSchedule
Details about the estimated delivery window.
| Name | Description | Schema |
|---|---|---|
| estimatedDeliveryDateTime optional | Date on which the shipment is expected to reach the customer delivery location. Values are in ISO 8601 date-time format, with UTC time zone or UTC offset. For example, 2020-07-16T23:00:00Z or 2020-07-16T23:00:00+01:00. | string (date-time) |
| apptWindowStartDateTime optional | The date and time at the start of the appointment window when the shipment is expected to be delivered. Values are in ISO 8601 date-time format, with UTC time zone or UTC offset. For example, 2020-07-16T23:00:00Z or 2020-07-16T23:00:00+01:00. | string (date-time) |
| apptWindowEndDateTime optional | The date and time at the end of the appointment window when the shipment is expected to be delivered. Values are in ISO 8601 date-time format, with UTC time zone or UTC offset. For example, 2020-07-16T23:00:00Z or 2020-07-16T23:00:00+01:00. | string (date-time) |
Dimensions
Physical dimensional measurements of a container.
| Name | Description | Schema |
|---|---|---|
| length required | The length of the container. | Decimal |
| width required | The width of the container. | Decimal |
| height required | The height of the container. | Decimal |
| unitOfMeasure required | The unit of measure for dimensions. | enum (UnitOfMeasure) |
Weight
The weight.
| Name | Description | Schema |
|---|---|---|
| unitOfMeasure required | The unit of measurement. | enum (UnitOfMeasure) |
| value required | The measurement value. | Decimal |
Decimal
A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation.
Pattern : ^-?(0|([1-9]\\d*))(\\.\\d+)?([eE][+-]?\\d+)?$.
Type : string
ItemQuantity
Details of item quantity.
| Name | Description | Schema |
|---|---|---|
| amount required | Quantity of units shipped for a specific item at a shipment level. If the item is present only in certain packages or pallets within the shipment, please provide this at the appropriate package or pallet level. | integer |
| unitOfMeasure required | Unit of measure for the shipped quantity. | string |
ShippingLabelList
Response payload with the list of shipping labels.
| Name | Description | Schema |
|---|---|---|
| pagination optional | The pagination elements required to retrieve the remaining data. | Pagination |
| shippingLabels optional | An array that contains the details of the generated shipping labels. | < ShippingLabel > array |
LabelData
Details of the shipment label.
| Name | Description | Schema |
|---|---|---|
| packageIdentifier optional | Identifier for the package. The first package will be 001, the second 002, and so on. This number is used as a reference to refer to this package from the pallet level. | string |
| trackingNumber optional | Package tracking identifier from the shipping carrier. | string |
| shipMethod optional | Ship method to be used for shipping the order. Amazon defines Ship Method Codes indicating shipping carrier and shipment service level. Ship Method Codes are case and format sensitive. The same ship method code should returned on the shipment confirmation. Note that the Ship Method Codes are vendor specific and will be provided to each vendor during the implementation. | string |
| shipMethodName optional | Shipping method name for internal reference. | string |
| content required | This field will contain the Base64 string of the shipment label content. | string |
ShippingLabel
Shipping label information for an order. Includes the purchase order number, selling party, ship from party, label format, and package details.
| Name | Description | Schema |
|---|---|---|
| purchaseOrderNumber required | This field will contain the Purchase Order Number for this order. Pattern : "^[a-zA-Z0-9]+$" | string |
| sellingParty required | ID of the selling party or vendor. | PartyIdentification |
| shipFromParty required | Warehouse code of vendor. | PartyIdentification |
| labelFormat required | Format of the label. | enum (LabelFormat) |
| labelData required | Provides the details of the packages in this shipment. | < LabelData > array |
SubmitShipmentConfirmationsRequest
The submitShipmentConfirmations request schema.
| Name | Description | Schema |
|---|---|---|
| shipmentConfirmations optional | Array of ShipmentConfirmation objects. Each ShipmentConfirmation object represents the confirmation details for a specific shipment. | < ShipmentConfirmation > array |
ShipmentConfirmation
Represents the confirmation details of a shipment. Includes the purchase order number and other shipment details.
| Name | Description | Schema |
|---|---|---|
| purchaseOrderNumber required | Purchase order number corresponding to the shipment. Pattern : "^[a-zA-Z0-9]+$" | string |
| shipmentDetails required | Shipment information. | ShipmentDetails |
| sellingParty required | ID of the selling party or vendor. | PartyIdentification |
| shipFromParty required | Warehouse code of vendor. | PartyIdentification |
| items required | Provide the details of the items in this shipment. If any of the item details field is common at a package or a pallet level, then provide them at the corresponding package. | < Item > array |
| containers optional | Provide the details of the items in this shipment. If any of the item details field is common at a package or a pallet level, then provide them at the corresponding package. | < Container > array |
SubmitShipmentStatusUpdatesRequest
The submitShipmentStatusUpdates request schema.
| Name | Description | Schema |
|---|---|---|
| shipmentStatusUpdates optional | Contains a list of one or more ShipmentStatusUpdate objects. Each ShipmentStatusUpdate object represents an update to the status of a specific shipment. | < ShipmentStatusUpdate > array |
ShipmentStatusUpdate
Represents a shipment status update.
| Name | Description | Schema |
|---|---|---|
| purchaseOrderNumber required | Purchase order number of the shipment for which to update the shipment status. Pattern : "^[a-zA-Z0-9]+$" | string |
| sellingParty required | ID of the selling party or vendor. | PartyIdentification |
| shipFromParty required | Warehouse code of vendor. | PartyIdentification |
| statusUpdateDetails required | Provide the details about the status of the shipment at that particular point of time. | StatusUpdateDetails |
CustomerInvoiceList
Represents a list of customer invoices, potentially paginated.
| Name | Description | Schema |
|---|---|---|
| pagination optional | The pagination elements required to retrieve the remaining data. | Pagination |
| customerInvoices optional | Represents a customer invoice within the CustomerInvoiceList. | < CustomerInvoice > array |
Pagination
The pagination elements required to retrieve the remaining data.
| Name | Description | Schema |
|---|---|---|
| nextToken optional | A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to the next request. If NextToken is not returned, there are no more order items to return. | string |
CustomerInvoice
Represents a customer invoice associated with a purchase order.
| Name | Description | Schema |
|---|---|---|
| purchaseOrderNumber required | The purchase order number for this order. Pattern : "^[a-zA-Z0-9]+$" | string |
| content required | The Base64 customer invoice. | string |
TransactionReference
Response that contains the transaction ID.
| Name | Description | Schema |
|---|---|---|
| transactionId optional | GUID to identify this transaction. This value can be used with the Transaction Status API to return the status of this transaction. | string |
ErrorList
A list of error responses returned when a request is unsuccessful.
| Name | Description | Schema |
|---|---|---|
| errors required | An array of error objects that represents individual errors encountered during the request. | < Error > array |
Error
Error response returned when the request is unsuccessful.
| Name | Description | Schema |
|---|---|---|
| code required | An error code that identifies the type of error that occurred. | string |
| message required | A message that describes the error condition. | string |
| details optional | Additional details that can help the caller understand or fix the issue. | string |
Container
A container for shipping and packing items.
| Name | Description | Schema |
|---|---|---|
| containerType required | The type of container. | enum (ContainerType) |
| containerIdentifier required | The container identifier. | string |
| trackingNumber optional | The tracking number. | string |
| manifestId optional | The manifest identifier. | string |
| manifestDate optional | The date of the manifest. | string |
| shipMethod optional | The shipment method. This property is required when calling the submitShipmentConfirmations operation, and optional otherwise. | string |
| scacCode optional | SCAC code required for NA VOC vendors only. | string |
| carrier optional | Carrier required for EU VOC vendors only. | string |
| containerSequenceNumber optional | An integer that must be submitted for multi-box shipments only, where one item may come in separate packages. | integer |
| dimensions optional | Physical dimensional measurements of a container. | Dimensions |
| weight required | The weight. | Weight |
| packedItems required | A list of packed items. | < PackedItem > array |
CreateContainerLabelRequest
The request body schema for the createContainerLabel operation.
| Name | Description | Schema |
|---|---|---|
| sellingParty required | The ID of the selling party or vendor. | PartyIdentification |
| shipFromParty required | The warehouse code of the vendor. | PartyIdentification |
| carrierId required | The container (pallet) label's carrier. | CarrierId |
| vendorContainerId required | The vendor's unique identifier for the container. | VendorContainerId |
| packages required | An array of package objects that associate shipment packages with a container. | Packages |
Packages
An array of package objects in a container.
Type : < Package > array
Package
The package that is associated with the container.
| Name | Description | Schema |
|---|---|---|
| packageTrackingNumber required | The tracking number on the label of shipment package, that you can fetch from the shippingLabels response. You can also scan the bar code on the shipping label to get the tracking number. | string |
VendorContainerId
The unique, vendor-provided identifier for the container.
Type : string
CarrierId
The unique carrier code for the carrier for whom container labels are requested.
Type : enum
| Value | Description |
|---|---|
| SWA | Ship with Amazon Carrier. |
CreateContainerLabelResponse
The response schema for the createContainerLabel operation.
| Name | Description | Schema |
|---|---|---|
| containerLabel required | The label data for the container label. | ContainerLabel |
ContainerLabel
The details of the container label.
| Name | Description | Schema |
|---|---|---|
| containerTrackingNumber optional | The container (pallet) tracking identifier from the shipping carrier. | string |
| content required | The container label content encoded into a Base64 string. | string |
| format required | The format of the container label. | ContainerLabelFormat |
ContainerLabelFormat
The format of the container label.
Type : enum
| Value | Description |
|---|---|
| PNG | Portable Network Graphics (png) format. |
| ZPL | Zebra Programming Language (zpl) format. |
LabelFormat
Format of the label.
Type : enum
| Value | Description |
|---|---|
| PNG | Portable Network Graphics (png) format. |
| ZPL | Zebra Programming Language (zpl) format. |
ContentType
The format of the file such as PDF, JPEG etc.
Type : enum
| Value | Description |
|---|---|
| application/pdf | Portable Document Format (pdf). |
ShipmentStatus
The shipment status.
Type : enum
| Value | Description |
|---|---|
| SHIPPED | Orders that have left the warehouse have shipped status. |
| FLOOR_DENIAL | Status for orders rejected due to quality issues with products on the floor, or the physical and virtual inventory do not match. |
TaxRegistrationType
Tax registration type for the entity.
Type : enum
| Value | Description |
|---|---|
| VAT | Value-added tax. |
| GST | Goods and Services Tax (GST). |
ContainerType
The type of container.
Type : enum
| Value | Description |
|---|---|
| Carton | A packing container type that is typically used for drinks or food. |
| Pallet | A flat transport structure which supports goods in a stable fashion while being lifted by a forklift. |
UnitOfMeasure
Type : enum
For use with the definition(s): Weight
The unit of measurement.
| Value | Description |
|---|---|
| KG | Kilogram |
| LB | Pounds (Libra for Latin). |
For use with the definition(s): Dimensions
The unit of measure for dimensions.
| Value | Description |
|---|---|
| IN | Inches |
| CM | Centimeters |
SortOrder
Type : enum
For use with the operation(s): getPackingSlips
The packing slip creation dates, which are sorted by ascending or descending order.
| Value | Description |
|---|---|
| ASC | Sort in ascending order by packing slip creation date. |
| DESC | Sort in descending order by packing slip creation date. |
For use with the operation(s): getCustomerInvoices
Sort ASC or DESC by order creation date.
| Value | Description |
|---|---|
| ASC | Sort in ascending order by order creation date. |
| DESC | Sort in descending order by order creation date. |
For use with the operation(s): getShippingLabels
The sort order creation date. You can choose between ascending (ASC) or descending (DESC) sort order.
| Value | Description |
|---|---|
| ASC | Sort in ascending order by order creation date. |
| DESC | Sort in descending order by order creation date. |
Updated 5 days ago