Códigos y sus Valores

Los códigos de producto permiten identificar productos mediante diferentes sistemas de codificación (EAN, Serie, IMEI, SKU, etc.). Puedes agregar cuantos códigos y valores necesites, limitados únicamente por los tipos de código existentes en la herramienta.

Formato CSV (Archivos Planos)

El campo de valores de códigos es una cadena de texto compuesta que permite múltiples códigos.

Estructura Básica

{{Tipo de código}}:{{Valor de código}}

Ejemplos CSV

Ejemplo 1: Un solo código (EAN)

CodeValues
Ean:1234

Resultado:

Tipo de código: Ean
Valor: 1234

Ejemplo 2: Dos códigos (EAN + Serie)

CodeValues
Ean:1234;Serie:5678

Resultado:

Tipo de código: Ean → Valor: 1234
Tipo de código: Serie → Valor: 5678

Ejemplo 3: Tres códigos (EAN + Serie + IMEI)

CodeValues
Ean:1234;Serie:5678;Imei:891011

Resultado:

Tipo de código: Ean → Valor: 1234
Tipo de código: Serie → Valor: 5678
Tipo de código: Imei → Valor: 891011

Archivo CSV Completo de Ejemplo

ProductCode|ProductName|CodeValues
PROD001|Smartphone Samsung|Ean:7891234567890;Imei:123456789012345
PROD002|Laptop Dell|Ean:7897654321098;Serie:SN123456789
PROD003|Tablet Apple|Ean:7890123456789;Serie:C02XYZ123456;Imei:987654321098765

Tipos de Códigos Comunes

Tipo	Descripción	Ejemplo
Ean	European Article Number (código de barras)	`7891234567890`
Serie	Número de serie del producto	`SN123456789`
Imei	International Mobile Equipment Identity (dispositivos móviles)	`123456789012345`
Sku	Stock Keeping Unit	`SKU-12345`
Upc	Universal Product Code	`012345678905`

Errores Comunes en CSV

❌ Incorrecto	✅ Correcto	Problema
`Ean : 1234`	`Ean:1234`	Espacios alrededor de `:`
`Ean:1234;`	`Ean:1234`	Termina con `;`
`Ean:1234,Serie:5678`	`Ean:1234;Serie:5678`	Usa `,` en lugar de `;`
`ean:1234`	`Ean:1234`	Capitalización incorrecta*

*Nota: Verifica la capitalización requerida en tu configuración específica.

Formato JSON (API REST)

En las APIs REST, los códigos se encuentran anidados dentro del array CodeValues.

Estructura Básica

"CodeValues": [
    {
        "CodeType": "Ean",
        "Code": "589632566"
    }
]

Ejemplos JSON

Ejemplo 1: Un solo código

{
    "ProductCode": "PROD001",
    "ProductName": "Smartphone Samsung",
    "CodeValues": [
        {
            "CodeType": "Ean",
            "Code": "7891234567890"
        }
    ]
}

Ejemplo 2: Múltiples códigos

{
    "ProductCode": "PROD002",
    "ProductName": "Laptop Dell",
    "CodeValues": [
        {
            "CodeType": "Ean",
            "Code": "1234"
        },
        {
            "CodeType": "Serie",
            "Code": "5678"
        },
        {
            "CodeType": "Imei",
            "Code": "891011"
        }
    ]
}

Request Completo de Ejemplo (POST)

POST /api/products
Content-Type: application/json
Authorization: Bearer {token}

{
    "ProductCode": "PROD003",
    "ProductName": "iPhone 15 Pro",
    "Price": 1199.99,
    "Stock": 25,
    "CodeValues": [
        {
            "CodeType": "Ean",
            "Code": "0194253000000"
        },
        {
            "CodeType": "Imei",
            "Code": "352000111234567"
        },
        {
            "CodeType": "Serie",
            "Code": "F17ABC123DEF"
        }
    ]
}

Comparativa CSV vs JSON

Misma información en ambos formatos

CSV:

ProductCode|CodeValues
PROD001|Ean:7891234567890;Serie:SN123456;Imei:123456789012345

JSON:

{
    "ProductCode": "PROD001",
    "CodeValues": [
        {
            "CodeType": "Ean",
            "Code": "7891234567890"
        },
        {
            "CodeType": "Serie",
            "Code": "SN123456"
        },
        {
            "CodeType": "Imei",
            "Code": "123456789012345"
        }
    ]
}

Casos de Uso por Industria

Retail (Productos Generales)

EAN + SKU:

