Entrega del feed: SFTP o URL, horarios y protecciones
Cómo hacernos llegar tu CSV: por SFTP o por URL, a qué horas se procesa y qué pasa si un día el fichero llega vacío o roto.
El CSV de artículos es la fuente de verdad de tu catálogo: lo que está en el fichero se publica, lo que cambia se actualiza y lo que desaparece se retira de los portales. Esta página explica cómo entregarlo y qué hace Portal Hero para que un mal día del fichero no se convierta en un mal día de ventas. El formato de columnas está en la especificación completa.
Dos formas de entregarlo
Por SFTP. Te damos un usuario y una contraseña para sftp.portalhero.pro y escribes el fichero en la carpeta upload con el nombre item_feed.csv. El acceso está restringido por red: necesitamos la IP o las IPs desde las que subirás el fichero para añadirlas a la lista de acceso. Si cambias de servidor o de proveedor, avísanos antes; es la causa más habitual de «he subido el fichero y no se actualiza».
Por URL. Publicas el fichero en una URL y Portal Hero lo descarga en cada ejecución. Si la URL necesita autenticación, nos indicas las cabeceras que debemos enviar en la petición. Es la opción más cómoda cuando tu ERP o tu tienda ya generan un feed.
En ambos casos el fichero se sobrescribe: no hace falta enviar incrementales ni avisar de los cambios.
Cuándo se procesa
La sincronización se ejecuta varias veces al día, a las horas que elijas durante el alta. Lo habitual es programarla justo después de que tu sistema genere el fichero y, si tu stock rota rápido, repetirla a mediodía y por la tarde. Cada ejecución compara el fichero con lo publicado y solo toca lo que ha cambiado, así que un catálogo grande no tarda más por sincronizarse a menudo.
Qué pasa si el fichero llega mal
Un feed vacío, cortado a la mitad o con las columnas descolocadas no debe borrar tu catálogo. Antes de aplicar ningún cambio, cada ejecución comprueba tres cosas:
- Que el fichero es válido: cabecera esperada, codificación y separador correctos.
- Que el volumen es coherente: si el número de artículos cae de golpe respecto a la ejecución anterior, la sincronización se detiene y te avisamos en lugar de retirar anuncios.
- Que cada fila es publicable: las filas con errores se descartan una a una, con su motivo, sin bloquear al resto.
Cuando una ejecución se detiene, tus anuncios se quedan como estaban hasta que el siguiente fichero correcto llega.
Dónde ver el resultado
En el dashboard tienes el resultado de cada ejecución: artículos creados, actualizados y retirados por portal, y el detalle de las filas descartadas. Si algo no cuadra, escríbenos con la hora de la ejecución y lo miramos contigo.