DATEV

App · 25 actions

Work with your tax adviser's DATEV: send receipts and invoices to DATEV Unternehmen online, import booking batches and invoice data into DATEV accounting, read payroll results, download payroll reports and look up clients and their master data.

Actions

ActionWhat it does
Add file to invoice data transferAdd one file to an invoice data transfer: its document.xml, a data XML file, or an invoice image the XML names.
Cancel invoice data transferCancel an invoice data transfer that hasn't been finalised.
Check payroll reports are readyCheck whether a client's payroll reports for a month are ready to download.
Download payroll reportsDownload a month's payroll reports, such as payslips, for every employee or one, as one PDF or a ZIP of PDFs, for a later step to send or store.
Finalise invoice data transferMark an invoice data transfer complete, so DATEV starts importing its files.
Find employeeFind an employee's personnel number in DATEV payroll from the company's own personnel number.
Get allowed file typesGet the file extensions a client's Belege online accepts, such as pdf and jpg.
Get booking batch importGet how a booking batch import went: pending, succeeded or failed, with what DATEV found wrong.
Get clientGet one client's name, numbers and the data services it is set up for, which also confirms you may reach it.
Get invoice data transferGet how far DATEV has got with an invoice data transfer, in words.
Get master clientGet one client's master data; in full, with addresses, contacts, bank accounts and tax office.
Get payroll resultsGet a month's payroll results for every employee or one: master data, pay, tax, social security, bookings or absences.
Get signed-in userGet the name and email of the DATEV user this connection signed in as, and which environment and client it reaches.
List booking batch importsList a client's booking batch imports, each pending, succeeded or failed.
List clientsList the clients (Mandanten) you may send accounting data to, with the data services each is set up for.
List document typesList a client's document types (Belegtypen), such as Rechnungseingang for incoming invoices, to file uploads under.
List employees with payroll reportsList the personnel numbers of the employees with payroll reports for a month.
List invoice data transfer logList the messages DATEV logged while processing an invoice data transfer.
List master clientsList the tax adviser's client master data records (Mandantenstammdaten), optionally by name or number.
List payroll clientsList the clients whose payroll results (Lohn und Gehalt or LODAS) you may read.
List payroll report typesList which payroll report types you may and may not download for a client.
List payroll reportsList the payroll reports DATEV has for a client, for a month, made since a day, or both.
Start invoice data transferStart sending invoice or cash book data in DATEV's XML format (Rechnungsdatenservice 1.0) for one month.
Upload booking batchSend bookings in DATEV-Format (an EXTF CSV file) for import into the client's DATEV accounting.
Upload receiptSend a receipt or invoice to Belege online in DATEV Unternehmen online, for the tax adviser to book.

Add file to invoice data transfer

Add one file to an invoice data transfer: its document.xml, a data XML file, or an invoice image the XML names.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Job IDjob_idtextRequired
The invoice data transfer's id, from 'Start invoice data transfer'.
Filefiletext
The file: upload it, pick one from an earlier step, or paste a link. Use this or Content.
Contentcontenttext
The XML to send as the file. Use this or File.
File namefile_nametext
Its name, as the XML refers to it, such as document.xml. Leave blank to keep the file's name.

Outputs

addedtrue/false
True once DATEV has the file
file_nametext
The file name sent
job_idtext
The transfer's id
Example output
{
  "added": true,
  "file_name": "document.xml",
  "job_id": "27347365-EE83-71F8-66BD-C7176F769BB8"
}

Cancel invoice data transfer

Cancel an invoice data transfer that hasn't been finalised. Its files are discarded.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Job IDjob_idtextRequired
The invoice data transfer's id, from 'Start invoice data transfer'.

Outputs

cancelledtrue/false
True once it is cancelled
job_idtext
The transfer's id
Example output
{
  "cancelled": true,
  "job_id": "27347365-EE83-71F8-66BD-C7176F769BB8"
}

Check payroll reports are ready

Check whether a client's payroll reports for a month are ready to download.

Inputs

