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

返回满足指定运输请求详细信息的运输服务优惠列表。

使用计划：

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

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

请求参数

Body 参数application/json

示例

{
    "ShipmentRequestDetails": {
        "AmazonOrderId": "string",
        "SellerOrderId": "string",
        "ItemList": [
            {
                "OrderItemId": "string",
                "Quantity": 0,
                "ItemWeight": {
                    "Value": 0,
                    "Unit": "oz"
                },
                "ItemDescription": "string",
                "TransparencyCodeList": [
                    "string"
                ],
                "ItemLevelSellerInputsList": [
                    {
                        "AdditionalInputFieldName": "string",
                        "AdditionalSellerInput": {
                            "DataType": "string",
                            "ValueAsString": "string",
                            "ValueAsBoolean": true,
                            "ValueAsInteger": 0,
                            "ValueAsTimestamp": "2019-08-24T14:15:22Z",
                            "ValueAsAddress": {
                                "Name": "string",
                                "AddressLine1": "string",
                                "AddressLine2": "string",
                                "AddressLine3": "string",
                                "DistrictOrCounty": "string",
                                "Email": "string",
                                "City": "string",
                                "StateOrProvinceCode": "string",
                                "PostalCode": "string",
                                "CountryCode": "string",
                                "Phone": "string"
                            },
                            "ValueAsWeight": {
                                "Value": 0,
                                "Unit": "oz"
                            },
                            "ValueAsDimension": {
                                "value": 0,
                                "unit": "inches"
                            },
                            "ValueAsCurrency": {
                                "CurrencyCode": "str",
                                "Amount": 0
                            }
                        }
                    }
                ],
                "LiquidVolume": {
                    "Unit": "ML",
                    "Value": 0
                },
                "IsHazmat": true,
                "DangerousGoodsDetails": {
                    "UnitedNationsRegulatoryId": "string",
                    "TransportationRegulatoryClass": "string",
                    "PackingGroup": "I",
                    "PackingInstruction": "PI965_SECTION_IA"
                }
            }
        ],
        "ShipFromAddress": {
            "Name": "string",
            "AddressLine1": "string",
            "AddressLine2": "string",
            "AddressLine3": "string",
            "DistrictOrCounty": "string",
            "Email": "string",
            "City": "string",
            "StateOrProvinceCode": "string",
            "PostalCode": "string",
            "CountryCode": "string",
            "Phone": "string"
        },
        "PackageDimensions": {
            "Length": 0,
            "Width": 0,
            "Height": 0,
            "Unit": "inches",
            "PredefinedPackageDimensions": "FedEx_Box_10kg"
        },
        "Weight": {
            "Value": 0,
            "Unit": "oz"
        },
        "MustArriveByDate": "2019-08-24T14:15:22Z",
        "ShipDate": "2019-08-24T14:15:22Z",
        "ShippingServiceOptions": {
            "DeliveryExperience": "DeliveryConfirmationWithAdultSignature",
            "DeclaredValue": {
                "CurrencyCode": "str",
                "Amount": 0
            },
            "CarrierWillPickUp": true,
            "CarrierWillPickUpOption": "CarrierWillPickUp",
            "LabelFormat": "PDF"
        },
        "LabelCustomization": {
            "CustomTextForLabel": "string",
            "StandardIdForLabel": "AmazonOrderId"
        }
    },
    "ShippingOfferingFilter": {
        "IncludePackingSlipWithLabel": true,
        "IncludeComplexShippingOptions": true,
        "CarrierWillPickUp": "CarrierWillPickUp",
        "DeliveryExperience": "DeliveryConfirmationWithAdultSignature"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/mfn/v0/eligibleShippingServices' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ShipmentRequestDetails": {
        "AmazonOrderId": "string",
        "SellerOrderId": "string",
        "ItemList": [
            {
                "OrderItemId": "string",
                "Quantity": 0,
                "ItemWeight": {
                    "Value": 0,
                    "Unit": "oz"
                },
                "ItemDescription": "string",
                "TransparencyCodeList": [
                    "string"
                ],
                "ItemLevelSellerInputsList": [
                    {
                        "AdditionalInputFieldName": "string",
                        "AdditionalSellerInput": {
                            "DataType": "string",
                            "ValueAsString": "string",
                            "ValueAsBoolean": true,
                            "ValueAsInteger": 0,
                            "ValueAsTimestamp": "2019-08-24T14:15:22Z",
                            "ValueAsAddress": {
                                "Name": "string",
                                "AddressLine1": "string",
                                "AddressLine2": "string",
                                "AddressLine3": "string",
                                "DistrictOrCounty": "string",
                                "Email": "string",
                                "City": "string",
                                "StateOrProvinceCode": "string",
                                "PostalCode": "string",
                                "CountryCode": "string",
                                "Phone": "string"
                            },
                            "ValueAsWeight": {
                                "Value": 0,
                                "Unit": "oz"
                            },
                            "ValueAsDimension": {
                                "value": 0,
                                "unit": "inches"
                            },
                            "ValueAsCurrency": {
                                "CurrencyCode": "str",
                                "Amount": 0
                            }
                        }
                    }
                ],
                "LiquidVolume": {
                    "Unit": "ML",
                    "Value": 0
                },
                "IsHazmat": true,
                "DangerousGoodsDetails": {
                    "UnitedNationsRegulatoryId": "string",
                    "TransportationRegulatoryClass": "string",
                    "PackingGroup": "I",
                    "PackingInstruction": "PI965_SECTION_IA"
                }
            }
        ],
        "ShipFromAddress": {
            "Name": "string",
            "AddressLine1": "string",
            "AddressLine2": "string",
            "AddressLine3": "string",
            "DistrictOrCounty": "string",
            "Email": "string",
            "City": "string",
            "StateOrProvinceCode": "string",
            "PostalCode": "string",
            "CountryCode": "string",
            "Phone": "string"
        },
        "PackageDimensions": {
            "Length": 0,
            "Width": 0,
            "Height": 0,
            "Unit": "inches",
            "PredefinedPackageDimensions": "FedEx_Box_10kg"
        },
        "Weight": {
            "Value": 0,
            "Unit": "oz"
        },
        "MustArriveByDate": "2019-08-24T14:15:22Z",
        "ShipDate": "2019-08-24T14:15:22Z",
        "ShippingServiceOptions": {
            "DeliveryExperience": "DeliveryConfirmationWithAdultSignature",
            "DeclaredValue": {
                "CurrencyCode": "str",
                "Amount": 0
            },
            "CarrierWillPickUp": true,
            "CarrierWillPickUpOption": "CarrierWillPickUp",
            "LabelFormat": "PDF"
        },
        "LabelCustomization": {
            "CustomTextForLabel": "string",
            "StandardIdForLabel": "AmazonOrderId"
        }
    },
    "ShippingOfferingFilter": {
        "IncludePackingSlipWithLabel": true,
        "IncludeComplexShippingOptions": true,
        "CarrierWillPickUp": "CarrierWillPickUp",
        "DeliveryExperience": "DeliveryConfirmationWithAdultSignature"
    }
}'

