Zum Hauptinhalt gehen

POST /api/v1/management/clients/ initialize

Harald Krondorfer
  • Aktualisiert

Der Endpunkt

  • POST /api/v1/management/clients/initialize

wird verwendet für die Initialisierung

  • der Fiskaleinheit (Client),
  • eventuell benötigter Fiskal-Hardware (Signaturerstellungseinheit, technische Sicherheitseinrichtung, Kontrolleinheit, Fiskal-Drucker/-Box,...) verwendet, sowie
  • um das elektronische Aufzeichnungssystem (Registrierkasse) bei den Finanzbehörden zu registrieren. (z.B. Registrierungsprozess bei FinanzOnline - Österreich)

Ergebnis

Bei einer erfolgreichen Verarbeitung (200) wird

  • der entsprechende Fiskal Client sowie
  • eine eventuell benötigte Fiskal-Hardware in Betrieb genommen und konfiguriert sowie
  • (sofern im jeweiligen Land notwendig / verfügbar) die Kasse bei der Steuerbehörde registriert.

Verwendung

  • Einmalig, im Rahmen der Inbetriebnahme eines Fiskal Clients.

Voraussetzungen

Formularfelder

Ein Start-Dokument muss an den Endpunkt geschickt werden.

Beim Aufruf von GET /api/v1/transactions/document/{clientId}/start wurde ein Start-Dokument als Antwort an des Vorsystem zurückgegeben. Dieses kann nun an den Endpunkt POST /api/v1/management/clients/initialize geschickt werden.

Alternative, kann das benötigte Startdokument auch vom Vorsystem selbst erstellt werden.

Antwort

Mögliche Antworten:

Code Beschreibung Beispiel
200

Das Start-Dokument wurde erfolgreich und fehlerfrei übermittelt und im documentStore gespeichert.

Weiters wird eine fiscalResponse an das Vorsystem zurückgegeben. Dies sollte für Referenzzwecke im Journal des Vorsystems gespeichert werden.

 fiscalResponse
204

Das Start-Dokument wurde erfolgreich und fehlerfrei übermittelt und im documentStore gespeichert.

In manchen Ländern wird keine fiscalResponse bei einer erfolgreichen Inbetriebnahme übermittelt.

 -
422

Das Start-Dokumententspricht nicht den Anforderungen des jeweiligen Landes oder die ClientId fehlt im Start-Dokument

Fehlerbehebung: 

  • Führen Sie
    POST /api/v1/transactions/validateDocument oder
    POST /api/v1/transactions/validateDocumentString
    für eine nähere Fehleranalyse aus;
  • Verwenden Sie GET /api/v1/transactions/document/{clientId}/start um ein valides Start-Dokument zu erzeugen;
  • geben Sie die entsprechende clientId an.
 -
500

Validierungsfehler im Startdokument oder die clientId, welche im Startdokument übermittelt wurde, findet sich nicht im ConfigStore

Fehlerbehebung: 

 -

 

Verwandte Beiträge

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.

Powered by Zendesk