当前位置： API文档

sales_trade_batch_change.php   （批量换货）

¥标准

1.接口说明

1.1 接口描述：订单批量换货
1.2 适用版本：网页版

2.调用场景

2.1 举例说明：自有商城接入ERP、金蝶接入、用友接入、SAP接入等

3.请求参数说明

   

3.1 请求地址

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

   

3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString
是本开放平台“自助对接”功能模块内自助申请，获取方式点击这里
时间戳timestampint
是北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名signString
是API输入参数签名结果，签名算法介绍单击这里

   

3.3 业务请求参数

名称字段Y字段描述Y类型Y枚举是否必须
订单换货信息trade_info_list
换货主要信息[ ]
是
订单trade_idtrade_idtrade_info_list
bigint(20)
是
换货参数change_info_listtrade_info_list
[ ]
是
订单明细idrec_idchange_info_list


是
原订单被换商品数量numchange_info_list
decimal(19, 4)
是
换出新商品信息spec_listchange_info_list
[ ]
是
换出商品idspec_idspec_list货品档案的spec_idbigint(20)
是
换出数量numspec_list
decimal(19, 4)
是


 4.响应参数

 

4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述，多个订单失败原因用 英文 分号 “;” 标识

  

4.2 业务响应参数

  records

名称字段类型长度必须描述
订单编号trade_nosdata[varchar]64否
订单idtrade_idsdata[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_batch_change.php';
 
$trade_info_list = [
  [
    "trade_id"=> "2734447459538305026",
    "change_info_list"=> [
      [
        "rec_id"=> "2734447459538307074",
        "num"=> "1",
        "spec_list"=> [
          [
            "spec_id"=> "2788722012439183360",
            "num"=>"1"
          ]
        ]

      ],
       [
        "rec_id"=> "2734447459538308098",
        "num"=> "1",
        "spec_list"=> [
          [
            "spec_id"=> "2787359232045875215",
            "num"=> "1"
          ]
        ]

      ]
    ]
  ]
];


$c->putApiParam('trade_info_list', json_encode($trade_info_list, JSON_UNESCAPED_UNICODE));
$json = $c->wdtOpenApi();
var_dump($json);

?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "trade_nos": [
        "JY2508290053"
    ],
    "trade_ids": [
        "2734447459538305026"
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 1020,
    "message": "请勿重复操作",
    "trade_nos": null,
    "trade_ids": null
}





常用工具