🛫 🚈 🚞 Como integrei o terminal POS e o FR IKKM-Touch em 1C: empresa 👸🏻 🎉 🙇🏾

Uma instrução passo a passo responderá à maioria das perguntas sobre como conectar um dispositivo 2in1 a uma plataforma 1C (mesmo que não responda a todas, teremos o prazer de analisar o restante nos comentários), mostrar possíveis opções e modos de conexão, drivers e o software necessário.

O artigo original em minha apresentação sobre esse assunto já está na Internet, e essa opção foi reescrita e finalizada especialmente para os leitores de Habr, em conformidade com as regras (espero não ter quebrado nada). Assim…

Interação de equipamentos de caixa com a plataforma 1C

Antes de prosseguir diretamente para a conexão, analisaremos as opções possíveis para os modos de operação, existem apenas duas delas: troca de dados offline e troca online.

Quando troca OFFLINE

Ocorre uma troca periódica e intermitente. A base do estoque e os preços de 1C são descarregados no dispositivo.

imagem

O correio, por exemplo, pega a máquina e vai para o campo com os pedidos, entregando cheques fiscais aos clientes e aceitando dinheiro e cartões bancários para pagamento. Após o final do dia útil, o funcionário retorna para enviar o relatório e o dinheiro, o dispositivo se conecta à rede local da empresa e carrega os resultados do turno (relatório de vendas no varejo, veja a figura abaixo).

imagem

Clássicos da troca de gênero-ONLINE

Este é um link permanente do equipamento da caixa registradora para o sistema de contabilidade, o dispositivo está sempre instalado na caixa registradora, embora não seja necessário fazer upload de toda a gama de itens e preços para ele, todos os dados são retirados do 1C pela rede. Este modo de operação do equipamento da caixa registradora pode ser encontrado em qualquer supermercado moderno.

E mais algumas coisas antes de iniciar a integração

Como o dispositivo é uma caixa registradora e, ao mesmo tempo, um terminal adquirente, no caso de troca ONLINE para a plataforma 1C, ele se apega a dois drivers diferentes (como dois dispositivos separados).

Vamos integrar usando:
driver do registrador fiscal versão 1.9 para a plataforma 1C 8.3
adquirindo o driver do terminal versão 1.9 para a mesma plataforma
OFFLINE IKKM Exchange versão 1.6 software de troca de dados

Integre-se à troca OFFLINE

Descompacte o arquivo iKKMExchange.rar no link acima para um local conveniente.

imagem

Execute o script createINI.bat e o arquivo de configurações Settings.ini será criado. Vamos nos

imagem

concentrar nas configurações abrindo Settings.ini em qualquer editor de texto:

imagem

"Log": "off" - log de operação do aplicativo está desativado por padrão.

RecNumLim: 2500 máx. número de unidades de manutenção de estoque (SKU) na base de estoque. 2500 é o dígito padrão.

"IPPort": porta 8082 na qual a troca será feita com 1C.

"Dinheiro": 0, "Banco": 1, "Tara": 2, "Crédito": 3 - esses são os parâmetros que devem ser idênticos no lado 1C da plataforma.

Dinheiro-sign indica retirada de dinheiro.

Banco - indica aceitação do pagamento com cartão bancário.

Tara - indica a recepção de contêineres. O sinal é usado como contabilidade de desconto, no atual sistema de fidelidade, etc.

Crédito - designação de crédito.

Para que a troca ocorra corretamente, é necessário verificar e corrigir os sinais por seus nomes e números de identificação no lado 1C.

Fazemos alterações a nosso critério, salve o arquivo.

Após as configurações, você pode executar o iKKMExchange.exe. Após um início bem-sucedido, o ícone com o mesmo nome aparecerá na barra de tarefas da área de trabalho.

imagem

Prosseguimos para a configuração na lateral do dispositivo IKKM integrado

Para fazer isso, vá para o item "Configurações do dispositivo" no dispositivo e , em seguida, para "Importar" , na janela que se abre, execute os procedimentos mostrados no vídeo abaixo:

