交易结构
交易结构
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| tid | String | 交易编号(交易ID) |
|
| title | String | 交易标题 |
|
| created | Date | 交易创建时间。格式:yyyy-MM-dd HH:mm:ss |
|
| tradetype | String | 交易类型。可选值：fixed(一口价) auction(拍卖) |
|
| status | String | 交易状态，可选值： TRADE_ACTIVE:交易处理中, TRADE_CLOSED:交易作废即交易关闭, TRADE_FINISHED:交易成功 |
|
| pay_status | String | 交易支付状态，可选值： PAY_NO:未付款, PAY_FINISH:已付款, PAY_TO_MEDIUM:付款至担保交易, PAY_PART:部分付款, REFUND_PART:部分退款, REFUND_ALL:全额退款 |
|
| ship_status | String | 交易物流状态，可选值： SHIP_NO:未发货, SHIP_PREPARE:配货中, SHIP_PART:部分发货, SHIP_FINISH:全部发货, RESHIP_PART:部分退货, RESHIP_ALL:全部退货 |
|
| has_invoice | Boolean | false | 是否开发票。可选值：true(开),false(不开)。默认不开 |
| invoice_title | String | 发票标题。如果要invoice为true,则此参数为必须 |
|
| invoice_desc | String | 发票内容。 |
|
| invoice_fee | String | 发票税金 |
|
| total_goods_fee | String | 商品总额(不包括配送费用) |
|
| total_trade_fee | String | 交易应付总额（包括商品价格 + 配送费用) |
|
| discount_fee | String | 手工调价的总和。把所有子订单的手工调价相加 |
|
| payed_fee | String | 已支付金额 |
|
| currency | String | CNY | 当前交易选择的货币类型。可选值：CNY（人民币），USD（美元），JPY（日元）。- 默认为CNY（人民币） |
| currency_rate | String | 当前货币汇率 |
|
| total_currency_fee | String | 当前货币订单总额 |
|
| buyer_obtain_point_fee | String | 买家获得积分,返点的积分。格式:100;单位:个 |
|
| point_fee | String | 买家使用积分。格式:100;单位:个 |
|
| total_weight | Number | 该笔交易中所有商品的总重量 |
|
| shipping_tid | String | 创建交易时的物流方式ID（交易完成前，物流方式有可改变） |
|
| shipping_type | String | 交易物流方式名称 |
|
| shipping_fee | String | 交易物流配送费用 |
|
| is_delivery | String | 是否实体配送。可选值:true(是),false(否) |
|
| is_cod | String | 是否货到付款。可选值:true(是),false(否) |
|
| is_protect | String | 是否保价（针对物流配送) |
|
| protect_fee | String | 保价费用（针对物流配送) |
|
| payment_tid | String | 支付方式ID |
|
| payment_type | String | 支付方式名称 |
|
| pay_time | Date | 付款时间。格式:yyyy-MM-dd HH:mm:ss |
|
| lastmodify | Date | 订单修改时间(用户对订单的操作会更新此字段)。格式:yyyy-MM-dd HH:mm:ss |
|
| end_time | Date | 交易成功时间(更新交易状态为成功的同时更新)/确认收货时间。格式:yyyy-MM-dd HH:mm:ss |
|
| confirm_time | Date | 订单确认时间。格式:yyyy-MM-dd HH:mm:ss |
|
| goods_discount_fee | String | 商品优惠金额 |
|
| orders_discount_fee | String | 订单优惠金额 |
|
| promotion_details | PromotionDetail | 详细优惠方案 |
|
| consign_time | Date | 卖家发货时间。 格式:yyyy-MM-dd HH:mm:ss |
|
| receiver_name | String | 收货人的姓名 |
|
| receiver_mobile | String | 收货人的手机号码 |
|
| receiver_email | String | 收货人email地址 |
|
| receiver_state | String | 收货人的所在省份 |
|
| receiver_city | String | 收货人的所在城市 |
|
| receiver_district | String | 收货人的所在地区 |
|
| receiver_address | String | 收货人的详细地址 |
|
| receiver_zip | String | 收货人的邮编 |
|
| receiver_phone | String | 收货人的电话号码 |
|
| receiver_time | String | 收货人要求到货时间 |
|
| commission_fee | String | 交易佣金。精确到2位小数;单位:元。如:200.07，表示:200元7分 |
|
| pay_cost | String | 支付手续费 |
|
| seller_rate | Boolean | 卖家是否已评价。可选值:true(已评价),false(未评价) |
|
| seller_uname | String | 卖家帐号 |
|
| seller_alipay_no | String | 卖家支付宝账号 |
|
| seller_mobile | String | 卖家手机 |
|
| seller_phone | String | 卖家电话 |
|
| seller_name | String | 卖家姓名 |
|
| seller_email | String | 卖家邮件地址 |
|
| seller_memo | String | 卖家备注 |
|
| seller_flag | String | 卖家备注旗帜 |
|
| agent_name | String | 代销人的姓名 |
|
| agent_uname | String | 代销人的帐号 |
|
| agent_level | String | 代销人的会员等级 |
|
| agent_sex | String | 代销人的性别 |
|
| agent_birthdate | String | 代销人的出生日期 |
|
| agent_phone | String | 代销人的电话号码 |
|
| agent_mobile | String | 代销人的手机号码 |
|
| agent_state | String | 代销人的所在省份 |
|
| agent_city | String | 代销人的所在城市 |
|
| agent_district | String | 代销人的所在地区 |
|
| agent_address | String | 代销人的详细地址 |
|
| agent_zip | String | 代销人的邮编 |
|
| agent_email | String | 代销人的Email地址 |
|
| agent_qq | String | 代销人的QQ号码 |
|
| agent_shop_url | String | 代销人的网店地址 |
|
| agent_shop_name | String | 代销人的网店名称 |
|
| buyer_name | String | 买家姓名 |
|
| buyer_alipay_no | String | 买家支付宝账号 |
|
| buyer_id | String | 买家（会员）ID |
|
| buyer_uname | String | 买家帐号 |
|
| buyer_email | String | 买家email |
|
| buyer_memo | String | 买家备注 |
|
| buyer_flag | String | 买家备注旗帜 |
|
| buyer_message | String | 买家留言，通过taobao.trade.add接口创建 |
|
| buyer_rate | Boolean | 买家是否已评价。可选值:true(已评价),false(未评价) |
|
| buyer_mobile | String | 买家的手机号码 |
|
| buyer_phone | String | 买家的电话号码 |
|
| buyer_state | String | 买家的所在省份 |
|
| buyer_city | String | 买家的所在城市 |
|
| buyer_district | String | 买家的所在地区 |
|
| buyer_address | String | 买家的详细地址 |
|
| buyer_zip | String | 买家的邮编 |
|
| orders_number | Number | 当前交易下订单数量 |
|
| trade_memo | String | 交易的备注内容 |
|
| orders | Order | 订单列表 |
|
| logistics_no | String | 运单号 |
|
| payment_lists | PaymentList | {"payment_list": []} | 订单支付信息列表 |
| is_brand_sale | String | normal | 品牌特卖（即寄售）订单标识，normal：普通 agentsale:特卖（寄售） 默认：normal |
| cod_status | String | 0 | 是否签收 0:未签收 1:以签收 默认：0 |
| trade_type | String | fixed | 交易类型： fixed(一口价) auction(拍卖) guarantee_trade(一口价、拍卖) auto_delivery(自动发货) ec（直冲） cod(货到付款) step (万人团) |
| step_trade_status | String | 分阶段订单状态： FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未付)，FRONT_PAID_FINAL_NOPAID(定金已付尾款未付)，FRONT_PAID_FINAL_PAID(定金和尾款都付) |
|
| step_paid_fee | String | 分阶段付款金额 |
|
| mark_desc | String | 异常订单处理意见 |
|
| is_errortrade | Boolean | true | 是否为异常订单,true:是；false:否 |
| passthrough | String | 透传参数。 矩阵不做任何解析处理直接打给目标方。一般是双方有特殊业务逻辑,矩阵标准结构无法满足,结构由通信双方约定。 |
