Consult overseas freight estimate

POST

/v2/open/pp/logistics/itemLogisticsPrice

商品维度

请求参数

Query 参数

timestamp

string

必需

sign

string

必需

Header 参数

nonce-str

string

可选

默认值:

nonce-str

Body 参数application/json

itemId

string

必需

skuId

string

必需

receiverAddress

object (ReceiverAddressTO)

必需

name

string | null

可选

string | null

可选

phone

string | null

可选

mobilePhone

string | null

可选

address

string | null

可选

taxId

string | null

可选

country

string | null

可选

city

string | null

可选

zip

string | null

可选

state

string | null

可选

quantity

integer

必需

currency

string

必需

price

string

必需

示例

{
  "itemId": "2048232789087639",
  "skuId": "4970432383383",
  "quantity": 1,
  "receiverAddress": {
    "country": "US",
    "state": "California",
    "city": "VALLEY VLG",
    "zip": "91607",
    "address": "5818 WHITSETT AVE 401",
    "name": "Ofir Birinbaum",
    "phone": "5083326888",
    "mobilePhone": "5083326888",
    "email": "1229220680@qq.com"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/open/pp/logistics/itemLogisticsPrice?timestamp&sign' \
--header 'nonce-str: nonce-str' \
--header 'Content-Type: application/json' \
--data-raw '{
     "itemId": "2048232789087639",
     "skuId": "4970432383383",
     "quantity": 1,
     "receiverAddress": {
        "country": "US",
        "state": "California",
        "city": "VALLEY VLG",
        "zip": "91607",
        "address": "5818 WHITSETT AVE 401",
        "name": "Ofir Birinbaum",
        "phone": "5083326888",
        "mobilePhone": "5083326888",
        "email": "1229220680@qq.com"
    }
}'

返回响应

🟢200成功

application/json

Body

errorCode

integer | null

返回码

可选

errorMsg

string | null

返回码对应信息

可选

success

boolean | null

可选

data

array[object (ItemFreightFeeResult) {6}] | null

返回内容

可选

serviceId

string | null

可选

companyName

string | null

可选

serviceCategory

string | null

可选

logisticsTime

object (LogisticsTime)

可选

shippingFee

object (FeeTO)

可选

taxFee

object (FeeTO)

必需

示例

成功示例异常示例

{
  "errorCode": 200,
  "errorMsg": null,
  "success": true,
  "data": [
    {
      "serviceId": "1",
      "companyName": "泛远中美空运集运专线",
      "shippingFee": {
        "amount": "322.92",
        "currency": "USD"
      },
      "serviceCategory": "air",
      "logisticsTime": {
        "mode": "1",
        "min": "5",
        "max": "7"
      }
    },
    {
      "serviceId": "2",
      "companyName": "泛远中美海运集运专线",
      "shippingFee": {
        "amount": "322.92",
        "currency": "USD"
      },
      "serviceCategory": "sea",
      "logisticsTime": {
        "mode": "1",
        "min": "6",
        "max": "9"
      }
    }
  ]
}

修改于 2025-04-25 06:17:40

Address addition and update

Order overseas freight preview