Clientclient_idtext
The client whose payroll DATEV runs: pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1.
Monthreport_monthdateRequired
The payroll month: pick any day in it.

Outputs

client_idtext
The client
monthtext
The month checked (YYYY-MM)
readytrue/false
Whether the month's reports are there
Example output
{
  "client_id": "455148-1",
  "month": "2026-10",
  "ready": true
}

Download payroll reports

Download a month's payroll reports, such as payslips, for every employee or one, as one PDF or a ZIP of PDFs, for a later step to send or store.

Inputs

Clientclient_idtext
The client whose payroll DATEV runs: pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1.
Monthreport_monthdateRequired
The payroll month: pick any day in it.
Report typesreport_typeslistRequired
Which payroll reports, such as payslips (LOBN).One or more of: LOBN (Payslip (Brutto/Netto)), LSTB (Income tax certificate (Lohnsteuerbescheinigung)), LSTE (Income tax certificate, English), SVNW (Social security record (SV-Nachweis)), ABEG (A1 certificate (A1-Bescheinigung)), AANB (A1 application confirmation), BUBE (Booking voucher (Buchungsbeleg)), LOJO (Payroll journal (Lohnjournal)), LJOE (Payroll journal, English), LSTA (Wage tax return (Lohnsteueranmeldung)), and 18 more.
Personnel numberemployee_numbernumber
Only this employee's reports. Leave blank for everyone's.From 1 to 99999.
As ZIPas_ziptrue/false
Get a ZIP with one PDF per report instead of a single PDF.

Outputs

content_typetext
application/pdf or application/zip
document_reftext
The downloaded file, for a later step to attach or upload
file_nametext
Its name
sizenumber
Its size in bytes
Example output
{
  "content_type": "application/pdf",
  "document_ref": "doc_0123456789abcdef",
  "file_name": "DATEV-455148-1-2026-10-LOBN.pdf",
  "size": 183422
}

Finalise invoice data transfer

Mark an invoice data transfer complete, so DATEV starts importing its files. It can't be cancelled afterwards.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Job IDjob_idtextRequired
The invoice data transfer's id, from 'Start invoice data transfer'.

Outputs

finalizedtrue/false
True once DATEV has started on it
job_idtext
The transfer's id
Example output
{
  "finalized": true,
  "job_id": "27347365-EE83-71F8-66BD-C7176F769BB8"
}

Find employee

Find an employee's personnel number in DATEV payroll from the company's own personnel number.

Inputs

Clientclient_idtext
The client whose payroll DATEV runs: pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1.
Company personnel numbercompany_personnel_numbertextRequired
The company's own number for the employee (Betriebliche Personalnummer).

Outputs

employeeobject
The employee's numbers
Example output
{
  "employee": {
    "company_personnel_number": "E-0001",
    "personnel_number": 1
  }
}

Get allowed file types

Get the file extensions a client's Belege online accepts, such as pdf and jpg.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.

Outputs

allowed_file_extensionslist
Extensions a single upload may have
allowed_staple_file_extensionslist
Extensions a stapled upload may have
staple_logictext
How stapled uploads are combined
Example output
{
  "allowed_file_extensions": [
    "pdf",
    "jpg",
    "png",
    "tif",
    "xml"
  ],
  "allowed_staple_file_extensions": [
    "pdf"
  ],
  "staple_logic": "pdf"
}

Get booking batch import

Get how a booking batch import went: pending, succeeded or failed, with what DATEV found wrong.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Job IDjob_idtextRequired
The job's id, from the step that started it.

Outputs

jobobject
A booking batch import (EXTF file job)
Example output
{
  "job": {
    "client_application_display_name": "Lodol",
    "data_category_id": 21,
    "date_from": "2026-10-01",
    "date_to": "2026-10-31",
    "filename": "EXTF_Buchungsstapel.csv",
    "fiscal_year_begin": "2026-01-01",
    "id": "8a772151-6c21-40fe-96ae-4d42cbeeda5a",
    "label": "Bookings October",
    "number_of_accounting_records": 42,
    "reference_id": "lodol-2026-10",
    "result": "succeeded",
    "timestamp": "2026-11-02T10:15:00+01:00",
    "validation_details": {
      "affected_elements": [],
      "detail": "",
      "title": "",
      "type": "https://www.datev.de/hilfe/1023095"
    }
  }
}

