pdd.order.information.get拼多多店铺订单详情接口(店铺订单交易接口,店铺订单明文接口,店铺订单解密接口)代码对接教程如下:
1.公共参数
参数名称 | 参数类型 | 是否必填 | 参数描述(接口代码教程wx19970108018) |
---|---|---|---|
type | String | 必填 | API接口名称(点击获取请求key和secret) |
client_id | String | 必填 | POP分配给应用的client_id |
access_token | String | 非必填 | 通过code获取的access_token |
timestamp | String | 必填 | UNIX时间戳,单位秒,需要与拼多多服务器时间差值在10分钟内 |
data_type | String | 非必填 | 响应格式,即返回数据的格式,JSON或者XML(二选一),默认JSON,注意是大写 |
version | String | 非必填 | API协议版本号,默认为V1,可不填 |
sign | String | 必填 | API输入参数签名结果,签名算法参考开放平台接入指南第三部分底部。 |
2.请求参数
参数接口 | 参数类型 | 是否必填 | 说明 |
---|---|---|---|
order_sn | STRING | 必填 | 订单号 |
3.返回参数说明
参数接口 | 参数类型 | 例子 | 说明 |
---|---|---|---|
order_info_get_response | OBJECT | 1 | response |
order_info | OBJECT | 1 | 订单详情对象 |
address 加密 | STRING | 1 | 收件详细地址 |
address_mask | STRING | 详细地址(打码) | |
after_sales_status | INTEGER | 1 | 售后状态 0:无售后 2:买家申请退款,待商家处理 3:退货退款,待商家处理 4:商家同意退款,退款中 5:平台同意退款,退款中 6:驳回退款,待买家处理 7:已同意退货退款,待用户发货 8:平台处理中 9:平台拒绝退款,退款关闭 10:退款成功 11:买家撤销 12:买家逾期未处理,退款失败 13:买家逾期,超过有效期 14:换货补寄待商家处理 15:换货补寄待用户处理 16:换货补寄成功 17:换货补寄失败 18:换货补寄待用户确认完成 21:待商家同意维修 22:待用户确认发货 24:维修关闭 25:维修成功 27:待用户确认收货 31:已同意拒收退款,待用户拒收 32:补寄待商家发货 |
bonded_warehouse | STRING | 保税仓名称 | |
buyer_memo | STRING | 1 | 买家留言信息 |
capital_free_discount | DOUBLE | 1 | 团长免单优惠金额,只在团长免单活动中才会返回优惠金额 |
card_info_list | OBJECT[] | 1 | 卡号信息列表 |
card_no 加密 | STRING | 1 | 卡号 |
mask_password 加密 | STRING | 1 | 卡密 |
cat_id_1 | LONG | 1 | 商品一级分类 |
cat_id_2 | LONG | 1 | 商品二级分类 |
cat_id_3 | LONG | 1 | 商品三级分类 |
cat_id_4 | LONG | 1 | 商品四级分类 |
city | STRING | 1 | 收件地城市 |
city_id | INTEGER | 1 | 城市编码 |
confirm_status | INTEGER | 1 | 成交状态:0:未成交、1:已成交、2:已取消 |
confirm_time | STRING | 1 | 成交时间 |
consolidate_info | OBJECT | 集运信息 | |
consolidate_type | INTEGER | 集运类型 0 - 香港集运 、1 - 新疆集运 | |
country | STRING | 1 | 收件地国家或地区 |
country_id | INTEGER | 1 | 国家或地区编码 |
created_time | STRING | 1 | 创建时间 |
delivery_home_value | DOUBLE | 1 | 送货入户费用 单位:元 |
delivery_install_value | DOUBLE | 1 | 送货入户并安装 单位:元 |
delivery_one_day | INTEGER | 是否当日发货,1-是,0-否 | |
discount_amount | DOUBLE | 1 | 折扣金额(元)折扣金额=平台优惠+商家优惠+团长免单优惠金额 |
duoduo_wholesale | INTEGER | 1 | 是否多多批发,1-是,0-否 |
extra_delivery_list | OBJECT[] | 订单多包裹发货时使用的其他发货快递信息 | |
logistics_id | INTEGER | 快递公司编号 | |
tracking_number | STRING | 快递运单号 | |
free_sf | INTEGER | 1 | 是否顺丰包邮 1表示是 0表示否 |
gift_delivery_list | OBJECT[] | 赠品额外运单列表 | |
logistics_id | INTEGER | 快递ID | |
tracking_number | STRING | 运单号 | |
gift_list | OBJECT[] | 赠品列表 | |
goods_count | INTEGER | 赠品数量 | |
goods_id | LONG | 赠品id | |
goods_img | STRING | 赠品图片 | |
goods_name | STRING | 赠品名称 | |
goods_price | DOUBLE | 赠品销售价格 | |
goods_spec | STRING | 赠品规格 | |
outer_goods_id | STRING | 商家外部商品编码 | |
outer_id | STRING | 商家外部sku编码 | |
sku_id | LONG | 赠品规格编码 | |
goods_amount | DOUBLE | 1 | 商品金额(元)商品金额=商品销售价格*商品数量-订单改价折扣金额 |
group_order_id | LONG | 团id | |
group_role | INTEGER | 团身份。0-团员,1-团长 | |
group_status | INTEGER | 1 | 成团状态:0:拼团中、1:已成团、2:团失败 |
home_delivery_type | INTEGER | 1 | 送货入户并安装服务 0-不支持送货,1-送货入户不安装,2-送货入户并安装 |
home_install_value | DOUBLE | 1 | 上门安装费用 单位:元 |
inner_transaction_id 加密 | STRING | 1 | 支付申报订单号(多多国际清关请使用此字段,单号以XP开头) |
invoice_status | INTEGER | 1 | 发票申请,1代表有 0代表无 |
is_lucky_flag | INTEGER | 1 | 是否抽奖订单,1-非抽奖订单,2-抽奖订单 |
is_pre_sale | INTEGER | 1 | 是否为预售商品 1表示是 0表示否 |
is_stock_out | INTEGER | 1 | 是否缺货 0-无缺货处理 1: 有缺货处理 |
item_list | OBJECT[] | 1 | 订单中商品sku列表 |
goods_count | INTEGER | 1 | 商品数量 |
goods_id | LONG | 1 | 商品编号 |
goods_img | STRING | 1 | 商品图片 |
goods_name | STRING | 1 | 商品名称 |
goods_price | DOUBLE | 1 | 商品销售价格 |
goods_spec | STRING | 1 | 商品规格,使用(规格值1,规格值2)组合作为sku的表示,中间以英文逗号隔开 |
outer_goods_id | STRING | 1 | 商家外部编码(商品),注意:编辑商品后必须等待商品审核通过后方可生效,订单中商品信息为交易快照的商品信息。 |
outer_id | STRING | 1 | 商家外部编码(sku),注意:编辑商品后必须等待商品审核通过后方可生效,订单中商品信息为交易快照的商品信息。 |
sku_id | LONG | 1 | 商品规格编码 |
last_ship_time | STRING | 1 | 订单承诺发货时间 |
logistics_id | LONG | 1 | 快递公司编号 |
mkt_biz_type | INTEGER | 1 | 市场业务类型,0-普通订单,1-拼内购订单 |
only_support_replace | INTEGER | 1 | 只换不修,1:是,0:否 |
order_change_amount | DOUBLE | 订单改价折扣金额,单位元 | |
order_depot_info | OBJECT | 1 | 仓库信息 |
depot_code | STRING | 1 | 仓库编码 |
depot_id | STRING | 1 | 仓库id |
depot_name | STRING | 1 | 仓库名称 |
depot_type | INTEGER | 1 | 仓库类型,1:自有仓 2:订阅仓 两者都不是则传空 |
ware_id | STRING | 1 | 货品id |
ware_name | STRING | 1 | 货品名称 |
ware_sn | STRING | 1 | 货品编码 |
ware_sub_info_list | OBJECT[] | 1 | 子货品列表(组合货品才会有子货品信息) |
ware_id | LONG | 1 | 子货品id |
ware_name | STRING | 1 | 子货品1编码 |
ware_quantity | LONG | 1 | 子货品数量 |
ware_sn | STRING | 1 | 子货品编码 |
ware_type | INTEGER | 1 | 货品类型(0:普通货品,1:组合货品) |
order_sn | STRING | 1 | 订单编号 |
order_status | INTEGER | 1 | 发货状态,枚举值:1:待发货,2:已发货待签收,3:已签收 |
order_tag_list | OBJECT[] | 订单标签列表,no_trace_delivery=无痕发货,only_support_replace=只换不修,duoduo_wholesale=多多批发,return_freight_payer=退货包运费,free_sf=顺丰包邮,support_nationwide_warranty=全国联保,self_contained=门店自提,delivery_one_day=当日发货,oversea_tracing=全球购溯源,distributional_sale=分销订单,open_in_festival=不打烊,region_black_delay_shipping=发货时间可延迟,same_city_distribution=同城配送,has_subsidy_postage=补贴运费红包,has_sf_express_service=顺丰加价,community_group=小区团购,has_ship_additional=加运费发顺丰,ship_additional_order=加运费补差价订单,conso_order=集运订单,allergy_refund=过敏包退,professional_appraisal=专业鉴定 | |
name | STRING | return_freight_payer | 标签名称 |
value | INTEGER | 1 | 是否有标签:0=无标签,1=有标签 |
pay_amount | DOUBLE | 1 | 支付金额(元)支付金额=商品金额-折扣金额+邮费+服务费 |
pay_no 加密 | STRING | 1 | 支付单号 |
pay_time | STRING | 1 | 支付时间 |
pay_type | STRING | 1 | 支付方式,枚举值:QQ,WEIXIN,ALIPAY,LIANLIANPAY |
platform_discount | DOUBLE | 1 | 平台优惠金额 |
postage | DOUBLE | 1 | 邮费 |
pre_sale_time | STRING | 1 | 预售时间 |
promise_delivery_time | STRING | 承诺送达时间 | |
province | STRING | 1 | 收件地省份 |
province_id | INTEGER | 1 | 省份编码 |
receive_time | STRING | 1 | 确认收货时间 |
receiver_address 加密 | STRING | 1 | 收件人地址,不拼接省市区。订单状态为待发货状态,且订单未被风控打标的情况下返回密文数据;其余情况返回空字符串。 |
receiver_address_mask | STRING | 收件人地址(打码) | |
receiver_name 加密 | STRING | 1 | 收件人姓名。订单状态为待发货状态,且订单未被风控打标的情况下返回密文数据;其余情况返回空字符串。 |
receiver_name_mask | STRING | 收件人姓名(打码) | |
receiver_phone 加密 | STRING | 1 | 收件人电话。订单状态为待发货状态,且订单未被风控打标的情况下返回密文数据;其余情况返回空字符串。 |
receiver_phone_mask | STRING | 收件人手机号(打码) | |
refund_status | INTEGER | 1 | 退款状态,枚举值:1:无售后或售后关闭,2:售后处理中,3:退款中,4: 退款成功 |
remark | STRING | 1 | 商家订单备注 |
remark_tag | INTEGER | 1 | 订单备注标记,1-红色,2-黄色,3-绿色,4-蓝色,5-紫色 |
remark_tag_name | STRING | 红色 | 订单备注标记名称 |
resend_delivery_list | OBJECT[] | 补寄额外运单列表 | |
logistics_id | INTEGER | 快递ID | |
tracking_number | STRING | 运单号 | |
return_freight_payer | INTEGER | 1 | 退货包运费,1:是,0:否 |
risk_control_status | INTEGER | 订单审核状态(0-正常订单, 1-审核中订单) | |
self_contained | INTEGER | 是否门店自提,1-是,0-否 | |
seller_discount | DOUBLE | 1 | 店铺优惠金额 |
service_fee_detail | OBJECT[] | 服务费明细列表,sf_express_fee=顺丰加价服务 | |
service_fee | DOUBLE | 服务费金额,单位:元 | |
service_name | STRING | 服务费类型 | |
ship_additional_link_order | STRING | 关联的加运费发顺丰的补差价订单 | |
ship_additional_origin_order | STRING | 加运费补差价订单的原单 | |
shipping_time | STRING | 1 | 发货时间 |
shipping_type | INTEGER | 创建交易时的物流方式(1-预约配送) | |
step_order_info | OBJECT | 1 | 定金订单信息 ,非定金订单该字段为null |
advanced_paid_fee | DOUBLE | 1 | 已付定金 单位:元 |
step_discount_amount | DOUBLE | 1 | 膨胀金额 (包含券减) 单位:元 |
step_paid_fee | DOUBLE | 1 | 分阶段已付金额(定金+尾款) 单位:元 |
step_trade_status | INTEGER | 1 | 定金订单状态:step_trade_status 枚举:0-定金未付尾款未付、1-定金已付尾款未付、2-定金已付尾款已付 |
stock_out_handle_status | INTEGER | 1 | 缺货处理状态 -1:无缺货处理 0: 缺货待处理 1缺货已处理 |
store_info | OBJECT | 门店信息 | |
store_id | LONG | 门店id | |
store_name | STRING | 门店名称 | |
store_number | STRING | 门店自定义编码 | |
support_nationwide_warranty | INTEGER | 1 | 全国联保,1:是,0:否 |
town | STRING | 1 | 收件地区县 |
town_id | INTEGER | 1 | 区县编码 |
tracking_number | STRING | 1 | 快递运单号 |
trade_type | INTEGER | 1 | 订单类型 0-普通订单、1-定金订单 |
updated_at | STRING | 1 | 订单最近一次更新时间 |
urge_shipping_time | STRING | 催发货时间 | |
yyps_date | STRING | 预约配送日期 | |
yyps_time | STRING | 预约配送时段 |
4.请求示例(CURL、PHP 、PHPsdk 、Java 、C# 、Python…)
- # coding:utf-8
- """
- Compatible for python2.x and python3.x
- requirement: pip install requests
- """
- from __future__ import print_function
- import requests
- # 请求示例 url 默认请求参数已经做URL编码
- url = "https://wx19970108018/pinduoduo/custom/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&method="
- headers = {
- "Accept-Encoding": "gzip",
- "Connection": "close"
- }
- if __name__ == "__main__":
- r = requests.get(url, headers=headers)
- json_obj = r.json()
- print(json_obj)