Solução de problemas¶

Conexão da IoT box¶

Não foi possível localizar o código de emparelhamento para conectar a IoT box¶

O código de emparelhamento deve ser impresso em impressoras de recibos conectadas à :abbr:`IoT box ` e também deve ser exibido nos monitores conectados.

O código de emparelhamento não é exibido nas seguintes circunstâncias:

• A IoT box já está conectada a uma base de dados do Odoo.

• A IoT box não está conectada à Internet.

• O código só é válido por 5 minutos após o início da IoT box. Ele é removido automaticamente dos monitores conectados quando esse tempo expira.

• A versão da imagem da IoT box é muito antiga. Se a imagem da IoT box for de uma versão anterior, o cartão SD da IoT box precisará ser atualizado novamente para atualizar a imagem (consulte Fazer flash do cartão SD).

Se nenhum dos casos listados acima corrigir o problema, certifique-se de que a caixa IoT box foi iniciada corretamente, verificando se um LED verde fixo está sendo exibido ao lado da porta de alimentação.

A IoT box está conectada, mas não está sendo exibida na base de dados¶

Quando uma IoT box se conecta a uma base de dados, ela pode ser reiniciada. Nesse caso, pode levar até cinco minutos para aparecer na base de dados. Se a IoT box ainda não estiver sendo exibida após cinco minutos, verifique se a IoT box pode acessar a base de dados e se o servidor não usa um ambiente de várias bases.

Para acessar a base de dados a partir da IoT box, abra um navegador e digite o endereço da base de dados.

A IoT box está conectada à base de dados do Odoo, mas não pode ser acessada¶

Certifique-se de que a IoT box e o computador que está executando o navegador estejam localizados na mesma rede, pois a IoT box não pode ser acessada de fora da rede local.

O certificado HTTPS não é gerado¶

Para gerar um certificado HTTPS, é necessária uma assinatura de IoT box para a IoT box. Conectar a :abbr:`IoT box antes de configurar uma assinatura de IoT box para a base de dados e a caixa IoT box com o Gerente de contas resultará em uma conexão não segura.

Além disso, um firewall também pode impedir que o certificado HTTPS seja gerado corretamente. Nesse caso, desative o firewall até que o certificado seja gerado com êxito. Deve-se observar também que determinados dispositivos, como um roteador que tenha um firewall integrado, podem impedir a geração do certificado HTTPS.

Impressora¶

A impressora não foi detectada¶

Se uma impressora não aparecer na lista de dispositivos, acesse a página inicial da IoT box e verifique se ela está listada em Impressoras.

Se a impressora não estiver presente na página inicial da IoT box, clique em Servidor de impressão, vá para a aba Administração e clique em Adicionar impressora. Se a impressora não estiver presente na lista, é provável que ela não esteja conectada corretamente.

A impressora emite um texto aleatório¶

Para a maioria das impressoras, o driver correto deve ser detectado e selecionado automaticamente. Entretanto, em alguns casos, o mecanismo de detecção automática pode não ser suficiente e, se nenhum driver for encontrado, a impressora poderá imprimir caracteres aleatórios.

A solução é selecionar manualmente o driver correspondente. Na página inicial da IoT box, clique em Servidor de impressão, vá para a aba Impressora e selecione a impressora na lista. No menu suspenso Administração, clique em Modificar impressora. Siga as etapas e selecione a marca e o modelo correspondentes à impressora.

Caso especial de configuração da Epson¶

A maioria das impressoras Epson suporta a impressão de recibos no Odoo PDV usando o comando GS v 0. Entretanto, os seguintes modelos de impressoras Epson não suportam esse comando:

• TM-U220

• TM-U230

• TM-P60

• TMP-P60II

Para contornar esse problema, configure a impressora para usar o comando ESC *.

Processo para forçar o comando ESC *¶

Compatibilidade com impressoras Epson¶

A primeira etapa é verificar se a impressora é incompatível com o comando GS v 0.

Se a impressora não for compatível com o comando ESC *, o processo a seguir não será possível. Se a impressora for compatível com o uso do comando ESC * para imprimir, siga este processo para configurar a impressora com a IoT box.

Configuração da IoT box para ESC *¶

Para configurar a IoT box para usar o comando ESC * para imprimir, acesse a página inicial da IoT box navegando até app Internet das Coisas ‣ IoT Boxes. Em seguida, clique no endereço IP e isso o direcionará para a página inicial da IoT box.

Seleção da impressora

Agora, clique no botão Servidor de impressoras. Isso redirecionará o navegador para a página CUPS. Em seguida, vá para Administração ‣ Impressoras ‣ Adicionar impressora, escolha a impressora que deve ser modificada e clique em Continuar.

Convenção de nomenclatura da CUPS

O CUPS solicitará ao administrador três informações: Nome, Descrição e Local. As duas últimas informações não precisam ser específicas; no entanto, o Nome deve seguir uma convenção específica para funcionar com o comando ESC *.

O Name deve corresponder a esta convenção: <printer_name>__IMC_<param_1>_<param_2>_..._<param_n>__`

