Preview order

POST

/taobao/purchase/order/render

Product preview interface, through which you can obtain accurate prices and shipping costs in China. Before calling the product preview interface, please call the credential stuffing interface (use mpId for itemId and mpSkuid for skuId).

请求参数

Body 参数application/json

appKey

string

必需

大吉平台appKey

appSecret

string

必需

秘钥，仅调试使用，正式用sign签名

need_supplychain_service

boolean

填写false

必需

receiver_address

object

必需

收货人地址信息（填写中国仓库信息即可）

country

string

一级地址（国家）

必需

state

string

必需

二级地址（省、自治区、直辖市）

city

string

三级地址（市）

必需

district

string

必需

四级地址（县、区、县级市）

address

string

详细地址

必需

zip

string

邮编

必需

name

string

姓名

必需

phone

string

电话

必需

mobile_phone

string

手机号

必需

warehouse_address

object

中国仓库地址

必需

country

string

一级地址（国家）

必需

state

string

必需

二级地址（省、直辖市、自治区）

city

string

三级地址（市）

必需

district

string

必需

四级地址（县、区、县级市）

address

string

详细地址

必需

zip

string

邮编

必需

phone

string

姓名

必需

mobile_phone

string

电话

必需

name

string

手机号

必需

render_item_List

string

必需

预览商品列表，此处itemId与skuId信息，需要先调用撞库接口获得mpId与mpSkuid，itemId请填写mpId，skuId请填写mpSkuid。

示例

{
  "appKey": "",
  "appSecret": "",
  "need_supplychain_service": false,
  "receiver_address": {
    "country": "中国",
    "state": "上海市",
    "city": "上海市",
    "district": "张江区",
    "address": "中华大街888号",
    "zip": "000000",
    "name": "张三",
    "phone": "18888888888",
    "mobile_phone": "18888888888"
  },
  "warehouse_address": {
    "country": "中国",
    "state": "上海市",
    "city": "上海市",
    "district": "张江区",
    "address": "中华大街888号",
    "zip": "000000",
    "name": "张三",
    "phone": "18888888888",
    "mobile_phone": "18888888888"
  },
  "render_item_List": "[{\"itemId\":2048153758314474,\"quantity\":\"1\",\"skuId\":3357413213162}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.dajisaas.com/taobao/purchase/order/render' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "",
    "appSecret": "",
    "need_supplychain_service": false,
    "receiver_address":
    {
        "country": "中国",
        "state": "上海市",
        "city": "上海市",
        "district": "张江区",
        "address": "中华大街888号",
        "zip": "000000",
        "name": "张三",
        "phone": "18888888888",
        "mobile_phone": "18888888888"
    },
    "warehouse_address":
    {
        "country": "中国",
        "state": "上海市",
        "city": "上海市",
        "district": "张江区",
        "address": "中华大街888号",
        "zip": "000000",
        "name": "张三",
        "phone": "18888888888",
        "mobile_phone": "18888888888"
    },
    "render_item_List": "[{\"itemId\":2048153758314474,\"quantity\":\"1\",\"skuId\":3357413213162}]"
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

消息

必需

data

object

业务数据

必需

result

object

返回结果

必需

code

string

返回码

必需

requestId

string

必需

TraceId

string

必需

timestamp

integer

必需

traceId

string

必需

示例

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "result": {
      "data": {
        "totalRealPayPrice": {
          "amount": 1260,
          "currency": "CNY"
        },
        "unavailableSkuList": [],
        "renderItemList": [
          {
            "nick": "zhulinws286",
            "itemPriceInfos": [
              {
                "itemId": 2048153758314474,
                "quantity": 1,
                "discountPrice": {
                  "amount": 2180,
                  "currency": "CNY"
                },
                "originPrice": {
                  "amount": 2180,
                  "currency": "CNY"
                },
                "skuId": 3357413213162
              }
            ],
            "sellerId": 172619986,
            "mainlandShippingFee": {
              "amount": 0,
              "currency": "CNY"
            },
            "orderFee": {
              "amount": 1480,
              "currency": "CNY"
            },
            "chooseSupplyChainServices": []
          }
        ]
      },
      "success": true
    },
    "code": "0",
    "requestId": "21412b5817231079530794815",
    "TraceId": "21410ddd17231079530752255e5d3b"
  },
  "timestamp": 1723107954115,
  "traceId": "c804971a0a0b"
}

修改于 2024-08-08 16:21:54

Product Bunker interface(撞库)

Create order