Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bill Lines
- 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 journalentries bulk
curl --request POST \
--url https://api.maesn.dev/accounting/journalEntries/bulk \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"accountNumberLength": "4",
"chartOfAccount": "SKR03",
"entries": [
{
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2025-06",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"description": "Invoice-3486 for services",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"dueDate": "2021-01-01T00:00:00Z",
"journalLineItems": [
{
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountNumber": 70001,
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"description": "Uitgesteld 21600001 Kantoor 06-2025",
"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": "2025-06-01T00:00:00Z"
}
],
"fiscalYearStartDate": "2025-01-01"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "433445",
"accountNumberLength": "4",
"chartOfAccount": "SKR03",
"createdDate": "2025-06-01T00:00:00Z",
"entries": [
{
"id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountingPeriodId": "2025-06",
"createdDate": "2025-06-01T00:00:00Z",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"description": "Invoice-3486 for services",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"dueDate": "2021-01-01T00:00:00Z",
"journalLineItems": [
{
"id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
"accountNumber": 70001,
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"description": "Uitgesteld 21600001 Kantoor 06-2025",
"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": "2025-06-01T00:00:00Z"
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"transactionDate": "2025-06-01T00:00:00Z",
"updatedDate": "2025-06-01T00:00:00Z"
}
],
"fiscalYearStartDate": "2025-01-01",
"taskId": "ABBDU8834993NND"
}
}
Field support per integration
Datev Rechnungswesen
Datev Rechnungswesen
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.
If you’re not using the Interactive Authentication Flow, make sure 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:
The accountNumberLength
field specifies the length of the G/L accounts.
The value must match the configuration defined in the end user’s mandate settings within the DATEV application.
Available options: SKR03
, SKR04
, SKR42
, SKR51
, SKR14
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
, ZWR
Available options: DEBIT
, CREDIT
DEBIT
indicates a debit on the accountNumber associated with the positive journal line amount.
CREDIT
indicates a credit on the accountNumber associated with the positive journal line amount.
The dimensions
field is used to categorize the journal entry with additional info such as cost centers, departments, projects.
Show properties
Show properties
The documentId
field is used to attach a document to the journal entry.
This is the ID of the document that have been previously uploaded using the POST Files
endpoint.
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Each journal entry must contain two journal line items. One with positive amount and one with negative amount.
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
YYYY-MM-DD date format, e.g., 2025-01-01
The fiscalYearStartDate
field should be set to the first day of the fiscal year, which is usually January 1st.
If your fiscal year begins on a different date, please adjust this field accordingly.
If the provided date does not match the actual fiscal year start date, DATEV will not return an error code. However, the journal entries will not be posted in Rechnungswesen.
Headers
API key
"example value"
Account key
"example value"
Query Parameters
Body
Response
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://api.maesn.dev/accounting/journalEntries/bulk \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"accountNumberLength": "4",
"chartOfAccount": "SKR03",
"entries": [
{
"accountId": "d1bfd23-517d-4ec6-b7d4-56f86c7cf246",
"accountingPeriodId": "2025-06",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"description": "Invoice-3486 for services",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"dueDate": "2021-01-01T00:00:00Z",
"journalLineItems": [
{
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountNumber": 70001,
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"description": "Uitgesteld 21600001 Kantoor 06-2025",
"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": "2025-06-01T00:00:00Z"
}
],
"fiscalYearStartDate": "2025-01-01"
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"id": "433445",
"accountNumberLength": "4",
"chartOfAccount": "SKR03",
"createdDate": "2025-06-01T00:00:00Z",
"entries": [
{
"id": "8df2df10-0fae-40ad-9d22-f25e5ab0ba23",
"accountId": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountingPeriodId": "2025-06",
"createdDate": "2025-06-01T00:00:00Z",
"currency": "EUR",
"debitCreditIndicator": "DEBIT",
"description": "Invoice-3486 for services",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"name": "Material/Waren"
}
],
"documentId": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
"dueDate": "2021-01-01T00:00:00Z",
"journalLineItems": [
{
"id": "94fdb7fd-13ae-47a6-8a2a-000e6ddc60d9",
"accountId": "da33b47c-98ca-4410-9c59-5db485ecaeb0",
"accountNumber": 70001,
"createdDate ": "2021-01-01T00:00:00Z",
"currency": "EUR",
"customerId": "782d89b56-13ae-47a6-8a2a-45e6ddc50d9",
"description": "Uitgesteld 21600001 Kantoor 06-2025",
"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": "2025-06-01T00:00:00Z"
}
],
"journalCode": "60",
"journalType": "FIN",
"number ": "21900030",
"transactionDate": "2025-06-01T00:00:00Z",
"updatedDate": "2025-06-01T00:00:00Z"
}
],
"fiscalYearStartDate": "2025-01-01",
"taskId": "ABBDU8834993NND"
}
}