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

创建新货物运输。

使用计划：

速率（每秒请求）	突发
5	15

x-amzn-RateLimit-Limit 响应头返回可应用于请求操作的使用计划速率限制（如可用）。上述表格指示了该操作的默认速率和突发值。业务需求要求更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参见销售合作伙伴 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/shipping/v1/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

示例

{
    "shipmentId": "89108749065090",
    "eligibleRates": [
        {
            "billedWeight": {
                "value": 4,
                "unit": "kg"
            },
            "totalCharge": {
                "value": 3.25,
                "unit": "GBP"
            },
            "serviceType": "Amazon Shipping Standard",
            "promise": {
                "deliveryWindow": {
                    "start": "2018-08-25T20:22:30.737Z",
                    "end": "2018-08-26T20:22:30.737Z"
                },
                "receiveWindow": {
                    "start": "2018-08-23T09:22:30.737Z",
                    "end": "2018-08-23T11:22:30.737Z"
                }
            },
            "rateId": "RI123456",
            "expirationTime": "2018-08-22T09:22:30.737Z"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障