Solución de problemas

Conexión de la caja IoT

No es posible localizar el código de emparejamiento para conectar la caja IoT

El código de emparejamiento debe estar impreso en la impresora de recibos conectada a la caja IoT y debe aparecer en los monitores conectados.

El código de emparejamiento no aparece en los siguientes casos:

  • La caja IoT ya está conectada a una base de datos de Odoo.

  • La caja IoT no está conectada a internet.

  • El código solo es válido durante los primeros 5 minutos después de encender la caja IoT. Una vez pasado este tiempo, se elimina en automático de las pantallas conectadas.

  • The version of the IoT box image is too old. If the IoT box image is from an earlier version, then the SD card of the IoT box needs to be re-flashed to update the image (see Flashing the SD Card).

If none of the cases listed above correct the issue, then make sure the IoT box has correctly started, by checking that a fixed green LED is showing next to the power port.

La caja IoT está conectada pero no aparece en la base de datos

Es posible que una caja IoT se reinicie cuando se conecta a una base de datos. En este caso, puede tardar hasta cinco minutos antes de aparecer en la base de datos. Si la caja IoT no aparece después de cinco minutos, asegúrese de que tiene alcance a la base de datos y que el servidor no utiliza un entorno de varias bases de datos.

Para acceder a la base de datos desde la caja IoT, abra su navegador y escriba la dirección de la base de datos.

La caja IoT está conectada a la base de datos de Odoo pero no puede localizarla

Asegúrese de que la caja IoT y la computadora que ejecuta el navegador se encuentran conectadas a la misma red, ya que la caja IoT no podrá localizarla fuera de la red local.

No se genera el certificado HTTPS

Para generar un certificado HTTPS, es necesaria una suscripción a la caja IoT para la caja IoT. Si conecta la caja IoT antes de configurar una suscripción de IoT para la base de datos y la caja IoT, entonces el resultado será una conexión no segura.

Además, un firewall también puede evitar que el certificado HTTPS se genere de forma adecuada. En este caso, desactive el firewall hasta que se genere el certificado. Considere que ciertos dispositivos, como un enrutador con un firewall incorporado, pueden impedir que se genere un certificado HTTPS.

Impresora

No se detecta la impresora

Si una impresora no aparece en su lista de dispositivos, vaya a la página de inicio de la caja IoT y asegúrese de que aparece en Impresoras.

La página de inicio de la caja IoT.

Si la impresora no aparece en la página de inicio de la caja IoT, haga clic en Servidor de impresoras, vaya a la pestaña Administración y haga clic en Agregar impresora. Es probable que la impresora no esté conectada correctamente si no aparece en la lista.

La impresora imprime texto aleatorio

Para la mayoría de las impresoras, el controlador correcto se detecta y selecciona de forma automática. Sin embargo, en algunos casos, es posible que el mecanismo de detección automática no sea suficiente, y si no encuentra ningún controlador, la impresora podría imprimir caracteres aleatorios.

La solución es seleccionar el controlador correspondiente de forma manual. Haga clic en Servidor de impresoras en la página de inicio de la caja IoT, vaya a la pestaña Impresoras y seleccione la impresora en la lista. En el menú desplegable Administración haga clic en Modificar impresora. Siga los pasos y seleccione la marca y el modelo que correspondan a la impresora.

Editar la impresora conectada a la caja IoT.

Nota

Las impresoras de recibos Epson y Star y las impresoras de etiquetas Zebra no necesitan un controlador para funcionar. Asegúrese de que no se seleccionó ningún controlador para esas impresoras.

Caso especial de uso de Epson

La mayoría de las impresoras Epson pueden imprimir recibos desde el Punto de venta de Odoo con el comando GS v 0. Sin embargo, los siguientes modelos de impresoras Epson no son compatibles con el comando;

  • TM-U220

  • TM-U230

  • TM-P60

  • TMP-P60II

Para solucionar este problema, configure la impresora para que use el comando ESC * para esto mejor.

Proceso para forzar el comando ESC*
Compatibilidad de la impresora Epson

El primer paso es revisar si una impresora no es compatible con el comando GS v 0

Ver también

Si la impresora no es compatible con el comando ESC * entonces no será posible realizar el siguiente proceso. Si la impresora es compatible con el uso del comando ESC * para imprimir, siga este proceso para configurar la impresora con la caja IoT.

configuración de la caja IoT para ESC*

Para configurar el uso del comando ESC * para imprimir en la caja IoT vaya a la página de inicio de la caja IoT desde la aplicación IoT ‣ cajas IoT. Después haga clic en la dirección IP, así se le redirigirá a la página de inicio de la caja IoT.

Al elegir la impresora

Ahora haga clic en el botón Printers server (servidores de impresoras). Esto lo redirigirá a la página de CUPS. Después, vaya a Administración ‣ Impresoras ‣ Agregar una impresora, elija la impresora que se tiene que modificar y haga clic en Continuar.

Truco

Si todavía no está seguro de cuál es el nombre de la impresora, siga los siguientes pasos:

  1. Fíjese qué impresoras están enlistadas en la página CUPS.

  2. Apague la impresora y vuelva a cargar la página.

  3. Ahora compare las listas para encontrar qué impresora desapareció.

  4. Vuelva a prender la impresora y recargue la página.

  5. Verifique de nuevo la lista para ver si la impresora vuelve a aparecer.

  6. La impresora que desapareció y volvió a aparecer en la lista de impresoras es el nombre de la impresora correspondiente.

Nota

Puede aparecer como Desconocido en :guilabel: Impresoras locales.

Convención de nomenclatura CUPS

El comando CUPS le solicitará tres datos al administrador: Nombre, Descripción y Ubicación. No es necesario que los dos últimos datos sean específicos, sin embargo, el nombre debe contar con una nomenclatura específica para que funcione con el comando ESC *.

El Nombre debe seguir este formato: <printer_name>__IMC_<param_1>_<param_2>_..._<param_n>__.

Desglose de la convención de nomenclatura:

  • printer_name: es el nombre de la impresora. Puede incluir cualquier carácter siempre que no sea _, /, #, o ` ` (espacio).

  • IMC: Son las siglas de Image Mode Column (el nombre simplificado de ESC*).

  • param_1: representa el parámetro específico:

    • SCALE<X>: escala de la imagen (con la misma relación de aspecto). X debe ser un número entero que describa el porcentaje de escala que se debe utilizar.

      Example

      100 es el tamaño original, 50 es la mitad del tamaño y 200 es el doble del tamaño.

    • LDV: Low Density Vertical (densidad vertical baja), se establecerá en High Density Vertical (densidad vertical alta) si no se especifica.

    • LDH: Low Density Horizontal (densidad horizontal baja), se establecerá en High Density Horizontal (densidad horizontal alta) si no se especifica.

      Nota

      Es posible que los parámetros de densidad se deban configurar de una manera específica según el modelo de impresora.

Ver también

Visite la documentación ESC * de Epson y haga clic en el modelo de impresora de la tabla superior para averiguar el tipo de configuración que debe tener.

Example

Los siguientes son ejemplos de nombres con formato correcto e incorrecto:

Formato correcto:

  • EPSONTMm30II__IMC__

  • EPSON_TM_U220__IMC_LDV_LDH_SCALE80__

Formato incorrecto (no impedirá la impresión, pero el resultado podría no ser el esperado):

  • EPSON TMm 30II -> El nombre no debe incluir espacios.

  • EPSONTMm30II -> El nombre es correcto, pero no hace uso de ESC *.

  • EPSONTMm30II__IMC -> El nombre no incluye __ al final.

  • EPSONTMm30II__IMC_XDV__ -> El parámetro XDV no coincide con ningún parámetro existente.

  • EPSONTMm30II_IMC_SCALE_ -> El parámetro SCALE no incluye el valor con la escala.

Terminar de agregar una impresora

Después de asignar un nombre a la impresora con la convención de nomenclatura adecuada, haga clic en Continuar. A continuación, en el valor Crear seleccione Sin procesar y para el valor Modelo seleccione Cola sin procesar (en).

Tras completar estos pasos, haga clic en Agregar impresora. Si no ocurrió ningún error, se le redirigirá a la página de banners.

En este punto la impresora debería haber sido creada, ahora la caja IoT solo necesita detectarla y luego sincronizarla con el servidor de Odoo (esto podría tardar unos minutos).

Agregar la impresora al PdV de Odoo

Una vez que la impresora aparezca en la base de datos de Odoo, deberá elegirla en la configuración del PdV como la impresora IoT. Vaya a Punto de venta ‣ Ajustes ‣ Dispositivos conectados ‣ Caja IoT ‣ Impresora de recibos ‣ Guardar.

Nota

Si la impresora se configuró de forma incorrecta (todavía imprime texto aleatorio o el recibo impreso es demasiado grande o pequeño), no se puede modificar mediante el nombre de la impresora con CUPS. Puede repetir el proceso anterior para configurar otra impresora desde cero y crear una con los parámetros modificados.

Ejemplo de configuración de la impresora Epson TM-U220B con ESC

