Livraison du flux : SFTP ou URL, horaires et protections

Le CSV d'articles est la source de vérité de votre catalogue : ce qui est dans le fichier est publié, ce qui change est mis à jour et ce qui disparaît est retiré des portails. Cette page explique comment le livrer et ce que fait Portal Hero pour qu'un mauvais jour du fichier ne se transforme pas en un mauvais jour de ventes. Le format des colonnes est dans la spécification complète.

Deux façons de le livrer

Par SFTP. Nous vous fournissons un identifiant et un mot de passe pour sftp.portalhero.pro et vous écrivez le fichier dans le dossier upload sous le nom item_feed.csv. L'accès est restreint par réseau : nous avons besoin de l'IP ou des IPs depuis lesquelles vous téléverserez le fichier pour les ajouter à la liste d'accès. Si vous changez de serveur ou de fournisseur, prévenez-nous à l'avance ; c'est la cause la plus fréquente de « j'ai téléversé le fichier et il ne se met pas à jour ».

Par URL. Vous publiez le fichier à une URL et Portal Hero le télécharge à chaque exécution. Si l'URL nécessite une authentification, vous nous indiquez les en-têtes que nous devons envoyer dans la requête. C'est l'option la plus pratique lorsque votre ERP ou votre boutique génèrent déjà un flux.

Dans les deux cas, le fichier est écrasé : il n'est pas nécessaire d'envoyer des incréments ni de signaler les changements.

Quand il est traité

La synchronisation s'exécute plusieurs fois par jour, aux heures que vous choisissez lors de l'inscription. L'usage habituel est de la programmer juste après que votre système a généré le fichier et, si votre stock tourne rapidement, de la répéter à midi et l'après-midi. Chaque exécution compare le fichier avec ce qui est publié et ne touche que ce qui a changé, de sorte qu'un grand catalogue ne prend pas plus de temps à se synchroniser souvent.

Que se passe-t-il si le fichier arrive mal

Un flux vide, coupé en deux ou avec les colonnes désordonnées ne doit pas supprimer votre catalogue. Avant d'appliquer le moindre changement, chaque exécution vérifie trois choses :

1. Que le fichier est valide : en-tête attendu, encodage et séparateur corrects.
2. Que le volume est cohérent : si le nombre d'articles chute brusquement par rapport à l'exécution précédente, la synchronisation s'arrête et nous vous prévenons au lieu de retirer des annonces.
3. Que chaque ligne est publiable : les lignes comportant des erreurs sont écartées une à une, avec leur motif, sans bloquer les autres.

Lorsqu'une exécution s'arrête, vos annonces restent telles quelles jusqu'à l'arrivée du fichier correct suivant.

Où voir le résultat

Dans le dashboard, vous avez le résultat de chaque exécution : articles créés, mis à jour et retirés par portail, ainsi que le détail des lignes écartées. Si quelque chose ne va pas, écrivez-nous avec l'heure de l'exécution et nous l'examinons avec vous.