Gibt das entsprechende Land an.

Erfolgt die Abfrage der fiscalCountryProperties über GET /api/v1/information/client/{clientId}/ countryProperties, wird das dem jeweiligen Client zugewiedene Land angegeben.

Gibt an, ob in einem Land eine Zertifizierung einer Fiskalisierungskomponente erforderlich ist, bzw. was zertifiziert werden muss.

"mandatory" - Zertifizierung des Vorsystems (z.B. Registrierkasse) Pflicht. In diesem Fall muss die Registrierkasse einen Zertifizierungs- oder Abnahmeprozess durchlaufen.

"miniPOS" - Zertifizierung ist Pflicht, wird aber durch eine bereits zertifizierte Komponente, welche ggf. in die RetailForce Middleware integriert ist, erfüllt.

"notNecessary" - keine Zertifizierung des Vorsystems erforderlich.

"true" - im jeweiligen Land müssen Daten zeilenweise an einen Fiskaldrucker geschickt werden.

• Aktuell nicht unterstützt.

"false"- Dokumentenbasierte Schnittstelle (kein zeilenweiser Druck). 

• Implementierung zwischen Vorsystem ("Kasse") und Fiskalisierungs Service basiert auf den Standard-Endpunkten der API.

Gibt den Typ der Fiskalisierung an.

"fiscalPrinter" - Fiskalisierung basiert auf einem zertifizierten Fiskaldrucker, oder auf einem zertifizierten Fiskalkassensystem.

• Dies bedeutet, dass zusätzlich zum RetailForce System ein Fiskaldrucker benötigt wird. Dieser muss ggf. von einem lokalen Anbieter erworben werden.

"online" - Fiskalisierung über Onlinesysteme der lokalen Finanzverwaltung.

• keine zusätzliche Hardwarekomponente erforderlich

"signature" - Fiskalisierung durch Signierung von Belegdaten, über ein im Fiskalisierungsservice hinterlegtes digitales Zertifikat.

• In manchen Ländern kann es erforderlich sein, ein qualifiziertes digitales Zertifikat, bereitgestellt von einer CA (Certificate Authority), zu erwerben.

"signatureWithOnline" - Fiskalisierung durch Erstellung von Signaturen und der Online-Übermittlung von Daten an die Finanzverwaltung.

• Kombination der beiden vorher genannten Arten.

Gibt an, welche Umgebung unterstützt wird:

"local" - lokale Installation der Fiskalmiddleware (lokale am Kassensystem, am Store-Server,...)

• API-Aufrufe können an das lokal installierte Fiskalisierungsservice erfolgen:
  • http://localhost:7678/ im Falle REST-Implementierung, oder
  • Methodenaufruf im Fall der nuget Implementierung

"cloud" - Fiskal Middleware steht als gehosteter Cloud-Dienst unter https://fiscalisation.retailforce.cloud/ zur Verfügung.

• API-Aufrufe können an das Cloud-Fiscalisation Service erfolgen.

Gibt an, welche Betriebssysteme / Plattformen grundsätzlich unterstützt werden.

"linux"

• via Docker Container (REST Implementierung)

"windows"

• via Windows Service (REST Implementierung), oder
• via nuget Implementierung

"ios"

• via nuget Implementierung

"android"

• via nuget Implementierung, oder
• android Service (REST Implementierung)

Gibt an, welche gesetzlichen Anforderungen unterstützt werden, sowie die Version deren.

Z.B. für Griechenland: "myData v1.x.x"

Dokumententypen, welche im jeweiligen Land "zu fiskalisieren" sind. Also z.B. durch die vorgeschriebene Hardwarekomponente verarbeitet werden, signiert werden, etc.

Unter "fiscalDocumentTypes" gelistete "documentTypes" werden im jeweiligen Land automatisch vom Fiskalisierungsservice, entsprechend der Fiskalisierungsgesetze, verarbeitet (z.B. signiert).

Diese Dokumententypen, MÜSSEN im jew. Land, an das Fiskalisierungsservice übermittelt werden, sofern das Vorsystem ("Registrierkasse") diese unterstützt.

