API文档

Y_sales_trade_modify.php（修改系统订单仓库物流）

1.接口说明

1.1 接口描述：修改旺店通erp内订单的订单标记

2.调用场景

2.1 修改旺店通erp内订单的订单标记，用来修改系统订单的仓库和物流，支持对一个订单进行操作可以仅仅修改仓库，或者仅仅修改物流，或者都修改。

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapitest.huice.com/openapi/sales_trade_modify.php
正式环境	https://openapi.huice.com/openapi/sales_trade_modify.php

3.2 公共请求参数

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

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
订单编号	trade_no	varchar	40	是	系统订单编号，默认为JY开头
物流公司id	logistics_id	bigint(20)	20	否	物流公司id，使用物流公司接口返回的logistics_id
仓库id	warehouse_id	int	11	否	仓库id 使用仓库接口的 warehouse_id

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述

5. 请求示例

php

//创建原始订单
<?php
   require_once('../WdtClient.php');

   $c = new WdtClient;
    $c->sid ='';
    $c->appkey ='';
    $c->appsecret ="";
   $c->gatewayUrl = 'https://openapitest.huice.com/openapi/sales_trade_modify.php';
   //系统订单号
   $c->putApiParam('trade_no','JY2505130492');
   //仓库id
   $c->putApiParam('warehouse_id','6');
   //物流公司id
   $c->putApiParam('logistics_id','2675780066033532930');
    $json = $c->wdtOpenApi();
    var_dump($json);

    ?>

JAVA

package com.erpx.api.trade;

import com.erpx.api.CommonConstants;
import com.erpx.api.WdtClient;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

public class ChangeWarehouseService {
    public static void changeWarehouse() throws Exception {

        WdtClient client = new WdtClient(CommonConstants.sid, CommonConstants.appkey, CommonConstants.appSecret,
            CommonConstants.baseUrl);
        Map<String, String> params = new HashMap<String, String>();

        params.put("trade_no", "JY2505130492");
        params.put("warehouse_id", "6");
        params.put("logistics_id", "2675780066033532930");

        try {
            String response = client.execute("sales_trade_modify.php", params);
            System.out.println(response);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) throws Exception {
        changeWarehouse();
    }
}

python

#  修改系统订单的仓库店铺
import WdtClient
import json
from wdt_constants import *
t =  WdtClient.WdtClient(APPKEY, APPSECRET, SID, BASEURL)
params = {}
# 订单号 页面展示的系统订单号
params.update({"trade_no":'JY2505130492'})
# 仓库id
params.update({"warehouse_id": "6"})
# 物流id
params.update({"logistics_id": "2675780066033532930"})
response = t.execute("sales_trade_modify.php", params)
print(response)

6.响应示例

6.1 正常响应示例

JSON	{ "code": 0, "message":"" }

6.2 异常响应示例

JSON	{ "code": 2900, "message": "必传参数缺失入参：warehouse_id 和logistics_id不能同时为空" }