Como você pode ver no tutorial em vídeo, na janela "Configuração da conexão", é necessário prestar atenção especial ao preenchimento de duas linhas: "Diretório de produtos HTTP" e "Registro de documentos HTTP" .

Os dois links começam com o endereço IP do PC, onde integraremos, e a porta de conexão (especificada anteriormente em Settings.ini ) é registrada , após a barra o comando permanece inalterado.

Portanto, a sequência de links de referência ficará assim:
192.168.0.11:8082/GetPriceList, levando em consideração a porta de conexão padrão.
E a linha do diário do documento é:
192.168.0.11:8082/SalesReport

Para fazer alterações nas linhas, você precisa chamar o teclado virtual na tela do dispositivo pressionando o botão físico no dispositivo com o ícone "seta para cima", localizado no canto inferior esquerdo do dispositivo.

Pode acontecer que, durante o processo de instalação, você encontre listas suspensas inativas na guia "Configuração de importação" , o que impossibilita a realização de mais integração. Isso indica um firmware desatualizado do dispositivo. A atualização do firmware para a versão mais recente corrigirá a situação.

imagem

Agora, volte para a pasta com o aplicativo IKKMExchange .

Se as configurações na lateral do dispositivo forem feitas corretamente, a primeira interação com o PC pela rede criará uma subpasta interna, cujo nome será o número de registro do dispositivo IKKM conectado. Todos os dados de troca para um dispositivo específico ocorrerão nesta pasta.

imagem

A troca de dados ocorre através da API REST . Uma troca bem-sucedida na pasta terá a seguinte aparência:

imagem

Configuração OFFLINE no lado 1C

Estamos estabelecendo uma nova regra de troca com equipamentos conectados.

imagem

Na janela "Configurações do equipamento conectado", é necessário definir a caixa de seleção correspondente; depois, iremos para o link "Regras para a troca com o equipamento conectado" .

imagem

Criaremos uma nova regra de troca com o nome e o depósito para descarregar itens de mercadorias, também indicaremos os parâmetros pelos quais as mercadorias serão selecionadas para descarregar no campo "Seleção" .

imagem

Quando você clica em "Atualizar" na guia "Lista de preços" , observamos o preenchimento da seção tabular abaixo com itens de mercadorias de acordo com a seleção. Coluna "SKU"contém o código de cada produto na lista, com a ajuda da qual já é possível encontrar facilmente a nomenclatura necessária no dispositivo. Se alguns produtos da lista não contiverem o código SKU, é melhor criá-lo usando a chave "Gerar SKU" . Salve as alterações.

imagem

Agora você precisa associar a regra criada ao equipamento. Para isso, retornaremos à janela "Configurando equipamento conectado" , clique no link "Equipamento conectado" .

imagem

Selecionamos o tipo de equipamento apropriado, clique em "Criar" , em uma nova janela, você precisa especificar o driver, a regra de troca que criamos anteriormente, o número de série do dispositivo pode ser especificado, mas não obrigatório.

imagem

Realizaremos configurações adicionais do equipamento conectado, clicando em
“Configurar” na mesma janela .
"Versão do formato do Exchange" - 1.6 na lista suspensa.
“ Descarregar diretório ” - o caminho para a pasta com o número de série do equipamento no diretório iKKMExchange.
“Nome do arquivo de configurações” - prescreva “Configurações” .
“Arquivo máximo da lista de preços” - você precisa registrar a “Lista de Preços” .
"Diretório de download" - o caminho é semelhante ao diretório de upload.
“Nome do arquivo do relatório de vendas” - indique “SalesReport” .
Salve as alterações e saia.

imagem

Algumas etapas anteriores, observei os sinais das equipes que examinamos no documento Settings.ini , agora precisamos duplicá-las no sistema de contabilidade 1C.

Vamos para a seção, como mostrado na figura abaixo:

imagem

Pelo botão "Criar" , uma janela para adicionar novos equipamentos de caixa registradora ao 1C é aberta.

O primeiro item é a indicação do local de trabalho correto.

Segundo, você pode especificar o número de série da KKM, esta é uma condição opcional.

