Depal Open API Doc
  1. 订单服务
Depal Open API Doc
  • 中文
    • 接入说明
      • 基本概念
      • 签名规则
      • 获取Token
    • 商品服务
      • 1688
        • 商品详情
        • 商品池查询
    • 订单服务
      • 下单前预览
        POST
      • 提交订单
        POST
      • 订单详情
        POST
      • 取消订单
        POST
      • 物流跟踪查询
        POST
  • English
    • API Instruction
      • Signature Rule
      • Get Token
    • product service
      • alibaba wholesale(1688)
        • Commodity Details
        • Commodity Pool Query
    • Order Service
      • Pre-order Preview
      • Submit Order
      • Order Details
      • Cancel Order
      • Logistics tracking query
  1. 订单服务

下单前预览

POST
/openapi/1/{appKey}/1688.order.create.preview

订单-预下单,错误码#

错误码错误描述解决方案
R500_001商品[offerId]不支持在线交易,无法下单。商品不支持在线交易,目前不能购买
R500_002商品[offerId]不属于同一卖家或者没有指定specId。存在多个卖家的商品或者商品没有指定specId
R500_003商品[offerId ]不属于同一卖家或者规格[specId] 不属于商品[offerId]存在多个卖家的商品或者商品不存在specId的规格
R500_004商品[offerId_specId]库存不足,请核实库存后订购。商品的某个规格库存不足
R500_005商品[offerId]的购买数量不满足起批量限制。商品的购买数量小于起批量
R500_006商品[offerId]的购买数量或者价格不满足混批限制。商品的购买数量或者总金额均不满足混批条件
R500_007与供应商的代销关系不存在,不能使用saleproxy通道下单。flow不能使用slproxy
R500_009商品[offerId]的购买数量不满足批售起批量限制。检查批售商品的购买数量
R500_008商品规格[offerId_specId]的价格为0,不可以下单,请检查后重新提交。检查下商品规格的价格

Request

Path Params
appKey
string 
required
Header Params
Authorization
string 
optional
Default:
{{smile_admin_Authon}}
Example:
{{smile_admin_Authon}}
x-depal-timestamp
string 
required
timestamp when calling the service, milliseconds
x-depal-access-token
string 
required
retrieve from "system.token.get"
x-depal-signature
string 
required
sign the request data, refer to the signature document
Body Params application/json
outOrderId
string 
optional
外部订单号
address
object (AddressDTO) 
optional
收货地址信息
userName
string 
optional
收件人,全名
phone
string 
optional
联系电话, 带国家号
country
string 
optional
国家代码
province
string 
optional
省代码
city
string 
optional
城市代码
address
string 
optional
详细地址
postCode
string 
optional
邮编
cargoList
array[object (CargoItemParam) {3}] 
optional
购买的商品,sku,数量
productId
integer <int64>
optional
商品ID
skuId
string 
optional
sku唯一标识, 字符串
quantity
integer 
optional
库存数量
Example
{
    "outOrderId": "string",
    "address": {
        "userName": "string",
        "phone": "string",
        "country": "string",
        "province": "string",
        "city": "string",
        "address": "string",
        "postCode": "string"
    },
    "cargoList": [
        {
            "productId": 0,
            "skuId": "string",
            "quantity": 0
        }
    ]
}

Responses

🟢200OK
application/json
Body
code
string 
optional
状态码
msg
string 
optional
信息
data
object (OrderCreatePreviewResult) 
optional
数据
previewId
string 
optional
每次preview,生成唯一ID
productTotalAmount
string 
optional
商品总金额 CNY 元 2.48
freightTotalAmount
string 
optional
运费,总金额 CNY 元 2.48
serviceTotalAmount
string 
optional
服务费总金额 CNY 元 2.48
cargoList
array[object (CargoItemResult) {7}] 
optional
购买的商品,sku,数量, 单价,总价
requestId
string 
optional
请求ID,方便问题跟踪
Example
{
    "code": "",
    "msg": "",
    "data": {
        "previewId": "",
        "productTotalAmount": "",
        "freightTotalAmount": "",
        "serviceTotalAmount": "",
        "cargoList": [
            {
                "productId": 0,
                "skuId": "",
                "quantity": 0,
                "price": "",
                "amount": "",
                "productName": "",
                "skuAttributeNames": [
                    ""
                ]
            }
        ]
    },
    "requestId": ""
}
Previous
商品池查询
Next
提交订单
Built with