Vendor Direct Fulfillment Shipping API v2021-12-28 Reference
Access a Direct Fulfillment vendor's shipping data.
Overview
The Selling Partner API for Direct Fulfillment Shipping provides programmatic access to 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
Paths
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. You define that time frame using the createdAfter and createdBefore parameters. You must use both of these parameters. The 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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see 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 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 | Shipping labels that became available after this date and time will be included in the result. Must be 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. Must be in ISO-8601 date/time format. | string (date-time) | - |
Query | sortOrder optional | Sort ASC or DESC by order creation date. | 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Body | body required | 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see 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. Should be the same purchaseOrderNumber as 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see 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 purchaseOrderNumber as received in the order. | string |
Body | body required | The request payload that contains 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see 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. Must be 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. Must be 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see 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 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 | Packing slips that became available after this date and time will be included in the result. Must be 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. Must be in ISO-8601 date/time format. | string (date-time) | - |
Query | sortOrder optional | Sort ASC or DESC by packing slip creation date. | 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.
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 table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.
Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path | purchaseOrderNumber required | The purchaseOrderNumber for the packing slip 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.
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 Base64encoded 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 | Purchase order number of the order for which to create a shipping label. Pattern : "^[a-zA-Z0-9]+$" | string |
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 |
Item
Details of the item being shipped.
Name | Description | Schema |
---|---|---|
itemSequenceNumber required | Item Sequence Number for the item. This must be the same value as sent in order for a given item. | integer |
buyerProductIdentifier optional | Buyer's Standard Identification Number (ASIN) of an item. Either buyerProductIdentifier or vendorProductIdentifier is required. | string |
vendorProductIdentifier optional | The vendor selected product identification of the item. Should be the same as was sent in the purchase order, like SKU Number. | string |
shippedQuantity required | Total item quantity shipped in this shipment. | ItemQuantity |
PackedItem
Represents an item packed into a container for shipping.
Name | Description | Schema |
---|---|---|
itemSequenceNumber required | Item Sequence Number for the item. This must be the same value as sent in the order for a given item. | integer |
buyerProductIdentifier optional | Buyer's 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 | The vendor selected product identification of the item. Should be the same as was sent in the Purchase Order, like SKU Number. | string |
packedQuantity required | Total item quantity packed in the container. | ItemQuantity |
PartyIdentification
Name, address, and tax details for a party.
Name | Description | Schema |
---|---|---|
partyId required | Assigned Identification for the party. | string |
address optional | Identification of the party by address. | Address |
taxRegistrationDetails optional | Tax registration details of the entity. | < TaxRegistrationDetails > array |
ShipmentDetails
Details about a shipment.
Name | Description | Schema |
---|---|---|
shippedDate required | This field indicates the date of the departure of the shipment from vendor's location. Vendors are requested to send ASNs within 30 minutes of departure from their warehouse/distribution center or at least 6 hours prior to the appointment time at the Amazon destination warehouse, whichever is sooner. Shipped date mentioned in the Shipment Confirmation should not be in the future. | string (date-time) |
shipmentStatus required | Indicate 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 | Date on which the shipment is expected to reach the buyer's warehouse. It needs to be an estimate based on the average transit time between the ship-from location and the destination. The exact appointment time will be provided by buyer and is potentially not known when creating the shipment confirmation. | string (date-time) |
StatusUpdateDetails
Details for the shipment status update given by the vendor for the specific package.
Name | Description | Schema |
---|---|---|
trackingNumber required | This is required to be provided for every package and should match with 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. This field is expected to be 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 digit 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. This field is expected to be 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 | This field indicates the date and time at the start of the appointment window scheduled to deliver the shipment. This field is expected to be 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 | This field indicates the date and time at the end of the appointment window scheduled to deliver the shipment. This field is expected to be 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 shipping labels list.
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 Base64encoded 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 | An array of ShipmentConfirmation objects, each represents 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 represents a status update 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 Base64encoded 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 |
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
Indicate 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 | Packing container type. 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
Sort ASC or DESC by packing slip creation date.
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): getShippingLabels, 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. |
Updated 4 months ago