拼多多自研接口接入开放公告
尊敬的快麦开放平台用户:
您好!
因拼多多平台业务合规升级要求,现平台要求用户获取快麦ERP里拼多多订单数据 的唯一渠道:需统一接入其 “方舟 ERP - 自研数据传输场景”。我方已完成该场景及配套接口的适配工作,现正式启动从原 ERP 开放平台到拼多多平台对接的切换,并向各位客户开放新对接通道。为避免影响拼多多订单信息正常获取,请当前有需求用户尽快切换对接。
拼多多平台公告跳转链接:(https://open.pinduoduo.com/application/document/announcement?id=350)
具体接入流程说明如下:
(1)申请注册方舟开发者应用
参考以下商家自研接入流程申请注册成为拼多多开发者账号:
(2)申请注册快麦开放平台appkey
通过服务贵方的快麦实施或者快麦商务内部提交申请,申请通过后可在快麦开放平台值班群内找值班产品按“快麦开放平台appkey+client_id提交信息
(3)双向方舟client_id绑定
在快麦核实您的appkey及client_id信息后,会给您快麦ERP拼多多放在的client_id。您需要按【方舟 ERP-自研数据传输场景 接入指南】的说明,将快麦ERP拼多多client_id绑定在您自身的拼多多方舟应用中。(同时快麦也会将您提交的client_id绑定在快麦拼多多放在应用中)
方舟 ERP-自研数据传输场景 接入指南链接:https://open.pinduoduo.com/application/document/browse?idStr=1E4B7F919EC480E8
(4)方舟自研接口调用
以上准备完毕后,您可以按【方舟数据传输接口】的请求说明进行数据请求联调。
方舟数据传输接口链接:
https://open.pinduoduo.com/application/document/api?id=pdd.erp.order.list.get
(5)接入特殊说明:
1.方舟传输接口-请求参数"sid"字段需按快麦加密方式,拼接加密签名填入。快麦会对该字段进行验签,验签通过的才会返回数据。
具体加密签名如下:
sid 传入appKey$session$sign
appKey, session ,appSecret 在快麦开放平台申请审核通过后颁发,
sign 为 MD5(appSecret+appKey+timestamp+appSecret)
例:appKey=111, session =abc,appSecret=222 timestamp= 1761616517
sign = MD5(222111abc1761616517222) MD5结果值:F959604193D19FF22606A935765FDC74
sid : 111$abc$F959604193D19FF22606A935765FDC74
2.订单列表查询接口,ERP订单状态需按快麦订单状态请求,请求枚举如下
erp_order_status ERP订单状态说明
| 状态 | 原ERP状态码 | 状态码 |
|---|---|---|
| 待付款 | WAIT_BUYER_PAY | 10 |
| 待审核 | WAIT_AUDIT | 20 |
| 等待财审 | WAIT_FINANCE_AUDIT | 21 |
| 等待人工审核 | WAIT_MANUAL_AUDIT | 22 |
| 审核完成 | FINISHED_AUDIT | 29 |
| 待打印快递单 | WAIT_EXPRESS_PRINT | 30 |
| 待打印发货单 | WAIT_DELIVERY_PRINT | 31 |
| 待打包 | WAIT_PACKAGE | 32 |
| 待称重 | WAIT_WEIGHT | 33 |
| 待发货 | WAIT_SEND_GOODS | 40 |
| 卖家已发货 | SELLER_SEND_GOODS | 50 |
| 交易完成 | FINISHED | 60 |
| 交易关闭 | CLOSED | 70 |
| 交易作废 | CANCEL | 80 |
注:当前快麦开放平台已不支持返回拼多多平台订单数据,具体信息可参考【拼多多订单信息开放改造公告】