Entrega del feed: SFTP o URL, horaris i proteccions
Com fer-nos arribar el teu CSV: per SFTP o per URL, a quines hores es processa i què passa si un dia el fitxer arriba buit o trencat.
El CSV d'articles és la font de veritat del teu catàleg: el que és al fitxer es publica, el que canvia s'actualitza i el que desapareix es retira dels portals. Aquesta pàgina explica com entregar-lo i què fa Portal Hero perquè un mal dia del fitxer no es converteixi en un mal dia de vendes. El format de columnes és a l'especificació completa.
Dues formes d'entregar-lo
Per SFTP. Et donem un usuari i una contrasenya per a sftp.portalhero.pro i escrius el fitxer a la carpeta upload amb el nom item_feed.csv. L'accés està restringit per xarxa: necessitem la IP o les IPs des de les quals pujaràs el fitxer per afegir-les a la llista d'accés. Si canvies de servidor o de proveïdor, avisa'ns abans; és la causa més habitual de «he pujat el fitxer i no s'actualitza».
Per URL. Publiques el fitxer en una URL i Portal Hero el descarrega en cada execució. Si la URL necessita autenticació, ens indiques les capçaleres que hem d'enviar en la petició. És l'opció més còmoda quan el teu ERP o la teva botiga ja generen un feed.
En ambdós casos el fitxer se sobreescriu: no cal enviar incrementals ni avisar dels canvis.
Quan es processa
La sincronització s'executa diverses vegades al dia, a les hores que triïs durant l'alta. El habitual és programar-la just després que el teu sistema generi el fitxer i, si el teu estoc rota ràpid, repetir-la al migdia i a la tarda. Cada execució compara el fitxer amb el que està publicat i només toca el que ha canviat, així que un catàleg gran no triga més per sincronitzar-se sovint.
Què passa si el fitxer arriba malament
Un feed buit, tallat a la meitat o amb les columnes descol·locades no ha d'esborrar el teu catàleg. Abans d'aplicar cap canvi, cada execució comprova tres coses:
- Que el fitxer és vàlid: capçalera esperada, codificació i separador correctes.
- Que el volum és coherent: si el nombre d'articles cau de cop respecte a l'execució anterior, la sincronització s'atura i t'avisem en lloc de retirar anuncis.
- Que cada fila és publicable: les files amb errors es descarten una a una, amb el seu motiu, sense bloquejar la resta.
Quan una execució s'atura, els teus anuncis es queden com estaven fins que arriba el següent fitxer correcte.
On veure el resultat
Al dashboard tens el resultat de cada execució: articles creats, actualitzats i retirats per portal, i el detall de les files descartades. Si alguna cosa no quadra, escriu-nos amb l'hora de l'execució i ho mirem amb tu.