GetShipmentDetails

返回与运输相关的详细信息，包括运输的详细信息、承运人的详细信息、运输状态、集装箱详细信息以及根据您指定的过滤参数值的其他相关详细信息。

使用计划：

速率（每秒请求）	突发
10	10

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

请求参数

Query 参数

limit

integer <int64>

可选

返回的记录数量限制。默认值为 50 条记录。

>= 1<= 50

sortOrder

enum<string>

可选

按采购订单创建日期升序或降序排序。

枚举值:

ASCDESC

nextToken

string

可选

用于分页，当发货数量超过指定的结果大小限制时。

createdAfter

string <date-time>

可选

在此时间戳之后可用的货运详细信息将包含在结果中。必须采用ISO 8601格式。

createdBefore

string <date-time>

可选

在此时间戳之前可用的装运详情将包括在结果中。必须采用 ISO 8601 格式。

shipmentConfirmedBefore

string <date-time>

可选

通过传递确认创建日期获取发货详情。必须采用 ISO 8601 格式。

shipmentConfirmedAfter

string <date-time>

可选

通过传递确认发货创建日期获取发货详情。必须采用 ISO 8601 格式。

packageLabelCreatedBefore

string <date-time>

可选

通过买方传递包裹标签创建日期获取运输详情。必须采用 ISO 8601 格式。

packageLabelCreatedAfter

string <date-time>

可选

通过买家传递包裹标签创建日期以获取发货详情。必须采用ISO 8601格式。

shippedBefore

string <date-time>

可选

通过传递发货日期获取装运详情，必须采用ISO 8601格式。

shippedAfter

string <date-time>

可选

通过传递发货日期之后获取发货详情。必须采用ISO 8601格式。

estimatedDeliveryBefore

string <date-time>

可选

通过传递预计送达日期获取运输详情。必须采用 ISO 8601 格式。

estimatedDeliveryAfter

string <date-time>

可选

通过传递预计送达日期获取运输详情。必须采用 ISO 8601 格式。

shipmentDeliveryBefore

string <date-time>

可选

通过传递以前的发货交付日期来获取发货详情。必须采用 ISO 8601 格式。

shipmentDeliveryAfter

string <date-time>

可选

通过传递发货交付日期获取货物运输详情。必须采用ISO 8601格式。

requestedPickUpBefore

string <date-time>

可选

通过传递请求提货日期之前的信息来获取货运详情。必须采用 ISO 8601 格式。

requestedPickUpAfter

string <date-time>

可选

通过传递请求取件日期获取发货详情。必须采用 ISO 8601 格式。

scheduledPickUpBefore

string <date-time>

可选

通过在预定提货日期之前传递来获取运输详情。必须采用 ISO 8601 格式。

scheduledPickUpAfter

string <date-time>

可选

通过传递计划取件日期后获取运输详细信息。必须采用ISO 8601格式。

currentShipmentStatus

string

可选

通过传递当前货物状态获取货物详细信息。

vendorShipmentIdentifier

string

可选

通过传递供应商发货ID获取发货详情

buyerReferenceNumber

string

可选

通过传递买家参考ID获取发货详情

buyerWarehouseCode

string

可选

根据买方仓库代码获取运输详情。该值应与运输中的 'shipToParty.partyId' 相同。

sellerWarehouseCode

string

可选

根据供应商仓库代码获取运输详情。该值应与运输中的'sellingParty.partyId'相同。

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

GetShipmentDetails 操作的响应模式。

payload

object (ShipmentDetails)

可选

GetShipmentDetails操作的请求模式。

pagination

object (Pagination)

可选

检索剩余数据所需的分页元素。

shipments

array[object (Shipment) {20}]

可选

一个包含一个或多个货物运输及其详细信息的列表。

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

