👨‍👩‍👦 🌥️ 😠 Wie ich POS-Terminal und FR IKKM-Touch in 1C: Enterprise integriert habe 👨🏽‍🏭 🕎 🌍

Eine Schritt-für-Schritt-Anleitung beantwortet die meisten Fragen zum Anschließen eines 2in1-Geräts an eine 1C-Plattform (auch wenn nicht alle beantwortet werden, analysieren wir den Rest gerne in den Kommentaren) und zeigt mögliche Verbindungsoptionen und -modi, Treiber und die erforderliche Software auf.

Der ursprüngliche Artikel in meinem Auftritt zu diesem Thema ist bereits im Internet und diese Option wurde speziell für Habrs Leser in Übereinstimmung mit den Regeln umgeschrieben und finalisiert (ich hoffe, ich habe nichts gebrochen). Damit…

Interaktion von Bargeldausrüstung mit 1C-Plattform

Bevor wir direkt zur Verbindung übergehen, werden wir die möglichen Optionen für Betriebsarten analysieren. Es gibt nur zwei davon: Offline-Datenaustausch und Online-Austausch.

Beim OFFLINE-Austausch

Es findet ein intermittierender periodischer Austausch statt. Die Basis von Lagerbeständen und Preisen von 1C wird in das Gerät entladen.

Bild

Der Kurier nimmt zum Beispiel den Automaten und geht auf Bestellungen vor Ort, verteilt Steuerschecks an Kunden und akzeptiert Bargeld und Bankkarten zur Zahlung. Nach dem Ende des Arbeitstages kehrt der Mitarbeiter zurück, um den Bericht und das Geld einzureichen. Das Gerät stellt eine Verbindung zum lokalen Netzwerk des Unternehmens her und lädt die Ergebnisse der Arbeitsschicht hoch (Einzelhandelsverkaufsbericht, siehe Abbildung unten).

Bild

Klassiker des Genre-ONLINE-Austauschs

Dies ist eine dauerhafte Verbindung der Registrierkassenausrüstung mit dem Buchhaltungssystem. Das Gerät ist immer an der Registrierkasse installiert. Es ist nicht erforderlich, die gesamte Palette an Artikeln und Preisen hochzuladen. Alle Daten werden von 1C über das Netzwerk abgerufen. Diese Funktionsweise von Registrierkassengeräten ist in jedem der modernen Supermärkte zu finden.

Und noch ein paar Dinge, bevor Sie mit der Integration beginnen

Da das Gerät sowohl eine Registrierkasse als auch gleichzeitig ein Erwerbsterminal ist, klammert es sich beim ONLINE-Austausch an die 1C-Plattform an zwei verschiedene Treiber (wie zwei separate Geräte).

Wir werden Folgendes integrieren:
Fiscal Registrar Driver Version 1.9 für 1C Plattform 8.3
Erwerb von Terminal Treiber Version 1.9 für dieselbe Plattform
OFFLINE IKKM Exchange 1.6 Datenaustauschsoftware

Integration in OFFLINE-Austausch

Entpacken Sie das Archiv iKKMExchange.rar unter dem obigen Link an einen geeigneten Ort.

Bild

Führen Sie das Skript createINI.bat aus , und die Einstellungsdatei Settings.ini wird erstellt. Wir werden uns mit den Einstellungen befassen ,

Bild

indem Sie Settings.ini in einem beliebigen Texteditor öffnen :

Bild

"Log": "off" - Anwendungsbetriebsprotokoll ist standardmäßig deaktiviert.

RecNumLim: max. 2500 Anzahl der Lagerhaltungseinheiten (SKU) in der Lagerbasis. 2500 ist die Standardziffer.

"IPPort": Port 8082, an dem der Austausch mit 1C erfolgt.

"Cash": 0, "Bank": 1, "Tara": 2, "Credit": 3 - Dies sind die Parameter, die auf der 1C-Seite der Plattform identisch sein sollten.

Kasse-sign zeigt Bargeldbezug an.

