Importar catálogo y precios

Cuando tienes que actualizar muchos precios o cargar un catálogo completo, hacerlo uno por uno no es práctico. Para eso hay dos herramientas en el Desk de administración: la importación de precios por archivo (la que usarás casi siempre) y la importación de catálogo de proveedor.

Nota: ambas viven en el escritorio de administración (Desk). Son tareas de encargado/administrador.

A) Importar precios en bloque — "Doco Item Price Import"

Es el camino recomendado para cambiar muchos precios de una lista a la vez. Funciona en tres pasos: descargas un archivo con los productos que elijas, editas los precios en ese archivo y lo vuelves a subir.

Paso 1 — Arma el filtro

Abre Doco Item Price Import → Nuevo y llena:

1. Price List — la lista que vas a actualizar (sólo salen las habilitadas). La moneda se completa sola.
2. Title — un nombre para reconocer esta carga.
3. Filtros para acotar qué productos incluir:
   • Item Group, Brand, Item Code / Name Contains.
   • "Only items without a price on this list" — sólo los que aún no tienen precio en esa lista.
   • "Include Disabled Items" — incluir deshabilitados.
   • "Include Variant Templates" — incluir plantillas de variantes.
4. Guarda el documento.

Importante: el archivo se genera con los filtros ya guardados. Si cambias un filtro, guarda antes de descargar, o te avisará: "Save first to apply the latest filters."

Paso 2 — Descarga y edita

1. Botón "Download CSV" (azul). Sale el aviso "Exportando precios…" y luego "Exported N items — nombre-archivo"; el archivo se abre/descarga.
2. Abre el CSV (Excel/Google Sheets). Trae los productos que cumplieron el filtro. Edita la columna de precio con los nuevos valores. No cambies las columnas de identificación (código).
3. Guarda el archivo como CSV.

Paso 3 — Sube y aplica

1. Adjunta tu CSV en el campo Import File.
2. Botón "Apply CSV" (verde). Confirma el aviso: "Apply this CSV to price list {lista}? This will create/update Item Prices."
3. Sale "Importando precios…" y al terminar el resumen: "Created X, Updated Y, Skipped Z". El detalle queda en "Last Import Summary" dentro del documento.

Nota: los precios se crean o actualizan (upsert): si el producto ya tenía precio en esa lista, se actualiza; si no, se crea. Los renglones con problema se omiten (Skipped) y aparecen en el resumen para que los revises. Si nada se aplicó y todo se omitió, el aviso sale en rojo; si hubo mezcla, en naranja; si todo salió bien, en verde.

[captura: documento Doco Item Price Import con los botones "Download CSV" y "Apply CSV" y el resumen de la última importación]

B) Importar catálogo de proveedor — "Importación Catálogo"

Sirve para ingerir la lista de un proveedor (el archivo que te manda) y crear productos a partir de ella. Cada importación es un documento Importación Catálogo con:

• Supplier (proveedor), y de dónde llegó (chat/remitente) y cuándo.
• Instructions — notas de cómo procesarla.
• Raw File — el archivo original del proveedor.
• Status, que avanza por: Recibido → Filtrado → Parcial → Completado (o Error).

El sistema lee el archivo, filtra qué renglones aplican y crea los productos, dejando registro de lo creado y lo descartado para que lo revises.

Advertencia: esta herramienta crea artículos nuevos en el catálogo maestro. Revisa el resultado (creados vs. descartados) antes de darlo por bueno, para no duplicar productos ni meter basura del archivo del proveedor.

[VERIFICAR: cómo se dispara una Importación Catálogo (¿llega automática desde Telegram/WhatsApp del proveedor o se crea a mano?), el formato de archivo aceptado y cómo se muestran los renglones creados/descartados en la interfaz. Confirmar con doco/docoutils/doctype/importacion_catalogo/importacion_catalogo.py.]

¿Cuál uso?

• Sólo cambiar precios de productos que ya existen → A) Doco Item Price Import.
• Meter productos nuevos desde la lista de un proveedor → B) Importación Catálogo.