"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.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"getShippingLabels",
"parameters":[
{
"name":"shipFromPartyId",
"in":"query",
"description":"The vendor warehouseId for order fulfillment. If not specified, the result will contain orders for all warehouses.",
"required":false,
"type":"string"
},
{
"name":"limit",
"in":"query",
"description":"The limit to the number of records returned.",
"required":false,
"type":"integer",
"maximum":100,
"minimum":1
},
{
"name":"createdAfter",
"in":"query",
"description":"Shipping labels that became available after this date and time will be included in the result. Must be in ISO-8601 date/time format.",
"required":true,
"type":"string",
"format":"date-time"
},
{
"name":"createdBefore",
"in":"query",
"description":"Shipping labels that became available before this date and time will be included in the result. Must be in ISO-8601 date/time format.",
"required":true,
"type":"string",
"format":"date-time"
},
{
"name":"sortOrder",
"in":"query",
"description":"Sort ASC or DESC by order creation date.",
"required":false,
"type":"string",
"default":"ASC",
"enum":[
"ASC",
"DESC"
],
"x-docgen-enum-table-extension":[
{
"value":"ASC",
"description":"Sort in ascending order by order creation date."
},
{
"value":"DESC",
"description":"Sort in descending order by order creation date."
}
]
},
{
"name":"nextToken",
"in":"query",
"description":"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.",
"required":false,
"type":"string"
}
],
"responses":{
"200":{
"description":"Success.",
"schema":{
"$ref":"#/definitions/ShippingLabelList"
},
"examples":{
"pagination":{
"nextToken":"MDAwMDAwMDAwMQ=="
},
"shippingLabels":[
{
"purchaseOrderNumber":"2JK3S9VCE",
"sellingParty":{
"partyId":"999US"
},
"shipFromParty":{
"partyId":"ABCD"
},
"labelFormat":"PNG",
"labelData":[
{
"packageIdentifier":"PKG001",
"trackingNumber":"1Z6A34Y60369738804",
"shipMethod":"UPS_GR_RES",
"shipMethodName":"UPS Ground Residential",
"content":"Base 64 encoded string goes here "
}
]
},
{
"purchaseOrderNumber":"2JK3S9VD",
"sellingParty":{
"partyId":"999US"
},
"shipFromParty":{
"partyId":"ABCD"
},
"labelFormat":"PNG",
"labelData":[
{
"packageIdentifier":"PKG002",
"trackingNumber":"1Z6A34Y60369738805",
"shipMethod":"UPS_GR_RES",
"shipMethodName":"UPS Ground Residential",
"content":"Base 64 encoded string goes here "
}
]
}
]
},
"headers":{
"x-amzn-RateLimit-Limit":{
"type":"string",
"description":"Your rate limit (requests per second) for this operation."
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Creates a shipping label for a purchase order and returns a transactionId for reference.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Returns a shipping label for the purchaseOrderNumber that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"The purchase order number for which you want to return the shipping label. Should be the same `purchaseOrderNumber` as received in the order.",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Creates shipping labels for a purchase order and returns the labels.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"createShippingLabels",
"parameters":[
{
"name":"purchaseOrderNumber",
"in":"path",
"description":"The purchase order number for which you want to return the shipping labels. It should be the same purchaseOrderNumber as received in the order.",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Submits one or more shipment confirmations for vendor orders.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"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.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"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.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"getCustomerInvoices",
"parameters":[
{
"name":"shipFromPartyId",
"in":"query",
"description":"The vendor warehouseId for order fulfillment. If not specified, the result will contain orders for all warehouses.",
"required":false,
"type":"string"
},
{
"name":"limit",
"in":"query",
"description":"The limit to the number of records returned",
"required":false,
"type":"integer",
"maximum":100,
"minimum":1
},
{
"name":"createdAfter",
"in":"query",
"description":"Orders that became available after this date and time will be included in the result. Must be in ISO-8601 date/time format.",
"required":true,
"type":"string",
"format":"date-time"
},
{
"name":"createdBefore",
"in":"query",
"description":"Orders that became available before this date and time will be included in the result. Must be in ISO-8601 date/time format.",
"required":true,
"type":"string",
"format":"date-time"
},
{
"name":"sortOrder",
"in":"query",
"description":"Sort ASC or DESC by order creation date.",
"required":false,
"type":"string",
"enum":[
"ASC",
"DESC"
],
"x-docgen-enum-table-extension":[
{
"value":"ASC",
"description":"Sort in ascending order by order creation date."
},
{
"value":"DESC",
"description":"Sort in descending order by order creation date."
}
]
},
{
"name":"nextToken",
"in":"query",
"description":"Used for pagination when there are more orders than the specified result size limit. The token value is returned in the previous API call.",
"required":false,
"type":"string"
}
],
"responses":{
"200":{
"description":"Success.",
"schema":{
"$ref":"#/definitions/CustomerInvoiceList"
},
"examples":{
"payload":{
"pagination":{
"nextToken":"MDAwMDAwMDAwMQ=="
},
"customerInvoices":[
{
"purchaseOrderNumber":"PO98676856",
"content":"base 64 content goes here"
}
]
}
},
"headers":{
"x-amzn-RateLimit-Limit":{
"type":"string",
"description":"Your rate limit (requests per second) for this operation."
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Returns a customer invoice based on the purchaseOrderNumber that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"getCustomerInvoice",
"parameters":[
{
"name":"purchaseOrderNumber",
"in":"path",
"description":"Purchase order number of the shipment for which to return the invoice.",
"required":true,
"type":"string",
"pattern":"^[a-zA-Z0-9]+$"
}
],
"responses":{
"200":{
"description":"Success.",
"schema":{
"$ref":"#/definitions/CustomerInvoice"
},
"examples":{
"application/json":{
"purchaseOrderNumber":"PO98676856",
"content":"base 64 encoded string"
}
},
"headers":{
"x-amzn-RateLimit-Limit":{
"type":"string",
"description":"Your rate limit (requests per second) for this operation."
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"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.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"getPackingSlips",
"parameters":[
{
"name":"shipFromPartyId",
"in":"query",
"description":"The vendor warehouseId for order fulfillment. If not specified the result will contain orders for all warehouses.",
"required":false,
"type":"string"
},
{
"name":"limit",
"in":"query",
"description":"The limit to the number of records returned",
"required":false,
"type":"integer",
"maximum":100,
"minimum":1
},
{
"name":"createdAfter",
"in":"query",
"description":"Packing slips that became available after this date and time will be included in the result. Must be in ISO-8601 date/time format.",
"required":true,
"type":"string",
"format":"date-time"
},
{
"name":"createdBefore",
"in":"query",
"description":"Packing slips that became available before this date and time will be included in the result. Must be in ISO-8601 date/time format.",
"required":true,
"type":"string",
"format":"date-time"
},
{
"name":"sortOrder",
"in":"query",
"description":"Sort ASC or DESC by packing slip creation date.",
"required":false,
"type":"string",
"default":"ASC",
"enum":[
"ASC",
"DESC"
],
"x-docgen-enum-table-extension":[
{
"value":"ASC",
"description":"Sort in ascending order by packing slip creation date."
},
{
"value":"DESC",
"description":"Sort in descending order by packing slip creation date."
}
]
},
{
"name":"nextToken",
"in":"query",
"description":"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.",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Returns a packing slip based on the purchaseOrderNumber that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 10 | 10 |\n\nThe `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](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"getPackingSlip",
"parameters":[
{
"name":"purchaseOrderNumber",
"in":"path",
"description":"The purchaseOrderNumber for the packing slip you want.",
"description":"Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"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."
"description":"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."
},
"shipmentStatus":{
"type":"string",
"description":"Indicate the shipment status.",
"enum":[
"SHIPPED",
"FLOOR_DENIAL"
],
"x-docgen-enum-table-extension":[
{
"value":"SHIPPED",
"description":"Orders that have left the warehouse have shipped status."
},
{
"value":"FLOOR_DENIAL",
"description":"Status for orders rejected due to quality issues with products on the floor, or the physical and virtual inventory do not match."
}
]
},
"isPriorityShipment":{
"type":"boolean",
"description":"Provide the priority of the shipment."
},
"vendorOrderNumber":{
"type":"string",
"description":"The vendor order number is a unique identifier generated by a vendor for their reference."
},
"estimatedDeliveryDate":{
"type":"string",
"format":"date-time",
"description":"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."
}
},
"description":"Details about a shipment."
},
"StatusUpdateDetails":{
"type":"object",
"required":[
"reasonCode",
"statusCode",
"statusDateTime",
"statusLocationAddress",
"trackingNumber"
],
"properties":{
"trackingNumber":{
"type":"string",
"description":"This is required to be provided for every package and should match with the trackingNumber sent for the shipment confirmation."
"description":"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](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-shipping-api-use-case-guide#additional-fields-explanation)."
"description":"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](https://developer-docs.amazon.com/sp-api/docs/vendor-direct-fulfillment-shipping-api-use-case-guide#additional-fields-explanation)."
"description":"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."
},
"statusLocationAddress":{
"$ref":"#/definitions/Address"
},
"shipmentSchedule":{
"$ref":"#/definitions/ShipmentSchedule"
}
},
"description":"Details for the shipment status update given by the vendor for the specific package."
"description":"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."
},
"apptWindowStartDateTime":{
"type":"string",
"format":"date-time",
"description":"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."
},
"apptWindowEndDateTime":{
"type":"string",
"format":"date-time",
"description":"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."
}
},
"description":"Details about the estimated delivery window."
"description":"A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\\\\d*))(\\\\.\\\\d+)?([eE][+-]?\\\\d+)?$`."
},
"ItemQuantity":{
"type":"object",
"required":[
"amount",
"unitOfMeasure"
],
"properties":{
"amount":{
"type":"integer",
"description":"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."
},
"unitOfMeasure":{
"type":"string",
"description":"Unit of measure for the shipped quantity."
"description":"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."
},
"trackingNumber":{
"type":"string",
"description":"Package tracking identifier from the shipping carrier."
},
"shipMethod":{
"type":"string",
"description":"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."
},
"shipMethodName":{
"type":"string",
"description":"Shipping method name for internal reference."
},
"content":{
"type":"string",
"description":"This field will contain the Base64encoded string of the shipment label content."
}
},
"description":"Details of the shipment label."
},
"ShippingLabel":{
"type":"object",
"required":[
"labelData",
"labelFormat",
"purchaseOrderNumber",
"sellingParty",
"shipFromParty"
],
"properties":{
"purchaseOrderNumber":{
"type":"string",
"description":"This field will contain the Purchase Order Number for this order.",
"pattern":"^[a-zA-Z0-9]+$"
},
"sellingParty":{
"description":"ID of the selling party or vendor.",
"description":"Shipping label information for an order. Includes the purchase order number, selling party, ship from party, label format, and package details."
"description":"ID of the selling party or vendor.",
"$ref":"#/definitions/PartyIdentification"
},
"shipFromParty":{
"description":"Warehouse code of vendor.",
"$ref":"#/definitions/PartyIdentification"
},
"items":{
"type":"array",
"description":"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.",
"items":{
"$ref":"#/definitions/Item"
}
},
"containers":{
"type":"array",
"description":"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.",
"description":"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."