账单对账结果回推送

请求参数:

字段名称 字段类型 字段描述 是否必填
source String 云简定义的商旅平台名称,例如携程商旅:ctrip
account String 当前租户的账户信息
sessionId String 身份验证信息
sign String 加密的sign,加密方式与身份验证一致。空值不传递不参与生成sign。
data BillHeaderInfo 账单信息

BillHeader:

字段名称 字段类型 字段描述 是否必填
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 初稿

results matching ""

    No results matching ""