Bank - Zeigt die Annahme der Zahlung per Bankkarte an.

Tara - zeigt den Empfang von Containern an. Das Zeichen wird als Rabattabrechnung, im aktuellen Treue-System usw. verwendet.

Kredit - Kreditbezeichnung.

Damit der Austausch korrekt verläuft, müssen die Zeichen anhand ihrer Namen und Identifikationsnummern auf der 1C-Seite überprüft und korrigiert werden.

Wir nehmen Änderungen nach eigenem Ermessen vor und speichern die Datei.

Nach den Einstellungen können Sie iKKMExchange.exe ausführen. Nach einem erfolgreichen Start wird das gleichnamige Symbol in der Taskleiste des Desktops angezeigt.

Bild

Wir fahren mit der Konfiguration auf der Seite des integrierten IKKM-Geräts fort

Gehen Sie dazu im Gerät zum Element „Geräteeinstellungen “ und dann im folgenden Fenster zu „Importieren“. Führen Sie die im folgenden Video gezeigten Schritte aus:

Wie Sie im Video-Tutorial sehen können, müssen Sie im Fenster „Verbindungsaufbau“ besonders darauf achten, zwei Zeilen auszufüllen: „HTTP-Produktverzeichnis“ und „HTTP-Dokumentprotokoll“ .

Beide Links beginnen mit der IP-Adresse des PCs, in den wir integrieren werden. Anschließend wird der Verbindungsport (den wir zuvor in Settings.ini angegeben haben ) registriert . Nach dem Schrägstrich bleibt der Befehl unverändert.

Daher sieht die Referenzlinkzeichenfolge folgendermaßen aus:
192.168.0.11:8082/GetPriceList unter Berücksichtigung des Standardverbindungsports.
Die Zeile des Dokumentjournals lautet:
192.168.0.11:8082/SalesReport

Um Änderungen an den Leitungen vorzunehmen, müssen Sie die virtuelle Tastatur auf dem Bildschirm des Geräts aufrufen, indem Sie die physische Taste auf dem Gerät mit dem Symbol „Aufwärtspfeil“ drücken. Diese befindet sich in der unteren linken Ecke des Geräts.

Es kann vorkommen, dass Sie während des Setup-Vorgangs auf der Registerkarte „Setup importieren“ inaktive Dropdown-Listen finden , die eine weitere Integration unmöglich machen. Dies weist auf eine veraltete Firmware des Geräts hin. Durch Aktualisieren der Firmware auf die neueste Version wird die Situation behoben.

Bild

Nun zurück zum Ordner mit der IKKMExchange- Anwendung .

Wenn die Einstellungen an der Seite des Geräts korrekt vorgenommen wurden, wird bei der ersten Interaktion mit dem PC über das Netzwerk ein interner Unterordner erstellt, dessen Name die Registrierungsnummer des angeschlossenen IKKM-Geräts ist. Alle Austauschdaten für ein bestimmtes Gerät finden in diesem Ordner statt.

Bild

Der Datenaustausch erfolgt über die REST-API . Ein erfolgreicher Austausch im Ordner sieht folgendermaßen aus:

Bild

OFFLINE-Einstellung auf der 1C-Seite

Wir richten eine neue Austauschregel für angeschlossene Geräte ein.

Bild

Im Fenster "Einstellungen der angeschlossenen Geräte" müssen Sie das entsprechende Kontrollkästchen aktivieren, dann gehen wir zum Link "Regeln für den Austausch mit angeschlossenen Geräten" .

Bild

Wir erstellen eine neue Umtauschregel mit dem Namen und dem Lager für das Entladen von Warenartikeln und geben im Feld "Auswahl" auch die Parameter an, nach denen die Waren zum Entladen ausgewählt werden .

Bild

Wenn Sie auf der Registerkarte "Preisliste" auf "Aktualisieren" klicken , beobachten wir, dass der folgende tabellarische Abschnitt entsprechend der Auswahl mit Warenartikeln gefüllt wird. Spalte "SKU"enthält den Code jedes Produkts in der Liste, mit dessen Hilfe es bereits möglich ist, den gewünschten Artikel auf dem Gerät leicht zu finden. Wenn einige Produkte in der Liste keinen SKU-Code enthalten, ist es besser, ihn mit dem Schlüssel "SKU generieren" zu erstellen . Speichern Sie die Änderungen.

Bild

Jetzt müssen Sie die erstellte Regel dem Gerät zuordnen. Dazu kehren wir zum Fenster "Konfigurieren verbundener Geräte" zurück und klicken auf den Link "Verbundene Geräte" .

Bild

Wir wählen den geeigneten Gerätetyp aus, klicken auf "Erstellen" , in einem neuen Fenster müssen Sie den Treiber angeben, die zuvor erstellte Austauschregel, die Seriennummer des Geräts kann angegeben werden, ist aber nicht erforderlich.

Bild

Wir nehmen zusätzliche Einstellungen der angeschlossenen Geräte vor, indem wir im selben Fenster auf
„Konfigurieren“ klicken .
"Exchange-Formatversion" - 1.6 aus der Dropdown-Liste.
" Verzeichnis entladen " - Der Pfad zum Ordner mit der Seriennummer des Geräts im iKKMExchange-Verzeichnis.
"Name der Einstellungsdatei" - "Einstellungen" vorschreiben .
"Max Preisliste" - Sie müssen "Preisliste" registrieren .
"Download-Verzeichnis" - Der Pfad ähnelt dem Upload-Verzeichnis.
"Name der Verkaufsberichtsdatei" - Geben Sie "SalesReport" an .
Speichern Sie die Änderungen und beenden Sie sie.

Bild

Ein paar Schritte zuvor habe ich die Anzeichen der Teams notiert, die wir im Dokument Settings.ini untersucht haben. Jetzt müssen wir sie bereits im 1C-Buchhaltungssystem duplizieren.

Wir gehen zu dem Abschnitt, wie in der folgenden Abbildung gezeigt:

Bild

Über die Schaltfläche "Erstellen" wird ein Fenster zum Hinzufügen neuer Registrierkassengeräte zu 1C geöffnet.

Der erste Punkt ist die Angabe des richtigen Arbeitsplatzes.

Zweitens können Sie die Seriennummer von KKM angeben. Dies ist eine optionale Bedingung.

Der dritte Absatz - wählt die zuvor erstellten Geräteeinstellungen „KKM Offline“ aus.

In der „Entsprechung der Lohnarten“ (vierter Absatz in der Abbildung) geben wir den Namen an und legen die Identifikationswerte in Settings.ini fest

Bild

Speichern Sie die Änderungen und fahren Sie mit dem letzten Konfigurationsschritt fort.

Wir werden überprüfen, wie die Daten von 1C in den Ordner in IKKMExchange heruntergeladen werden, der dem Gerät entspricht. Gehen Sie zum erforderlichen 1C-Abschnitt:

Bild

Vorausgesetzt, die vorherigen Einrichtungsvorgänge werden korrekt ausgeführt und das richtige Lager ausgewählt, sowie die Upload-Regel werden unsere Offline-Geräte im Fenster angezeigt. Klicken Sie auf "Entladen" .

Bild

Das Entladen erfolgt in dem Ordner mit der Seriennummer Ihres KKM.

Bild

Wenn Sie Settings.xml öffnen, finden Sie die zuvor festgelegten Zahlungscodes.

Bild

Das Festlegen der OFFLINE-Freigabe ist abgeschlossen.

Wenn Sie die neueste Version der 1C: Retail-Konfiguration installiert haben, steht Ihnen auch die automatische Austauschfunktion zur Verfügung.

Bild

Konfigurieren Sie die ONLINE-Freigabe

Um zu verhindern, dass aus dem Artikel ein zweibändiger Artikel wird, wird am Beispiel von IKKM als Fiskalregistrator eine Demonstration der ONLINE-Austauscheinstellungen gezeigt. Der Vorgang zum Einrichten einer Vermittlungsstelle mit dem Bankteil des Geräts (wie bei einem erwerbenden Terminal) sieht ähnlich aus. In diesem Beispiel wird die Konfiguration „1C: Trade Management“ verwendet. Der Installationsprozess bei anderen Konfigurationen unterscheidet sich aufgrund der Funktionen der Schnittstelle geringfügig, das Prinzip bleibt jedoch erhalten.

Zuerst müssen Sie den Treiber installieren.

Im Fenster des Artikels „RMK und Ausrüstung“ finden wir den Link „Verbundene Ausrüstung“ und klicken darauf.

Bild

Gehen Sie auf die „Hardware - Treiber“ Registerkarte , und klicken Sie dann auf die Schaltfläche „Hinzufügen einen neuen Treiber aus der Datei . “

Bild

Laden Sie das im obigen Artikel beschriebene Archiv mit dem Treiber herunter und öffnen Sie es.

Bild

Der erste Treiber-Download führt zu einem Fehler. Um die Integration fortzusetzen, müssen Sie nur den Installationsversuch wiederholen, und beim zweiten Mal wird der Treiber erfolgreich installiert.

Bild

Die Hälfte der Konfiguration von ONLINE Exchange ist abgeschlossen. Wechseln Sie zur Registerkarte „Geräte verbinden und konfigurieren“ . Der Typ der verbundenen Geräte lautet „Steuerregistrare“ . Klicken Sie auf „Erstellen“ . Wählen Sie aus der Dropdown-Liste iKKM aus.

Bild

Nachdem Sie auf "Konfigurieren" geklickt haben , wird das Fenster mit den Parametern des von uns ausgewählten Geräts geöffnet, in dem Sie auf die Druckparameter des Druckers "Anzahl der Zeichen pro Zeile" achten sollten.: Für den in iKKM integrierten Drucker (Papierbreite 57 mm) ist der Standardparameter (vierundzwanzig Zeichen) geeignet. Wenn Sie einen externen Drucker (80 mm und mehr) anschließen, können Sie andere Werte (sechsunddreißig, achtundvierzig Zeichen) verwenden.

Im Element "IP-Adresse" müssen Sie die IP-Adresse angeben, ohne den Port eines iKKM-Geräts im Netzwerk hinzuzufügen, nachdem Sie über einen Router eine statische Adresse festgelegt haben.

"Wo werden wir den API-Schlüssel speichern?" - der Punkt, an dem wir ein für Sie geeignetes Verzeichnis mit einem Textdokument eines dynamischen API-Schlüssels zum Schutz des Netzwerkbetriebs ablegen. Jedes Mal während einer Steueroperation wird der Schlüssel durch einen anderen Wert ersetzt.

Das Element "WEB-API-Schlüssel" sollte den aktuellen Sicherheitsschlüssel enthalten.

Bild

Der aktuelle API-Schlüssel kann über die Weboberfläche des Geräts abgerufen werden, indem Sie ihn kontaktieren, nachdem Sie über den Browser „Geräte-IP-Adresse: 8080“ eine Verbindung zum Netzwerk hergestellt haben .

Bild

Alle Einstellungen sind vorgenommen, jetzt können Sie das Gerät testen.

Bild

Hurra, die Einrichtung des FR wurde erfolgreich abgeschlossen!

Zum Schluss noch ein Trick

Wenn Sie während der Verwendung des Geräts das eine oder andere Produkt nicht über iKKM verkaufen können (das Gerät bricht es bei der Prüfung nicht), überprüfen Sie die Rundungseinstellungen in Ihrer 1C:

Richtige Option für 1C: Einzelhandel, 1C: Apotheke

Bild

für 1C: Restaurant

Bild

Gut für alle schnelle und bequeme Registrierkassen für Sie!

Wie ich POS-Terminal und FR IKKM-Touch in 1C: Enterprise integriert habe