"CodeValues": [
    {
        "CodeType": "Ean",
        "Code": "7891234567890"
    },
    {
        "CodeType": "Sku",
        "Code": "SKU-LAPTOP-001"
    }
]

CSV equivalente:

Ean:7891234567890;Sku:SKU-LAPTOP-001

Electrónica (Teléfonos, Tablets)

EAN + IMEI + Serie:

"CodeValues": [
    {
        "CodeType": "Ean",
        "Code": "0194253000000"
    },
    {
        "CodeType": "Imei",
        "Code": "352000111234567"
    },
    {
        "CodeType": "Serie",
        "Code": "F17ABC123DEF"
    }
]

CSV equivalente:

Ean:0194253000000;Imei:352000111234567;Serie:F17ABC123DEF

Computadoras y Laptops

EAN + Serie + SKU:

"CodeValues": [
    {
        "CodeType": "Ean",
        "Code": "1234567890123"
    },
    {
        "CodeType": "Serie",
        "Code": "CN0123456789"
    },
    {
        "CodeType": "Sku",
        "Code": "DELL-XPS-15-001"
    }
]

CSV equivalente:

Ean:1234567890123;Serie:CN0123456789;Sku:DELL-XPS-15-001

Validación de Códigos

Código EAN-13 (13 dígitos)

Formato válido: 13 dígitos numéricos

✅ 7891234567890
❌ 789123456789 (12 dígitos)
❌ 78912345678901 (14 dígitos)
❌ 789ABC4567890 (contiene letras)

Código IMEI (15 dígitos)

Formato válido: 15 dígitos numéricos

✅ 123456789012345
❌ 12345678901234 (14 dígitos)
❌ 1234567890123456 (16 dígitos)

Número de Serie

Formato: Alfanumérico, varía según fabricante

✅ SN123456789
✅ C02XYZ123456
✅ F17ABC123DEF

Validación Pre-Envío

Checklist antes de enviar

Los tipos de código existen en el sistema Prisma
Los códigos tienen el formato correcto (longitud, tipo de caracteres)
No hay espacios alrededor de : (CSV)
Se usa ; como separador (CSV)
No termina con ; (CSV)
El JSON está bien formado (API)
Códigos EAN/UPC tienen dígito verificador válido

Solución de Problemas

Error: “Invalid code type”

Causa: El tipo de código no existe en Prisma

Solución: Verifica que el tipo de código esté configurado en el sistema

Tipos comunes:

Ean, Upc, Serie, Imei, Sku

Error: “Code format invalid”

Causa: El código no cumple con el formato esperado

Solución para EAN-13:

# Validar longitud
if len(ean) != 13:
    print("EAN debe tener 13 dígitos")

# Validar que sean solo números
if not ean.isdigit():
    print("EAN debe contener solo dígitos")

Error: “Duplicate code”

Causa: El código ya existe en otro producto

Solución:

Verifica que no estés duplicando códigos únicos (EAN, IMEI)
Si es intencional, consulta con el administrador

Ejemplos de Código

Python: Generar formato CSV

def format_codes_csv(codes):
    """
    Genera string de códigos en formato CSV
    codes: dict con {tipo: valor}
    """
    parts = [f"{code_type}:{value}" for code_type, value in codes.items()]
    return ";".join(parts)

# Uso
codes = {
    "Ean": "7891234567890",
    "Serie": "SN123456",
    "Imei": "123456789012345"
}

result = format_codes_csv(codes)
print(result)
# Output: Ean:7891234567890;Serie:SN123456;Imei:123456789012345

Python: Generar formato JSON

def format_codes_json(codes):
    """
    Genera array de códigos en formato JSON
    codes: dict con {tipo: valor}
    """
    return [
        {"CodeType": code_type, "Code": value}
        for code_type, value in codes.items()
    ]

# Uso
codes = {
    "Ean": "7891234567890",
    "Serie": "SN123456"
}

import json
result = format_codes_json(codes)
print(json.dumps(result, indent=2))

Output:

[
  {
    "CodeType": "Ean",
    "Code": "7891234567890"
  },
  {
    "CodeType": "Serie",
    "Code": "SN123456"
  }
]

Recursos Relacionados

Etiquetas y sus Valores - Formato similar para etiquetas
Formatos de Archivos - Especificaciones generales
Autenticación API REST - Cómo autenticarte en la API

Soporte

¿Necesitas ayuda con los códigos?

📧 Contacta al equipo de soporte
🔍 Solicita la lista de tipos de código disponibles
📋 Envía ejemplos para validación
🔢 Consulta sobre validación de códigos EAN/IMEI