新增收款单(强鉴权)

POST

/order-aggregation/fund/receipt-bill

开放接口-收付款单

资金修改安全性要求高，为保护资金数据安全，防止请求数据被篡改，增加数据验签逻辑和请求时效性判断
验签逻辑：
将参与验签的字段key=value，按字典升序排序用 '&'拼接，最后拼接加密&_key_=salt,然后计算MD5作为参数传递，服务接收到请求后，用相同的逻辑计算MD5,然后匹配是否相等，
例如拼接后:exemptAmount=0&nonce=123&otherOrgId=1772779383262880&otherOrgType=CUSTOMER&paymentMethodCode=3&realTradeAmount=10&timestamp=1703154485&tradeMoney=10&tradeTime=1702990018000&_key_=xxx
计算MD5：e405e585821989c8bae19e81110d0fb5

注意:

加密的盐salt由易订货颁发

参与验签的字段在接口里面有标记

请求参数

Query 参数

sign

string

必需

数据签名校验，签名请看文档说明

nonce

string

必需

签名随机串(参与加密),请勿重复，用于防重放

timestamp

integer

必需

签名时间戳(秒)，同时用于请求超时校验，120s内有效(参与加密)

Header 参数

access_token

string

必需

oauth2接口获取的access_token

x-client-id

string

必需

申请对接时的clientId

Body 参数application/json

attachments

array [object]

附件

可选

exemptAmount

number

可选

优惠金额(参与加密)

otherOrgId

integer <int64>

必需

交易对手机构ID(往来单位机构id)(参与加密)

otherOrgType

enum<string>

必需

交易对手机构类型(总部:HEADQUARTER,分公司:BRANCH,门店:STORE,客户:CUSTOMER,供应商:SUPPLIER)(参与加密)

枚举值:

BRANCHCUSTOMERHEADQUARTERMERCHANTSTORESUPPLIERVOID

paymentMethodCode

string

必需

支付方式,1:现金(参与加密)

realTradeAmount

number

必需

实收金额(参与加密)

>= 0.01<= 100000000

remark

string

备注

可选

tradeMoney

number

必需

交易金额(收款单金额) = exemptAmount + realTradeAmount(参与加密)

>= 0.01<= 100000000

tradeTime

string <date-time>

必需

交易时间(时间戳ms),允许往前15天，往后15天范围(参与加密)

示例

{
  "attachments": [
    {}
  ],
  "exemptAmount": 0,
  "otherOrgId": 0,
  "otherOrgType": "BRANCH",
  "paymentMethodCode": "string",
  "realTradeAmount": 0.01,
  "remark": "string",
  "tradeMoney": 0.01,
  "tradeTime": "2019-08-24T14:15:22Z"
}

返回响应

🟢200OK

application/json

Body

object {0}

示例

{}

修改于 2024-01-26 03:31:43

往来对象核销触发

查询核销单列表