1.接口说明

获取交易号

2.使用场景

背景

通过 HTTP post 方式创建资源时（比如在 U8 系统里创建一张新的销售订单），为了防止同一资源因重复提交导致资源重复创建问题，需要通过交易号来识别多次提交是否为重复提交，从而保证即使重复提交也不会导致生成两个新的资源。

2.1场景1

将上游的主键信息作为交易号，每个新增【add】类型的API，都有一个 biz_id 参数，传入上游主键即可。 比如从上游的【10001】报销单生成 ERP 的凭证，【10001】的报销单重复提交导也只会产生一张凭证。 https://api.yonyouup.com/api/voucher/add?biz_id=10001

2.2场景2

如果上游没有主键线索信息，需要先通过此 API 获取一个交易号（tradeid），通过此交易号保证 ERP 中的资源不会重复被创建。对于开发者需保存此交易号到本地，多次提交请使用同一个 tradeid。 https://api.yonyouup.com/system/tradeid 返回 xxxx https://api.yonyouup.com/api/voucher/add?tradeid=xxxx

3.接口调用说明

3.1请求说明

3.2输入参数说明

3.3请求示例

https://api.yonyouup.com/system/tradeid?&from_account=FromAccount&app_key=AppKey&token=token
                                                

3.4返回参数说明

3.5正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
	"errcode": "0",
	"errmsg": "成功",
	"trade": {
               "id": "40d8c9b4d35611e4ab8e0017fa000443"
  }
}
			
													
												

3.6错误返回示例

Content-type: text/html; charset=utf-8
{
   "errcode" : "2001",
   "errmsg" : "fail"
}
			
												

4.API测试