跳到主要内容

拼多多自研接口接入开放公告

尊敬的快麦开放平台用户:​

您好!​

因拼多多平台业务合规升级要求,现平台要求用户获取快麦ERP里拼多多订单数据的唯一渠道:需统一接入其 “方舟 ERP - 自研数据传输场景”。我方已完成该场景及配套接口的适配工作,现正式启动从原 ERP 开放平台到拼多多平台对接的切换,并向各位客户开放新对接通道。为避免影响拼多多订单信息正常获取,请当前有需求用户尽快切换对接。

拼多多平台公告跳转链接:(https://open.pinduoduo.com/application/document/announcement?id=350)

具体接入流程说明如下:

1)申请注册方舟开发者应用

参考以下商家自研接入流程申请注册成为拼多多开发者账号:

商家自研接入流程链接:https://open.pinduoduo.com/application/business/list?role=business&activeKey=1&alias=pop-registration

(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_PAY10
待审核WAIT_AUDIT20
等待财审WAIT_FINANCE_AUDIT21
等待人工审核WAIT_MANUAL_AUDIT22
审核完成FINISHED_AUDIT29
待打印快递单WAIT_EXPRESS_PRINT30
待打印发货单WAIT_DELIVERY_PRINT31
待打包WAIT_PACKAGE32
待称重WAIT_WEIGHT33
待发货WAIT_SEND_GOODS40
卖家已发货SELLER_SEND_GOODS50
交易完成FINISHED60
交易关闭CLOSED70
交易作废CANCEL80

注:当前快麦开放平台已不支持返回拼多多平台订单数据,具体信息可参考【拼多多订单信息开放改造公告】

https://open.kuaimai.com/docs/question/%E7%B3%BB%E7%BB%9F%E5%85%AC%E5%91%8A/%E6%8B%BC%E5%A4%9A%E5%A4%9A%E8%AE%A2%E5%8D%95%E4%BF%A1%E6%81%AF%E5%BC%80%E6%94%BE%E6%94%B9%E9%80%A0%E5%85%AC%E5%91%8A