Barcode · UPC · Check Digit

Interactivo 1. Mockup: Data Entry de Producto

Haga clic en un ejemplo para ver la auto-detección y validación en tiempo real.

Decisión BarcodeType: calcular siempre, no almacenar en DB

El tipo de barcode es un atributo derivado — se determina al 100% del valor. Dado "049000042566", SIEMPRE es UPC-A. No hay ambigüedad.

El enum vive en código, no en la DB

public enum BarcodeType : byte
{
    UpcA     = 0,
    Ean13    = 1,
    Ean8     = 2,
    Isbn     = 3,
    Plu      = 4,
    Internal = 8,
    Custom   = 9,
}

public static BarcodeType DetectType(string barcode) =>
    barcode switch
    {
        _ when !barcode.All(char.IsDigit)                     => BarcodeType.Custom,
        { Length: 4 or 5 }                                    => BarcodeType.Plu,
        { Length: 13 } when barcode[..3] is "978" or "979"  => BarcodeType.Isbn,
        { Length: 13 } when barcode[..2] is >= "20" and <= "29" => BarcodeType.Internal,
        { Length: 12 } when barcode[0] is '2' or '4'        => BarcodeType.Internal,
        { Length: 8 }                                          => BarcodeType.Ean8,
        { Length: 12 }                                         => BarcodeType.UpcA,
        { Length: 13 }                                         => BarcodeType.Ean13,
        _                                                      => BarcodeType.Custom,
    };

Contexto 2. Realidad del Merchant Pequeño / Supermercado

Un merchant que "solo usa el barcode del fabricante" en la práctica siempre tiene mezcla:

Productos que NUNCA traen UPC

Referencia 3. Cómo lo Hacen los Competidores

Referencia 4. Glosario de Términos

Todos estos términos están documentados en docs/GLOSSARY.md. Referencia rápida inline:

Referencia 5. Estándar GS1: Por qué Prefijo "2"

El primer dígito de un UPC-A indica su propósito. Esto es un estándar global de GS1, no una convención arbitraria:

Por qué "2" y no otro

• Cero colisiones — un barcode prefijo 2 nunca choca con un código de fabricante real
• Sin registro — el merchant no paga a GS1 para generarlos
• No son globales — dos tiendas pueden usar 2100001 para productos distintos

Ejemplo: peso variable en báscula

Barcode generado por la báscula del supermercado:

  2 12345 00399 5
  │ │     │     └─ Check digit
  │ │     └─ Precio: $3.99
  │ └─ Código interno del producto (queso gouda)
  └─ Prefijo 2 = "este código lo generé yo"

Prefijos EAN-13 relevantes (Latam)

No implementada 6. Lógica de Auto-Detección (función pura, no DB)

// BarcodeHelper.DetectType() — enum en código, NO columna en DB
// Orden: más específico → más general. El usuario NUNCA elige tipo manualmente.

if (4-5 dígitos numéricos)             → PLU         // frutas/verduras
else if (13 dig, 978|979)              → ISBN        // libros
else if (13 dig, prefijo 20-29)        → Internal    // generado por tienda (EAN)
else if (12 dig, prefijo 2 o 4)        → Internal    // generado por tienda (UPC)
else if (8 dígitos numéricos)           → EAN-8       // validar Mod10
else if (12 dígitos numéricos)          → UPC-A       // validar Mod10
else if (13 dígitos numéricos)          → EAN-13      // validar Mod10
else                                    → Custom      // sin validación

No existe 7. Validación Check Digit (Modulo 10)

// Ejemplo: UPC-A "012345678905"
// Posiciones desde la derecha (sin check digit), pesos alternados 3,1,3,1...
// 0×1 + 1×3 + 2×1 + 3×3 + 4×1 + 5×3 + 6×1 + 7×3 + 8×1 + 9×3 + 0×1 = 85
// Check = (10 - 85%10) % 10 = 5  ✓

public static bool IsValidCheckDigit(string barcode)
{
    if (!barcode.All(char.IsDigit)) return false;
    if (barcode.Length is not (8 or 12 or 13)) return true;

    var sum = 0;
    for (var i = 0; i < barcode.Length - 1; i++)
    {
        var w = ((barcode.Length - 1 - i) % 2 == 0) ? 1 : 3;
        sum += (barcode[i] - '0') * w;
    }
    var expected = (10 - (sum % 10)) % 10;
    return (barcode[^1] - '0') == expected;
}

Implementado 8. Modelo de Datos (Schema Actual)

Item Code vs Barcode

Implementado 9. Indexes & Performance

Parcial 10. Flujo de Búsqueda

POS Terminal (offline — todo local)

Portal Web / Mobile

11. Gap Analysis

12. Orden de Implementación