Update ordersV0
Reflect recent changes to ordersV0: - Add ISPU SellerShipment model under orders section - Switch Sandbox Behaviors legacy extension to the modern extension - Add SSA fields - Update 'status' to 'shipmentStatus' - Add link to marketplaceId list
This commit is contained in:
parent
decb94d46d
commit
8fb41717b1
|
@ -73,7 +73,7 @@
|
||||||
{
|
{
|
||||||
"name": "MarketplaceIds",
|
"name": "MarketplaceIds",
|
||||||
"in": "query",
|
"in": "query",
|
||||||
"description": "A list of MarketplaceId values. Used to select orders that were placed in the specified marketplaces.",
|
"description": "A list of MarketplaceId values. Used to select orders that were placed in the specified marketplaces.\n\nSee the [Selling Partner API Developer Guide](https://github.com/amzn/selling-partner-api-docs/blob/main/guides/en-US/developer-guide/SellingPartnerApiDeveloperGuide.md#marketplaceid-values) for a complete list of marketplaceId values.",
|
||||||
"required": true,
|
"required": true,
|
||||||
"type": "array",
|
"type": "array",
|
||||||
"items": {
|
"items": {
|
||||||
|
@ -300,7 +300,10 @@
|
||||||
"FulfillmentInstruction": {
|
"FulfillmentInstruction": {
|
||||||
"FulfillmentSupplySourceId": "sampleSupplySourceId"
|
"FulfillmentSupplySourceId": "sampleSupplySourceId"
|
||||||
},
|
},
|
||||||
"IsISPU": false
|
"IsISPU": false,
|
||||||
|
"AutomatedShippingSettings": {
|
||||||
|
"HasAutomatedShippingSettings": false
|
||||||
|
}
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"AmazonOrderId": "902-8745147-1934268",
|
"AmazonOrderId": "902-8745147-1934268",
|
||||||
|
@ -625,6 +628,9 @@
|
||||||
"CompanyLegalName": "A Company Name"
|
"CompanyLegalName": "A Company Name"
|
||||||
},
|
},
|
||||||
"PurchaseOrderNumber": "1234567890123"
|
"PurchaseOrderNumber": "1234567890123"
|
||||||
|
},
|
||||||
|
"AutomatedShippingSettings": {
|
||||||
|
"HasAutomatedShippingSettings": false
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -694,7 +700,10 @@
|
||||||
"FulfillmentInstruction": {
|
"FulfillmentInstruction": {
|
||||||
"FulfillmentSupplySourceId": "sampleSupplySourceId"
|
"FulfillmentSupplySourceId": "sampleSupplySourceId"
|
||||||
},
|
},
|
||||||
"IsISPU": false
|
"IsISPU": false,
|
||||||
|
"AutomatedShippingSettings": {
|
||||||
|
"HasAutomatedShippingSettings": false
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
@ -751,7 +760,10 @@
|
||||||
"FulfillmentInstruction": {
|
"FulfillmentInstruction": {
|
||||||
"FulfillmentSupplySourceId": "sampleSupplySourceId"
|
"FulfillmentSupplySourceId": "sampleSupplySourceId"
|
||||||
},
|
},
|
||||||
"IsISPU": false
|
"IsISPU": false,
|
||||||
|
"AutomatedShippingSettings": {
|
||||||
|
"HasAutomatedShippingSettings": false
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@ -1741,9 +1753,249 @@
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
},
|
||||||
|
"/orders/v0/orders/{orderId}/shipment": {
|
||||||
|
"post": {
|
||||||
|
"tags": [
|
||||||
|
"shipment"
|
||||||
|
],
|
||||||
|
"description": "Update the shipment status.",
|
||||||
|
"operationId": "updateShipmentStatus",
|
||||||
|
"parameters": [
|
||||||
|
{
|
||||||
|
"name": "orderId",
|
||||||
|
"in": "path",
|
||||||
|
"description": "An Amazon-defined order identifier, in 3-7-7 format.",
|
||||||
|
"required": true,
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "payload",
|
||||||
|
"in": "body",
|
||||||
|
"description": "Request to update the shipment status.",
|
||||||
|
"required": true,
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusRequest"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"responses": {
|
||||||
|
"204": {
|
||||||
|
"description": "Success.",
|
||||||
|
"x-amzn-api-sandbox": {
|
||||||
|
"static": [
|
||||||
|
{
|
||||||
|
"request": {
|
||||||
|
"parameters": {}
|
||||||
|
},
|
||||||
|
"response": {}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RateLimit-Limit": {
|
||||||
|
"description": "Your rate limit (requests per second) for this operation.",
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"400": {
|
||||||
|
"description": "Request has missing or invalid parameters and cannot be parsed.",
|
||||||
|
"x-amzn-api-sandbox": {
|
||||||
|
"static": [
|
||||||
|
{
|
||||||
|
"request": {
|
||||||
|
"parameters": {
|
||||||
|
"body": {
|
||||||
|
"value": {
|
||||||
|
"marketplaceId": "1",
|
||||||
|
"shipmentStatus": "ReadyForPickup"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"response": {
|
||||||
|
"errors": [
|
||||||
|
{
|
||||||
|
"code": "InvalidInput",
|
||||||
|
"message": "Marketplace id is not defined",
|
||||||
|
"details": "1001"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RateLimit-Limit": {
|
||||||
|
"description": "Your rate limit (requests per second) for this operation.",
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"403": {
|
||||||
|
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"404": {
|
||||||
|
"description": "The resource specified does not exist.",
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RateLimit-Limit": {
|
||||||
|
"description": "Your rate limit (requests per second) for this operation.",
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"413": {
|
||||||
|
"description": "The request size exceeded the maximum accepted size.",
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"415": {
|
||||||
|
"description": "The request payload is in an unsupported format.",
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"429": {
|
||||||
|
"description": "The frequency of requests was greater than allowed.",
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"500": {
|
||||||
|
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusErrorResponse"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"503": {
|
||||||
|
"description": "Temporary overloading or maintenance of the server.",
|
||||||
|
"headers": {
|
||||||
|
"x-amzn-RequestId": {
|
||||||
|
"description": "Unique request reference ID.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"schema": {
|
||||||
|
"$ref": "#/definitions/UpdateShipmentStatusErrorResponse"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"definitions": {
|
"definitions": {
|
||||||
|
"UpdateShipmentStatusRequest": {
|
||||||
|
"description": "Request to update the status of shipment of an order.",
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"marketplaceId": {
|
||||||
|
"$ref": "#/definitions/MarketplaceId"
|
||||||
|
},
|
||||||
|
"shipmentStatus": {
|
||||||
|
"$ref": "#/definitions/ShipmentStatus"
|
||||||
|
},
|
||||||
|
"orderItems": {
|
||||||
|
"$ref": "#/definitions/OrderItems"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"required": [
|
||||||
|
"marketplaceId",
|
||||||
|
"shipmentStatus"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"MarketplaceId": {
|
||||||
|
"description": "the unobfuscated marketplace ID",
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"ShipmentStatus": {
|
||||||
|
"description": "the status of the shipment of the order to be updated",
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"ReadyForPickup",
|
||||||
|
"PickedUp",
|
||||||
|
"RefusedPickup"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"OrderItems": {
|
||||||
|
"description": "the list of order items and quantities when the seller wants to partially update the shipment status of the order",
|
||||||
|
"type": "array",
|
||||||
|
"items": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"orderItemId": {
|
||||||
|
"description": "the unique identifier for the order item",
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"quantity": {
|
||||||
|
"type": "integer",
|
||||||
|
"description": "the quantity of items that needs an update of the shipment status"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"UpdateShipmentStatusErrorResponse": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"errors": {
|
||||||
|
"description": "One or more unexpected errors occurred during the UpdateShipmentStatus operation.",
|
||||||
|
"$ref": "#/definitions/ErrorList"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"description": "The error response schema for the UpdateShipmentStatus operation."
|
||||||
|
},
|
||||||
"GetOrdersResponse": {
|
"GetOrdersResponse": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"properties": {
|
"properties": {
|
||||||
|
@ -2110,6 +2362,28 @@
|
||||||
"description": "The recommended location for the seller to ship the items from. It is calculated at checkout. The seller may or may not choose to ship from this location.",
|
"description": "The recommended location for the seller to ship the items from. It is calculated at checkout. The seller may or may not choose to ship from this location.",
|
||||||
"$ref": "#/definitions/Address"
|
"$ref": "#/definitions/Address"
|
||||||
},
|
},
|
||||||
|
"BuyerInvoicePreference": {
|
||||||
|
"type": "string",
|
||||||
|
"enum": [
|
||||||
|
"INDIVIDUAL",
|
||||||
|
"BUSINESS"
|
||||||
|
],
|
||||||
|
"x-docgen-enum-table-extension": [
|
||||||
|
{
|
||||||
|
"value": "INDIVIDUAL",
|
||||||
|
"description": "Buyer should be issued an individual invoice."
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"value": "BUSINESS",
|
||||||
|
"description": "Buyer should be issued a business invoice. Tax information is available in BuyerTaxInformation structure."
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"description": "The buyer’s invoicing preference."
|
||||||
|
},
|
||||||
|
"BuyerTaxInformation": {
|
||||||
|
"description": "Contains the business invoice tax information.",
|
||||||
|
"$ref": "#/definitions/BuyerTaxInformation"
|
||||||
|
},
|
||||||
"FulfillmentInstruction": {
|
"FulfillmentInstruction": {
|
||||||
"description": "Contains the instructions about the fulfillment like where should it be fulfilled from.",
|
"description": "Contains the instructions about the fulfillment like where should it be fulfilled from.",
|
||||||
"$ref": "#/definitions/FulfillmentInstruction"
|
"$ref": "#/definitions/FulfillmentInstruction"
|
||||||
|
@ -2131,6 +2405,10 @@
|
||||||
},
|
},
|
||||||
"BuyerInfo": {
|
"BuyerInfo": {
|
||||||
"$ref": "#/definitions/BuyerInfo"
|
"$ref": "#/definitions/BuyerInfo"
|
||||||
|
},
|
||||||
|
"AutomatedShippingSettings": {
|
||||||
|
"description": "Contains information regarding the Shipping Settings Automaton program, such as whether the order's shipping settings were generated automatically, and what those settings are.",
|
||||||
|
"$ref": "#/definitions/AutomatedShippingSettings"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"description": "Order information."
|
"description": "Order information."
|
||||||
|
@ -2669,12 +2947,34 @@
|
||||||
},
|
},
|
||||||
"description": "Information about withheld taxes."
|
"description": "Information about withheld taxes."
|
||||||
},
|
},
|
||||||
|
"BuyerTaxInformation": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"BuyerLegalCompanyName": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Business buyer's company legal name."
|
||||||
|
},
|
||||||
|
"BuyerBusinessAddress": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Business buyer's address."
|
||||||
|
},
|
||||||
|
"BuyerTaxRegistrationId": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Business buyer's tax registration ID."
|
||||||
|
},
|
||||||
|
"BuyerTaxOffice": {
|
||||||
|
"type": "string",
|
||||||
|
"description": "Business buyer's tax office."
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"description": "Contains the business invoice tax information."
|
||||||
|
},
|
||||||
"FulfillmentInstruction": {
|
"FulfillmentInstruction": {
|
||||||
"type": "object",
|
"type": "object",
|
||||||
"properties": {
|
"properties": {
|
||||||
"FulfillmentSupplySourceId": {
|
"FulfillmentSupplySourceId": {
|
||||||
"type": "string",
|
"description": "Denotes the recommended sourceId where the order should be fulfilled from.",
|
||||||
"description": "Denotes the recommended sourceId where the order should be fulfilled from."
|
"type": "string"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"description": "Contains the instructions about the fulfillment like where should it be fulfilled from."
|
"description": "Contains the instructions about the fulfillment like where should it be fulfilled from."
|
||||||
|
@ -2731,6 +3031,24 @@
|
||||||
},
|
},
|
||||||
"description": "A single item's buyer information."
|
"description": "A single item's buyer information."
|
||||||
},
|
},
|
||||||
|
"AutomatedShippingSettings": {
|
||||||
|
"description": "Contains information regarding the Shipping Settings Automation program, such as whether the order's shipping settings were generated automatically, and what those settings are.",
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"HasAutomatedShippingSettings": {
|
||||||
|
"description": "If true, this order has automated shipping settings generated by Amazon. This order could be identified as an SSA order.",
|
||||||
|
"type": "boolean"
|
||||||
|
},
|
||||||
|
"AutomatedCarrier": {
|
||||||
|
"description": "Auto-generated carrier for SSA orders.",
|
||||||
|
"type": "string"
|
||||||
|
},
|
||||||
|
"AutomatedShipMethod": {
|
||||||
|
"description": "Auto-generated ship method for SSA orders.",
|
||||||
|
"type": "string"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
"ErrorList": {
|
"ErrorList": {
|
||||||
"type": "array",
|
"type": "array",
|
||||||
"description": "A list of error responses returned when a request is unsuccessful.",
|
"description": "A list of error responses returned when a request is unsuccessful.",
|
||||||
|
|
Loading…
Reference in New Issue