pdd.order.information.get拼多多店铺订单详情接口(店铺订单交易接口,店铺订单明文接口,店铺订单解密接口)代码对接教程

发布于:2023-01-22 ⋅ 阅读:(4) ⋅ 点赞:(0) ⋅ 评论:(0)

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)