Saltar al contenido principal

📤 Exportar — Asistente de exportación programada

El Asistente de exportación te permite generar feeds automáticos de datos (CSV, Excel o JSON) que se publican en una URL pública estable y se regeneran periódicamente. Es la herramienta perfecta para integrar TPVReady con sistemas externos: marketplaces, comparadores de precio, paneles de BI, scripts de tu gestoría, marketplaces como Amazon, El Corte Inglés…

A diferencia del Importar, aquí no subes nada: TPVReady publica datos hacia fuera.

🚪 Cómo se accede​

Menú lateral → Configuración → Exportar (solo admin).

📋 El listado de exportaciones​

Tabla con todos los feeds que tienes configurados. Columnas:

  • Nombre — el que tú le diste.
  • Slug — el identificador en la URL pública.
  • Formato — CSV / XLSX / JSON.
  • Entidad — qué datos exporta (productos por ahora).
  • Periodicidad — cada cuánto se regenera.
  • Última generación — fecha y hora.
  • Tamaño.
  • Estado — Activo / Inactivo.
  • URL pública — el enlace estable que comparten los sistemas externos.

Acciones por fila​

  • ▶ Ejecutar ahora — regenera el fichero al instante, sin esperar al scheduler.
  • 📋 Copiar URL — al portapapeles, listo para pegar en otra herramienta.
  • ✏️ Editar — abre el wizard de configuración.
  • 🔘 Toggle activar/desactivar — sin borrar nada.
  • 🗑️ Eliminar — borra la configuración Y el fichero publicado en MinIO.

➕ Crear una nueva exportación​

Botón Nueva exportación. Se abre un wizard de 3 pasos:

Paso 1 — Datos generales​

CampoPara qué sirve
NombreIdentificación interna (ej: "Feed Amazon España", "Catálogo para gestoría").
SlugParte de la URL pública. Solo letras/números/guiones (ej: amazon-es). Cuidado: si lo cambias, la URL anterior queda inválida.
FormatoCSV (universal), XLSX (Excel), JSON (APIs y scripts).
Separador (solo CSV)Coma ,, punto y coma ;, o tabulador.
Encoding (solo CSV)UTF-8 (recomendado), Windows-1252, etc.
PeriodicidadManual · cada 10 min · cada 30 min · cada hora · cada 6 h · cada 12 h · diaria · cron personalizado.

Paso 2 — Campos a exportar​

Aquí defines qué columnas tendrá tu feed.

Pantalla dividida en dos:

  • Izquierda: el catálogo de campos disponibles agrupados por bloque (Datos del producto, Familia, Tarifas, Stock, Promofarma, Imágenes…).
  • Derecha: la lista de campos seleccionados, con orden personalizable arrastrando.

Para cada campo seleccionado puedes:

  • Renombrar el alias (ej: el campo interno nombre_comercial lo exportas como Nombre).
  • Reordenar arrastrando con el icono de las 6 puntitas.
  • Eliminar con la papelera.
Empieza por una plantilla mínima

No selecciones todos los campos a lo loco. Empieza con los 5-10 imprescindibles que pide el sistema destino, ejecuta una vez y verifica. Añadir más después es trivial.

Paso 3 — Filtros y revisión​

  • Filtros opcionales — limitar la exportación (ej: solo productos activos, solo stock > 0, solo una familia concreta).
  • Previsualización — las primeras filas del fichero tal como saldrá.
  • Botón Guardar y ejecutar para crear la exportación y generar el primer fichero al momento.

🌐 La URL pública​

Cada exportación se publica en una URL estable y pública:

https://cdn.tpvready.es/tpvready/{empresa_token}/exportaciones/{slug}.{ext}

Ejemplo: https://cdn.tpvready.es/tpvready/a3f7-…/exportaciones/amazon-es.csv

Características:

  • Estable: la URL no cambia mientras no cambies el slug.
  • Pública sin auth: cualquiera con el enlace puede descargarla.
  • Rápida: servida desde MinIO con caché CDN.
  • Actualizada según tu periodicidad: cada vez que el scheduler ejecuta, sobreescribe el fichero.
URL pública = datos públicos

Como cualquiera con el enlace puede leer el fichero, no incluyas información sensible (precios de coste, márgenes, datos personales de clientes). Sí está bien para datos comerciales: nombre, EAN, precio venta, stock, descripción.

⏱️ Periodicidades disponibles​

PeriodicidadCuándo se regeneraCaso de uso típico
ManualSolo cuando pulsas Ejecutar ahora.Pruebas, exportaciones puntuales.
Cada 10 minA los 0, 10, 20, 30, 40, 50 minutos.Stock en tiempo casi real para marketplace activo.
Cada 30 min / 1 h / 6 h / 12 hMúltiplos de la hora.Feeds con cambios moderados.
DiariaUna vez al día (hora interna por defecto).Catálogos, listados de gestoría.
Cron personalizadoExpresión cron de 5 campos.Cualquier patrón a medida.

💡 Buenas prácticas​

  • Un feed por sistema destino. No reutilices "el feed grande" para varios sistemas: cada uno tiene sus columnas, formato y periodicidad ideales.
  • Slug descriptivo y corto. amazon-es-stock mejor que feed-1-prueba. Si cambias slug, no olvides actualizar el destino que lo lea.
  • Empieza diario, sube frecuencia solo si lo necesitas. Cada generación cuenta a efectos de carga del servidor.
  • Verifica el fichero después de crear. Click en la URL pública y mírala con tu ojo: ¿son las columnas que esperabas?, ¿se interpreta el separador?, ¿hay caracteres raros?
  • Documenta dónde está consumido cada feed. En el nombre o en una nota propia: dentro de 6 meses agradecerás saber para qué creaste "feed-prom-extra".

❓ Preguntas frecuentes​

¿Qué entidades puedo exportar? Por ahora productos está consolidado. Para clientes, ventas u otras entidades, contacta con soporte@extremanet.com y vamos añadiendo a demanda.

Necesito incluir un campo que no aparece en el catálogo. Pídelo a soporte: el catálogo se amplía a demanda real.

¿Puedo proteger la URL con contraseña? No por ahora. Si tu uso lo requiere, dinos: estamos valorando añadir tokens de acceso para los feeds privados.

Mi cron personalizado no se ejecuta. Comprueba la sintaxis (5 campos: minuto · hora · día-mes · mes · día-semana). Y verifica que la exportación está Activa (toggle verde). Si sigue sin ejecutar, contacta con soporte.

Eliminé una exportación por error. ¿Puedo recuperarla? La configuración se borra y el fichero MinIO también. No hay papelera. Si tenías una configuración compleja, recréala desde cero. Recomendación: antes de borrar, desactiva primero.

¿Necesitas ayuda configurando un feed? Escríbenos a soporte@extremanet.com.