当前位置: API文档

sales_trade_replenish.php(创建补发订单)

1.接口说明

1.1 接口描:通过接口推送补发订单给ERP

1.2 适用版本:网页版

2.调用场景

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/sales_trade_replenish.php
正式环境https://openapi.huice.com/openapi/sales_trade_replenish.php

  3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
卖家账号, 由旺店通分配
接口账号keyString
由旺店通分配appkey, 在发送的数据中对应 key 字段
秒级时间戳timestampint
北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。
签名signString
签名

   3.3 业务请求参数

字段名称Y 字段Y父级字段Y类型Y枚举是否必填默认值
订单主信息部分trade_info
单个订单 ,不是数组

JSON 格式的字符串放

在form 参数 trade_info 中 



订单trade_no

(补发的订单trade_no)

trade_notrade_infovarchar(64)

收件人姓名receiver_nametrade_infovarchar(128)

收件人手机号receiver_mobiletrade_infovarchar(128)

收件人详细地址receiver_addresstrade_infovarchar(255)

收件人省编码receiver_provincetrade_infoint

收件人市编码receiver_citytrade_infoint

收件人区编码receiver_districttrade_infoint

客服备注cs_remarktrade_infovarchar(1024)

是否审核is_checktrade_infoint1 审核 (自动执行审核)
0 不审核 默认为0

补发的货品信息spec_listtrade_info


商品规格编码spec_nospec_listvarchar(64)

数量numspec_listdecimal(19,4)

是否组合装is_suitespec_listint0 否 1 是 默认 00
金额amountspec_listdecimal(19,4)


4.响应参数

4.1公共相应参数

名称字段类型长度必须描述
返回码codeint
0成功 其他值失败
返回messagemessagevarchar(255)
成功时为空
订单编号
trade_nos数组 data[varchar(64)]

订单idtrade_ids数组 data[bigint(20)]

5.请求示例

PHP
<?php
require_once('../WdtClient.php');
$c = new WdtClient;
$c->sid = '';
$c->appkey = '';
$c->appsecret = "";
$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/sales_trade_replenish.php';

$tradeInfo = [
    'trade_no' => 'JY2509150112',
    'is_check' => 1,
    'receiver_address' => '详细地址',
    'receiver_mobile' => '11155555543',
    'receiver_name' => '6666666666',
    'receiver_province' => '330000',
    'receiver_city' => '330100',
    'receiver_district' => '330108',
    'spec_list' => [
        ['spec_no' => '6903244673273', 'num' => 12],
        ['spec_no' => 'P7S022229', 'num' => 12]
    ]
];


$c->putApiParam('trade_info', json_encode($tradeInfo));
$json = $c->wdtOpenApi();
var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "trade_nos": [
        "JY2601280003"
    ],
    "trade_ids": [
        "2789447850105241602"
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 30401,
    "message": "传入的spec_no错误"
}




常用工具