El siguiente es un ejemplo del proceso de solución de problemas para el modelo TM-U220B con el comando ESC *. El recibo que aparece a continuación ejemplifica un recibo que se imprime correctamente debido al formato adecuado (en teoría):

Imagen de un recibo con un formato correcto impreso desde una base de datos de demostración.

Si intenta imprimir este recibo antes de configurar el formato adecuado, imprimirá caracteres aleatorios, ya que el modelo TM-U220B no es compatible con GS v 0.

Papel de impresora con caracteres aparentemente aleatorios.

Para configurar correctamente el formato para el modelo TM-U220B de la impresora Epson, debe seguir los siguientes pasos.

Luego de consultar el sitio web de Epson para verificar la compatibilidad de los comandos GS v 0 y ESC *, puede observar que el modelo TM-U220B no es compatible con GS v 0, pero sí con ESC *.

Evaluación de compatibilidad de Epson en su sitio web.

Al agregar la impresora, CUPS preguntará qué impresora se debe agregar:

Selección para agregar impresora en el menú de administración.

En este caso, la impresora está conectada por USB así que no aparecerá en las impresoras descubiertas en la red. En su lugar, es probable que aparezca en la selección desconocida en impresoras locales. Al desconectar el cable USB de la impresora de la caja IoT y actualizar la página, la impresora desconocida desaparece. Al conectarla de nuevo, vuelve a aparecer, por lo que se puede decir que esta es la impresora en cuestión.

Es necesario agregar __IMC a la nomenclatura del nombre, pues necesitará imprimir con el comando ESC *. Busque el modelo de la impresora en el sitio web de Epson ESC * para obtener más información acerca de los parámetros de densidad.

Especificaciones de la impresora Epson TM-U220 en el sitio web del fabricante.

Para el modelo particular TM-U220, el valor de m debe ser igual a 0 o 1. Al referenciar la caja rosa de Descripción en la imagen anterior, los valores de m pueden ser 0, 1, 32 o 33. En el caso de esta impresora, el valor de m NO pueden ser 32 o 33 (de lo contrario se imprimirán caracteres al azar).

La tabla incluye los siguientes valores numéricos: 32 y 33, los cuáles ocurren si el Número de bits para datos verticales está establecido en 24. Esto significa que es una Alta densidad vertical. En caso de configurar la Epson TM-U220, deberá forzar la Baja densidad vertical, pues el modelo de la impresora no es compatible con una Alta densidad vertical para el comando ESC *.

Para agregar una Baja densidad vertical, agregue el parámetro LDV a la nomenclatura del nombre.

Agregue una *Baja densidad vertical*  (el parámetro `LDV`) a la nomenclatura del nombre.

Haga clic en Continuar para proceder. Luego, establezca el valor Hacer a Raw y para el modelo Modelo establézcalo en Raw Queue (en).

Especificaciones para Epson TM-U220 en el sitio web de los fabricantes.

Sin embargo, al intentar imprimir con la nomenclatura del nombre EpsonTMU220B__IMC_LDV__ se imprimirá el recibo, pero será muy grande y se saldrá del margen. Para solucionar esto, agregue una nueva impresora (y la nomenclatura del nombre) con el parámetro `SCALE<X> ` para adaptar el tamaño del recibo.

Estos son algunos de los ejemplos:

Convención sobre el nombre de impresoras

EpsonTMU220B__IMC_LDV__

EpsonTMU220B__IMC_LDV_SCALE75__

EpsonTMU220B__IMC_LDV_LDH__

EpsonTMU220B__IMC_LDV_LDH_SCALE35__

Formato de un recibo de ejemplo. Formato del recibo usando la convención: EpsonTMU220B__IMC_LDV__. Formato de un recibo usando la convención de nombre: EpsonTMU220B__IMC_LDV_SCALE75__. Formato del recibo usando la convención de nombre: EpsonTMU220B__IMC_LDV_LDH__. Formato del recibo usando la convención de nombre: EpsonTMU220B__IMC_LDV_LDH_SCALE35__.

DYMO LabelWriter print issue

The DYMO LabelWriter has a known issue in printing with the IoT box. The OpenPrinting CUPS server installs the printer using Local RAW Printer drivers. In order to print anything, the correct Make and Model needs to be set, so the correct driver is referenced when using the device.

Additionally, a new printer needs to be added to reduce a print delay that occurs after updating the driver.

Importante

The DYMO LabelWriter 450 DUO printer is the recommended DYMO printer for use with Odoo and the IoT box. It must already be connected to, and recognized on, the IoT box.

The DYMO LabelWriter 450 DUO printer contains two printers in one: a label printer and a tape printer. Choosing the correct model (either DYMO LabelWriter 450 DUO Label (en) or DYMO LabelWriter 450 DUO Tape (en)) is crucial when configuring the following processes.

