wezone
/
selling-partner-api-models
mirror of https://github.com/amzn/selling-partner-api-models.git
10
0
Fork 0
Code Issues Projects Releases Wiki Activity
selling-partner-api-models/merchant-fulfillment-api-model/merchantFulfillmentV0.json

3346 lines
119 KiB
JSON
Raw Normal View History

Initial commit
2020-07-30 08:33:17 +08:00
{
"swagger": "2.0",
"info": {
"description": "The Selling Partner API for Merchant Fulfillment helps you build applications that let sellers purchase shipping for non-Prime and Prime orders using Amazon’s Buy Shipping Services.",
"version": "v0",
"title": "Selling Partner API for Merchant Fulfillment",
"contact": {
"name": "Selling Partner API Test Support",
"url": "https://github.com/amzn/amazon-marketplace-api-sdk/issues",
"email": "marketplaceapitest@amazon.com"
},
"license": {
"name": "Amazon Software License",
"url": "https://aws.amazon.com/asl/"
}
},
"host": "sellingpartnerapi-na.amazon.com",
"schemes": [
"https"
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"paths": {
"/mfn/v0/eligibleServices": {
"post": {
"tags": [
"merchantFulfillment"
],
"description": "Returns a list of shipping service offers that satisfy the specified shipment request details.",
"operationId": "getEligibleShipmentServicesOld",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"description": "Request schema.",
"$ref": "#/definitions/GetEligibleShipmentServicesRequest"
}
}
],
"responses": {
"200": {
"description": "Success",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShipmentRequestDetails": {
"AmazonOrderId": "903-5563053-5647845",
"ItemList": [
{
"OrderItemId": "52986411826454",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"PackageDimensions": {
"Length": 10,
"Width": 10,
"Height": 10,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"CarrierWillPickUpOption": "ShipperWillDropOff"
}
}
}
}
}
},
"response": {
"payload": {
"ShippingServiceList": [
{
"ShippingServiceName": "UPS 2nd Day Air",
"CarrierName": "UPS",
"ShippingServiceId": "UPS_PTP_2ND_DAY_AIR",
"ShippingServiceOfferId": "WHgxtyn6qjGGaCzOCog1azF5HLHje5Pz3Lc2Fmt5eKoZAReW8oJ1SMumuBS8lA/Hjuglhyiu0+KRLvyJxFV0PB9YFMDhygs3VyTL0WGYkGxiuRkmuEvpqldUn9rrkWVodqnR4vx2VtXvtER/Ju6RqYoddJZGy6RS2KLzzhQ2NclN0NYXMZVqpOe5RsRBddXaGuJr7oza3M52+JzChocAHzcurIhCRynpbxfmNLzZMQEbgnpGLzuaoSMzfxg90/NaXFR/Ou01du/uKd5AbfMW/AxAKP9ht6Oi9lDHq6WkGqvjkVLW0/jj/fBgblIwcs+t",
"ShipDate": "2019-10-28T16:36:36Z",
"EarliestEstimatedDeliveryDate": "2019-10-31T06:00:00Z",
"LatestEstimatedDeliveryDate": "2019-10-31T06:00:00Z",
"Rate": {
"CurrencyCode": "USD",
"Amount": 34.73
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"LabelFormat": ""
},
"AvailableLabelFormats": [
"ZPL203",
"ShippingServiceDefault",
"PDF",
"PNG"
],
"AvailableFormatOptionsForLabel": [
{
"LabelFormat": "ZPL203"
},
{
"LabelFormat": "ShippingServiceDefault"
},
{
"LabelFormat": "PDF"
},
{
"LabelFormat": "PNG"
}
]
},
{
"ShippingServiceName": "UPS Next Day Air Saver",
"CarrierName": "UPS",
"ShippingServiceId": "UPS_PTP_NEXT_DAY_AIR_SAVER",
"ShippingServiceOfferId": "WHgxtyn6qjGGaCzOCog1azF5HLHje5Pz3Lc2Fmt5eKqqhKGQ2YZmuxsXKVXmdgdWNvfxb1qfm5bGm8NuqlqnNT3eTiJ4viTctepggbeUKUSykClJ+Qmw43zdA8wsgREhQCmb4Bbo/skapLQS1F9uwH2FgY5SfMsj/egudyocpVRT45KSQAT0H5YiXW3OyyRAae9fZ0RzDJAABHiisOyYyXnB1mtWOZqc7rlGR4yyqN7jmiT4t8dmuGPX7ptY4qskrN+6VHZO9bM9tdDS0ysHhAVv4jO3Q5sWFg4nEPaARWSsrpa6zSGMLxAOj56O3tcP",
"ShipDate": "2019-10-28T16:36:36Z",
"EarliestEstimatedDeliveryDate": "2019-10-30T06:00:00Z",
"LatestEstimatedDeliveryDate": "2019-10-30T06:00:00Z",
"Rate": {
"CurrencyCode": "USD",
"Amount": 98.75
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"LabelFormat": ""
},
"AvailableLabelFormats": [
"ZPL203",
"ShippingServiceDefault",
"PDF",
"PNG"
],
"AvailableFormatOptionsForLabel": [
{
"LabelFormat": "ZPL203"
},
{
"LabelFormat": "ShippingServiceDefault"
},
{
"LabelFormat": "PDF"
},
{
"LabelFormat": "PNG"
}
]
}
],
"TemporarilyUnavailableCarrierList": [
{
"CarrierName": "UPS"
},
{
"CarrierName": "DHLECOMMERCE"
}
],
"TermsAndConditionsNotAcceptedCarrierList": [
{
"CarrierName": "YANWEN"
},
{
"CarrierName": "CHINA_POST"
}
]
}
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShipmentRequestDetails": {
"AmazonOrderId": "TEST_CASE_400",
"ItemList": [
{
"OrderItemId": "52986411826454",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "USA",
"Phone": "7132341234"
},
"PackageDimensions": {
"Length": 10,
"Width": 10,
"Height": 10,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"CarrierWillPickUpOption": "ShipperWillDropOff"
}
}
}
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "1 validation error detected: Value 'USA' at 'shipmentRequestDetails.shipFromAddress.countryCode' failed to satisfy constraint: Member must have length less than or equal to 2",
"details": ""
}
]
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The specified resource does not exist.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
},
"parameters": []
},
"/mfn/v0/eligibleShippingServices": {
"post": {
"tags": [
"merchantFulfillment"
],
"description": "Returns a list of shipping service offers that satisfy the specified shipment request details.",
"operationId": "getEligibleShipmentServices",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"description": "Request schema.",
"$ref": "#/definitions/GetEligibleShipmentServicesRequest"
}
}
],
"responses": {
"200": {
"description": "Success",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShipmentRequestDetails": {
"AmazonOrderId": "903-5563053-5647845",
"ItemList": [
{
"OrderItemId": "52986411826454",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"PackageDimensions": {
"Length": 10,
"Width": 10,
"Height": 10,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"CarrierWillPickUpOption": "ShipperWillDropOff"
}
}
}
}
}
},
"response": {
"payload": {
"ShippingServiceList": [
{
"ShippingServiceName": "UPS 2nd Day Air",
"CarrierName": "UPS",
"ShippingServiceId": "UPS_PTP_2ND_DAY_AIR",
"ShippingServiceOfferId": "WHgxtyn6qjGGaCzOCog1azF5HLHje5Pz3Lc2Fmt5eKoZAReW8oJ1SMumuBS8lA/Hjuglhyiu0+KRLvyJxFV0PB9YFMDhygs3VyTL0WGYkGxiuRkmuEvpqldUn9rrkWVodqnR4vx2VtXvtER/Ju6RqYoddJZGy6RS2KLzzhQ2NclN0NYXMZVqpOe5RsRBddXaGuJr7oza3M52+JzChocAHzcurIhCRynpbxfmNLzZMQEbgnpGLzuaoSMzfxg90/NaXFR/Ou01du/uKd5AbfMW/AxAKP9ht6Oi9lDHq6WkGqvjkVLW0/jj/fBgblIwcs+t",
"ShipDate": "2019-10-28T16:36:36Z",
"EarliestEstimatedDeliveryDate": "2019-10-31T06:00:00Z",
"LatestEstimatedDeliveryDate": "2019-10-31T06:00:00Z",
"Rate": {
"CurrencyCode": "USD",
"Amount": 34.73
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"LabelFormat": ""
},
"AvailableLabelFormats": [
"ZPL203",
"ShippingServiceDefault",
"PDF",
"PNG"
],
"AvailableFormatOptionsForLabel": [
{
"LabelFormat": "ZPL203"
},
{
"LabelFormat": "ShippingServiceDefault"
},
{
"LabelFormat": "PDF"
},
{
"LabelFormat": "PNG"
}
]
},
{
"ShippingServiceName": "UPS Next Day Air Saver",
"CarrierName": "UPS",
"ShippingServiceId": "UPS_PTP_NEXT_DAY_AIR_SAVER",
"ShippingServiceOfferId": "WHgxtyn6qjGGaCzOCog1azF5HLHje5Pz3Lc2Fmt5eKqqhKGQ2YZmuxsXKVXmdgdWNvfxb1qfm5bGm8NuqlqnNT3eTiJ4viTctepggbeUKUSykClJ+Qmw43zdA8wsgREhQCmb4Bbo/skapLQS1F9uwH2FgY5SfMsj/egudyocpVRT45KSQAT0H5YiXW3OyyRAae9fZ0RzDJAABHiisOyYyXnB1mtWOZqc7rlGR4yyqN7jmiT4t8dmuGPX7ptY4qskrN+6VHZO9bM9tdDS0ysHhAVv4jO3Q5sWFg4nEPaARWSsrpa6zSGMLxAOj56O3tcP",
"ShipDate": "2019-10-28T16:36:36Z",
"EarliestEstimatedDeliveryDate": "2019-10-30T06:00:00Z",
"LatestEstimatedDeliveryDate": "2019-10-30T06:00:00Z",
"Rate": {
"CurrencyCode": "USD",
"Amount": 98.75
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"LabelFormat": ""
},
"AvailableLabelFormats": [
"ZPL203",
"ShippingServiceDefault",
"PDF",
"PNG"
],
"AvailableFormatOptionsForLabel": [
{
"LabelFormat": "ZPL203"
},
{
"LabelFormat": "ShippingServiceDefault"
},
{
"LabelFormat": "PDF"
},
{
"LabelFormat": "PNG"
}
]
}
],
"TemporarilyUnavailableCarrierList": [
{
"CarrierName": "UPS"
},
{
"CarrierName": "DHLECOMMERCE"
}
],
"TermsAndConditionsNotAcceptedCarrierList": [
{
"CarrierName": "YANWEN"
},
{
"CarrierName": "CHINA_POST"
}
]
}
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShipmentRequestDetails": {
"AmazonOrderId": "TEST_CASE_400",
"ItemList": [
{
"OrderItemId": "52986411826454",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "USA",
"Phone": "7132341234"
},
"PackageDimensions": {
"Length": 10,
"Width": 10,
"Height": 10,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"CarrierWillPickUpOption": "ShipperWillDropOff"
}
}
}
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "1 validation error detected: Value 'USA' at 'shipmentRequestDetails.shipFromAddress.countryCode' failed to satisfy constraint: Member must have length less than or equal to 2",
"details": ""
}
]
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The specified resource does not exist.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/GetEligibleShipmentServicesResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
},
"parameters": []
},
"/mfn/v0/shipments/{shipmentId}": {
"get": {
"tags": [
"merchantFulfillment"
],
"description": "Returns the shipment information for an existing shipment.",
"operationId": "getShipment",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"description": "The Amazon-defined shipment identifier for the shipment.",
"required": true,
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"
}
],
"responses": {
"200": {
"description": "Success",
"x-amazon-spds-sandbox-behavior": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "abcddcba-00c3-4f6f-a63a-639f76ee9253"
}
}
},
"response": {
"payload": {
"ShipmentId": "abcddcba-00c3-4f6f-a63a-639f76ee9253",
"AmazonOrderId": "903-5563053-5647845",
"SellerOrderId": "903-5563053-5647845",
"Insurance": {
"CurrencyCode": "USD",
"Amount": 0.0
},
"ItemList": [
{
"OrderItemId": "12958298061782",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"ShipToAddress": {
"Name": "New York",
"AddressLine1": "TIME WARNER CENTER",
"AddressLine2": "10 COLUMBUS CIR",
"Email": "",
"City": "NEW YORK",
"StateOrProvinceCode": "NY",
"PostalCode": "10019-1158",
"CountryCode": "US",
"Phone": ""
},
"PackageDimensions": {
"Length": 10.0,
"Width": 10.0,
"Height": 10.0,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingService": {
"ShippingServiceName": "UPS 2nd Day Air",
"CarrierName": "UPS",
"ShippingServiceId": "UPS_PTP_2ND_DAY_AIR",
"ShippingServiceOfferId": "",
"ShipDate": "2019-10-28T18:00:00Z",
"Rate": {
"CurrencyCode": "USD",
"Amount": 34.73
},
"ShippingServiceOptions": {
"DeliveryExperience": "DeliveryConfirmationWithoutSignature",
"DeclaredValue": {
"CurrencyCode": "USD",
"Amount": 0.0
}
},
"RequiresAdditionalSellerInputs": false
},
"Label": {
"Dimensions": {
"Length": 6.0,
"Width": 4.0,
"Unit": "inches"
},
"FileContents": {
"Contents": "H4sIAAAAAAAAAOS6dV",
"FileType": "image/png",
"Checksum": "9ALVyphCKfc3+Lb2ssyh8A=="
}
},
"Status": "Purchased",
"TrackingId": "1Z17E2100206868939",
"CreatedDate": "2019-10-28T18:29:34Z",
"LastUpdatedDate": "2019-10-28T18:30:35Z"
}
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"x-amazon-spds-sandbox-behavior": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "aabbccdd-1beb-4cda-8bf4-7366cfddbec1"
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "1 validation error detected: Value 'TEST_CASE_400' at 'shipmentId' failed to satisfy constraint: Member must satisfy regular expression pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"details": ""
}
]
}
}
],
"schema": {
"$ref": "#/definitions/GetShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/GetShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/GetShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The specified resource does not exist.",
"schema": {
"$ref": "#/definitions/GetShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/GetShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/GetShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/GetShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
},
"delete": {
"tags": [
"merchantFulfillment"
],
"description": "Cancel the shipment indicated by the specified shipment identifier.",
"operationId": "cancelShipment",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"description": "The Amazon-defined shipment identifier for the shipment to cancel.",
"required": true,
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"
}
],
"responses": {
"200": {
"description": "Success",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "be7a0a53-00c3-4f6f-a63a-639f76ee9253"
}
}
},
"response": {
"payload": {
"ShipmentId": "be7a0a53-00c3-4f6f-a63a-639f76ee9253",
"AmazonOrderId": "903-5563053-5647845",
"SellerOrderId": "903-5563053-5647845",
"Insurance": {
"CurrencyCode": "USD",
"Amount": 0.0
},
"ItemList": [
{
"OrderItemId": "12958298061782",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"ShipToAddress": {
"Name": "New York",
"AddressLine1": "TIME WARNER CENTER",
"AddressLine2": "10 COLUMBUS CIR",
"Email": "",
"City": "NEW YORK",
"StateOrProvinceCode": "NY",
"PostalCode": "10019-1158",
"CountryCode": "US",
"Phone": ""
},
"PackageDimensions": {
"Length": 10.0,
"Width": 10.0,
"Height": 10.0,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingService": {
"ShippingServiceName": "UPS 2nd Day Air",
"CarrierName": "UPS",
"ShippingServiceId": "UPS_PTP_2ND_DAY_AIR",
"ShippingServiceOfferId": "",
"ShipDate": "2019-10-28T18:00:00Z",
"Rate": {
"CurrencyCode": "USD",
"Amount": 34.73
},
"ShippingServiceOptions": {
"DeliveryExperience": "DeliveryConfirmationWithoutSignature",
"DeclaredValue": {
"CurrencyCode": "USD",
"Amount": 0.0
}
},
"RequiresAdditionalSellerInputs": false
},
"Label": {
"Dimensions": {},
"FileContents": {
"Contents": "",
"FileType": "",
"Checksum": ""
}
},
"Status": "RefundPending",
"TrackingId": "1Z17E2100206868939",
"CreatedDate": "2019-10-28T18:29:34Z",
"LastUpdatedDate": "2019-10-28T18:36:55Z"
}
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "87d20cf7-1beb-4cda-8bf4-7366cfddbec1"
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "1 validation error detected: Value 'TEST_CASE_400' at 'shipmentId' failed to satisfy constraint: Member must satisfy regular expression pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"details": ""
}
]
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
},
"parameters": []
},
"/mfn/v0/shipments/{shipmentId}/cancel": {
"put": {
"tags": [
"merchantFulfillment"
],
"description": "Cancel the shipment indicated by the specified shipment identifer.",
"operationId": "cancelShipmentOld",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"description": "The Amazon-defined shipment identifier for the shipment to cancel.",
"required": true,
"type": "string",
"pattern": "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}"
}
],
"responses": {
"200": {
"description": "Success",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "be7a0a53-00c3-4f6f-a63a-639f76ee9253"
}
}
},
"response": {
"payload": {
"ShipmentId": "be7a0a53-00c3-4f6f-a63a-639f76ee9253",
"AmazonOrderId": "903-5563053-5647845",
"SellerOrderId": "903-5563053-5647845",
"Insurance": {
"CurrencyCode": "USD",
"Amount": 0.0
},
"ItemList": [
{
"OrderItemId": "12958298061782",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"ShipToAddress": {
"Name": "New York",
"AddressLine1": "TIME WARNER CENTER",
"AddressLine2": "10 COLUMBUS CIR",
"Email": "",
"City": "NEW YORK",
"StateOrProvinceCode": "NY",
"PostalCode": "10019-1158",
"CountryCode": "US",
"Phone": ""
},
"PackageDimensions": {
"Length": 10.0,
"Width": 10.0,
"Height": 10.0,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingService": {
"ShippingServiceName": "UPS 2nd Day Air",
"CarrierName": "UPS",
"ShippingServiceId": "UPS_PTP_2ND_DAY_AIR",
"ShippingServiceOfferId": "",
"ShipDate": "2019-10-28T18:00:00Z",
"Rate": {
"CurrencyCode": "USD",
"Amount": 34.73
},
"ShippingServiceOptions": {
"DeliveryExperience": "DeliveryConfirmationWithoutSignature",
"DeclaredValue": {
"CurrencyCode": "USD",
"Amount": 0.0
}
},
"RequiresAdditionalSellerInputs": false
},
"Label": {
"Dimensions": {},
"FileContents": {
"Contents": "",
"FileType": "",
"Checksum": ""
}
},
"Status": "RefundPending",
"TrackingId": "1Z17E2100206868939",
"CreatedDate": "2019-10-28T18:29:34Z",
"LastUpdatedDate": "2019-10-28T18:36:55Z"
}
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "87d20cf7-1beb-4cda-8bf4-7366cfddbec1"
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "1 validation error detected: Value 'TEST_CASE_400' at 'shipmentId' failed to satisfy constraint: Member must satisfy regular expression pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
"details": ""
}
]
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The specified resource does not exist.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/CancelShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
},
"parameters": []
},
"/mfn/v0/shipments": {
"post": {
"tags": [
"merchantFulfillment"
],
"description": "Create a shipment with the information provided.",
"operationId": "createShipment",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"$ref": "#/definitions/CreateShipmentRequest"
}
}
],
"responses": {
"200": {
"description": "Success",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShipmentRequestDetails": {
"AmazonOrderId": "903-5563053-5647845",
"ItemList": [
{
"OrderItemId": "52986411826454",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"PackageDimensions": {
"Length": 10,
"Width": 10,
"Height": 10,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"CarrierWillPickUpOption": "ShipperWillDropOff"
}
},
"ShippingServiceId": "UPS_PTP_2ND_DAY_AIR",
"ShippingServiceOfferId": "WHgxtyn6qjGGaCzOCog1azF5HLHje5Pz3Lc2Fmt5eKoZAReW8oJ1SMumuBS8lA/Hjuglhyiu0+KRLvyJxFV0PB9YFMDhygs3VyTL0WGYkGxiuRkmuEvpqldUn9rrkWVodqnR4vx2VtXvtER/Ju6RqYoddJZGy6RS2KLzzhQ2NclN0NYXMZVqpOe5RsRBddXaGuJr7oza3M52+JzChocAHzcurIhCRynpbxfmNLzZMQEbgnpGLzuaoSMzfxg90/NaXFR/Ou01du/uKd5AbfMW/AxAKP9ht6Oi9lDHq6WkGqvjkVLW0/jj/fBgblIwcs+t"
}
}
}
},
"response": {
"payload": {
"ShipmentId": "be7a0a53-00c3-4f6f-a63a-639f76ee9253",
"AmazonOrderId": "903-5563053-5647845",
"Insurance": {
"CurrencyCode": "USD",
"Amount": 0
},
"ItemList": [
{
"OrderItemId": "12958298061782",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"ShipToAddress": {
"Name": "New York",
"AddressLine1": "TIME WARNER CENTER",
"AddressLine2": "10 COLUMBUS CIR",
"Email": "",
"City": "NEW YORK",
"StateOrProvinceCode": "NY",
"PostalCode": "10019-1158",
"CountryCode": "US",
"Phone": ""
},
"PackageDimensions": {
"Length": 10,
"Width": 10,
"Height": 10,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingService": {
"ShippingServiceName": "UPS 2nd Day Air",
"CarrierName": "UPS",
"ShippingServiceId": "UPS_PTP_2ND_DAY_AIR",
"ShippingServiceOfferId": "WHgxtyn6qjGGaCzOCog1azF5HLHje5Pz3Lc2Fmt5eKoZAReW8oJ1SMumuBS8lA/Hjuglhyiu0+KRLvyJxFV0PB9YFMDhygs3VyTL0WGYkGxiuRkmuEvpqldUn9rrkWVodqnR4vx2VtXvtER/Ju6RqYoddJZGy6RS2KLzzhQ2NclN0NYXMZVqpOe5RsRBddXaGuJr7oza3M52+JzChocAHzcurIhCRynpbxfmNLzZMQEbgnpGLzuaoSMzfxg90/NaXFR/Ou01du/uKd5AbfMW/AxAKP9ht6Oi9lDHq6WkGqvjkVLW0/jj/fBgblIwcs+t",
"ShipDate": "2019-10-28T16:37:37Z",
"EarliestEstimatedDeliveryDate": "2019-10-30T07:00:00Z",
"LatestEstimatedDeliveryDate": "2019-10-30T07:00:00Z",
"Rate": {
"CurrencyCode": "USD",
"Amount": 34.73
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"DeclaredValue": {
"CurrencyCode": "USD",
"Amount": 0
}
},
"RequiresAdditionalSellerInputs": false
},
"Label": {
"Dimensions": {
"Length": 6.0,
"Width": 4.0,
"Unit": "inches"
},
"FileContents": {
"Contents": "H4sIAAAAAAAAAOR",
"FileType": "image/png",
"Checksum": "d+eUxK5WTGxkGsTF0pmefQ=="
},
"LabelFormat": "PNG"
},
"Status": "Purchased",
"TrackingId": "1Z17E2100217295733",
"CreatedDate": "2019-10-28T16:37:43Z"
}
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/CreateShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShipmentRequestDetails": {
"AmazonOrderId": "TEST_CASE_400",
"ItemList": [
{
"OrderItemId": "52986411826454",
"Quantity": 1
}
],
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "USA",
"Phone": "7132341234"
},
"PackageDimensions": {
"Length": 10,
"Width": 10,
"Height": 10,
"Unit": "inches"
},
"Weight": {
"Value": 10,
"Unit": "oz"
},
"ShippingServiceOptions": {
"DeliveryExperience": "NoTracking",
"CarrierWillPickUp": false,
"CarrierWillPickUpOption": "ShipperWillDropOff"
}
},
"ShippingServiceId": "UPS_PTP_2ND_DAY_AIR",
"ShippingServiceOfferId": "WHgxtyn6qjGGaCzOCog1azF5HLHje5Pz3Lc2Fmt5eKoZAReW8oJ1SMumuBS8lA/Hjuglhyiu0+KRLvyJxFV0PB9YFMDhygs3VyTL0WGYkGxiuRkmuEvpqldUn9rrkWVodqnR4vx2VtXvtER/Ju6RqYoddJZGy6RS2KLzzhQ2NclN0NYXMZVqpOe5RsRBddXaGuJr7oza3M52+JzChocAHzcurIhCRynpbxfmNLzZMQEbgnpGLzuaoSMzfxg90/NaXFR/Ou01du/uKd5AbfMW/AxAKP9ht6Oi9lDHq6WkGqvjkVLW0/jj/fBgblIwcs+t"
}
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "1 validation error detected: Value 'USA' at 'shipmentRequestDetails.shipFromAddress.countryCode' failed to satisfy constraint: Member must have length less than or equal to 2",
"details": ""
}
]
}
}
],
"schema": {
"$ref": "#/definitions/CreateShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/CreateShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/CreateShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The specified resource does not exist.",
"schema": {
"$ref": "#/definitions/CreateShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/CreateShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/CreateShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/CreateShipmentResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
},
"parameters": []
},
"/mfn/v0/sellerInputs": {
"post": {
"tags": [
"merchantFulfillment"
],
"description": "Get a list of additional seller inputs required for a ship method. This is generally used for international shipping.",
"operationId": "getAdditionalSellerInputsOld",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsRequest"
}
}
],
"responses": {
"200": {
"description": "Success",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShippingServiceId": "UPS_PTP_GND",
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"OrderId": "903-5563053-5647845"
}
}
}
},
"response": {
"payload": {
"ShipmentLevelFields": [
{
"AdditionalInputFieldName": "John Doe"
}
],
"ItemLevelFieldsList": [
{
"Asin": "ASIN_ID_200",
"AdditionalInputs": [
]
}
]
}
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShippingServiceId": "UPS_PTP_GND",
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "XX",
"Phone": "7132341234"
},
"OrderId": "901-5563053-5647845"
}
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "Invalid Ship From Address when calling GetAdditionalSellerInputs",
"details": ""
}
]
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The specified resource does not exist.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
},
"parameters": []
},
"/mfn/v0/additionalSellerInputs": {
"post": {
"tags": [
"merchantFulfillment"
],
"description": "Gets a list of additional seller inputs required for a ship method. This is generally used for international shipping.",
"operationId": "getAdditionalSellerInputs",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsRequest"
}
}
],
"responses": {
"200": {
"description": "Success",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShippingServiceId": "UPS_PTP_GND",
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "US",
"Phone": "7132341234"
},
"OrderId": "903-5563053-5647845"
}
}
}
},
"response": {
"payload": {
"ShipmentLevelFields": [
{
"AdditionalInputFieldName": "John Doe"
}
],
"ItemLevelFieldsList": [
{
"Asin": "ASIN_ID_200",
"AdditionalInputs": [
]
}
]
}
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"x-amazon-spds-sandbox-behaviors": [
{
"request": {
"parameters": {
"body": {
"value": {
"ShippingServiceId": "UPS_PTP_GND",
"ShipFromAddress": {
"Name": "John Doe",
"AddressLine1": "300 Turnbull Ave",
"Email": "jdoeasdfllkj@yahoo.com",
"City": "Detroit",
"StateOrProvinceCode": "MI",
"PostalCode": "48123",
"CountryCode": "XX",
"Phone": "7132341234"
},
"OrderId": "901-5563053-5647845"
}
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "Invalid Ship From Address when calling GetAdditionalSellerInputs",
"details": ""
}
]
}
}
],
"schema": {
"description": "Response schema.",
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"404": {
"description": "The specified resource does not exist.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/GetAdditionalSellerInputsResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
}
}
}
},
"parameters": []
}
},
"definitions": {
"Error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"description": "An error code that identifies the type of error that occured."
},
"message": {
"type": "string",
"description": "A message that describes the error condition in a human-readable form."
},
"details": {
"type": "string",
"description": "Additional details that can help the caller understand or fix the issue."
}
},
"description": "Error response returned when the request is unsuccessful."
},
"ErrorList": {
"type": "array",
"description": "A list of error responses returned when a request is unsuccessful.",
"items": {
"$ref": "#/definitions/Error"
}
},
"LabelFormatOptionRequest": {
"type": "object",
"properties": {
"IncludePackingSlipWithLabel": {
"description": "When true, include a packing slip with the label.",
"type": "boolean"
}
}
},
"LabelFormatOption" : {
"type" : "object",
"properties" : {
"IncludePackingSlipWithLabel" : {
"description": "When true, include a packing slip with the label.",
"type" : "boolean"
},
"LabelFormat" : {
"$ref" : "#/definitions/LabelFormat"
}
}
},
"AvailableCarrierWillPickUpOption" : {
"description": "Indicates whether the carrier will pick up the package, and what fee is charged, if any.",
"type" : "object",
"required" : [ "CarrierWillPickUpOption", "Charge" ],
"properties" : {
"CarrierWillPickUpOption" : {
"$ref" : "#/definitions/CarrierWillPickUpOption"
},
"Charge" : {
"description": "The fee charged.",
"$ref" : "#/definitions/CurrencyAmount"
}
}
},
"AvailableCarrierWillPickUpOptionsList" : {
"description": "List of available carrier pickup options.",
"type" : "array",
"items" : {
"$ref" : "#/definitions/AvailableCarrierWillPickUpOption"
}
},
"AvailableDeliveryExperienceOption" : {
"description": "The available delivery confirmation options, and the fee charged, if any.",
"type" : "object",
"required" : [ "DeliveryExperienceOption", "Charge" ],
"properties" : {
"DeliveryExperienceOption" : {
"$ref" : "#/definitions/DeliveryExperienceOption"
},
"Charge" : {
"$ref" : "#/definitions/CurrencyAmount"
}
}
},
"AvailableDeliveryExperienceOptionsList" : {
"description": "List of available delivery experience options.",
"type" : "array",
"items" : {
"$ref" : "#/definitions/AvailableDeliveryExperienceOption"
}
},
"AvailableShippingServiceOptions" : {
"description": "The available shipping service options.",
"type" : "object",
"required" : [ "AvailableCarrierWillPickUpOptions", "AvailableDeliveryExperienceOptions" ],
"properties" : {
"AvailableCarrierWillPickUpOptions" : {
"$ref" : "#/definitions/AvailableCarrierWillPickUpOptionsList"
},
"AvailableDeliveryExperienceOptions" : {
"$ref" : "#/definitions/AvailableDeliveryExperienceOptionsList"
}
}
},
"AvailableFormatOptionsForLabel" : {
"$ref" : "#/definitions/AvailableFormatOptionsForLabelList"
},
"AvailableFormatOptionsForLabelList" : {
"description": "The available label formats.",
"type" : "array",
"items" : {
"$ref" : "#/definitions/LabelFormatOption"
}
},
"Constraint" : {
"description": "A validation constraint.",
"type" : "object",
"required" : [ "ValidationString" ],
"properties" : {
"ValidationRegEx" : {
"description": "A regular expression.",
"type" : "string"
},
"ValidationString" : {
"description": "A validation string.",
"type" : "string"
}
}
},
"Constraints" : {
"description": "List of constraints.",
"type" : "array",
"items" : {
"$ref" : "#/definitions/Constraint"
}
},
"AdditionalInputs" : {
"description": "Maps the additional seller input to the definition. The key to the map is the field name.",
"type" : "object",
"properties" : {
"AdditionalInputFieldName" : {
"description": "The field name.",
"type" : "string"
},
"SellerInputDefinition" : {
"$ref" : "#/definitions/SellerInputDefinition"
}
}
},
"SellerInputDefinition" : {
"description": "Specifies characteristics that apply to a seller input.",
"type" : "object",
"required" : [ "IsRequired", "DataType", "Constraints", "InputDisplayText", "StoredValue" ],
"properties" : {
"IsRequired" : {
"description": "When true, the additional input field is required.",
"type" : "boolean"
},
"DataType" : {
"description": "The data type of the additional input field.",
"type" : "string"
},
"Constraints" : {
"$ref" : "#/definitions/Constraints"
},
"InputDisplayText" : {
"description": "The display text for the additional input field.",
"type" : "string"
},
"InputTarget" : {
"description": "Whether the seller input applies to the item or the shipment. Possible values: SHIPMENT_LEVEL, ITEM_LEVEL.",
"$ref": "#/definitions/InputTargetType"
},
"StoredValue" : {
"$ref" : "#/definitions/AdditionalSellerInput"
},
"RestrictedSetValues" : {
"$ref" : "#/definitions/RestrictedSetValues"
}
}
},
"InputTargetType": {
"description": "InputTarget values.",
"type": "string",
"enum": [
"SHIPMENT_LEVEL",
"ITEM_LEVEL"
]
},
"AdditionalInputsList" : {
"description": "A list of additional inputs.",
"type" : "array",
"items" : {
"$ref" : "#/definitions/AdditionalInputs"
}
},
"AdditionalSellerInput": {
"description": "Additional information required to purchase shipping.",
"type": "object",
"properties": {
"DataType": {
"description": "The data type of the additional information.",
"type": "string"
},
"ValueAsString": {
"description": "The value when the data type is string.",
"type": "string"
},
"ValueAsBoolean": {
"description": "The value when the data type is boolean.",
"type": "boolean"
},
"ValueAsInteger": {
"description": "The value when the data type is integer.",
"type": "integer"
},
"ValueAsTimestamp": {
"description": "The value when the data type is a date-time formatted string.",
"$ref": "#/definitions/Timestamp"
},
"ValueAsAddress": {
"$ref": "#/definitions/Address"
},
"ValueAsWeight": {
"$ref": "#/definitions/Weight"
},
"ValueAsDimension": {
"$ref": "#/definitions/Length"
},
"ValueAsCurrency": {
"$ref": "#/definitions/CurrencyAmount"
}
}
},
"AdditionalSellerInputs": {
"description": "An additional set of seller inputs required to purchase shipping.",
"type": "object",
"required": [
"AdditionalInputFieldName",
"AdditionalSellerInput"
],
"properties": {
"AdditionalInputFieldName": {
"description": "The name of the additional input field.",
"type": "string"
},
"AdditionalSellerInput": {
"$ref": "#/definitions/AdditionalSellerInput"
}
}
},
"AdditionalSellerInputsList": {
"description": "A list of additional seller input pairs required to purchase shipping.",
"type": "array",
"items": {
"$ref": "#/definitions/AdditionalSellerInputs"
}
},
"Address": {
"description": "The postal address information.",
"type": "object",
"required": [
"AddressLine1",
"City",
"CountryCode",
"Email",
"Name",
"Phone",
"PostalCode"
],
"properties": {
"Name": {
"$ref": "#/definitions/AddressName"
},
"AddressLine1": {
"$ref": "#/definitions/AddressLine1"
},
"AddressLine2": {
"$ref": "#/definitions/AddressLine2"
},
"AddressLine3": {
"$ref": "#/definitions/AddressLine3"
},
"DistrictOrCounty": {
"$ref": "#/definitions/DistrictOrCounty"
},
"Email": {
"$ref": "#/definitions/EmailAddress"
},
"City": {
"$ref": "#/definitions/City"
},
"StateOrProvinceCode": {
"$ref": "#/definitions/StateOrProvinceCode"
},
"PostalCode": {
"$ref": "#/definitions/PostalCode"
},
"CountryCode": {
"$ref": "#/definitions/CountryCode"
},
"Phone": {
"$ref": "#/definitions/PhoneNumber"
}
}
},
"AddressLine1": {
"description": "The street address information.",
"type": "string",
"maxLength": 180
},
"AddressLine2": {
"description": "Additional street address information.",
"type": "string",
"maxLength": 60
},
"AddressLine3": {
"description": "Additional street address information.",
"type": "string",
"maxLength": 60
},
"AddressName": {
"description": "The name of the addressee, or business name.",
"type": "string",
"maxLength": 30
},
"AmazonOrderId": {
"description": "An Amazon-defined order identifier, in 3-7-7 format.",
"type": "string",
"pattern" : "[0-9A-Z]{3}-[0-9]{7}-[0-9]{7}"
},
"CancelShipmentResponse": {
"description": "Response schema.",
"type": "object",
"properties": {
"payload": {
"description": "The payload for the cancelShipment operation.",
"$ref": "#/definitions/Shipment"
},
"errors": {
"description": "One or more unexpected errors occurred during the cancelShipment operation.",
"$ref": "#/definitions/ErrorList"
}
}
},
"City": {
"description": "The city.",
"type": "string",
"maxLength": 30
},
"CountryCode": {
"description": "The country code. A two-character country code, in ISO 3166-1 alpha-2 format.",
"type": "string"
},
"CreateShipmentRequest": {
"description": "Request schema.",
"type": "object",
"required": [
"ShipmentRequestDetails",
"ShippingServiceId"
],
"properties": {
"ShipmentRequestDetails": {
"description": "Shipment information required for creating a shipment.",
"$ref": "#/definitions/ShipmentRequestDetails"
},
"ShippingServiceId": {
"$ref": "#/definitions/ShippingServiceIdentifier"
},
"ShippingServiceOfferId": {
"description": "Identifies a shipping service order made by a carrier.",
"type": "string"
},
"HazmatType": {
"description": "Hazardous materials options for a package. Consult the terms and conditions for each carrier for more information about hazardous materials.",
"$ref": "#/definitions/HazmatType"
},
"LabelFormatOption": {
"$ref": "#/definitions/LabelFormatOptionRequest"
},
"ShipmentLevelSellerInputsList": {
"description": "A list of additional seller inputs required to ship this shipment.",
"$ref": "#/definitions/AdditionalSellerInputsList"
}
}
},
"CreateShipmentResponse": {
"description": "Response schema.",
"type": "object",
"properties": {
"payload": {
"description": "Shipment information.",
"$ref": "#/definitions/Shipment"
},
"errors": {
"description": "One or more unexpected errors occurred during the createShipment operation.",
"$ref": "#/definitions/ErrorList"
}
}
},
"ItemLevelFields" : {
"type" : "object",
"required" : [ "Asin", "AdditionalInputs" ],
"properties" : {
"Asin" : {
"description": "The Amazon Standard Identification Number (ASIN) of the item.",
"type" : "string"
},
"AdditionalInputs" : {
"$ref" : "#/definitions/AdditionalInputsList"
}
}
},
"ItemLevelFieldsList" : {
"description": "A list of item level fields.",
"type" : "array",
"items" : {
"$ref" : "#/definitions/ItemLevelFields"
}
},
"GetAdditionalSellerInputsRequest" : {
"description": "Request schema.",
"type" : "object",
"required" : [ "ShippingServiceId", "ShipFromAddress", "OrderId" ],
"properties" : {
"ShippingServiceId" : {
"$ref" : "#/definitions/ShippingServiceIdentifier"
},
"ShipFromAddress" : {
"description": "The address from which to ship.",
"$ref" : "#/definitions/Address"
},
"OrderId": {
"description": "An Amazon defined order identifier",
"$ref" : "#/definitions/AmazonOrderId"
}
}
},
"GetAdditionalSellerInputsResult": {
"description": "The payload for the getAdditionalSellerInputs operation.",
"type": "object",
"properties": {
"ShipmentLevelFields" : {
"$ref" : "#/definitions/AdditionalInputsList"
},
"ItemLevelFieldsList" : {
"$ref" : "#/definitions/ItemLevelFieldsList"
}
}
},
"GetAdditionalSellerInputsResponse" : {
"description": "Response schema.",
"type" : "object",
"properties" : {
"payload": {
"$ref": "#/definitions/GetAdditionalSellerInputsResult"
},
"errors": {
"$ref": "#/definitions/ErrorList"
}
}
},
"CurrencyAmount": {
"description": "Currency type and amount.",
"type": "object",
"required": [
"Amount",
"CurrencyCode"
],
"properties": {
"CurrencyCode": {
"description": "Three-digit currency code in ISO 4217 format.",
"type": "string",
"maxLength": 3
},
"Amount": {
"description": "The currency amount.",
"type": "number",
"format": "double"
}
}
},
"CustomTextForLabel": {
"description": "Custom text to print on the label.\n\nNote: Custom text is only included on labels that are in ZPL format (ZPL203). FedEx does not support CustomTextForLabel.",
"type": "string",
"maxLength": 14
},
"DeliveryExperienceType": {
"description": "DeliveryExperience values.",
"type": "string",
"enum": [
"DeliveryConfirmationWithAdultSignature",
"DeliveryConfirmationWithSignature",
"DeliveryConfirmationWithoutSignature",
"NoTracking"
]
},
"DistrictOrCounty": {
"description": "The district or county.",
"type": "string"
},
"EmailAddress": {
"description": "The email address.",
"type": "string"
},
"FileContents": {
"description": "The document data and checksum.",
"type": "object",
"required": [
"Checksum",
"Contents",
"FileType"
],
"properties": {
"Contents": {
"description": "Data for printing labels, in the form of a Base64-encoded, GZip-compressed string.",
"type": "string"
},
"FileType": {
"$ref": "#/definitions/FileType"
},
"Checksum": {
"description": "An MD5 hash to validate the PDF document data, in the form of a Base64-encoded string.",
"type": "string"
}
}
},
"FileType": {
"description": "The file type for a label.",
"type": "string",
"enum": [
"application/pdf",
"application/zpl",
"image/png"
]
},
"GetEligibleShipmentServicesRequest": {
"description": "Request schema.",
"type": "object",
"required": [
"ShipmentRequestDetails"
],
"properties": {
"ShipmentRequestDetails": {
"description": "Shipment information required for requesting shipping service offers.",
"$ref": "#/definitions/ShipmentRequestDetails"
},
"ShippingOfferingFilter": {
"$ref": "#/definitions/ShippingOfferingFilter"
}
}
},
"GetEligibleShipmentServicesResponse": {
"description": "Response schema.",
"type": "object",
"properties": {
"payload": {
"$ref": "#/definitions/GetEligibleShipmentServicesResult"
},
"errors": {
"description": "One or more unexpected errors occurred during this operation.",
"$ref": "#/definitions/ErrorList"
}
}
},
"GetEligibleShipmentServicesResult": {
"description": "The payload for the getEligibleShipmentServices operation.",
"type": "object",
"required": [
"ShippingServiceList"
],
"properties": {
"ShippingServiceList": {
"description": "A list of shipping services offers.",
"$ref": "#/definitions/ShippingServiceList"
},
"RejectedShippingServiceList": {
"$ref": "#/definitions/RejectedShippingServiceList"
},
"TemporarilyUnavailableCarrierList": {
"$ref": "#/definitions/TemporarilyUnavailableCarrierList"
},
"TermsAndConditionsNotAcceptedCarrierList": {
"$ref": "#/definitions/TermsAndConditionsNotAcceptedCarrierList"
}
}
},
"GetShipmentResponse": {
"description": "Response schema.",
"type": "object",
"properties": {
"payload": {
"description": "The payload for the getShipment operation.",
"$ref": "#/definitions/Shipment"
},
"errors": {
"description": "One or more unexpected errors occurred during this operation.",
"$ref": "#/definitions/ErrorList"
}
}
},
"HazmatType": {
"description": "Hazardous materials options for a package. Consult the terms and conditions for each carrier for more information on hazardous materials. Possible values: None - The package does not contain hazardous material. LQHaxmat - The package contains limited quantities of hazardous material.",
"type": "string",
"enum": [
"None",
"LQHazmat"
]
},
"Item": {
"description": "An Amazon order item identifier and a quantity.",
"type": "object",
"required": [
"OrderItemId",
"Quantity"
],
"properties": {
"OrderItemId": {
"$ref": "#/definitions/OrderItemId"
},
"Quantity": {
"$ref": "#/definitions/ItemQuantity"
},
"ItemWeight": {
"$ref": "#/definitions/Weight"
},
"ItemDescription": {
"$ref": "#/definitions/ItemDescription"
},
"TransparencyCodeList": {
"$ref": "#/definitions/TransparencyCodeList"
},
"ItemLevelSellerInputsList": {
"description": "A list of additional seller inputs required to ship this item using the chosen shipping service.",
"$ref": "#/definitions/AdditionalSellerInputsList"
}
}
},
"ItemList": {
"description": "The list of items to be included in a shipment.",
"type": "array",
"items": {
"$ref": "#/definitions/Item"
}
},
"ItemQuantity": {
"description": "The number of items.",
"type": "integer",
"format": "int32"
},
"ItemDescription": {
"description": "The description of the item.",
"type": "string"
},
"Label": {
"description": "Data for creating a shipping label and dimensions for printing the label.",
"type": "object",
"required": [
"Dimensions",
"FileContents"
],
"properties": {
"CustomTextForLabel": {
"$ref": "#/definitions/CustomTextForLabel"
},
"Dimensions": {
"$ref": "#/definitions/LabelDimensions"
},
"FileContents": {
"$ref": "#/definitions/FileContents"
},
"LabelFormat": {
"$ref": "#/definitions/LabelFormat"
},
"StandardIdForLabel": {
"$ref": "#/definitions/StandardIdForLabel"
}
}
},
"LabelCustomization": {
"description": "Custom text for shipping labels.",
"type": "object",
"properties": {
"CustomTextForLabel": {
"$ref": "#/definitions/CustomTextForLabel"
},
"StandardIdForLabel": {
"$ref": "#/definitions/StandardIdForLabel"
}
}
},
"LabelDimension": {
"description": "A label dimension.",
"type": "number"
},
"LabelDimensions": {
"description": "Dimensions for printing a shipping label.",
"type": "object",
"required": [
"Length",
"Unit",
"Width"
],
"properties": {
"Length": {
"description": "The length dimension.",
"$ref": "#/definitions/LabelDimension"
},
"Width": {
"description": "The width dimension.",
"$ref": "#/definitions/LabelDimension"
},
"Unit": {
"description": "The unit of measurement.",
"$ref": "#/definitions/UnitOfLength"
}
}
},
"LabelFormat": {
"description": "The label format.",
"type": "string",
"enum": [
"PDF",
"PNG",
"ZPL203",
"ZPL300",
"ShippingServiceDefault"
]
},
"LabelFormatList": {
"description": "List of label formats.",
"type": "array",
"items": {
"$ref": "#/definitions/LabelFormat"
}
},
"Length": {
"description": "The length.",
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"$ref": "#/definitions/UnitOfLength"
}
}
},
"OrderItemId": {
"description": "An Amazon-defined identifier for an individual item in an order.",
"type": "string"
},
"PackageDimension": {
"type": "number",
"format": "double"
},
"PackageDimensions": {
"description": "The dimensions of a package contained in a shipment.",
"type": "object",
"properties": {
"Length": {
"description": "The length dimension. If you don't specify PredefinedPackageDimensions, you must specify the Length.",
"$ref": "#/definitions/PackageDimension"
},
"Width": {
"description": "The width dimension. If you don't specify PredefinedPackageDimensions, you must specify the Width.",
"$ref": "#/definitions/PackageDimension"
},
"Height": {
"description": "The height dimension. If you don't specify PredefinedPackageDimensions, you must specify the Height.",
"$ref": "#/definitions/PackageDimension"
},
"Unit": {
"description": "The unit of measurement. If you don't specify PredefinedPackageDimensions, you must specify the Unit.",
"$ref": "#/definitions/UnitOfLength"
},
"PredefinedPackageDimensions": {
"$ref": "#/definitions/PredefinedPackageDimensions"
}
}
},
"PhoneNumber": {
"description": "The phone number.",
"type": "string",
"maxLength": 30
},
"PostalCode": {
"description": "The zip code or postal code.",
"type": "string",
"maxLength": 30
},
"PredefinedPackageDimensions": {
"description": "An enumeration of predefined parcel tokens. If you specify a PredefinedPackageDimensions token, you are not obligated to use a branded package from a carrier. For example, if you specify the FedEx_Box_10kg token, you do not have to use that particular package from FedEx. You are only obligated to use a box that matches the dimensions specified by the token.\n\nNote: Please note that carriers can have restrictions on the type of package allowed for certain ship methods. Check the carrier website for all details. Example: Flat rate pricing is available when materials are sent by USPS in a USPS-produced Flat Rate Envelope or Box.",
"type": "string",
"enum": [
"FedEx_Box_10kg",
"FedEx_Box_25kg",
"FedEx_Box_Extra_Large_1",
"FedEx_Box_Extra_Large_2",
"FedEx_Box_Large_1",
"FedEx_Box_Large_2",
"FedEx_Box_Medium_1",
"FedEx_Box_Medium_2",
"FedEx_Box_Small_1",
"FedEx_Box_Small_2",
"FedEx_Envelope",
"FedEx_Padded_Pak",
"FedEx_Pak_1",
"FedEx_Pak_2",
"FedEx_Tube",
"FedEx_XL_Pak",
"UPS_Box_10kg",
"UPS_Box_25kg",
"UPS_Express_Box",
"UPS_Express_Box_Large",
"UPS_Express_Box_Medium",
"UPS_Express_Box_Small",
"UPS_Express_Envelope",
"UPS_Express_Hard_Pak",
"UPS_Express_Legal_Envelope",
"UPS_Express_Pak",
"UPS_Express_Tube",
"UPS_Laboratory_Pak",
"UPS_Pad_Pak",
"UPS_Pallet",
"USPS_Card",
"USPS_Flat",
"USPS_FlatRateCardboardEnvelope",
"USPS_FlatRateEnvelope",
"USPS_FlatRateGiftCardEnvelope",
"USPS_FlatRateLegalEnvelope",
"USPS_FlatRatePaddedEnvelope",
"USPS_FlatRateWindowEnvelope",
"USPS_LargeFlatRateBoardGameBox",
"USPS_LargeFlatRateBox",
"USPS_Letter",
"USPS_MediumFlatRateBox1",
"USPS_MediumFlatRateBox2",
"USPS_RegionalRateBoxA1",
"USPS_RegionalRateBoxA2",
"USPS_RegionalRateBoxB1",
"USPS_RegionalRateBoxB2",
"USPS_RegionalRateBoxC",
"USPS_SmallFlatRateBox",
"USPS_SmallFlatRateEnvelope"
]
},
"RestrictedSetValues": {
"description": "The set of fixed values in an additional seller input.",
"type": "array",
"items": {
"description": "A single fixed value.",
"type": "string"
}
},
"SellerOrderId": {
"description": "A seller-defined order identifier.",
"type": "string",
"maxLength": 64
},
"Shipment": {
"description": "The details of a shipment, including the shipment status.",
"type": "object",
"required": [
"AmazonOrderId",
"CreatedDate",
"Insurance",
"ItemList",
"Label",
"PackageDimensions",
"ShipFromAddress",
"ShipToAddress",
"ShipmentId",
"ShippingService",
"Status",
"Weight"
],
"properties": {
"ShipmentId": {
"$ref": "#/definitions/ShipmentId"
},
"AmazonOrderId": {
"$ref": "#/definitions/AmazonOrderId"
},
"SellerOrderId": {
"$ref": "#/definitions/SellerOrderId"
},
"ItemList": {
"$ref": "#/definitions/ItemList"
},
"ShipFromAddress": {
"description": "The address of the sender.",
"$ref": "#/definitions/Address"
},
"ShipToAddress": {
"description": "The destination address for the shipment.",
"$ref": "#/definitions/Address"
},
"PackageDimensions": {
"$ref": "#/definitions/PackageDimensions"
},
"Weight": {
"description": "The package weight.",
"$ref": "#/definitions/Weight"
},
"Insurance": {
"description": "If DeclaredValue was specified in a previous call to the CreateShipment operation, then Insurance indicates the amount that the carrier will use to insure the shipment. If DeclaredValue was not specified with a previous call to the CreateShipment operation, then the shipment will be insured for the carrier's minimum insurance amount, or the combined sale prices that the items are listed for in the shipment, whichever is less.",
"$ref": "#/definitions/CurrencyAmount"
},
"ShippingService": {
"$ref": "#/definitions/ShippingService"
},
"Label": {
"description": "Data for creating a shipping label and dimensions for printing the label. If the shipment is canceled, an empty Label is returned.",
"$ref": "#/definitions/Label"
},
"Status": {
"description": "The shipment status.",
"$ref": "#/definitions/ShipmentStatus"
},
"TrackingId": {
"$ref": "#/definitions/TrackingId"
},
"CreatedDate": {
"description": "The date and time the shipment was created.",
"$ref": "#/definitions/Timestamp"
},
"LastUpdatedDate": {
"description": "The date and time of the last update.",
"$ref": "#/definitions/Timestamp"
}
}
},
"ShipmentId": {
"description": "An Amazon-defined shipment identifier.",
"type": "string"
},
"ShipmentRequestDetails": {
"description": "Shipment information required for requesting shipping service offers or for creating a shipment.",
"type": "object",
"required": [
"AmazonOrderId",
"ItemList",
"PackageDimensions",
"ShipFromAddress",
"ShippingServiceOptions",
"Weight"
],
"properties": {
"AmazonOrderId": {
"description": "An Amazon-defined order identifier in 3-7-7 format.",
"$ref": "#/definitions/AmazonOrderId"
},
"SellerOrderId": {
"description": "A seller-defined order identifier.",
"$ref": "#/definitions/SellerOrderId"
},
"ItemList": {
"$ref": "#/definitions/ItemList"
},
"ShipFromAddress": {
"description": "The address of the sender.",
"$ref": "#/definitions/Address"
},
"PackageDimensions": {
"description": "The package dimensions.",
"$ref": "#/definitions/PackageDimensions"
},
"Weight": {
"description": "The package weight.",
"$ref": "#/definitions/Weight"
},
"MustArriveByDate": {
"description": "The date by which the package must arrive to keep the promise to the customer, in ISO 8601 datetime format. If MustArriveByDate is specified, only shipping service offers that can be delivered by that date are returned.",
"$ref": "#/definitions/Timestamp"
},
"ShipDate": {
"description": "When used in a request, this is the date and time that the seller wants to ship the package. When used in a response, this is the date and time that the package can be shipped by the indicated method.",
"$ref": "#/definitions/Timestamp"
},
"ShippingServiceOptions": {
"description": "Extra services offered by the carrier.",
"$ref": "#/definitions/ShippingServiceOptions"
},
"LabelCustomization": {
"description": "Label customization options.",
"$ref": "#/definitions/LabelCustomization"
}
}
},
"ShipmentStatus": {
"description": "The shipment status.",
"type": "string",
"enum": [
"Purchased",
"RefundPending",
"RefundRejected",
"RefundApplied"
]
},
"DeliveryExperienceOption": {
"description": "The delivery confirmation level.",
"type": "string",
"enum": [
"DeliveryConfirmationWithAdultSignature",
"DeliveryConfirmationWithSignature",
"DeliveryConfirmationWithoutSignature",
"NoTracking",
"NoPreference"
]
},
"ShippingOfferingFilter": {
"type": "object",
"properties": {
"IncludePackingSlipWithLabel": {
"description": "When true, include a packing slip with the label.",
"type": "boolean"
},
"IncludeComplexShippingOptions": {
"description": "When true, include complex shipping options.",
"type": "boolean"
},
"CarrierWillPickUp": {
"$ref": "#/definitions/CarrierWillPickUpOption"
},
"DeliveryExperience": {
"$ref": "#/definitions/DeliveryExperienceOption"
}
}
},
"ShippingService": {
"description": "A shipping service offer made by a carrier.",
"type": "object",
"required": [
"CarrierName",
"Rate",
"ShipDate",
"ShippingServiceId",
"ShippingServiceName",
"ShippingServiceOfferId",
"ShippingServiceOptions",
"RequiresAdditionalSellerInputs"
],
"properties": {
"ShippingServiceName": {
"description": "A plain text representation of a carrier's shipping service. For example, \"UPS Ground\" or \"FedEx Standard Overnight\". ",
"type": "string"
},
"CarrierName": {
"description": "The name of the carrier.",
"type": "string"
},
"ShippingServiceId": {
"$ref": "#/definitions/ShippingServiceIdentifier"
},
"ShippingServiceOfferId": {
"description": "An Amazon-defined shipping service offer identifier.",
"type": "string"
},
"ShipDate": {
"description": "The date that the carrier will ship the package.",
"$ref": "#/definitions/Timestamp"
},
"EarliestEstimatedDeliveryDate": {
"description": "The earliest date by which the shipment will be delivered.",
"$ref": "#/definitions/Timestamp"
},
"LatestEstimatedDeliveryDate": {
"description": "The latest date by which the shipment will be delivered.",
"$ref": "#/definitions/Timestamp"
},
"Rate": {
"description": "The amount that the carrier will charge for the shipment.",
"$ref": "#/definitions/CurrencyAmount"
},
"ShippingServiceOptions": {
"description": "Extra services offered by the carrier.",
"$ref": "#/definitions/ShippingServiceOptions"
},
"AvailableShippingServiceOptions" : {
"$ref" : "#/definitions/AvailableShippingServiceOptions"
},
"AvailableLabelFormats": {
"$ref": "#/definitions/LabelFormatList"
},
"AvailableFormatOptionsForLabel" : {
"$ref" : "#/definitions/AvailableFormatOptionsForLabelList"
},
"RequiresAdditionalSellerInputs" : {
"description": "When true, additional seller inputs are required.",
"type" : "boolean"
}
}
},
"ShippingServiceIdentifier": {
"description": "An Amazon-defined shipping service identifier.",
"type": "string"
},
"ShippingServiceList": {
"description": "A list of shipping services offers.",
"type": "array",
"items": {
"$ref": "#/definitions/ShippingService"
}
},
"ShippingServiceOptions": {
"description": "Extra services provided by a carrier.",
"type": "object",
"required": [
"DeliveryExperience",
"CarrierWillPickUp"
],
"properties": {
"DeliveryExperience": {
"description": "The delivery confirmation level.",
"$ref": "#/definitions/DeliveryExperienceType"
},
"DeclaredValue": {
"description": "The declared value of the shipment. The carrier uses this value to determine the amount to use to insure the shipment. If DeclaredValue is greater than the carrier's minimum insurance amount, the seller is charged for the additional insurance as determined by the carrier. For information about optional insurance coverage, see the Seller Central Help [UK](https://sellercentral.amazon.co.uk/gp/help/200204080) [US](https://sellercentral.amazon.com/gp/help/200204080).",
"$ref": "#/definitions/CurrencyAmount"
},
"CarrierWillPickUp": {
"description": "When true, the carrier will pick up the package.\n\nNote: Scheduled carrier pickup is available only using Dynamex (US), DPD (UK), and Royal Mail (UK).",
"type": "boolean"
},
"CarrierWillPickUpOption": {
"$ref": "#/definitions/CarrierWillPickUpOption"
},
"LabelFormat": {
"description": "The seller's preferred label format.",
"$ref": "#/definitions/LabelFormat"
}
}
},
"CarrierWillPickUpOption": {
"description": "Carrier will pick up option.",
"type": "string",
"enum": [
"CarrierWillPickUp",
"ShipperWillDropOff",
"NoPreference"
]
},
"StandardIdForLabel": {
"description": "The type of standard identifier to print on the label.",
"type": "string",
"enum": [
"AmazonOrderId"
]
},
"StateOrProvinceCode": {
"description": "The state or province code.",
"type": "string",
"maxLength": 30
},
"RejectedShippingService": {
"description": "Information about a rejected shipping service",
"type": "object",
"required": [
"CarrierName",
"ShippingServiceName",
"ShippingServiceId",
"RejectionReasonCode"
],
"properties": {
"CarrierName": {
"description": "The rejected shipping carrier name. e.g. USPS",
"type": "string"
},
"ShippingServiceName": {
"description": "The rejected shipping service localized name. e.g. FedEx Standard Overnight",
"type": "string"
},
"ShippingServiceId": {
"description": "The rejected shipping service identifier. e.g. FEDEX_PTP_STANDARD_OVERNIGHT",
"$ref": "#/definitions/ShippingServiceIdentifier"
},
"RejectionReasonCode": {
"description": "A reason code meant to be consumed programatically. e.g. CARRIER_CANNOT_SHIP_TO_POBOX",
"type": "string"
},
"RejectionReasonMessage": {
"description": "A localized human readable description of the rejected reason.",
"type": "string"
}
}
},
"RejectedShippingServiceList": {
"description": "List of services that were for some reason unavailable for this request",
"type": "array",
"items": {
"$ref": "#/definitions/RejectedShippingService"
}
},
"TemporarilyUnavailableCarrier": {
"description": "A carrier who is temporarily unavailable, most likely due to a service outage experienced by the carrier.",
"type": "object",
"required": [
"CarrierName"
],
"properties": {
"CarrierName": {
"description": "The name of the carrier.",
"type": "string"
}
}
},
"TemporarilyUnavailableCarrierList": {
"description": "A list of temporarily unavailable carriers.",
"type": "array",
"items": {
"$ref": "#/definitions/TemporarilyUnavailableCarrier"
}
},
"TermsAndConditionsNotAcceptedCarrier": {
"description": "A carrier whose terms and conditions have not been accepted by the seller.",
"type": "object",
"required": [
"CarrierName"
],
"properties": {
"CarrierName": {
"description": "The name of the carrier.",
"type": "string"
}
}
},
"TermsAndConditionsNotAcceptedCarrierList": {
"description": "List of carriers whose terms and conditions were not accepted by the seller.",
"type": "array",
"items": {
"$ref": "#/definitions/TermsAndConditionsNotAcceptedCarrier"
}
},
"Timestamp": {
"type": "string",
"format": "date-time"
},
"TrackingId": {
"description": "The shipment tracking identifier provided by the carrier.",
"type": "string"
},
"TransparencyCode": {
"description": "The Transparency code associated with the item.",
"type": "string"
},
"TransparencyCodeList": {
"description": "A list of transparency codes.",
"type": "array",
"items": {
"$ref": "#/definitions/TransparencyCode"
}
},
"UnitOfLength": {
"description": "The unit of length.",
"type": "string",
"enum": [
"inches",
"centimeters"
]
},
"UnitOfWeight": {
"description": "The unit of weight.",
"type": "string",
"enum": [
"oz",
"g"
]
},
"Weight": {
"description": "The weight.",
"type": "object",
"required": [
"Unit",
"Value"
],
"properties": {
"Value": {
"$ref": "#/definitions/WeightValue"
},
"Unit": {
"$ref": "#/definitions/UnitOfWeight"
}
}
},
"WeightValue": {
"description": "The weight value.",
"type": "number",
"format": "double"
}
}
}