Catálogo de mercado --- subida / descarga CSV

Última actualización: Aug 31, 2026Sección: Integraciones

Usa este flujo del panel de control cuando quieras editar muchas filas del catálogo de una sola vez:

  1. Exporta el catálogo actual como CSV
  2. Edita las filas sin conexión
  3. Sube el CSV de vuelta
  4. Revisa los cambios detectados
  5. Aplica los cambios

Esta página cubre el flujo del panel de control del propietario (autenticación Bearer). Para el uso de la API externa de solo lectura con X-API-Key, consulta market-catalog-external-api{.interpreted-text role="doc"}.

Resumen

La integración MARKET tiene una pestaña dedicada:

  • Subida / Descarga en los detalles de la integración
  • Exportar CSV descarga un CSV de ida y vuelta con cabeceras estables
  • Importar CSV analiza el contenido del archivo primero (previsualización), luego aplica los cambios de creación/actualización

Alcance actual:

  • Solo productos y variantes
  • Las filas faltantes se ignoran (no se archivan)
  • Las listas de precios no son parte de este flujo CSV todavía

Contrato CSV

Las cabeceras CSV son fijas y ordenadas:

row_type,product_id,variant_id,status,type_keys,tag_slugs,product_name,product_attributes_json,product_locales_json,variant_sort_order,variant_sku,variant_attributes_json,variant_locales_json

Reglas importantes:

  • row_type: product o variant
  • product_id:
  • opcional para filas de producto nuevas
  • obligatorio para filas de variante
  • variant_id:
  • opcional para filas de variante nuevas
  • obligatorio para actualizar una fila de variante existente
  • type_keys usa | como separador (para filas de producto)
  • tag_slugs usa | como separador (para filas de producto)
  • Las columnas *_attributes_json y *_locales_json deben contener valores de objeto JSON válidos cuando están rellenas

Previsualización y aplicación

El panel siempre ejecuta la previsualización primero:

  • valida la estructura de filas y restricciones del dominio
  • resuelve la acción de la fila: created, updated, unchanged o invalid
  • resalta los campos cambiados en la tabla de previsualización
  • muestra contadores de resumen

El filtro de previsualización por defecto es solo filas cambiadas. Puedes cambiar para mostrar todas las filas.

Etapa de aplicación:

  • requiere un token de previsualización de la última respuesta de previsualización
  • falla con conflicto si los datos cambiaron y el token está desactualizado
  • aplica solo operaciones de creación/actualización

Comportamiento de filas faltantes

Las filas que existen en el catálogo pero están ausentes en el CSV subido se cuentan como missing in file y se ignoran:

  • sin cambios automáticos de estado a ARCHIVED
  • sin eliminación

Mejores prácticas

  • Comienza desde una exportación fresca antes de editar
  • Mantén los IDs al actualizar filas existentes
  • Evita cambiar el orden o nombres de las columnas
  • Usa archivos CSV UTF-8
  • Mantén una única fuente de verdad para valores SKU (filas de variante)

Lecturas adicionales

  • API externa de lectura y alcances de claves API: market-catalog-external-api{.interpreted-text role="doc"}
  • Claves API y permisos: OpenAPI https://api.mailoo.app/docs/v1
📚