Liste der im jeweiligen Land unterstützte Dokumententypen.

Neben den "fiscalDocumentTypes", KÖNNEN die unter "supportedDocumentTypes" gelisteten Dokumenttypen an das Fiscalisierungsservice übermittelt werden. 

Bei diesen Dokumenttypen handelt es sich um s.g. "nicht-fiskale" Dokumente, also solche, die nicht "fiskalisiert" (z.B. signiert) werden.

Liste der im jeweiligen Land nicht unterstützten Dokumententypen.

"DocumentTypes" die unter "notSupportedDocumentTypes" gelistet werden, können im jeweiliten Land NICHT an das Fiskalisierungsservice übermittelt werden. 

Gründe dafür können technische Unmöglichkeit oder landespezifische Vorschriften / Gesetzen sein.

Wird ein "notSupportedDocumentType" an das Fiskalisierungsservice geschickt, antwortet dieses mit einer Fehlermeldung ("documentType not supported!")

Das Vorsystem sollte diese Dokumenttypen im entsprechenden Land nicht erlauben.

Liste der im jeweiligen Land unterstützte  (zulässigen) Zahlungsarten.

Diese Zahlungsarten können im jeweiligen Land verwendet werden.

Das Vorsystem sollte, im jeweiligen Land, dem Kassenbenutzer nur unterstützte ("supported") Zahlungsarten anbieten.

Liste der im jeweiligen Land nicht unterstützte  (bzw. unzulässigen) Zahlungsarten.

Das Vorsystem sollte nicht-unterstützte Zahlungsarten im jeweiligen Land unterdrücken.

Liste an Bezahlmethoden (paymentTypes) bei denen eine Überbezahlung des geschuldeten Betrages im betreffenden Land nicht erlaubt ist.

Beispiele:

Belegsumme = EUR 38,50

• Der Kunde bezahlt EUR 50 mit Debitkarte weil er das Restgeld gerne in Bar zurück haben möchte (Überbezahlung).
• Kunde bezahlt EUR 50 in Bar und erhält 11,50 als Wechselgeld zurück (Wechselgeldrückgabe).

Diese Vorgänge sind in manchen Ländern nicht erlaubt (bedeutet: dürfen nicht an das Fiskalisierungssystem geschickt werden).

Dies bedeutet, dass Zahlungsbeträge ("payment.amount") immer der Brutto-Summe der Positionen ("grossValue" aller "positions") entsprechen müssen und keine negativen Zahlungsbeträge übergeben werden dürfen.

Liste an im jeweiligen Land unterstützte Geschäftsfalls-Typen.

Diese Geschäftsfälle können im jeweiligen Land verwendet werden, im Gegensatz zu notSupportedBusinessTransactionTypes.

Liste an im jeweiligen Land nicht unterstützte  (bzw. unzulässigen) Geschäftsfalls-Typen.

Diese Geschäftsfälle können im jeweiligen Land nicht verwendet werden und sollten vom Vorsystem unterdrückt und nicht an das Fiskalisierungsservice übermittelt werden.

Detailinformationen zu den im jeweiligen Land unterstützten MwSt.-Sätzen.

Dieses Array beinhaltet folgende Angaben:

• MwSt.-Satz: "vatPercent" / "vatPercent2"
• Interne ID über welche der jeweilige MwSt.-Satz gemappt ist: "vatIdentification"
• Bezeichnung des MwSt.-Satz: "caption" / "caption_EN"
• historische MwSt.-Sätze unter Angabe der Gültigkeit ("validFrom" - "validTo")

"not mandatory" - Kundendisplay ist nicht gefordert (keine Verpflichtung).

"mandatory (no-RF)" - Kundendisplay ist verpflichtend, wird aber nicht über RetailForce Middleware angesteuert. Ansteuerung erfolgt automatisch durch das jeweilige Fiskalisierungssystem (z.B. automatisch durch den Fiskaldrucker)

