费用类型

说明

每刻填写费用时的表单，本质是一个独立于单据本身的表单，表单上的字段类型如下

响应参数

参数说明

保证金/押金预付款类型

保证金/押金费用的预付款类型不再通过 noReceiptSubTypeCode、noReceiptSubTypeName、noReceiptType、noReceiptTypeName 等平铺字段返回。请从 customObject 中读取表单“预付款类型”字段，返回值复用选项对象结构：

{
  "customObject": {
    "noReceiptSubType": {
      "detailBusinessCode": "BID_DEPOSIT",
      "businessCode": "BID_DEPOSIT",
      "text": "投标保证金"
    }
  }
}

其中 noReceiptSubType 为示例 key，实际以费用表单字段的业务编码或 identifier 为准。

trainSeat火车席位

airClass飞机舱位

参数样例

[
  {
    "code": "CODE001",
    "expenseTypeBizCode": "EXPENSE001",
    "consumeAmount": {
      "currency": "CNY",
      "amount": 30
    },
    "comments": "备注信息",
    "airClass": {},
    "consumeTime": {
      "startTime": 1546272000000,
      "endTime": 1548950400000
    },
    "consumeLocation": {
      "departure": "domestic-ZH32-ZH32_1",
      "departureText": "杭州市",
      "destination": "domestic-ZH1-ZH1_0",
      "destinationText": "北京市"
    },
    "invoiceList": [],
    "corpExpense": true,
    "corpType": "ALL_RECEIPTS",
    "receiptAmount": {
      "currency": "CNY",
      "amount": 30
    },
    "nonReceiptAmount": {
      "currency": "CNY",
      "amount": 0
    },
    "forecastReceiptDate": {
      "startTime": 1546272000000,
      "endTime": 1546272000000
    },
    "tradingPartnerBizCode": "CODE001",
    "tradingPartnerParentBizCode": "121",
    "tradingPartnerName": "每刻科技有限公司",
    "recordDeductionAmount": {
      "currency": "CNY",
      "amount": 0
    },
    "customObject": {
      "CF1201": {
        "type": "AmountInput",
        "value": {
          "currency": "USD",
          "amount": 800
        }
      },
      "cityId": {
        "type": "CityInput",
        "value": {
          "code": "domestic-ZH32-ZH32_1",
          "text": "杭州市"
        }
      },
      "noReceiptSubType": {
        "detailBusinessCode": "BID_DEPOSIT",
        "businessCode": "BID_DEPOSIT",
        "text": "投标保证金"
      }
    },
    "expectedRecoveryDate": {
      "startTime": 1546272000000,
      "endTime": 1546272000000
    },
    "receiptMedium": "ELECTRONIC",
    "receiptAttachments": [
      {
        "name": "保证金收据.pdf",
        "url": "https://example.com/receipt.pdf",
        "pdfUrl": null
      }
    ],
    "splitTag": "NOT_SPLIT",
    "splitSourceCode": null,
    "orderDetailsFromDataHub": {
      "departureTime": "2020-06-28 10:12:12",
      "orderType": "CAR",
      "passengerName": "枚课",
      "orderId": "1600055903535",
      "payTime": "2020-06-28 12:12:12",
      "departureAddress": "未来park",
      "personalPayFee": 801,
      "remark": "我是备注呀，哈哈哈",
      "orderAt": "2020-06-28 12:12:12",
      "corpPayFee": 201,
      "carType": "经济型",
      "payType": "混合支付",
      "cityName": "宁波市",
      "totalFee": 1001,
      "arrivalTime": "2020-06-28 12:12:12",
      "arrivalAddress": "西溪银泰"
    },
    "deductionExpense": {
      "code": "EXPENSE_2110081APV9GU9",
      "deductionRuleCode": "RULE_211008ZWOF3P2",
      "deductionRuleName": "hs 逾期规则",
      "deductionTypeCode": "TYPE_211008ZWOF3P7",
      "deductionType": "EXPENSE_AMOUNT",
      "deductionTypeRateCode": "RATE_211008ZWOF3P9",
      "deductionTypeRate": 50.00,
      "startTime": 1633066971000,
      "endTime": 1633671805000,
      "consumeTime": 1633066971000,
      "expectAmount": 50.00,
      "expectAfterActualAmount": 50.00,
      "actualAmount": 50.00,
      "approvalAfterActualAmount": 50.00,
      "deductionStatus": true,
      "currency": "CNY",
      "operatorCode": "",
      "days": 7.00,
      "deductionInvoices": null
    },
    "travelPartnerInfo": {
      "externalTravelPartner": [
        {
          "name": "外部参与人",
          "employeeId": "",
          "departmentBizCode": "",
          "departmentName": "",
          "classPosition": {
            "name": "",
            "bizCode": ""
          },
          "gender": null,
          "enName": {
            "firstName": "",
            "middleName": "",
            "lastName": ""
          },
          "peopleNum": 1,
          "idInfo": {
            "idType": null,
            "idNumber": ""
          },
          "customObject": {
            "CF203": ""
          }
        }
      ],
      "internalTravelPartner": [
        {
          "name": "内部参与人A",
          "employeeId": "A001",
          "departmentBizCode": "D001",
          "departmentName": "部门001",
          "classPosition": {
            "name": "",
            "bizCode": ""
          },
          "gender": null,
          "enName": {
            "firstName": "",
            "middleName": "",
            "lastName": ""
          },
          "peopleNum": 1,
          "idInfo": {
            "idType": null,
            "idNumber": ""
          },
          "customObject": {}
        }
      ]
    },
    "corpExpenseResponsibleUser": [
      {
        "employeeNo": "352352",
        "userId": null,
        "text": "谢忠持"
      }
    ],
    "labourTax": {
      "amountType": "pre",
      "amount": {
        "currency": "CNY",
        "amount": 1000,
        "amountStr": "1000"
      },
      "preTaxAmount": {
        "currency": "CNY",
        "amount": 1000,
        "amountStr": "1000"
      },
      "withholdingTaxAmount": {
        "currency": "CNY",
        "amount": 40,
        "amountStr": "40"
      },
      "afterTaxAmount": {
        "currency": "CNY",
        "amount": 960,
        "amountStr": "960"
      }
    },
    "noTaxSuite": {
      "taxAmount": {
        "amount": 750,
        "currency": "CNY",
        "customExchangeRate": 1,
        "amountStr": "￥750.00"
      },
      "withoutTaxAmount": {
        "amount": 250,
        "currency": "CNY",
        "customExchangeRate": 1,
        "amountStr": "￥250.00"
      },
      "taxRate": 3
    }
  }
]

修改记录

2023-02-08  新增费用类型文档
2024-03-30  增加责任人
2024-07-12  增加不含税组件
2024-11-22  增加核销记录、支付记录
2026-05-29  增加保证金/押金预付款类型、收据介质、收据附件、预计回收日期返回字段
2026-06-29  调整保证金/押金预付款类型返回说明，预付款类型位于 customObject，收据介质和收据附件为费用明细顶层字段
2026-06-30  补充保证金/押金预付款类型 businessCode 和收据附件 pdfUrl 返回示例