执行多账单项入账操作

POST

/api/bill/multi

执行多账单项入账操作。

入账模式说明：

账单 x 1，账单明细 x N

账单明细目前版本包括：

商品明细

赔偿明细

数据结构：
{
"orderId": "订单ID",
"bookId": "账本ID",
"modelId": "数据模型ID",
"modelKey": "模型主键",
"status": "账单状态",
"category": "账单类别",
"income": "收入/支出标识",
"indent": "编号生成规则",
"type": "账单类型",
"items": [
{
"price": "单价",
"quantity": "数量",
"name": "商品名称",
"code": "商品编码",
"amount": "金额",
"payTermId": "支付条款ID"
// ... 其他明细字段
}
]
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "orderId": "869e0b0c-4747-4c1a-b316-6c7be0122fd3",
    "bookId": "8c21fb10-a9c9-430d-8f50-16b87711288d",
    "modelId": "datum.room",
    "modelKey": "1105",
    "status": "Valid",
    "category": "Pay",
    "income": true,
    "indent": "NUM.PAYBILL",
    "type": "GoodIn",
    "items": [
        {
            "price": 100,
            "quantity": 2,
            "name": "云烟",
            "code": "01.0003",
            "amount": 200,
            "payTermId": "766814e7-b5f1-46ea-b51f-f8c7efa160d1"
        },
        {
            "price": 100,
            "quantity": 1,
            "name": "软玉溪",
            "code": "01.0002",
            "amount": 100,
            "payTermId": "ad73b0b8-56b7-425d-8b5d-4e59aa0acf8a"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/bill/multi' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderId": "869e0b0c-4747-4c1a-b316-6c7be0122fd3",
    "bookId": "8c21fb10-a9c9-430d-8f50-16b87711288d",
    "modelId": "datum.room",
    "modelKey": "1105",
    "status": "Valid",
    "category": "Pay",
    "income": true,
    "indent": "NUM.PAYBILL",
    "type": "GoodIn",
    "items": [
        {
            "price": 100,
            "quantity": 2,
            "name": "云烟",
            "code": "01.0003",
            "amount": 200,
            "payTermId": "766814e7-b5f1-46ea-b51f-f8c7efa160d1"
        },
        {
            "price": 100,
            "quantity": 1,
            "name": "软玉溪",
            "code": "01.0002",
            "amount": 100,
            "payTermId": "ad73b0b8-56b7-425d-8b5d-4e59aa0acf8a"
        }
    ]
}'

返回响应

🟢200

application/json

成功响应

Body

示例

{
    "data": {
        "id": "string",
        "amount": 0,
        "bookId": "string",
        "code": "string",
        "comment": "string",
        "endAt": "2019-08-24T14:15:22.123Z",
        "groupBy": "string",
        "income": true,
        "name": "string",
        "orderId": "string",
        "serial": "string",
        "startAt": "2019-08-24T14:15:22.123Z",
        "type": "string",
        "category": "string",
        "modelId": "string",
        "modelKey": "string",
        "sigma": "string",
        "tenantId": "string",
        "appId": "string",
        "active": true,
        "language": "string",
        "metadata": "string",
        "version": "string",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "createdBy": "string",
        "updatedAt": "2019-08-24T14:15:22.123Z",
        "updatedBy": "string"
    }
}

修改于 2026-02-10 11:28:24

执行账本间的转账操作

执行带预授权模式的押金入账操作