Etiquetas y sus Valores

Las etiquetas (tags) permiten agregar metadatos personalizados a los registros. Puedes añadir cuantas etiquetas y valores necesites, limitadas únicamente por las etiquetas existentes en la herramienta.

Formato CSV (Archivos Planos)

El campo de valores de etiquetas es una cadena de texto compuesta que permite múltiples etiquetas.

Estructura Básica

{{Nombre de etiqueta}}:{{Valor de etiqueta}}

Ejemplos CSV

Ejemplo 1: Una sola etiqueta

TagValues
CodigoExtra:Numero1

Resultado:

Etiqueta: CodigoExtra
Valor: Numero1

Ejemplo 2: Dos etiquetas

TagValues
CodigoExtra:Numero1;CodigoSuper:Numero2

Resultado:

Etiqueta: CodigoExtra → Valor: Numero1
Etiqueta: CodigoSuper → Valor: Numero2

Ejemplo 3: Tres etiquetas

TagValues
CodigoExtra:Numero1;CodigoSuper:Numero2;CodigoMega:Numero3

Resultado:

Etiqueta: CodigoExtra → Valor: Numero1
Etiqueta: CodigoSuper → Valor: Numero2
Etiqueta: CodigoMega → Valor: Numero3

Archivo CSV Completo de Ejemplo

ProductCode|ProductName|TagValues
PROD001|Laptop|CodigoExtra:LAP001
PROD002|Mouse|CodigoExtra:MOU001;CodigoSuper:SUPER123
PROD003|Teclado|CodigoExtra:TEC001;CodigoSuper:SUP456;CodigoMega:MEG789

Errores Comunes en CSV

❌ Incorrecto	✅ Correcto	Problema
`CodigoExtra : Numero1`	`CodigoExtra:Numero1`	Espacios alrededor de `:`
`CodigoExtra:Numero1;`	`CodigoExtra:Numero1`	Termina con `;`
`CodigoExtra:Numero1,CodigoSuper:Numero2`	`CodigoExtra:Numero1;CodigoSuper:Numero2`	Usa `,` en lugar de `;`

Formato JSON (API REST)

En las APIs REST, las etiquetas se encuentran anidadas dentro del array TagValues.

Estructura Básica

"TagValues": [
    {
        "TagName": "TAG-STORE-1",
        "Value": "Uno"
    }
]

Ejemplos JSON

Ejemplo 1: Una sola etiqueta

{
    "ProductCode": "PROD001",
    "ProductName": "Laptop",
    "TagValues": [
        {
            "TagName": "TAG-STORE-1",
            "Value": "Uno"
        }
    ]
}

Ejemplo 2: Múltiples etiquetas

{
    "ProductCode": "PROD002",
    "ProductName": "Mouse",
    "TagValues": [
        {
            "TagName": "TAG-STORE-1",
            "Value": "Uno"
        },
        {
            "TagName": "TAG-STORE-2",
            "Value": "Cuatro"
        },
        {
            "TagName": "TAG-STORE-3",
            "Value": "Siete"
        }
    ]
}

Request Completo de Ejemplo (POST)

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

{
    "ProductCode": "PROD003",
    "ProductName": "Teclado Mecánico",
    "Price": 149.99,
    "Stock": 50,
    "TagValues": [
        {
            "TagName": "Category",
            "Value": "Electronics"
        },
        {
            "TagName": "Brand",
            "Value": "Logitech"
        },
        {
            "TagName": "Model",
            "Value": "MX-Keys"
        }
    ]
}

Comparativa CSV vs JSON

Misma información en ambos formatos

CSV:

ProductCode|TagValues
PROD001|Category:Electronics;Brand:Logitech;Model:MX-Keys

JSON:

{
    "ProductCode": "PROD001",
    "TagValues": [
        {
            "TagName": "Category",
            "Value": "Electronics"
        },
        {
            "TagName": "Brand",
            "Value": "Logitech"
        },
        {
            "TagName": "Model",
            "Value": "MX-Keys"
        }
    ]
}

Casos de Uso Comunes

Etiquetas de Categorización

"TagValues": [
    {
        "TagName": "Department",
        "Value": "Electronics"
    },
    {
        "TagName": "SubCategory",
        "Value": "Computers"
    }
]

CSV equivalente:

Department:Electronics;SubCategory:Computers

Etiquetas de Ubicación

"TagValues": [
    {
        "TagName": "Warehouse",
        "Value": "WH-001"
    },
    {
        "TagName": "Aisle",
        "Value": "A12"
    },
    {
        "TagName": "Shelf",
        "Value": "S03"
    }
]

CSV equivalente:

Warehouse:WH-001;Aisle:A12;Shelf:S03

Etiquetas de Atributos de Producto

"TagValues": [
    {
        "TagName": "Color",
        "Value": "Black"
    },
    {
        "TagName": "Size",
        "Value": "Medium"
    },
    {
        "TagName": "Material",
        "Value": "Aluminum"
    }
]

CSV equivalente:

Color:Black;Size:Medium;Material:Aluminum

Validación

Checklist antes de enviar

Los nombres de etiquetas existen en el sistema Prisma
No hay espacios alrededor de : (CSV)
Se usa ; como separador (CSV)
No termina con ; (CSV)
El JSON está bien formado (API)
Los valores son del tipo correcto

Solución de Problemas

Error: “Tag not found”

Causa: El nombre de etiqueta no existe en Prisma

Solución: Verifica que la etiqueta esté creada en el sistema o contacta al administrador

Error: “Invalid tag format”

Causa CSV: Espacios alrededor de : o formato incorrecto

Solución:

❌ Tag Name : Value
✅ TagName:Value

Error: “Unexpected character”

Causa CSV: Carácter ; al final de la cadena

Solución:

❌ Tag1:Val1;Tag2:Val2;
✅ Tag1:Val1;Tag2:Val2

Recursos Relacionados

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

Soporte

¿Necesitas ayuda con las etiquetas?

📧 Contacta al equipo de soporte
🔍 Solicita la lista de etiquetas disponibles en tu instancia
📋 Envía ejemplos para validación