Detalhamento da convenção de nomenclatura:

• printer_name: Esse é o nome da impressora. Pode ser qualquer caractere, desde que não contenha _, /, # ou ` ` (caractere de espaço).

• IMC: Significa Image Mode Column (o nome simplificado de ESC *).

• param_1: Isso representa o parâmetro específico:

  • SCALE<X>: Escala da imagem (com a mesma proporção de tela). X deve ser um número inteiro que descreve a porcentagem da escala que deve ser usada.

    Example

    100 é o tamanho original, 50 é a metade do tamanho, 200 é o dobro do tamanho.

  • LDV: Low Density Vertical (será definido como High Density Vertical se não for especificado).

  • LDH: Low Density Horizontal (será definido como High Density Horizontal se não for especificado).

    Nota

    Os parâmetros de densidade podem precisar ser configurados de uma maneira específica, dependendo do modelo da impressora.

Concluir a adição de uma impressora

Depois de definir o nome da impressora com a convenção de nomes adequada, clique em Continuar. Em seguida, defina o valor Make como Raw e, no valor Model, defina-o como Raw Queue (en).

Depois de concluir essas etapas, clique em Adicionar impressora. Se tudo tiver sido feito corretamente, a página deverá ser redirecionada para a página Banners.

Nesse ponto, a impressora deve ter sido criada; agora, a IoT box só precisa detectá-la e sincronizar com o servidor do Odoo (isso pode levar alguns minutos).

Adicionar a impressora ao PDV do Odoo

Quando a impressora estiver visível na base de dados do Odoo, não se esqueça de escolhê-la na configuração do PDV como a impressora IoT. Navegue até app PDV ‣ Definições ‣ Dispositivos conectados ‣ IoT Box ‣ Impressora de recibos ‣ Salvar.

Exemplo de configuração da impressora Epson TM-U220B usando ESC

Click this text to reveal the example

A seguir, um exemplo do processo de solução de problemas para um modelo de impressora TM-U220B usando o comando ESC *. O recibo ilustrado abaixo é um exemplo de recibo que está sendo impresso corretamente devido à formatação adequada (em teoria):

Tentar imprimir esse recibo imediatamente, antes da formatação adequada, não funcionará, pois o modelo de impressora TM-U220B não é compatível com GS v 0. Em vez disso, serão impressos caracteres aleatórios:

Para configurar corretamente a formatação do modelo de impressora Epson TM-U220B, execute as seguintes etapas.

Após consultar o site da Epson para verificar a compatibilidade de ambos os comandos: GS v 0 e ESC *, é possível constatar que, de fato, o TM-U220B não é compatível com o GS v 0, mas é compatível com o ESC *.

Ao adicionar a impressora, o CUPS perguntará qual impressora deve ser adicionada:

Nesse caso, a impressora está conectada via USB, portanto, não fará parte da seção Impressoras encontradas na rede. Em vez disso, ela provavelmente faz parte da seleção Desconhecido em Impressoras locais. Ao desconectar o cabo USB da impressora da IoT Box e atualizar a página, a impressora desconhecida desaparece. Ao conectá-lo novamente, a impressora reaparece, de modo que se pode dizer que essa é a impressora em questão.

