Validar un código de barras

Para qué sirve el dígito de control

Todo código EAN, UPC e ISBN termina en un dígito que no forma parte de la identidad del producto, es pura aritmética. Ese dígito se calcula a partir de los números anteriores con una fórmula de ponderación fija, así que si un solo dígito se transpuso durante la captura de datos, una importación de hoja de cálculo o un escaneo OCR de una etiqueta impresa, la cuenta ya no cierra y el código queda demostrablemente mal. Esa es la idea completa: un lector puede detectar un error de tipeo sin necesidad de consultar nada externo.

Qué hace POST /verify/barcode

Envía el texto del código y, opcionalmente, la simbología esperada. La tarea elimina el formato, confirma que la longitud coincide con un estándar conocido, recalcula el dígito de control con el algoritmo correcto para ese formato y lo compara con el que se proporcionó. La respuesta indica si el código es válido y con qué simbología coincidió, para que un código que parece válido tanto como EAN-13 como UPC-A mal formado no le deje adivinando.

Un formato con más historia de la que parece

El UPC se adoptó comercialmente en Estados Unidos en 1974, y se escaneó por primera vez en un paquete de chicles en un supermercado de Ohio. El EAN llegó poco después como la extensión internacional, agregando un dígito de prefijo de país para que la misma infraestructura funcionara en todo el mundo. El ISBN, de origen distinto pero de estructura similar, viene de un esquema de numeración para libreros de los años sesenta y más tarde se integró a la misma lógica de dígito de control que usa el EAN-13. Tres industrias distintas, una idea compartida: números capaces de detectar sus propios errores.

Dónde encaja en un flujo real

Úselo cuando llega un feed de proveedor con miles de SKU nuevos y necesita saber qué códigos de barras son estructuralmente correctos antes de que lleguen a un catálogo o a un punto de venta. Úselo antes de enviar publicaciones a un marketplace que rechaza de plano los códigos mal formados. Como la tarea es asíncrona, la envía y sigue trabajando, y luego recoge los resultados mediante un webhook firmado o un enlace firmado válido por 24 horas, sin necesidad de sondear el estado.

Lo que no hace

Confirma validez matemática, no que el código esté registrado a un producto real ni que no esté duplicado dentro de su propio catálogo. Esos son problemas distintos que requieren datos distintos. Lo que ofrece es un primer filtro rápido y honesto que elimina los códigos que ya sabe que están rotos, antes de que le cuesten un envío rechazado.