Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bill Lines
- Bookings
- Booking Proposals
- Contacts
- Customers
- Dimensions
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Journal Entries
- Offers
- Offer Lines
- Payments
- Payment Terms
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tax Rates
- Transactions
- Vendor Credits
- Authentication
- Tenant Management
- User
Create expense
curl --request POST \
--url https://api.maesn.dev/accounting/expenses \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=[
null
]' \
--form 'expense={
"accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
"currency": "EUR",
"customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
"documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
"exchangeRate": "1",
"expenseLines": [
{
"accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
"currency": "EUR",
"description": "Gasoline for business trip",
"documentNumber": "12345",
"exchangeRate": "1",
"itemId": "12345",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax rate name",
"taxRatePercentage": 21
},
"totalGrossAmount": "100",
"totalNetAmount": "100",
"trackingCategories": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
]
}
],
"journalCode": "60",
"memo": "Memo",
"paymentType": "CASH",
"supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
"type": "EXPENSE",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "5",
"transactionDate": "2021-01-01T00:00:00Z"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "9dea18d2-748e-4bda-9f4c-02b08a9622cd",
"accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
"documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
"exchangeRate": "1",
"expenseLines": [
{
"id": "b9dade6b-2b69-42c9-bcd4-841960f6cd9f",
"accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"description": "Gasoline for business trip",
"documentNumber": "12345",
"exchangeRate": "1",
"itemId": "12345",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax rate name",
"taxRatePercentage": 21
},
"totalGrossAmount": "100",
"totalNetAmount": "100",
"trackingCategories": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
],
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"files": [
"file1.pdf"
],
"journalCode": "60",
"memo": "Gasoline for business trip",
"paymentType": "CASH",
"supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
"taskId ": "ADB4457839PXTC2220",
"type": "EXPENSE",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "5",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
}
Field support per integration
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId
is correctly populated.
You can obtain this value by using the GET Companies
endpoint available under the Authentication section.
Supported Request Parameters:
Available options (3-letter ISO 4217):
AED
, AFN
, ALL
, AMD
, ANG
, AOA
, ARS
, AUD
, AWG
, AZN
, BAM
, BBD
, BDT
, BGN
, BHD
, BIF
, BMD
, BND
, BOB
, BRL
, BSD
, BTN
, BWP
, BYR
, BZD
, CAD
, CDF
, CHF
, CLP
, CNY
, COP
, CRC
, CUC
, CVE
, CZK
, DJF
, DKK
, DOP
, DZD
, EEK
, EGP
, ERN
, ETB
, EUR
, FJD
, FKP
, GBP
, GEL
, GHS
, GIP
, GMD
, GNF
, GQE
, GTQ
, GYD
, HKD
, HNL
, HRK
, HTG
, HUF
, IDR
, ILS
, INR
, IQD
, IRR
, ISK
, JMD
, JOD
, JPY
, KES
, KGS
, KHR
, KMF
, KPW
, KRW
, KWD
, KYD
, KZT
, LAK
, LBP
, LKR
, LRD
, LSL
, LTL
, LVL
, LYD
, MAD
, MDL
, MGA
, MKD
, MMK
, MNT
, MOP
, MRO
, MUR
, MVR
, MWK
, MXN
, MYR
, MZM
, NAD
, NGN
, NIO
, NOK
, NPR
, NZD
, OMR
, PAB
, PEN
, PGK
, PHP
, PKR
, PLN
, PYG
, QAR
, RON
, RSD
, RUB
, SAR
, SBD
, SCR
, SDG
, SEK
, SGD
, SHP
, SLL
, SOS
, SRD
, SYP
, SZL
, THB
, TJS
, TMT
, TND
, TRY
, TTD
, TWD
, TZS
, UAH
, UGX
, USD
, UYU
, UZS
, VEB
, VND
, VUV
, WST
, XAF
, XCD
, XDR
, XOF
, XPF
, YER
, ZAR
, ZMK
, ZWR
Available options:
EXPENSE
This endpoints is asynchronous. To check the status of the request, use the GET asyncTask
endpoint.
For more info about asynchronous tasks visit the Asynchronous Task
section.
Please ensure the query parameter companyId
is accurately populated with the appropriate company ID.
You can obtain this value by using the GET Companies
endpoint available under the Authentication section.
Supported Request Parameters:
Available options (3-letter ISO 4217):
AED
, AFN
, ALL
, AMD
, ANG
, AOA
, ARS
, AUD
, AWG
, AZN
, BAM
, BBD
, BDT
, BGN
, BHD
, BIF
, BMD
, BND
, BOB
, BRL
, BSD
, BTN
, BWP
, BYR
, BZD
, CAD
, CDF
, CHF
, CLP
, CNY
, COP
, CRC
, CUC
, CVE
, CZK
, DJF
, DKK
, DOP
, DZD
, EEK
, EGP
, ERN
, ETB
, EUR
, FJD
, FKP
, GBP
, GEL
, GHS
, GIP
, GMD
, GNF
, GQE
, GTQ
, GYD
, HKD
, HNL
, HRK
, HTG
, HUF
, IDR
, ILS
, INR
, IQD
, IRR
, ISK
, JMD
, JOD
, JPY
, KES
, KGS
, KHR
, KMF
, KPW
, KRW
, KWD
, KYD
, KZT
, LAK
, LBP
, LKR
, LRD
, LSL
, LTL
, LVL
, LYD
, MAD
, MDL
, MGA
, MKD
, MMK
, MNT
, MOP
, MRO
, MUR
, MVR
, MWK
, MXN
, MYR
, MZM
, NAD
, NGN
, NIO
, NOK
, NPR
, NZD
, OMR
, PAB
, PEN
, PGK
, PHP
, PKR
, PLN
, PYG
, QAR
, RON
, RSD
, RUB
, SAR
, SBD
, SCR
, SDG
, SEK
, SGD
, SHP
, SLL
, SOS
, SRD
, SYP
, SZL
, THB
, TJS
, TMT
, TND
, TRY
, TTD
, TWD
, TZS
, UAH
, UGX
, USD
, UYU
, UZS
, VEB
, VND
, VUV
, WST
, XAF
, XCD
, XDR
, XOF
, XPF
, YER
, ZAR
, ZMK
, ZWR
If you’re not using the Interactive Authentication Flow, make sure the query parameter companyId
is correctly populated.
You can obtain this value by using the GET Companies
endpoint available under the Authentication section.
Supported Request Parameters:
Supported Request Parameters:
Available options (3-letter ISO 4217):
AED
, AFN
, ALL
, AMD
, ANG
, AOA
, ARS
, AUD
, AWG
, AZN
, BAM
, BBD
, BDT
, BGN
, BHD
, BIF
, BMD
, BND
, BOB
, BRL
, BSD
, BTN
, BWP
, BYR
, BZD
, CAD
, CDF
, CHF
, CLP
, CNY
, COP
, CRC
, CUC
, CVE
, CZK
, DJF
, DKK
, DOP
, DZD
, EEK
, EGP
, ERN
, ETB
, EUR
, FJD
, FKP
, GBP
, GEL
, GHS
, GIP
, GMD
, GNF
, GQE
, GTQ
, GYD
, HKD
, HNL
, HRK
, HTG
, HUF
, IDR
, ILS
, INR
, IQD
, IRR
, ISK
, JMD
, JOD
, JPY
, KES
, KGS
, KHR
, KMF
, KPW
, KRW
, KWD
, KYD
, KZT
, LAK
, LBP
, LKR
, LRD
, LSL
, LTL
, LVL
, LYD
, MAD
, MDL
, MGA
, MKD
, MMK
, MNT
, MOP
, MRO
, MUR
, MVR
, MWK
, MXN
, MYR
, MZM
, NAD
, NGN
, NIO
, NOK
, NPR
, NZD
, OMR
, PAB
, PEN
, PGK
, PHP
, PKR
, PLN
, PYG
, QAR
, RON
, RSD
, RUB
, SAR
, SBD
, SCR
, SDG
, SEK
, SGD
, SHP
, SLL
, SOS
, SRD
, SYP
, SZL
, THB
, TJS
, TMT
, TND
, TRY
, TTD
, TWD
, TZS
, UAH
, UGX
, USD
, UYU
, UZS
, VEB
, VND
, VUV
, WST
, XAF
, XCD
, XDR
, XOF
, XPF
, YER
, ZAR
, ZMK
, ZWR
Available options:
EXPENSE
, REFUND
Query Parameters
Body
Response
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/expenses \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=[
null
]' \
--form 'expense={
"accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
"currency": "EUR",
"customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
"documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
"exchangeRate": "1",
"expenseLines": [
{
"accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
"currency": "EUR",
"description": "Gasoline for business trip",
"documentNumber": "12345",
"exchangeRate": "1",
"itemId": "12345",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax rate name",
"taxRatePercentage": 21
},
"totalGrossAmount": "100",
"totalNetAmount": "100",
"trackingCategories": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
]
}
],
"journalCode": "60",
"memo": "Memo",
"paymentType": "CASH",
"supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
"type": "EXPENSE",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "5",
"transactionDate": "2021-01-01T00:00:00Z"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "9dea18d2-748e-4bda-9f4c-02b08a9622cd",
"accountId ": "6527a18d2-748e-4bda-9f4c-02b08a9622cd",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "8a32de4f-55cc-4962-b000-a2a20662b821",
"documentId": "c77fbedb-1ff3-4fed-8716-4d3e3fc85ccf",
"exchangeRate": "1",
"expenseLines": [
{
"id": "b9dade6b-2b69-42c9-bcd4-841960f6cd9f",
"accountId": "56dec6c2-b14c-43ea-87bb-cc67b0ba2545",
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"description": "Gasoline for business trip",
"documentNumber": "12345",
"exchangeRate": "1",
"itemId": "12345",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax rate name",
"taxRatePercentage": 21
},
"totalGrossAmount": "100",
"totalNetAmount": "100",
"trackingCategories": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
],
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"files": [
"file1.pdf"
],
"journalCode": "60",
"memo": "Gasoline for business trip",
"paymentType": "CASH",
"supplierId": "52c049b9-91b7-4828-b346-e1eeadfa31dd",
"taskId ": "ADB4457839PXTC2220",
"type": "EXPENSE",
"totalGrossAmount": "100",
"totalNetAmount": "100",
"totalTaxAmount": "5",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
}