Huilianyi Open API Documentation

https://opendocs.huilianyi.com/
Admin
Official API documentation for Huilianyi (汇联易), an enterprise expense management and financial...
Tokens:692,501
Snippets:2,270
Trust Score:8.7
Update:2 months ago
Show doc for...
Tokens:
Raw
### Example Train Order Query URL

Source: https://opendocs.huilianyi.com/implement/business-data/train/order.html

This is an example of a GET request URL for querying train orders, including parameters for date range, integration, pagination, payment type, and company OID.

```bash
/api/open/train/orders?startDate=2016-09-29 11:25:14&endDate=2016-09-29 11:25:15&integration=CTRIP&page=0&size=1&companyOID=cf2b3694-b4f8-4aca-b233-111748eb025b
```

--------------------------------

### OpenPrepaymentApportionRequestDTO Example

Source: https://opendocs.huilianyi.com/implement/business-data/expense-report/create-corp-expense-report.html

Example payload for a prepayment apportionment line item.

```json
{
    "amount": 20.00,
    "openApportionViewRequestDTOList": [{}],
    "companyCode": "0001",
    "remark": "分摊行备注",
    "relevantEmployeeId": "0001"
}
```

--------------------------------

### expenseAmortise Example

Source: https://opendocs.huilianyi.com/implement/business-data/expense-report/create-corp-expense-report.html

Example payload for defining an expense amortization schedule.

```json
{
    "periodName": "2024-01",
    "amount": 100.00,
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": "2024-01-31T23:59:59Z"
}
```

--------------------------------

### Response Data Example

Source: https://opendocs.huilianyi.com/implement/business-data/hotel/transactionsV2.html

Example JSON response containing hotel settlement base info, order details, and hotel information.

```json
[{
        "businessCode": "TA00032363",
        "applicationOID": "8c9d986d-c898-4fc0-ab6c-5390a9a6f8b7",
        "hotelOrderSettlementBaseInfo": {
            "id": null,
            "recordId": "4784287",
            "orderId": "3183226502",
            "accountId": "4113",
            "companyOID": "cf2b3694-b4f8-4aca-b233-111748eb025b",
            "uid": "2103580238          ",
            "detailType": "O",
            "payType": "X",
            "hotelType": "X",
            "price": 424,
            "quantity": 1,
            "amount": 424,
            "serviceFee": 0,
            "extraCharge": 0,
            "accCheckBatchNo": "testnet_4113_20170428",
            "createTime": "2017-05-05 04:34:56",
            "dataChangeLastTime": "2017-05-05 04:39:48",
            "createdDate": "2017-05-07 00:00:53"
        },
        "hotelOrderSettlementOrderInfo": {
            "id": 2,
            "orderId": "3183226502",
            "employeeName": "宇超",
            "employeeId": "",
            "workCity": "",
            "orderDate": "2017-05-04 14:17:20",
            "roomName": "双床房",
            "roomNameEN": "Twin Room",
            "quantity": null,
            "clientName": "宇超",
            "startTime": "2017-06-18 17:00:00",
            "endTime": "2017-06-19 00:00:00",
            "postAmount": 0,
            "isHasSpecialInvoice": "T",
            "serverFrom": "Offline",
            "lowPriceRC": "",
            "lowPriceRCInfo": "",
            "lowPriceRCInfoEN": "",
            "agreementRC": "",
            "agreementRCInfo": "",
            "agreementRCInfoEN": "",
            "costCenter": "",
            "costCenter2": "",
            "costCenter3": "",
            "defineTitleContent": "",
            "defineTitleContent2": "",
            "hotelRelatedJourneyNo": "TA00032363-D-1-H",
            "remarks": "一定安排双床",
            "settlementClients": [
                {
                    "employeeId": "",
                    "clientName": "宇超",
                    "costCenter1": "^123456",
                    "costCenter2": "",
                    "costCenter3": "",
                    "dept1": "预订",
                    "dept2": "",
                    "dept3": "",
                    "dept4": "",
                    "dept5": "",
                    "dept6": "",
                    "dept8": "",
                    "dept9": "",
                    "dept10": ""
                }
            ]
        },
        "hotelOrderSettlementHotelInfo": {
            "id": 2,
            "hotelName": "全季酒店（北京朝阳门店）",
            "hotelNameEN": "JI Hotel(Chaoyangmen Beijing)",
            "cityName": null,
            "cityNameEN": "Beijing                                           ",
            "star": 3,
            "isDomestic": "true",
            "isCU": "F"
        }
    }
]
```

