版本信息

v1.0	2020-05-15	上线
v1.1	2020-06-04	1订单列表接口参数中order_status 改为 trade_status 2订单列表接口参数中 trade_status 增加类型6：部分发货 3订单对象中order_id 修改为 trade_id 4订单对象中order_status 修改为 trade_status ,增加类型6：部分发货 5订单对象中添加 end_time 完成时间 6订单对象中添加 update_time 更新时间 7订单对象中增加 cod_fee货到付款金额 8订单对象中total_price 改为 payment_fee：实付总额 9订单对象中添加 adjust_fee 手工调整金额 10订单对象中 goods 改为 orders 11orders 中 order 对象添加 order_id 子订单唯一编号 12order 对象添加 order_status 子订单状态 13order 对象中添加 price、payment_fee、discount_fee、adjust_fee、use_points、send_time、end_time 14订单对象中去掉了 address对象，添加：receiver_name,receiver_phone,receiver_mobile,receiver_zip,receiver_state,receiver_city,receiver_district,receiver_town,receiver_address
v1.2	2020-06-16	1去掉订单对象order 中price字段，使用goods_price
v1.3	2020-06-22	接口名称及参数名称修改 1order_list 修改为 trade_list 2order_get 修改为 trade_get ，参数oid 修改为 trade_id 3order_send 修改为 trade_send ，参数oid修改为trade_id
v1.4	2020-08-10	发货接口支持订单部分商品发货

平台介绍
我打开放平台是我打软件为电商商家提供的自助接入式快递单打印发货服务。特别适合自建商城、微信小程序等电商商家，以及为此类商家提供开店软件的软件商。只需要简单的软件开发能力，即可接入我打提供的快递单打印发货能力及订单处理周边服务。
我打提供了标准的接口规范和鉴权方案，接入方只需按照接口规范实现相应接口即可。在我打开放平台提交接入申请、配置接口地址、测试接口实现是否正确。接口测试完毕后即可在我打中打单发货。
接入申请
申请地址：https://open.woda.com
接口鉴权
为了防止API调用过程中被黑客恶意篡改，接口被黑客恶意调用造成数据安全问题。接入方在接口实现中，要验证请求是否合法。我打发起的API请求会携带签名，接入方服务端要根据请求参数，对签名进行验证，签名不合法的请求要拒绝。
1. AppKey和AppSecret
AppKey和AppSecret是双方约定的身份识别和请求验证秘钥，双方要妥善保管，不可对其他任何第三方透露，以免造成数据泄露等安全问题；AppKey和AppSecret可以由接入方提供或由我打自动分配；如果接入方支持多个店铺商家模式，AppKey可以用来识别不同的店铺商家，用来作为数据分离的id。一个店铺对应一对AppKey/AppSecret。AppKey生成后原则上不支持变更。AppSecret支持变更，提高安全性。
2. 签名生成算法
1对所有API请求参数（包括系统参数和业务参数，但除去sign参数和byte[]类型的参数），根据参数名称的ASCII码表的顺序排序。如：foo:1, bar:2, foo_bar:3, foobar:4排序后的顺序是bar:2, foo:1, foo_bar:3, foobar:4。
2将排序好的参数名和参数值拼装在一起，根据上面的示例得到的结果为：bar2foo1foo_bar3foobar4。
3把拼装好的字符串前后加上AppSecret后，采用utf-8编码，使用MD5进行摘要，如：md5(AppSecretbar2foo1foo_bar3foobar4AppSecret)；
4将摘要得到的字节流结果使用十六进制表示，如：hex(“helloworld”.getBytes(“utf-8”)) = “68656C6C6F776F726C64”说明：MD5是128位长度的摘要算法，用16进制表示，一个十六进制的字符能表示4个位，所以签名后的字符串长度固定为32个十六进制字符。
API调用
API是基于HTTP协议来调用的，我打使用POST请求进行API调用，所有请求都必须带有系统参数
接入方响应流程：
收到HTTP请求> 解析参数 > 验证签名 > 验证时间戳 > 业务处理 > 返回json数据 
系统参数

系统参数	类型	说明
app_key	string	开放平台接入申请中填写的AppKey
method	string	接口名称：查询订单列表“trade_list”；查询单个订单详情“trade_get”；订单发货“trade_send”;宝贝列表“goods_list”
timestamp	string	时间戳（毫秒数），接入方需要校验时间戳，正负不能超过2分钟
format	string	固定值“json”，接入方给我打返回的数据类型为json类型
version	string	固定值“1.0”
sign_method	string	固定值“md5”
sign	string	签名（具体见：签名生成算法）

错误码

错误码	说明
0	成功
10001	签名验证失败
10002	时间戳无效
10003	app_key不存在
20001	订单不存在
20002	订单状态不支持发货
20003	不支持的快递公司
20004	不支持拆分发货
30001	商品不存在
30002	商品sku不存在
99999	系统错误

接口列表
1. 订单列表接口
接口名称:trade_list
业务参数：

参数	类型	说明	实例	备注
trade_status	string	订单状态请求值	0 所有          1 等待付款          2 等待发货          3 等待确认收货          4 交易成功          5 交易关闭       6 部分发货	必填
create_time_start	string	订单创建时间开始	2014-07-01 00:00:00
create_time_end	string	订单创建时间截止	2014-07-01 23:59:59	craete_time_start和create_time_end为一组; update_time_start和update_time_end为一组; 二组必选一组
update_time_start	string	订单更新时间起始	2014-07-01 00:00:00
update_time_end	string	订单更新时间截止	2014-07-01 23:59:59	create_time_start和create_time_end为一组; update_time_start和update_time_end为一组; 二组必选一组
page	string	页码	默认为0，起始页为0	必填
page_size	string	页大小	默认为100	必填

接口返回：
2. 订单详情接口
接口名称：trade_get
业务参数：

参数	类型	说明	备注
trade_id	string	订单编号	订单唯一标示

接口返回：
3. 订单发货接口
接口名称：trade_send
业务参数：

参数	类型	说明	备注
trade_id	string	订单编号	订单唯一标示
express_code	string	快递公司编码	SF、EMS 详见快递公司编码表
out_sid	string	运单号
oids	string	非必填，发货的order_id	订单明细id，即子订单号 order_id，用于订单部分商品发货的场景。一笔订单多种商品对应多个子订单号 order_id。 如果要传入多个值请用英文逗号隔开。
is_split	string	非必填，是否拆分发货标识	1：是，0：不是 如果平台不支持拆分发货，可以返回错误码：20004

接口返回：
4. 商品列表接口
接口名称：goods_list
业务参数：

参数	类型	说明	示例	备注
page	string	页码	默认为0，起始页为0	必填
page_size	string	页大小	默认为100	必填

接口返回：
快递公司编码

快递公司编码	快递公司名称
14	申通
15	中通
16	圆通
26	顺丰
50	韵达
...

快递公司编码https://woda.yuque.com/docs/share/ff670924-65cb-4327-9e7e-066c811392e4?#5Ru8
打单发货教程
详见：https://help.woda.com