当前位置： API文档

sales.TradeImport.upload（已完成订单推送）

¥标准

1.接口说明

1.1 接口描述：推送已完成订单给ERP
1.2 适用版本：客户端 V1.4.7.3及以上版本

1.5注意事项：【权限校验】：店铺权限、仓库权限

  • 一次最多传入200条数据

  • 数据不支持更新，需要保证请求参数正确

  • 推送的单据状态在客户端-销售-订单导入界面为待转已完成状态

2.调用场景

2.1 举例说明：财务系统、SAP、线下ERP、数据分析等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/openapi

  3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是卖家账号, 由旺店通分配
接口账号keyString
是由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
盐saltString
是由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
是调用的接口名称
版本号vString
是1.0
秒级时间戳timestampint
是秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
是签名

  3.3 业务请求参数

名称字段类型长度
必须描述
订单列表trade_listList<Map<String, Object>>
Y订单列表

trade_list

名称字段类型长度
必须描述
订单编号
trade_noString40Y订单编号
原始单号
src_tidsString255N
原始单号
原始子单号
src_oidString40N原始子单号
订单类别trade_typeByte
N

订单类别

1：网店销售

2：线下订单

3：售后换货

4：批发业务

7：现款销售

订单来源trade_fromByte
N

订单来源

1：API抓单

2：手工建单

3：导入

5：接口推送

6：补发订单

7：PDA选货开单

应收金额receivableDecimal(19,4)
Y应收金额
店铺名称shop_nameString128Y
店铺名称
仓库名称warehouse_nameString64Y
仓库名称
物流公司名称logistics_nameString40Y
系统内自定义的物流公司名称
邮费
post_amountDecimal(19,4)
N邮费
物流单号
logistics_noString40Y
物流单号
商家编码merchant_noString40
Y
商家编码
货品数量numDecimal(19,4)
Y
货品数量
货品价格order_priceDecimal(19,4)
Y
货品价格
业务员
salesmanString50N业务员
审单员checkerString50N审单员
发票类型invoice_typeByte
N

发票类型

0：不需要发票

1：普通发票

2：增值税发票

发票抬头invoice_titleString255
N发票抬头
发票内容invoice_contectString255
N发票内容
客户网名
buyer_nickString100
N客户网名
收件人receiver_nameString100
Y收件人
省份provinceString
N省份
城市cityString
N城市
区县
districtString
N区县
大头笔
receiver_dtb
String
128
N
大头笔
地址
receiver_address
String
256
Y
地址
邮编
receiver_zip
String
20
N
邮编
电话
receiver_mobileString
40
Y
电话
买家留言
buyer_message
String
1024
N
买家留言
客服备注
cs_remark
String
1024
N
客服备注
下单时间
trade_time
String

N

下单时间

yyyy-MM-dd HH:mm:ss格式

付款时间
pay_time
String

N

付款时间

yyyy-MM-dd HH:mm:ss格式

审单时间
check_time
String

N

审单时间

yyyy-MM-dd HH:mm:ss格式

打单时间
print_time
String

N

打单时间

yyyy-MM-dd HH:mm:ss格式

扫描时间
scan_time
String

N

扫描时间

yyyy-MM-dd HH:mm:ss格式

发货时间
consign_time
String

N

发货时间

yyyy-MM-dd HH:mm:ss格式

赠品方式
gift_type
Byte

N

赠品方式

0：非赠品

1：自动赠送

2：手动赠送

3：回购自动赠送

货品优惠
goods_discount
Decimal(19,4)
N
货品优惠

4.响应参数

名称字段类型长度
必须描述
状态码statusInt
Y

状态码为0，表示调用成功

错误信息

message

String


Y

无错误信息不返回

结果信息

data

Map<String, Object>


Y

结果信息

data

名称字段类型长度
必须描述
返回信息

message

String


Y

固定返回ok,该值不可以作为请求是否成功的标志

5.请求示例

Json格式请求报文
[
    [
        {
            "logistics_name": "自有",
            "logistics_no": "JYA2023071200005",
            "merchant_no": 4205,
            "num": 4,
            "receivable": 12.5,
            "receiver_address": "北京 北京市 西城区 西直门北大街凯德茂T1",
            "receiver_mobile": "13512340987",
            "shop_name": "东升的tb店铺",
            "trade_no": "JYA2023071200005",
            "trade_time": "2023-07-12 00:01:02",
            "warehouse_name": "高筱原的仓库1"
        }
    ]
]
PHP

<?php  
header("Content-Type: text/html; charset=UTF-8");  
date_default_timezone_set("Asia/Shanghai");  

$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret")
  
$trade1 = new stdClass();
$trade1-> trade_no = 'JYA2023071200005';
$trade1-> shop_name = '东升的tb店铺';
$trade1-> warehouse_name = '高筱原的仓库1';
$trade1-> logistics_name = '自有';
$trade1-> logistics_no = $trade1->trade_no;
$trade1-> merchant_no = 4205;
$trade1-> num = 4;
$trade1-> receivable = 12.5;
$trade1-> receiver_address = '北京 北京市 西城区 西直门北大街凯德茂T1';
$trade1-> receiver_mobile = '13512340987';
//$trade1-> receiver_name = '张张张';
//$trade1-> order_price = 2.5;
$trade1-> trade_time = '2023-07-12 00:01:02';
  
$tradeList = array();
array_push($tradeList, $trade1);

$response = $client->call("sales.TradeImport.upload", $tradeList); 
?>

JAVA
C#

6.响应示例

   6.1 正常响应示例 

JSON

{
    "data": {
        "message": "OK"
    },
    "status": 0
}

   6.2 异常响应示例

JSON
{
    "message": "订单编号已存在",
    "status": 100
}




常用工具