Ce document décrit le format du fichier CSV utilisé pour les imports via FTP / SFTP des POS non intégré.
Le fichier doit être encodé en UTF-8 et au format CSV (séparé par des virgules ",").
Un fichier d'exemple se trouve en pièce jointe de cet article.
ℹ️ Formats de données
Utilisez toujours un point comme séparateur décimal (ex.
1.23) et non pas une virgule.Les valeurs doivent être indiquées dans la devise utilisée et non pas en centimes (ex.
1.23et non123).
📋 Structure du fichier CSV
Colonne | Description | Obligatoire |
order_remote_id | Identifiant unique de la commande | Oui |
order_date | Date de la vente, format ISO8601 | Oui |
order_covers | Nombre de couverts | Non, 0 par défaut |
product_remote_id | Identifiant unique du produit dans le POS | Oui |
product_remote_name | Nom du produit tel que défini dans le POS | Non |
product_quantity | Quantité totale vendue pour ce produit | Oui |
product_amount_including_tax | Montant total T.T..C des ventes du produit, en euros | Oui |
product_amount_excluding_tax | Montant total H.T des ventes du produit, en euros | Oui |
🧪 Validation de votre fichier
Avant de déposer votre fichier sur le FTP, vous pouvez vérifier qu’il respecte bien le format attendu en utilisant notre outil de validation :
👉 https://pos-import-report.yokitup.com
🔐 Connexion FTP / SFTP
Les identifiants de connexion (serveur, utilisateur, mot de passe) sont visibles dans la page de l'intégration POS.
⚠️ Après 3 tentatives de connexion échouées, votre adresse IP sera automatiquement bloquée pendant 24 heures.
⏱ Fréquence de traitement des fichiers
Les fichiers déposés sur le FTP sont traités automatiquement toutes les heures.
Chaque traitement va analyser les fichiers présents dans le dossier, en se basant sur leur nom.
⚠️ Fichiers déjà traités
Une fois qu’un fichier a été traité, il ne peut plus être retraité, même si :
le fichier est supprimé puis recréé avec le même nom ;
le fichier contenait une erreur (par exemple : format invalide).
Pour forcer un nouveau traitement, vous devez changer le nom du fichier (ajouter une date, une version, etc.).
🚫 Aucune suppression possible
Une fois qu’un fichier a été traité, les ventes et produits enregistrées ne peuvent pas être supprimées.
⚠️ Soyez donc très attentif avant de déposer un fichier sur le FTP.
✅ Gestion des doublons
Si une vente a déjà été traitée (par exemple via un autre fichier), elle sera automatiquement ignorée lors des traitements suivants.
L’identifiant utilisé pour cela est le champ
order_remote_id, qui doit être unique pour chaque vente.
🔔 Suivi des erreurs
Après dépôt d’un fichier, vous pouvez vérifier son traitement dans l’onglet Événements de votre intégration POS. Attention, le nom du fichier n’est pas affiché, il faut donc surveiller les dates et types d’erreur indiqués.
📆 Recommandation sur les ventes nocturnes
💡 Conseil : si vous avez des ventes enregistrées entre minuit et 6h du matin et que votre export ne contient que la date (sans l’heure), nous vous recommandons de les rattacher à la date de la veille dans votre export.
Cela permet d’aligner les données avec la réalité opérationnelle des sites ouverts tard le soir et de garantir des statistiques plus cohérentes.
👉 Ce comportement est souvent attendu par les équipes opérationnelles, mais il doit être explicitement géré dans le script d’export, car ce n’est pas le comportement par défaut.