Get client

Get one client's name, numbers and the data services it is set up for, which also confirms you may reach it.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.

Outputs

clientobject
A DATEV client (Mandant)
Example output
{
  "client": {
    "client_number": 1,
    "consultant_number": 455148,
    "id": "455148-1",
    "name": "Musterholz GmbH",
    "services": [
      {
        "name": "Belegbilderservice",
        "scopes": [
          "accounting:documents"
        ]
      }
    ]
  }
}

Get invoice data transfer

Get how far DATEV has got with an invoice data transfer, in words.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Job IDjob_idtextRequired
The invoice data transfer's id, from 'Start invoice data transfer'.

Outputs

jobobject
An invoice data transfer (DXSO job)
Example output
{
  "job": {
    "finished": true,
    "id": "27347365-EE83-71F8-66BD-C7176F769BB8",
    "status": 2,
    "status_text": "processed successfully",
    "succeeded": true
  }
}

Get master client

Get one client's master data; in full, with addresses, contacts, bank accounts and tax office.

Inputs

Master client IDmaster_client_idtextRequired
The client's id from 'List master clients'.
Full recordfulltrue/false
Include addresses, contacts, bank accounts and the rest, not just the basics.

Outputs

master_clientobject
A client's master data record (Mandantenstammdaten)
Example output
{
  "master_client": {
    "container": {
      "client_since": "2019-01-01",
      "client_to": "",
      "consultant_number": 455148,
      "name": "Musterholz GmbH",
      "number": 10001,
      "status": "active",
      "timestamp": "2026-10-30T09:00:00Z",
      "type": "legal_person"
    },
    "data_environment_number": 455148,
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

Get payroll results

Get a month's payroll results for every employee or one: master data, pay, tax, social security, bookings or absences.

Inputs

Clientclient_idtext
The client whose payroll DATEV runs: pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1.
DatadatatextRequired
Which results to get.One of: masterdata (Employee master data), salarytotalvalues (Gross and net pay totals), salarypayments (Pay components (wage types)), taxpayments (Tax payments (wage tax, church tax, solidarity surcharge)), socialsecuritypayments (Social security contributions), accountingrecords (Accounting records (bookings)), absences (Absences, holiday and overtime).
Monthpayroll_monthdateRequired
The payroll month: pick any day in it.
Through monthpayroll_month_enddate
For several months: the last one. Leave blank for one month.
Personnel numberemployee_idnumber
Only this employee, by their personnel number in payroll. Leave blank for everyone.At least 1.

Outputs

countnumber
How many records
payroll_systemtext
The payroll program: lodas or lug (Lohn und Gehalt)
recordslist
One per employee and month
Example output
{
  "count": 1,
  "payroll_system": "lug",
  "records": [
    {
      "accounting_month": "2026-10",
      "amount_paid": 2650.0,
      "company_personnel_number": "E-0001",
      "current_gross_payment": 4200.0,
      "employment": {
        "date_of_joining": "2020-01-01",
        "date_of_leaving": "",
        "job_title": "Accountant",
        "weekly_working_hours": 40
      },
      "month_of_recalculation": "",
      "net_income": 2650.0,
      "personal_data": {
        "date_of_birth": "1985-04-12",
        "first_name": "Erika",
        "surname": "Mustermann"
      },
      "personnel_number": 1,
      "sick_leave_month": 0,
      "vacation_days_taken": 12,
      "wage_tax": 690.25
    }
  ]
}

Get signed-in user

Get the name and email of the DATEV user this connection signed in as, and which environment and client it reaches.

Inputs

None.

Outputs

connected_clienttext
The one client this connection reaches, or null when it reaches every client
environmenttext
production or sandbox
userobject
The DATEV user who signed in
Example output
{
  "connected_client": null,
  "environment": "sandbox",
  "user": {
    "account_id": "a1b2c3d4",
    "email": "erika.mustermann@example.com",
    "email_verified": true,
    "family_name": "Mustermann",
    "given_name": "Erika",
    "name": "Erika Mustermann"
  }
}

List booking batch imports

List a client's booking batch imports, each pending, succeeded or failed.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Page sizetopnumber
How many to return, from 1 to 100. Leave blank for 100.From 1 to 100.
Skipskipnumber
How many to skip, for the next page: the next_skip an earlier run gave. Leave blank for the first page.At least 0.

Outputs

countnumber
How many are on this page
has_moretrue/false
Whether there is another page
jobslist
The imports on this page
next_skipnumber
The Skip value for the next page, or null when this is the last
totalnumber
How many there are in all
Example output
{
  "count": 1,
  "has_more": false,
  "jobs": [
    {
      "client_application_display_name": "Lodol",
      "data_category_id": 21,
      "date_from": "2026-10-01",
      "date_to": "2026-10-31",
      "filename": "EXTF_Buchungsstapel.csv",
      "fiscal_year_begin": "2026-01-01",
      "id": "8a772151-6c21-40fe-96ae-4d42cbeeda5a",
      "label": "Bookings October",
      "number_of_accounting_records": 42,
      "reference_id": "lodol-2026-10",
      "result": "succeeded",
      "timestamp": "2026-11-02T10:15:00+01:00",
      "validation_details": {
        "affected_elements": [],
        "detail": "",
        "title": "",
        "type": "https://www.datev.de/hilfe/1023095"
      }
    }
  ],
  "next_skip": null,
  "total": 1
}

List clients

List the clients (Mandanten) you may send accounting data to, with the data services each is set up for.

Inputs

Consultant numberconsultant_numbernumber
Only this tax adviser's clients (Beraternummer).From 1 to 9999999.
Client numberclient_numbernumber
Only clients with this number (Mandantennummer).From 1 to 99999.
Page sizetopnumber
How many to return, from 1 to 100. Leave blank for 100.From 1 to 100.
Skipskipnumber
How many to skip, for the next page: the next_skip an earlier run gave. Leave blank for the first page.At least 0.

Outputs

clientslist
The clients on this page
countnumber
How many are on this page
has_moretrue/false
Whether there is another page
next_skipnumber
The Skip value for the next page, or null when this is the last
totalnumber
How many there are in all
Example output
{
  "clients": [
    {
      "client_number": 1,
      "consultant_number": 455148,
      "id": "455148-1",
      "name": "Musterholz GmbH",
      "services": [
        {
          "name": "Belegbilderservice",
          "scopes": [
            "accounting:documents"
          ]
        }
      ]
    }
  ],
  "count": 1,
  "has_more": false,
  "next_skip": null,
  "total": 1
}

List document types

List a client's document types (Belegtypen), such as Rechnungseingang for incoming invoices, to file uploads under.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.

Outputs

countnumber
How many there are
document_typeslist
The document types
Example output
{
  "count": 1,
  "document_types": [
    {
      "category": "invoices_received",
      "debit_credit_identifier": "debit",
      "name": "Rechnungseingang"
    }
  ]
}

List employees with payroll reports

List the personnel numbers of the employees with payroll reports for a month.

Inputs

Clientclient_idtext
The client whose payroll DATEV runs: pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1.
Monthreport_monthdateRequired
The payroll month: pick any day in it.
Report typesreport_typeslistRequired
Which payroll reports, such as payslips (LOBN).One or more of: LOBN (Payslip (Brutto/Netto)), LSTB (Income tax certificate (Lohnsteuerbescheinigung)), LSTE (Income tax certificate, English), SVNW (Social security record (SV-Nachweis)), ABEG (A1 certificate (A1-Bescheinigung)), AANB (A1 application confirmation), BUBE (Booking voucher (Buchungsbeleg)), LOJO (Payroll journal (Lohnjournal)), LJOE (Payroll journal, English), LSTA (Wage tax return (Lohnsteueranmeldung)), and 18 more.

Outputs

countnumber
How many
employee_numberslist
Their personnel numbers
Example output
{
  "count": 2,
  "employee_numbers": [
    1,
    2
  ]
}

List invoice data transfer log

List the messages DATEV logged while processing an invoice data transfer. DATEV keeps them about two months.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Job IDjob_idtextRequired
The invoice data transfer's id, from 'Start invoice data transfer'.

Outputs

countnumber
How many there are
entrieslist
The log entries
Example output
{
  "count": 1,
  "entries": [
    {
      "context": "",
      "filename": "document.xml",
      "text": "wurde empfangen!",
      "time": "2026-11-02T14:12:57+01:00",
      "type": "information"
    }
  ]
}

List master clients

List the tax adviser's client master data records (Mandantenstammdaten), optionally by name or number.

Inputs

Searchsearchtext
Only clients whose name or number contains this.
Statusstatustext
Only active or only inactive clients. Leave blank for both.One of: active, inactive.
Orderorder_bytext
How to sort them.One of: name+asc (Name, A to Z), name+desc (Name, Z to A), number+asc (Client number, lowest first), number+desc (Client number, highest first).
Page sizetopnumber
How many to return, from 1 to 100. Leave blank for 100.From 1 to 100.
Skipskipnumber
How many to skip, for the next page: the next_skip an earlier run gave. Leave blank for the first page.At least 0.

Outputs

countnumber
How many are on this page
has_moretrue/false
Whether there is another page
master_clientslist
The clients on this page
next_skipnumber
The Skip value for the next page, or null when this is the last
totalnumber
How many there are in all
Example output
{
  "count": 1,
  "has_more": false,
  "master_clients": [
    {
      "container": {
        "client_since": "2019-01-01",
        "client_to": "",
        "consultant_number": 455148,
        "name": "Musterholz GmbH",
        "number": 10001,
        "status": "active",
        "timestamp": "2026-10-30T09:00:00Z",
        "type": "legal_person"
      },
      "data_environment_number": 455148,
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    }
  ],
  "next_skip": null,
  "total": 1
}

List payroll clients

List the clients whose payroll results (Lohn und Gehalt or LODAS) you may read.

Inputs

None.

Outputs

clientslist
The payroll clients
countnumber
How many there are
Example output
{
  "clients": [
    {
      "client_id": "455148-1",
      "client_number": 1,
      "consultant_number": 455148
    }
  ],
  "count": 1
}

List payroll report types

List which payroll report types you may and may not download for a client.

Inputs

Clientclient_idtext
The client whose payroll DATEV runs: pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1.

Outputs

access_deniedlist
Report type codes you may not
access_grantedlist
Report type codes you may download
client_idtext
The client
Example output
{
  "access_denied": [
    "PFAN"
  ],
  "access_granted": [
    "LOBN",
    "LSTB",
    "SVNW"
  ],
  "client_id": "455148-1"
}

List payroll reports

List the payroll reports DATEV has for a client, for a month, made since a day, or both.

Inputs

Clientclient_idtext
The client whose payroll DATEV runs: pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1.
Report typesreport_typeslistRequired
Which payroll reports, such as payslips (LOBN).One or more of: LOBN (Payslip (Brutto/Netto)), LSTB (Income tax certificate (Lohnsteuerbescheinigung)), LSTE (Income tax certificate, English), SVNW (Social security record (SV-Nachweis)), ABEG (A1 certificate (A1-Bescheinigung)), AANB (A1 application confirmation), BUBE (Booking voucher (Buchungsbeleg)), LOJO (Payroll journal (Lohnjournal)), LJOE (Payroll journal, English), LSTA (Wage tax return (Lohnsteueranmeldung)), and 18 more.
Monthreport_monthdate
Only reports for this payroll month: pick any day in it.
Made sincecreated_sincedate
Only reports made on or after this day.

Outputs

countnumber
How many there are
reportslist
The reports
Example output
{
  "count": 1,
  "reports": [
    {
      "document_type": "LOBN",
      "employee_number": 1,
      "period": "2026-10-01",
      "timestamp": "2026-10-28"
    }
  ]
}

Start invoice data transfer

Start sending invoice or cash book data in DATEV's XML format (Rechnungsdatenservice 1.0) for one month. Add its files next, then finalise it.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Dataimport_typetextRequired
What the files hold.One of: accountsPayableLedgerImport (Incoming invoices (accounts payable)), accountsReceivableLedgerImport (Outgoing invoices (accounts receivable)), cashLedgerImport (Cash book entries).
Monthaccounting_monthdateRequired
The accounting month the data belongs to: pick any day in it.

Outputs

client_idtext
The client it is for
jobobject
The new invoice data transfer (DXSO job)
Example output
{
  "client_id": "455148-1",
  "job": {
    "account_length": 4,
    "cash_ledger_names": [
      "Kasse"
    ],
    "id": "27347365-EE83-71F8-66BD-C7176F769BB8",
    "ledger_folder_names": [
      "Eingangsrechnungen"
    ]
  }
}

Upload booking batch

Send bookings in DATEV-Format (an EXTF CSV file) for import into the client's DATEV accounting. DATEV checks and imports it later; read the job to see how it went.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
Filefiletext
The EXTF CSV file: upload it, pick one from an earlier step, or paste a link. Use this or Content.
Contentcontenttext
The file's text in DATEV-Format, starting with its EXTF header line. Use this or File.
File namefile_nametext
Starts with EXTF_ and ends with .csv, such as EXTF_Buchungsstapel.csv. Leave blank to keep the file's name.
Referencereferencetext
Your own reference for the batch, shown on its job.

Outputs

check_after_secondsnumber
How long DATEV suggests waiting before checking
client_idtext
The client it went to
file_nametext
The file name sent
job_idtext
The import job's id, for 'Get booking batch import'
Example output
{
  "check_after_seconds": 5,
  "client_id": "455148-1",
  "file_name": "EXTF_Buchungsstapel.csv",
  "job_id": "8a772151-6c21-40fe-96ae-4d42cbeeda5a"
}

Upload receipt

Send a receipt or invoice to Belege online in DATEV Unternehmen online, for the tax adviser to book. One file per upload; ZIP files aren't accepted.

Inputs

Clientclient_idtext
The DATEV client (Mandant): pick one, or type its consultant number and client number joined by a hyphen, such as 455148-1. Leave blank on a connection made for one client to use that client.
FilefiletextRequired
The document: upload it, pick a file from an earlier step, or paste a link to it.
File namefile_nametext
What to call it in DATEV, such as Invoice-1042.pdf. Leave blank to keep the file's own name.
Document typedocument_typetext
The document type (Belegtyp) to file it under, which decides how DATEV processes it. Leave blank for none.
Notenotetext
A note for the tax adviser, up to 255 characters.
Repository categorycategorytext
Belege online's top filing level, such as your company name. Give all three levels or none.
Repository folderfoldertext
The second filing level, such as Invoices.
Repository registerregistertext
The third filing level, such as 2026/11.

Outputs

client_idtext
The client it went to
documentobject
The document as Belege online received it
file_nametext
The file name sent
Example output
{
  "client_id": "455148-1",
  "document": {
    "document_type": "Rechnungseingang",
    "files": [
      {
        "id": "c0ffee00-1234-4abc-8def-0123456789ab",
        "media_type": "application/pdf",
        "name": "Invoice-1042.pdf",
        "size": 48213,
        "upload_date": "2026-11-02T10:15:00+01:00"
      }
    ],
    "id": "b6f1d6a2-3c4e-4f2a-9a1b-2d3e4f5a6b7c",
    "note": "Office supplies"
  },
  "file_name": "Invoice-1042.pdf"
}

On this page