FiscalDocument - OpenFiskal API

{
  "regime": "<string>",
  "document_type": "Kassenbeleg",
  "transmission_status": "transmitted",
  "fiscal_unit_id": "fu_01HXYZ",
  "document_number": "2026-004822",
  "transmitted_at": "2023-11-07T05:31:56Z",
  "verification": {
    "url": "<string>",
    "qr_data": "<string>"
  },
  "tse_serial": "<string>",
  "client_id": "<string>",
  "signature_algorithm": "ecdsa-plain-SHA384",
  "time_format": "utcTime",
  "start_event": {
    "signed_at": "2023-11-07T05:31:56Z",
    "transaction_counter": 4821,
    "signature": "aSDinaTvuI8gbWludGxpZnk=",
    "process_type": "<string>",
    "process_data": "<string>"
  },
  "end_event": {
    "signed_at": "2023-11-07T05:31:56Z",
    "transaction_counter": 4821,
    "signature": "aSDinaTvuI8gbWludGxpZnk=",
    "process_type": "<string>",
    "process_data": "<string>"
  }
}

Option 1
Option 2
Option 3

Jurisdiction-specific fiscal output attached to every operation. Discriminated by regime — each variant carries typed fields for its fiscal security device and signing protocol.

regime

string

required

Allowed value: "tse"

document_type

string

required

Example:

"Kassenbeleg"

transmission_status

enum<string>

required

Available options:

transmitted,

pending,

failed,

not_required

fiscal_unit_id

string

ID of the fiscal unit that signed this document

Example:

"fu_01HXYZ"

document_number

string | null

Assigned on completion

Example:

"2026-004822"

transmitted_at

string<date-time> | null

verification

object

QR data for receipt printing (DSFinV-K format)

Show child attributes

tse_serial

string

Serial number of the TSE hardware module

client_id

string

POS client identifier registered with the TSE

signature_algorithm

string

Algorithm used by the TSE (e.g. ecdsa-plain-SHA384)

Example:

"ecdsa-plain-SHA384"

time_format

string

Time format used by the TSE (e.g. utcTime)

Example:

"utcTime"

start_event

object

Fiscal start event. Populated when the operation is opened. Must be stored by the POS and printed on the receipt.

Show child attributes

end_event

object

Fiscal end event. Populated when the operation is completed.

Show child attributes

Totals Error

⌘I

API

Schemas