--------------------------------

### GET /api/open/prepayment/apply

Source: https://opendocs.huilianyi.com/implement/business-data/prepayment-apply/query-prepayment-apply.html

查询对公收款单列表，支持按最后编辑时间进行增量查询。

```APIDOC
## GET /api/open/prepayment/apply

### Description
该接口用于对外开放查询对公收款单。注意:调用方必须能够正确处理重复的业务单据数据。

### Method
GET

### Endpoint
/api/open/prepayment/apply

### Parameters
#### Query Parameters
- **status** (String) - Optional - 状态 (1001:初始, 1002:提交财务确认, 1004:财务确认通过, 1009:已驳回)
- **startDate** (String) - Required - 开始时间 (最后编辑时间)
- **endDate** (String) - Required - 结束时间 (最后编辑时间)
- **withApprovalHistory** (String) - Optional - 审批历史 (默认false)
- **companyCode** (String) - Optional - 公司Code
- **page** (String) - Required - 页数 (0和1均为第一页)
- **size** (String) - Required - 条数
- **ascMode** (Boolean) - Optional - 是否按照收款单最后更改时间升序排列 (不传默认false)

### Response
#### Success Response (200)
- **message** (String) - 操作结果信息
- **errorCode** (String) - 错误码
- **data** (Array) - 收款单数据列表

#### Response Example
{
  "message": "operation completed",
  "errorCode": "0000",
  "data": [
    {
      "id": "1494230195547304014",
      "businessCode": "AR5547304014",
      "amount": 550.0000,
      "currencyCode": "CNY",
      "confirmedDate": "2022-04-14 16:06:21"
    }
  ]
}
```

--------------------------------

### Request Example for Expense Type Detail

Source: https://opendocs.huilianyi.com/implement/master-data/expense-type/detail-expense-type.html

Example of a GET request to retrieve a specific expense type's details using its OID and set of books code.

```http
/api/open/expenseType/ec92af2c-7af8-48b6-94fc-a77d6bb7eb8c?setOfBooksCode=DEFAULT_SOB
```

--------------------------------

### Paginated Cost Center Query URL Example

Source: https://opendocs.huilianyi.com/implement/master-data/costcenter/query-costcenter.html

Example of a GET request URL for paginated cost center queries, specifying page number, size, and set of books code.

```http
/api/open/costCenter?page=1&size=10&setOfBooksCode="ZT0001"
```

--------------------------------

### GET /budget-service/api/open/budget/explain/query/v2

Source: https://opendocs.huilianyi.com/implement/business-data/budget/budgetExplainQuery.html

根据单据类型和单据编号查询单据的预算执行信息。

```APIDOC
## GET /budget-service/api/open/budget/explain/query/v2

### Description
该接口用于根据单号查询单据预算执行信息。

### Method
GET

### Endpoint
/budget-service/api/open/budget/explain/query/v2

### Parameters
#### Query Parameters
- **documentType** (String) - Required - 单据类型 (EXP_REPORT: 报销单, EXP_REQUISITION: 申请单, CONTRACT: 合同)
- **businessCode** (String) - Required - 单据编号
- **companyCode** (String) - Optional - 单据类型为合同时必填

### Response
#### Success Response (200)
- **message** (String) - 错误消息
- **errorCode** (String) - 错误消息编码
- **data** (List) - BudgetCheckLogGroupVO 列表

#### Response Example
{
  "message": "success",
  "errorCode": "0000",
  "data": [{
    "controlRuleName": "年度管控规则",
    "controlStrategyName": "期间警告管控",
    "budgetCheckLogs": [{
      "scenarioName": "stage预算场景",
      "scenarioCode": "0001",
      "versionName": "stage预算版本",
      "versionCode": "0001",
      "structureName": "项目预算表",
      "structureCode": "0001",
      "itemName": "非预付占预算",
      "itemCode": "0001",
      "bgtBudgetFunctionAmount": "750.00",
      "bgtReverseFunctionAmountR": "1779.93",
      "bgtReverseFunctionAmountU": "186.66",
      "availableAmount": "-1216.59",
      "progressRate": "262.212%",
      "controlLevel": "ALLOWED",
      "dynamics": []
    }]
  }]
}
```

--------------------------------

### POST /budget-service/api/open/budget/query/prepare/line