Pela convenção de nomenclatura, como o aparelho deve imprimir usando o comando ESC *, é imperativo adicionar __IMC. Consulte o modelo da impressora no site ESC * da Epson <https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=88>`_ para saber mais sobre os parâmetros de densidade.

Para esse modelo específico, TM-U220, m deve ser igual a 0 ou 1. Ao fazer referência à Descrição abaixo da caixa rosa na imagem acima, os valores m podem ser 0, 1, 32 ou 33. Portanto, no caso dessa impressora, o valor m NÃO pode ser 32 ou 33 (caso contrário, serão impressos caracteres aleatórios).

A tabela inclui os valores numéricos: 32 e 33, ambos ocorrem se o número de bits para dados verticais estiver definido como 24. Isso significa que se trata de uma densidade vertical alta. No caso da configuração da Epson TM-U220, será necessário forçar a densidade vertical baixa, pois esse modelo de impressora não suporta densidade vertical alta* para esse comando ESC *.

Para adicionar uma Low Vertical Density (baixa densidade vertical), adicione o parâmetro LDV à convenção de nomenclatura.

Clique em Continuar para prosseguir. Em seguida, defina o valor Make como Raw e, para o valor Model, defina-o como Raw Queue (en).

No entanto, ao tentar imprimir com a convenção de nomes: EpsonTMU220B__IMC_LDV__, o recibo é impresso, mas é muito grande e fica fora da margem. Para resolver isso, adicione uma nova impressora (e convenção de nomes) com o parâmetro SCALE1 para se adaptar ao tamanho do recibo.

Alguns exemplos:

Convenção de nomenclatura de impressoras	EpsonTMU220B__IMC_LDV__	EpsonTMU220B__IMC_LDV_SCALE75__	EpsonTMU220B__IMC_LDV_LDH__	EpsonTMU220B__IMC_LDV_LDH_SCALE35__

Problema de impressão da DYMO LabelWriter¶

A DYMO LabelWriter tem um problema conhecido na impressão com a IoT box. O servidor OpenPrinting CUPS instala a impressora usando os drivers Impressora local RAW. Para imprimir qualquer coisa, o Marca e modelo correto precisa ser definido, de modo que o driver correto seja referenciado ao usar o dispositivo.

Além disso, uma nova impressora precisa ser adicionada para reduzir um atraso de impressão que ocorre após a atualização do driver.

DYMO LabelWriter não está imprimindo¶

Se a DYMO LabelWriter não estiver imprimindo nada, será necessário instalar um novo driver.

Primeiro, abra o console do OpenPrinting CUPS clicando em Servidor de impressoras na parte inferior da página inicial da IoT box. Em seguida, clique em Impressoras no menu superior. Clique na impressora em questão e selecione Manutenção no primeiro menu suspenso. Em seguida, selecione Modificar a impressora no segundo menu suspenso.

Em seguida, selecione a conexão de rede/impressora específica na qual a modificação deve ser feita. Clique em Continuar.

Na próxima página, clique em Continuar para continuar a definir a Marca da impressora.

Em Marca, selecione DYMO no menu. Clique em Continuar para definir o Modelo.

Na página seguinte, defina o Modelo como DYMO LabelWriter 450 DUO Label (en) (ou qualquer modelo de impressora DYMO que esteja sendo usado). Clique em Modificar a impressora para concluir a configuração do novo driver; uma página de confirmação será exibida.

Depois de ser redirecionado para uma página de confirmação, reconhecendo uma atualização bem-sucedida, clique no botão Impressoras no menu superior.

Todas as impressoras instaladas no servidor CUPS do OpenPrinting são exibidas, incluindo a recém-atualizada: DYMO LabelWriter 450 DUO Label (ou qualquer modelo de impressora DYMO que esteja sendo usado). Clique na impressora que acabou de ser atualizada.

Para imprimir uma etiqueta de teste, clique no menu suspenso Manutenção à esquerda do menu suspenso Administração e selecione Imprimir página de teste. A etiqueta de teste será impressa com um atraso de dez segundos se a atualização do driver for bem-sucedida.

Para reduzir esse atraso, será necessário adicionar uma nova impressora. Siga o processo abaixo.

Atraso de impressão da DYMO LabelWriter¶

Para resolver o problema de atraso após a modificação do driver, a impressora deve ser reinstalada. Para reinstalar a impressora, abra a página de administração do OpenPrinting CUPS clicando em Servidor de impressoras, na parte inferior da página inicial da IoT box. Em seguida, clique em Administração no menu superior e, em seguida, clique em Adicionar uma impressora.

Na próxima tela, na seção Impressoras locais, selecione a impressora pré-instalada DYMO LabelWriter 450 DUO Label (DYMO LabelWriter 450 DUO Label) (ou qualquer modelo de impressora DYMO que esteja sendo usado). Clique em Continuar.

Na tela seguinte, modifique o Nome para algo reconhecível, pois a impressora original ainda estará presente. Clique em Continuar para ser levado à próxima tela.

Em seguida, escolha o Modelo. Selecione DYMO LabelWriter 450 DUO Label (en) (ou qualquer modelo de impressora DYMO que esteja sendo usado) e, finalmente, clique em Adicionar impressora para concluir a instalação.

Depois de ser redirecionado para uma página de confirmação, reconhecendo que a instalação foi bem-sucedida, clique no botão Impressoras no menu superior.

Todas as impressoras instaladas no servidor CUPS do OpenPrinting são exibidas, incluindo a recém-instalada: DYMO LabelWriter 450 DUO Label (ou qualquer modelo de impressora DYMO que esteja sendo usado). Clique na impressora que acabou de ser instalada.

Para imprimir uma etiqueta de teste, clique no menu suspenso Manutenção à esquerda do menu suspenso Administração e selecione Imprimir página de teste. A etiqueta de teste deve ser impressa imediatamente (com um ou dois segundos de atraso).

A impressora Zebra não imprime nada¶

As impressoras Zebra são bastante sensíveis ao formato do código Zebra Programming Language (ZPL) que é impresso. Se nada sair da impressora ou se forem impressas etiquetas em branco, tente alterar o formato do relatório enviado para a impressora acessando as Definições ‣ Técnico ‣ Interface do usuário ‣ Visualizações no modo de desenvolvedor e procure o modelo correspondente.

Leitor de código de barras¶

Os caracteres lidos pelo leitor de código de barras não correspondem ao código de barras¶

Por padrão, a maioria dos leitores de código de barras é configurada no formato QWERTY dos EUA. Se o leitor de código de barras usar um layout diferente, vá para a exibição de formulário do dispositivo (app Internet das Coisas ‣ Dispositivos ‣ Dispositivo de código de barras) e selecione o formato correto.

Nada acontece quando um código de barras é escaneado¶

Certifique-se de que o dispositivo correto esteja selecionado na configuração do Ponto de venda e que o código de barras esteja configurado para enviar um caractere ENTER (código 28) no final de cada código de barras. Para fazer isso, navegue até o app PDV ‣ Menu de três pontos no PDV ‣ seção IoT Box ‣ Editar.

O leitor de código de barras é detectado como um teclado¶

O tipo de dispositivo pode ser alterado manualmente acessando sua visualização de formulário (app Internet das Coisas ‣ Dispositivos ‣ Dispositivo de código de barra) e ativando a opção É leitor.

O leitor de código de barras processa os caracteres do código de barras individualmente¶

Ao acessar a versão móvel do Odoo a partir de um celular ou tablet, emparelhado com um leitor de código de barras pela IoT box, o leitor pode processar cada caractere do código de barras como uma leitura individual. Nesse caso, a opção Layout do teclado deve ser preenchida com o idioma apropriado do leitor de código de barras na página do formulário Leitor de código de barras.

O Layout do teclado é baseado no idioma e as opções disponíveis variam, dependendo do dispositivo e do idioma da base de dados. Por exemplo: Inglês (Reino Unido), Inglês (EUA), etc.

Caixa registradora¶

A caixa registradora não abre¶

A caixa registradora deve estar conectada à impressora e a caixa de seleção Caixa registradora deve estar marcada na configuração PDV. Para fazer isso, navegue até app PDV ‣ Menu de três pontos no PDV ‣ seção IoT Box ‣ Editar ‣ Impressora de recibos ‣ Caixa de marcação da caixa registradora.

Balança¶

As balanças desempenham uma função crucial no processo de checkout, especialmente para produtos vendidos por peso em vez de por preço fixo.

Configurar balanças Ariva S¶

A Odoo determinou que uma configuração específica nas balanças da série Ariva S (fabricadas pela Mettler-Toledo, LLC.) precisa ser modificada, e um cabo USB-RJ45 específico da Mettler é necessário para que a balança funcione com a IoT box do Odoo.

Para configurar corretamente a balança para reconhecimento da IoT box, siga este processo de configuração das balanças da série Ariva S.

Cabo¶

O número de peça da Mettler é 72256236 cabo - USB-PDV. Entre em contato com a Mettler ou com um parceiro para adquirir um cabo autêntico. Observe que nenhum outro cabo além deste da Mettler funciona para esta configuração. O uso de um cabo somente serial conectado a um adaptador serial-USB não é eficaz.

Definição¶

Consulte o Guia de Instalação da Mettler para balanças da série Ariva S durante a seguinte configuração: Guia do usuário da balança Ariva Checkout.

Para começar, vá para a página 17 do manual acima para configurar. Este guia lista as possíveis configurações para as balanças da série Ariva S.

Siga as instruções, juntamente com o processo a seguir, para colocar a balança no modo de configuração. Primeiro, mantenha o botão >T< pressionado por oito segundos ou até que apareça CONF.

Em seguida, pressione >T< até que apareça GRP 3 e, em seguida, pressione >0< para confirmar.

Em 3.1, verifique se a configuração está definida como 1 (portas COM virtuais USB). Pressione >T< para percorrer as opções do grupo 3.1.

Quando 3.1 estiver definido como 1, pressione >0< para confirmar a seleção. Continue a pressionar >0< até que apareça GRP 4.

Agora, pressione >T< até que apareça EXIT.

Quando aparecer EXIT, pressione >0<. Em seguida, pressione >0< novamente para SALVAR. A balança será reiniciada.

Por fim, reinicie a IoT box para reconhecer as alterações feitas na configuração da balança. Após a reinicialização, a balança aparece como Toledo 8217, enquanto antes aparecia como Adam Equipment Serial.