Simplify the creation and updating of contact records in DATEV Rechnungswesen.
Authorize end user
Get user info (optional)
Get companies
Decide your path
Individual contacts
.Miscellaneous account
.Check status
Check DATEV general requirements
Delete end user
accountNumber
, which is essential for managing and referencing these contacts within the DATEV system.
Debtor account numbers are usually assigned in the range from 10000 to 69999. Creditor account numbers, on the other hand, lie in the range from 70000 to 99999.
To create or update individual contacts, use the POST /contacts/bulk
endpoint. This endpoint allows you to create new contacts or update existing ones by providing the necessary details.
create
individual contacts, each contact entry in the JSON request must have a unique dedicated accountNumber
(e.g. 10000
, 10001
, 70000
, 70001
etc.). If a contact with the provided accountNumber already exists, it will be updated automatically.update
existing contacts, provide the accountNumber
field for each contact in the list with the account number of the contacts you want to update. If a contact with the specified accountNumber does not exist, a new contact will be created.miscellaneous accounts
(“Diverse Addressen” in DATEV) to group and manage business partners who do not have individual account numbers.
This approach is useful for managing one-time customers or suppliers — for example, when issuing an invoice to a partner with whom there is unlikely to be future collaboration.
Instead of creating a new account for each of these partners, all their transactions can be posted to a shared miscellaneous account, thereby simplifying bookkeeping.
IMPORTANT: To create and use a miscellaneous account, the end user must first activate OPOS (Offene-Posten-Buchführung) in their DATEV client. This enables open item accounting, which is required for tracking individual transactions under shared miscellaneous accounts.
To create a miscellaneous account, use the POST /contacts/bulk
endpoint.
create
a miscellaneous account, all contact entries in the JSON request must share the same dedicated accountNumber
, indicating they belong to the new shared account. (e.g. 20000
). If a shared account associated to the provided accountNumber
already exists, the new contacts are added to it.update
function is not directly applicable to miscellaneous accounts, as they are designed to group multiple contacts under a single account number. However, it is possible to add new contacts to an existing miscellaneous account.