Source: https://opendocs.huilianyi.com/implement/business-data/budget/selectPrepareLine.html

该接口使用预算编制行信息分页查询预算编制行信息。

```APIDOC
## POST /budget-service/api/open/budget/query/prepare/line

### Description
该接口使用预算编制行信息分页查询预算编制行信息。

### Method
POST

### Endpoint
/budget-service/api/open/budget/query/prepare/line

### Request Body
- **language** (string) - 语言
- **organizationCode** (string) - 组织代码
- **structureCode** (string) - 预算结构代码
- **scenarioCode** (string) - 预算场景代码
- **versionCode** (string) - 预算版本代码
- **periodYear** (integer) - 预算年度
- **hasCompany** (boolean) - 是否包含公司
- **companyCode** (string) - 公司代码
- **hasBudgetUnit** (boolean) - 是否包含预算单位
- **budgetUnitCode** (string) - 预算单位代码
- **hasUser** (boolean) - 是否包含用户
- **userCode** (string) - 用户代码
- **hasDimension1Value**...**hasDimension20Value** (boolean) - 是否包含维度1至20的值
- **dimension1ValueCode**...**dimension20ValueCode** (string) - 维度1至20的值代码

### Request Example
{
    "language": "zh_cn",
    "organizationCode": "00001",
    "structureCode": "00001",
    "scenarioCode": "00001",
    "versionCode": "00001",
    "periodYear": 2024,
    "hasCompany": true,
    "companyCode": "00001",
    "hasBudgetUnit": true,
    "budgetUnitCode": "00001",
    "hasUser": true,
    "userCode": "00001",
    "hasDimension1Value": false,
    "hasDimension2Value": false,
    "hasDimension3Value": false,
    "hasDimension4Value": false,
    "hasDimension5Value": false,
    "hasDimension6Value": false,
    "hasDimension7Value": false,
    "hasDimension8Value": false,
    "hasDimension9Value": false,
    "hasDimension10Value": false,
    "hasDimension11Value": false,
    "hasDimension12Value": false,
    "hasDimension13Value": false,
    "hasDimension14Value": false,
    "hasDimension15Value": false,
    "hasDimension16Value": false,
    "hasDimension17Value": false,
    "hasDimension18Value": false,
    "hasDimension19Value": false,
    "hasDimension20Value": false,
    "dimension1ValueCode": null,
    "dimension2ValueCode": null,
    "dimension3ValueCode": null,
    "dimension4ValueCode": null,
    "dimension5ValueCode": null,
    "dimension6ValueCode": null,
    "dimension7ValueCode": null,
    "dimension8ValueCode": null,
    "dimension9ValueCode": null,
    "dimension10ValueCode": null,
    "dimension11ValueCode": null,
    "dimension12ValueCode": null,
    "dimension13ValueCode": null,
    "dimension14ValueCode": null,
    "dimension15ValueCode": null,
    "dimension16ValueCode": null,
    "dimension17ValueCode": null,
    "dimension18ValueCode": null,
    "dimension19ValueCode": null,
    "dimension20ValueCode": null
}
```

--------------------------------

### POST /api/open/prepayment/apply

Source: https://opendocs.huilianyi.com/implement/business-data/prepayment-apply/create-prepayment-apply.html

创建对公收款单接口，用于提交收款申请。

