费用类型
说明
每刻填写费用时的表单,本质是一个独立于单据本身的表单,表单上的字段类型如下
请求参数
参数说明
字段名称 | 字段类型 | 是否必填 | 字段说明 |
---|---|---|---|
code | String(100) | 是 | 费用内码,全局唯一 |
expenseTypeBizCode | String(100) | 是 | 费用类型编码 |
expenseTypeName | String(100) | 是 | 费用类型名称 |
viceExpenseTypeBizCode | String(100) | 否 | 辅助费用类型编码 |
viceExpenseTypeName | String(150) | 否 | 辅助费用类型名称 |
consumeAmount | AmountInput | 是 | 消费金额(消费币种) |
consumeBaseAmount | AmountInput | 是 | 消费本币金额 |
approvedAmount | AmountInput | 是 | 审批通过金额(收款币种,修改后金额) |
approvedBaseAmount | AmountInput | 是 | 审批通过本币金额(修改后金额) |
comments | String | 否 | 备注 |
airClass | String | 否 | 舱位(只有飞机标准关联了该费用类型才会有该字段,见下表) |
trainSeat | String | 否 | 座位(只有火车标准关联了该费用类型才会有该字段,见下表) |
consumeTime | DateTimeInput | 否 | 消费时间 |
consumeLocation | CityInput | 否 | 消费城市(字段类型具体看表单配置) |
invoiceList | List<InvoiceInput> | 否 | 发票 |
attachments | List<AttachmentInput> | 否 | 附件 |
allocationList | List<AllocationInput> | 是 | 分摊信息,每个费用至少有一条分摊 |
customObject | CustomObject | 是 | 自定义对象 |
invoiceStatus | int | 是 | 发票状态 |
invoiceSubmitTime | Long | 否 | 发票到票时间 |
invoiceExpectSubmitTime | Long | 否 | 发票预计到票时间 |
status | String(10) | 否 | OPEN 未报销;PROCESSING 已报销;HOLD 已移除;CLOSED 已报销;FREE 免报销 |
corpExpense | boolean | 是 | 是否对公费用 |
corpType | String(100) | 否 | 业务类型 ALL_RECEIPTS-全部到票 NO_RECEIPT-未到票 RECEIPT_DEDUCTION-到票核销 RECEIPT_PAY_SOME-到票部分支付或不支付 PAY_BEFORE_RECEIPT-支付前期已到的发票 |
receiptAmount | AmountInput | 否 | 到票金额 |
nonReceiptAmount | AmountInput | 否 | 未到票金额 |
forecastReceiptDate | DateTimeInput | 否 | 预计到票日期 |
tradingPartnerBizCode | String(100) | 否 | 往来单位业务编码 |
tradingPartnerName | String(150) | 否 | 往来单位业务名称 |
tradingPartnerPartnerBizCode | String(100) | 否 | 当前往来单位的上一级分类的编码 |
recordDeductionAmount | AmountInput | 否 | 核销未到票记录金额 |
payBeforeReceiptAmount | AmountInput | 否 | 支付前期已到的发票金额 |
splitTag | String | 是 | 费用拆分状态,NOTSPLIT-未被拆分,SPLIT_SOURCE拆分来源,SPLIT_TARGET-拆分后费用 |
splitSourceCode | String(150) | 否 | 拆分来源的费用Code |
deductionList | List<ExpenseDeductionInput> | 否 | 对公费用核销的数据 |
payBeforeDeductionList | List<PayBeforeDeductionInput> | 否 | 支付前期已到的发票的明细记录 |
sourceId | String(150) | 否 | 第三方订单id |
sourceType | String(150) | 否 | 第三方平台,清单 |
consumeToAcceptExchangeRate | BigDecimal | 是 | 消费币种到收款币种汇率 |
acceptToBaseExchangeRate | BigDecimal | 是 | 收款币种到公司抬头本币汇率 |
consumeToBaseExchangeRate | BigDecimal | 是 | 消费币种到公司抬头本币汇率 |
customExchangeRate | BigDecimal | 是 | 用户自定义的汇率 |
orderDetailsFromDataHub | CarOrderDto | 是 | 从datahub获取到的didi费用的订单详情 |
settleType | String(100) | 是 | personal_advance(个人垫付--员工自行垫资的消费,公司需按报销流程打款给员工) ent_paid_order(企业支付--企业代为支付的员工消费,无论是否报销,公司不会打款给员工) pay_afterwards(事后统一支付--员工自行垫资的消费或补贴,公司决定在报销流程结束后,统一支付给员工,不随流程支付) |
deductionExpense | DeductionExpenseDto | 否 | 费用的逾期扣款信息。例外费用:对公费用、含分摊的费用、含摊销的费用、负数费用、含收款明细的整单、拆分的费用、月结费用、有企业支付标记的费用 |
accrualReconcile | AccrualReconcileInput | 否 | 预提核销 |
detailTotalAmount | List<OpenApiTotalAmountDataDto> | 否 | 明细组件下的金额组件的总金额(计算后的)(C级字段) |
expenseDeductionTaxAmount | AmountInput | 否 | 费用级抵扣税额 |
travelPartnerInfo | TravelPartnerInfo | 否 | 行程参与人 |
labourTax | ExpenseLabourTaxDto | 否 | 劳务报酬个税 |
corpExpenseResponsibleUser | List<OpenApiStaffDataDto> | 否 | 责任人 |
formRankCode | String(100) | 否 | 费用表单序号 |
noTaxSuite | NoTaxSuiteInput | 否 | 不含税组件信息 |
trainSeat火车席位
字段编码 | 字段说明 |
---|---|
BUSINESS | 商务座 |
SPECIAL | 特等座 |
FIRST | 一等座 |
SECOND | 二等座 |
SOFT_SLEEPER | 软卧 |
ADVANCED_SOFT_SLEEPER | 高级软卧 |
HARD_SLEEPER | 硬卧 |
SOFT | 软座 |
HARD | 硬座 |
STANDING | 无座 |
airClass飞机舱位
字段编码 | 字段说明 |
---|---|
FIRST | 头等舱 |
BUSINESS | 商务舱 |
ECONOMY | 经济舱 |
参数样例
[{
"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": "杭州市"
}
}
},
"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 增加不含税组件