Create bookings

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

BookingEntryRequestDto

Show properties

accountNumber

number

required

This is typically the customer or supplier account number.

amount

number

required

bookingDate

string

required

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

bookingTaxCode

string

bookingType

enum

Available options: PARTIAL_INVOICE, ADVANCED_PAYMENT_RECEIVED, FINAL_INVOICE, OTHER

contraAccountNumber

number

required

This is the opposing account number used for the booking entry.It might be a bank, revenue, or expense account, depending on the nature of the transaction.

currency

enum

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

debitCreditIndicator

enum

required

Available options: DEBIT, CREDITDEBIT indicates a debit on the accountNumber and a credit on the contraAccountNumber.CREDIT indicates a credit on the accountNumber and a debit on the contraAccountNumber.

description

string

required

dimension1

string

The dimension1 field represents the information for cost accounting (KOST1)

dimension2

string

The dimension2 field represents the information for cost accounting (KOST2)

documentNumber

string

required

dueDate

string

ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

fileId

string

The fileId field is used to attach a file to the booking entry. This is the ID of the file that you previously uploaded using the POST Files endpoint.

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[]

Show child attributes

entries.accountNumber

number

Example:

"70000"

entries.amount

number

Example:

"1500"

entries.bookingDate

string

Example:

"2021-01-01T00:00:00Z"

entries.bookingTaxCode

string

Example:

"9"

entries.bookingType

enum<string>

Available options:

PARTIAL_INVOICE,

ADVANCED_PAYMENT_RECEIVED,

FINAL_INVOICE,

OTHER

Example:

"PARTIAL_INVOICE"

entries.contraAccountNumber

number

Example:

"4900"

entries.currency

enum<string>

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"

entries.debitCreditIndicator

enum<string>

Available options:

CREDIT,

DEBIT

entries.description

string

Example:

"payment"

entries.dimension1

string

Example:

"Marketing"

entries.dimension2

string

Example:

"Service and Maintenance"

entries.documentNumber

string

Example:

"Rg32029/2024"

entries.dueDate

string

Example:

"2021-01-01T00:00:00Z"

entries.fileId

string

Example:

"AA7N4ICJ0SJIU38"

fiscalYearStartDate

string

Example:

"2025-01-01"

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Create bookings

Field support per integration

Headers

Query Parameters

Body

Response

Get started

Guides

Integrations

Use cases

API reference

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration