拼多多订单信息开放改造公告
尊敬的快麦开放平台用户:
您好!
【拼多多】平台针对全部服务商推出最新安全规范,快麦已对订单查询及销售出库单接口进行改造。指导原则为erp产商不能通过自建开放平台透出通过拼多多开放平台接口抓取到的数据字段。如有相关更详细的需求,可以注册成为拼多多自研开发者。可参考拼多多开放平台对接指 南注册后,通过拼多多开放平台获取相关订单数据:
拼多多注册指南跳转链接:https://open.pinduoduo.com/application/document/browse?idStr=04DD98845AD2977D
| 接口名称 | 核心变更点 |
|---|---|
| erp.trade.list.query 订单查询(非淘系,拼多多) | 该接口不再返回拼多多平台所有数据 |
| erp.trade.outstock.simple.query 销售出库查询 | 该接口针对拼多多平台将屏蔽和替换平台相关字段,详细数据可见下表:销售出库单接口字段改造列表 |
附件一:销售出库单接口改造字段列表
| 主表:list | ||||
|---|---|---|---|---|
| 参数名 | 类型 | 描述 | 必填 | 改造说明 |
| receiverCountry | string | 收件国家,跨境订单使用(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverState | string | 收件省份(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverCity | string | 收件市(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverDistrict | string | 收件区县(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverStreet | string | 收件街道(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverAddress | string | 收件详细地址( 淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverZip | string | 收件邮编(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverMobile | string | 收件人手机号(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverName | string | 收件人姓名(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| receiverPhone | string | 收件人固话(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| buyerNick | string | 平台订单上的买家昵称(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| postFee | string | 邮费:合单的话,取的是主单的邮费(拼多多订单不返回) | 拼多多不返回该字段 | |
| payment | string | 实付金额(单位:元)(拼多多订单不返回) | 拼多多不返回该字段 | |
| buyerTaxNo | string | 买家税号 | 拼多多不返回该字段 | |
| status | string | 订单的平台状态(拼多多订单不返回) | 拼多多不返回该字段 | |
| paymentDiff | double | 订单差额 = 系统实付金额 - 平台实收金额 区间值(拼多多订单不返回) | 拼多多不返回该字段 | |
| taxFee | string | 税费(拼多多订单不返回) | 拼多多不返回该字段 | |
| buyerMessage | string | 平台订单上的买家留言(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| unifiedStatus | string | 各平台状态映射后的统一状态(拼多多订单不返回) | 拼多多不返回该字段 | |
| modified | long | 订单在平台上的修改时间(拼多多订单不返回) | 拼多多不返回该字段 | |
| ptConsignTime | long | 平台发货时间(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| tid | string | 平台订单号 | 拼多多不返回该字段 | |
| invoiceName | string | 发票抬头(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| invoiceRemark | string | 发票备注(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| invoiceFormat | integer | 发票类型 1 普通 2 增值 | 拼多多不返回该字段 | |
| invoiceType | string | 发票类型 | 拼多多不返回该字段 | |
| invoiceKind | string | 发票种类( 1 电子发票 2 纸质发票 )(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| taobaoId | long | 平台的卖家账户(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| sellerMemo | string | 平台上的卖家备注(拼多多订单不返回) | 拼多多不返回该字段 | |
| acPayment | string | 不变的实付金额(拼多多订单不返回) | 拼多多不返回该字段 | |
| sellerFlag | long | 平台上的卖家旗帜:0: 灰,1: 红,2: 黄,3: 绿,4: 蓝,5: 紫,6: 橙,7: 浅蓝,8: 浅粉,9: 深绿,10: 桃红(拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| payAmount | string | 订单买家已付金额(单位:元)(拼多多订单 不返回) | 必填 | 拼多多不返回该字段 |
| selfBuiltPaymentReceivable | string | 代收金额(拼多多订单不返回) | 拼多多不返回该字段 | |
| selfBuiltDepositAmount | string | 定金(拼多多订单不返回) | 拼多多不返回该字段 | |
| selfBuiltPayment | string | 货到付款总金额(拼多多订单不返回) | 拼多多不返回该字段 | |
| tradeInvoice | object | 订单发票信息(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| govSubsidyInfo | object | 国补信息(拼多多订单不返回) | 拼多多不返回该字段 | |
| subShop | object | 子店铺信息(拼多多订单不返回) | 拼多多不返回该字段 | |
| 子表:list/subShop | ||||
| 参数名 | 类型 | 描述 | 必填 | 改造说明 |
| id | long | 子店铺 ID | 拼多多不返回该字段 | |
| shopName | string | 店铺名称 | 拼多多不返回该字段 | |
| platformCode | string | 所属平台编码 | 拼多多不返回该字段 | |
| shopCode | string | 店铺编码 | 拼多多不返回该字段 | |
| logisticsCode | string | 物流商编码 | 拼多多不返回该字段 | |
| 子表:list/orders | ||||
| 参数名 | 类型 | 描述 | 必填 | 改造说明 |
| tid | string | 所属订单的平台编号 | 拼多多不返回该字段 | |
| endTime | long | 子订单的交易结束时间 | 拼多多不返回该字段 | |
| modified | long | 子订单平台的修改时间 | 拼多多不返回该字段 | |
| numIid | string | 平台商品数字编号 | 拼多多替换为系统主商品 ID | |
| payment | string | 实付金额,公式:实付金额 = 应付金额 - 优惠金额(单位:元) | 拼多多不返回该字段 | |
| outerSkuId | string | outer_sku_id (拼多多替换为系统商品编码) | 拼多多替换为系统商品编码 | |
| skuId | string | 平台规格编号 | 拼多多替换为系统SKUID | |
| taobaoId | long | 订单店铺的平台 ID(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| picPath | string | 平台商品图片链接 | 拼多多替换为系统商品图片链接 | |
| oldStatus | string | 子订单旧的平台状态,不做持久化,一般用于订单同步更新时的判断比较 (拼多多订单不返回) | 拼多多不返回该字段 | |
| status | string | 子订单平台状态 (拼多多订单不返回) | 拼多多不返回该字段 | |
| soid | string | 子订单平台编号(由于某些平台的子订单号为字符类型,需要用此字段保存,后续可将 oid 修改为 String 类型)(拼多多订单不返回) | 拼多多不返回该字段 | |
| refundStatus | string | 子订单退款状态:CLOSED:退款关闭 NO_REFUND:未退款 SELLER_CONTINUE_CONSIGN:卖家已发货退款 SELLER_REFUSE_BUYER:卖家拒绝退款 WAIT_SELLER_AGREE:待卖家同意退款 WAIT_BUYER_RETURN_GOODS:待买家退货 WAIT_SELLER_CONFIRM_GOODS:待卖家确认收货 SUCCESS:退款成功 | 拼多多不返回该字段 | |
| oid | long | 子订单平台编号 (淘宝有,京东没有,拼多多不返回) | 拼多多不返回该字段 | |
| title | string | 平台商品名称 | 拼多多替换为系统商品的标题 | |
| acPayment | string | 不变的实付金额,进来后不变 | 拼多多不返回该字段 | |
| postFee | string | 单笔订单运费(拼多多订单不返回) | 拼多多不返回该字段 | |
| payAmount | string | 商品买家已付金额(单位:元)(拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| ptConsignTime | long | 平台发货时间(淘系、拼多多订单不返回) | 拼多多不返回该字段 | |
| totalFee | string | 应付金额,公式:应付金额 = 商品数量 * 商品单价 + 手工调整价 | 拼多多不返回该字段 | |
| estimateConTime | long | 预计发货时间 (拼多多订单不返回) | 拼多多不返回该字段 | |
| refundId | string | 平台退款编号 (拼多多订单不返回) | 拼多多不返回该字段 | |
| divideOrderFee | string | 平台实付 (平台分摊之后的实付金额)(单位:元) | 必填 | 拼多多不返回该字段 |
| 子表:list/orders/suits | ||||
| 参数名 | 类型 | 描述 | 必填 | 改造说 明 |
| numIid | string | 平台商品数字编号 | 拼多多替换为系统主商品 ID | |
| outerSkuId | string | 外部 skuID | 必填 | 拼多多替换为系统SKUID |
| payAmount | string | 商品买家实付金额 (拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| tid | string | 所属订单的平台编号 | 必填 | 拼多多不返回该字段 |
| modified | long | 子订单平台的修改时间 | 必填 | 拼多多不返回该字段 |
| payment | string | 实付金额,公式:实付金额 = 应付金额 - 优惠金额(拼多多不返回) | 必填 | 拼多多不返回该字段 |
| skuId | string | 平台规格编号 | 必填 | 拼多多替换为系统SKUID |
| taobaoId | long | 订单店铺的平台 ID (拼多多不返回) | 必填 | 拼多多不返回该字段 |
| picPath | string | 平台商品图片链接 | 必填 | 拼多多替换为系统商品图片链接 |
| status | string | 子订单平台状态(拼多多不返回) | 必填 | 拼多多不返回该字段 |
| refundStatus | string | 子订单退款状态(拼多多不返回) | 必填 | 拼多多不返回该字段 |
| oid | long | 子订单平台编号 (淘宝有,京东没有、拼多多不返回)) | 必填 | 拼多多不返回该字段 |
| title | string | 商品标题 | 必填 | 拼多多替换系统商品标题 |
| divideOrderFee | string | 平台实付 (平台分摊之后的实付金额) | 必填 | 拼多多不返回该字段 |
| ptConsignTime | long | 平台发货时间 | 必填 | 拼多多不返回该字段 |
| totalFree | string | 应付金额,公式:应付金额 = 商品数量 * 商品单价 + 手工调整价 | 必填 | 拼多多不返回该字段 |
| 子表:list/tradeInvoice | ||||
| 参数名 | 类型 | 描述 | 必填 | 改造说明 |
| invoiceType | string | 发票抬头类型:1 个人、2 企业(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| invoiceKind | string | 发票类型:发票种类 1 纸质普通 2 纸质专票 3 电子普通 4 电子专票(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| invoiceName | string | 发票抬头(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| buyerTaxNo | string | 买家税号(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| invoiceRemark | string | 发票备注(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| buyerAddress | string | 购方地址(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| buyerPhone | string | 购方电话(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| buyerBank | string | 购方开户行(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| buyerBankAccount | string | 购方开户行账号(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| invoiceAmount | string | 开票金额(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 |
| string | 邮箱(淘系、拼多多订单不返回) | 必填 | 拼多多不返回该字段 | |
| 子表:list/govSubsidyInfo | ||||
| 参数名 | 类型 | 描述 | 必填 | 改造说明 |
| subShopId | string | 子店铺 id(拼多多不返回) | 拼多多不返回该字段 | |
| subShopName | string | 子店铺名称(拼多多不返回) | 拼多多不返回该字段 | |
| govSubsidyAmount | string | 国家补贴金额(拼多多不返回) | 拼多多不返回该字段 | |
| govSubsidyDetail | string | 订单国补详情数据(json 字符串存储,业务方根据平台不同逻辑自行解析取想要的字段做业务,拼多多不返回) | 拼多多不返回该字段 |