```APIDOC
## POST /api/open/prepayment/apply

### Description
该接口主要用于创建对公收款单。

### Method
POST

### Endpoint
/api/open/prepayment/apply

### Parameters
#### Request Body
- **receiptType** (String) - Required - 对公收款类型 (1：对公支付单预付退款, 3：对公支付单到票退款)
- **repaymentType** (String) - Required - 收款方式
- **transDetailId** (String) - Optional - 借款支付流水id (支付流水id和流水号二选一)
- **transDetailNum** (String) - Optional - 借款支付流水号 (支付流水id和流水号二选一)
- **withReceiptPaymentLineId** (String) - Optional - 到票付款行id (“到票退款”时必填)
- **payeeBankAccount** (String) - Optional - 收款方开户账号
- **payerBankAccount** (String) - Optional - 退款方账号
- **repaymentAmount** (BigDecimal) - Required - 收款金额
- **interestAmount** (BigDecimal) - Optional - 利息金额
- **isFinance** (Boolean) - Optional - 是否财务还款 (false员工还款，true财务还款，默认false)
- **operatorEmployeeId** (String) - Required - 操作人工号
- **status** (String) - Optional - 收款单状态 (1001: 编辑中, 1002: 已提交)
- **businessCode** (String) - Optional - 收款单号
- **transactionNumber** (String) - Optional - 收款流水
- **procedureAmount** (BigDecimal) - Optional - 手续费金额

### Request Example
{
    "receiptType":"3",
    "repaymentType":"1001",
    "transDetailId":"1186829718839721985",
    "transDetailNum":"1186829718839721985",
    "withReceiptPaymentLineId": 1186829718839721985,
    "payeeBankAccount": "3994452",
    "repaymentAmount":"1",
    "interestAmount":"0",
    "isFinance":"false",
    "status":"1002",
    "operatorEmployeeId":"100001",
    "businessCode": "PA0001",
    "transactionNumber": "0000011"
}

### Response
#### Success Response (200)
- **message** (String) - 操作成功
- **errorCode** (String) - 错误码
- **key** (String) - 收款单号

#### Response Example
{
    "message": "操作成功",
    "errorCode": "0000",
    "key": "CR00032673"
}
```

--------------------------------

### OpenInvoiceApportionRequestDTO Example

Source: https://opendocs.huilianyi.com/implement/business-data/expense-report/create-corp-expense-report.html

Example payload for an invoice apportionment line item.

```json
{
    "amount": 30.00,
    "openApportionViewRequestDTOList": [{}],
    "companyCode": "0001",
    "remark": "分摊行备注",
    "relevantEmployeeId": "0001",
    "applicationApportionmentId": 123456789
}
```

--------------------------------

### OpenPrepaymentLineDetailDTO JSON Examples

Source: https://opendocs.huilianyi.com/implement/business-data/expense-report/payment-schedule-search.html

JSON objects representing prepayment line detail configurations including text areas, custom enumerations, and numeric fields.

```json
{
            "fieldTypeId": 101,
            "name": null,
            "value": null,
            "adapterValue": null,
            "showValue": "",
            "printValue": null,
            "valueCode": null,
            "createdDate": "2025-09-03T07:24:48Z",
            "lastModifiedDate": "2025-09-03T07:24:48Z",
            "fieldContent": "{\"maxLength\":1000}",
            "formOID": "168a15c3-7c7f-4211-9614-457d80f4e76a",
            "referenceOID": null,
            "messageKey": "text_area",
            "dataSource": "",
            "sequence": 20,
            "systemSequence": 2,
            "required": false,
            "hide": false,
            "listEnabled": null,
            "descriptionEnabled": null,
            "fieldDescription": null,
            "isReadOnly": false,
            "fieldConstraint": "",
            "fieldCode": "moreText",
            "attachmentImages": [],
            "bankAccountNo": null,
            "promptInfo": "请输入",
            "pdfShow": false,
            "formPdfShow": null,
            "businessFieldCode": null,
            "refCostCenterOID": null,
            "expenseTypeOID": null,
            "legShowValue": null,
            "ledOrmKey": null,
            "highOff": [],
            "setOfBooksCode": null,
            "children": null,
            "guiWidgetOID": "dce9dd84-abd8-11e6-bae2-00163e000c55",
            "categoryType": null,
            "extraType": null,
            "valid": true,
            "currentEdit": null,
            "skipFormulaCalculation": null,
            "fieldValueCode": null,
            "valueEntity": null,
            "reconciliationShow": null,
            "reconciliationKey": null,
            "isCallBackReturn": null,
            "field2": null,
            "mappingType": null,
            "fromFix": null
        },
        {
            "id": "1963141108943056899",
            "bizType": "PRE_PAYMENT",
            "bizTypeId": 1601,
            "formValueOID": "c940a709-65cf-4141-a9ed-a904ec6eed9f",
            "bizOID": "1ea63671-db18-4ce2-8262-7ded5661cef8",
            "fieldOID": "22ea7c5e-f6dd-43f1-9e56-2d7adf02e836",
            "fieldString": null,
            "fieldName": "值列表",
            "fieldType": "CUSTOM_ENUMERATION",
            "fieldTypeId": 106,
            "name": null,
            "value": null,
            "adapterValue": null,
            "showValue": "",
            "printValue": null,
            "valueCode": null,
            "createdDate": "2025-09-03T07:24:48Z",
            "lastModifiedDate": "2025-09-03T07:24:48Z",
            "fieldContent": "cust_list",
            "formOID": "168a15c3-7c7f-4211-9614-457d80f4e76a",
            "referenceOID": null,
            "messageKey": "cust_list",
            "dataSource": "{\"customEnumerationOID\":\"02c1a1ee-03c5-4cac-99fd-8d51af0989b9\"}",
            "sequence": 30,
            "systemSequence": 3,
            "required": false,
            "hide": false,
            "listEnabled": null,
            "descriptionEnabled": null,
            "fieldDescription": null,
            "isReadOnly": false,
            "fieldConstraint": "{\"defaultValueType\":\"104\",\"type\":\"0\",\"defaultValue\":\"\"}",
            "fieldCode": "custList",
            "attachmentImages": [],
            "bankAccountNo": null,
            "promptInfo": "请选择",
            "pdfShow": false,
            "formPdfShow": null,
            "businessFieldCode": null,
            "refCostCenterOID": null,
            "expenseTypeOID": null,
            "legShowValue": null,
            "ledOrmKey": null,
            "highOff": [],
            "setOfBooksCode": null,
            "children": null,
            "guiWidgetOID": "dce9dc89-abd8-11e6-bae2-00163e000c55",
            "categoryType": null,
            "extraType": null,
            "valid": true,
            "currentEdit": null,
            "skipFormulaCalculation": null,
            "fieldValueCode": null,
            "valueEntity": null,
            "reconciliationShow": null,
            "reconciliationKey": null,
            "isCallBackReturn": null,
            "field2": null,
            "mappingType": null,
            "fromFix": null
        },
        {
            "id": "1963141108943056900",
            "bizType": "PRE_PAYMENT",
            "bizTypeId": 1601,
            "formValueOID": "b24cda59-f354-4fd0-a6a2-1038ab16fe22",
            "bizOID": "1ea63671-db18-4ce2-8262-7ded5661cef8",
            "fieldOID": "dcfb8a5b-f966-49ac-aeb7-468a4886734e",
            "fieldString": null,
            "fieldName": "数字",
            "fieldType": "DOUBLE",
            "fieldTypeId": 104,
            "name": null,
            "value": null,
            "adapterValue": null,
            "showValue": "",
            "printValue": null,
            "valueCode": null,
            "createdDate": "2025-09-03T07:24:48Z",
            "lastModifiedDate": "2025-09-03T07:24:48Z"
```

