平台级费用导入接口

业务场景

供云票等第三方平台将其他来源的费用导入每刻系统。平台传入云票企业编码，系统自动转换为对应的每刻企业编码后执行费用导入。

接口限制

10次/秒/企业

注意事项

1. 接口支持部分成功：单条费用失败不会影响同批次其他费用导入。
2. 每次最多导入 10 条费用。
3. 如需关联发票，可在费用导入成功后，将返回的 expenseCode 传给发票导入接口。
4. integrity=true 表示接口可识别的必填项已传完整；false 表示费用已导入但必填项不完整。

调用说明

调用前需通过平台级接口调用说明获取访问令牌，并在请求 Header 中传入 tokenId。

费用参数与原 OpenAPI 费用导入接口一致，详细字段请参考费用导入接口。

接口地址

/api/platform/receive/expense

请求类型

POST

请求参数

Body 参数

ReceivedExpenseReq

请求示例

{
  "entCode": "YUNPIAO_ENT_CODE",
  "expenseReq": {
    "employeeId": "EMP001",
    "expenseList": [
      {
        "expenseName": "差旅费"
      }
    ]
  }
}

响应参数

ExpenseImportResult

successData 元素

errorData 元素

响应示例

{
  "response_code": 0,
  "response_message": null,
  "data": {
    "successData": [
      {
        "idx": 0,
        "expenseCode": "EX2026042700001",
        "bizCode": "BIZ_001",
        "integrity": true
      }
    ],
    "errorData": []
  }
}

同批次存在失败数据时，成功数据仍返回在 successData，失败数据返回在 errorData，顶层 response_code 为 1008：

{
  "response_code": 1008,
  "response_message": "参数校验失败",
  "data": {
    "successData": [
      {
        "idx": 1,
        "expenseCode": "EX2026042700002",
        "bizCode": "BIZ_002",
        "integrity": true
      }
    ],
    "errorData": [
      {
        "idx": 0,
        "key": null,
        "errorCode": "10000",
        "errorMessage": "费用类型不存在"
      }
    ]
  }
}

异常响应

完整响应码请参考平台级接口响应码说明。

修改记录

2026-04-28  新增接口文档
2026-08-27  按当前平台费用导入接口更新并合入master文档