淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
fields	String	必须	tid,type,status,payment,orders		需要返回的字段列表，多个字段用半角逗号分隔，可选值为返回示例中能看到的所有字段。
tid	Number	必须	123456789		交易编号

名称	类型	示例值	描述
trade	Trade		交易主订单信息
└ buyer_open_uid String AAHk5d-EAAeGwJedwSFu0XXX 买家OpenUid └ title String 麦包包交易标题，以店铺名作为此标题的值。注:taobao.trades.get接口返回的Trade中的title是商品名称 └ type String fixed(一口价) 交易类型列表，同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade, auto_delivery, ec, cod的4种交易类型的数据可选值 fixed(一口价) auction(拍卖) guarantee_trade(一口价、拍卖) auto_delivery(自动发货) independent_simple_trade(旺店入门版交易) independent_shop_trade(旺店标准版交易) ec(直冲) cod(货到付款) fenxiao(分销) game_equipment(游戏装备) shopex_trade(ShopEX交易) netcn_trade(万网交易) external_trade(统一外部交易)o2o_offlinetrade（O2O交易）step (万人团)nopaid(无付款订单)pre_auth_type(预授权0元购机交易) └ created Date 2000-01-01 00:00:00 交易创建时间。格式:yyyy-MM-dd HH:mm:ss └ sid String NP1021246146 物流运单号 └ tid Number 2231958349 交易编号 (父订单的交易编号) └ acookie_id String 1a11a0987628772c002ec7d0eec2a352 Acookie订单唯一ID。 └ seller_rate Boolean true 卖家是否已评价。可选值:true(已评价),false(未评价) └ buyer_rate Boolean true 买家是否已评价。可选值:true(已评价),false(未评价)。如买家只评价未打分，此字段仍返回false └ status String TRADE_NO_CREATE_PAY 交易状态。可选值: * TRADE_NO_CREATE_PAY(没有创建支付宝交易) * WAIT_BUYER_PAY(等待买家付款) * SELLER_CONSIGNED_PART(卖家部分发货) * WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) * WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) * TRADE_BUYER_SIGNED(买家已签收,货到付款专用) * TRADE_FINISHED(交易成功) * TRADE_CLOSED(付款以后用户退款成功，交易自动关闭) * TRADE_CLOSED_BY_TAOBAO(付款以前，卖家或买家主动关闭交易) * PAY_PENDING(国际信用卡支付付款确认中) * WAIT_PRE_AUTH_CONFIRM(0元购合约中) * PAID_FORBID_CONSIGN(拼团中订单或者发货强管控的订单，已付款但禁止发货) └ payment String 200.07 实付金额。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ discount_fee String 200.07 建议使用trade.promotion_details查询系统优惠系统优惠金额（如打折，VIP，满就送等），精确到2位小数，单位：元。如：200.07，表示：200元7分 └ adjust_fee String 200.07 卖家手工调整金额，精确到2位小数，单位：元。如：200.07，表示：200元7分。来源于订单价格修改，如果有多笔子订单的时候，这个为0，单笔的话则跟[order].adjust_fee一样 └ post_fee String 200.07 邮费。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ total_fee String 200.07 商品金额（商品价格乘以数量的总金额）。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ pay_time Date 2000-01-01 00:00:00 付款时间。格式:yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。 └ end_time Date 2000-01-01 00:00:00 交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间。格式:yyyy-MM-dd HH:mm:ss └ modified Date 2000-01-01 00:00:00 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss └ consign_time Date 2000-01-01 00:00:00 卖家发货时间。格式:yyyy-MM-dd HH:mm:ss └ received_payment String 200.07 卖家实际收到的支付宝打款金额（由于子订单可以部分确认收货，这个金额会随着子订单的确认收货而不断增加，交易成功后等于买家实付款减去退款金额）。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ commission_fee String 200.07 交易佣金。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ buyer_memo String 上衣要大一号买家备注（与淘宝网上订单的买家备注对应，只有买家才能查看该字段） └ seller_memo String 好的卖家备注（与淘宝网上订单的卖家备注对应，只有卖家才能查看该字段） └ buyer_area String 浙江省杭州市买家下单的地区 └ alipay_no String 2009112081173831 支付宝交易号，如：2009112081173831 └ buyer_message String 要送的礼物的，不要忘记的哦买家留言 └ pic_path String http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg 商品图片绝对途径 └ num_iid Number 3424234 商品数字编号 └ price String 200.07 商品价格。精确到2位小数；单位：元。如：200.07，表示：200元7分 └ cod_fee String 12.07 货到付款服务费。精确到2位小数;单位:元。如:12.07，表示:12元7分。 └ cod_status String EW_CREATED(订单已创建) 货到付款物流状态。初始状态 NEW_CREATED,接单成功 ACCEPTED_BY_COMPANY,接单失败 REJECTED_BY_COMPANY,接单超时 RECIEVE_TIMEOUT,揽收成功 TAKEN_IN_SUCCESS,揽收失败 TAKEN_IN_FAILED,揽收超时 TAKEN_TIMEOUT,签收成功 SIGN_IN,签收失败 REJECTED_BY_OTHER_SIDE,订单等待发送给物流公司 WAITING_TO_BE_SENT,用户取消物流订单 CANCELED └ buyer_cod_fee String 12.07 买家货到付款服务费。精确到2位小数;单位:元。如:12.07，表示:12元7分 └ seller_cod_fee String 12.07 卖家货到付款服务费。精确到2位小数;单位:元。如:12.07，表示:12元7分。卖家不承担服务费的订单：未发货的订单获取服务费为0，发货后就能获取到正确值。 └ express_agency_fee String 212.07 快递代收款。精确到2位小数;单位:元。如:212.07，表示:212元7分 └ shipping_type String free 创建交易时的物流方式（交易完成前，物流方式有可能改变，但系统里的这个字段一直不变）。可选值：free(卖家包邮),post(平邮),express(快递),ems(EMS),virtual(虚拟发货)，25(次日必达)，26(预约配送)。 └ num Number 1 商品购买数量。取值范围：大于零的整数,对于一个trade对应多个order的时候（一笔主订单，对应多笔子订单），num=0，num是一个跟商品关联的属性，一笔订单对应多比子订单的时候，主订单上的num无意义。 └ point_fee Number 0 买家使用积分,下单时生成，且一直不变。格式:100;单位:个. └ real_point_fee Number 0 买家实际使用积分（扣除部分退款使用的积分），交易完成后生成（交易成功或关闭），交易未完成时该字段值为0。格式:100;单位:个 └ buyer_obtain_point_fee Number 0 买家获得积分,返点的积分。格式:100;单位:个。返点的积分要交易成功之后才能获得。 └ buyer_alipay_no String tbtest1063@taobaotest.com 买家支付宝账号 └ receiver_name String 东方不败收货人的姓名（1. 修改地址项目，hold单期间脱敏处理） └ receiver_country String 中国收货人国籍 └ receiver_state String 浙江省收货人的所在省份 └ receiver_city String 杭州市收货人的所在城市注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的receiver_city的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了receiver_district里面建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有receiver_district参数，该参数作为城市 └ receiver_district String 西湖区收货人的所在地区注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的receiver_city的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了receiver_district里面建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有receiver_district参数，该参数作为城市 └ receiver_town String 三墎镇收货人街道地址（1. 修改地址项目，hold单期间脱敏处理） └ receiver_address String 淘宝城911号收货人的详细地址（1. 修改地址项目，hold单期间脱敏处理） └ receiver_zip String 223700 收货人的邮编 └ receiver_mobile String 13512501826 收货人的手机号码（1. 修改地址项目，hold单期间脱敏处理） └ receiver_phone String 13819175372 收货人的电话号码（1. 修改地址项目，hold单期间脱敏处理） └ buyer_email String tbtest1064@taobaotest.com 买家邮件地址 └ seller_alipay_no String tbtest1063@taobaotest.com 卖家支付宝账号 └ seller_mobile String 13512501826 卖家手机 └ seller_phone String 13512501826 卖家电话 └ seller_name String 我在测试卖家姓名 └ seller_email String tbtest1063@taobaotest.com 卖家邮件地址 └ available_confirm_fee String 200.07 交易中剩余的确认收货金额（这个金额会随着子订单确认收货而不断减少，交易成功后会变为零）。精确到2位小数;单位:元。如:200.07，表示:200 元7分 └ has_post_fee Boolean true 是否包含邮费。与available_confirm_fee同时使用。可选值:true(包含),false(不包含) └ timeout_action_time Date 2000-01-01 00:00:00 超时到期时间。格式:yyyy-MM-dd HH:mm:ss。业务规则：前提条件：只有在买家已付款，卖家已发货的情况下才有效如果申请了退款，那么超时会落在子订单上；比如说3笔ABC，A申请了，那么返回的是BC的列表, 主定单不存在如果没有申请过退款，那么超时会挂在主定单上；比如ABC，返回主定单，ABC的超时和主定单相同 └ snapshot_url String T1mURbXopZXXXe3rLI.1257513712679_snap 交易快照地址 └ trade_memo String 这是一次成功的交易交易备注。 └ promotion String hello world 交易促销详细信息 └ is_3D Boolean true 是否3D交易 └ is_lgtype Boolean true 是否保障速递，如果为true，则为保障速递订单，使用线下联系发货接口发货，如果未false，则该订单非保障速递，根据卖家设置的订单流转规则可使用物流宝或者常规物流发货。 └ is_brand_sale Boolean true 表示是否是品牌特卖（常规特卖，不包括特卖惠和特实惠）订单，如果是返回true，如果不是返回false。当此字段与is_force_wlb均为true时，订单强制物流宝发货。 └ is_force_wlb Boolean true 订单是否强制使用物流宝发货。当此字段与is_brand_sale均为true时，订单强制物流宝发货。此字段为false时，该订单根据流转规则设置可以使用物流宝或者常规方式发货 └ buyer_flag Number 1 买家备注旗帜（与淘宝网上订单的买家备注旗帜对应，只有买家才能查看该字段）红、黄、绿、蓝、紫分别对应 1、2、3、4、5 └ seller_flag Number 1 卖家备注旗帜（与淘宝网上订单的卖家备注旗帜对应，只有卖家才能查看该字段）红、黄、绿、蓝、紫分别对应 1、2、3、4、5 └ credit_card_fee String 30.5 使用信用卡支付金额数 └ step_trade_status String FRONT_NOPAID_FINAL_NOPAID 分阶段付款的订单状态（例如万人团订单等），目前有三返回状态FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未付)，FRONT_PAID_FINAL_NOPAID(定金已付尾款未付)，FRONT_PAID_FINAL_PAID(定金和尾款都付) └ step_paid_fee String 525.70 分阶段付款的已付金额（万人团订单已付金额） └ eticket_ext String 525.70 电子凭证的垂直信息 └ mark_desc String 该订单需要延长收货时间订单出现异常问题的时候，给予用户的描述,没有异常的时候，此值为空 └ has_yfx Boolean true 订单中是否包含运费险订单，如果包含运费险订单返回true，不包含运费险订单，返回false └ yfx_fee String 0.50 订单的运费险，单位为元 └ yfx_id String 135751716473138 运费险支付号 └ yfx_type String taojinbi 运费险类型 └ send_time String 2000-01-01 订单将在此时间前发出，主要用于预售订单 └ can_rate Boolean true 买家可以通过此字段查询是否当前交易可以评论，can_rate=true可以评价，false则不能评价。 └ seller_can_rate Boolean true 卖家是否可以对订单进行评价 └ is_part_consign Boolean true 是否是多次发货的订单如果卖家对订单进行多次发货，则为true否则为false └ is_daixiao Boolean true 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单，那么该值为true；反之，该值为false。 └ is_wt Boolean true 表示订单交易是否网厅订单。如果该订单是网厅订单，那么该值为true；反之，该值为false。 └ arrive_interval Number 1 物流到货时效，单位天 └ arrive_cut_time String 16:00 物流到货时效截单时间，格式 HH:mm └ consign_interval Number 48 物流发货时效，单位小时 └ o2o String crm 导购宝=crm └ o2o_guide_id String 123456 导购员id └ o2o_guide_name String 西湖门店导购员1 导购员名称 └ o2o_shop_id String 123456 导购员门店id └ o2o_shop_name String 西湖门店导购门店名称 └ o2o_delivery String inshop 导购宝提货方式，inshop：店内提货，online：线上发货 └ o2o_out_trade_id String 123456 外部订单号 └ shop_code String demo 线下自提门店编码 └ hk_en_name String chenxiao 拼音名 └ hk_flight_no String GZ0022 航班号 └ hk_china_name String 陈小中文名 └ hk_card_code String G0000000001 证件号码 └ hk_card_type String 证件类型证件类型001代表港澳通行证类型、002代表入台证003代表护照 └ hk_flight_date String 2014-12-01 15:50 航班飞行时间 └ hk_gender String M 性别M: 男性，F: 女性 └ hk_birthday String 1988-01-12 出生日期 └ hk_pickup String 某地点提货地点 └ hk_pickup_id String 3 提货地点id └ est_con_time String 付款后30天内商家的预计发货时间 └ invoice_kind String 1 发票类型（ 1 电子发票 2 纸质发票） orders Order [] 订单列表 └ title String 山寨版测试机器商品标题 └ pic_path String http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg 商品图片的绝对路径 └ price String 200.07 商品价格。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ num_iid Number 2342344 商品数字ID └ sku_id String 5937146 商品的最小库存单位Sku的id.可以通过taobao.item.sku.get获取详细的Sku信息 └ outer_iid String 152e442aefe88dd41cb0879232c0dcb0 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品Item的id，可以通过taobao.items.custom.get获取商品的Item的信息 └ outer_sku_id String 81893848 外部网店自己定义的Sku编号 └ refund_status String SUCCESS(退款成功) 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款，等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款，等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货，等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功) └ status String TRADE_NO_CREATE_PAY 订单状态（请关注此状态，如果为TRADE_CLOSED_BY_TAOBAO状态，则不要对此订单进行发货，切记啊！）。可选值: TRADE_NO_CREATE_PAY(没有创建支付宝交易) WAIT_BUYER_PAY(等待买家付款) WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) TRADE_BUYER_SIGNED(买家已签收,货到付款专用) TRADE_FINISHED(交易成功) TRADE_CLOSED(付款以后用户退款成功，交易自动关闭) TRADE_CLOSED_BY_TAOBAO(付款以前，卖家或买家主动关闭交易) PAY_PENDING(国际信用卡支付付款确认中) └ oid Number 2231958349 子订单编号 └ total_fee String 200.07 应付金额（商品价格 * 商品数量 + 手工调整金额 - 子订单级订单优惠金额）。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ payment String 200.07 子订单实付金额。精确到2位小数，单位:元。如:200.07，表示:200元7分。对于多子订单的交易，计算公式如下：payment = price * num + adjust_fee - discount_fee ；单子订单交易，payment与主订单的payment一致，对于退款成功的子订单，由于主订单的优惠分摊金额，会造成该字段可能不为0.00元。建议使用退款前的实付金额减去退款单中的实际退款金额计算。 └ discount_fee String 200.07 子订单级订单优惠金额。精确到2位小数;单位:元。如:200.07，表示:200元7分 └ adjust_fee String 1.01 手工调整金额.格式为:1.01;单位:元;精确到小数点后两位. └ divide_order_fee String 21.00 分摊之后的实付金额 └ part_mjz_discount String 21.00 优惠分摊 └ sku_properties_name String 颜色:桔色;尺码:M SKU的值。如：机身颜色:黑色;手机套餐:官方标配 └ item_meal_id Number 2564854632 套餐ID └ item_meal_name String M8原装电池:便携支架:M8专用座充:莫凡保护袋套餐的值。如：M8原装电池:便携支架:M8专用座充:莫凡保护袋 └ num Number 1 购买数量。取值范围:大于零的整数 └ snapshot_url String T1mURbXopZXXXe3rLI.1257513712679_snap 订单快照URL └ timeout_action_time Date 2000-01-01 00:00:00 订单超时到期时间。格式:yyyy-MM-dd HH:mm:ss └ item_memo String 这是商品备注商品备注 └ buyer_rate Boolean true 买家是否已评价。可选值：true(已评价)，false(未评价) └ seller_rate Boolean true 卖家是否已评价。可选值：true(已评价)，false(未评价) └ refund_id String 2231958349 最近退款ID └ seller_type String B（商城商家）卖家类型，可选值为：B（商城商家），C（普通卖家） └ cid Number 123456 交易商品对应的类目ID └ is_oversold Boolean true 是否超卖 └ end_time Date 2012-04-07 00:00:00 子订单的交易结束时间说明：子订单有单独的结束时间，与主订单的结束时间可能有所不同，在有退款发起的时候或者是主订单分阶段付款的时候，子订单的结束时间会早于主订单的结束时间，所以开放这个字段便于订单结束状态的判断 └ order_from String jhs 子订单来源,如jhs(聚划算)、taobao(淘宝)、wap(无线) └ is_service_order Boolean true 是否是服务订单，是返回true，否返回false。 └ consign_time String 2013-01-13 15:23:00 子订单发货时间，当卖家对订单进行了多次发货，子订单的发货时间和主订单的发货时间可能不一样了，那么就需要以子订单的时间为准。（没有进行多次发货的订单，主订单的发货时间和子订单的发货时间都一样） └ shipping_type String post 子订单的运送方式（卖家对订单进行多次发货之后，一个主订单下的子订单的运送方式可能不同，用order.shipping_type来区分子订单的运送方式） └ logistics_company String 顺风快递子订单发货的快递公司名称 └ invoice_no String 05432465 子订单所在包裹的运单号 └ bind_oid Number 23194074143138 捆绑的子订单号，表示该子订单要和捆绑的子订单一起发货，用于卖家子订单捆绑发货 └ is_daixiao Boolean true 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单，那么该值为true；反之，该值为false。 └ ticket_outer_id String 123456abcd 对应门票有效期的外部id └ ticket_expdate_key String 100FFFFFF02374020000002001020304000A 门票有效期的key └ is_www Boolean true 子订单是否是www订单 └ store_code String 南京QDHEWL-0004 发货的仓库编码 └ tmser_spu_code String 家装干支装服务支持家装类物流的类型 └ sub_order_tax_fee String 0 天猫国际官网直供子订单关税税费 └ sub_order_tax_rate String 0 天猫国际官网直供子订单关税税率 └ et_ser_time String 2015-04-15 13:00 天猫汽车服务预约时间 └ et_shop_name String 测试预约门店地址电子凭证预约门店地址 └ et_verified_shop_name String 测试核销门店地址电子凭证核销门店地址 └ et_plate_number String 浙A11111 车牌号码 └ estimate_con_time String demo 子订单预计发货时间 └ bind_oids String 193741211090019,193741211080019 bind_oid字段的升级，支持返回绑定的多个子订单，多个子订单以半角逗号分隔 └ zhengji_status String 1 征集预售订单征集状态：1（征集中），2（征集成功），3（征集失败） └ md_qualification String true_免单原因免单资格属性 └ md_fee String 999 免单金额 └ customization String { "itemId": 123, "skuId": 123, "text": [ { "id": 44, "content": "home" } ], "pic": [ { "id": 44, "url": "sn" } ] ,"dingzhi":";pluginId:182;dingzhiId:157886;"} 定制信息 └ inv_type String 6 库存类型：6为在途 └ is_sh_ship Boolean true 是否发货 └ shipper String cn 仓储信息 └ f_type String jsd 订单履行类型，如喵鲜生极速达（jsd） └ f_status String 分单完成订单履行状态，如喵鲜生极速达：分单完成 └ f_term String storeId 单履行内容，如喵鲜生极速达：storeId,phone └ combo_id String 1923423423 天猫搭配宝 └ order_attr String {} 子订单扩展属性 └ assembly_rela String 123123 assemblyRela └ assembly_price String 123123123 assemblyPrice └ assembly_item String 123,456 assemblyItem └ sub_order_tax_promotion_fee String 0 天猫国际子订单计税优惠金额 └ down_payment String 1000 downPayment └ down_payment_ratio String 1000 downPaymentRatio └ month_payment String 1000 monthPayment └ tail_payment String 1000 tailPayment └ installment_num String 1000 installmentNum └ penalty String 1000 penalty └ service_fee String 1000 serviceFee └ car_taker String 1000 carTaker └ car_taker_phone String 1000 carTakerPhone └ car_taker_id String 1000 carTakerID └ car_store_code String 1000 carStoreCode └ car_store_name String 1000 carStoreName └ out_unique_id String 1000 outUniqueId └ ws_bank_apply_no String 1000 wsBankApplyNo └ oid_str String 123 oidStr └ fqg_num Number 12 花呗分期期数 └ is_fqg_s_fee Boolean true 是否商家承担手续费 └ tax_free Boolean true 天猫国际订单是否包税 └ tax_coupon_discount String 0 天猫国际订单包税金额 └ nr_reduce_inv_fail String 1 nrReduceInvFail promotion_details PromotionDetail [] 优惠详情 └ id Number 22331764490705 交易的主订单或子订单号 └ promotion_name String 满就减钱优惠信息的名称 └ discount_fee String 10.00 优惠金额（免运费、限时打折时为空）,单位：元 └ gift_item_name String 晨光签字笔满就送商品时，所送商品的名称 └ gift_item_id String 13233791195 赠品的宝贝id └ gift_item_num String 1 满就送礼物的礼物数量 └ promotion_desc String 双11促销，满就送优惠活动的描述 └ promotion_id String mjs 优惠id，(由营销工具id、优惠活动id和优惠详情id组成，结构为：营销工具id-优惠活动id_优惠详情id，如mjs-123024_211143） service_tags LogisticsTag [] 物流标签 └ order_id String 123456 主订单或子订单的订单号 logistic_service_tag_list LogisticServiceTag [] 服务标签 └ service_tag String comFee=1211;comTim=1;companyCode=SF; 物流服务下的标签属性,多个标签之间有";"分隔 └ service_type String FAST 消费者选快递请直接判断service_tag是否包含companyCode。而不要判断service_type service_orders ServiceOrder [] 服务子订单列表 └ oid Number 110770592823138 虚拟服务子订单订单号 └ item_oid Number 110770592803138 服务所属的交易订单号。如果服务为一年包换，则item_oid这笔订单享受改服务的保护 └ service_id Number 2342344 服务数字id └ service_detail_url String http://wt.taobao.com/plan.htm?plan_id=planId 服务详情的URL地址 └ num Number 1 购买数量，取值范围为大于0的整数 └ price String 39.09 服务价格，精确到小数点后两位：单位:元 └ payment String 29.98 子订单实付金额。精确到2位小数，单位:元。如:200.07，表示:200元7分。 └ title String 滚筒洗衣机商品名称 └ total_fee String 39.09 服务子订单总费用 └ buyer_nick String 小倩2005 卖家昵称 └ refund_id String 2231958349 最近退款的id └ seller_nick String 麦包包卖家昵称 └ pic_path String http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg 服务图片地址 └ tmser_spu_code String 家装干支装服务支持家装类物流的类型 └ et_ser_time String 2015-04-15 13:00 天猫汽车预约服务时间 └ et_shop_name String 测试预约门店地址电子凭证预约门店地址 └ et_verified_shop_name String 测试核销门店地址电子凭证核销门店地址 └ et_plate_number String 浙A11111 车牌号 └ oid_str String 110770592823138 虚拟服务子订单订单号(String类型) └ invoice_name String 淘宝发票抬头 └ invoice_type String 水果，图书发票类型 └ trade_from String WAP,JHS 交易内部来源。WAP(手机);HITAO(嗨淘);TOP(TOP平台);TAOBAO(普通淘宝);JHS(聚划算)一笔订单可能同时有以上多个标记，则以逗号分隔 └ trade_source String ownshop 交易外部来源：ownshop(商家官网) └ zero_purchase Boolean true 在返回的trade对象上专门增加一个字段zero_purchase来区分，这个为true的就是0元购机预授权交易 └ alipay_point Number 1 付款时使用的支付宝积分的额度,单位分，比如返回1，则为1分钱 └ pcc_af Number 1 天猫点券卡实付款金额,单位分 trade_ext TradeExt 交易扩展表信息 └ before_enable_flag Number 1 enable前扩展标识位 └ before_close_flag Number 1 关闭订单前扩展标识位 └ before_pay_flag Number 1 付款前扩展标识位 └ before_ship_flag Number 1 发货前扩展标识位 └ before_confirm_flag Number 1 确认收货前扩展标识位 └ before_rate_flag Number 1 评价前扩展标识位 └ before_refund_flag Number 1 退款前扩展标识位 └ before_modify_flag Number 1 修改前扩展标识位 └ third_party_status Number 1 第三方状态，第三方自由定义 └ extra_data String abc 第三方个性化数据 └ ext_attributes String abc attributes标记 └ order_tax_fee String 0 天猫国际官网直供主订单关税税费 └ et_ser_time String 2015-04-15 13:00 天猫汽车服务预约时间 └ et_shop_name String 接口测试新增门店_0304055043555 电子凭证预约门店地址 └ et_verified_shop_name String 测试核销门店地址电子凭证核销门店地址 └ et_plate_number String 浙A11111 车牌号码 └ o2o_snatch_status String 1 抢单状态 0,未处理待分发;1,抢单中;2,已抢单;3,已发货;-1,超时;-2,处理异常;-3,匹配失败;-4,取消抢单;-5,退款取消;-9,逻辑删除 └ is_sh_ship Boolean true 是否屏蔽发货 └ eticket_service_addr String 地址信息天猫电子凭证家装 └ et_type String bs_common 电子凭证扫码购-扫码支付订单type └ market String eticket 垂直市场 └ obs String 1 门店预约自提订单标 └ et_shop_id Number 66749068 扫码购关联门店 └ paid_coupon_fee String 10.00 满返红包的金额；如果没有满返红包，则值为 0.00 └ shop_pick String 1 线下门店自提 └ rx_audit_status String 0 处方药审核状态 └ es_date String 直接下单预计时间 yyyyMMdd └ es_range String 直接下单预计时间 hh:mm-hh:mm └ os_date String 预约下单时间 yyyyMMdd └ os_range String 预约下单时间 hh:mm-hh:mm └ coupon_fee Number 使用红包付款金额 100 └ post_gate_declare Boolean true 邮关订单 └ cross_bonded_declare Boolean true 跨境订单 └ trade_attr String {\"payCurrency\":\"HKD\"} 主订单扩展属性;payCurrency:HKD(港币)、TWD(台币) └ top_hold Number 0 TOP拦截标识，0不拦截，1拦截 └ omni_attr String {} 星盘标识字段 └ omni_param String {} 星盘业务字段 └ assembly String 1 assembly └ forbid_consign Number 1 聚划算一起买字段 └ identity String EPP 采购订单标识 └ team_buy_hold Number 1 天猫拼团拦截标示 └ share_group_hold Number 1 分享购拦截 └ ofp_hold Number 1 天猫国际拦截 └ o2o_step_trade_detail String 3_1_100_paid 组装O2O多阶段尾款订单的明细数据总阶段数，当前阶数，阶段金额（单位：分），支付状态，例如 3_1_100_paid ; 3_2_2000_nopaid └ o2o_step_order_id String 2505550397798727 特权定金订单的尾款订单ID └ o2o_et_order_id String 2505550397798727 分阶段订单的特权定金订单ID └ o2o_voucher_price String 1000 分阶段订单的特权定金抵扣金额，单位：分 └ order_tax_promotion_fee String 0 天猫国际计税优惠金额 └ delay_create_delivery Number 1 聚划算火拼标记 └ tid_str String 123 tidStr └ toptype Number 1 top定义订单类型 └ service_type String timedd,jiaju 包含的交易服务类型 └ o2o_service_mobile String 17802118895 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 杭州市余杭区文一西路969号 o2oServiceAddress └ o2o_step_trade_detail_new String bizType:分阶段付款交易,orderPayChannel:支付宝在线支付,subOrderPayTime:step 0: payTime Sun Jul 30 17:08:50 CST 2017 step 1: payTime Sat Aug 05 04:07:14 CST 2017 ,totalStep:2,currStep:2,fee:60300,payStatus:paid o2oStepTradeDetailNew └ o2o_xiaopiao String 123 o2oXiaopiao └ o2o_contract String 3213 o2oContract └ recharge_fee String 100 rechargeFee └ retail_store_code String 123 retailStoreCode └ retail_out_order_id String 123 retailOutOrderId └ platform_subsidy_fee String 100.00 platformSubsidyFee └ nr_offline String 1 nrOffline └ wtt_param String json格式网厅订单垂直表信息 logistics_infos LogisticsInfo [] 子单物流发货信息 └ trade_id Number 1100070860172581613 主交易号 └ sub_trade_id Number 1100070860173581613 子交易号 └ item_id String 2323232 货品仓储id └ item_code String 323232 货品仓储code └ need_consign_num Number 5 应发数量 └ store_code String 2223 如是菜鸟仓，则将菜鸟仓的区域仓code进行填充，如是商家仓发货则填充SC └ type String 00 子订单类型:标示该子交易单来源交易，还是BMS增加的，枚举值(00=交易，10=BMS绑定) └ sku_id String 213 商品的最小库存单位Sku的id └ num_iid Number 12222 商品数字编号 └ consign_type String cn 发货类型 CN=菜鸟发货,SC的商家仓发货 └ seller_nick String 我在测试 sellerNick └ buyer_nick String 我在测试 buyerNick └ omnichannel_param String orderState:X_SHOP_HANDLED,orderType:STORE_DELIVER,acceptExpirationTime:2016-09-05 23:41:59,targetCode:34510274,allocationCode:339001,subOrderCode:194497830335000,targetType:STORE; 全渠道订单相关字段 └ real_receiver_open_id String AAEnVKOdAOIduo9TH9hjf-zb 收件人淘宝加密openId └ real_receiver_display_nick String 这是一个昵称收件人淘宝加密昵称 └ post_fee_type String giftprepaid 邮费类型，giftprepaid代表送礼玩法预付，normal代表订单buyer付款邮费或平台包邮订单 └ real_post_fee String 11 实际邮费，单位：分，没有发生邮费退款不返回该字段 └ refund_post_fee String 8 邮费退款金额，单位：分，没有发生邮费退款不返回该字段 └ gift_post_fee_role String 0 送礼邮费支付角色，0为送礼人支付邮费，1为收礼人支付邮费，免邮场景、平台补贴邮费场景不返回该字段

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradeFullinfoGetCustomizationRequest req = new TradeFullinfoGetCustomizationRequest();
req.setFields("tid,type,status,payment,orders");
req.setTid(123456789L);
TradeFullinfoGetCustomizationResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TradeFullinfoGetCustomizationRequest req = new TradeFullinfoGetCustomizationRequest();
req.Fields = "tid,type,status,payment,orders";
req.Tid = 123456789L;
TradeFullinfoGetCustomizationResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TradeFullinfoGetCustomizationRequest;
$req->setFields("tid,type,status,payment,orders");
$req->setTid("123456789");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.trade.fullinfo.get.customization' \
-d 'partner_id=apidoc' \
-d 'session=37da77df-8eb3-4b7c-a3a0-5e7ee7b467a6' \
-d 'sign=7267A236C86A37C28EF781281A31C054' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-13+15%3A37%3A41' \
-d 'v=2.0' \
-d 'fields=tid%2Ctype%2Cstatus%2Cpayment%2Corders' \
-d 'tid=123456789'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TradeFullinfoGetCustomizationRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.fields="tid,type,status,payment,orders"
req.tid=123456789
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.trade.fullinfo.get.customization");
add_param(pRequest,"fields","tid,type,status,payment,orders");
add_param(pRequest,"tid","123456789");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.trade.fullinfo.get.customization', {
	'fields':'tid,type,status,payment,orders',
	'tid':'123456789'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<trade_fullinfo_get_customization_response>
    <trade>
        <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
        <title>麦包包</title>
        <type>fixed(一口价)</type>
        <created>2000-01-01 00:00:00</created>
        <sid>NP1021246146</sid>
        <tid>2231958349</tid>
        <acookie_id>1a11a0987628772c002ec7d0eec2a352</acookie_id>
        <seller_rate>true</seller_rate>
        <buyer_rate>true</buyer_rate>
        <status>TRADE_NO_CREATE_PAY</status>
        <payment>200.07</payment>
        <discount_fee>200.07</discount_fee>
        <adjust_fee>200.07</adjust_fee>
        <post_fee>200.07</post_fee>
        <total_fee>200.07</total_fee>
        <pay_time>2000-01-01 00:00:00</pay_time>
        <end_time>2000-01-01 00:00:00</end_time>
        <modified>2000-01-01 00:00:00</modified>
        <consign_time>2000-01-01 00:00:00</consign_time>
        <received_payment>200.07</received_payment>
        <commission_fee>200.07</commission_fee>
        <buyer_memo>上衣要大一号</buyer_memo>
        <seller_memo>好的</seller_memo>
        <buyer_area>浙江省杭州市</buyer_area>
        <alipay_no>2009112081173831</alipay_no>
        <buyer_message>要送的礼物的，不要忘记的哦</buyer_message>
        <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
        <num_iid>3424234</num_iid>
        <price>200.07</price>
        <cod_fee>12.07</cod_fee>
        <cod_status>EW_CREATED(订单已创建)</cod_status>
        <buyer_cod_fee>12.07</buyer_cod_fee>
        <seller_cod_fee>12.07</seller_cod_fee>
        <express_agency_fee>212.07</express_agency_fee>
        <shipping_type>free</shipping_type>
        <num>1</num>
        <point_fee>0</point_fee>
        <real_point_fee>0</real_point_fee>
        <buyer_obtain_point_fee>0</buyer_obtain_point_fee>
        <buyer_alipay_no>tbtest1063@taobaotest.com</buyer_alipay_no>
        <receiver_name>东方不败</receiver_name>
        <receiver_country>中国</receiver_country>
        <receiver_state>浙江省</receiver_state>
        <receiver_city>杭州市</receiver_city>
        <receiver_district>西湖区</receiver_district>
        <receiver_town>三墎镇</receiver_town>
        <receiver_address>淘宝城911号</receiver_address>
        <receiver_zip>223700</receiver_zip>
        <receiver_mobile>13512501826</receiver_mobile>
        <receiver_phone>13819175372</receiver_phone>
        <buyer_email>tbtest1064@taobaotest.com</buyer_email>
        <seller_alipay_no>tbtest1063@taobaotest.com</seller_alipay_no>
        <seller_mobile>13512501826</seller_mobile>
        <seller_phone>13512501826</seller_phone>
        <seller_name>我在测试</seller_name>
        <seller_email>tbtest1063@taobaotest.com</seller_email>
        <available_confirm_fee>200.07</available_confirm_fee>
        <has_post_fee>true</has_post_fee>
        <timeout_action_time>2000-01-01 00:00:00</timeout_action_time>
        <snapshot_url>T1mURbXopZXXXe3rLI.1257513712679_snap</snapshot_url>
        <trade_memo>这是一次成功的交易</trade_memo>
        <promotion>hello world</promotion>
        <is_3D>true</is_3D>
        <is_lgtype>true</is_lgtype>
        <is_brand_sale>true</is_brand_sale>
        <is_force_wlb>true</is_force_wlb>
        <buyer_flag>1</buyer_flag>
        <seller_flag>1</seller_flag>
        <credit_card_fee>30.5</credit_card_fee>
        <step_trade_status>FRONT_NOPAID_FINAL_NOPAID</step_trade_status>
        <step_paid_fee>525.70</step_paid_fee>
        <eticket_ext>525.70</eticket_ext>
        <mark_desc>该订单需要延长收货时间</mark_desc>
        <has_yfx>true</has_yfx>
        <yfx_fee>0.50</yfx_fee>
        <yfx_id>135751716473138</yfx_id>
        <yfx_type>taojinbi</yfx_type>
        <send_time>2000-01-01</send_time>
        <can_rate>true</can_rate>
        <seller_can_rate>true</seller_can_rate>
        <is_part_consign>true</is_part_consign>
        <is_daixiao>true</is_daixiao>
        <is_wt>true</is_wt>
        <arrive_interval>1</arrive_interval>
        <arrive_cut_time>16:00</arrive_cut_time>
        <consign_interval>48</consign_interval>
        <o2o>crm</o2o>
        <o2o_guide_id>123456</o2o_guide_id>
        <o2o_guide_name>西湖门店导购员1</o2o_guide_name>
        <o2o_shop_id>123456</o2o_shop_id>
        <o2o_shop_name>西湖门店</o2o_shop_name>
        <o2o_delivery>inshop</o2o_delivery>
        <o2o_out_trade_id>123456</o2o_out_trade_id>
        <shop_code>demo</shop_code>
        <hk_en_name>chenxiao</hk_en_name>
        <hk_flight_no>GZ0022</hk_flight_no>
        <hk_china_name>陈小</hk_china_name>
        <hk_card_code>G0000000001</hk_card_code>
        <hk_card_type>证件类型</hk_card_type>
        <hk_flight_date>2014-12-01 15:50</hk_flight_date>
        <hk_gender>M</hk_gender>
        <hk_birthday>1988-01-12</hk_birthday>
        <hk_pickup>某地点</hk_pickup>
        <hk_pickup_id>3</hk_pickup_id>
        <est_con_time>付款后30天内</est_con_time>
        <invoice_kind>1</invoice_kind>
        <orders>
            <order>
                <title>山寨版测试机器</title>
                <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
                <price>200.07</price>
                <num_iid>2342344</num_iid>
                <sku_id>5937146</sku_id>
                <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
                <outer_sku_id>81893848</outer_sku_id>
                <refund_status>SUCCESS(退款成功)</refund_status>
                <status>TRADE_NO_CREATE_PAY</status>
                <oid>2231958349</oid>
                <total_fee>200.07</total_fee>
                <payment>200.07</payment>
                <discount_fee>200.07</discount_fee>
                <adjust_fee>1.01</adjust_fee>
                <divide_order_fee>21.00</divide_order_fee>
                <part_mjz_discount>21.00</part_mjz_discount>
                <sku_properties_name>颜色:桔色;尺码:M</sku_properties_name>
                <item_meal_id>2564854632</item_meal_id>
                <item_meal_name>M8原装电池:便携支架:M8专用座充:莫凡保护袋</item_meal_name>
                <num>1</num>
                <snapshot_url>T1mURbXopZXXXe3rLI.1257513712679_snap</snapshot_url>
                <timeout_action_time>2000-01-01 00:00:00</timeout_action_time>
                <item_memo>这是商品备注</item_memo>
                <buyer_rate>true</buyer_rate>
                <seller_rate>true</seller_rate>
                <refund_id>2231958349</refund_id>
                <seller_type>B（商城商家）</seller_type>
                <cid>123456</cid>
                <is_oversold>true</is_oversold>
                <end_time>2012-04-07 00:00:00</end_time>
                <order_from>jhs</order_from>
                <is_service_order>true</is_service_order>
                <consign_time>2013-01-13 15:23:00</consign_time>
                <shipping_type>post</shipping_type>
                <logistics_company>顺风快递</logistics_company>
                <invoice_no>05432465</invoice_no>
                <bind_oid>23194074143138</bind_oid>
                <is_daixiao>true</is_daixiao>
                <ticket_outer_id>123456abcd</ticket_outer_id>
                <ticket_expdate_key>100FFFFFF02374020000002001020304000A</ticket_expdate_key>
                <is_www>true</is_www>
                <store_code>南京QDHEWL-0004</store_code>
                <tmser_spu_code>家装干支装服务</tmser_spu_code>
                <sub_order_tax_fee>0</sub_order_tax_fee>
                <sub_order_tax_rate>0</sub_order_tax_rate>
                <et_ser_time>2015-04-15 13:00</et_ser_time>
                <et_shop_name>测试预约门店地址</et_shop_name>
                <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
                <et_plate_number>浙A11111</et_plate_number>
                <estimate_con_time>demo</estimate_con_time>
                <bind_oids>193741211090019,193741211080019</bind_oids>
                <zhengji_status>1</zhengji_status>
                <md_qualification>true_免单原因</md_qualification>
                <md_fee>999</md_fee>
                <customization>{   &quot;itemId&quot;: 123,   &quot;skuId&quot;: 123,   &quot;text&quot;: [     {       &quot;id&quot;: 44,       &quot;content&quot;: &quot;home&quot;     }   ],   &quot;pic&quot;: [     {       &quot;id&quot;: 44,       &quot;url&quot;: &quot;sn&quot;     }   ] ,&quot;dingzhi&quot;:&quot;;pluginId:182;dingzhiId:157886;&quot;}</customization>
                <inv_type>6</inv_type>
                <is_sh_ship>true</is_sh_ship>
                <shipper>cn</shipper>
                <f_type>jsd</f_type>
                <f_status>分单完成</f_status>
                <f_term>storeId</f_term>
                <combo_id>1923423423</combo_id>
                <order_attr>{}</order_attr>
                <assembly_rela>123123</assembly_rela>
                <assembly_price>123123123</assembly_price>
                <assembly_item>123,456</assembly_item>
                <sub_order_tax_promotion_fee>0</sub_order_tax_promotion_fee>
                <down_payment>1000</down_payment>
                <down_payment_ratio>1000</down_payment_ratio>
                <month_payment>1000</month_payment>
                <tail_payment>1000</tail_payment>
                <installment_num>1000</installment_num>
                <penalty>1000</penalty>
                <service_fee>1000</service_fee>
                <car_taker>1000</car_taker>
                <car_taker_phone>1000</car_taker_phone>
                <car_taker_id>1000</car_taker_id>
                <car_store_code>1000</car_store_code>
                <car_store_name>1000</car_store_name>
                <out_unique_id>1000</out_unique_id>
                <ws_bank_apply_no>1000</ws_bank_apply_no>
                <oid_str>123</oid_str>
                <fqg_num>12</fqg_num>
                <is_fqg_s_fee>true</is_fqg_s_fee>
                <tax_free>true</tax_free>
                <tax_coupon_discount>0</tax_coupon_discount>
                <nr_reduce_inv_fail>1</nr_reduce_inv_fail>
            </order>
        </orders>
        <promotion_details>
            <promotion_detail>
                <id>22331764490705</id>
                <promotion_name>满就减钱</promotion_name>
                <discount_fee>10.00</discount_fee>
                <gift_item_name>晨光签字笔</gift_item_name>
                <gift_item_id>13233791195</gift_item_id>
                <gift_item_num>1</gift_item_num>
                <promotion_desc>双11促销，满就送</promotion_desc>
                <promotion_id>mjs</promotion_id>
            </promotion_detail>
        </promotion_details>
        <service_tags>
            <logistics_tag>
                <order_id>123456</order_id>
                <logistic_service_tag_list>
                    <logistic_service_tag>
                        <service_tag>comFee=1211;comTim=1;companyCode=SF;</service_tag>
                        <service_type>FAST</service_type>
                    </logistic_service_tag>
                </logistic_service_tag_list>
            </logistics_tag>
        </service_tags>
        <service_orders>
            <service_order>
                <oid>110770592823138</oid>
                <item_oid>110770592803138</item_oid>
                <service_id>2342344</service_id>
                <service_detail_url>http://wt.taobao.com/plan.htm?plan_id=planId</service_detail_url>
                <num>1</num>
                <price>39.09</price>
                <payment>29.98</payment>
                <title>滚筒洗衣机</title>
                <total_fee>39.09</total_fee>
                <buyer_nick>小倩2005</buyer_nick>
                <refund_id>2231958349</refund_id>
                <seller_nick>麦包包</seller_nick>
                <pic_path>http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg</pic_path>
                <tmser_spu_code>家装干支装服务</tmser_spu_code>
                <et_ser_time>2015-04-15 13:00</et_ser_time>
                <et_shop_name>测试预约门店地址</et_shop_name>
                <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
                <et_plate_number>浙A11111</et_plate_number>
                <oid_str>110770592823138</oid_str>
            </service_order>
        </service_orders>
        <invoice_name>淘宝</invoice_name>
        <invoice_type>水果，图书</invoice_type>
        <trade_from>WAP,JHS</trade_from>
        <trade_source>ownshop</trade_source>
        <zero_purchase>true</zero_purchase>
        <alipay_point>1</alipay_point>
        <pcc_af>1</pcc_af>
        <trade_ext>
            <before_enable_flag>1</before_enable_flag>
            <before_close_flag>1</before_close_flag>
            <before_pay_flag>1</before_pay_flag>
            <before_ship_flag>1</before_ship_flag>
            <before_confirm_flag>1</before_confirm_flag>
            <before_rate_flag>1</before_rate_flag>
            <before_refund_flag>1</before_refund_flag>
            <before_modify_flag>1</before_modify_flag>
            <third_party_status>1</third_party_status>
            <extra_data>abc</extra_data>
            <ext_attributes>abc</ext_attributes>
        </trade_ext>
        <order_tax_fee>0</order_tax_fee>
        <et_ser_time>2015-04-15 13:00</et_ser_time>
        <et_shop_name>接口测试新增门店_0304055043555</et_shop_name>
        <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
        <et_plate_number>浙A11111</et_plate_number>
        <o2o_snatch_status>1</o2o_snatch_status>
        <is_sh_ship>true</is_sh_ship>
        <eticket_service_addr>地址信息</eticket_service_addr>
        <et_type>bs_common</et_type>
        <market>eticket</market>
        <obs>1</obs>
        <et_shop_id>66749068</et_shop_id>
        <paid_coupon_fee>10.00</paid_coupon_fee>
        <shop_pick>1</shop_pick>
        <rx_audit_status>0</rx_audit_status>
        <es_date>直接下单预计时间</es_date>
        <es_range>直接下单预计时间</es_range>
        <os_date>预约下单时间</os_date>
        <os_range>预约下单时间</os_range>
        <coupon_fee>使用红包付款金额</coupon_fee>
        <post_gate_declare>true</post_gate_declare>
        <cross_bonded_declare>true</cross_bonded_declare>
        <trade_attr>{\&quot;payCurrency\&quot;:\&quot;HKD\&quot;}</trade_attr>
        <top_hold>0</top_hold>
        <omni_attr>{}</omni_attr>
        <omni_param>{}</omni_param>
        <assembly>1</assembly>
        <forbid_consign>1</forbid_consign>
        <identity>EPP</identity>
        <team_buy_hold>1</team_buy_hold>
        <share_group_hold>1</share_group_hold>
        <ofp_hold>1</ofp_hold>
        <o2o_step_trade_detail>3_1_100_paid</o2o_step_trade_detail>
        <o2o_step_order_id>2505550397798727</o2o_step_order_id>
        <o2o_et_order_id>2505550397798727</o2o_et_order_id>
        <o2o_voucher_price>1000</o2o_voucher_price>
        <order_tax_promotion_fee>0</order_tax_promotion_fee>
        <delay_create_delivery>1</delay_create_delivery>
        <tid_str>123</tid_str>
        <toptype>1</toptype>
        <service_type>timedd,jiaju</service_type>
        <o2o_service_mobile>17802118895</o2o_service_mobile>
        <o2o_service_name>衍一</o2o_service_name>
        <o2o_service_state>浙江省</o2o_service_state>
        <o2o_service_city>杭州市</o2o_service_city>
        <o2o_service_district>余杭区</o2o_service_district>
        <o2o_service_town>五常街道</o2o_service_town>
        <o2o_service_address>杭州市余杭区文一西路969号</o2o_service_address>
        <o2o_step_trade_detail_new>bizType:分阶段付款交易,orderPayChannel:支付宝在线支付,subOrderPayTime:step 0: payTime Sun Jul 30 17:08:50 CST 2017    step 1: payTime Sat Aug 05 04:07:14 CST 2017    ,totalStep:2,currStep:2,fee:60300,payStatus:paid</o2o_step_trade_detail_new>
        <o2o_xiaopiao>123</o2o_xiaopiao>
        <o2o_contract>3213</o2o_contract>
        <recharge_fee>100</recharge_fee>
        <retail_store_code>123</retail_store_code>
        <retail_out_order_id>123</retail_out_order_id>
        <platform_subsidy_fee>100.00</platform_subsidy_fee>
        <nr_offline>1</nr_offline>
        <wtt_param>json格式</wtt_param>
        <logistics_infos>
            <logistics_info>
                <trade_id>1100070860172581613</trade_id>
                <sub_trade_id>1100070860173581613</sub_trade_id>
                <item_id>2323232</item_id>
                <item_code>323232</item_code>
                <need_consign_num>5</need_consign_num>
                <store_code>2223</store_code>
                <type>00</type>
                <sku_id>213</sku_id>
                <num_iid>12222</num_iid>
                <consign_type>cn</consign_type>
            </logistics_info>
        </logistics_infos>
        <seller_nick>我在测试</seller_nick>
        <buyer_nick>我在测试</buyer_nick>
        <omnichannel_param>orderState:X_SHOP_HANDLED,orderType:STORE_DELIVER,acceptExpirationTime:2016-09-05 23:41:59,targetCode:34510274,allocationCode:339001,subOrderCode:194497830335000,targetType:STORE;</omnichannel_param>
        <real_receiver_open_id>AAEnVKOdAOIduo9TH9hjf-zb</real_receiver_open_id>
        <real_receiver_display_nick>这是一个昵称</real_receiver_display_nick>
        <post_fee_type>giftprepaid</post_fee_type>
        <real_post_fee>11</real_post_fee>
        <refund_post_fee>8</refund_post_fee>
        <gift_post_fee_role>0</gift_post_fee_role>
    </trade>
</trade_fullinfo_get_customization_response>

{
    "trade_fullinfo_get_customization_response":{
        "trade":{
            "buyer_open_uid":"AAHk5d-EAAeGwJedwSFu0XXX",
            "title":"麦包包",
            "type":"fixed(一口价)",
            "created":"2000-01-01 00:00:00",
            "sid":"NP1021246146",
            "tid":2231958349,
            "acookie_id":"1a11a0987628772c002ec7d0eec2a352",
            "seller_rate":true,
            "buyer_rate":true,
            "status":"TRADE_NO_CREATE_PAY",
            "payment":"200.07",
            "discount_fee":"200.07",
            "adjust_fee":"200.07",
            "post_fee":"200.07",
            "total_fee":"200.07",
            "pay_time":"2000-01-01 00:00:00",
            "end_time":"2000-01-01 00:00:00",
            "modified":"2000-01-01 00:00:00",
            "consign_time":"2000-01-01 00:00:00",
            "received_payment":"200.07",
            "commission_fee":"200.07",
            "buyer_memo":"上衣要大一号",
            "seller_memo":"好的",
            "buyer_area":"浙江省杭州市",
            "alipay_no":"2009112081173831",
            "buyer_message":"要送的礼物的，不要忘记的哦",
            "pic_path":"http:\/\/img08.taobao.net\/bao\/uploaded\/i8\/T1jVXXXePbXXaoPB6a_091917.jpg",
            "num_iid":3424234,
            "price":"200.07",
            "cod_fee":"12.07",
            "cod_status":"EW_CREATED(订单已创建)",
            "buyer_cod_fee":"12.07",
            "seller_cod_fee":"12.07",
            "express_agency_fee":"212.07",
            "shipping_type":"free",
            "num":1,
            "point_fee":0,
            "real_point_fee":0,
            "buyer_obtain_point_fee":0,
            "buyer_alipay_no":"tbtest1063@taobaotest.com",
            "receiver_name":"东方不败",
            "receiver_country":"中国",
            "receiver_state":"浙江省",
            "receiver_city":"杭州市",
            "receiver_district":"西湖区",
            "receiver_town":"三墎镇",
            "receiver_address":"淘宝城911号",
            "receiver_zip":"223700",
            "receiver_mobile":"13512501826",
            "receiver_phone":"13819175372",
            "buyer_email":"tbtest1064@taobaotest.com",
            "seller_alipay_no":"tbtest1063@taobaotest.com",
            "seller_mobile":"13512501826",
            "seller_phone":"13512501826",
            "seller_name":"我在测试",
            "seller_email":"tbtest1063@taobaotest.com",
            "available_confirm_fee":"200.07",
            "has_post_fee":true,
            "timeout_action_time":"2000-01-01 00:00:00",
            "snapshot_url":"T1mURbXopZXXXe3rLI.1257513712679_snap",
            "trade_memo":"这是一次成功的交易",
            "promotion":"hello world",
            "is_3D":true,
            "is_lgtype":true,
            "is_brand_sale":true,
            "is_force_wlb":true,
            "buyer_flag":1,
            "seller_flag":1,
            "credit_card_fee":"30.5",
            "step_trade_status":"FRONT_NOPAID_FINAL_NOPAID",
            "step_paid_fee":"525.70",
            "eticket_ext":"525.70",
            "mark_desc":"该订单需要延长收货时间",
            "has_yfx":true,
            "yfx_fee":"0.50",
            "yfx_id":"135751716473138",
            "yfx_type":"taojinbi",
            "send_time":"2000-01-01",
            "can_rate":true,
            "seller_can_rate":true,
            "is_part_consign":true,
            "is_daixiao":true,
            "is_wt":true,
            "arrive_interval":1,
            "arrive_cut_time":"16:00",
            "consign_interval":48,
            "o2o":"crm",
            "o2o_guide_id":"123456",
            "o2o_guide_name":"西湖门店导购员1",
            "o2o_shop_id":"123456",
            "o2o_shop_name":"西湖门店",
            "o2o_delivery":"inshop",
            "o2o_out_trade_id":"123456",
            "shop_code":"demo",
            "hk_en_name":"chenxiao",
            "hk_flight_no":"GZ0022",
            "hk_china_name":"陈小",
            "hk_card_code":"G0000000001",
            "hk_card_type":"证件类型",
            "hk_flight_date":"2014-12-01 15:50",
            "hk_gender":"M",
            "hk_birthday":"1988-01-12",
            "hk_pickup":"某地点",
            "hk_pickup_id":"3",
            "est_con_time":"付款后30天内",
            "invoice_kind":"1",
            "orders":{
                "order":[
                    {
                        "title":"山寨版测试机器",
                        "pic_path":"http:\/\/img08.taobao.net\/bao\/uploaded\/i8\/T1jVXXXePbXXaoPB6a_091917.jpg",
                        "price":"200.07",
                        "num_iid":2342344,
                        "sku_id":"5937146",
                        "outer_iid":"152e442aefe88dd41cb0879232c0dcb0",
                        "outer_sku_id":"81893848",
                        "refund_status":"SUCCESS(退款成功)",
                        "status":"TRADE_NO_CREATE_PAY",
                        "oid":2231958349,
                        "total_fee":"200.07",
                        "payment":"200.07",
                        "discount_fee":"200.07",
                        "adjust_fee":"1.01",
                        "divide_order_fee":"21.00",
                        "part_mjz_discount":"21.00",
                        "sku_properties_name":"颜色:桔色;尺码:M",
                        "item_meal_id":2564854632,
                        "item_meal_name":"M8原装电池:便携支架:M8专用座充:莫凡保护袋",
                        "num":1,
                        "snapshot_url":"T1mURbXopZXXXe3rLI.1257513712679_snap",
                        "timeout_action_time":"2000-01-01 00:00:00",
                        "item_memo":"这是商品备注",
                        "buyer_rate":true,
                        "seller_rate":true,
                        "refund_id":"2231958349",
                        "seller_type":"B（商城商家）",
                        "cid":123456,
                        "is_oversold":true,
                        "end_time":"2012-04-07 00:00:00",
                        "order_from":"jhs",
                        "is_service_order":true,
                        "consign_time":"2013-01-13 15:23:00",
                        "shipping_type":"post",
                        "logistics_company":"顺风快递",
                        "invoice_no":"05432465",
                        "bind_oid":23194074143138,
                        "is_daixiao":true,
                        "ticket_outer_id":"123456abcd",
                        "ticket_expdate_key":"100FFFFFF02374020000002001020304000A",
                        "is_www":true,
                        "store_code":"南京QDHEWL-0004",
                        "tmser_spu_code":"家装干支装服务",
                        "sub_order_tax_fee":"0",
                        "sub_order_tax_rate":"0",
                        "et_ser_time":"2015-04-15 13:00",
                        "et_shop_name":"测试预约门店地址",
                        "et_verified_shop_name":"测试核销门店地址",
                        "et_plate_number":"浙A11111",
                        "estimate_con_time":"demo",
                        "bind_oids":"193741211090019,193741211080019",
                        "zhengji_status":"1",
                        "md_qualification":"true_免单原因",
                        "md_fee":"999",
                        "customization":"{   \"itemId\": 123,   \"skuId\": 123,   \"text\": [     {       \"id\": 44,       \"content\": \"home\"     }   ],   \"pic\": [     {       \"id\": 44,       \"url\": \"sn\"     }   ] ,\"dingzhi\":\";pluginId:182;dingzhiId:157886;\"}",
                        "inv_type":"6",
                        "is_sh_ship":true,
                        "shipper":"cn",
                        "f_type":"jsd",
                        "f_status":"分单完成",
                        "f_term":"storeId",
                        "combo_id":"1923423423",
                        "order_attr":"{}",
                        "assembly_rela":"123123",
                        "assembly_price":"123123123",
                        "assembly_item":"123,456",
                        "sub_order_tax_promotion_fee":"0",
                        "down_payment":"1000",
                        "down_payment_ratio":"1000",
                        "month_payment":"1000",
                        "tail_payment":"1000",
                        "installment_num":"1000",
                        "penalty":"1000",
                        "service_fee":"1000",
                        "car_taker":"1000",
                        "car_taker_phone":"1000",
                        "car_taker_id":"1000",
                        "car_store_code":"1000",
                        "car_store_name":"1000",
                        "out_unique_id":"1000",
                        "ws_bank_apply_no":"1000",
                        "oid_str":"123",
                        "fqg_num":12,
                        "is_fqg_s_fee":true,
                        "tax_free":true,
                        "tax_coupon_discount":"0",
                        "nr_reduce_inv_fail":"1"
                    }
                ]
            },
            "promotion_details":{
                "promotion_detail":[
                    {
                        "id":22331764490705,
                        "promotion_name":"满就减钱",
                        "discount_fee":"10.00",
                        "gift_item_name":"晨光签字笔",
                        "gift_item_id":"13233791195",
                        "gift_item_num":"1",
                        "promotion_desc":"双11促销，满就送",
                        "promotion_id":"mjs"
                    }
                ]
            },
            "service_tags":{
                "logistics_tag":[
                    {
                        "order_id":"123456",
                        "logistic_service_tag_list":{
                            "logistic_service_tag":[
                                {
                                    "service_tag":"comFee=1211;comTim=1;companyCode=SF;",
                                    "service_type":"FAST"
                                }
                            ]
                        }
                    }
                ]
            },
            "service_orders":{
                "service_order":[
                    {
                        "oid":110770592823138,
                        "item_oid":110770592803138,
                        "service_id":2342344,
                        "service_detail_url":"http:\/\/wt.taobao.com\/plan.htm?plan_id=planId",
                        "num":1,
                        "price":"39.09",
                        "payment":"29.98",
                        "title":"滚筒洗衣机",
                        "total_fee":"39.09",
                        "buyer_nick":"小倩2005",
                        "refund_id":"2231958349",
                        "seller_nick":"麦包包",
                        "pic_path":"http:\/\/img08.taobao.com\/bao\/upload\/i8\/T1jVXXXePb_a0908.jpg",
                        "tmser_spu_code":"家装干支装服务",
                        "et_ser_time":"2015-04-15 13:00",
                        "et_shop_name":"测试预约门店地址",
                        "et_verified_shop_name":"测试核销门店地址",
                        "et_plate_number":"浙A11111",
                        "oid_str":"110770592823138"
                    }
                ]
            },
            "invoice_name":"淘宝",
            "invoice_type":"水果，图书",
            "trade_from":"WAP,JHS",
            "trade_source":"ownshop",
            "zero_purchase":true,
            "alipay_point":1,
            "pcc_af":1,
            "trade_ext":{
                "before_enable_flag":1,
                "before_close_flag":1,
                "before_pay_flag":1,
                "before_ship_flag":1,
                "before_confirm_flag":1,
                "before_rate_flag":1,
                "before_refund_flag":1,
                "before_modify_flag":1,
                "third_party_status":1,
                "extra_data":"abc",
                "ext_attributes":"abc"
            },
            "order_tax_fee":"0",
            "et_ser_time":"2015-04-15 13:00",
            "et_shop_name":"接口测试新增门店_0304055043555",
            "et_verified_shop_name":"测试核销门店地址",
            "et_plate_number":"浙A11111",
            "o2o_snatch_status":"1",
            "is_sh_ship":true,
            "eticket_service_addr":"地址信息",
            "et_type":"bs_common",
            "market":"eticket",
            "obs":"1",
            "et_shop_id":66749068,
            "paid_coupon_fee":"10.00",
            "shop_pick":"1",
            "rx_audit_status":"0",
            "es_date":"直接下单预计时间",
            "es_range":"直接下单预计时间",
            "os_date":"预约下单时间",
            "os_range":"预约下单时间",
            "coupon_fee":使用红包付款金额,
            "post_gate_declare":true,
            "cross_bonded_declare":true,
            "trade_attr":"{\\\"payCurrency\\\":\\\"HKD\\\"}",
            "top_hold":0,
            "omni_attr":"{}",
            "omni_param":"{}",
            "assembly":"1",
            "forbid_consign":1,
            "identity":"EPP",
            "team_buy_hold":1,
            "share_group_hold":1,
            "ofp_hold":1,
            "o2o_step_trade_detail":"3_1_100_paid",
            "o2o_step_order_id":"2505550397798727",
            "o2o_et_order_id":"2505550397798727",
            "o2o_voucher_price":"1000",
            "order_tax_promotion_fee":"0",
            "delay_create_delivery":1,
            "tid_str":"123",
            "toptype":1,
            "service_type":"timedd,jiaju",
            "o2o_service_mobile":"17802118895",
            "o2o_service_name":"衍一",
            "o2o_service_state":"浙江省",
            "o2o_service_city":"杭州市",
            "o2o_service_district":"余杭区",
            "o2o_service_town":"五常街道",
            "o2o_service_address":"杭州市余杭区文一西路969号",
            "o2o_step_trade_detail_new":"bizType:分阶段付款交易,orderPayChannel:支付宝在线支付,subOrderPayTime:step 0: payTime Sun Jul 30 17:08:50 CST 2017    step 1: payTime Sat Aug 05 04:07:14 CST 2017    ,totalStep:2,currStep:2,fee:60300,payStatus:paid",
            "o2o_xiaopiao":"123",
            "o2o_contract":"3213",
            "recharge_fee":"100",
            "retail_store_code":"123",
            "retail_out_order_id":"123",
            "platform_subsidy_fee":"100.00",
            "nr_offline":"1",
            "wtt_param":"json格式",
            "logistics_infos":{
                "logistics_info":[
                    {
                        "trade_id":1100070860172581613,
                        "sub_trade_id":1100070860173581613,
                        "item_id":"2323232",
                        "item_code":"323232",
                        "need_consign_num":5,
                        "store_code":"2223",
                        "type":"00",
                        "sku_id":"213",
                        "num_iid":12222,
                        "consign_type":"cn"
                    }
                ]
            },
            "seller_nick":"我在测试",
            "buyer_nick":"我在测试",
            "omnichannel_param":"orderState:X_SHOP_HANDLED,orderType:STORE_DELIVER,acceptExpirationTime:2016-09-05 23:41:59,targetCode:34510274,allocationCode:339001,subOrderCode:194497830335000,targetType:STORE;",
            "real_receiver_open_id":"AAEnVKOdAOIduo9TH9hjf-zb",
            "real_receiver_display_nick":"这是一个昵称",
            "post_fee_type":"giftprepaid",
            "real_post_fee":"11",
            "refund_post_fee":"8",
            "gift_post_fee_role":"0"
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isv.invalid-permission	必须是此交易的买家或卖家才能获取交易详细信息	保证传入的订单ID和卖家SessionKey信息是一致的
isv.trade-not-exist	交易不存在	订单已进入历史库，不再提供实时查询，出现此错误请清除本地数据库该订单，不要重试
isv.invalid-parameter:tid	订单ID不存在，或者使用了子订单ID来查询	请填写正确的订单ID，或使用主订单ID来查询
isv.trade-service-access-frequency	交易慢查询访问太频繁	缩短查询订单的时间范围，减少超时查询的次数，或者等待一段时间后再来查询
isp.trade-service-degrade	单位时间内慢查询过多，服务被降级	请稍后重试。
isp.commission-service-unavailable	佣金服务不可用	重试
isp.trade-service-unavailable	交易服务不可用	适当重试
isp.trade-service-failed	服务不可用	重试
isp.call-limited	交易服务限流	请稍后重试
isp.remote-connection-error	交易服务连接依赖的远程服务错误	请稍后重试
isp.remote-service-timeout	交易服务处理超时	请稍后重试
isv.invalid-parameter	请求参数有误	请传入正确的参数
isv.astrolabe-trade-closured	门店发货拦截订单	重试
isp.contextPrepareError	交易服务不可用	重试
isv.trade-hold	订单已经被星盘拦截	对接星盘发货系统
isp.processError	???	???
isp.filterError	???	???
isp.syncLockError	???	???
isp.processCatchError	???	???

API测试工具错误码查询工具 SDK下载

交易API

taobao.trade.fullinfo.get.customization (获取单笔交易业务定制的详细信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