SubmitShipments - Amazon Selling Partner API (SP-API)-中文

提交一个或多个供应商订单的发货请求。

使用计划：

速率（每秒请求数）	突发
10	10

当可用时，x-amzn-RateLimit-Limit 响应头返回应用于请求操作的使用计划速率限制。上表指示了该操作的默认速率和突发值。业务需求要求更高吞吐量的销售合作伙伴可能会看到比此处显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Body 参数application/json

示例

{
    "shipments": [
        {
            "vendorShipmentIdentifier": "string",
            "transactionType": "New",
            "buyerReferenceNumber": "string",
            "transactionDate": "2019-08-24T14:15:22Z",
            "currentShipmentStatus": "Created",
            "currentshipmentStatusDate": "2019-08-24T14:15:22Z",
            "shipmentStatusDetails": [
                {
                    "shipmentStatus": "Created",
                    "shipmentStatusDate": "2019-08-24T14:15:22Z"
                }
            ],
            "shipmentCreateDate": "2019-08-24T14:15:22Z",
            "shipmentConfirmDate": "2019-08-24T14:15:22Z",
            "packageLabelCreateDate": "2019-08-24T14:15:22Z",
            "shipmentFreightTerm": "Collect",
            "sellingParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipFromParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipToParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipmentMeasurements": {
                "totalCartonCount": 0,
                "totalPalletStackable": 0,
                "totalPalletNonStackable": 0,
                "shipmentWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "shipmentVolume": {
                    "unitOfMeasure": "CuFt",
                    "value": "string"
                }
            },
            "collectFreightPickupDetails": {
                "requestedPickUp": "2019-08-24T14:15:22Z",
                "scheduledPickUp": "2019-08-24T14:15:22Z",
                "carrierAssignmentDate": "2019-08-24T14:15:22Z"
            },
            "purchaseOrders": [
                {
                    "purchaseOrderNumber": "string",
                    "purchaseOrderDate": "2019-08-24T14:15:22Z",
                    "shipWindow": "string",
                    "items": [
                        {
                            "itemSequenceNumber": "string",
                            "buyerProductIdentifier": "string",
                            "vendorProductIdentifier": "string",
                            "shippedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "maximumRetailPrice": {
                                "currencyCode": "string",
                                "amount": "string"
                            }
                        }
                    ]
                }
            ],
            "importDetails": {
                "methodOfPayment": "PaidByBuyer",
                "sealNumber": "string",
                "route": {
                    "stops": [
                        {
                            "functionCode": "PortOfDischarge",
                            "locationIdentification": {
                                "type": "string",
                                "locationCode": "string",
                                "countryCode": "string"
                            },
                            "arrivalTime": "2019-08-24T14:15:22Z",
                            "departureTime": "2019-08-24T14:15:22Z"
                        }
                    ]
                },
                "importContainers": "string",
                "billableWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "estimatedShipByDate": "2019-08-24T14:15:22Z",
                "handlingInstructions": "Oversized"
            },
            "containers": [
                {
                    "containerType": "carton",
                    "containerSequenceNumber": "string",
                    "containerIdentifiers": [
                        {
                            "containerIdentificationType": "SSCC",
                            "containerIdentificationNumber": "string"
                        }
                    ],
                    "trackingNumber": "string",
                    "dimensions": {
                        "length": "string",
                        "width": "string",
                        "height": "string",
                        "unitOfMeasure": "In"
                    },
                    "weight": {
                        "unitOfMeasure": "G",
                        "value": "string"
                    },
                    "tier": 0,
                    "block": 0,
                    "innerContainersDetails": {
                        "containerCount": 0,
                        "containerSequenceNumbers": [
                            {
                                "containerSequenceNumber": "string"
                            }
                        ]
                    },
                    "packedItems": [
                        {
                            "itemSequenceNumber": "string",
                            "buyerProductIdentifier": "string",
                            "vendorProductIdentifier": "string",
                            "packedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "itemDetails": {
                                "purchaseOrderNumber": "string",
                                "lotNumber": "string",
                                "expiry": {
                                    "manufacturerDate": "2019-08-24T14:15:22Z",
                                    "expiryDate": "2019-08-24T14:15:22Z",
                                    "expiryAfterDuration": {
                                        "durationUnit": "Days",
                                        "durationValue": 0
                                    }
                                }
                            }
                        }
                    ]
                }
            ],
            "transportationDetails": {
                "shipMode": "TruckLoad",
                "transportationMode": "Road",
                "shippedDate": "2019-08-24T14:15:22Z",
                "estimatedDeliveryDate": "2019-08-24T14:15:22Z",
                "shipmentDeliveryDate": "2019-08-24T14:15:22Z",
                "carrierDetails": {
                    "name": "string",
                    "code": "string",
                    "phone": "string",
                    "email": "string",
                    "shipmentReferenceNumber": "string"
                },
                "billOfLadingNumber": "string"
            }
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/shipping/v1/shipments' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipments": [
        {
            "vendorShipmentIdentifier": "string",
            "transactionType": "New",
            "buyerReferenceNumber": "string",
            "transactionDate": "2019-08-24T14:15:22Z",
            "currentShipmentStatus": "Created",
            "currentshipmentStatusDate": "2019-08-24T14:15:22Z",
            "shipmentStatusDetails": [
                {
                    "shipmentStatus": "Created",
                    "shipmentStatusDate": "2019-08-24T14:15:22Z"
                }
            ],
            "shipmentCreateDate": "2019-08-24T14:15:22Z",
            "shipmentConfirmDate": "2019-08-24T14:15:22Z",
            "packageLabelCreateDate": "2019-08-24T14:15:22Z",
            "shipmentFreightTerm": "Collect",
            "sellingParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipFromParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipToParty": {
                "address": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "partyId": "string",
                "taxRegistrationDetails": [
                    {
                        "taxRegistrationType": "VAT",
                        "taxRegistrationNumber": "string"
                    }
                ]
            },
            "shipmentMeasurements": {
                "totalCartonCount": 0,
                "totalPalletStackable": 0,
                "totalPalletNonStackable": 0,
                "shipmentWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "shipmentVolume": {
                    "unitOfMeasure": "CuFt",
                    "value": "string"
                }
            },
            "collectFreightPickupDetails": {
                "requestedPickUp": "2019-08-24T14:15:22Z",
                "scheduledPickUp": "2019-08-24T14:15:22Z",
                "carrierAssignmentDate": "2019-08-24T14:15:22Z"
            },
            "purchaseOrders": [
                {
                    "purchaseOrderNumber": "string",
                    "purchaseOrderDate": "2019-08-24T14:15:22Z",
                    "shipWindow": "string",
                    "items": [
                        {
                            "itemSequenceNumber": "string",
                            "buyerProductIdentifier": "string",
                            "vendorProductIdentifier": "string",
                            "shippedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "maximumRetailPrice": {
                                "currencyCode": "string",
                                "amount": "string"
                            }
                        }
                    ]
                }
            ],
            "importDetails": {
                "methodOfPayment": "PaidByBuyer",
                "sealNumber": "string",
                "route": {
                    "stops": [
                        {
                            "functionCode": "PortOfDischarge",
                            "locationIdentification": {
                                "type": "string",
                                "locationCode": "string",
                                "countryCode": "string"
                            },
                            "arrivalTime": "2019-08-24T14:15:22Z",
                            "departureTime": "2019-08-24T14:15:22Z"
                        }
                    ]
                },
                "importContainers": "string",
                "billableWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "estimatedShipByDate": "2019-08-24T14:15:22Z",
                "handlingInstructions": "Oversized"
            },
            "containers": [
                {
                    "containerType": "carton",
                    "containerSequenceNumber": "string",
                    "containerIdentifiers": [
                        {
                            "containerIdentificationType": "SSCC",
                            "containerIdentificationNumber": "string"
                        }
                    ],
                    "trackingNumber": "string",
                    "dimensions": {
                        "length": "string",
                        "width": "string",
                        "height": "string",
                        "unitOfMeasure": "In"
                    },
                    "weight": {
                        "unitOfMeasure": "G",
                        "value": "string"
                    },
                    "tier": 0,
                    "block": 0,
                    "innerContainersDetails": {
                        "containerCount": 0,
                        "containerSequenceNumbers": [
                            {
                                "containerSequenceNumber": "string"
                            }
                        ]
                    },
                    "packedItems": [
                        {
                            "itemSequenceNumber": "string",
                            "buyerProductIdentifier": "string",
                            "vendorProductIdentifier": "string",
                            "packedQuantity": {
                                "amount": 0,
                                "unitOfMeasure": "Cases",
                                "unitSize": 0
                            },
                            "itemDetails": {
                                "purchaseOrderNumber": "string",
                                "lotNumber": "string",
                                "expiry": {
                                    "manufacturerDate": "2019-08-24T14:15:22Z",
                                    "expiryDate": "2019-08-24T14:15:22Z",
                                    "expiryAfterDuration": {
                                        "durationUnit": "Days",
                                        "durationValue": 0
                                    }
                                }
                            }
                        }
                    ]
                }
            ],
            "transportationDetails": {
                "shipMode": "TruckLoad",
                "transportationMode": "Road",
                "shippedDate": "2019-08-24T14:15:22Z",
                "estimatedDeliveryDate": "2019-08-24T14:15:22Z",
                "shipmentDeliveryDate": "2019-08-24T14:15:22Z",
                "carrierDetails": {
                    "name": "string",
                    "code": "string",
                    "phone": "string",
                    "email": "string",
                    "shipmentReferenceNumber": "string"
                },
                "billOfLadingNumber": "string"
            }
        }
    ]
}'

返回响应

🟢202成功

application/json

成功。

Headers

Body

示例

{
    "payload": {
        "transactionId": "string"
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障