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

创建采购订单的运输标签并返回标签。

使用计划：

速率（每秒请求）	峰值
10	10

x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制（如果可用）。上表显示了此操作的默认速率和峰值值。业务需求更高的销售合作伙伴可能会看到高于此处显示的速率和峰值值。有关更多信息，请参见销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数

purchaseOrderNumber

string

必需

您要退回运输标签的采购订单号码。它应该与订单中收到的采购订单号码相同。

正则匹配:

^[a-zA-Z0-9]+$

Body 参数application/json

创建发货标签操作的请求主体。

sellingParty

object (PartyIdentification)

必需

一方的姓名、地址和税务详情。

partyId

string

必需

为该方分配的识别标识。

address

object (Address)

聚会地址。

可选

taxRegistrationDetails

array[object (TaxRegistrationDetails) {4}]

可选

实体的税务登记信息。

shipFromParty

object (PartyIdentification)

必需

一方的姓名、地址和税务详情。

containers

array[object (Container) {12}]

可选

此次发货中的包裹清单。

containerType

enum<string>

容器的类型。

必需

枚举值:

CartonPallet

containerIdentifier

string

容器标识符。

必需

trackingNumber

string

追踪号码。

可选

manifestId

string

清单标识符。

可选

manifestDate

string

清单的日期。

可选

shipMethod

string

可选

发货方式。调用submitShipmentConfirmations操作时，此属性为必需，其他情况下为可选。

scacCode

string

可选

仅对北美进口商要求提供SCAC代码。

carrier

string

可选

仅限EU VOC供应商需要承运人。

containerSequenceNumber

integer

可选

仅在多箱运输中必须提交的一个整数，某个物品可能会分成几个包裹。

dimensions

object (Dimensions)

可选

容器的物理尺寸测量。

weight

object (Weight)

重量。

必需

packedItems

array[object (PackedItem) {5}]

打包物品清单。

必需

示例

{
    "sellingParty": {
        "partyId": "string",
        "address": {
            "name": "string",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "city": "string",
            "county": "string",
            "district": "string",
            "stateOrRegion": "string",
            "postalCode": "string",
            "countryCode": "string",
            "phone": "string"
        },
        "taxRegistrationDetails": [
            {
                "taxRegistrationType": "VAT",
                "taxRegistrationNumber": "string",
                "taxRegistrationAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationMessages": "string"
            }
        ]
    },
    "shipFromParty": {
        "partyId": "string",
        "address": {
            "name": "string",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "city": "string",
            "county": "string",
            "district": "string",
            "stateOrRegion": "string",
            "postalCode": "string",
            "countryCode": "string",
            "phone": "string"
        },
        "taxRegistrationDetails": [
            {
                "taxRegistrationType": "VAT",
                "taxRegistrationNumber": "string",
                "taxRegistrationAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationMessages": "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": "KG",
                "value": "string"
            },
            "packedItems": [
                {
                    "itemSequenceNumber": 0,
                    "buyerProductIdentifier": "string",
                    "pieceNumber": 0,
                    "vendorProductIdentifier": "string",
                    "packedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "string"
                    }
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sellingParty": {
        "partyId": "string",
        "address": {
            "name": "string",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "city": "string",
            "county": "string",
            "district": "string",
            "stateOrRegion": "string",
            "postalCode": "string",
            "countryCode": "string",
            "phone": "string"
        },
        "taxRegistrationDetails": [
            {
                "taxRegistrationType": "VAT",
                "taxRegistrationNumber": "string",
                "taxRegistrationAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationMessages": "string"
            }
        ]
    },
    "shipFromParty": {
        "partyId": "string",
        "address": {
            "name": "string",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "city": "string",
            "county": "string",
            "district": "string",
            "stateOrRegion": "string",
            "postalCode": "string",
            "countryCode": "string",
            "phone": "string"
        },
        "taxRegistrationDetails": [
            {
                "taxRegistrationType": "VAT",
                "taxRegistrationNumber": "string",
                "taxRegistrationAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationMessages": "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": "KG",
                "value": "string"
            },
            "packedItems": [
                {
                    "itemSequenceNumber": 0,
                    "buyerProductIdentifier": "string",
                    "pieceNumber": 0,
                    "vendorProductIdentifier": "string",
                    "packedQuantity": {
                        "amount": 0,
                        "unitOfMeasure": "string"
                    }
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

订单的运输标签信息。包括采购订单号、销售方、发货方、标签格式和包装详情。

purchaseOrderNumber

string

必需

此字段将包含该订单的采购订单号。

正则匹配:

^[a-zA-Z0-9]+$

sellingParty

object (PartyIdentification)

必需

一方的姓名、地址和税务详情。

partyId

string

必需

为该方分配的识别标识。

address

object (Address)

聚会地址。

可选

taxRegistrationDetails

array[object (TaxRegistrationDetails) {4}]

可选

实体的税务登记信息。

shipFromParty

object (PartyIdentification)

必需

一方的姓名、地址和税务详情。

labelFormat

enum<string>

标签的格式。

必需

枚举值:

PNGZPL

labelData

array[object (LabelData) {5}]

必需

提供此货物中包裹的详细信息。

packageIdentifier

string

可选

包裹的标识符。第一个包裹将是001，第二个是002，以此类推。此编号用于从托盘层面引用该包裹。

trackingNumber

string

可选

运输承运人提供的包裹追踪标识符。

shipMethod

string

可选

用于发货订单的运输方式。亚马逊定义了运输方式代码，指示运输承运人和发货服务级别。运输方式代码对大小写和格式敏感。运输确认中应返回相同的运输方式代码。请注意，运输方式代码是特定于供应商的，并将在实施期间提供给每个供应商。

shipMethodName

string

可选

内部参考的运输方式名称。

content

string

必需

此字段将包含货运标签内容的Base64编码字符串。

示例

{
    "purchaseOrderNumber": "string",
    "sellingParty": {
        "partyId": "string",
        "address": {
            "name": "string",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "city": "string",
            "county": "string",
            "district": "string",
            "stateOrRegion": "string",
            "postalCode": "string",
            "countryCode": "string",
            "phone": "string"
        },
        "taxRegistrationDetails": [
            {
                "taxRegistrationType": "VAT",
                "taxRegistrationNumber": "string",
                "taxRegistrationAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationMessages": "string"
            }
        ]
    },
    "shipFromParty": {
        "partyId": "string",
        "address": {
            "name": "string",
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "city": "string",
            "county": "string",
            "district": "string",
            "stateOrRegion": "string",
            "postalCode": "string",
            "countryCode": "string",
            "phone": "string"
        },
        "taxRegistrationDetails": [
            {
                "taxRegistrationType": "VAT",
                "taxRegistrationNumber": "string",
                "taxRegistrationAddress": {
                    "name": "string",
                    "addressLine1": "string",
                    "addressLine2": "string",
                    "addressLine3": "string",
                    "city": "string",
                    "county": "string",
                    "district": "string",
                    "stateOrRegion": "string",
                    "postalCode": "string",
                    "countryCode": "string",
                    "phone": "string"
                },
                "taxRegistrationMessages": "string"
            }
        ]
    },
    "labelFormat": "PNG",
    "labelData": [
        {
            "packageIdentifier": "string",
            "trackingNumber": "string",
            "shipMethod": "string",
            "shipMethodName": "string",
            "content": "string"
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠409409

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障