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

store.trade.add 添加单笔交易 (同步)

详细描述

添加单笔交易

支持平台： 485, ERP-协同版, ERP-仓储版, 商派店掌柜

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(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

交易编号（交易id）
title String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

交易标题
created Date

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

false

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发票税金
total_goods_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

折扣优惠金额
goods_discount_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

商品优惠金额
orders_discount_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

订单优惠金额
promotion_details PromotionDetail

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

详细优惠方案
payed_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

已支付金额
currency String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

当前货别汇率
total_currency_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

当前货币订单总额
buyer_obtain_point_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

交易物流方式名称
shipping_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

交易物流配送费用
is_protect String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

支付方式ID
payment_type String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

支付方式名称
pay_time Date

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人的姓名
receiver_email String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人email地址
receiver_state String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人的所在省份
receiver_city String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人的所在城市
receiver_district String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人的所在地区
receiver_address String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人的详细地址
receiver_zip String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人的邮编
receiver_mobile String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人的手机号码
receiver_phone String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人的电话号码
receiver_time String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

收货人要求到货时间
buyer_alipay_no String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家支付宝账号
buyer_id String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家（会员）ID
buyer_uname String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家帐号
buyer_name String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家姓名
buyer_mobile String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家的手机号码
buyer_phone String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家的电话号码
buyer_email String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家email
buyer_state String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家的所在省份
buyer_city String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家的所在城市
buyer_district String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家的所在地区
buyer_address String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家的详细地址
buyer_zip String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家的邮编
buyer_rate Boolean

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的姓名
agent_uname String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的帐号
agent_level String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的会员等级
agent_sex String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的性别
agent_birthdate String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的出生日期
agent_phone String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的电话号码
agent_mobile String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的手机号码
agent_state String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的所在省份
agent_city String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的所在城市
agent_district String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的所在地区
agent_address String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的详细地址
agent_zip String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的邮编
agent_email String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的Email地址
agent_qq String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的QQ号码
agent_shop_url String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的网店地址
agent_shop_name String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

代销人的网店名称
seller_uname String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家帐号
seller_rate Boolean

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家支付宝账号
seller_mobile String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家电话号码
seller_phone String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家手机号码
seller_memo String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家备注
seller_flag String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家备注旗帜
seller_name String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家姓名
seller_state String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家的所在省份
seller_city String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家的所在城市
seller_district String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家的所在地区
seller_address String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家的详细地址
seller_email String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家邮件地址
seller_zip String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

卖家的邮编
commission_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的姓名
shipper_phone String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的电话号码
shipper_mobile String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的手机号码
shipper_state String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的所在省份
shipper_city String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的所在城市
shipper_district String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的所在地区
shipper_address String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的详细地址
shipper_zip String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的邮编
shipper_email String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发货人的Email地址
trade_memo String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

交易备注
protect_fee String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

支付手续费
buyer_memo String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家备注
buyer_flag String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

买家备注旗帜
buyer_message String

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

发票内容
orders_number Number

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

当前交易下订单数量
total_weight Number

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

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

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(可选)

订单列表
payment_lists PaymentList

485(可选)

ERP-协同版(可选)

ERP-仓储版(可选)

商派店掌柜(不支持)

{"payment_list": []}

订单支付信息详情(json列表串)

返回结果

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

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

同步示例 异步示例

XML数据格式：

			
JSON数据格式：

			
{
    "rsp":"succ",
    "msg_id":"3463421b2581604c74dcb9b74ffab2e4",
    "data":"{
        "trade":{
              "tid":"201001010001",
              "created":"2010-06-11 10:36:01"
            }
     }
 }

		

		
	

	

	

		

			
错误码

		

		

			

				
					

						错误码
						错误描述
						解决方案
					

				
				
									
			

		

	

	

		

			
API工具

		

		

			

				API TOOLS 在线测试工具
			

			

				SDK 调用示例
			


		

	

	

		

			
FAQ

		

		

			

				
									
			

		

	

	
修改时间：2012-12-25 17:45:47