Fichiers (SFTP ou S3)

Sur cette page

Livraison via SFTP

Vous exportez des fichiers et les livrez selon un planning vers SFTP ou S3. Athia fournit la destination, la spécification du format et la validation.

À qui appartient-il de votre côté : votre équipe de données. Ils exportent à partir des systèmes d'enregistrement et planifient la livraison.
Ce qu'Athia vous apporte : la destination SFTP ou S3 et les informations d'identification, la spécification du champ (voir Dictionnaire de données Athia), et un rapport de validation sur chaque livraison répertoriant les lignes rejetées, les champs obligatoires manquants et les incohérences de type, vérifié par rapport au mappage convenu pour votre compte plutôt que par rapport aux noms de colonnes fixes, afin que vous puissiez corriger l'exportation avant la prochaine exécution.
Cadence : quotidien est typique de l’alimentation récurrente. Faites-le correspondre à la fréquence de fermeture de vos systèmes sources.
Formats : Le parquet Apache est préférable. Gzip CSV, JSON Lines ou l'accès direct aux tables et aux vues fonctionnent également.
Granularité des fichiers : un fichier par source et par mois, environ un gigaoctet par fichier, divisé s'il est plus volumineux.
Un effort ponctuel : l'export historique se fait une seule fois. Une fois la connexion en direct établie, aucune mise à jour manuelle continue n'est nécessaire.

Exportez l'historique au niveau de la tentative.

Incluez chaque tentative de paiement et son résultat, plutôt que l'enregistrement par commande.

Livraison via SFTP ou S3

Utilisez le schéma et l'emplacement sécurisé convenus pour les fichiers historiques et les fichiers programmés.

Athia valide le flux de données

Le schéma, l'exhaustivité, les identifiants, les horodatages et la cohérence des résultats sont vérifiés avant l'activation.

Corriger et renvoyer

Résolvez les lacunes signalées, renvoyez les données concernées et répétez la validation jusqu'à ce que le flux de données soit valide.

Exécuter le calendrier récurrent

Maintenez le flux de données à jour automatiquement après la charge historique initiale ; les téléchargements manuels réguliers ne sont pas nécessaires.

Le remplissage et l'alimentation récurrente utilisent le même chemin et la même spécification.

Livraison via SFTP#

SFTP est le bon choix pour l’historique en masse et pour les flux qui n’ont pas besoin d’arriver en quelques secondes.

Obtenir l'accès

Demandez à votre équipe Athia d'ouvrir un compte SFTP. Vous échangez des clés publiques, et elles renvoient l'hôte, le nom d'utilisateur et les répertoires de téléchargement et de réception de votre compte. Il n'y a pas de mot de passe.

Nommer vos fichiers

Commencez chaque nom de fichier par le type de données qu'il contient. Athia route sur ce préfixe, donc un fichier mal nommé est un fichier mal acheminé.

transactions_2026-05-18_01.parquet
costs_2026-05-18_01.parquet
subscriptions_2026-05-18_01.parquet

Tout ce qui se trouve après le préfixe vous appartient : un horodatage, un système source, un numéro de pièce.

Téléchargement et lecture du reçu

Connectez-vous avec l'hôte et le nom d'utilisateur qui vous ont été attribués.
Déposez vos fichiers dans le répertoire de téléchargement.
Lisez le reçu dans le répertoire des reçus sur le même serveur.

Athia rédige un reçu pour chaque fichier traité, nommant les lignes rejetées, les champs obligatoires manquants et les incohérences de type. Corrigez l'exportation plutôt que le fichier, sinon la prochaine exécution planifiée répétera le problème.