--------------------------------

### OpenPrepaymentRelatedApportionRequestDTO Example

Source: https://opendocs.huilianyi.com/implement/business-data/expense-report/create-corp-expense-report.html

Example payload for linking prepayment apportionment to an expense type.

```json
{
    "expenseTypeCode": "DEFAULT_SOBEXP1087",
    "openPrepaymentApportionRequestDTOList": [{}]
}
```

--------------------------------

### Budget Item Query Parameters

Source: https://opendocs.huilianyi.com/implement/business-data/budget/queryItem.html

Example of parameters used for querying budget items. Includes date range, pagination, and size.

```json
{
  "startDate": "2021-10-01 00:00:00",
  "endDate": "2021-10-02 00:00:00",
  "page": 1,
  "size": 100
}
```

--------------------------------

### FlightDTO JSON Example

Source: https://opendocs.huilianyi.com/implement/business-data/receipt/receipt-create-open.html

Example of the JSON structure for the FlightDTO object used in receipt creation.

```json
{
  "moreInfo": {
    "flightsFI": [
      {
        "sfz": "T2长春",
        "mdz": "上海浦东",
        "hbh": "CA1986",
        "cyrq": "2019年03月06日",
        "qfsj": "11:25",
        "zwdj": "S"
      }
    ]
  }
}
```

--------------------------------

### API Response Examples

Source: https://opendocs.huilianyi.com/implement/master-data/vendor/update-vendor.html

Examples of JSON responses returned by the API for successful operations and error scenarios.

```json
{
  "message": "operation completed",
  "errorCode": "0000",
  "key": "10003111124256"
}
```

```json
{
"message": "该供应商银行账号重复",
"errorCode": "121705"
}
```

--------------------------------

### Add Budget Project Request Example

Source: https://opendocs.huilianyi.com/implement/business-data/budget/addItem.html

This is an example of a POST request to add a new budget project. It includes organization details, project codes, names, and internationalization settings.

