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",
        "companyName": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "string",
        "postalCode": "string",
        "email": "string",
        "phoneNumber": "string",
        "geocode": {
            "latitude": "string",
            "longitude": "string"
        }
    },
    "shipFrom": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "companyName": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "string",
        "postalCode": "string",
        "email": "string",
        "phoneNumber": "string",
        "geocode": {
            "latitude": "string",
            "longitude": "string"
        }
    },
    "returnTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "companyName": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "string",
        "postalCode": "string",
        "email": "string",
        "phoneNumber": "string",
        "geocode": {
            "latitude": "string",
            "longitude": "string"
        }
    },
    "shipDate": "2019-08-24T14:15:22Z",
    "packages": [
        {
            "dimensions": {
                "length": 0,
                "width": 0,
                "height": 0,
                "unit": "INCH"
            },
            "weight": {
                "unit": "GRAM",
                "value": 0
            },
            "insuredValue": {
                "value": 0,
                "unit": "str"
            },
            "isHazmat": true,
            "sellerDisplayName": "string",
            "charges": [
                {
                    "amount": {
                        "value": 0,
                        "unit": "str"
                    },
                    "chargeType": "TAX"
                }
            ],
            "packageClientReferenceId": "string",
            "items": [
                {
                    "itemValue": {
                        "value": 0,
                        "unit": "str"
                    },
                    "description": "string",
                    "itemIdentifier": "string",
                    "quantity": 0,
                    "weight": {
                        "unit": "GRAM",
                        "value": 0
                    },
                    "liquidVolume": {
                        "unit": "ML",
                        "value": 0
                    },
                    "isHazmat": true,
                    "dangerousGoodsDetails": {
                        "unitedNationsRegulatoryId": "string",
                        "transportationRegulatoryClass": "string",
                        "packingGroup": "I",
                        "packingInstruction": "PI965_SECTION_IA"
                    },
                    "productType": "string",
                    "invoiceDetails": {
                        "invoiceNumber": "string",
                        "invoiceDate": "2019-08-24T14:15:22Z"
                    },
                    "serialNumbers": [
                        "string"
                    ],
                    "directFulfillmentItemIdentifiers": {
                        "lineItemID": "string",
                        "pieceNumber": "string"
                    }
                }
            ]
        }
    ],
    "valueAddedServicesDetails": [
        {
            "id": "string",
            "amount": {
                "value": 0,
                "unit": "str"
            }
        }
    ],
    "taxDetails": [
        {
            "taxType": "GST",
            "taxRegistrationNumber": "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"
        ]
    },
    "serviceSelection": {
        "serviceId": [
            "string"
        ]
    },
    "shipperInstruction": {
        "deliveryNotes": "string"
    },
    "destinationAccessPointDetails": {
        "accessPointId": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/shipping/v2/oneClickShipment' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shipTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "companyName": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "string",
        "postalCode": "string",
        "email": "string",
        "phoneNumber": "string",
        "geocode": {
            "latitude": "string",
            "longitude": "string"
        }
    },
    "shipFrom": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "companyName": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "string",
        "postalCode": "string",
        "email": "string",
        "phoneNumber": "string",
        "geocode": {
            "latitude": "string",
            "longitude": "string"
        }
    },
    "returnTo": {
        "name": "string",
        "addressLine1": "string",
        "addressLine2": "string",
        "addressLine3": "string",
        "companyName": "string",
        "stateOrRegion": "string",
        "city": "string",
        "countryCode": "string",
        "postalCode": "string",
        "email": "string",
        "phoneNumber": "string",
        "geocode": {
            "latitude": "string",
            "longitude": "string"
        }
    },
    "shipDate": "2019-08-24T14:15:22Z",
    "packages": [
        {
            "dimensions": {
                "length": 0,
                "width": 0,
                "height": 0,
                "unit": "INCH"
            },
            "weight": {
                "unit": "GRAM",
                "value": 0
            },
            "insuredValue": {
                "value": 0,
                "unit": "str"
            },
            "isHazmat": true,
            "sellerDisplayName": "string",
            "charges": [
                {
                    "amount": {
                        "value": 0,
                        "unit": "str"
                    },
                    "chargeType": "TAX"
                }
            ],
            "packageClientReferenceId": "string",
            "items": [
                {
                    "itemValue": {
                        "value": 0,
                        "unit": "str"
                    },
                    "description": "string",
                    "itemIdentifier": "string",
                    "quantity": 0,
                    "weight": {
                        "unit": "GRAM",
                        "value": 0
                    },
                    "liquidVolume": {
                        "unit": "ML",
                        "value": 0
                    },
                    "isHazmat": true,
                    "dangerousGoodsDetails": {
                        "unitedNationsRegulatoryId": "string",
                        "transportationRegulatoryClass": "string",
                        "packingGroup": "I",
                        "packingInstruction": "PI965_SECTION_IA"
                    },
                    "productType": "string",
                    "invoiceDetails": {
                        "invoiceNumber": "string",
                        "invoiceDate": "2019-08-24T14:15:22Z"
                    },
                    "serialNumbers": [
                        "string"
                    ],
                    "directFulfillmentItemIdentifiers": {
                        "lineItemID": "string",
                        "pieceNumber": "string"
                    }
                }
            ]
        }
    ],
    "valueAddedServicesDetails": [
        {
            "id": "string",
            "amount": {
                "value": 0,
                "unit": "str"
            }
        }
    ],
    "taxDetails": [
        {
            "taxType": "GST",
            "taxRegistrationNumber": "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"
        ]
    },
    "serviceSelection": {
        "serviceId": [
            "string"
        ]
    },
    "shipperInstruction": {
        "deliveryNotes": "string"
    },
    "destinationAccessPointDetails": {
        "accessPointId": "string"
    }
}'

返回响应

🟢200成功

application/json

成功。

Headers

Body

示例

{
    "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服务器故障