O terceiro parágrafo - seleciona as configurações de equipamento criadas anteriormente "KKM Offline"

Na "Correspondência de rubricas salariais" (quarto parágrafo na figura), indicamos o nome e definimos os valores de identificação em Settings.ini

imagem

Salve as alterações e vá para a última etapa da configuração.

Verificaremos como os dados serão baixados do 1C para a pasta no IKKMExchange correspondente ao dispositivo, vá para a seção 1C necessária:

imagem

Desde que as operações de configuração anteriores sejam executadas corretamente e o armazém correto seja selecionado, bem como a regra de upload, nosso equipamento off-line é exibido na janela. Clique em "Descarregar" .

imagem

O descarregamento ocorrerá na pasta com o número de série do seu KKM.

imagem

Se você abrir o arquivo Settings.xml, poderá encontrar os códigos de pagamento definidos anteriormente.

imagem

A configuração do compartilhamento OFFLINE está concluída.

Se você instalou a versão mais recente da configuração 1C: varejo, a função de troca automática também estará disponível para você.

imagem

Configurar compartilhamento ONLINE

Para impedir que o artigo se transforme em dois volumes, uma demonstração das configurações de troca ONLINE será mostrada no exemplo da IKKM, como registradora fiscal. O processo de criação de uma troca com a parte bancária do dispositivo (como um terminal de aquisição) é semelhante. O exemplo usa a configuração “1C: trade management”, o processo de instalação em outras configurações será ligeiramente diferente devido aos recursos da interface, mas o princípio é preservado.

Primeiro, você precisa instalar o driver.

Na janela do item “RMK and equipment” , encontramos o link “Connected equipment” e clique nele.

imagem

Vá para a guia "Drivers de hardware" e clique no botão "Adicionar um novo driver do arquivo" .

imagem

Faça o download do arquivo com o driver, descrito no artigo acima, e abra-o.

imagem

O primeiro download do driver produz um erro. Para continuar a integração, basta tentar novamente a tentativa de instalação e na segunda vez em que o driver for instalado com sucesso.

imagem

Na metade do caminho para configurar a troca ONLINE, vá para a guia "Conectar e configurar o equipamento" , o tipo de equipamento a ser conectado é "Registradores fiscais" , clique em "Criar" . Na lista suspensa, selecione iKKM.

imagem

Depois de clicar em “Configurar” , a janela dos parâmetros do equipamento que escolhemos se abre, onde você deve prestar atenção ao parâmetro de impressão da impressora “Número de caracteres por linha”: para a impressora embutida no iKKM (largura do papel 57 mm), o parâmetro padrão (vinte e quatro caracteres) é adequado; se você conectar uma impressora externa (80 mm e acima), poderá usar outros valores (trinta e seis, quarenta e oito caracteres).

No item "Endereço IP", é necessário especificar o ip sem adicionar a porta de um dispositivo iKKM na rede, depois de configurá-lo com um endereço estático através de um roteador.

“Onde vamos armazenar a chave da API” - o ponto em que colocamos um diretório conveniente para você com um documento de texto de uma chave da API dinâmica para proteger as operações da rede. Sempre que durante uma operação fiscal, a chave será substituída por um valor diferente.

O item "chave da API da WEB" deve conter a chave de segurança atual.

imagem

A chave da API atual pode ser obtida na interface da web do dispositivo entrando em contato com ela após conectar-se à rede por meio do navegador "endereço IP do dispositivo: 8080" .

imagem

Todas as configurações são feitas, agora você pode testar o dispositivo.

imagem

Viva, a instalação do FR foi concluída com êxito!

Finalmente, outro truque

Se durante o uso do dispositivo, você não puder vender um ou outro produto via iKKM (o dispositivo não o interrompe na verificação), verifique as configurações de arredondamento na sua

opção 1C: Correta para 1C: Varejo, 1C: Farmácia

imagem

Para 1C: Restaurante

imagem

Bom para todos caixas registradoras rápidas e convenientes para você!

Como integrei o terminal POS e o FR IKKM-Touch em 1C: empresa