拼多多开放平台订单详情接口解析

API接口订单接口是指用于实现订单相关操作的程序接口。通过这个接口，用户可以实现创建、修改、查询和取消订单等功能。

常见的API接口订单接口包括：

1. 创建订单接口，用于实现用户下单操作。

2. 修改订单接口，用于修改已有订单信息。

3. 查询订单接口，用于查询订单信息。

4. 取消订单接口，用于取消已有订单。

在使用API接口订单接口时，需要将接口的请求参数、请求方式和响应格式等信息传递给接口，以便接口能够正确处理请求。同时，为了保障数据的安全性和可靠性，在使用API接口订单接口时，建议使用HTTPS协议进行数据传输，并且设置安全验证信息，如API Key、Token等，避免恶意攻击和非法操作。

查询单个订单详情（只能获取到成交时间三个月以内的交易信息）

返回参数说明

详情API接口

参数接口	参数类型	例子	说明
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 - 新疆中转、2-哈萨克斯坦集运、3-西藏中转
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=专业鉴定，ship_hold=暂停发货
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		预约配送时段

请求示例

package com.pdd.pop.sdk.http.demo;

import com.pdd.pop.sdk.common.util.JsonUtil;
import com.pdd.pop.sdk.http.api.pop.request.PddOrderInformationGetRequest;
import com.pdd.pop.sdk.http.api.pop.response.PddOrderInformationGetResponse;
import com.pdd.pop.sdk.http.PopClient;
import com.pdd.pop.sdk.http.PopHttpClient;

public class PopClientDemo {

    public static void main(String[] args) throws Exception {

        String clientId = "your clientId";
        String clientSecret = "your clientSecret";
        String accessToken = "your accessToken";
        PopClient client = new PopHttpClient(clientId, clientSecret);

        PddOrderInformationGetRequest request = new PddOrderInformationGetRequest();
        request.setOrderSn("1");
        PddOrderInformationGetResponse response = client.syncInvoke(request, accessToken);
        System.out.println(JsonUtil.transferToJson(response));
    }
}