Get started
Integrations
- Overview
- Abacus
- bexio
- BuchhaltungsButler
- DATEV Rechnungswesen
- DATEV Unternehmen Online
- Exact Online
- fortnox
- FreeAgent
- FreshBooks
- Holded
- Lexware Office
- Microsoft Business Central
- Moneybird
- Odoo
- Pennylane
- Qonto
- QuickBooks
- Sage Accounting
- Sage Active
- sevdesk
- Snelstart
- Twinfield
- Visma eAcccounting
- Visma e-conomic
- weclapp
- Xentral
- Xero
Use cases
cURL
Copy
Ask AI
curl --request POST \
--url https://api.maesn.dev/accounting/journalEntries \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=<string>' \
--form filesPos=123 \
--form 'journal_entry={
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2021-06",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"isProvisional": "false",
"journalLineItems": [
{
"accountCode": "4034",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"transactionDate": "2021-01-01T00:00:00Z"
}' \
--form files.items='@example-file'Copy
Ask AI
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
}
},
"data": [
{
"id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountingPeriodId": "2021-06",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"files": [
"file1.pdf"
],
"isProvisional": "false",
"journalLineItems": [
{
"id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountCode": "4034",
"accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
"accountNumber": 8200,
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190,
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
]
}Journal Entries
Create journal entry
POST
/
accounting
/
journalEntries
cURL
Copy
Ask AI
curl --request POST \
--url https://api.maesn.dev/accounting/journalEntries \
--header 'Content-Type: multipart/form-data' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--form 'files=<string>' \
--form filesPos=123 \
--form 'journal_entry={
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2021-06",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"isProvisional": "false",
"journalLineItems": [
{
"accountCode": "4034",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"transactionDate": "2021-01-01T00:00:00Z"
}' \
--form files.items='@example-file'Copy
Ask AI
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 125,
"perPage": 50,
"currentPage": 1,
"totalPages": 3
}
},
"data": [
{
"id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountingPeriodId": "2021-06",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"description": "Hotel for dreamforce",
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"files": [
"file1.pdf"
],
"isProvisional": "false",
"journalLineItems": [
{
"id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountCode": "4034",
"accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
"accountNumber": 8200,
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"debitCreditIndicator": "DEBIT",
"description": "Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"categoryName": "CostCenter",
"code": "KD1",
"name": "Material/Waren"
}
],
"documentNumber": "123456789",
"exchangeRate": 1,
"supplierId": "998933b56-13ae-47a6-8a32a-45e6ddc50d9",
"taxRate": {
"id": "1895b05b-38a6-4a6a-9653-166389894350",
"code": "03",
"name": "Tax19",
"taxRatePercentage": "19"
},
"thirdPartyCode": "112233",
"totalGrossAmount": 1190,
"totalNetAmount": 1000,
"totalTaxAmount": 190,
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"transactionDate": "2021-01-01T00:00:00Z",
"updatedDate": "2021-01-01T00:00:00Z"
}
]
}Field support per integration
bexio
bexio
Supported Request Parameters:
Show properties
Show properties
Show properties
Show properties
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, ZWRThe
number field is optional. It can be used to define groups of journal entries with the same reference number.Business Central
Business Central
If you’re not using the Interactive Authentication Flow, make sure the query parameters
environmentName and companyId are correctly populated.
You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.Exact
Exact
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.Show properties
Show properties
accountingPeriodId accepted format: YYYY-MM .Show properties
Show properties
The
filesPos field is an array of line item positions (starting from 1) that correspond to each uploaded file.
The value at index i in filesPos refers to the line item that the file at index i in the files array should be linked to.
This field is required when uploading files.Example:
If you’re uploading 2 files, and you want to link the first file to line item 1 and the second file to line item 3:
filesPos: [1, 3]fortnox
fortnox
Supported Request Parameters:
Sage Active
Sage Active
If you’re not using the Interactive Authentication Flow, make sure the query parameters
environmentName and companyId are correctly populated.
You can obtain these values by using the GET Companies endpoint available under the Authentication section. Please use the id field as the companyId and the environmentId field as the environmentName.Twinfield
Twinfield
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.Show properties
Show properties
Note that each journal line can reference only one entity type. Please include only one of the following fields: customerId, supplierId, or dimension.
Odoo
Odoo
Xero
Xero
Supported Request Parameters:
Show properties
Show properties
Show properties
Show properties
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, ZWRHeaders
API key
Example:
"example value"
Account key
Example:
"example value"
Body
multipart/form-data
Array of files to upload
Array of file positions
Show child attributes
Show child attributes
Example:
"d1bfd23-517d-4ec6-b7d4-56f86c7cf246"
Example:
"2021-06"
Available options:
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 Example:
"EUR"
Example:
"Hotel for dreamforce"
Example:
"b5e624e5-fb9e-4836-a443-87a3820f5b48"
Example:
"false"
Show child attributes
Show child attributes
Example:
"4034"
Example:
"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9"
Available options:
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 Example:
"EUR"
Example:
"782d89b56-13ae-47a6-8a2a-45e6ddc50d9"
Available options:
DEBIT, CREDIT Example:
"DEBIT"
Example:
"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021"
Show child attributes
Show child attributes
Example:
"efa82f42-fd85-11e1-a21f-0800200c9a33"
Example:
"CostCenter"
Example:
"KD1"
Example:
"Material/Waren"
Example:
"123456789"
Example:
1
Example:
"998933b56-13ae-47a6-8a32a-45e6ddc50d9"
Show child attributes
Show child attributes
Example:
"112233"
Example:
1190
Example:
1000
Example:
190
Example:
"60"
Example:
"FIN"
Example:
"21900030"
Example:
"2021-01-01T00:00:00Z"
Response
200 - application/json
Show child attributes
Show child attributes
Example:
"8df2df10-0fae-40ad-9d22-f25e5ab0ba23"
Example:
"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9"
Example:
"2021-06"
Example:
"2021-01-01T00:00:00Z"
Available options:
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 Example:
"EUR"
Example:
"Hotel for dreamforce"
Example:
"b5e624e5-fb9e-4836-a443-87a3820f5b48"
Example:
"false"
Show child attributes
Show child attributes
Example:
"94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9"
Example:
"4034"
Example:
"da33b47c-98ca-4410-9c59-5db485ecaeb0"
Example:
8200
Example:
"2021-01-01T00:00:00Z"
Available options:
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 Example:
"EUR"
Example:
"782d89b56-13ae-47a6-8a2a-45e6ddc50d9"
Available options:
DEBIT, CREDIT Example:
"DEBIT"
Example:
"Uitgesteld 21600001 Kantoor 01-01-2021-31-12-2021"
Show child attributes
Show child attributes
Example:
"123456789"
Example:
1
Example:
"998933b56-13ae-47a6-8a32a-45e6ddc50d9"
Example:
"112233"
Example:
1190
Example:
1000
Example:
190
Example:
"2021-01-01T00:00:00Z"
Example:
"60"
Example:
"FIN"
Example:
"21900030"
Example:
"2021-01-01T00:00:00Z"
Example:
"2021-01-01T00:00:00Z"
Was this page helpful?
⌘I