```json
{
    "organizationCode":"001",
    "budgetItemCode":"002",
    "budgetItemName":"预算项目名称",
    "budgetItemTypeCode":"001",
    "remark":"测试备注2",
    "isEnabled":true,
    "enterFlag":true,
    "authCompanyCodes":["001","002"],
    "budgetJournalTypeCodes":["001","002"],
    "i18n": {
      "budgetItemName": [
        {
          "language": "zh_cn",
          "value": "预算项目A-默认类型"
        }
      ]
    }
}
```

--------------------------------

### Vendor API Response Examples

Source: https://opendocs.huilianyi.com/implement/master-data/vendor/create-vendor.html

Examples of JSON response structures for successful operations and error scenarios.

```json
{
  "message": "operation completed",
  "errorCode": "0000",
  "key": "10003111124256"
}
```

```json
{
"message": "该供应商银行账户重复",
"errorCode": "121705"
}
```

--------------------------------

### Response Example

Source: https://opendocs.huilianyi.com/implement/business-data/payment-service/paymentFlow_query.html

Successful response structure containing payment batch details and line items.

```json
{
    "message": "operation completed",
    "errorCode": "0000",
    "data": [
        {
            "totalAmount": 2.0000,
            "batchNo": "202309041214041135938377",
            "remark": "",
            "baseTotalAmount": 1.200,
            "companyOid": "d9b15c4f-0c44-4faa-bf8f-b0155b3e0bd7",
            "companyName": "美元测试公司",
            "companyCode": "194708901",
            "paymentMethodCode": "1218",
            "paymentMethodId": "0",
            "paymentMethodName": "落地文件-中文",
            "createBy": "21a8d442-955b-474f-babc-442be1080504",
            "accountNumber": "238462387467236421201",
            "accountName": "美元测试账号1201",
            "orderNum": 1,
            "currency": "CNY",
            "batchCompanyId": 9009,
            "batchCompanyNames": null,
            "paymentApprovalOid": "0074ede2-84d3-4caf-be3a-9a1bf7ca1c1a",
            "lineList": [
                {
                    "baseAmount": 2.000,
                    "amount": 2.0000,
                    "partnerCategory": "1002",
                    "partnerCategoryDesc": "内部员工",
                    "partnerId": 452153,
                    "partnerCode": "00010",
                    "partnerName": "懿欧阳1",
                    "payeeAccountName": "重复卡号",
                    "payeeBankName": "城市商业银行",
                    "payeeBankCode": "313191002017",
                    "payeeBranchBankName": null,
                    "currency": "CNY",
                    "accountNumber": "1234567",
                    "documentNumber": "LA00434205",
                    "documentCategory": "PAYMENT_REQUISITION",
                    "documentCategoryDesc": "借款单",
                    "employeeId": "00010",
                    "employeeName": "懿欧阳1"
                }
            ],
            "creator": {
                "employeeID": "00010",
                "fullName": "懿欧阳1",
                "email": "14082978512@xnhly99.com",
                "departmentName": "欧阳测试-部门",
                "departmentCustNo": "0001"
            },
            "approvalHistorys": null
        }
    ],
    "spanId": "5ec37c114b0f291c"
}
```

--------------------------------

### Receipt Check Response Example

Source: https://opendocs.huilianyi.com/implement/business-data/receipt/receipt-check-open.html

Example JSON response returned after a successful receipt check operation.

