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

购买一个运输服务标识符，并返回与购买相关的详细信息和文件。

使用计划：

速率（每秒请求数）	冲击
80	100

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

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "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"
    },
    "returnTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "county": "string",
        "district": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "shipDate": "2019-08-24T14:15:22.123Z",
    "goodsOwner": {
        "merchantId": "string"
    },
    "packages": [
        {
            "packageTrackingNumber": "string"
        }
    ],
    "valueAddedServicesDetails": [
        {
            "id": "string",
            "amount": {
                "currencyCode": "string",
                "currencyAmount": 0
            }
        }
    ],
    "taxDetails": [
        {
            "taxType": "CGST",
            "taxRate": "string",
            "taxAmount": {
                "currencyCode": "string",
                "amount": "string"
            },
            "taxableAmount": {
                "currencyCode": "string",
                "amount": "string"
            }
        }
    ],
    "channelDetails": {
        "channelType": "AMAZON",
        "amazonOrderDetails": {
            "orderId": "string"
        },
        "amazonShipmentDetails": {
            "shipmentId": "string"
        }
    },
    "labelSpecifications": {
        "format": "PDF",
        "size": {
            "width": 0,
            "length": 0,
            "unit": "INCH"
        },
        "dpi": 0,
        "pageLayout": "string",
        "needFileJoining": true,
        "requestedDocumentTypes": [
            "PACKSLIP"
        ],
        "requestedLabelCustomization": {
            "requestAttributes": [
                "PACKAGE_CLIENT_REFERENCE_ID"
            ]
        }
    },
    "serviceSelection": {
        "serviceId": [
            "string"
        ]
    },
    "shipperInstruction": {
        "deliveryNotes": "string"
    },
    "destinationAccessPointDetails": {
        "accessPointId": "string"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/shipping/v2/oneClickShipment' \
--header 'x-amzn-shipping-business-id;' \
--header 'Content-Type: application/json' \
--data '{
    "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"
    },
    "returnTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "string",
        "county": "string",
        "district": "string",
        "stateOrRegion": "string",
        "postalCode": "string",
        "countryCode": "string",
        "phone": "string"
    },
    "shipDate": "2019-08-24T14:15:22.123Z",
    "goodsOwner": {
        "merchantId": "string"
    },
    "packages": [
        {
            "packageTrackingNumber": "string"
        }
    ],
    "valueAddedServicesDetails": [
        {
            "id": "string",
            "amount": {
                "currencyCode": "string",
                "currencyAmount": 0
            }
        }
    ],
    "taxDetails": [
        {
            "taxType": "CGST",
            "taxRate": "string",
            "taxAmount": {
                "currencyCode": "string",
                "amount": "string"
            },
            "taxableAmount": {
                "currencyCode": "string",
                "amount": "string"
            }
        }
    ],
    "channelDetails": {
        "channelType": "AMAZON",
        "amazonOrderDetails": {
            "orderId": "string"
        },
        "amazonShipmentDetails": {
            "shipmentId": "string"
        }
    },
    "labelSpecifications": {
        "format": "PDF",
        "size": {
            "width": 0,
            "length": 0,
            "unit": "INCH"
        },
        "dpi": 0,
        "pageLayout": "string",
        "needFileJoining": true,
        "requestedDocumentTypes": [
            "PACKSLIP"
        ],
        "requestedLabelCustomization": {
            "requestAttributes": [
                "PACKAGE_CLIENT_REFERENCE_ID"
            ]
        }
    },
    "serviceSelection": {
        "serviceId": [
            "string"
        ]
    },
    "shipperInstruction": {
        "deliveryNotes": "string"
    },
    "destinationAccessPointDetails": {
        "accessPointId": "string"
    }
}'

返回响应

🟢200成功

application/json

成功。

Headers

Bodyapplication/json

示例

{
    "shipmentId": "87852211788104",
    "packageDocumentDetails": [
        {
            "packageClientReferenceId": "#abcd",
            "packageDocuments": [
                {
                    "type": "LABEL",
                    "format": "PNG",
                    "contents": "sdioadaiosfhdodsaiufhouafhoudfhdouahfac=="
                }
            ],
            "trackingId": 1578648261977
        }
    ],
    "promise": {
        "pickupWindow": {
            "start": "2019-12-11T07:09:05.513Z",
            "end": "2019-12-11T09:09:05.513Z"
        },
        "deliveryWindow": {
            "start": "2019-12-13T07:09:05.513Z",
            "end": "2019-12-13T09:09:05.513Z"
        }
    },
    "carrier": {
        "id": "AMZN_UK",
        "name": "Amazon Shipping"
    },
    "service": {
        "id": "SWA-UK-PREM",
        "name": "Amazon Shipping One Day"
    },
    "totalCharge": {
        "unit": "GBP",
        "value": 4.76
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障