To keep things consistent, both of the following processes detail the configuration for the DYMO LabelWriter 450 DUO Label (en) model. Change the model when needed.

DYMO LabelWriter not printing

In the case where the DYMO LabelWriter is not printing anything, a new driver needs to be installed.

First, open the OpenPrinting CUPS console by clicking Printers server at the bottom of the IoT box homepage. Next, click on Printers in the top menu. Click into the printer in question, and select Maintenance in the first drop-down menu. Then, select Modify Printer in the second drop-down menu.

Modify the make and model of the DYMO LabelWriter. Maintenance and Modify drop-down menus highlighted.

Next, select the specific network connection/printer that the modification should be made on. Click Continue.

Printer selection screen with Continue highlighted.

On the next page, click Continue to proceed to set the Make of the printer.

Printer modification screen with Continue highlighted.

Under Make select DYMO from the menu. Click on Continue to set the Model.

Setting the make page, with DYMO and continue highlighted.

On the following page, set the Model to DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used). Click on Modify Printer to complete setting the new driver, a confirmation page will appear.

Setting the printer model page with DYMO LabelWriter 450 DUO Label (en) highlighted.

After being redirected to a confirmation page, acknowledging a successful update, click on the Printers button in the top menu.

All the printers installed on the OpenPrinting CUPS server appear, including the newly updated: DYMO LabelWriter 450 DUO Label (or whichever DYMO printer model is being used). Click into the printer that was just updated.

To print a test label, click on the Maintenance drop-down menu to the left of the Administration drop-down menu, and select Print Test Page. The test label will print out with a ten-second delay if the driver update was successful.

Printing a test page from the administration drop-down menu in the OpenPrinting CUPs server.

To reduce this delay a new printer will need to be added, follow the process below.

DYMO LabelWriter print delay

To resolve the delay issue after modifying the driver, the printer must be reinstalled. To reinstall the printer, open the OpenPrinting CUPS administration page by clicking Printers server, at the bottom of the IoT box homepage. Then, click on Administration in the top menu, then click Add a Printer.

Truco

If the DYMO LabelWriter 450 DUO printer is not printing at all, or is not recognizable (has a RAW driver type), then update the drivers on the device. See DYMO LabelWriter not printing.

Add a printer button highlighted on the Printer CUPS management page.

On the next screen, in the Local Printers section, select the DYMO LabelWriter 450 DUO Label (DYMO LabelWriter 450 DUO Label) (or whichever DYMO printer model is being used) pre-installed printer. Click Continue.

Add a printer screen on OpenPrinting CUPS with DYMO LabelWriter 450 DUO Label highlighted.

On the following screen, modify the Name to something recognizable, as the original printer will still be present. Click Continue to be taken to the next screen.

Rename printer page in the 'Add a Printer' flow, with the name field highlighted.

Next, choose the Model. Select DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used), and finally, click Add Printer to complete the installation.

Choose model screen on the OpenPrinting CUPS console with model and add a printer highlighted.

After being redirected to a confirmation page, acknowledging a successful installation, click on the Printers button in the top menu.

All the printers installed on the OpenPrinting CUPS server appear, including the newly installed: DYMO LabelWriter 450 DUO Label (or whichever DYMO printer model is being used). Click into the printer that was just installed.

Printer page with newly installed printer highlighted.

To print a test label, click on the Maintenance drop-down menu to the left of the Administration drop-down menu, and select Print Test Page. The test label should print out immediately (one-to-two seconds delay).

Printing a test page from the administration drop-down menu in the OpenPrinting CUPs server.

La impresora Zebra no imprime nada

Las impresoras Zebra son muy sensibles al formato del código de Zebra Programming Language (ZPL) que se imprime. Si no sale nada de la impresora o se imprimen etiquetas en blanco, intente cambiar el formato del reporte que se envía a la impresora, vaya a Ajustes ‣ Técnico ‣ Interfaz de usuario ‣ Vistas en el modo de desarrollador y busque la plantilla correspondiente.

Ver también

Consulte las instrucciones de Zebra sobre la impresión de archivos ZPL aquí.

Lector de código de barras

El lector de códigos de barras lee caracteres que no coinciden con el código de barras

De forma predeterminada, la mayoría de los lectores de códigos de barras están configurados en el formato QWERTY de Estados Unidos. Si el lector de códigos de barras utiliza una distribución distinta, vaya a la vista de formulario del dispositivo (aplicación IoT ‣ Dispositivos ‣ Dispositivo de código de barras) y seleccione el formato correcto.