```json
{
    "errorCode": "121800",
    "message": "查验成功",
    "data": {
        "type": "增值税普通发票",
        "payee": "上海早陆晚玖餐饮有限公司",
        "detail": null,
        "fee": 27200.0,
        "title": "上海甄汇信息科技有限公司",
        "draweeNo": "91310118MA1JLFER1F",
        "billingTime": 1551801600,
        "billingDate": "20220523",
        "invoiceNo": "59957351",
        "invoiceCode": "3100164320",
        "feeWithoutTax": 26408.0,
        "tax": 792.0,
        "payeeNo": "913101070678326966",
        "draweeAddressPhone": "",
        "payeeAddressPhone": "金沙江路1977弄16号B1 021-52502933",
        "draweeBankAccount": "",
        "payeeBankAccount": "中国工商银行复兴中路支行1001208709006961904",
        "deviceNumber": "661601595941",
        "invoiceTypeNo": "04",
        "invalidStatus": "N",
        "receiptStatus": "正常",
        "checkCode": "52164989290593315048",
        "taxAuthorityName": "",
        "taxAuthorityNo": "",
        "taxCertificateNumber": "",
        "remark": "",
        "taxRate": 0.03,
        "tollType": "",
        "allElectricalBillingNo": "22312000000001555922" ,
        "deviceNumber": "661704927021",
        "ofdUrl": "https://skfp.shanghai.chinatax.gov.cn:9008/api?action=getDoc&code=xxxxxx&type=3",
        "reversedType": "ALREADY",
        "seatNumber": "04车09D号",
        "seatTT": "二等座",
        "dateTT": "2024年04月22日",
        "idCardNo": "372928******193477",
        "receiptOwner": "魏咸斌",
        "timeTT": "07:20",
        "stationGetoffTT": "天津",
        "stationGetonTT": "北京南",
        "trainNumberTT": "C2201",
        "numberFI": "211522A08604229895530xxxx",
        "flightsFI": "URC 乌鲁木齐-NKG 南京,CZ6927,2022-06-15,09:03,N",
        "domesticPassengers": "Y",
        "taxFi": "50.00",
        "fareFi": 680.00,
        "fuelDurchargeFi": 0.00,
        "caacdevelopmentFundFi": 50.00,
        "invoiceGoods": [
            {
                "invoiceUniqueCode": "310016432059957351",
                "goodsName": "*餐饮服务*餐饮服务",
                "specificationModel": "",
                "unit": "",
                "count": "",
                "unitPrice": null,
                "amount": "26408.00",
                "taxRate": "3",
                "taxPrice": "792.00",
                "organizationCode": null,
                "vehicleType": null,
                "brandModel": null,
                "placeOfOrigin": null,
                "certificateNumber": null,
                "commodityInspectionNo": null,
                "engineNumber": null,
                "frameNumber": null,
                "importCertificate": null,
                "tonnage": null,
                "limitMultiplier": null,
                "expenseItem": "",
                "carType": "",
                "plateNumber": "",
                "passDateFrom": "",
                "passDateTo": "",
                "detailNo": "1"
            }
        ]
    },
  "success": true
}
```

--------------------------------

### Budget Item Query Response Example

Source: https://opendocs.huilianyi.com/implement/business-data/budget/queryItem.html

Example of a successful response when querying budget items. Includes message, error code, and a list of budget item data.

```json
{
  "message": "success",
  "errorCode": "0000",
  "data": [
    {
      "organizationCode":"001",
      "budgetItemCode":"002",
      "budgetItemName":"预算项目名称",
      "budgetItemTypeCode":"001",
      "budgetItemTypeName":"默认预算项目类型",
      "parentBudgetItemCode":"001",
      "parentBudgetItemName":"父级预算项目名称",
      "responsibleDepartmentCode":"0001",
      "responsibleDepartmentName":"归口部门名称",
      "remark":"备注信息",
      "enabled":true,
      "allCompanyFlag": true,
      "allDepartmentFlag": true,
      "allBudgetUnitFlag": true,
      "i18n": {
        "budgetItemName": [
          {
            "language": "zh_cn",
            "value": "预算项目名称"
          }
        ]
      }
    }
  ]
}
```

--------------------------------

### Receipt Check Request Parameter Example

Source: https://opendocs.huilianyi.com/implement/business-data/receipt/receipt-check-open.html

Example JSON payload for initiating a receipt check request.

```json
{
    "invoiceTypeNo": "04",
    "invoiceCode": "3100164320",
    "invoiceNo": "59957351",
    "billingDate": "20190306",
    "invoiceAmount": 123,
    "checkCode": "315048",
    "orderNo": "IV7899898"
}
```

--------------------------------

### GET /api/open/application/by/user

Source: https://opendocs.huilianyi.com/implement/business-data/application/application-query-by-user.html

查询用户已通过的申请单列表。仅查询已通过状态的单据，支持差旅、费用申请，不包含已关闭单据。查询范围包括申请人、参与人、制单人、统一报销人。

