获取单笔交易的详细信息

---

接口地址： http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trade-fullinfo-get

---

请求方式： POST

---

传参方式： JSON

---

返回格式： JSON

---

请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数	类型	必选	描述
shop_id	String	是	店铺 ID
params	Object	是	参数
-fields	string	是	需要返回的字段列表，多个字段用半角逗号分隔，可选值为返回示例中能看到的所有字段。
-tid	Number	是	交易编号
-includeOaid	string	否	appkey 未对接 oaid 加密，则忽略该字段。对接 oaid 加密情况下，（收货人 + 手机号 + 座机 + 收货地址 +create）5 个字段组合成 oaid，原始订单上座机为空也满足条件。传 true，代表必须返回 oaid，生成不了就报 isv.oaid-field-miss 错误；默认或者传 false，满足生成条件则返回 oaid，否则为空
edition	string	否	版本 默认:1(不传默认为1) 1:1.0,2:2.0

请求示例

{
  "shop_id":173926031,
    "params":{
  "fields":"tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town",
  "tid":"10000000001",
  "includeOaid":"true"
    }
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trade-fullinfo-get' --header 'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx' --header 'Content-Type: application/json' --data-raw '{
  "shopId":"123456789",
  "fields":"tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town",
  "tid":"10000000001",
  "includeOaid":"true"
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trade-fullinfo-get',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "shopId":"123456789",
  "fields":"tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town",
  "tid":"10000000001",
  "includeOaid":"true"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n  \"shopId\":\"123456789\",\r\n  \"fields\":\"tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town\",\r\n  \"tid\":\"10000000001\",\r\n  \"includeOaid\":\"true\"\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trade-fullinfo-get")
  .method("POST", body)
  .addHeader("Authorization", "1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Python请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-trade-fullinfo-get"

payload = json.dumps({
  "shopId": "123456789",
  "fields": "tid,type,status,payment,orders,promotion_details,receiver_name,receiver_state,receiver_address,receiver_zip,receiver_mobile,receiver_phone,receiver_country,receiver_town",
  "tid": "10000000001"
})
headers = {
  'Authorization': '1798c6aadec33d1bc2f5b707f1049aefexxxx',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

响应参数

参数	类型	描述
data	object	返回数据
----trade	Trade	交易主订单信息
----seller_nick	String	卖家昵称
----pic_path	String	商品图片绝对途径
----payment	String	实付金额。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分
----seller_rate	Boolean	卖家是否已评价。可选值：true(已评价),false(未评价)
----post_fee	String	邮费。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分
----receiver_name	String	收货人的姓名
----receiver_state	String	收货人的所在省份
----receiver_address	String	收货人的详细地址
----receiver_zip	String	收货人的邮编
----receiver_mobile	String	收货人的手机号码
----receiver_phone	String	收货人的电话号码
----consign_time	Date	卖家发货时间。格式：yyyy-MM-dd HH:mm:ss
----received_payment	String	卖家实际收到的支付宝打款金额（由于子订单可以部分确认收货，这个金额会随着子订单的确认收货而不断增加，交易成功后等于买家实付
----promotion_details	PromotionDetail[]	优惠详情
----est_con_time	String	商家的预计发货时间
----receiver_country	String	收货人国籍
----receiver_town	String	收货人街道地址
----order_tax_fee	String	天猫国际官网直供主订单关税税费
----paid_coupon_fee	String	满返红包的金额；如果没有满返红包，则值为 0.00
----shop_pick	String	门店自提，总店发货，分店取货的门店自提订单标识
----tid_str	String	同 tid
----biz_code	String	为 tmall.daogoubao.cloudstore 时表示云店链路
----cloud_store	String	值为 1，且 bizCode 不为 tmall.daogoubao.cloudstore 时，为旗舰店订单
----new_presell	Boolean	预售单为 true，否则 false (云店订单专用)
----you_xiang	Boolean	优享购为 true，否则 false(云店订单专用)
----pay_channel	String	默认为 0,0 表示用户主动支付 1 表示系统代扣 2 表示保险赔付
----tid	Number	交易编号 (父订单的交易编号)
----num	Number	商品购买数量。取值范围：大于零的整数，对于一个 trade 对应多个 order 的时候（一笔主订单，对应多笔子订单），num=0，num 是一个跟商品关联的属性，一笔
----num_iid	Number	商品数字编号
----status	String	交易状态。可选值： * TRADE_NO_CREATE_PAY(没有创建支付宝交易) * WAIT_BUYER_PAY(等待买家付款) * SELLER_CONSIGNED_PART
----title	String	交易标题，以店铺名作为此标题的值。注：taobao.trades.get 接口返回的 Trade 中的 title 是商品名称
----type	String	交易类型列表，同时查询多种交易类型可用逗号分隔。默认同时查询 guarantee_trade, auto_delivery, ec, cod 的 4 种交易类型的数据 可选
----price	String	商品价格。精确到 2 位小数；单位：元。如：200.07，表示：200 元 7 分
----discount_fee	String	可以使用 trade.promotion_details 查询系统优惠系统优惠金额（如打折，VIP，满就送等），精确到 2 位小数，单位：元。如：200.07，表
----has_post_fee	Boolean	是否包含邮费。与 available_confirm_fee 同时使用。可选值：true(包含),false(不包含)
----total_fee	String	商品金额（商品价格乘以数量的总金额）。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分
----created	Date	交易创建时间。格式：yyyy-MM-dd HH:mm:ss
----pay_time	Date	付款时间。格式：yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。
----modified	Date	交易修改时间(用户对订单的任何修改都会更新此字段)。格式：yyyy-MM-dd HH:mm:ss
----end_time	Date	交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间 。格式：yyyy-MM-dd HH:mm:ss
----buyer_message	String	买家留言
----buyer_memo	String	买家备注（与淘宝网上订单的买家备注对应，只有买家才能查看该字段）
----buyer_flag	Number	买家备注旗帜（与淘宝网上订单的买家备注旗帜对应，只有买家才能查看该字段）红、黄、绿、蓝、紫 分别对应 1、2、3、4、5
----seller_memo	String	卖家备注（与淘宝网上订单的卖家备注对应，只有卖家才能查看该字段）
----seller_flag	Number	卖家备注旗帜（与淘宝网上订单的卖家备注旗帜对应，只有卖家才能查看该字段）红、黄、绿、蓝、紫 分别对应 1、2、3、4、5
----buyer_nick	String	买家昵称
----trade_attr	JSON	top 动态字段
----credit_card_fee	String	使用信用卡支付金额数
----step_trade_status	String	分阶段付款的订单状态（例如万人团订单等），目前有三返回状态 FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未
----step_paid_fee	String	分阶段付款的已付金额（万人团订单已付金额）
----mark_desc	String	订单出现异常问题的时候，给予用户的描述，没有异常的时候，此值为空
----shipping_type	String	创建交易时的物流方式（交易完成前，物流方式有可能改变，但系统里的这个字段一直不变）。可选值：free(卖家包邮),post(平邮),express
----buyer_cod_fee	String	买家货到付款服务费。精确到 2 位小数;单位：元。如：12.07，表示：12 元 7 分
----adjust_fee	String	卖家手工调整金额，精确到 2 位小数，单位：元。如：200.07，表示：200 元 7 分。来源于订单价格修改，如果有多笔子订单的时候，这个为 0，单笔
----trade_from	String	交易内部来源。WAP(手机);HITAO(嗨淘);TOP(TOP 平台);TAOBAO(普通淘宝);JHS(聚划算)一笔订单可能同时有以上多个标记，则以逗号分隔
----service_orders	ServiceOrder[]	服务子订单列表
----buyer_rate	Boolean	买家是否已评价。可选值：true(已评价),false(未评价)。如买家只评价未打分，此字段仍返回 false
----receiver_city	String	收货人的所在城市注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的 receiver_city 的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了 receiver_district 里面 建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有 receiver_district 参数，该参数作为城市
----receiver_district	String	收货人的所在地区注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市 是放在的 receiver_city 的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了 receiver_district 里面 建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有 receiver_district 参数，该参数作为城市
----service_tags	LogisticsTag[]	物流标签
----o2o	String	导购宝 =crm
----o2o_guide_id	String	导购员 id
----o2o_shop_id	String	导购员门店 id
----o2o_guide_name	String	导购员名称
----o2o_shop_name	String	导购门店名称
----o2o_delivery	String	导购宝提货方式，inshop：店内提货，online：线上发货
----orders	Order[]	订单列表
----trade_ext	TradeExt	交易扩展表信息
----eticket_service_addr	String	天猫电子凭证家装
----rx_audit_status	String	处方药未审核状态
----es_range	String	时间段
----es_date	String	时间
----os_date	String	时间
----os_range	String	时间段
----coupon_fee	Number	订单中使用红包付款的金额
----o2o_et_order_id	String	分阶段交易的特权定金订单 ID
----post_gate_declare	Boolean	邮关订单
----cross_bonded_declare	Boolean	跨境订单
----omnichannel_param	String	全渠道商品通相关字段
----assembly	String	组合商品
----top_hold	Number	TOP 拦截标识，0 不拦截，1 拦截
----omni_attr	String	星盘标识字段
----omni_param	String	星盘业务字段
----forbid_consign	Number	聚划算一起买字段
----identity	String	采购订单标识
----team_buy_hold	Number	天猫拼团拦截标示
----share_group_hold	Number	shareGroupHold
----ofp_hold	Number	天猫国际拦截
----o2o_step_trade_detail	String	组装 O2O 多阶段尾款订单的明细数据 总阶段数，当前阶数，阶段金额（单位：分），支付状态，例如 3_1_100_paid ;
----o2o_step_order_id	String	特权定金订单的尾款订单 ID
----o2o_voucher_price	String	分阶段订单的特权定金抵扣金额，单位：分
----order_tax_promotion_fee	String	天猫国际计税优惠金额
----delay_create_delivery	Number	聚划算火拼标记
----toptype	Number	top 定义订单类型
----service_type	String	serviceType
----o2o_service_mobile	String	o2oServiceMobile
----o2o_service_name	String	o2oServiceName
----o2o_service_state	String	o2oServiceState
----o2o_service_city	String	o2oServiceCity
----o2o_service_district	String	o2oServiceDistrict
----o2o_service_town	String	o2oServiceTown
----o2o_service_address	String	o2oServiceAddress
----o2o_step_trade_detail_new	String	o2oStepTradeDetailNew
----o2o_xiaopiao	String	o2oXiaopiao
----o2o_contract	String	o2oContract
----retail_store_code	String	新零售门店编码
----retail_out_order_id	String	新零售线下订单 id
----recharge_fee	String	rechargeFee
----platform_subsidy_fee	String	platformSubsidyFee
----nr_offline	String	nrOffline
----wtt_param	String	网厅订单垂直表信息
----logistics_infos	LogisticsInfo[]	logisticsInfos
----nr_store_order_id	String	nrStoreOrderId
----nr_shop_id	String	门店 ID
----nr_shop_name	String	门店名称
----nr_shop_guide_id	String	导购员 ID
----nr_shop_guide_name	String	导购员名称
----sort_info	JSON	sortInfo
----sorted	Number	1 已排序 2 不排序
----nr_no_handle	String	一小时达不处理订单
----buyer_open_uid	String	买家 OpenUid
----is_gift	Boolean	isGift
----donee_nick	String	doneeNick
----donee_open_uid	String	doneeUid
----suning_shop_code	String	suningShopCode
----suning_shop_valid	Number	suningShopValid
----retail_store_id	String	retailStoreId
----is_istore	Boolean	isIstore
----ua	String	ua
----cutoff_minutes	String	截单时间
----es_time	String	时效：天
----delivery_time	String	发货时间
----collect_time	String	揽收时间
----dispatch_time	String	派送时间
----sign_time	String	签收时间
----delivery_cps	String	派送 CP
----linkedmall_ext_info	String	linkedmall 透传参数
----rt_omni_send_type	String	新零售全渠道订单：订单类型，自提订单：pickUp，电商发货：tmall，门店发货（配送、骑手）：storeSend
----rt_omni_store_id	String	新零售全渠道订单：发货门店 ID
----rt_omni_outer_store_id	String	新零售全渠道订单：商家自有发货门店编码
----tcps_start	String	同城预约配送开始时间
----tcps_code	String	同城业务类型，com.tmall.dsd:定时送，storeDsd-fn-3-1:淘速达 3 公里蜂鸟配送
----tcps_end	String	同城预约配送结束时间
----m_tariff_fee	String
----timing_promise	String	时效服务身份，如 tmallPromise 代表天猫时效承诺
----promise_service	String	时效服务字段，服务字段，会有多个服务值，以英文半角逗号","切割
----oi_range	String	苏宁预约安装，用户安装时间段
----oi_date	String	苏宁预约安装，用户安装时间
----hold_install	String	苏宁预约安装，暂不安装
----outer_partner_member_id	String	外部会员 id
----root_cat	String	叶子分类
----gifting	String	1-gifting 订单
----gifting_takeout	String	1-coffee gifting 订单
----app_name	String	订单来源
----easy_home_city_type	String	居然之家同城站订单类型 deposit：预约到店，direct：直接购买，tail：尾款核销
----nr_deposit_order_id	String	同城站关联订单号
----nr_store_code	String	摊位 id
----propoint	String	使用淘金币的数量，以分为单位，和订单标 propoint 中间那一段一样，没有返回 null
----zqs_order_tag	String	1-周期送订单
----txp_freezer_id	String	天鲜配冰柜 id
----txp_receive_method	String	天鲜配自提方式
----brand_light_shop_store_id	String	同城购门店 ID
----brand_light_shop_source	String	同城购订单 source
----extend_info	String	透出的额外信息
----lm	String	收货地址有变更，返回"1"
----ncz_ext_attr	String	新康众定制数据
----is_wmly	String	标识完美履约订单
----omni_package	String	全渠道包裹信息
----expandcard_info	ExpandCardInfo	购物金信息输出
----invoice_detail_after_refund	String	苹果发票详情
----invoice_detail_pay	String	苹果发票详情
----invoice_detail_mid_refund
----expand_card_basic_price	String	买卡订单本金
----expand_card_expand_price	String	买卡订单权益金
----expand_card_basic_price_used	String	用卡订单所用的本金
----expand_card_expand_price_used	String	用卡订单所用的权益金
----is_openmall	Boolean	是否是 Openmall 订单
----asdp_biz_type	String	asdp 业务身份
----oaid	String	(收货人 + 手机号 + 收货地址 +create）4 字段返回值都都不能为空，否则生
----v_logistics_create	Boolean	是否是码上收订单
----q_r_pay	Boolean	是否是非物流订单
----is_sh_ship	Boolean	是否屏蔽发货
----o2o_snatch_status	String	抢单状态 0,未处理待分发;1,抢单中;2,已抢单;3,已发货;-1,超时;-2,处理异常;-3,匹配失败;-4,取消抢单;-5,退款取消;-9,逻辑删除
----market	String	垂直市场
----et_type	String	电子凭证扫码购-扫码支付订单 type
----et_shop_id	Number	扫码购关联门店
----obs	String	门店预约自提订单标
----deduct_money	int	消耗点券
status	int	状态码，0为成功

返回数据

{
  "data": {
                "orders": {
                    "order": [
                        {
                            "adjust_fee": "0.00",
                            "buyer_rate": false,
                            "cid": 5000000005,
                            "discount_fee": "0.00",
                            "divide_order_fee": "**.00",
                            "end_time": "2021-04-01 13:08:18",
                            "is_daixiao": false,
                            "num": 1,
                            "num_iid": 1000000000001,
                            "oid": "168*********10386",
                            "payment": "108.00",
                            "pic_path": "https://img.alic*********01MtD9Oh1ySJ*********956577.png",
                            "price": "98.00",
                            "refund_id": "1079*********818603",
                            "refund_status": "SUCCESS",
                            "seller_rate": false,
                            "seller_type": "C",
                            "status": "TR*********ED",
                            "title": "婴幼儿*********湿巾生*********使用包",
                            "total_fee": "***.00"
                        }
                    ]
                },
                "receiver_address": "三墩*********幢2单元",
                "receiver_mobile": "$1Sag+WmXBD*********icUYg2yQ==$1$$",
                "receiver_name": "~jKIpSPC*********~u/nh~1~~",
                "receiver_state": "**省",
                "receiver_zip": "000000",
                "status": "TRADE_CLOSED",
                "type": "fixed"
            },
  "deduct_money": 4
},
  "status": 0
}

错误码

状态码(status)	错误信息	解决方案
132	请求格式必须为JSON	修改请求参数格式为json
422	参数列表不合法，在err中会给出提示	根据提示做相应修改
200	认证失败	请确保请求头里的Authorization存在或者未过期
422	必须是此交易的买家或卖家才能获取交易详细信息	保证传入的订单 ID 和卖家 SessionKey 信息是一致的
422	交易不存在	订单已进入历史库，不再提供实时查询，出现此错误请清除本地数据库该订单，不要重试
422	订单 ID 不存在，或者使用了子订单 ID 来查询	请填写正确的订单 ID，或使用主订单 ID 来查询
422	交易慢查询访问太频繁	缩短查询订单的时间范围，减少超时查询的次数，或者等待一段时间后再来查询
422	单位时间内慢查询过多，服务被降级	请稍后重试。
422	佣金服务不可用	重试
422	交易服务不可用	适当重试
422	服务不可用	重试
422	交易服务限流	请稍后重试
422	交易服务连接依赖的远程服务错误	请稍后重试
422	交易服务处理超时	请稍后重试
422	请求参数有误	请传入正确的参数
422	门店发货拦截订单	重试
422	交易服务不可用	重试
422	订单已经被星盘拦截	对接星盘发货系统
2011	店铺未授权	使用已授权店铺