No ocurre nada al escanear un código de barras

Asegúrese de que seleccionó el dispositivo correcto en la configuración del Punto de venta y que el código de barras está configurado para enviar un carácter ENTER (código 28) al final de cada código de barras. Para ello, vaya a la aplicación Punto de venta ‣ Menú de tres puntos en el PdV ‣ Sección caja IoT ‣ Editar.

El lector de códigos de barras se detecta como un teclado

Importante

Algunos lectores de código de barras no se anuncian como lectores de código de barras, sino como teclados USB. La caja IoT no los reconocerá.

El tipo de dispositivo se puede cambiar manualmente desde su vista de formulario (aplicación IoT ‣ Dispositivos‣ Dispositivo de código de barras), luego deberá activar la opción ¿Es un escáner?.

Modificar la vista de formulario del lector de códigos de barras.

El lector de código de barras procesa los caracteres del código de barras de forma individual

Al acceder a Odoo desde un dispositivo móvil o una tableta, enlazado con un lector de códigos de barras mediante la caja IoT es posible que el lector procese cada carácter del código de barras de forma individual. En este caso debe seleccionar el idioma apropiado del escáner de códigos de barras en la opción Distribución del teclado de la página del formulario del escáner de códigos de barras.

Truco

Vaya a IoT ‣ Dispositivos ‣ Lector de códigos de barras para acceder a la página del formulario correspondiente.

La página del formulario de lector de códigos de barras. La opción "Distribución del teclado" aparece dentro de un rectángulo rojo.

La distribución del teclado toma como referencia el idioma y las opciones disponibles varían según el dispositivo y el idioma de la base de datos. Por ejemplo: Inglés (RU), Inglés (EE. UU.), etc.

Caja registradora

La caja registradora no abre

La caja registradora debe estar conectada a la impresora y la casilla de verificación Caja registradora debe estar seleccionada en la configuración del PdV. Para hacerlo, vaya a la aplicación Punto de venta ‣ menú con tres puntos en el PdV ‣ sección Caja IoT ‣ Editar ‣ Impresora de recibos ‣ casilla Caja registradora.

Báscula

Las básculas son muy importantes para el proceso de pago, sobre todo para los productos que se venden por peso y no por precio fijo.

Configuración de las básculas Ariva S

Odoo ha determinado que las básculas Ariva (fabricadas por Mettler-Toledo, LLC.) de la serie S necesitan modificaciones en ajustes específicos y que también necesitan un cable Mettler USB a RJ45 específico para que las básculas funcionen con nuestra caja IoT.

Para configurar la báscula Ariva de la serie S de forma correcta y que la caja IoT la reconozca deberá seguir este proceso de configuración.

Importante

Es fundamental que use el cable oficial USB a RJ45 de Mettler durante este proceso.

Cable

El número de pieza de Mettler es 72256236 - cable USB a PdV (o POS). Contacte a Mettler o a un distribuidor autorizado para adquirir un cable auténtico. Tome en cuenta que ningún otro cable funciona para esta configuración, solo el de Mettler. Si decide usar algún otro cable conectado a un adaptador serial a USB, considere que entonces no funcionará.

Cable USB a PdV auténtico de Mettler, número de pieza 72256236.

Configurar

Consulte la guía de configuración de Mettler para básculas Ariva de la serie S para realizar los siguientes pasos: Guía del usuario de la báscula de cobro de Ariva.

Vaya a la página 17 del manual anterior, en la sección Configuración. Esta guía incluye las posibilidades de configuración para las básculas Ariva de la serie S.

Siga las instrucciones, junto con el siguiente proceso, para configurar la báscula en modo de configuración. Primero, mantenga presionado el botón >T< durante ocho segundos o hasta que aparezca CONF .

Después presione >T< hasta que aparezca GRP 3 y luego presione >0< para confirmar.

En 3.1, asegúrese de que el ajuste corresponda a 1 (Puertos COM virtuales USB). Presione >T< para avanzar entre las opciones del grupo 3.1.

Una vez que 3.1 sea 1, presione >0<**para confirmar su selección y después presione **>0< hasta que aparezca GRP 4.

Ahora presione >T< hasta que aparezca EXIT.

Importante

No haga ningún otro cambio a menos que sea necesario.

Después de que aparezca EXIT, presione >0< y luego vuelva a presionar >0< para SAVE (Guardar). La báscula se reiniciará.

Por último, reinicie la caja IoT para que reconozca las modificaciones en la configuración de la báscula. La báscula aparecerá como Toledo 8217 después de que se reinicie, en lugar del nombre anterior que era Adam Equipment Serial.