Skip to main content
POST
/
accounting
/
bookings
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/bookings \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "accounNumbertLength": "4",
  "chartOfAccount": "SKR03",
  "entries": [
    {
      "accountNumber": "70000",
      "amount": "1500",
      "bookingDate": "2021-01-01T00:00:00Z",
      "bookingTaxCode": "9",
      "bookingType": "PARTIAL_INVOICE",
      "contraAccountNumber": "4900",
      "currency": "EUR",
      "description": "payment",
      "dimension1": "Marketing",
      "dimension2": "Service and Maintenance",
      "documentNumber": "Rg32029/2024",
      "dueDate": "2021-01-01T00:00:00Z",
      "fileId": "AA7N4ICJ0SJIU38"
    }
  ],
  "fiscalYearStartDate": "2025-01-01"
}
'
import requests

url = "https://api.maesn.dev/accounting/bookings"

payload = {
    "accounNumbertLength": "4",
    "chartOfAccount": "SKR03",
    "entries": [
        {
            "accountNumber": "70000",
            "amount": "1500",
            "bookingDate": "2021-01-01T00:00:00Z",
            "bookingTaxCode": "9",
            "bookingType": "PARTIAL_INVOICE",
            "contraAccountNumber": "4900",
            "currency": "EUR",
            "description": "payment",
            "dimension1": "Marketing",
            "dimension2": "Service and Maintenance",
            "documentNumber": "Rg32029/2024",
            "dueDate": "2021-01-01T00:00:00Z",
            "fileId": "AA7N4ICJ0SJIU38"
        }
    ],
    "fiscalYearStartDate": "2025-01-01"
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "X-ACCOUNT-KEY": "<x-account-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {
    'X-API-KEY': '<x-api-key>',
    'X-ACCOUNT-KEY': '<x-account-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accounNumbertLength: '4',
    chartOfAccount: 'SKR03',
    entries: [
      {
        accountNumber: '70000',
        amount: '1500',
        bookingDate: '2021-01-01T00:00:00Z',
        bookingTaxCode: '9',
        bookingType: 'PARTIAL_INVOICE',
        contraAccountNumber: '4900',
        currency: 'EUR',
        description: 'payment',
        dimension1: 'Marketing',
        dimension2: 'Service and Maintenance',
        documentNumber: 'Rg32029/2024',
        dueDate: '2021-01-01T00:00:00Z',
        fileId: 'AA7N4ICJ0SJIU38'
      }
    ],
    fiscalYearStartDate: '2025-01-01'
  })
};

fetch('https://api.maesn.dev/accounting/bookings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.maesn.dev/accounting/bookings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accounNumbertLength' => '4',
    'chartOfAccount' => 'SKR03',
    'entries' => [
        [
                'accountNumber' => '70000',
                'amount' => '1500',
                'bookingDate' => '2021-01-01T00:00:00Z',
                'bookingTaxCode' => '9',
                'bookingType' => 'PARTIAL_INVOICE',
                'contraAccountNumber' => '4900',
                'currency' => 'EUR',
                'description' => 'payment',
                'dimension1' => 'Marketing',
                'dimension2' => 'Service and Maintenance',
                'documentNumber' => 'Rg32029/2024',
                'dueDate' => '2021-01-01T00:00:00Z',
                'fileId' => 'AA7N4ICJ0SJIU38'
        ]
    ],
    'fiscalYearStartDate' => '2025-01-01'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-ACCOUNT-KEY: <x-account-key>",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.maesn.dev/accounting/bookings"

	payload := strings.NewReader("{\n  \"accounNumbertLength\": \"4\",\n  \"chartOfAccount\": \"SKR03\",\n  \"entries\": [\n    {\n      \"accountNumber\": \"70000\",\n      \"amount\": \"1500\",\n      \"bookingDate\": \"2021-01-01T00:00:00Z\",\n      \"bookingTaxCode\": \"9\",\n      \"bookingType\": \"PARTIAL_INVOICE\",\n      \"contraAccountNumber\": \"4900\",\n      \"currency\": \"EUR\",\n      \"description\": \"payment\",\n      \"dimension1\": \"Marketing\",\n      \"dimension2\": \"Service and Maintenance\",\n      \"documentNumber\": \"Rg32029/2024\",\n      \"dueDate\": \"2021-01-01T00:00:00Z\",\n      \"fileId\": \"AA7N4ICJ0SJIU38\"\n    }\n  ],\n  \"fiscalYearStartDate\": \"2025-01-01\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<x-api-key>")
	req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.maesn.dev/accounting/bookings")
  .header("X-API-KEY", "<x-api-key>")
  .header("X-ACCOUNT-KEY", "<x-account-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accounNumbertLength\": \"4\",\n  \"chartOfAccount\": \"SKR03\",\n  \"entries\": [\n    {\n      \"accountNumber\": \"70000\",\n      \"amount\": \"1500\",\n      \"bookingDate\": \"2021-01-01T00:00:00Z\",\n      \"bookingTaxCode\": \"9\",\n      \"bookingType\": \"PARTIAL_INVOICE\",\n      \"contraAccountNumber\": \"4900\",\n      \"currency\": \"EUR\",\n      \"description\": \"payment\",\n      \"dimension1\": \"Marketing\",\n      \"dimension2\": \"Service and Maintenance\",\n      \"documentNumber\": \"Rg32029/2024\",\n      \"dueDate\": \"2021-01-01T00:00:00Z\",\n      \"fileId\": \"AA7N4ICJ0SJIU38\"\n    }\n  ],\n  \"fiscalYearStartDate\": \"2025-01-01\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.maesn.dev/accounting/bookings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accounNumbertLength\": \"4\",\n  \"chartOfAccount\": \"SKR03\",\n  \"entries\": [\n    {\n      \"accountNumber\": \"70000\",\n      \"amount\": \"1500\",\n      \"bookingDate\": \"2021-01-01T00:00:00Z\",\n      \"bookingTaxCode\": \"9\",\n      \"bookingType\": \"PARTIAL_INVOICE\",\n      \"contraAccountNumber\": \"4900\",\n      \"currency\": \"EUR\",\n      \"description\": \"payment\",\n      \"dimension1\": \"Marketing\",\n      \"dimension2\": \"Service and Maintenance\",\n      \"documentNumber\": \"Rg32029/2024\",\n      \"dueDate\": \"2021-01-01T00:00:00Z\",\n      \"fileId\": \"AA7N4ICJ0SJIU38\"\n    }\n  ],\n  \"fiscalYearStartDate\": \"2025-01-01\"\n}"

response = http.request(request)
puts response.read_body
{
  "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": "2021-01-01T00:00:00Z",
    "entries": [
      {
        "accountNumber": "70000",
        "amount": "1500",
        "bookingDate": "2021-01-01T00:00:00Z",
        "bookingTaxCode": "9",
        "bookingType": "PARTIAL_INVOICE",
        "contraAccountNumber": "4900",
        "currency": "EUR",
        "description": "payment",
        "dimension1": "Marketing",
        "dimension2": "Service and Maintenance",
        "documentNumber": "Rg32029/2024",
        "dueDate": "2021-01-01T00:00:00Z",
        "fileId": "AA7N4ICJ0SJIU38"
      }
    ],
    "fiscalYearStartDate": "2025-01-01",
    "taskId": "ABBDU8834993NND"
  }
}

​
Field support per integration

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
BookingEntryRequestDto
​
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 the end user’s 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 booking 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
​
accounNumbertLength
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
Last modified on July 9, 2026