开发文档 > API文档 > 交易API > store.trade.update

store.trade.update 修改单笔交易信息 (同步)

详细描述

修改单笔交易信息

支持平台： 485, B2B分销王, 商派店掌柜, 微商无线商城

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
method String 是

API接口名称
certi_id Number 否

分配给应用的证书ID
from_node_id String 是

API调用的来源节点ID,对于第三方开发者来说，此id即为申请应用颁发的APP KEY
from_api_v String 否

请求方版本号
to_node_id String 否

API调用的目的节点ID(除了基础服务类api，其他接口必传此参数)
to_api_v String 否

接收方版本号
callback_url String 否

响应回调地址，带http路径的标准URL。（调用异步接口此参数必填）
v String 是

矩阵API协议版本，可选值:1.0
timestamp String 是

时间戳，格式为yyyy-MM-dd hh:mm:ss，例如：2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟
format String 是

可选，指定响应格式。默认JSON ,目前支持格式为JSON
sign String 是

对调用API时所有输入参数（包括应用级参数）进行签名结果

应用级输入参数

名称 类型
默认全部
 示例值 默认值 描述
tid String

485(必填)

B2B分销王(必填)

商派店掌柜(必填)

微商无线商城(必填)

交易编号（交易id）
title String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易标题
created Date

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易创建时间。格式:yyyy-MM-dd HH:mm:ss

modified Date

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易修改时间。格式:yyyy-MM-dd HH:mm:ss
status String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易状态，可选值： TRADE_ACTIVE:交易处理中, TRADE_CLOSED:交易作废即交易关闭, TRADE_FINISHED:交易成功
pay_status String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易支付状态，可选值： PAY_NO:未付款, PAY_FINISH:已付款, PAY_TO_MEDIUM:付款至担保交易, PAY_PART:部分付款, REFUND_PART:部分退款, REFUND_ALL:全额退款
ship_status String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易物流状态，可选值： SHIP_NO:未发货, SHIP_PREPARE:配货中, SHIP_PART:部分发货, SHIP_FINISH:全部发货, RESHIP_PART:部分退货, RESHIP_ALL:全部退货

is_delivery Boolean

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

是否实体配送。可选值:true(是),false(否)
is_cod Boolean

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

是否货到付款。可选值:true(是),false(否)
has_invoice Boolean

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

false

是否开发票。可选值：true(开),false(不开)。默认不开
invoice_title String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

发票title。如果要invoice为true,则此参数为必须
invoice_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

发票税金
total_goods_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

商品总额(不包括配送费用)
total_trade_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易应付总额（包括商品价格 + 配送费用)
discount_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

折扣优惠金额
goods_discount_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

商品优惠金额
orders_discount_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

订单优惠金额
promotion_details PromotionDetail

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

详细优惠方案
payed_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

已支付金额
currency String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

当前交易选择的货币类型。可选值：CNY（人民币），USD（美元），JPY（日元）。- 默认为CNY（人民币）
currency_rate String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

当前货别汇率
total_currency_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

当前货别订单总额
buyer_obtain_point_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家获得积分,返点的积分。格式:100;单位:个
point_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家使用积分。格式:100;单位:个
shipping_tid String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

创建交易时的物流方式ID（交易完成前，物流方式有可改变）
shipping_type String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易物流方式名称
shipping_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易物流配送费用
is_protect String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

是否保价（针对物流配送)
protect_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

保价费用（针对物流配送)
payment_tid Number

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

支付方式ID
payment_type String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

支付方式名称
pay_time Date

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

支付时间。 格式:yyyy-MM-dd HH:mm:ss

end_time Date

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易成功时间。 格式:yyyy-MM-dd HH:mm:ss
consign_time Date

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家发货时间。 格式:yyyy-MM-dd HH:mm:ss
trade_valid_time Date

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易有效时间(下单后的最后付款的截止时间) 格式:yyyy-MM-dd HH:mm:ss
receiver_name String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人的姓名
receiver_email String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人email地址
receiver_state String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人的所在省份
receiver_city String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人的所在城市
receiver_district String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人的所在地区
receiver_address String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人的详细地址
receiver_zip String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人的邮编
receiver_mobile String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人的手机号码
receiver_phone String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人的电话号码
receiver_time String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

收货人要求到货时间
buyer_alipay_no String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家支付宝账号
seller_uname String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家帐号
buyer_id String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家（会员）ID
buyer_uname String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家帐号
buyer_name String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家姓名
buyer_mobile String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家的手机号码
buyer_phone String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家的电话号码
buyer_email String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家email
buyer_state String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家的所在省份
buyer_city String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家的所在城市
buyer_district String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家的所在地区
buyer_address String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家的详细地址
buyer_zip String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家的邮编
seller_rate Boolean

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家是否已评价。可选值:true(已评价),false(未评价)

buyer_rate Boolean

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家是否已评价。可选值:true(已评价),false(未评价)
commission_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易佣金。精确到2位小数;单位:元。如:200.07，表示:200元7分
seller_alipay_no String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家支付宝账号
seller_mobile String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家电话号码
seller_phone String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家手机号码
seller_name String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家姓名
seller_email String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家邮件地址
trade_memo String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易备注
protect_fee String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

保价费用（针对物流配送)
pay_cost String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

支付手续费
buyer_memo String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家备注
buyer_flag String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家备注旗帜
buyer_message String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

买家留言，通过taobao.trade.add接口创建

seller_memo String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家备注
seller_flag String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

卖家备注旗帜
tradetype String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

交易类型。可选值：fixed(一口价) auction(拍卖)
invoice_desc String

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

发票内容。
orders_number Number

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

当前交易下订单数量
total_weight Number

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

该笔交易的商品总重量
orders Order

485(可选)

B2B分销王(可选)

商派店掌柜(可选)

微商无线商城(可选)

订单列表
payment_list PaymentList

485(可选)

B2B分销王(可选)

商派店掌柜(不支持)

微商无线商城(不支持)

订单支付信息详情

返回结果

名称 类型 是否必须 示例值 描述
trade Trade 是

返回订单结构中tid（订单ID）和created这两个参数。

同步示例 异步示例

XML数据格式：

			
JSON数据格式：

			
{
    "rsp":"succ",
    "msg_id":"3463421b2581604c74dcb9b74ffab2e4",
    "data":"{
        "trade":{
              "tid":"201001010001"
            }
     }
 }

		

		
	

	

	

		

			
错误码

		

		

			

				
					

						错误码
						错误描述
						解决方案
					

				
				
									
			

		

	

	

		

			
API工具

		

		

			

				API TOOLS 在线测试工具
			

			

				SDK 调用示例
			


		

	

	

		

			
FAQ

		

		

			

				
									
			

		

	

	
修改时间：2012-12-12 21:55:09