当前位置: 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接口名称 | type | String | 是 | 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_list | List<String> | ERP订单号 | 非必填 | ["123456"] | trade_no | 系统订单号(传入订单号可以不传时间条件) |
| erp_order_status | Integer | ERP订单状态 | 非必填 | 55 | status | 订单状态 |
| item_order_sn_list | List<String> | ERP子订单号 | 非必填 | |||
| pdd_mall_id | long | 拼多多店铺id | 非必填 | |||
| pdd_order_sn_list | List<String> | 拼多多订单号 | 非必填 | ["123456"] | src_tid | 原始单号(传入原始单号可以不传时间条件) |
| pdd_order_status | Integer | 拼多多订单状态 | 非必填 | |||
| query_time_end | Long | 结束时间时间戳 | 非必填 | 1761926400 | end_time | 结束时间(未传订单号/原始单号时间条件必传) |
| query_time_start | Long | 开始时间时间戳 | 非必填 | 1761926400 | start_time | 开始时间(未传订单号/原始单号时间条件必传) |
| query_time_type | Integer | 时间类型 | 非必填 | 4 | time_type | 时间类型 4:订单修改时间 |
| sid | String | 卖家账号 | 必填 | apidevnew2 | sid | 旺店通卖家账号 |
| page | Integer | 返回页码 | 必填 | 1 | page_no | 分页编号,分页查询必传 |
| page_size | Integer | 返回数量,最大100 | 必填 | 100 | page_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_time | String | 订单创建时间 | created | 创建时间 |
| discount_amount | Double | 折扣金额 | discount | 优惠金额 |
| duo_duo_pay_reduction | double | 多多支付立减金额 | ||
| erp_after_sales_id | String | erp售后单号 | ||
| erp_after_sales_status | Integer | erp售后状态 | ||
| erp_buyer_memo | String | erp买家留言 | buyer_message | 买家备注 |
| erp_mall_no | String | erp店铺编码 | shop_no | 店铺编号 |
| erp_order_sn | String | erp订单号 | trade_no | 订单编号 |
| erp_order_status | Integer | erp订单状态 | trade_status | 订单状态 |
| erp_refund_status | Integer | erp退款状态 | refund_status | 退款状态 |
| erp_remark | String | erp卖家备注 | cs_remark | 客服备注 |
| erp_remark_tag | Integer | erp卖家旗帜 | remark_flag | 客服备注旗子 |
| income_amount | Double | 实收金额 | receivable | 应收金额 |
| last_ship_time | String | 承诺发货时间 | ||
| logistics_id | long | 快递公司id | logistics_id | 物流id |
| pay_amount | double | 实付金额 | paid | 已付金额 |
| pay_time | String | 支付时间 | pay_time | 支付时间 |
| pdd_buyer_memo | String | 拼多多买家留言 | buyer_message | 买家备注 |
| pdd_mail_id | long | 拼多多店铺id | shop_id | 店铺id |
| pdd_order_status | Integer | 拼多多订单状态 | trade_status | 订单状态 |
| pdd_remark | String | 拼多多卖家备注 | cs_remark | 客服备注 |
| pdd_remark_tag | Integer | 拼多多卖家旗帜 | remark_flag | 客服备注旗子 |
| platform_discount | Double | 邮费 | post_amount | 邮费 |
| receive_time | String | 确认收货时间 | ||
| seller_discount | String | 商家优惠金额 | ||
| shipping_time | String | 平台发货时间 | ||
| tracking_number | String | 快递单号 | logistics_no | 物流单号 |
| updated_at | String | 修改时间 | modified | 修改时间 |
| ware_house_id | String | 发货仓库编号 | warehouse_no | 仓库编号 |
| ware_house_type | long | 发货仓库类型 | warehouse_type | 仓库类型 |
| ware_house_name | String | 发货仓库名称 | warehouse_name | 仓库名称 |
items
| PDD字段 | 参数类型 | PDD字段名 | wdt字段 | wdtERP字段名 |
|---|---|---|---|---|
erp_goods_amount | double | 货品金额 | share_amount | 分摊后总价 |
erp_goods_count | long | 货品数量 | num | 货品数量 |
erp_goods_id | String | erp商家编码 | goods_no | 货品编号 |
| erp_goods_img | String | 货品图片链接 | img_url | 图片路径 |
| erp_goods_price | double | 货品销售价格 | price | 销售单价 |
| erp_sku_id | String | erp sku编码 | spec_no | 商家编码 |
| income_amount | double | 实收金额 | share_amount | 分摊后总价 |
| item_common_ext_param | String | 其他 | {\"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_sn | String | erp子订单号 | rec_id | 明细主键 |
| pay_amount | Double | 实收金额 | paid | 已支付金额 |
| pdd_goods_amount | double | 商品金额 | share_amount | 分摊后合计应收 |
| pdd_goods_count | long | 商品数量 | num | 数量 |
| ppd_goods_id | long | 拼多多商品id | ||
| pdd_goods_img | String | 商品图片链接 | ||
| pdd_goods_price | double | 商品销售价格 | ||
| pdd_order_sn | String | 拼多多订单号 | src_oid | 原始子单号 |
| pdd_sku_id | long | 拼多多skuID | ||