返回响应

🟢200成功

application/json

成功

Headers

Body

示例

{
    "payload": {
        "ShippingServiceList": [
            {
                "ShippingServiceName": "string",
                "CarrierName": "string",
                "ShippingServiceId": "string",
                "ShippingServiceOfferId": "string",
                "ShipDate": "2019-08-24T14:15:22Z",
                "EarliestEstimatedDeliveryDate": "2019-08-24T14:15:22Z",
                "LatestEstimatedDeliveryDate": "2019-08-24T14:15:22Z",
                "Rate": {
                    "CurrencyCode": "str",
                    "Amount": 0
                },
                "ShippingServiceOptions": {
                    "DeliveryExperience": "DeliveryConfirmationWithAdultSignature",
                    "DeclaredValue": {
                        "CurrencyCode": "str",
                        "Amount": 0
                    },
                    "CarrierWillPickUp": true,
                    "CarrierWillPickUpOption": "CarrierWillPickUp",
                    "LabelFormat": "PDF"
                },
                "AvailableShippingServiceOptions": {
                    "AvailableCarrierWillPickUpOptions": [
                        {
                            "CarrierWillPickUpOption": "CarrierWillPickUp",
                            "Charge": {
                                "CurrencyCode": "str",
                                "Amount": 0
                            }
                        }
                    ],
                    "AvailableDeliveryExperienceOptions": [
                        {
                            "DeliveryExperienceOption": "DeliveryConfirmationWithAdultSignature",
                            "Charge": {
                                "CurrencyCode": "str",
                                "Amount": 0
                            }
                        }
                    ]
                },
                "AvailableLabelFormats": [
                    "PDF"
                ],
                "AvailableFormatOptionsForLabel": [
                    {
                        "IncludePackingSlipWithLabel": true,
                        "LabelFormat": "PDF"
                    }
                ],
                "RequiresAdditionalSellerInputs": true,
                "Benefits": {
                    "IncludedBenefits": [
                        "string"
                    ],
                    "ExcludedBenefits": [
                        {
                            "Benefit": "string",
                            "ReasonCodes": [
                                "string"
                            ]
                        }
                    ]
                }
            }
        ],
        "RejectedShippingServiceList": [
            {
                "CarrierName": "string",
                "ShippingServiceName": "string",
                "ShippingServiceId": "string",
                "RejectionReasonCode": "string",
                "RejectionReasonMessage": "string"
            }
        ],
        "TemporarilyUnavailableCarrierList": [
            {
                "CarrierName": "string"
            }
        ],
        "TermsAndConditionsNotAcceptedCarrierList": [
            {
                "CarrierName": "string"
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障