增量查询报销单
接口描述
此接口为增量接口用于按照报销单最后变更日期查询报销单。
旧版本的入口
已经通过旧版本接口读取报销单的客户,可以继续使用旧版本的接口进行读取
【Ver1.0 版本】
请求URI
/api/openapi/expense/reports/V2
请求方式
GET
请求参数示例
/api/openapi/expense/reports/V2?startTime=2020-01-01 00:00:00&endTime=2020-02-29 00:00:00&fetchApprovalHistory=false&page=1&size=20&status=1004,1005
请求参数说明
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
startTime | String | 是 | 查询开始时间。格式: yyyy-MM-dd HH:mm:ss |
endTime | String | 是 | 查询结束时间。格式: yyyy-MM-dd HH:mm:ss |
page | int | 是 | 页码, 第一页的page为1 |
size | int | 是 | 每页结果数。最大50 |
status | String | 是 | 报销单状态ID列表。 以 , 分隔 |
fetchApprovalHistory | Boolean | 否 | 默认值为false 是否返回审批历史 |
{
"total": 1,
"current": 1,
"pageSize": 20,
"pages": 1,
"hasPrevious": false,
"hasNext": false,
"data": [
{
"tenantId": 1214732595705114600,
"businessCode": "CKA0000000520",
"title": "経費精算",
"remark": "remark",
"createdDate": "2020-02-27T04:42:39Z",
"lastUpdatedDate": "2020-02-27T07:56:21Z",
"company": {
"oid": "13c79677-ad3a-427b-a9ef-1b33ad2100a4",
"name": "Test-COM",
"code": "SPD-COM-001",
"path": null
},
"department": {
"oid": "81782f23-61b7-49d3-8b36-2f087324b111",
"name": "DEP001",
"code": "DEP001",
"path": "DEP_ROOT|DEP001"
},
"applicant": {
"userOID": "489b3cc6-52d4-4647-a9e2-305c083dc727",
"fullName": "Spendia",
"employeeId": "00001",
"corporation": {
"oid": "13c79677-ad3a-427b-a9ef-1b33ad2100a4",
"name": "Test-COM",
"code": null,
"path": null
},
"company": {
"oid": "13c79677-ad3a-427b-a9ef-1b33ad2100a4",
"name": "Test-COM",
"code": null,
"path": null
},
"department": {
"oid": "84d3a264-a5f8-48bd-90c5-c0fa8b7051f1",
"name": "DEP001",
"code": "DEP001",
"path": null
}
},
"submittedBy": {
"userOID": "489b3cc6-52d4-4647-a9e2-305c083dc727",
"fullName": "Spendia",
"employeeId": "00001",
"corporation": null,
"company": null,
"department": null
},
"createdBy": {
"userOID": "489b3cc6-52d4-4647-a9e2-305c083dc727",
"fullName": "Spendia",
"employeeId": "00001",
"corporation": null,
"company": null,
"department": null
},
"lastApprovalDate": "2020-02-27T04:42:48Z",
"lastAuditApprovalDate": "2020-02-27T04:47:05Z",
"lastAuditApprovalCode": "100001",
"lastAuditApprovalName": "财务1",
"customForm": {
"formOID": "1f3a03b0-44ce-4965-a446-95f41f0136da",
"name": "Travel expense",
"type": null,
"code": "Form002",
"customFields": [
{
"formValueOID": "902342dd-0662-4ea7-bb9b-f954519e0bb2",
"fieldOID": "7a951104-e0df-4220-807f-83b86255d542",
"fieldName": "Payment Date",
"fieldCode": null,
"fieldType": "DATE",
"oid": "7a951104-e0df-4220-807f-83b86255d542",
"name": "Payment Date",
"type": "DATE",
"value": "2020-02-27",
"messageKey": "common.date"
}
]
},
"expenseReportOID": "41451e47-61a7-4f2c-894b-946e3fc1badd",
"status": "PAID",
"setOfBooksId": 1214732595927412700,
"baseReimbursementAmount": 0,
"generalLedgerDate": "2020-02-26T15:00:00Z",
"callbackJournalNo": "2020-02-27",
"personalPaymentBaseAmount": 200,
"actualPaymentBaseAmount": 200,
"baseCurrencyAmount": 200,
"type": 1001,
"costCenter": {
"oid": "7a951104-e0df-4220-807f-83b86255d542",
"name": "CC001",
"code": "CC001"
},
"invoices": [
{
"expenseReportInvoiceOID": "7db78010-2b03-4e02-971a-1c4b2723e53c",
"invoiceOID": "3e08288c-7f29-44f7-b2c5-ee45f75ce8cd",
"status": 1000,
"rejectReason": null,
"expenseType": {
"oid": null,
"name": "Taxi",
"code": "10010001",
"path": null
},
"costCenterItem": {},
"invoiceStatus": "SUBMITTED",
"unitPrice": null,
"quantity": null,
"expenseTaxType": null,
"baseCurrencyAmount": 183805,
"baseCurrencyCode": "JPY",
"baseCurrencyTaxExclusiveAmount": 91903,
"baseCurrencyFeeWithoutExemptedTax": 137854,
"baseCurrencyTaxAmount": 91902,
"baseCurrencyExemptedTaxAmount": 45951,
"originalCurrencyAmount": 1110,
"originalCurrencyCode": "EUR",
"originalCurrencyTaxExclusiveAmount": 555,
"originalCurrencyFeeWithoutExemptedTax": 832.5,
"originalCurrencyTaxAmount": 555,
"originalCurrencyExemptedTaxAmount": 277.5,
"originalCurrencyRate": "165.5903295",
"comment": "",
"createdDate": "2024-11-14T12:36:35+09:00",
"invoiceCreateDate": "2024-11-22T23:59:00+09:00",
"rateDate": "2024-11-15T17:56:00+09:00",
"lastUpdatedDate": "2024-11-14T12:36:34+09:00",
"data": [
{
"type": "LOCATION",
"code": null,
"name": "都市",
"value": "JPN046039000",
"messageKey": "location"
}
],
"receipt": {
"tax": 9,
"exemptedTax": 9,
"consumptionTaxCode": "T1001",
"billingDate": "2022-09-10",
"phoneNumber": "07043096073",
"shopName": "ビックカメラ",
"businessRegistrationNumber": "T2201845125542",
"businessCategory": "1001",
"businessRegistrationDate": "2022-09-10",
"taxDetails": [
{
"rate": 10,
"tax": 1111
},
{
"rate": 3,
"tax": 356
},
{
"rate": 2,
"tax": 240
}
],
"attachments": [{
"fileName": "添付ファイルのfile1.pdf",
"fileUrl": "https://spendia-dynamic-stage.s3.ap-northeast-1.amazonaws.com/29ad55e2-702d-43be-b525-1b7a173c452b/invoices/5bfc11df-5436-4920-8632-ee1ba74a3bea-%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88.xlsx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20231127T014901Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=AKIAJYC4KIDBXXJMJSNQ%2F20231127%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Signature=8c3324b7496df5df48a1eeb486fd89106c60e8d6836a51723f59a9db865d0bd7"
}]
},
"isApportionUsed": true,
"expenseApportion": [
{
"apportionOID": "c755f7b6-1820-4b0b-8831-3d3cfc12ceb6",
"expenseOID": "3e08288c-7f29-44f7-b2c5-ee45f75ce8cd",
"amount": 91,
"baseCurrencyAmount": 91,
"taxAmount": 9,
"exemptedTaxAmount": 9,
"baseTaxAmount": 9,
"baseExemptedTaxAmount": 9,
"apportionUser": null,
"apportionPercentage": 1,
"costCenterItems": [
{
"type": null,
"costCenterOID": "00000000-0000-0000-0000-000000000000",
"costCenterCode": null,
"itemOID": "81782f23-61b7-49d3-8b36-2f087324b111",
"itemCode": "SPD022012"
}
]
}
],
"invoiceCreateDate": "2020-02-27T04:42:41Z",
"originalCurrencyAmount": 1000,
"originalCurrencyCode": "CNY",
"originalCurrencyRate": 21.7,
"originalCurrencyTaxExclusiveAmount": 900,
"originalCurrencyFeeWithoutExemptedTax": 900,
"originalCurrencyTaxAmount": 100,
"originalCurrencyExemptedTaxAmount": 100,
"source": "jsnavi",
"creditCardDetail": "{\"id\":\"1621032153136889857\",\"companyCode\":\"11111\",\"paymentType\":\"COMPANY\",\"paymentName\":\"会社支払\",\"orderSequence\":\"2556595\",\"userCardId\":\"SC1006\",\"creditCardSearchKey\":\"JCSC1006\",\"userOID\":\"6faa8192-7969-4af1-8c30-bec6d35bd1f4\",\"useDate\":\"2023-02-02\",\"areaClassification\":\"F\",\"currency\":\"CNY\",\"originalAmount\":322,\"currencyRate\":1,\"amount\":\"322\",\"franchiseStoreName\":\"大阪テスト大阪テスト大阪テスト\",\"creditCardCompanyCode\":\"JC\",\"creditCardCompanyName\":\"JCB\",\"creditCardBrand\":\"MASTER\",\"taxiTicketNumber\":\"dd000004\",\"taxiTicketRemark\":\"山田\",\"etcCardNo\":\"2020000000000000eTCETCETCETCET\",\"etcCardMemberName\":\"ETC会員\",\"departurePlace\":\"大けやき前(会津美里町)/会津バス\",\"arrivalPlace\":\"大けやき前(会津美里町)/会津バス\",\"departmentCode\":\"DEFAULTDEP\",\"departmentName\":\"経理部\",\"userDepartmentCode\":\"DEFAULTDEP\",\"userDepartmentName\":\"経理部\",\"billingDate\":\"2023-02-02\",\"storePhone\":null,\"industryCode\":\"90\",\"other2\":\"\",\"other3\":\"\",\"expenseCreatedTime\":\"2023-02-08T14:25:56+09:00\",\"purpose\":\"BUSINESS\",\"isExpenseCreated\":false,\"expenseOID\":null,\"referenceId\":\"2556595card\",\"source\":\"jsnavi\",\"monthOrdersCount\":null,\"originalAmountStr\":\"322\",\"orderDate\":\"2023-02-02\"}"
}
],
"application":[
{
"type": "BORROW_APPLICATION",
"applicationOID": "74e13a10-512a-4443-b995-4d75a66b2fda",
"businessCode": "LA00237495",
"reimbursementAmount": 100.0
},
{
"type": "BORROW_APPLICATION",
"applicationOID": "74e13a10-512a-4443-b995-4d75a66b2fdb",
"businessCode": "LA00237496",
"reimbursementAmount": 101.0
}
],
"requests":[
{
"type": "TRAVEL",
"businessCode": "TA00650475",
"totalAmount": 102.0
}
],
"paymentLines": [
{
"id": 421,
"tenantId": 1074840362127142914,
"reimbursementBatchOID": null,
"entityType": 1002,
"entityOID": "9f53621c-6ad0-408a-8068-48946c4cb650",
"status": 1001,
"baseCurrencyCode": "JPY",
"baseAmount": 50.0000,
"paymentMethodName": "线上票据有银行",
"paymentMethodCategory": "ONLINE_PAYMENT",
"paymentMethodSubType": "BILL",
"paymentMethodCode": "098049283091221",
"paymentLineCustomFields": [
{
"fieldCode": "country",
"value": "AE"
}
],
"withBankInfo": true,
"estimatedPaymentDate": "2021-06-08",
"issueDepartmentOID": "3b4fa910-f2fa-4662-81bb-9dfdd696ca57",
"issueDepartmentName": "テスト-王|王様",
"issueDepartmentCode": "10100",
"issueDate": "2021-06-08",
"expiryDate": "2021-06-08",
"estimatedMaturityDate": "2021-06-08",
"receivingSupplier": "汇3",
"receivingSupplierId": 1153255526580518912,
"receivingPostalCode": "123123",
"receivingAddress": "撒阿萨大大萨瓦青蛙大大",
"checkNetNo": "444",
"payeeBankId": 1374973747813957632,
"payeeBankCode": "0000",
"payeeBankName": "日本銀行",
"payeeBranchId": 0,
"payeeBranchCode": "093",
"payeeBranchName": "本店",
"payeeAccountType": "1",
"payeeAccountNo": "8975645",
"payeeAccountName": "明",
"payeeAccountFbName": "アキラ",
"country": "CHINA",
"overseaBankName": "CHINABANK",
"overseaBranchName": "PUDONG",
"overseaAccount": "231030202838383838",
"overseaPayeeName": "YANYINGMING",
"overseaBranchAddress": "YAOHUALU333",
"overseaPayeeAddress": "MUDANJIANGLU2223",
"internationalBalanceOfPaymentsItemCode": "3333",
"remittancePurpose": "FEEPAYMENT",
"licenceNo": "2314",
"licenceDate": "2021-06-08",
"appointmentCode": "9876",
"message": "check",
"commissionChargeParty": null,
"baseDate": "2021-06-08",
"applicantPostOID": "5d614e18-8327-11eb-b360-0a405f8b1a98"
}
],
"paymentConfirmInfos": [
{
"paymentLineId": "152174",
"reimbursementBatchName": "20240429271676520638817345084",
"paymentDate": "2024-05-10",
"createdDate": "2024-04-29",
"paymentCurrency": "JPY",
"paymentType": "FBデータ",
"paymentCategoryCode": "1005",
"paymentCategoryName": "ONLINE_PAYMENT",
"paymentExchangeRate": 1.0,
"paymentRemaker": "備考1",
"bankInfo": {
"bankcode": "0000",
"branchBankCode": "093",
"bankAccount": "XXXXXX",
"bankName": "XXXXXX"
}
},
{
"paymentLineId": "152175",
"reimbursementBatchName": "20240429271676520638817345084",
"paymentDate": "2024-05-11",
"createdDate": "2024-04-29",
"paymentCurrency": "JPY",
"paymentType": "FBデータ",
"paymentCategoryCode": "1005",
"paymentCategoryName": "ONLINE_PAYMENT",
"paymentExchangeRate": 1.0,
"paymentRemaker": "備考2",
"bankInfo": {
"bankcode": "0000",
"branchBankCode": "094",
"bankAccount": "XXXXXX",
"bankName": "XXXXXX"
}
}
],
"sourceTaxations": [
{
"expenseReportOID": "24fba3d1-ce6f-4219-be3d-397d821f5c4b",
"id": 1400377252788600834,
"sourceTaxCategoryId": 1074936017499635714,
"sourceTaxCategoryCode": "01",
"sourceTaxCategoryName": "切り捨て法(税込)",
"basicRate": 0.10210,
"levyType": "CORP",
"paymentAmount": 300.0000,
"taxableAmount": null,
"sourceTaxAmount": null
}
]
}
]
}
トラマネ(TM)的返回例
{
"source": "tm",
"tmRouteDetail": "{\"id\":\"1643137652967493634\",\"payDate\":\"2023-04-04\",\"payment\":\"950\",\"categoryCode\":\"BUS\",\"depStationName\":\"三鷹\",\"arvStationName\":\"中野\",\"depCompanyName\":\"JR東日本1\",\"arvCompanyName\":\"JR東日本2\",\"purpose\":\"BUSINESS\",\"expenseOID\":null,\"expenseCreated\":false,\"userOID\":\"428bcdaf-db13-4962-8457-aa862fda1346\",\"tenantId\":\"1262289482059026433\",\"companyId\":\"1743\",\"remark\":\"spendia测试\",\"monthOrdersCount\":null,\"orderDate\":\"2023-04-04\",\"amount\":\"950\"}"
}
経路明細的返回例
{
"source": "transfer",
"routeDetails": {
"routeDetail": "{\"date\":\"2023-04-03T15:00:00Z\",\"price\":208,\"amount\":208,\"name\":\"東京--JR山手線内回り--秋葉原--JR総武線--御茶ノ水--JR中央線快速--新宿\",\"time\":16,\"arrivalTime\":null,\"departureTime\":null,\"isRound\":false}",
"routeInfoDetail": "{\"leFlag\":false,\"anFlag\":true,\"isRound\":false,\"time\":26,\"timeOnBoard\":16,\"departure\":\"東京\",\"arrival\":\"新宿\",\"LimitedExpress\":\"指定席\",\"OtherService\":\"新幹線eチケット\"}"
}
}
接口返回字段
PageResposne
参数名 | 类型 | 说明 |
---|---|---|
total | int | 查询结果总个数 |
current | int | 当前页数 |
pageSize | int | 每页结果计 |
pages | int | 查询结果总分页数 |
hasPrevious | boolean | 是否有上一页 |
hasNext | boolean | 是否有下一页 |
data | ExpenseReport[] | 报销单列表 |
ExpenseReport
参数名 | 类型 | 规则 | 说明 |
---|---|---|---|
expenseReportOID | UUID | 长度 36 | 租户OID |
tenantId | Long | 租户ID | |
businessCode | String | 最大长度 36 | 报销单号 |
title | String | 最大长度 500 | 事由 |
remark | String | 最大长度 255 | 描述 |
createdDate | ZonedDateTime | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 创建时间 |
lastUpdatedDate | ZonedDateTime | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 最后更新时间 |
company | EntitySummary | 单据关系公司 | |
department | EntitySummary | 单据关系部门 | |
applicant | UserSummary | 申请人 | |
submittedBy | UserSummary | 提交人 | |
createdBy | UserSummary | 创建人 | |
lastApprovalDate | String | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 最后审批时间 |
lastAuditApprovalDate | String | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 最后审核时间 |
lastAuditApprovalCode | String | 最后审核人工号 | |
lastAuditApprovalName | String | 最后审核人名称 | |
customForm | CustomForm | 关联自定义表单 | |
approvalHistories | ApprovalHistory[] | 审批历史 | |
status | String | 单据状态 参照 StatusType | |
setOfBooksId | String | 账套ID | |
baseReimbursementAmount | BigDecimal | 小数点位数由货币决定 | 本币还款金额 |
generalLedgerDate | ZonedDateTime | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 过账日期 |
callbackJournalNo | String | 回写凭证 | |
personalPaymentBaseAmount | BigDecimal | 小数点位数由货币决定 | 个人支付本位币金额 |
actualPaymentBaseAmount | BigDecimal | 小数点位数由货币决定 | 报销单实发本位币金额 |
baseCurrencyAmount | BigDecimal | 小数点位数由货币决定 | 报销单总金额 |
type | int | 报销单类型 1. 1001-日常报销单;1002-差旅报销单;1003-费用报销单 | |
costCenter | CostCenter | 报销单所属成本中心 | |
invoices | ExpenseReportInvoice[] | 费用列表 | |
application | Application[] | 报销单关联借款单列表 | |
requests | DataEntity[] | 报销单关联申请单列表 | |
paymentLines | PaymentLine[] | 付款行数据列表 | |
paymentConfirmInfos | paymentConfirmInfo[] | 付款确认列表 | |
sourceTaxations | ExpenseReportSourceTaxation[] | 源泉税明细 |
StatusType
枚举值 | 枚举名 | 说明 |
---|---|---|
1001 | INIT | (新建、撤回、审批驳回、审核驳回、反冲驳回) |
1002 | SUBMIT | 提交审批 |
1003 | PASSED | 审批通过 |
1004 | FINANCE_AUDIT_PASSED | 审核通过 |
1005 | PAID | 已付款 |
1008 | PAYMENT_IN_PROCESS | 付款中 |
1020 | COMPLETION | 完了 |
UserSummary
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
userOID | UUID | 长度 36 | 用户OID |
fullName | String | 最大长度 100 | 员工姓名 |
employeeId | String | 最大长度 32 | 员工姓名 |
corporation | EntitySummary | 法人实体 | |
company | EntitySummary | 归属公司 | |
department | EntitySummary | 部门 |
EntitySummary
字段名 | 类型 | 必填 | 约束 | 说明 |
---|---|---|---|---|
oid | UUID | 否 | 长度 36 | 实体OID |
name | String | 否 | 长度 50 | 实体name |
code | String | 否 | 长度 50 | 实体Code |
path | String | 实体path(仅部门) |
CustomForm
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
formOID | UUID | 长度 36 | 表单OID |
name | String | 最大长度 100 | 表单名称 |
code | String | 最大长度 100 | 表单编码 |
customFields | CustomField[] | 自定义字段列表 |
CustomField
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
formValueOID | UUID | 最大长度 36 | 自定义字段业务OID |
fieldOID | UUID | 最大长度 36 | 自定义字段OID |
fieldName | String | 最大长度 100 | 自定义字段名称 |
fieldCode | String | 最大长度 50 | 自定义字段编码 |
fieldType | String | 最大长度 50 | 自定义字段类型 |
value | String | 最大长度 1000 | 自定义字段值 |
valueName | String | 最大长度 1000 | 自定义字段值名称 |
valueCode | String | 最大长度 100 | 自定义字段值编码(仅针对控件(成本中心 、部门、自定义列表、付款方式)增加) |
ApprovalHistory
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
operationType | Integer | 参见ApprovalOperationType | 操作类别 |
operation | Integer | 参见 ApprovalOperation | 操作类型 |
operationDetail | String | 最大长度 1000 | 操作备注 |
remark | String | 最大长度 1000 | 操作备注(补充) |
approvalDate | String | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 审批时间 |
operator | UserSummary | 参见引用说明 | 操作人 |
submitter | UserSummary | 参见引用说明 | 提交人 |
applicant | UserSummary | 参见引用说明 | 申请人 |
ApprovalOperationType
枚举值 | 说明 |
---|---|
1001 | 自己 |
1002 | 审批人 |
1003 | 财务 |
1004 | 开票 |
1005 | 还款财务审批 |
1006 | 系统 |
1007 | 订票专员 |
1008 | 订票申请价格审核人 |
1009 | 管理员 |
1010 | 已发送确认人 |
1011 | 反冲 |
ApprovalOperation
枚举值 | 说明 | 申请单 | 报销单 | 借款单 |
---|---|---|---|---|
1001 | 提交审批 | Y | Y | Y |
1002 | 撤回 | Y | Y | Y |
1003 | 申请单更改 | Y | - | - |
1004 | 审批中 | Y | Y | Y |
1014 | 已确认 | Y | Y | Y |
2001 | 审批通过 | Y | Y | Y |
2002 | 审批驳回 | Y | Y | Y |
2003 | 审批驳回费用 | - | Y | - |
3001 | 审核通过 | - | Y | Y |
3002 | 审核驳回 | - | Y | Y |
3003 | 财务已收单 | - | Y | - |
3005 | 退单 | - | Y | - |
3006 | 审核通知 | - | Y | Y |
3007 | 寄出 | - | Y | - |
3008 | 审核反冲 | - | Y | Y |
3009 | 申请人完了 | - | Y | Y |
4000 | 付款中确认 | - | Y | Y |
4001 | 财务已付款 | - | Y | Y |
4002 | 财务付款失败 | - | Y | Y |
5000 | APP还款提交 | - | - | Y |
5001 | 现金还款提交 | - | - | Y |
5002 | 财务收款通过 | - | - | Y |
5003 | 财务收款驳回 | - | - | Y |
5004 | 报销单还款提交 | - | Y | - |
5005 | 申请单关闭 | Y | - | - |
5006 | 用户停用申请单 | Y | - | - |
5007 | 用户重启申请单 | Y | - | - |
5008 | 中间件停用申请单 | Y | - | - |
5009 | 添加会签 | Y | Y | Y |
5010 | 转交 | Y | Y | Y |
5011 | 管理员转交 | Y | Y | Y |
5020 | 付款反冲 | - | Y | Y |
8001 | 财务员工交互 | - | Y | Y |
8002 | 财务附件上传 | - | Y | Y |
8003 | 财务附件删除 | - | Y | Y |
9001 | 管理员审批跳转 | Y | Y | Y |
9003 | 催办 | Y | Y | Y |
ExpenseReportInvoice
参数名 | 类型 | 规则 | 说明 |
---|---|---|---|
expenseReportInvoiceOID | UUID | 长度 36 | 报销单费用关联OID |
invoiceOID | UUID | 长度 36 | 费用OID |
status | String | 费用状态值 | |
rejectReason | String | 最大长度 500 | 驳回理由 |
expenseType | EntitySummary | 费用类型 | |
costCenterItem | EntitySummary | 成本中心项 | |
invoiceStatus | String | 费用状态枚举名 | |
unitPrice | String | 单价 | |
quantity | String | 数量 | |
expenseTaxType | Integer | 费用类型 1001:不含税 1002:含税 1003:非课税 | |
baseCurrencyAmount | Double | 本位币金额 | |
baseCurrencyCode | String | 本位币种 | |
baseCurrencyTaxExclusiveAmount | Double | 本位币不含税额 | |
baseCurrencyFeeWithoutExemptedTax | Double | 本位币不含税额(税额减免后) | |
baseCurrencyTaxAmount | Double | 本位币税额 | |
baseCurrencyExemptedTaxAmount | Double | 本位币税额(税额减免后) | |
comment | String | 事由 | |
createdDate | ZonedDateTime | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 创建时间 |
lastUpdatedDate | ZonedDateTime | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 最后更新时间 |
data | ExpenseField[] | 费用自定义字段 | |
receipt | Receipt | 费用关联发票 | |
isApportionUsed | Boolean | 是否使用分摊 | |
expenseApportion | ExpenseApportion[] | 费用分摊列表 | |
invoiceCreateDate | Date | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 费用发生日期 |
rateDate | Date | 时间格式:yyyy-MM-dd'T'HH:mm:ssZ | 汇率日期 |
originalCurrencyAmount | Double | 原币金额 | |
originalCurrencyCode | String | 原币种 | |
originalCurrencyRate | Double | 原币汇率 | |
originalCurrencyTaxExclusiveAmount | Double | 原币不含税额 | |
originalCurrencyFeeWithoutExemptedTax | Double | 原币不含税额(税额减免后) | |
originalCurrencyTaxAmount | Double | 原币税额 | |
originalCurrencyExemptedTaxAmount | Double | 原币税额(税额减免后) | |
source | String | 费用来源 jsnavi:信用卡 tm:TM btos:BTOS transfer:经路检索(短距离) routeSearch:经路检索 空白:手工创建 | |
creditCardDetail | String | 信用卡数据详情 useDate:利用日 creditCardCompanyCode:信用卡公司编码 creditCardCompanyName:信用卡公司名称 creditCardBrand:信用卡品牌 franchiseStoreName:使用店名称 currency:原币种 originalAmount:原币金额 currencyRate:汇率 amount:日币金额 billing_date:结算日 | |
tmRouteDetail | String | TM数据详情 categoryCode:消费项目 depStationName:进站车站 arvStationName:出站车站 depCompanyName:运营公司(进站车站) arvCompanyName:运营公司(出站车站) amount:金额 | |
routeDetails | RouteDetail | 换乘明细数据详情 |
Application
参数名 | 类型 | 规则 | 说明 |
---|---|---|---|
type | String | 类型 | |
applicationOID | UUID | 借款单OID | |
businessCode | String | 借款单号 | |
reimbursementAmount | BigDecimal | 核销金额 |
RouteDetail
参数名 | 类型 | 规则 | 说明 |
---|---|---|---|
routeDetail | String | 换乘区间 time:乘车时间 name:换乘区间 price:单价 amount:金额 | |
routeInfoDetail | String | 换乘区间详情 time:所需时间 leFlag:乐表示 anFlag:安表示 isRound:单程/往返 departure:出发地 arrival:到达地 LimitedExpress:特急料金 OtherService:其他服务 |
ExpenseField
参数名 | 类型 | 规则 | 说明 |
---|---|---|---|
type | String | 长度 36 | 字段类型 |
code | String | 最大长度 50 | 自定义字段编码 |
name | String | 最大长度 50 | 自定义字段名称 |
value | String | 最大长度 255 | 自定义字段值 |
messageKey | String | 最大长度 100 | 字段编码 |
valueCode | String | 最大长度 255 | 主数据时,页面显示的编码 |
valueName | String | 最大长度 255 | 主数据时,页面显示的名称 |
compositeIndex | Int | 组合控件编号 | |
parentCompositeIndex | Int | 父控件编号 |
Receipt
参数名 | 类型 | 规则 | 说明 |
---|---|---|---|
tax | BigDecimal | 税金 | |
exemptedTax | BigDecimal | 税金(税额减免后) | |
consumptionTaxCode | String | 长度 100 | 消费税代码 |
billingDate | Date | 日期格式:yyyy-MM-dd | 开票日期 |
phoneNumber | String | 电话号码 | |
shopName | String | 店名 | |
businessRegistrationNumber | String | 事业者登记编号 | |
businessCategory | Integer | 1001:课税事业者 1002:免税事业者 | 事业者类别 |
businessRegistrationDate | Date | 日期格式:yyyy-MM-dd | 事业者登记日期 |
taxDetails | taxDetails[] | 税明细 | |
attachments | attachments[] | 附件列表 |
taxDetails
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
rate | number | 税明细税率 | |
tax | number | 税明细税额 |
ExpenseApportion
参数名 | 类型 | 规则 | 说明 |
---|---|---|---|
apportionOID | UUID | 长度 36 | 分担OID |
expenseOID | UID | 长度 36 | 費用OID |
amount | BigDecimal | 費用金額 | |
baseCurrencyAmount | BigDecimal | 主要通貨金額 | |
taxAmount | BigDecimal | 元通貨税額 | |
exemptedTaxAmount | BigDecimal | 元通貨税額(税额减免后) | |
baseTaxAmount | BigDecimal | 主要通貨税額 | |
baseExemptedTaxAmount | BigDecimal | 主要通貨税額(税额减免后) | |
apportionUser | UserSummary | 分担先 | |
apportionPercentage | BigDecimal | 分担割合 | |
costCenterItems | CostCenterItem[] | 成本中心项一覧 |
CostCenterItem
参数名 | 类型 | 规则 | 说明 |
---|---|---|---|
type | String | 类型 | |
costCenterOID | UUID | 长度 36 | 成本中心OID |
costCenterCode | String | 长度 100 | 成本中心编码 |
itemOID | UUID | 长度 36 | 成本中心项OID |
itemCode | String | 长度 100 | 成本中心项目编码 |
PaymentLine
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
id | Long | 付款行ID | |
tenantId | Long | 租户ID | |
reimbursementBatchOID | UUID | 付款批次oid | |
entityType | Integer | 单据类型 1001申请单;1002报销单 | |
entityOID | UUID | 单据oid | |
status | Integer | 状态 1001未付款;1008付款中1005已付款 | |
baseCurrencyCode | String | 币种 | |
baseAmount | BigDecimal | 金额 | |
paymentMethodName | String | 付款方式名称 | |
paymentMethodCategory | String | 付款类型 ONLINE_PAYMENT线上 OFFLINE_PAYMENT线下 EBANK_PAYMENT落地文件 | |
paymentMethodSubType | String | 付款子类型 BILL单据;OTHER其他 | |
paymentMethodCode | String | 付款方式 | |
paymentLineCustomFields | PaymentLineCustomField[] | 付款方式自定义字段列表 | |
withBankInfo | Boolean | 是否显示银行 | |
estimatedPaymentDate | LocalDate | 预计付款日期 | |
issueDepartmentOID | UUID | 出票方部门OID | |
issueDepartmentName | String | 出票方部门名称 | |
issueDepartmentCode | String | 出票方部门编码 | |
issueDate | LocalDate | 出票日期 | |
expiryDate | LocalDate | 到期日期 | |
estimatedMaturityDate | LocalDate | 预计到账日期 | |
receivingSupplier | String | 收票供应商 | |
receivingSupplierId | Long | 收票供应商id-非闪付选择 | |
receivingPostalCode | String | 收票邮编 | |
receivingAddress | String | 收票地址 | |
checkNetNo | String | 电债NetNO | |
payeeBankId | Long | 收款银行id | |
payeeBankCode | String | 收款银行编码 | |
payeeBankName | String | 收款银行名称 | |
payeeBranchId | Long | 收款支行id | |
payeeBranchCode | String | 收款支行编码 | |
payeeBranchName | String | 收款支行名称 | |
payeeAccountType | String | 收款账户类别 | |
payeeAccountNo | String | 收款银行账号 | |
payeeAccountName | String | 收款账户名 | |
payeeAccountFbName | String | 收款账户名fb用 | |
commissionChargeParty | String | 银行手续费负担方 | |
baseDate | LocalDate | 基准日期 | |
applicantPostOID | UUID | 申请人岗位oid | |
country | String | 国家 | |
overseaBankName | String | 海外FB用银行名称 | |
overseaBranchName | String | 海外FB用支行名 | |
overseaAccount | String | 海外FB用银行账号 | |
overseaPayeeName | String | 海外FB用收款人名 | |
overseaBranchAddress | String | 海外FB用支行地址 | |
overseaPayeeAddress | String | 海外FB用收款人地址 | |
internationalBalanceOfPaymentsItemCode | String | 国际收支项目编码 | |
remittancePurpose | String | 汇款目的 | |
licenceNo | String | 许可证No. | |
licenceDate | LocalDate | 许可证日期 | |
appointmentCode | String | 预约编码 | |
message | String | 信息 |
paymentConfirmInfo
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
paymentLineId | Long | 付款行ID | |
reimbursementBatchName | Long | 付款批次编码 | |
paymentDate | Date | 付款日 | |
createdDate | Date | 付款确认操作日 | |
paymentCurrency | String | 币种 | |
paymentType | String | 付款方式类型 | |
paymentCategoryCode | String | 付款方式编码 | |
paymentCategoryName | String | 付款方式名称 | |
paymentExchangeRate | Double | 汇率 | |
paymentRemaker | String | 备注 | |
bankInfo | bankInfo | 付款银行信息 |
bankInfo
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
bankcode | String | 银行编码 | |
branchBankCode | String | 支行编码 | |
bankAccount | String | 银行账号 | |
bankName | String | 账户名 |
PaymentLineCustomField
参数名 | 类型 | 约束 | 说明 |
---|---|---|---|
fieldCode | String | 最大长度 50 | 自定义字段编码 |
value | String | 最大长度 1000 | 自定义字段值 |
ExpenseReportSourceTaxation
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
expenseReportOID | UUID | 报销单oid | |
id | Long | 源泉税项目id | |
sourceTaxCategoryId | Long | 源泉税报酬类别id | |
sourceTaxCategoryCode | String | 源泉税报酬类别编码 | |
sourceTaxCategoryName | String | 源泉税报酬类别名称 | |
basicRate | BigDecimal | 基本税率 | |
levyType | String | 源泉税征收类型 NONE不征收源泉税;CORP征收源泉税(法人);INDIV征收源泉税(个人) | |
paymentAmount | BigDecimal | 支付金额 | |
taxableAmount | BigDecimal | 需纳税金额 | |
sourceTaxAmount | BigDecimal | 源泉税金额 |
attachment(file)
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
fileName | String | 附件 | |
fileUrl | String | 附件URL |
DataEntity
字段名 | 类型 | 规则 | 说明 |
---|---|---|---|
type | String | 单据类型 | |
businessCode | String | 最大长度36 | 单号 |
totalAmount | BigDecimal | 总金额 |
失败示例
{
"message": "传入参数格式异常:1002;90,正确格式为:1,2,3",
"errorCode": "120005"
}
字段说明
字段名称 | 类型 | 说明 |
---|---|---|
message | String | 返回信息说明 |
errorCode | String | 返回错误码 |
错误代码
errorCode | message | 说明 |
---|---|---|
120005 | 传入参数格式异常:{0},正确格式为:{1} |