Barcode GS1

No se necesita configuración: una vez instalado, los códigos de barras GS1 se analizan allí donde la aplicación lee un escaneo. Se pueden ajustar dos cosas.

Identificadores de aplicación

Los identificadores de aplicación se leen de un GS1 barcode.nomenclature: el establecido en la compañía cuando es una nomenclatura GS1; de lo contrario, la primera nomenclatura GS1 encontrada (la Default GS1 Nomenclature que Odoo incluye). Sus reglas GS1-128 se obtienen una vez, cuando se abre la aplicación de código de barras.

Para enseñar al escáner un nuevo identificador de aplicación, añade una regla en Inventario → Configuración → Nomenclaturas de códigos de barras — sin cambios de código. Una regla cuyo Type sea uno de los que la aplicación entiende (product, lot, quantity, weighted product, priced product, package, package type, expiration date, best before date, pack date, location, destination location) se asigna al campo correspondiente del escaneo analizado (véase Uso); el valor de cualquier otra regla sigue estando disponible en ais.

Los identificadores que la nomenclatura no define siguen funcionando mediante los integrados en el módulo, y si la nomenclatura no se puede leer en absoluto, el módulo recurre a ellos por completo.

Escáneres que no pueden enviar FNC1

GS1 termina un valor de longitud variable con FNC1 a menos que sea el último elemento del código de barras, y un escáner de cuña de teclado a menudo no envía nada en su lugar. Odoo tiene un campo precisamente para eso — FNC1 Separator en la nomenclatura —, así que configura el escáner para que envíe uno de esos caracteres (# de fábrica) y el escaneo se leerá tal como está impreso.

Instala barcode_gs1 junto con barcode_scanner (y un módulo de funcionalidad como barcode_stock). Una vez instalado, los códigos de barras GS1 se analizan automáticamente allí donde la aplicación lee un escaneo.

Un código de barras GS1 escaneado produce un objeto analizado como este:

{ type: "gs1", value: "", // GTIN (AI 01), en la forma en que los productos almacenan gtin: "", // el GTIN exactamente tal como se escaneó (14 dígitos) productCodes: [...], // todas las formas en que el GTIN puede estar almacenado lot: "", // AI 10 (recurre al serial, AI 21) serial: "", // AI 21 expiry: "YYYY-MM-DD", // AI 17, o 15/16 cuando no hay 17 useDate: "YYYY-MM-DD", // AI 15 / 16 (consumir preferentemente antes, vender antes) packDate: "YYYY-MM-DD", // AI 13 productionDate: "...", // AI 11 qty: , // AI 30 / 37; null cuando la etiqueta no indica cantidad count: , // AI 30 / 37 (piezas), conservado junto al peso weight: , // AI 31xx–36xx, la medida de la mercancía weightUom: {id, name}, // la unidad en que está esa medida, según la regla measures: [{ai, value, uom}, ...], // todas las medidas, incluido el peso bruto price: , // AI 390n–393n (importe a pagar) currency: "", // el código numérico que lleva AI 391n / 393n sscc: "", // AI 00 (unidad logística) location: "", // AI 414 locationDest: "", // AI 410 / 413 ais: {"01": "...", "10": "...", ...}, errors: [...], // lo que no se pudo leer, p. ej. un dígito de control incorrecto }

Se admiten tanto los códigos de barras entre paréntesis — (01)09501101020917(10)LOT123(17)261231 — como los escaneos sin procesar separados por FNC1.

GS1 siempre lleva el GTIN rellenado con ceros hasta 14 dígitos, mientras que un producto almacena el código corto impreso en el artículo. Por lo tanto, value contiene la forma sin relleno que almacena Odoo (13 dígitos, como produce sanitize_ean), que es con la que las pantallas comparan el producto; productCodes enumera las otras longitudes con las que un código de barras puede haberse almacenado, empezando por la forma más antigua.

Valores de longitud variable

GS1 termina un valor de longitud variable (un lote, un serial…) con FNC1, excepto cuando es el último elemento del código de barras, donde no se necesita ninguno. El analizador lo lee así: hasta el siguiente separador, o hasta el final del código de barras (véase Configuración para escáneres que no pueden enviar FNC1).

Solo cuando esa lectura es imposible —un valor más largo de lo que permite su regla— se ha eliminado claramente un separador. El valor termina entonces en el siguiente elemento que se lee limpiamente: un identificador numérico específico (nunca uno alfanumérico, ni un rango comodín) con un valor, una fecha real o un dígito de control correcto. Cualquier cosa por debajo de eso es ambigua —21 5830192 es el serial 5830192, o el serial 58 seguido de una cantidad de 192— y se lee como dice GS1, como un único valor.

Las lecturas erróneas se rechazan

Un GTIN, SSCC o GLN solo se acepta cuando su dígito de control (GS1 módulo 10) coincide. Un identificador mal leído se deja vacío y se informa en errors en lugar de resolverse al producto o palé equivocado.

En la aplicación de almacén

Qué hace la aplicación de almacén con él (con barcode_stock instalado):

• la cantidad recogida es el número de piezas que indica la etiqueta (AI 30/37). Una etiqueta sin él recoge una sola unidad, o la cantidad del paquete cuando su GTIN es un código de barras de embalaje. Una medida como un peso neto se decodifica pero no se toma como cantidad: eso depende de la unidad en la que se almacena el producto;
• el lote o serial se busca para el producto escaneado y se preselecciona en el asistente de movimiento; en una recepción, un lote desconocido abre el flujo de creación de lote con el nombre y, cuando product_expiry está instalado, la fecha de caducidad prerrellenada;
• en una entrega o un traslado interno, un lote que no está disponible se informa en lugar de escoger otro silenciosamente.