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

使用提供的信息创建一个货件。

使用计划：

速率（每秒请求数）	峰值
2	2

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

请求参数

Body 参数application/json必填

示例

{
    "clientReferenceId": "string",
    "shipTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "county": "string",
        "district": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "shipFrom": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "county": "string",
        "district": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "containers": [
        {
            "containerType": "Carton",
            "containerIdentifier": "string",
            "trackingNumber": "string",
            "manifestId": "string",
            "manifestDate": "string",
            "shipMethod": "string",
            "scacCode": "string",
            "carrier": "string",
            "containerSequenceNumber": 0,
            "dimensions": {
                "length": "string",
                "width": "string",
                "height": "string",
                "unitOfMeasure": "In"
            },
            "weight": {
                "unitOfMeasure": "G",
                "value": "string"
            },
            "packedItems": [
                {
                    "itemSequenceNumber": 0,
                    "buyerProductIdentifier": "string",
                    "pieceNumber": 0,
                    "vendorProductIdentifier": "string",
                    "packedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "Cases",
                        "unitSize": 0,
                        "totalWeight": {
                            "unitOfMeasure": "POUNDS",
                            "amount": "string"
                        }
                    }
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/mfn/v0/shipments' \
--header 'Content-Type: application/json' \
--data '{
    "clientReferenceId": "string",
    "shipTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "county": "string",
        "district": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "shipFrom": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "county": "string",
        "district": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "containers": [
        {
            "containerType": "Carton",
            "containerIdentifier": "string",
            "trackingNumber": "string",
            "manifestId": "string",
            "manifestDate": "string",
            "shipMethod": "string",
            "scacCode": "string",
            "carrier": "string",
            "containerSequenceNumber": 0,
            "dimensions": {
                "length": "string",
                "width": "string",
                "height": "string",
                "unitOfMeasure": "In"
            },
            "weight": {
                "unitOfMeasure": "G",
                "value": "string"
            },
            "packedItems": [
                {
                    "itemSequenceNumber": 0,
                    "buyerProductIdentifier": "string",
                    "pieceNumber": 0,
                    "vendorProductIdentifier": "string",
                    "packedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "Cases",
                        "unitSize": 0,
                        "totalWeight": {
                            "unitOfMeasure": "POUNDS",
                            "amount": "string"
                        }
                    }
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

成功。

Headers

Bodyapplication/json

示例

{
    "payload": {
        "shipmentId": "string",
        "eligibleRates": [
            {
                "rateId": "string",
                "carrierId": "SWA",
                "carrierName": "string",
                "serviceId": "string",
                "serviceName": "string",
                "billedWeight": {
                    "unitOfMeasure": "G",
                    "value": "string"
                },
                "totalCharge": {
                    "currencyCode": "string",
                    "currencyAmount": 0
                },
                "promise": {
                    "deliveryWindow": {
                        "start": "2019-08-24T14:15:22.123Z",
                        "end": "2019-08-24T14:15:22.123Z"
                    },
                    "pickupWindow": {
                        "start": "2019-08-24T14:15:22.123Z",
                        "end": "2019-08-24T14:15:22.123Z"
                    }
                },
                "supportedDocumentSpecifications": [
                    {
                        "format": "PDF",
                        "size": {
                            "width": 0,
                            "length": 0,
                            "unit": "INCH"
                        },
                        "printOptions": [
                            {
                                "supportedDPIs": [
                                    0
                                ],
                                "supportedPageLayouts": [
                                    "string"
                                ],
                                "supportedFileJoiningOptions": [
                                    true
                                ],
                                "supportedDocumentDetails": [
                                    {
                                        "name": "PACKSLIP",
                                        "isMandatory": true
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "availableValueAddedServiceGroups": [
                    {
                        "groupId": "string",
                        "groupDescription": "string",
                        "isRequired": true,
                        "valueAddedServices": [
                            {
                                "id": "string",
                                "name": "string",
                                "cost": {
                                    "currencyCode": "string",
                                    "currencyAmount": 0
                                }
                            }
                        ]
                    }
                ],
                "requiresAdditionalInputs": true,
                "rateItemList": [
                    {
                        "rateItemID": "BASE_RATE",
                        "rateItemType": "MANDATORY",
                        "rateItemCharge": {
                            "currencyCode": "string",
                            "currencyAmount": 0
                        },
                        "rateItemNameLocalization": "string"
                    }
                ],
                "paymentType": "PAY_THROUGH_AMAZON",
                "benefits": {
                    "includedBenefits": [
                        "string"
                    ],
                    "excludedBenefits": [
                        {
                            "benefit": "string",
                            "reasonCodes": [
                                "string"
                            ]
                        }
                    ]
                }
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障