{
    "payload": {
        "pagination": {
            "nextToken": "MDAwMDAwMDAwMQ=="
        },
        "shipments": [
            {
                "vendorShipmentIdentifier": "00050003",
                "buyerReferenceNumber": "1234567",
                "currentShipmentStatus": "CarrierAssigned",
                "currentshipmentStatusDate": "2019-08-09T19:56:45.632",
                "shipmentStatusDetails": [
                    {
                        "shipmentStatus": "CarrierAssigned",
                        "shipmentStatusDate": "2019-08-09T19:56:45.632"
                    },
                    {
                        "shipmentStatus": "TransportationRequested",
                        "shipmentStatusDate": "2019-07-07T19:56:45.632"
                    },
                    {
                        "shipmentStatus": "Created",
                        "shipmentStatusDate": "2019-07-06T19:56:45.632"
                    }
                ],
                "shipmentCreateDate": "2019-07-07T19:56:45.632",
                "shipmentConfirmDate": "2019-08-07T19:56:45.632",
                "packageLabelCreateDate": "2019-08-07T19:56:45.632",
                "shipmentFreightTerm": "Collect",
                "sellingParty": {
                    "partyId": "998US"
                },
                "shipFromParty": {
                    "address": {
                        "name": "ABC electronics warehouse",
                        "addressLine1": "DEF 1st street",
                        "city": "Lisses",
                        "stateOrRegion": "abcland",
                        "postalCode": "91090",
                        "countryCode": "DE"
                    },
                    "partyId": "ABCD12"
                },
                "shipToParty": {
                    "partyId": "999US"
                },
                "shipmentMeasurements": {
                    "totalCartonCount": 30,
                    "totalPalletStackable": 30,
                    "totalPalletNonStackable": 30,
                    "shipmentWeight": {
                        "unitOfMeasure": "Kg",
                        "value": "120.45"
                    },
                    "shipmentVolume": {
                        "unitOfMeasure": "CuFt",
                        "value": "2.4"
                    }
                },
                "collectFreightPickupDetails": {
                    "requestedPickUp": "2019-08-07T19:56:45.632",
                    "scheduledPickUp": "2019-08-07T19:56:45.632",
                    "carrierAssignmentDate": "2019-08-07T19:56:45.632"
                },
                "purchaseOrders": [
                    {
                        "purchaseOrderNumber": "1BBBAAAA",
                        "purchaseOrderDate": "2019-08-06T19:56:45.632",
                        "shipWindow": "08/25/2021 - 08/31/2021",
                        "items": [
                            {
                                "itemSequenceNumber": "001",
                                "vendorProductIdentifier": "9782700001659",
                                "buyerProductIdentifier": "9782700001690",
                                "shippedQuantity": {
                                    "amount": 100,
                                    "unitOfMeasure": "Eaches",
                                    "unitSize": 1
                                },
                                "maximumRetailPrice": {
                                    "currencyCode": "USD",
                                    "amount": "12345"
                                }
                            }
                        ]
                    }
                ],
                "importDetails": {
                    "methodOfPayment": "PaidByBuyer",
                    "sealNumber": "1232142132",
                    "route": {
                        "stops": [
                            {
                                "functionCode": "PortOfDischarge",
                                "locationIdentification": {
                                    "type": "string",
                                    "locationCode": "string",
                                    "countryCode": "US"
                                },
                                "arrivalTime": "2021-07-12T22:22:25.038Z",
                                "departureTime": "2021-07-12T22:22:25.038Z"
                            }
                        ]
                    },
                    "importContainers": "string",
                    "billableWeight": {
                        "unitOfMeasure": "G",
                        "value": "10"
                    },
                    "estimatedShipByDate": "2021-07-12T22:22:25.038Z",
                    "handlingInstructions": "Oversized"
                },
                "containers": [
                    {
                        "containerType": "carton",
                        "containerSequenceNumber": "001",
                        "containerIdentifiers": [
                            {
                                "containerIdentificationType": "SSCC",
                                "containerIdentificationNumber": "213124134213"
                            }
                        ],
                        "trackingNumber": "XXXX",
                        "dimensions": {
                            "length": "12",
                            "width": "12",
                            "height": "12",
                            "unitOfMeasure": "IN"
                        },
                        "weight": {
                            "unitOfMeasure": "KG",
                            "value": "10"
                        },
                        "packedItems": [
                            {
                                "itemSequenceNumber": "001",
                                "buyerProductIdentifier": "B07DFVDRAA",
                                "vendorProductIdentifier": "12312412421",
                                "packedQuantity": {
                                    "amount": 1,
                                    "unitOfMeasure": "Each"
                                },
                                "itemDetails": {
                                    "purchaseOrderNumber": "string",
                                    "lotNumber": "string",
                                    "expiry": {
                                        "manufacturerDate": "2021-07-12T22:22:25.038Z",
                                        "expiryDate": "2021-07-12T22:22:25.038Z",
                                        "expiryAfterDuration": {
                                            "durationUnit": "Days",
                                            "durationValue": 0
                                        }
                                    }
                                }
                            },
                            {
                                "containerType": "pallet",
                                "containerSequenceNumber": "002",
                                "containerIdentifiers": [
                                    {
                                        "containerIdentificationType": "SSCC",
                                        "containerIdentificationNumber": "ARK123214214213"
                                    }
                                ],
                                "trackingNumber": "TRACK001",
                                "dimensions": {
                                    "length": "12",
                                    "width": "12",
                                    "height": "12",
                                    "unitOfMeasure": "IN"
                                },
                                "weight": {
                                    "unitOfMeasure": "KG",
                                    "value": "10"
                                },
                                "tier": 2,
                                "block": 2,
                                "innerContainersDetails": {
                                    "containerCount": 10,
                                    "containerSequenceNumbers": [
                                        {
                                            "containerSequenceNumber": "002"
                                        },
                                        {
                                            "containerSequenceNumber": "003"
                                        }
                                    ]
                                },
                                "packedItems": [
                                    {
                                        "itemSequenceNumber": "001",
                                        "buyerProductIdentifier": "B07DFVDRAA",
                                        "vendorProductIdentifier": "12312412421",
                                        "packedQuantity": {
                                            "amount": 1,
                                            "unitOfMeasure": "Each"
                                        },
                                        "itemDetails": {
                                            "purchaseOrderNumber": "string",
                                            "lotNumber": "string",
                                            "expiry": {
                                                "manufacturerDate": "2021-07-12T22:22:25.038Z",
                                                "expiryDate": "2021-07-12T22:22:25.038Z",
                                                "expiryAfterDuration": {
                                                    "durationUnit": "Days",
                                                    "durationValue": 0
                                                }
                                            }
                                        }
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "transportationDetails": {
                    "shipMode": "LessThanTruckLoad",
                    "transportationMode": "Road",
                    "shippedDate": "2019-08-07T19:56:45.632",
                    "estimatedDeliveryDate": "2019-08-07T19:56:45.632",
                    "shipmentDeliveryDate": "2019-08-07T19:56:45.632",
                    "carrierDetails": {
                        "name": "UPS",
                        "phone": "1234567890",
                        "email": "abc@xyz.com",
                        "code": "string",
                        "shipmentReferenceNumber": "TRACK001"
                    },
                    "billOfLadingNumber": "string"
                }
            }
        ]
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应