Documentation Index
Fetch the complete documentation index at: https://dev.openfiskal.com/llms.txt
Use this file to discover all available pages before exploring further.
Planned — not yet available. The export endpoints described here are not implemented in sandbox or production. Calls to POST /exports, GET /exports, and GET /exports/{id} currently return 404 not_found. This page documents the intended contract.
Overview
Exports are asynchronous. You create an export job, poll it until the artifact is ready, then download the file before the retention deadline.
Every export response includes the schema version, retention deadline, and a download link once the status reaches ready.
Export types
| Type | Description |
|---|
dsfinvk | Germany (KassenSichV) — DSFinV-K archive containing 20 CSV files, index.xml, and GDPdU DTD |
tse_tar | Germany (KassenSichV) — Raw TSE transaction data |
dep7 | Austria (RKSV) — DEP7 data export |
Requesting an export
Every export requires a type, register_id, and a time range.
Germany — DSFinV-K
Germany — TSE data
Austria — DEP7
curl -X POST https://sandbox.api.openfiskal.com/v1/exports \
-H "Authorization: Bearer of_test_deu_abc123..." \
-H "X-OpenFiskal-Merchant: merchant_01HXYZ" \
-H "Idempotency-Key: dsfinvk-2026-03" \
-H "Content-Type: application/json" \
-d '{
"type": "dsfinvk",
"register_id": "reg_01HABC",
"from": "2026-03-01T00:00:00Z",
"to": "2026-03-31T23:59:59Z"
}'
cashpointclosing.csv, transactions.csv, lines.csv, payment.csv, vat.csv, and other mandated files alongside index.xml and the GDPdU DTD.curl -X POST https://sandbox.api.openfiskal.com/v1/exports \
-H "Authorization: Bearer of_test_deu_abc123..." \
-H "X-OpenFiskal-Merchant: merchant_01HXYZ" \
-H "Idempotency-Key: tse-2026-03" \
-H "Content-Type: application/json" \
-d '{
"type": "tse_tar",
"register_id": "reg_01HABC",
"from": "2026-03-01T00:00:00Z",
"to": "2026-03-31T23:59:59Z"
}'
curl -X POST https://sandbox.api.openfiskal.com/v1/exports \
-H "Authorization: Bearer of_test_aut_abc123..." \
-H "X-OpenFiskal-Merchant: merchant_01HXYZ" \
-H "Idempotency-Key: dep7-2026-03" \
-H "Content-Type: application/json" \
-d '{
"type": "dep7",
"register_id": "reg_01HABC",
"from": "2026-03-01T00:00:00Z",
"to": "2026-03-31T23:59:59Z"
}'
Polling and download
All export types follow the same async lifecycle:
POST /exports returns the job with status queued- Poll
GET /exports/{exportId} until status reaches ready
Create response:
{
"id": "exp_01JDEF",
"type": "dsfinvk",
"status": "queued",
"schema_version": "1.0",
"register_id": "reg_01HABC",
"from": "2026-03-01T00:00:00Z",
"to": "2026-03-31T23:59:59Z",
"retention_expires_at": "2026-04-07T00:00:00Z",
"created_at": "2026-03-31T12:00:00Z"
}
Retention
Export artifacts remain downloadable until the retention_expires_at timestamp. Copy each artifact to your own durable storage before that deadline.
