跳到主要内容

拼多多订单信息开放改造公告

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

您好!

【拼多多】平台针对全部服务商推出最新安全规范,快麦已对订单查询及销售出库单接口进行改造。指导原则为erp产商不能通过自建开放平台透出通过拼多多开放平台接口抓取到的数据字段。如有相关更详细的需求,可以注册成为拼多多自研开发者。可参考拼多多开放平台对接指南注册后,通过拼多多开放平台获取相关订单数据:

拼多多注册指南跳转链接:https://open.pinduoduo.com/application/document/browse?idStr=04DD98845AD2977D

接口名称核心变更点
erp.trade.list.query
订单查询(非淘系,拼多多)
该接口不再返回拼多多平台所有数据
erp.trade.outstock.simple.query
销售出库查询
该接口针对拼多多平台将屏蔽和替换平台相关字段,详细数据可见下表:销售出库单接口字段改造列表

附件一:销售出库单接口改造字段列表

主表:list
参数名类型描述必填改造说明
receiverCountrystring收件国家,跨境订单使用(淘系、拼多多订单不返回)拼多多不返回该字段
receiverStatestring收件省份(淘系、拼多多订单不返回)拼多多不返回该字段
receiverCitystring收件市(淘系、拼多多订单不返回)拼多多不返回该字段
receiverDistrictstring收件区县(淘系、拼多多订单不返回)拼多多不返回该字段
receiverStreetstring收件街道(淘系、拼多多订单不返回)拼多多不返回该字段
receiverAddressstring收件详细地址(淘系、拼多多订单不返回)拼多多不返回该字段
receiverZipstring收件邮编(淘系、拼多多订单不返回)拼多多不返回该字段
receiverMobilestring收件人手机号(淘系、拼多多订单不返回)拼多多不返回该字段
receiverNamestring收件人姓名(淘系、拼多多订单不返回)拼多多不返回该字段
receiverPhonestring收件人固话(淘系、拼多多订单不返回)拼多多不返回该字段
buyerNickstring平台订单上的买家昵称(淘系、拼多多订单不返回)拼多多不返回该字段
postFeestring邮费:合单的话,取的是主单的邮费(拼多多订单不返回)拼多多不返回该字段
paymentstring实付金额(单位:元)(拼多多订单不返回)拼多多不返回该字段
buyerTaxNostring买家税号拼多多不返回该字段
statusstring订单的平台状态(拼多多订单不返回)拼多多不返回该字段
paymentDiffdouble订单差额 = 系统实付金额 - 平台实收金额 区间值(拼多多订单不返回)拼多多不返回该字段
taxFeestring税费(拼多多订单不返回)拼多多不返回该字段
buyerMessagestring平台订单上的买家留言(淘系、拼多多订单不返回)拼多多不返回该字段
unifiedStatusstring各平台状态映射后的统一状态(拼多多订单不返回)拼多多不返回该字段
modifiedlong订单在平台上的修改时间(拼多多订单不返回)拼多多不返回该字段
ptConsignTimelong平台发货时间(淘系、拼多多订单不返回)拼多多不返回该字段
tidstring平台订单号拼多多不返回该字段
invoiceNamestring发票抬头(淘系、拼多多订单不返回)拼多多不返回该字段
invoiceRemarkstring发票备注(淘系、拼多多订单不返回)拼多多不返回该字段
invoiceFormatinteger发票类型 1 普通 2 增值拼多多不返回该字段
invoiceTypestring发票类型拼多多不返回该字段
invoiceKindstring发票种类( 1 电子发票 2 纸质发票 )(淘系、拼多多订单不返回)拼多多不返回该字段
taobaoIdlong平台的卖家账户(淘系、拼多多订单不返回)拼多多不返回该字段
sellerMemostring平台上的卖家备注(拼多多订单不返回)拼多多不返回该字段
acPaymentstring不变的实付金额(拼多多订单不返回)拼多多不返回该字段
sellerFlaglong平台上的卖家旗帜:0: 灰,1: 红,2: 黄,3: 绿,4: 蓝,5: 紫,6: 橙,7: 浅蓝,8: 浅粉,9: 深绿,10: 桃红(拼多多订单不返回)必填拼多多不返回该字段
payAmountstring订单买家已付金额(单位:元)(拼多多订单不返回)必填拼多多不返回该字段
selfBuiltPaymentReceivablestring代收金额(拼多多订单不返回)拼多多不返回该字段
selfBuiltDepositAmountstring定金(拼多多订单不返回)拼多多不返回该字段
selfBuiltPaymentstring货到付款总金额(拼多多订单不返回)拼多多不返回该字段
tradeInvoiceobject订单发票信息(淘系、拼多多订单不返回)必填拼多多不返回该字段
govSubsidyInfoobject国补信息(拼多多订单不返回)拼多多不返回该字段
subShopobject子店铺信息(拼多多订单不返回)拼多多不返回该字段
子表:list/subShop
参数名类型描述必填改造说明
idlong子店铺 ID拼多多不返回该字段
shopNamestring店铺名称拼多多不返回该字段
platformCodestring所属平台编码拼多多不返回该字段
shopCodestring店铺编码拼多多不返回该字段
logisticsCodestring物流商编码拼多多不返回该字段
子表:list/orders
参数名类型描述必填改造说明
tidstring所属订单的平台编号拼多多不返回该字段
endTimelong子订单的交易结束时间拼多多不返回该字段
modifiedlong子订单平台的修改时间拼多多不返回该字段
numIidstring平台商品数字编号拼多多替换为系统主商品 ID
paymentstring实付金额,公式:实付金额 = 应付金额 - 优惠金额(单位:元)拼多多不返回该字段
outerSkuIdstringouter_sku_id (拼多多替换为系统商品编码)拼多多替换为系统商品编码
skuIdstring平台规格编号拼多多替换为系统SKUID
taobaoIdlong订单店铺的平台 ID(淘系、拼多多订单不返回)拼多多不返回该字段
picPathstring平台商品图片链接拼多多替换为系统商品图片链接
oldStatusstring子订单旧的平台状态,不做持久化,一般用于订单同步更新时的判断比较 (拼多多订单不返回)拼多多不返回该字段
statusstring子订单平台状态 (拼多多订单不返回)拼多多不返回该字段
soidstring子订单平台编号(由于某些平台的子订单号为字符类型,需要用此字段保存,后续可将 oid 修改为 String 类型)(拼多多订单不返回)拼多多不返回该字段
refundStatusstring子订单退款状态:CLOSED:退款关闭 NO_REFUND:未退款 SELLER_CONTINUE_CONSIGN:卖家已发货退款 SELLER_REFUSE_BUYER:卖家拒绝退款 WAIT_SELLER_AGREE:待卖家同意退款 WAIT_BUYER_RETURN_GOODS:待买家退货 WAIT_SELLER_CONFIRM_GOODS:待卖家确认收货 SUCCESS:退款成功拼多多不返回该字段
oidlong子订单平台编号 (淘宝有,京东没有,拼多多不返回)拼多多不返回该字段
titlestring平台商品名称拼多多替换为系统商品的标题
acPaymentstring不变的实付金额,进来后不变拼多多不返回该字段
postFeestring单笔订单运费(拼多多订单不返回)拼多多不返回该字段
payAmountstring商品买家已付金额(单位:元)(拼多多订单不返回)必填拼多多不返回该字段
ptConsignTimelong平台发货时间(淘系、拼多多订单不返回)拼多多不返回该字段
totalFeestring应付金额,公式:应付金额 = 商品数量 * 商品单价 + 手工调整价拼多多不返回该字段
estimateConTimelong预计发货时间 (拼多多订单不返回)拼多多不返回该字段
refundIdstring平台退款编号 (拼多多订单不返回)拼多多不返回该字段
divideOrderFeestring平台实付 (平台分摊之后的实付金额)(单位:元)必填拼多多不返回该字段
子表:list/orders/suits
参数名类型描述必填改造说明
numIidstring平台商品数字编号拼多多替换为系统主商品 ID
outerSkuIdstring外部 skuID必填拼多多替换为系统SKUID
payAmountstring商品买家实付金额 (拼多多订单不返回)必填拼多多不返回该字段
tidstring所属订单的平台编号必填拼多多不返回该字段
modifiedlong子订单平台的修改时间必填拼多多不返回该字段
paymentstring实付金额,公式:实付金额 = 应付金额 - 优惠金额(拼多多不返回)必填拼多多不返回该字段
skuIdstring平台规格编号必填拼多多替换为系统SKUID
taobaoIdlong订单店铺的平台 ID (拼多多不返回)必填拼多多不返回该字段
picPathstring平台商品图片链接必填拼多多替换为系统商品图片链接
statusstring子订单平台状态(拼多多不返回)必填拼多多不返回该字段
refundStatusstring子订单退款状态(拼多多不返回)必填拼多多不返回该字段
oidlong子订单平台编号 (淘宝有,京东没有、拼多多不返回))必填拼多多不返回该字段
titlestring商品标题必填拼多多替换系统商品标题
divideOrderFeestring平台实付 (平台分摊之后的实付金额)必填拼多多不返回该字段
ptConsignTimelong平台发货时间必填拼多多不返回该字段
totalFreestring应付金额,公式:应付金额 = 商品数量 * 商品单价 + 手工调整价必填拼多多不返回该字段
子表:list/tradeInvoice
参数名类型描述必填改造说明
invoiceTypestring发票抬头类型:1 个人、2 企业(淘系、拼多多订单不返回)必填拼多多不返回该字段
invoiceKindstring发票类型:发票种类 1 纸质普通 2 纸质专票 3 电子普通 4 电子专票(淘系、拼多多订单不返回)必填拼多多不返回该字段
invoiceNamestring发票抬头(淘系、拼多多订单不返回)必填拼多多不返回该字段
buyerTaxNostring买家税号(淘系、拼多多订单不返回)必填拼多多不返回该字段
invoiceRemarkstring发票备注(淘系、拼多多订单不返回)必填拼多多不返回该字段
buyerAddressstring购方地址(淘系、拼多多订单不返回)必填拼多多不返回该字段
buyerPhonestring购方电话(淘系、拼多多订单不返回)必填拼多多不返回该字段
buyerBankstring购方开户行(淘系、拼多多订单不返回)必填拼多多不返回该字段
buyerBankAccountstring购方开户行账号(淘系、拼多多订单不返回)必填拼多多不返回该字段
invoiceAmountstring开票金额(淘系、拼多多订单不返回)必填拼多多不返回该字段
emailstring邮箱(淘系、拼多多订单不返回)必填拼多多不返回该字段
子表:list/govSubsidyInfo
参数名类型描述必填改造说明
subShopIdstring子店铺 id(拼多多不返回)拼多多不返回该字段
subShopNamestring子店铺名称(拼多多不返回)拼多多不返回该字段
govSubsidyAmountstring国家补贴金额(拼多多不返回)拼多多不返回该字段
govSubsidyDetailstring订单国补详情数据(json 字符串存储,业务方根据平台不同逻辑自行解析取想要的字段做业务,拼多多不返回)拼多多不返回该字段