Create booking proposal

Field support per integration

DATEV Unternehmen Online

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:

bookingProposal

string

required

Show properties

string

The id field represents the unique identifier of the booking proposal.

The id must be a valid UUID; otherwise, it will be ignored.This field is only relevant and used when uploading files with the booking proposal.

addresses

Address[]

Show properties

city

string

bankAccountNumber

number

bankCode

string

bic

string

bookingProposalDate

string

required

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

contactAccountNumber

number

The contactAccountNumber field represents the account number of the contact associated with the booking proposal.It is the customer account number for INVOICE or the vendor account number for BILL.

contactName

string

The contactName field represents the name of the contact associated with the booking proposal.

currency

enum

required

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

deliveryDate

string

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

discountPaymentDate

string

The discountPaymentDate field represents the date until which a discount (discountAmount and discountPercentage in line items) can be applied to the payment.ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

discountPaymentDate2

string

The discountPaymentDate2 field represents the date until which a discount (discountAmount2 and discountPercentage2 in line items) can be applied to the payment.ISO-8601 date format, e.g., 2024-01-01T00:00:00Z

dueDate

string

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

iban

string

isPaymentOrder

boolean

The isPaymentOrder field determines whether a payment instruction (transfer for bills or direct debit for invoices) should be automatically created when the booking proposal is processed

ledgerName

string

required

The ledgerName field represents the name of the correct ledger folder where the data will be sent to.To get the correct name, you can use the GET Accounts endpoint.

For INVOICE booking proposals, the ledgerName must be of type ACCOUNT_RECEIVABLE, and for BILL booking proposals, it must be of type ACCOUNT_PAYABLE.

lineItems

BookingLineItem[]

required

Show properties

accountName

string

The accountName field specifies the name of the general ledger account linked to the individual line item within the invoice or bill.

accountNumber

number

The accountNumber field specifies the general ledger account linked to the individual line item within the invoice or bill.

bookingTaxCode

string

description

string

dimension1

string

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

dimension2

string

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

discountAmount

number

discountAmount2

number

discountPercentage

number

discountPercentage2

number

taxRatePercentage

number

totalGrossAmount

number

required

notes

string

number

string

required

orderId

string

paidDate

string

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

paymentTermsId

string

totalGrossAmount

number

required

vatId

string

bookingType

BookingType

required

Available options: INVOICE, BILL

files

file[]

The files array can be used to attach files to the booking proposal.

The name of the uploaded files must include the file extension, for example invoice.pdf.

folderManagement

FolderManagement

The folderManagement object defines the three-level folder structure for a booking proposal. If not provided, the default structure will be used.

Show properties

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

multipart/form-data

bookingProposal

object

Show child attributes

bookingProposal.id

string

Example:

"BP-12345"

bookingProposal.addresses

object[]

Show child attributes

bookingProposal.addresses .city

string

Example:

"city"

bookingProposal.bankAccountId

string

Example:

"5a6b7f5dw45c1c-403e-ad56-202fbc312414"

bookingProposal.bankAccountNumber

number

Example:

5407324931

bookingProposal.bankCode

string

Example:

"50010517"

bookingProposal.bic

string

Example:

"DEUTDEFF"

bookingProposal.bookingProposalDate

string

Example:

"2025-07-14T00:00:00Z"

bookingProposal.contactAccountNumber

number

Example:

70000

bookingProposal.contactId

string

Example:

"eaa28f49-6028-4b6e-bb12-d8f6278073fc"

bookingProposal.contactName

string

Example:

"John Doe"

bookingProposal.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"

bookingProposal.deliveryDate

string

Example:

"2025-07-26T00:00:00Z"

bookingProposal.discountPaymentDate

string

Example:

"2025-07-16T00:00:00Z"

bookingProposal.discountPaymentDate2

string

Example:

"2025-07-18T00:00:00Z"

bookingProposal.dueDate

string

Example:

"2025-07-24T00:00:00Z"

bookingProposal.journalCode

string

Example:

"60"

bookingProposal.iban

string

Example:

"DE43100500000920018963"

bookingProposal.isPaymentOrder

boolean

Example:

"true"

bookingProposal.ledgerName

string

Example:

"Payroll"

bookingProposal.lineItems

object[]

Show child attributes

bookingProposal.lineItems.id

string

Example:

"Item-112233"

bookingProposal.lineItems.accountCode

string

Example:

"200"

bookingProposal.lineItems.accountId

string

Example:

"db32-4f56-8a9b-1234567890ab"

bookingProposal.lineItems.accountName

string

Example:

"EXPENSE"

bookingProposal.lineItems.accountNumber

number

Example:

4900

bookingProposal.lineItems.bookingTaxCode

string

Example:

"9"

bookingProposal.lineItems.description

string

Example:

"Item A"

bookingProposal.lineItems.dimension1

string

Example:

"Marketing"

bookingProposal.lineItems.dimension2

string

Example:

"Service and Maintenance"

bookingProposal.lineItems.discountAmount

number

Example:

100

bookingProposal.lineItems.discountAmount2

number

Example:

50

bookingProposal.lineItems.discountPercentage

number

Example:

20

bookingProposal.lineItems.discountPercentage2

number

Example:

10

bookingProposal.lineItems.taxCode

string

Example:

"02"

bookingProposal.lineItems.taxRatePercentage

number

Example:

19

bookingProposal.lineItems.totalGrossAmount

number

Example:

500

bookingProposal.lineItems.totalNetAmount

number

Example:

450

bookingProposal.lineItems.type

enum<string>

Available options:

GOODS,

SERVICES

Example:

"SERVICES"

bookingProposal.notes

string

Example:

"Bill for maintenance services"

bookingProposal.number

string

Example:

"1233330"

bookingProposal.orderId

string

Example:

"3344566"

bookingProposal.paidDate

string

Example:

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

bookingProposal.paymentTermsId

string

Example:

"03"

bookingProposal.totalGrossAmount

number

Example:

500

bookingProposal.vatId

string

Example:

"DE987654321"

bookingType

enum<string>

Available options:

INVOICE,

BILL

files

file[]

Array of files to upload

folderManagement

object

Show child attributes

folderManagement.category

string

Example:

"Accounting"

folderManagement.folder

string

Example:

"Invoices"

folderManagement.register

string

Example:

"2025 January"

Response

200 - application/json

Get started

Guides

Integrations

Use cases

API reference

Create booking proposal

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