当前位置: API文档

pdd.erp.order.list.get(订单查询-pdd业务(字段映射))

¥标准

1.接口说明

1.1 接口描述:查询旺店通系统上拼多多订单数据信息
1.2 适用版本:
1.3 增量获取:按照最后修改时间增量获取
1.4 时间跨度:query_time_start和query_time_end最大跨度为60分钟。

1.5注意事项:

2.调用场景

2.1 举例说明:

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境
正式环境https://ark-api.pinduoduo.com/ark/router

  3.2 拼多多公共请求参数

名称字段类型必须描述

API接口名称

typeString

API接口名称

拼多

erp_goods_price

多POP分配给应用的client_id

client_id

String

拼多多POP分配给应用的client_id

通过code获取的access_token

access_token

String

通过code获取的access_token

UNIX时间戳,单位秒,需要与拼多多服务器时间差值在10分钟内

timestamp

String

UNIX时间戳,单位秒,需要与拼多多服务器时间差值在10分钟内

响应格式,即返回数据的格式,JSON或者XML(二选一),默认JSON,注意是大写

data_type

String


响应格式,即返回数据的格式,JSON或者XML(二选一),默认JSON,注意是大写

API协议版本号,默认为V1,可不填

version

String

API协议版本号,默认为V1,可不填

API输入参数签名结果,签名算法参考开放平台接入指南第三部分底部。

sign

String

API输入参数签名结果,签名算法参考开放平台接入指南第三部分底部拼多多sign说明

目标应用client_id

target_client_id

String

目标应用client_id 旺店通client_id:e6c4b8a127c14831b2ff860735cf8680

  业务请求参数

PDD字段参数类型PDD字段名是否必填示例wdt字段wdtERP字段名

erp_mall_no

String

店铺编码

非必填"123"shop_no

店铺编号

erp_order_sn_listList<String>ERP订单号非必填["123456"]trade_no系统订单号(传入订单号可以不传时间条件)
erp_order_statusIntegerERP订单状态非必填55status订单状态
item_order_sn_listList<String>ERP子订单号非必填


pdd_mall_idlong拼多多店铺id非必填


pdd_order_sn_listList<String>拼多多订单号非必填["123456"]src_tid原始单号(传入原始单号可以不传时间条件)
pdd_order_statusInteger拼多多订单状态非必填


query_time_endLong结束时间时间戳非必填1761926400end_time结束时间(未传订单号/原始单号时间条件必传)
query_time_startLong开始时间时间戳非必填1761926400start_time开始时间(未传订单号/原始单号时间条件必传)
query_time_typeInteger时间类型非必填4time_type

时间类型

4:订单修改时间

sidString卖家账号必填apidevnew2sid旺店通卖家账号
pageInteger返回页码必填1page_no分页编号,分页查询必传
page_sizeInteger返回数量,最大100必填100page_size分页大小,分页查询必传

响应信息

order_list

PDD字段参数类型PDD字段名wdt字段wdtERP字段名

common_ext_param

String

其他

{\"logistics_name\":\"物流公司名称\",\"fenxiao_nick\":\"分销商信息\",\"trade_time\":\"下单时间\",\"raw_goods_type_count\":原始货品种类数,\"is_prev_notify\":是否京配,\"unmerge_mask\":未合并标记,\"other_cost\":其它成本,\"print_remark\":\"打印备注\",\"bad_reason\":异常订单,\"other_amount\":其它费用,\"package_id\":包装id,\"checker_id\":审核员工ID,\"is_unpayment_sms\":催未付款订单消息发送标记,\"raw_goods_count\":原始货品数量,\"tax_rate\":税率,\"to_deliver_time\":\"派送时间\",\"salesman_id\":业务员ID,\"fchecker_name\":\"财审人名称\",\"trade_id\":erp订单表的主键,\"shop_remark\":\"店铺备注\",\"cs_remark_count\":客服备注条数,\"split_from_trade_id\":拆分订单,原单ID,\"pre_charge_time\":\"预配送时间\",\"checker_name\":\"审核人姓名\",\"trade_prepay\":使用的预存款,\"customer_no\":\"旺店通系统客户编码\",\"large_type\":大件类型,\"pi_amount\":分期付款金额,\"weight\":预估重量,\"tax\":税额,\"logistics_code\":\"物流公司编号\",\"shop_name\":\"旺店通店铺名称\",\"freeze_reason_info\":\"冻结原因名称\",\"trade_mask\":订单标记位,\"tags\":\"订单标签/异常\",\"volume\":体积,\"src_tids\":\"原始单号\",\"shop_id\":店铺ID,\"buyer_message_count\":买家留言条数,\"is_sealed\":不可合并拆分,\"checkouter_name\":\"签出人名称\",\"check_step\":审核步骤,\"consign_status\":发货状态,\"customer_type\":客户类型,\"flag_id\":标记id,\"\":冻结原因,\"single_spec_no\":\"货品商家编码\",\"discount_change\":优惠变化金额,\"cs_remark_change_count\":客服备注变化,\"checkouter_id\":签出人,\"fchecker_id\":财审人,\"goods_type_count\":货品种类数,\"dap_amount\":款到发货金额,\"goods_count\":货品总数,\"cod_amount\":COD金额,\"flag_name\":\"标记名称\",\"sales_score\":销售积分,\"split_package_num\":线上包裹拆分数,\"logistics_template_id\":物流单模板ID,\"post_cost\":邮资成本,\"trade_status\":订单状态,\"commission\":佣金,\"sendbill_template_id\":发货单模板id,\"currency\":\"币种\",\"logistics_type\":物流方式,\"profit\":预估毛利,\"note_count\":便签条数,\"trade_from\":订单来源,\"delivery_term\":发货条件,\"gift_mask\":赠品标记,\"goods_amount\":货品总额,\"goods_cost\":货品预估成本,\"stockout_no\":\"出库单号\",\"cancel_reason\":取消原因,\"fenxiao_type\":分销类别,\"revert_reason\":驳回原因,\"fenxiao_tid\":\"分销原始单号\",\"trade_type\":订单类型,\"ext_cod_fee\":买家COD费用,\"fullname\":\"业务员姓名\",\"customer_id\":旺店通买家id,\"delay_to_time\":延迟处理,\"warehouse_id\":仓库id}

confirm_time

String成交时间

created_timeString订单创建时间created创建时间
discount_amountDouble折扣金额discount优惠金额
duo_duo_pay_reductiondouble多多支付立减金额

erp_after_sales_idStringerp售后单号

erp_after_sales_statusIntegererp售后状态

erp_buyer_memoStringerp买家留言buyer_message买家备注
erp_mall_noStringerp店铺编码shop_no店铺编号
erp_order_snStringerp订单号trade_no订单编号 
erp_order_statusIntegererp订单状态trade_status订单状态
erp_refund_statusIntegererp退款状态refund_status退款状态
erp_remark

String

erp卖家备注cs_remark客服备注
erp_remark_tagIntegererp卖家旗帜remark_flag客服备注旗子
income_amountDouble实收金额

receivable

应收金额
last_ship_timeString承诺发货时间

logistics_idlong快递公司idlogistics_id物流id
pay_amountdouble实付金额paid
已付金额
pay_timeString支付时间pay_time支付时间
pdd_buyer_memoString拼多多买家留言buyer_message买家备注
pdd_mail_idlong拼多多店铺idshop_id

店铺id

pdd_order_statusInteger拼多多订单状态trade_status订单状态
pdd_remarkString拼多多卖家备注cs_remark客服备注
pdd_remark_tagInteger拼多多卖家旗帜remark_flag客服备注旗子
platform_discountDouble
邮费post_amount邮费
receive_timeString确认收货时间

seller_discountString商家优惠金额

shipping_timeString平台发货时间

tracking_numberString快递单号logistics_no物流单号
updated_atString修改时间modified修改时间
ware_house_idString发货仓库编号warehouse_no仓库编号
ware_house_typelong发货仓库类型

warehouse_type

仓库类型
ware_house_nameString发货仓库名称warehouse_name仓库名称

items

PDD字段参数类型PDD字段名wdt字段wdtERP字段名

erp_goods_amount

double

货品金额

share_amount分摊后总价

erp_goods_count

long货品数量num

货品数量

erp_goods_id

Stringerp商家编码goods_no货品编号
erp_goods_imgString货品图片链接img_url图片路径
erp_goods_pricedouble货品销售价格price销售单价
erp_sku_idString
erp sku编码spec_no商家编码
income_amountdouble实收金额share_amount分摊后总价
item_common_ext_paramString其他{\"suite_discount\":组合装优惠,\"spec_code\":\"规格码\",\"tc_order_id\":\"分销商id\",\"is_zero_cost\":是否允许0成本,\"discount\":总折扣金额,\"suite_amount\":组合装分摊后总价,\"tax_rate\":税率,\"trade_id\":erp订单主键,\"api_goods_name\":\"平台货品名称\",\"modified\":\"最后修改时间\",\"stock_reserved\":库存保留情况,\"barcode\":\"主条码\",\"is_print_suite\":是否打印组合装,\"goods_name\":\"货品名称\",\"src_tid\":\"原始订单编号\",\"large_type\":大件类型,\"is_master\":是否为主子订单,\"refund_status\":退款状态,\"corp_entity_name\":\"公司主体名称\",\"created\":\"订单生成时间\",\"goods_id\":货品id,\"weight\":估重,\"is_received\":是否打款,\"from_mask\":原始单标记,\"pay_time\":\"子单付款时间\",\"unit_name\":\"基本单位名称\",\"adjust\":手工调整价,\"platform_goods_id\":\"平台货品ID\",\"share_amount\":分摊后总价,\"cid\":类目id,\"platform_spec_id\":\"平台商品ID\",\"flag\":区分子单拆分的唯一性标记,\"suite_name\":\"拆自组合装\",\"api_spec_name\":\"平台规格名称\",\"remark\":\"备注\",\"bind_oid\":\"关联发货\",\"from_mask_ext\":平台标签,\"pay_status\":子单付款状态,\"spec_id\":erp内商品主键,\"commission\":佣金,\"guarantee_mode\":担保方式,\"suite_id\":组合装ID,\"class_name\":\"分类名称\",\"is_consigned\":平台已发货,\"actual_num\":实发数量,\"delivery_term\":发货条件,\"gift_type\":赠品方式,\"order_price\":成交价,\"base_unit_id\":基本单位ID,\"rec_id\":erp子订单主键,\"share_post\":分摊邮费,\"prop2\":\"自定义属性2\",\"suite_no\":\"组合装编码\",\"share_amount2\":share_amount备份值,\"corp_entity_id\":\"公司主体id\",\"spec_name\":\"规格名\",\"goods_type\":货品类别,\"suite_num\":组合装数量,\"share_price\":分摊后价格}
item_order_snStringerp子订单号rec_id明细主键
pay_amountDouble实收金额paid已支付金额
pdd_goods_amountdouble商品金额share_amount分摊后合计应收
pdd_goods_countlong商品数量num数量
ppd_goods_idlong拼多多商品id

pdd_goods_imgString商品图片链接



pdd_goods_pricedouble商品销售价格

pdd_order_snString拼多多订单号src_oid原始子单号
pdd_sku_idlong拼多多skuID









常用工具