Skip to main content
POST
/
accounting
/
journalEntries
/
bulk
cURL
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",
      "exchangeRate": "1,2045",
      "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",
              "categoryName": "CostCenter",
              "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": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "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",
        "exchangeRate": "1,2045",
        "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",
                "categoryName": "CostCenter",
                "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"
  }
}

​
Field support per integration

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:
​
accountNumberLength
number
required
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.
​
chartOfAccount
string
required
Available options: SKR03, SKR04, SKR42, SKR51, SKR14
​
entries
JournalEntryRequestDto[]
​
fiscalYearStartDate
string
required
YYYY-MM-DD date format, e.g., 2025-01-01The 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

​
X-API-KEY
string
required

API key

Example:

"example value"

​
X-ACCOUNT-KEY
string
required

Account key

Example:

"example value"

Query Parameters

​
companyId
string

Body

application/json
​
accountNumberLength
number
Example:

"4"

​
chartOfAccount
enum<string>
Available options:
SKR03,
SKR04,
SKR42,
SKR51,
SKR14
Example:

"SKR03"

​
entries
object[]
​
fiscalYearStartDate
string
Example:

"2025-01-01"

Response

200 - application/json
​
meta
object
​
data
object