Order overseas freight preview

POST

/v2/open/pp/logistics/orderRenderFreight

请求参数

Query 参数

timestamp

string

必需

sign

string

必需

Header 参数

nonce-str

string

可选

默认值:

nonce-str

Body 参数application/json

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

可选

renderItems

array [object {6}] | null

可选

itemId

string

必需

skuId

string

必需

quantity

integer

必需

freightInfo

object (FreightInfoTO)

必需

currency

string

必需

price

string

必需

示例

{
  "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"
  },
  "renderItems": [
    {
      "itemId": "2048020617114736",
      "skuId": "413185732720",
      "quantity": 1,
      "freightInfo": {
        "serviceId": "1",
        "companyName": "",
        "serviceCategory": ""
      }
    },
    {
      "itemId": "2048232789087639",
      "skuId": "4970432383383",
      "quantity": 2,
      "freightInfo": {
        "serviceId": "2",
        "companyName": "",
        "serviceCategory": ""
      }
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/open/pp/logistics/orderRenderFreight?timestamp&sign' \
--header 'nonce-str: nonce-str' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
    },
    "renderItems": [
        {
            "itemId": "2048020617114736",
            "skuId": "413185732720",
            "quantity": 1,
            "freightInfo": {
                "serviceId": "1",
                "companyName": "",
                "serviceCategory": ""
            }
        },
        {
            "itemId": "2048232789087639",
            "skuId": "4970432383383",
            "quantity": 2,
            "freightInfo": {
                "serviceId": "2",
                "companyName": "",
                "serviceCategory": ""
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

errorCode

integer | null

返回码

可选

errorMsg

string | null

返回码对应信息

可选

success

boolean | null

可选

data

object (OrderRenderFreightResult)

返回内容

可选

availableList

array[object (RenderAvailableTO) {3}] | null

可选

unavailableList

array[object (LineItemTO) {8}] | null

可选

renderId

string | null

可选

示例

成功示例异常示例

{
  "errorCode": 200,
  "errorMsg": null,
  "success": true,
  "data": {
    "availableList": [
      {
        "shippingFee": {
          "amount": "322.92",
          "currency": "USD"
        },
        "items": [
          {
            "itemId": "2048020617114736",
            "skuId": "413185732720",
            "quantity": 1
          }
        ]
      },
      {
        "shippingFee": {
          "amount": "322.92",
          "currency": "USD"
        },
        "items": [
          {
            "itemId": "2048232789087639",
            "skuId": "4970432383383",
            "quantity": 2
          }
        ]
      }
    ],
    "unavailableList": [],
    "renderId": "FF2024080200001"
  }
}

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

Consult overseas freight estimate

Update domestic logistics information