"mandatory (RF)" - Kundendisplay muss verpflichtend vorhanden sein und muss über die RetailForce Middleware angesteuert werden. 

• Ansteuerung des Kundendisplays erfolgt über die Funktion: POST /api/v1/transactions/display/{clientId}

"not allowed" - Einsatz eines Kundendisplay ist in diesem Land verboten.

Gibt an, ob Eingabegeräte im jeweiligen Land registriert werden müssen ("true" / "false").

Eingabegeräte sind keine eigenständigen (stand-alone fähigen) Aufzeichnungssysteme. Mehr Informationen siehe: Architekturen von elektronischen Aufzeichnungssystemen (EAS)

"true" - im jeweiligen Land besteht die Vorschrift ein technisches Journal (Audit Log) führen zu müssen (in diesem Fall in der RF-Lizenz enthalten).

• in diesem Fall müssen technische Ereignis-Einträge über
  • POST /api/v1/transactions/auditlog, oder
  • POST /api/v1/transactions/storeDocument ("documentType": "[1002] = AuditLog")
    an das Fiskalisierungsservice gesendet werden.

"false" - es besteht keine Vorschrift zur Führung eines technischen Journals (nicht in Lizenz enthalten).

• technische Ereignisse KÖNNEN aufgezeichnet werden, müssen aber nicht.

"true" - im entsprechenden Land muss der Nachdruck eines Dokuments verpflichtend aufgezeichnet werden.

• Aufruf von entweder:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{documentGuid}, oder

  • PUT /api/v1/transactions/reprintDocument

    verpflichtend.

"false" - Nachdruck eines Dokuments muss nicht verpflichtend aufgezeichnet werden.

"terminal" - Nachdruck eines Dokuments darf nur auf der gleichen Kasse erfolgen, auf welcher auch das Original-Dokument ausgestellt wurde.

"store" - Nachdruck eines Dokuments darf nur innerhalb der gleichen Filiale erfolgen, in welcher das Original-Dokument ausgestellt wurde.

• Die Abbildung der Nachdruck-Funktion, über mehrere Filialen hinweg, muss vom Vorsystem umgesetzt werden.

"all" - Nachdruck eines Dokuments darf sowohl auf einer anderen Kasse als auch in einer anderen Filiale erfolgen.

• Die Abbildung der Nachdruck-Funktion, über mehrere Filialen hinweg, muss vom Vorsystem umgesetzt werden.

"true" - es muss einmal am Tag ein Tagesabschluss (Z-Bericht) erzeugt werden.

• Tagesabschluss:
  • POST /api/v1/transactions/storeDocument
  • "documentType": "[99] = EndOfDay"

"false" - keine Vorschrift für einen täglichen Tagesabschluss.

Gibt den Zeitraum seit der täglichen Kasseneröffnung an, innerhalb welcher ein Tagesabschluss erfolgen (z.B. innerhalb von 24h).

"-1" - nicht gesetzt.

Angabe, ob auf einem Beleg (Dokument) Verkäufe und Retouren gleichzeitig aufgezeichnet werden dürfen.

"oneReceiptAllowed" - erlaubt (Verkäufe und Retouren können gemischt auf einem Beleg dargestellt werden).

• Verkäufe:
  • "positions" (Type 0 oder 1) mit positiven Werten,
• Retouren:
  • "positions" (Type 0 oder 1) mit negativen Werten und 
  • ggf. "documentReference" gesetzt.

"oneReceiptAllowedVat" - solange der Mehrwertsteuerbetrag positiv bleibt, können Verkäufe und Retouren auf einem gemeinsamen Beleg aufgezeichnet werden.

"multiReceipt" - Verkäufe und Retouren müssen verpflichtend auf verschiedenen Belegen dargestellt werden.

• Das Vorsystem muss, vor der Übermittlung an das Fiskalisierungsservice, Verkäufe und Retouren automatisch auf unterschiedliche Transaktionen aufteilen.

"NoReturnAllowed" - im jeweiligen Land ist die Retourenabwicklung über das Fiskalsystem nicht möglich. In diesen Ländern werden Retouren häufig über Formulare über die Buchhaltung o.ä. gehandhabt.