```APIDOC
## GET /api/open/application/by/user

### Description
该接口用于查询用户已通过的申请单列表。仅查询已通过状态的单据，支持差旅、费用申请，不包含已关闭单据。查询范围包括申请人、参与人、制单人、统一报销人。

### Method
GET

### Endpoint
/api/open/application/by/user

### Parameters
#### Query Parameters
- **page** (int) - Required - 当前页 (0和1均为第一页)
- **size** (int) - Required - 每页记录数 (最大100)
- **applicantEmployeeId** (String) - Required - 申请人工号

### Response
#### Success Response (200)
- **message** (string) - 操作结果描述
- **errorCode** (string) - 错误码
- **data** (array) - 申请单列表
- **spanId** (string) - 追踪ID

#### Response Example
{
  "message": "operation completed",
  "errorCode": "0000",
  "data": [
    {
      "applicantOID": "041d0a8a-5d0e-4e95-856f-2cbf9c5ff11e",
      "applicationOID": "3461598a-bcd5-4a19-b21c-3a464fe9ef02",
      "businessCode": "CL202605252152",
      "status": 1003,
      "title": "看下关联",
      "totalAmount": 91.0
    }
  ],
  "spanId": "b85bd0733fb1fc16"
}
```

--------------------------------

### OpenApportionViewRequestDTO Example

Source: https://opendocs.huilianyi.com/implement/business-data/expense-report/create-corp-expense-report.html

Example payload for defining an apportionment item (department, cost center, or project task).

```json
{
    "fieldType": "department",
    "costCenterCode": "PROJECT",
    "costCenterItemCode": "1001"
}
```

--------------------------------

### GET /api/open/project/detail/{projectCode}

Source: https://opendocs.huilianyi.com/implement/master-data/project/query-project-detail.html

查询指定项目编码的项目详情信息。本接口需要集团权限。

```APIDOC
## GET /api/open/project/detail/{projectCode}

### Description
用于查询项目详情。

### Method
GET

### Endpoint
/api/open/project/detail/{projectCode}

### Parameters
#### Path Parameters
- **projectCode** (String) - Required - 项目编码

#### Query Parameters
- **showCustomValues** (Boolean) - Optional - 是否查询扩展字段
- **showProjectTasks** (Boolean) - Optional - 是否查询项目任务
- **showProjectMembers** (Boolean) - Optional - 是否查询项目成员
- **showControls** (Boolean) - Optional - 是否查询项目控制
- **showCompany** (Boolean) - Optional - 是否查询启用公司
- **showDepartment** (Boolean) - Optional - 是否查询启用项目
- **showI18n** (Boolean) - Optional - 是否查询多语言 (默认为false)

### Response
#### Success Response (200)
- **message** (String) - 操作结果信息
- **errorCode** (String) - 错误码
- **data** (Object) - 项目详情数据对象

#### Response Example
{
  "message": "operation completed",
  "errorCode": "0000",
  "data": {
    "sequenceNumber": 1,
    "projectCode": "1224",
    "projectName": "项目77213",
    "projectTypeCode": "4093",
    "startDate": "2021-12-31T16:00:00Z",
    "endDate": "2022-12-10T16:00:00Z",
    "enabled": true,
    "projectMembers": [
      {
        "positionCode": "jiaose001",
        "positionName": "角色1",
        "employeeId": "001311",
        "employeeName": "刘59245",
        "status": "1001"
      }
    ]
  }
}
```

--------------------------------

### GET /api/open/prepayment/apply/detail

Source: https://opendocs.huilianyi.com/implement/business-data/prepayment-apply/query-prepayment-apply-detail.html

查询指定对公收款单的详细信息。

```APIDOC
## GET /api/open/prepayment/apply/detail

### Description
该接口用于对外开放查询对公收款单详情。

### Method
GET

### Endpoint
/api/open/prepayment/apply/detail?businessCode={businessCode}

### Parameters
#### Query Parameters
- **businessCode** (String) - Required - 收款单单号

### Response
#### Success Response (200)
- **message** (String) - 操作结果信息
- **errorCode** (String) - 错误码
- **data** (Object) - 收款单详情数据对象

#### Response Example
{
  "message": "operation completed",
  "errorCode": "0000",
  "data": {
      "businessCode": "AR5547304014",
      "amount": 550.0000,
      "status": 1004
  }
}
```

--------------------------------

### Accrual Write-Off Request Example

Source: https://opendocs.huilianyi.com/implement/business-data/expense-report/create-corp-expense-report.html

Example JSON payload for the OpenAccrualWriteOffRequestDTO, used to perform accrual write-offs.

```json
{
    "accrualWriteOffBusinessCode": "AC001",
    "accrualWriteOffLine": 123456789,
    "accrualWriteOffAmount": 100.00,
    "accrualLineCode": "ACL001",
    "ignoreAmountDifference": false
}
```
Tokens:
Raw