账单对账结果回推送
请求参数:
字段名称 |
字段类型 |
字段描述 |
是否必填 |
source |
String |
云简定义的商旅平台名称,例如携程商旅:ctrip |
是 |
account |
String |
当前租户的账户信息 |
是 |
sessionId |
String |
身份验证信息 |
是 |
sign |
String |
加密的sign,加密方式与身份验证一致。空值不传递不参与生成sign。 |
是 |
data |
BillHeaderInfo |
账单信息 |
是 |
字段名称 |
字段类型 |
字段描述 |
是否必填 |
source |
String |
云简定义的商旅平台名称,例如携程商旅:ctrip |
是 |
billCode |
String |
账单对应的唯一主键 |
是 |
billName |
String |
账单名称 |
条件必填,作废账单时不用传 |
sourceType |
String |
账单类型,支持:flight, train, hotel, taxi, meal |
否 |
confirmStatus |
String |
当前账单的对账状态,Y是完全确认,N是完全不确认,P是部分确认(partial confirmation),当confirmStatus 是P时,billLine信息时必填 |
是 |
description |
String |
备注,不超过255字符,比如不确认的原因 |
否 |
billLine |
List<BillLineInfo> |
账单行的确认信息,当confirmStatus 是P时必填 |
否 |
BillLineInfo:
字段名称 |
字段类型 |
字段描述 |
是否必填 |
source |
String |
云简定义的商旅平台名称,例如携程商旅:ctrip |
是 |
billCode |
String |
账单的代码,用于与账单头的billCode呼应 |
是 |
billLineCode |
String |
账单行的代码,账单内唯一 |
是 |
orderId |
String |
账单对应的订单id |
是 |
statementId |
String |
结算流水的id,虽然正确拼写位settlementId,但是错误的地方太多了,将错就错,仅部分渠道支持此字段 |
否 |
sourceType |
String |
订单类型,大部份渠道有值 |
否 |
confirmStatus |
String |
当前账单的对账状态,Y是确认,N不确认 |
是 |
description |
String |
备注,不超过255字符,比如不确认的原因 |
否 |
返回参数:
字段名称 |
字段类型 |
字段描述 |
resCode |
Integer |
响应状态码 |
resMsg |
String |
响应状态信息 |
请求示例(按账单确认、否认账单):
{
"source": "ctrip",
"account": "your_tenant_account",
"sessionId": "your_session_id",
"sign": "your_encrypted_sign",
"data": {
"billCode": "unique_bill_identifier",
"billName": "Bill Name",
"sourceType": "flight",
"confirmStatus": "Y",
"description":"确认"
}
}
请求示例(按具体账单条目确认、否认账单):
{
"source": "ctrip",
"account": "your_tenant_account",
"sessionId": "your_session_id",
"sign": "your_encrypted_sign",
"data": {
"billCode": "unique_bill_identifier",
"billName": "Bill Name",
"sourceType": "flight",
"confirmStatus": "P",
"billLine": [
{
"source": "ctrip",
"billCode": "unique_bill_identifier",
"billLineCode": "unique_bill_line_identifier",
"orderId": "order_id",
"statementId": "settlement_id",
"sourceType": "flight",
"confirmStatus": "Y",
"description": null
},{
"source": "ctrip",
"billCode": "unique_bill_identifier",
"billLineCode": "unique_bill_line_identifier",
"orderId": "order_id",
"statementId": "settlement_id",
"sourceType": "flight",
"confirmStatus": "N",
"description": "金额不一致"
}
]
}
}
返回示例:
{
"resCode": 10000,
"resMsg": "success"
}
{
"resCode": 9999,
"resMsg": "渠道名不能为空"
}
版本说明
版本号 |
编写日期 |
更改内容 |
V1.0 |
2024.07.22 |
初稿 |