平台类

    tradeid/get


    目录

    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请求说明

    url https://api.yonyouup.com/system/tradeid
    格式 JSON
    https请求方式 GET
    编码类型 UTF-8


    3.2输入参数说明

    参数 是否必填 描述
    from_account 调用方id
    app_key 应用编码
    token 全局访问唯一识别码

    3.3请求示例

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


    3.4返回参数说明

    参数说明 描述
    errcode 错误码,0 为正常。
    errmsg 错误信息。
    id 交易号。

    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测试

    API测试 SDK下载