Skip to main content
POST
/
accounting
/
files
/
async
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/files/async \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --form file='@example-file' \
  --form documentType=Rechnungsausgang \
  --form documentDate=2025-03-26T08:25:54.060Z \
  --form documentId=b5e624e5-fb9e-4836-a443-87a3820f5b48 \
  --form 'integrationSource=3rd party app' \
  --form 'note=note for the document'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "data": {
    "taskId": "02cc5849-b23c-48fe-8a9b-96f74bfc9571"
  }
}

​
Field support per integration

This endpoint 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:
​
file
File
required
The name of the uploaded file must include the file extension, for example invoice.pdf.
​
documentId
string
The documentId field can be used to uniquely identify a document. If provided, it must be a valid GUID.
​
documentType
string
required
The documentType field must match one of the document types returned by the GET Document Types endpoint.
​
note
string
This endpoint 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:
​
file
File
required
The name of the uploaded file must include the file extension, for example invoice.pdf.
​
documentDate
string
required
​
documentId
string
The documentId field can be used to uniquely identify a document. If provided, it must be a valid GUID.
​
documentType
string
required
The documentType field must match one of the document types returned by the GET Document Types endpoint.
​
integrationSource
string
required
The integrationSource field should be set to the name of your application integrating with DATEV.
​
note
string

Headers

​
X-API-KEY
string
required

API key

​
X-ACCOUNT-KEY
string
required

Account key

Query Parameters

​
companyId
string

Body

multipart/form-data
​
file
file
required
​
documentType
string
required
Example:

"Rechnungsausgang"

​
documentDate
string
Example:

"2025-03-26T08:25:54.060Z"

​
documentId
string
Example:

"b5e624e5-fb9e-4836-a443-87a3820f5b48"

​
integrationSource
string
Example:

"3rd party app"

​
note
string
Example:

"note for the document"

Response

202 - application/json
​
meta
object
​
data
object
Last modified on April 27, 2026