Docs

Importar SKUs

Referencia operacional para importar y mantener tu catálogo en Prize. Si recién empezás, hacé Inicio rápido primero — esta página asume que ya entendés el flow básico y profundiza sobre operación día a día.

Tres caminos

Prize soporta tres formas de importar SKUs, cada una óptima para un caso distinto:

| Modo | Cuándo usarlo | Latencia | |------|--------------|---------| | CSV manual | Setup inicial. Migración. Refresh masivo (>10K SKUs). | Minutos | | API REST | Cambios programáticos diarios. Integración con tu ERP/PIM. | Segundos | | Webhook entrante | Catálogos vivos donde el precio cambia minuto a minuto. Prize escucha tu sistema. | Inmediato |

CSV detallado

El método más simple. Subís un archivo, Prize valida fila por fila, vos confirmás.

  • Schema — 9 columnas requeridas + 3 opcionales. Detalle completo en Atributos.
  • Tamaño máximo — 50.000 filas por archivo. Si tenés más, dividí en lotes o usá API.
  • Encoding — UTF-8. Latin-1 / Windows-1252 se convierten automáticamente.
  • Separador — coma (,) por default. Si usás punto y coma, indicalo en el modal de import.

Dry-run mode

Antes de aplicar, podés correr un dry-run: Prize valida el archivo y te muestra qué pasaría — cuántos SKUs nuevos, cuántos updateados, cuántos errores — sin escribir nada al catálogo. Activás dry-run en el modal de import.

TIP · DRY-RUN ANTES DE IMPORTS GRANDES

Para imports >5.000 filas, corré siempre dry-run primero. Si hay errores de schema o validación, los detectás antes de aplicar y evitás un rollback parcial.

API REST

Para integración programática con tu ERP, PIM o cualquier sistema que sea fuente de verdad de tu catálogo.

| Método | Endpoint | Uso | |--------|----------|-----| | POST | /v1/catalog/skus | Crear uno o varios SKUs. Body es array. | | PATCH | /v1/catalog/skus/<sku> | Update parcial de un SKU existente. | | DELETE | /v1/catalog/skus/<sku> | Eliminar un SKU del catálogo. | | POST | /v1/catalog/skus/batch | Crear / update / delete en una sola request (transaccional). |

Todas las requests soportan idempotency keys via header Idempotency-Key. Si hacés retry con la misma key, Prize devuelve la respuesta original sin re-ejecutar la operación.

POST /v1/catalog/skus/batch — curl


Detalle completo en API · Catálogo. Rate limits y autenticación en API · Autenticación.


Webhook entrante


Si tu sistema fuente puede emitir webhooks cuando algo cambia, Prize los escucha y aplica el cambio inmediatamente — sin esperar al próximo ciclo. Setup:


    

  • En Configuración → Catálogo → Webhooks entrantes, generás un endpoint URL único para tu workspace.
    • 

  • Tu sistema le hace POST a esa URL cada vez que un SKU cambia.
    • 

  • Prize valida la firma HMAC (la clave la generás en Prize, la usás para firmar el payload del lado de tu sistema).
    • 

  • El cambio se aplica en segundos.
    • 



CUIDADO · ORDEN DE EVENTOS
Si tu sistema dispara webhooks fuera de orden (eventos paralelos sin secuencia), podés terminar con un estado inconsistente. Prize ofrece un campo updated_at opcional en el payload — si está presente, Prize descarta eventos más viejos que el último aplicado.


Qué pasa al re-importar


Re-importar un SKU existente actualiza sus campos, pero no destruye el trabajo previo:


| Cambio | Efecto en matches | Efecto en recs en cola |
|--------|------------------|----------------------|
| Sólo precio | Sin efecto. | Se invalida y regenera en próximo ciclo. |
| Sólo margen | Sin efecto. | Sin efecto inmediato (entra al próximo ciclo). |
| EAN / modelo | Matches existentes pasan a re-validación. HIGH baja a MEDIA si el cambio es ambiguo. | Recs en cola se descartan. |
| Categoría | Sin efecto inmediato. Re-aplican umbrales y márgenes de la nueva categoría en el próximo ciclo. | Recs en cola se invalidan. |
| Eliminar SKU | Matches y recs asociados se eliminan. Auditoría se mantiene. | Removidas. |


Errores comunes


| Código | Significado | Cómo resolverlo |
|--------|------------|----------------|
| VAL-001 | Columna requerida faltante. | Verificá que tu CSV tenga las 9 columnas obligatorias. |
| VAL-002 | Tipo inválido (precio con separadores, margen mal formateado). | Limpiá la columna. Precio = entero. Margen = decimal. |
| VAL-003 | SKU duplicado en el archivo. | Cada SKU es único. Mergeá filas duplicadas antes de subir. |
| VAL-004 | Categoría con typo distinto al árbol existente. | Revisá ortografía. Si el path es nuevo a propósito, confirmá la creación en el preview. |
| VAL-005 | EAN con checksum inválido. | Verificá el dígito de control del EAN-13. Prize valida el checksum estándar. |
| VAL-006 | Margen fuera de rango (> 1.0 o < -0.5). | Margen es decimal: 0.19 = 19%. Valores extremos raramente válidos. |
| API-401 | Token inválido o expirado. | Regenerá el token en Configuración → API. |
| API-429 | Rate limit excedido. | Esperá el reset (header Retry-After) o pedí incremento. |


Próximos pasos