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",
"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",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"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": "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",
"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",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"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": "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"
}
}
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",
"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",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"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": "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",
"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",
"dimensions": [
{
"id": "efa82f42-fd85-11e1-a21f-0800200c9a33",
"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": "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"
}
}
Datev Rechnungswesen
GET asyncTask
endpoint.For more info about asynchronous tasks visit the Asynchronous Task
section.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.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.SKR03
, SKR04
, SKR42
, SKR51
, SKR14
Show properties
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
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.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.Show properties
accountNumber
field must be a customer/supplier account if totalGrossAmount is positive; otherwise, a G/L account.dimensions
field is used to categorize the journal entry with additional info such as cost centers, departments, projects.Show properties
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.API key
"example value"
Account key
"example value"
The response is of type object
.
Was this page helpful?