Wo dürfen gekaufte Artikel retourniert werden?

"terminal" - Artikel dürfen nur an der gleichen Kasse zurückgenommen werden (Belegausstellung) auf der auch der ursprüngliche Verkauf durchgeführt wurde.

"store" - Artikel dürfen nur in der gleichen Filiale zurückgenommen werden (Belegausstellung) in der auch der ursprüngliche Verkauf durchgeführt wurde.

"all" - Artikel dürfen auch in anderen Filialen zurückgenommen werden.

Belegreferenz bei Retouren

"single" - bei Retouren darf nur auf einen Vorbeleg (Verkaufsbeleg der retournierten Ware bzw. Dienstleistung) referenziert werden.

• "documentReference" nur auf einen einzelnen Vorbeleg erlaubt, bzw.
• Referenz auf Positions-Ebene ("positionReference") auf nur einen Vorbeleg erlaubt.

"multiple" - bei Retouren darf auf mehrere Vorbelege (mehrere Verkaufsbelege, wenn mehrere Waren bzw. Dienstleistungen von mehreren Käufen retourniert werden).

• "documentReference" auf mehrere Vorbelege, oder
• Referenz auf entsprechenden Vorbeleg über "positionReference" auf der einzelnen Retouren-Position.

Gibt an ob das Element "fiscalDocumentNumber" der "fiscalResonse" des entsprechenden Landes auf Dokumenten angedruckt werden muss.

• vom Vorsystem übergebene Dokumentennummer werden ignoriert. Das Fiskalsystem (z.B. Drucker) vergibt die jeweilige Dokumentennummer / Dokumenten-ID selbständig.

"true" - im jeweiligen Land sind Aufschläge (Preisaufschläge) auf Waren bzw. Dienstleistungen erlaubt.

• Aufschläge:
  • "positions.discounts" mit NEGATIVEN Werten

"false" - Preisaufschläge sind nicht erlaubt.

"true" - Kasse darf über einen Trainingsmodule verfügen.

• Trainingmode:
  • "isTraining": true

"false" - Kasse darf keinen Trainings-/Demo-Modus aufweisen.

"true" - Summe der einzelnen Positionen wird auf Basis des Netto-Betrages (netValue) berechnet (z.B. Québec/Kanada).

"false" - Summe der einzelnen Positionen wird auf Basis des Brutto-Betrages (grossValue) berechnet (Standard).

"true" - Erfasste, aber später nicht im Beleg enthaltene Positionen, müssen im Payload (JSON) übermittelt werden.

"false" - Erfasste, aber später nicht im Beleg enthaltene Positionen, müssen nicht übermittelt werden.

Hinweis: mehr Informationen dazu finden Sie im Artikel "Übermitteln von gelöschten Artikelpositionen"

RFI / 

INFO

Gibt den Type des Startdokuments im betreffenden Land an.

Nur relevant wenn das Vorsystem die Funktion GET /api/v1/transactions/document/{clientId}/start, im Zuge der Initialisierung NICHT verwendet und das jeweilige Startdokument selbst erzeugt.

Liste der im betreffenden Land unterstützten Auszahlungsarten.

Die unter "supportedPayOutTypes" können / müssen für Auszahlungen ("documentType": "[10] = PayOut" und "businessTransactionType": "[10] = PayOut") angegeben werden.

Gibt an, ob die Mehrwertsteuersätze durch das jeweilige Fiskalisierungsmodul des Landes berechnet werden.

"true" - Fiskalisierungsmodul (Fiskalisierungsservice) berechnet die MwSt.-Sätze.

"false" - Kasse muss MwSt.-Sätze berechnen.

Gibt an, ob und wie viele Nachkommastellen im JSON-Dokument an die Fiscal Middleware enthalten sein müssen, wenn Beträge / Summen gesendet werden.

Betrifft sämtliche Wert-Angaben im Payload ("GrossValue", "NetValue"," TaxValue", "Amount",...)