Consegna del feed: SFTP o URL, orari e protezioni

Il CSV degli articoli è la fonte di verità del tuo catalogo: ciò che è nel file viene pubblicato, ciò che cambia viene aggiornato e ciò che sparisce viene ritirato dai portali. Questa pagina spiega come consegnarlo e cosa fa Portal Hero affinché una brutta giornata del file non si trasformi in una brutta giornata di vendite. Il formato delle colonne è nella specifica completa.

Due modi di consegnarlo

Via SFTP. Ti diamo un utente e una password per sftp.portalhero.pro e scrivi il file nella cartella upload con il nome item_feed.csv. L'accesso è limitato a livello di rete: ci serve l'IP o gli IP da cui caricherai il file per aggiungerli alla lista di accesso. Se cambi server o provider, avvisaci prima; è la causa più comune di «ho caricato il file e non si aggiorna».

Via URL. Pubblichi il file su un URL e Portal Hero lo scarica a ogni esecuzione. Se l'URL richiede autenticazione, ci indichi gli header che dobbiamo inviare nella richiesta. È l'opzione più comoda quando il tuo ERP o il tuo negozio generano già un feed.

In entrambi i casi il file viene sovrascritto: non è necessario inviare incrementali né avvisare delle modifiche.

Quando viene elaborato

La sincronizzazione si esegue più volte al giorno, agli orari che scegli durante l'attivazione. Di solito la si programma subito dopo che il tuo sistema genera il file e, se il tuo stock ruota rapidamente, la si ripete a mezzogiorno e nel pomeriggio. Ogni esecuzione confronta il file con ciò che è pubblicato e tocca solo ciò che è cambiato, quindi un catalogo grande non impiega più tempo per il fatto di sincronizzarsi spesso.

Cosa succede se il file arriva male

Un feed vuoto, tagliato a metà o con le colonne fuori posto non deve cancellare il tuo catalogo. Prima di applicare qualsiasi modifica, ogni esecuzione verifica tre cose:

1. Che il file sia valido: intestazione attesa, codifica e separatore corretti.
2. Che il volume sia coerente: se il numero di articoli cala di colpo rispetto all'esecuzione precedente, la sincronizzazione si ferma e ti avvisiamo invece di ritirare annunci.
3. Che ogni riga sia pubblicabile: le righe con errori vengono scartate una a una, con il loro motivo, senza bloccare le altre.

Quando un'esecuzione si ferma, i tuoi annunci restano come erano finché non arriva il file corretto successivo.

Dove vedere il risultato

Nel dashboard hai il risultato di ogni esecuzione: articoli creati, aggiornati e ritirati per portale, e il dettaglio delle righe scartate. Se qualcosa non torna, scrivici con l'ora dell'esecuzione e lo guardiamo insieme a te.