数字化供应链 接口文档
  1. 订单
数字化供应链 接口文档
  • 公共消息
  • 消息说明
  • 商品
    • 获取商品详情v2
      GET
    • 批量获取详情v2
      POST
    • 获取全量分类v2
      GET
    • 获取逐级类目v2
      GET
    • 批量更新商品v2
      POST
  • 选品
    • 选品分组列表v2
      GET
    • 在线选品v2(新版)
      POST
    • 选品分组商品列表v2
      POST
    • 选品库增加商品v2
      GET
    • 选品库商品列表v2
      GET
    • 选品库移除商品v2
      GET
  • 订单
    • 可售检测V2
      GET
    • 前置校验V2
      POST
    • 提交下单V2
      POST
    • 全平台订单列表V2
      GET
    • 各平台订单列表V2
      GET
  • 物流
    • 确认收货
      POST
    • 物流查询v2
      GET
    • 获取物流公司列表V2
      GET
  • 售后
    • 售后前置校验V2
      POST
    • 上传售后凭证(图片)V2
      POST
    • 申请售后V2
      POST
    • 售后列表V2
      GET
    • 售后详情V2
      GET
    • 退货商家邮寄信息
      PATCH
  • 消息
    • 店铺订单取消
    • 商品下架
    • 交易成功
    • 售后同意
    • 商品上架
    • 商品已收货
    • 售后拒绝
    • 商品修改
    • 商家已发货
    • 售后退款到账
    • 商品价格变更
    • 商品库添加
    • 移除商品库商品
  1. 订单

前置校验V2

POST
/v2/order/beforeCheck

必须使用新签名算法#

此接口一般常应用于客户付款之前确认订单页面,该接口会返回运费及当下订单传入的商品是否有不可售的商品,如有不可售会告知具体不可售原因,以保证商品下单后都能流转到供应链中台,其中price价格为检验协议价格,如不传后续价格不匹配损失由客户承担。#

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
spu
array [object {3}] 
商品组
必需
sku
number 
必需
商品唯一规格id(商品详情中option的id)
number
number 
数量
必需
price
integer 
可选
协议价 单位分 非必传 如果需要比价 可用此字段 后期会改成必传
address
object 
地址
必需
consignee
string 
收货人
必需
phone
string 
联系方式
必需
province
string 
省
必需
city
string 
市
必需
area
string 
区
必需
street
string 
街道
必需
description
string 
详细
必需
示例
{
    "spu": [
        {
            "sku": 0,
            "number": 0,
            "price": 0
        }
    ],
    "address": {
        "consignee": "string",
        "phone": "string",
        "province": "string",
        "city": "string",
        "area": "string",
        "street": "string",
        "description": "string"
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/order/beforeCheck' \
--header 'Content-Type: application/json' \
--data-raw '{
    "spu": [
        {
            "sku": 0,
            "number": 0,
            "price": 0
        }
    ],
    "address": {
        "consignee": "string",
        "phone": "string",
        "province": "string",
        "city": "string",
        "area": "string",
        "street": "string",
        "description": "string"
    }
}'

返回响应

🟢200成功
application/json
Body
code
number 
必需
1:成功,10001:地址错误
msg
string 
描述说明
必需
data
array [object {3}] 
返回的数据
必需
freight
number 
运费
必需
skus
array[number]
规格组
必需
money
number 
协议价+服务费
可选
示例
{
    "code": 0,
    "msg": "string",
    "data": [
        {
            "freight": 0,
            "skus": [
                0
            ],
            "money": 0
        }
    ]
}
上一页
可售检测V2
下一页
提交下单V2
Built with