In diesem Artikel lernen Sie, wie Sie die verschiedenen Eigenschaften der Länder abfragen und auch in der RetailForce Cloud einsehen können. Am Ende des Artikels finden Sie eine Erklärung zu den einzelnen Elementen der fiscalCountryProperties.
Um für Ihre Implementierung die jeweils notwendigen Implementierungen darzustellen, wurden die Ländereigenschaften (FiscalCountryProperties) ins Leben gerufen. Diese zeigen, welche Teile des Gesamtinterfaces für ein jeweiliges Land mindestens zu implementieren sind.
Die Ländereigenschaften stehen ab der Version V1.2.12 (ausgenommen Client ab V1.2.13) bereit.
Abfrage der Ländereigenschaften in der Cloud
Die Ländereigenschaften können im Cloud Portal unter folgenden Link abgerufen werden:
https://portal.retailforce.cloud/information/fiscal-country
Um die FiscalCountryProperties aufrufen zu können, müssen Sie im Portal angemeldet sein.
Abfrage der Ländereigenschaften am Client
Die Ländereigenschaften können auch per Programm abgefragt werden. So ist es möglich auf diverse Ländereigenschaften auch im Kassenprogramm zu reagieren.
Beispiel: ein Dokumenttyp ist in einem Land nicht erlaubt und wird daher nicht unterstützt.
Abfrage über direkte Implementierung (nuget)
Um alle vorhanden Ländereigenschaften aller Länder abzufragen, kann folgende Methode aufgerufen werden:
List<IFiscalCountryProperties> TrustedFiscalModul.GetFiscalCountryPropertiesList()
Abfrage über Client
Rest Service
Am Restservice gibt es 2 Endpunkte um die Ländereigenschaften abzufragen:
GET /api/v1/information/countryProperties
Mit dieser Methode können die Ländereigenschaften für ein Land abgefragt werden.,
/api/v1/information/client/{clientId}/countryProperties
Mit dieser Methode können die Ländereigenschaften für einen Client abgefragt werden.
Fiscal Service client
Am Fiscal Service client (.net Standard 2.0 und .net Framework 2) gibt es folgende Methoden um die Ländereigenschaften abzufragen.
FiscalCountryProperties GetFiscalCountryProperties(FiscalCountry fiscalCountry)
Mit dieser Methode können die Ländereigenschaften für ein Land abgefragt werden.
FiscalCountryProperties GetFiscalCountryProperties(Guid clientId)
Mit dieser Methode können die Ländereigenschaften für einen Client abgefragt werden.
fiscalCountryProperties - Erklärung
| Actual country module version | Aktuelle Version des Trusted Fiscal Country Moduls innerhalb der Middleware (relevant für Länder, in denen eine bestimmte Softwareversion zertifiziert werden muss; z.B. Frankreich). |
| Line interface |
"true" - im jeweiligen Land müssen Daten zeilenweise an einen Fiskaldrucker geschickt werden. "false" - Dokumentenbasierte Schnittstelle (kein zeilenweiser Druck). |
| Customer Display |
"not mandatory" - Kundendisplay ist nicht gefordert (keine Verpflichtung). "mandatory (no-RF)" - Kundendisplay ist verpflichtend, wird aber nicht über RetailForce Middleware angesteuert. "mandatory (RF)" - Kundendisplay muss verpflichtend vorhanden sein und muss über die RetailForce Middleware angesteuert werden. "not allowed" - Einsatz eines Kundendisplay ist in diesem Land verboten. |
| Audit log mandatory |
"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). "false" - es besteht keine Vorschrift zur Führung eines technischen Journals (nicht in Lizenz enthalten). |
| Must record document reprints |
"true" - im entsprechenden Land muss der Nachdruck eines Dokuments verpflichtend aufgezeichnet werden (Aufruf des Endpunktes: PUT /api/v1/transactions/reprintDocument/ {clientId}/{documentGuid} verpflichtend!). "false" - Nachdruck eines Dokuments muss nicht verpflichtend aufgezeichnet werden. |
| Reprint allowed domain |
"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. "all" - Nachdruck eines Dokuments darf sowohl auf einer anderen Kasse als auch in einer anderen Filiale erfolgen. |
| Must send closing per day |
"true" - es muss einmal am Tag ein Tagesabschluss (Z-Bericht) erzeugt werden. "false" - keine Vorschrift für einen täglichen Tagesabschluss. |
| Maximum hour interval for closing |
Gibt den Zeitraum seit der täglichen Kasseneröffnung an, innerhalb welcher ein Tagesabschluss erfolgen (z.B. innerhalb von 24h). "-1" - nicht gesetzt. |
| Return and sale behavior |
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). "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. "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. |
| Return reference behavior |
Belegreferenz bei Retouren "single" - bei Retouren darf nur auf einen Vorbeleg (Verkaufsbeleg der retournierten Ware bzw. Dienstleistung) referenziert werden. "multiple" - bei Retouren darf auf mehrere Vorbelege (mehrere Verkaufsbelege, wenn mehrere Waren bzw. Dienstleistungen von mehreren Käufen retourniert werden). |
| Allowed return domain |
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. |
| Surcharges possible |
"true" - im jeweiligen Land sind Aufschläge (Preisaufschläge) auf Waren bzw. Dienstleistungen erlaubt. "false" - Preisaufschläge sind nicht erlaubt. |
| Trainingmode allowed |
"true" - Kasse darf über einen Trainingsmodule verfügen. "false" - Kasse darf keinen Trainings-/Demo-Modus aufweisen. |
| Fiscal module calculates tax rates |
Gibt an, ob die Mehrwertsteuersätze durch das jeweilige Fiskalisierungsmodul des Landes berechnet werden. "true" - Fiskalisierungsmodul berechnet die MwSt.-Sätze. "false" - Kasse muss MwSt.-Sätze berechnen. |
| Amount decimal places |
Gibt an, ob und wie viele Nachkommastellen im JSON-Dokument an die Fiscal Middleware enthalten sein müssen, wenn Beträge / Summen gesendet werden. |
| Fiscal document types |
Dokumententypen, welche im jeweiligen Land "zu fiskalisieren" sind. Also z.B. durch die vorgeschriebene Hardwarekomponente verarbeitet werden, signiert werden, etc. |
| Document types (supported/not supported) |
Im jeweiligen Land unterstützte Dokumententypen. "supported" - diese Dokumenten Typen können übermittelt werden. "not supported" - diese Dokumenten Typen können nicht übermittelt werden (Fehlermeldung!). |
| Payment types (supported/not supported) |
Im jeweiligen Land unterstützte Zahlungsarten. "supported" - diese Zahlungsarten können übermittelt werden (sind im jeweiligen Land zulässig). "not supported" - diese Zahlungsarten können nicht übermittelt werden (sind im jeweiligen Land z.B. nicht zulässig). |
| Business transaction types (supported/not supported) |
Im jeweiligen Land unterstützte Geschäftsfalls-Typen. "supported" - diese Geschäftsfalls-Typen können übermittelt werden (sind im jeweiligen Land zulässig). "not supported" - diese Geschäftsfalls-Typen können nicht übermittelt werden (sind im jeweiligen Land z.B. nicht zulässig). |
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.