Skip to main content
POST
Create a DSFinV-K export

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-OpenFiskal-Merchant
string
required

Merchant identifier returned by the merchants resource.

Body

application/json
from
string<date-time>
required
Example:

"2026-03-01T00:00:00.000Z"

to
string<date-time>
required
Example:

"2026-03-31T23:59:59.000Z"

register_id
string
required

Register to export. DSFinV-K is per-register: the archive covers exactly this register, and it must be on the KassenSichV regime. The window is silently clamped to the period the register was live.

Example:

"reg_01HABC"

Response

Export job enqueued

id
string
required
type
enum<string>
required
Available options:
dsfinvk,
tse
status
enum<string>
required
Available options:
pending,
completed,
failed
from
string<date-time>
required
to
string<date-time>
required
created_at
string<date-time>
required
register_id
string | null
download_url
string | null

Signed URL to download the export artifact. Present only when status is completed.

error
object | null

Failure information. Present only when status is failed.

coverage
object | null

What the artifact covers. TSE exports only, and only once completed. Absent for other export types and while the export is still pending.

completed_at
string<date-time> | null