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.

A página de destino da página inicial da IoT box.

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.

Edite a impressora conectada à IoT box.

Nota

Epson receipt printers and Zebra label printers do not need a driver to work. Make sure that no driver is selected for those printers.

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.

Veja também

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.

Dica

Caso não tenha certeza do nome da impressora, execute as seguintes etapas:

  1. Observe as impressoras listadas na página CUPS.

  2. Desligue a impressora e atualize a página.

  3. Agora, compare a diferença com a primeira lista para ver qual impressora desapareceu.

  4. Ligue novamente a impressora e atualize a página.

  5. Verifique novamente a lista para ver se a impressora reaparece.

  6. A impressora que desapareceu e reapareceu novamente nas impressoras listadas é o nome da impressora em questão.

Nota

É possível que seja Desconhecido em Impressoras locais.

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.

Veja também

Visite a Documentação ESC * da Epson e clique no modelo da impressora na tabela acima para ver se a impressora precisa ter esses parâmetros definidos.

Example

A seguir, exemplos de formatação correta e incorreta de nome:

Formatação correta do nome:

  • EPSONTMm30II__IMC__

  • EPSON_TM_U220__IMC_LDV_LDH_SCALE80__

Formatação incorreta do nome (isso não impedirá a impressão, mas o resultado pode não ser o esperado):

  • EPSON TMm 30II -> O nome não pode ter espaços.

  • EPSONTMm30II -> O nome em si está correto, mas ele não usará ESC *.

  • EPSONTMm30II__IMC -> Esse nome não tem o final __.

  • EPSONTMm30II__IMC_XDV__ -> O parâmetro XDV não corresponde a nenhum parâmetro existente.

  • EPSONTMm30II__IMC_SCALE__ -> O parâmetro SCALE está sem o valor da escala.

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.

Nota

Se a impressora estiver configurada incorretamente (continuar imprimindo texto aleatório ou o recibo impresso for muito grande/pequeno), ela não poderá ser modificada por meio do nome da impressora com CUPS. Em vez disso, o processo acima pode ser repetido para configurar outra impressora do zero e criar uma com parâmetros modificados.

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

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):

Imagem de recibo devidamente formatada de uma base de dados de demonstração.

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:

Papel de impressora com caracteres aparentemente 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 *.

Avaliação de compatibilidade da Epson no site da Epson.

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

Menu de administração, adicionar seleção de impressora.

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.

Especificações da Epson TM-U220 no site do fabricante.

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.

Adicione uma *Low Vertical Density* (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).

Especificações da Epson TM-U220 no site do fabricante.

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__

Exemplo de formato de recibo. Formato do recibo usando a convenção de nomenclatura: EpsonTMU220B__IMC_LDV__. Formato do recibo usando a convenção de nomes: EpsonTMU220B__IMC_LDV_SCALE75__. Formato do recibo usando a convenção de nomes: EpsonTMU220B__IMC_LDV_LDH__. Formato do recibo usando a convenção de nomes: 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.

Importante

A impressora DYMO LabelWriter 450 DUO é a impressora DYMO recomendada para uso com o Odoo e a IoT box. Ela deve já estar conectada à IoT box e ser reconhecida por ela.

A impressora DYMO LabelWriter 450 DUO contém duas impressoras em uma: uma impressora de etiquetas e uma impressora de fitas. A escolha do modelo correto (DYMO LabelWriter 450 DUO Label (en) ou DYMO LabelWriter 450 DUO Tape (en)) é crucial ao configurar os seguintes processos.

Para manter a consistência, os dois processos a seguir detalham a configuração do modelo DYMO LabelWriter 450 DUO Label (en). Altere o modelo quando necessário.

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.

Modifique a marca e o modelo da DYMO LabelWriter. Menus suspensos Manutenção e Modificar destacados.

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

Tela de seleção de impressora com Continuar destacado.

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

Tela de modificação da impressora com Continuar destacado.

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

Configuração da página de criação, com DYMO e continuar destacados.

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.

Configuração da página do modelo da impressora com a DYMO LabelWriter 450 DUO Label (en) destacada.

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.

Impressão de uma página de teste no menu suspenso de administração do servidor OpenPrinting CUPs.

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.

Dica

Se a impressora DYMO LabelWriter 450 DUO não estiver imprimindo ou não for reconhecida (tiver um tipo de driver RAW), atualize os drivers do dispositivo. Consulte DYMO LabelWriter não está imprimindo.

Botão "Adicionar uma impressora" destacado na página de gerenciamento da impressora CUPS.

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.

Adicionar uma tela de impressora no OpenPrinting CUPS com DYMO LabelWriter 450 DUO Label destacada.

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.

Página "Renomear impressora" no fluxo "Adicionar uma impressora", com o campo de nome destacado.

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.

Escolha a tela do modelo no console do OpenPrinting CUPS com o modelo e adicione uma impressora destacada.

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.

Página da impressora com a impressora recém-instalada em destaque.

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).

Impressão de uma página de teste no menu suspenso de administração do servidor OpenPrinting CUPs.

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

Importante

Alguns leitores de código de barras não se anunciam como leitores de código de barras, mas como um teclado USB, e não serão reconhecidos pela IoT box.

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.

Modificação da visualização do formulário do leitor de código de barras.

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.

Dica

Acesse a página do formulário do leitor de código de barras navegando até app IoT ‣ Dispositivos ‣ Leitor de código de barras.

Página de formulário do leitor de código de barras, com a opção de layout de teclado destacada.

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.

Importante

É fundamental usar o cabo USB-RJ45 oficial da Mettler durante esse processo.

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.

Cabo USB-PDV autêntico da Mettler, número de peça 72256236.

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.

Importante

Não faça nenhuma outra alteração, a menos que seja necessário.

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.