Forum

Bitte beachte auch unsere Knowledgebase und das Handbuch!

Importmodus JSON (R...
 
Benachrichtigungen
Alles löschen

Importmodus JSON (R2B/Receipt): Storno, Rückmeldung der Bon-Nummer, Fehlerbehandlung

0 Beiträge
1 Benutzer
0 Reactions
10 Ansichten
0
[#613]
Themenstarter

Hallo Chris,

ich binde QRK (Version 1.44.0, Build 260926) an unsere Händlersoftware für Autohändler an.
Die Software erstellt die Rechnung, bei Barzahlung oder Bankomat legt ein lokaler Agent eine JSON-Datei im Importordner ab. Wir nutzen den Importmodus laut Dokumentation „5.4 Importmode JSON Schnittstelle". In Tests an einer lokalen Testkasse funktioniert der Import. Ich habe einige Fragen, damit ich ihn
RKSV-konform und nachvollziehbar betreiben können.

Was ich getestet habe (alle wurden importiert):
- R2B bar: {"r2b":[{"receiptNum":"ANZ26 Link entfernt ","secondPayedBy":"0","customerText":"…"}]} ergibt den Bon „Zahlungsbeleg für Rechnung ANZ26/TEST1 – nicht für
den Vorsteuerabzug geeignet", M% 00.
- R2B Bankomat über 15.490,00 (payedBy":"1").
- R2B-Mischzahlung: payedBy":"0", given":"10000.00", secondPayedBy":"1", gross":"15490.00". Der Bon zeigt „Gegeben 10.000,00" und „Bankomat 5.490,00".
- Storno als R2B mit negativem Betrag ("gross":"-1500.00"), jeweils bar und Bankomat. Bei der Mischzahlung als Storno mit given":"-10000.00" und secondPayedBy":"1" wurde der gesamte Betrag als BAR gebucht, given und secondPayedBy wurden ignoriert.

1. Storno
- Ist ein negativer Betrag im R2B- oder Receipt-JSON der vorgesehene Weg für einen Storno? In der Kasse selbst gibt es einen eigenen Storno-Button. Erzeugt dieser einen anderen Belegtyp (RKSV-Stornobeleg) als ein importierter Bon mit negativem Betrag?
- Gibt es ein Feld oder einen Weg, einen Storno ausdrücklich zu kennzeichnen und auf den ursprünglichen Bon (Bon-Nr.) zu verweisen?
- Bei einer Mischzahlung wird der Storno vollständig in einer Zahlungsart gebucht (siehe oben). Ist es richtig, dass wir dafür je Zahlungsart einen eigenen Storno-Bon senden müssen? Oder gibt es einen besseren Weg?
- Falls ein negativer Betrag nicht RKSV-konform ist: Wie sollen wir Stornos übergeben?

2. Rückmeldung nach dem Import
- Kann QRK nach dem Import ein Ergebnis liefern, mit Bon-Nummer, Zeitstempel und Fehlerstatus? Wir möchten die QRK-Bon-Nr. zu unserer Rechnung speichern und referenzieren. Aktuell sehe ich nur, dass die Datei auf .old umbenannt und ein PDF erzeugt wird.
- Mögliche Wege aus meiner Sicht: eine Ergebnisdatei neben der .old-Datei, die Bon-Nr. im PDF-Dateinamen, ein zweiter Ordner, ein Aufruf (Kommandozeile oder Webhook) oder ein lesbarer Datenbankzugriff. Was ist vorgesehen oder empfohlen?
- Was passiert bei einer fehlerhaften Datei (ungültiges JSON, falsches Format, doppelter Name)? Wird sie abgelehnt, umbenannt (z. B. .err) oder protokolliert? Wo sehen wir das?

3. Eindeutigkeit und Wiederholung
- Wird in R2B auf die receiptNum geachtet? Kann dieselbe Rechnungsnummer mehrfach vorkommen (Anzahlung und Restzahlung, Teilzahlungen, Storno)? Gibt es eine Dublettenprüfung?
- Du schreibst, wiederverwendete Dateinamen führten zu Fehlern. Was genau passiert dabei?

4. Buchung und Auswertung
- Wie werden R2B-Bons (Steuersatz 0, „nicht für den Vorsteuerabzug geeignet") in Tagesabschluss, Monatsbericht und DEP/FinanzOnline geführt? Kommen sie als Barumsatz mit 0 % vor? Ich muss sicherstellen, dass die USt nicht doppelt (Rechnung und Bon) gemeldet wird.
- Wie beurteilen Sie die Kombination aus Rechnung mit USt und R2B-Bon rechtlich (RKSV)? Ist sie so vorgesehen?
- Wie ist es bei Anzahlungen, wenn später die Schlussrechnung kommt?

5. Technisches zum Import
- Läuft der Import nur, wenn QRK im Importmodus geöffnet ist, oder auch im Hintergrund (forceImportMode)? Wir möchten den Agenten unbeaufsichtigt auf einem Kassenrechner betreiben.
- Zeichensatz und Sonderzeichen (Umlaute, Anführungszeichen, /, Backslash), maximale Länge von customerText und receiptNum.
- Kann das Belegdatum mitgegeben werden (z. B. Rechnungsdatum) oder gilt immer der Importzeitpunkt?
- Mehrere Kassen: ein Importordner pro Kasse, oder lässt sich die Zielkasse in der Datei angeben?

Vielen Dank für eure Unterstützung!
LG Mirko


Teilen: