👩🏻‍⚕️ 🤱🏿 🔃 Comment j'ai intégré POS-terminal et FR IKKM-Touch dans 1C: entreprise 🚵🏿 🧘🏼 🧑🏾‍🤝‍🧑🏽

Une instruction étape par étape répondra à la plupart des questions sur la connexion d'un appareil 2en1 à une plate-forme 1C (même si elle ne répond pas à tous, nous analyserons volontiers le reste dans les commentaires), montrera les options et modes de connexion possibles, les pilotes et le logiciel nécessaire sous la coupe.

L'article original de ma performance sur ce sujet est déjà sur Internet, et cette option a été réécrite et finalisée spécialement pour les lecteurs de Habr conformément aux règles (j'espère que je n'ai rien cassé). Donc…

Interaction des équipements de caisse avec la plateforme 1C

Avant de procéder directement à la connexion, nous analyserons les options possibles pour les modes de fonctionnement, il n'y en a que deux: l'échange de données hors ligne et l'échange en ligne.

Lors d'un échange HORS LIGNE

Un échange intermittent et périodique se produit. La base de stock et les prix de 1C sont déchargés dans l'appareil.

Le courrier, par exemple, prend la machine et se rend sur le terrain pour les commandes, remet les chèques fiscaux aux clients et accepte les espèces et les cartes bancaires pour le paiement. Après la fin de la journée de travail, l'employé revient pour soumettre le rapport et l'argent, l'appareil se connecte au réseau local de l'entreprise et télécharge les résultats du quart de travail (rapport des ventes au détail, voir la figure ci-dessous).

Les classiques du genre-échange en ligne

Il s'agit d'un lien permanent de l'équipement de la caisse enregistreuse avec le système de comptabilité, l'appareil est toujours installé à la caisse enregistreuse, alors qu'il n'est pas nécessaire d'y télécharger toute la gamme d'articles et de prix, toutes les données sont prises de 1C sur le réseau. Ce mode de fonctionnement de l'équipement de caisse enregistreuse peut être trouvé dans tous les supermarchés modernes.

Et quelques autres choses avant de commencer l'intégration

Étant donné que l'appareil est à la fois une caisse enregistreuse et en même temps un terminal d'acquisition, dans le cas d'un échange EN LIGNE vers la plate-forme 1C, il s'accroche à deux pilotes différents (comme deux appareils distincts).

Nous intégrerons en utilisant:
la version 1.9 du pilote de registraire fiscal pour la plate-forme 1C 8.3 l'
acquisition du pilote de terminal version 1.9 pour la même plateforme
OFFLINE IKKM Exchange version 1.6 logiciel d'échange de données

Intégration avec échange OFFLINE

Décompressez l' archive iKKMExchange.rar sur le lien ci-dessus à un endroit pratique.

Exécutez le script createINI.bat et le fichier de paramètres Settings.ini est créé. Nous allons nous

attarder sur les paramètres en ouvrant Settings.ini dans n'importe quel éditeur de texte:

«Log»: «off» - journal des opérations de l'application est désactivé par défaut.

RecNumLim: 2500 max. nombre d'unités de stockage (SKU) dans la base de stock. 2500 est le chiffre par défaut.

"IPPort": port 8082 sur lequel l'échange sera effectué avec 1C.

"Cash": 0, "Bank": 1, "Tara": 2, "Credit": 3 - ce sont les paramètres qui doivent être identiques du côté 1C de la plateforme.

En espèces-sign indique un retrait en espèces.

Banque - indique l'acceptation du paiement par carte bancaire.

Tara - indique la réception des conteneurs. Le signe est utilisé comme comptabilité de remise, dans le système de fidélisation actuel, etc.

Crédit - désignation de crédit.

Pour que l'échange se déroule correctement, il est nécessaire de vérifier et de corriger les signes par leurs noms et numéros d'identification sur le côté 1C.

Nous apportons des modifications à notre discrétion, enregistrez le fichier.

Après les paramètres, vous pouvez exécuter iKKMExchange.exe. Après un démarrage réussi, l'icône du même nom apparaîtra dans la barre des tâches du bureau.

Nous procédons à la configuration sur le côté de l'appareil IKKM intégré

Pour ce faire, accédez à l'élément «Paramètres du périphérique» dans le périphérique , puis à «Importer» , dans la fenêtre qui s'ouvre, effectuez les procédures indiquées dans la vidéo ci-dessous:

Comme vous pouvez le voir dans le didacticiel vidéo, dans la fenêtre «Configuration de la connexion», vous devez porter une attention particulière au remplissage de deux lignes: «Répertoire de produits HTTP» et «Journal de document HTTP» .

Les deux liens commencent par l'adresse IP du PC, où nous allons intégrer, puis le port de connexion (que nous avons spécifié dans Settings.ini plus tôt ) est enregistré , après la barre oblique, la commande reste inchangée.

Ainsi, la chaîne de lien de référence ressemblera à ceci:
192.168.0.11:8082/GetPriceList en tenant compte du port de connexion par défaut.
Et la ligne du journal des documents est:
192.168.0.11:8082/SalesReport

Pour apporter des modifications aux lignes, vous devez appeler le clavier virtuel sur l'écran de l'appareil en appuyant sur le bouton physique de l'appareil avec l'icône «flèche vers le haut», il est situé dans le coin inférieur gauche de l'appareil.

Il peut arriver que pendant le processus d'installation, vous trouviez des listes déroulantes inactives dans l'onglet «Importer l'installation» , ce qui rend impossible la poursuite de l'intégration. Cela indique un firmware obsolète de l'appareil, la mise à jour du firmware vers la dernière version corrigera la situation.

Revenons maintenant au dossier avec l'application IKKMExchange .

Si les réglages sur le côté de l'appareil sont effectués correctement, la première interaction avec le PC via le réseau créera un sous-dossier interne, dont le nom sera le numéro d'enregistrement de l'appareil IKKM connecté. Toutes les données d'échange pour un appareil spécifique auront lieu dans ce dossier.

L'échange de données a lieu via l' API REST . Un échange réussi dans le dossier ressemblera à ceci:

Réglage OFFLINE sur le côté 1C

Nous mettons en place une nouvelle règle d'échange avec les équipements connectés.

Dans la fenêtre «Paramètres de l'équipement connecté», vous devez cocher la case correspondante, puis nous irons au lien «Règles pour l'échange avec l'équipement connecté» .

Nous allons créer une nouvelle règle d'échange avec le nom et l'entrepôt pour le déchargement des articles de marchandise, nous indiquerons également les paramètres par lesquels les marchandises seront sélectionnées pour le déchargement dans le champ "Sélection" .

Lorsque vous cliquez sur «Actualiser» dans l'onglet «Liste de prix» , nous observons le remplissage de la section tabulaire ci-dessous avec les articles de base en fonction de la sélection. Colonne "SKU"contient le code de chaque produit de la liste, à l'aide duquel il sera déjà possible de trouver facilement la nomenclature nécessaire sur l'appareil. Si certains produits de la liste ne contiennent pas le code SKU, il est préférable de le créer à l'aide de la clé "Générer SKU" . Enregistrez les modifications.

Vous devez maintenant associer la règle créée à l'équipement, pour cela, nous revenons à la fenêtre "Configuration de l'équipement connecté" , cliquez sur le lien "Équipement connecté" .

Nous sélectionnons le type d'équipement approprié, cliquez sur "Créer" , dans une nouvelle fenêtre vous devez spécifier le pilote, la règle d'échange que nous avons créée précédemment, le numéro de série de l'appareil peut être spécifié, mais pas obligatoire.

Nous effectuerons des réglages supplémentaires de l'équipement connecté en cliquant sur
«Configurer» dans la même fenêtre .
«Version au format Exchange» - 1.6 dans la liste déroulante.
« Décharger le répertoire » - le chemin d'accès au dossier avec le numéro de série de l'équipement dans le répertoire iKKMExchange.
«Nom du fichier de paramètres» - prescrire «Paramètres» .
«Fichier de liste de prix max» - vous devez enregistrer «PriceList» .
«Répertoire de téléchargement» - le chemin d'accès est similaire au répertoire de téléchargement.
«Nom du fichier de rapport de vente» - indiquez «SalesReport» .
Enregistrez les modifications et quittez.

Quelques étapes plus tôt, j'ai noté les signes des équipes que nous avons examinées dans le document Settings.ini , nous devons maintenant les dupliquer déjà dans le système comptable 1C.

Nous allons à la section, comme indiqué dans la figure ci-dessous:

Par le bouton "Créer" , une fenêtre pour ajouter un nouvel équipement de caisse enregistreuse à 1C s'ouvre.

Le premier élément est l'indication du lieu de travail correct.

Deuxièmement, vous pouvez spécifier le numéro de série de KKM, il s'agit d'une condition facultative.

Le troisième paragraphe - sélectionne les paramètres d'équipement précédemment créés «KKM hors ligne»

Dans la «Correspondance des rubriques» (quatrième paragraphe de la figure), nous indiquons le nom et définissons les valeurs d'identification dans Settings.ini

Enregistrez les modifications et passez à la dernière étape de configuration.

Nous vérifierons comment les données seront téléchargées de 1C vers le dossier dans IKKMExchange correspondant à l'appareil, passez à la section 1C nécessaire: à

condition que les opérations de configuration précédentes soient effectuées correctement et que l'entrepôt approprié soit sélectionné, ainsi que la règle de téléchargement, notre équipement hors ligne s'affiche dans la fenêtre. Cliquez sur "Décharger" .

Le déchargement aura lieu dans le dossier avec le numéro de série de votre KKM.

Si vous ouvrez Settings.xml, vous pouvez trouver les codes de paiement que nous avons définis plus tôt.

La configuration du partage hors ligne est terminée.

Si vous avez installé la dernière version de la configuration 1C: retail, la fonction d'échange automatique sera également à votre disposition.

Configurer le partage en ligne

Pour éviter que l'article ne se transforme en deux volumes, une démonstration des paramètres d'échange EN LIGNE sera présentée sur l'exemple d'IKKM, en tant que registraire fiscal. Le processus de mise en place d'un échange avec la partie bancaire de l'appareil (comme un terminal acquéreur) semble similaire. L'exemple utilise la configuration «1C: gestion commerciale», le processus d'installation sur d'autres configurations sera légèrement différent en raison des caractéristiques de l'interface, mais le principe est conservé.

Tout d'abord, vous devez installer le pilote.

Dans la fenêtre de l'article «RMK et équipement» , nous trouvons le lien «Équipement connecté» et cliquez dessus.

Accédez à l'onglet "Pilotes matériels" , puis cliquez sur le bouton "Ajouter un nouveau pilote à partir du fichier" .

Téléchargez l'archive avec le pilote, présentée dans l'article ci-dessus, et ouvrez-la.

Le premier téléchargement du pilote génère une erreur. Pour poursuivre l'intégration, il vous suffit de réessayer la tentative d'installation et la deuxième fois que le pilote sera installé avec succès.

La moitié du chemin pour configurer l'échange en ligne est terminée, allez dans l'onglet «Connecter et configurer l'équipement» , le type d'équipement à connecter est «Registres fiscaux» , cliquez sur «Créer» . Dans la liste déroulante, sélectionnez iKKM.

Après avoir cliqué sur «Configurer» , la fenêtre des paramètres de l'équipement que nous avons choisi s'ouvre, où vous devez faire attention au paramètre d'impression de l'imprimante «Nombre de caractères par ligne»: pour l'imprimante intégrée en iKKM (largeur du papier 57 mm), le paramètre standard (vingt-quatre caractères) convient, si vous connectez une imprimante externe (80 mm et plus), vous pouvez utiliser d'autres valeurs (trente-six, quarante-huit caractères).

Dans l'élément «Adresse IP», vous devez spécifier ip sans ajouter le port d'un périphérique iKKM sur le réseau, après l'avoir défini avec une adresse statique via un routeur.

«Où allons-nous stocker la clé API» - le point auquel nous plaçons un répertoire qui vous convient avec un document texte d'une clé API dynamique pour protéger les opérations réseau. Chaque fois lors d'une opération fiscale, la clé sera remplacée par une valeur différente.

L'élément "Clé API WEB" doit contenir la clé de sécurité actuelle.

La clé API actuelle peut être obtenue à partir de l'interface Web de l'appareil en la contactant après la connexion au réseau via le navigateur «adresse IP de l'appareil: 8080» .

Tous les paramètres sont définis, vous pouvez maintenant tester l'appareil.

Hourra, la mise en place du FR s'est terminée avec succès!

Enfin, une autre astuce

Si pendant l'utilisation de l'appareil, vous ne pouvez pas vendre l'un ou l'autre produit via iKKM (l'appareil ne le casse pas dans le chèque), vérifiez les paramètres d'arrondi dans votre 1C:

Option correcte pour 1C: Retail, 1C: Pharmacie

Pour 1C: Restaurant

Bon pour tout le monde caisses enregistreuses rapides et pratiques pour vous!

Comment j'ai intégré POS-terminal et FR IKKM-Touch dans 1C: entreprise