OdooWiki OCA HUB

Barcode GS1 Stock

barcode_gs1_stock folder_open OCA/barcode-interface open_in_new
Inventory/Logistics Licencia: AGPL-3

Este módulo es el puente entre los códigos de barras GS1 y la aplicación de almacén: hace que la medida que lleva una etiqueta GS1 sea la cantidad recogida, expresada en la unidad en la que se almacena el producto.

Una etiqueta GS1 a menudo indica ambas cosas, y no coinciden: una caja de embutido lleva "2 pieces" (AI 30) y "2.497 kg" (AI 310n). Cuál de las dos es la cantidad depende de cómo se almacene el producto, algo que solo el almacén sabe: los kilogramos la convierten en el peso, las unidades la convierten en el recuento.

Se instala automáticamente en cuanto barcode_gs1 y barcode_stock están instalados, y ninguno de los dos lo necesita sin él.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Cuando una etiqueta de código de barras GS1 indica tanto un recuento de piezas como un peso o volumen, este módulo hace que la medida sea la cantidad recogida si el producto se almacena en ese tipo de unidad, de modo que el almacén registra la cantidad correcta.

Este módulo funciona dentro de la pantalla de escaneo de la aplicación Barcode. No añade menús ni pantallas nuevas; cambia cómo se convierte una etiqueta GS1 escaneada en una cantidad.

Una etiqueta GS1 puede llevar varias medidas a la vez: un recuento de piezas (AI 30 o 37) y un peso neto o volumen (por ejemplo 2.497 kg). El módulo compara cada medida de la etiqueta con la unidad en la que se almacena el producto. Si el producto se almacena en kilogramos, el peso se convierte en la cantidad; si se cuenta en unidades, se mantiene el recuento de piezas. Un peso nunca se convierte en un número de unidades.

  • Las medidas que describen el propio paquete (peso bruto, dimensiones, volumen de la unidad logística, AI 330n a 349n) se ignoran.
  • La medida elegida se convierte a la unidad de almacenamiento del producto y se redondea tal como Odoo la va a guardar, de modo que la pantalla muestra la cantidad que realmente se guardará.
  • Si la medida se redondea a cero, el escaneo se trata como si no tuviera medida y se aplica la lectura normal.
  • Para un código de barras de embalaje, la medida precisa sustituye a la cantidad nominal del paquete cuando coincide con la unidad del producto.

La lista de unidades de medida se carga una vez cuando se inicia la aplicación Barcode. Si esa carga falla, se reintenta en segundo plano en el siguiente escaneo que lleve una medida, y ese escaneo mantiene la lectura básica.

Se instala automáticamente una vez que están presentes tanto el módulo GS1 barcode como el módulo barcode stock, y solo afecta a la lógica de escaneo.

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.

Fuentes · Odoo 18.0

Confirmado el 2026-11-03 en la rama 18.0 de OCA/barcode-interface.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

No hay nada que configurar para el propio módulo. No obstante, la precisión con la que se conserva una medida es la de Odoo, y sus valores por defecto son más gruesos que los de la mayoría de las etiquetas GS1.

Una medida se convierte en una cantidad redondeada dos veces, como en cualquier parte de stock: a la Precisión de redondeo de la unidad del producto, y a los decimales de la precisión de la Unidad de medida del producto. Ambas tienen por defecto dos decimales, así que los 2.497 kg que indica una etiqueta se almacenan como 2.50 kg, y la aplicación muestra 2.50 para que la cantidad en pantalla sea la que se almacenará.

Para conservar los gramos que indica una etiqueta, en productos almacenados en kilogramos:

  • establezca la Precisión de redondeo de kg en 0.001, en Inventario → Configuración → Unidades de medida → Categorías de UdM → Peso (la opción Unidades de medida debe estar habilitada en los ajustes de Inventario);
  • establezca los dígitos de la precisión de la Unidad de medida del producto en 3, en Ajustes → Técnico → Estructura de la base de datos → Precisión decimal (modo desarrollador).

La precisión se aplica a todas las cantidades de la base de datos, no solo a los escaneos.

Instalar barcode_gs1 junto a barcode_stock incorpora este módulo, y todas las pantallas que aplican una cantidad escaneada lo utilizan.

Cuando un código de barras GS1 escaneado lleva una medida, la unidad en la que está esa medida proviene de la regla que lo leyó (Unit of Measure en la regla del código de barras — AI 310n son kilogramos, 320n libras, 311n metros). Después se compara con la unidad en la que se almacena el producto:

  • del mismo tipo de unidad — la medida es la cantidad, convertida a la unidad propia del producto: 2.497 kg en la etiqueta son 2497 para un producto en gramos;
  • de un tipo diferente — un peso para un producto contado en unidades, por ejemplo — la medida no dice nada sobre cuántas unidades tomar, así que el recuento de piezas de la etiqueta (AI 30/37) es la cantidad, y una sola unidad cuando la etiqueta no indica ninguna.

Cuando una etiqueta indica varias medidas (un peso neto y un volumen neto, por ejemplo), se toma la primera que esté en el tipo de unidad del producto. El peso bruto y las demás medidas del propio envase (AI 330n–349n) nunca se toman.

La cantidad se redondea tal como se va a almacenar, de modo que lo que muestra la pantalla es lo que acaba en el inventario. Con los valores predeterminados de Odoo son dos decimales: 2.497 kg son 2.50 para un producto en kilogramos (véase Configuration para conservar los gramos). Una medida que se redondea a nada (4 g, para un producto en kilogramos con dos decimales) no se toma: el escaneo se lee como uno sin medida.

Cuando el GTIN es un código de barras de embalaje (un cartón de doce, por ejemplo), una etiqueta sin recuento toma la cantidad del paquete, y un recuento en la etiqueta prevalece sobre ella. Una medida en el tipo de unidad propio del producto prevalece sobre ambas: un cartón de queso que pesa 4.32 kg son 4.32 para un producto almacenado en kilogramos, no doce.

Las unidades de medida se leen cuando se abre la aplicación. Si eso falla, se vuelven a leer en el siguiente escaneo que lleve una medida; ese escaneo se lee como si no llevara ninguna.

Sin este módulo los códigos de barras GS1 se siguen analizando, pero una medida nunca es la cantidad: la aplicación de almacén toma el recuento de piezas, o una sola unidad (la cantidad del paquete para un código de barras de embalaje).

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.