# Flux fichiers et référentiels

Intégrer un système qui échange des CSV ou tient les données de référence.

## Configurer un flux

Les connexions fichiers portent le transport et ses identifiants. Les flux portent le type d'opération, les dossiers, la planification et le format. Séparez ces responsabilités pour réutiliser une connexion sans dupliquer ses secrets.

1. Configurez et testez la connexion depuis les réglages d'intégration.
2. Choisissez le type de flux réellement disponible sur l'instance.
3. Définissez les dossiers d'entrée et de sortie ainsi que la planification.
4. Testez un petit lot et examinez son journal.
5. Vérifiez les fichiers traités, rejetés ou archivés avant d'activer la récurrence.

Les modèles de CSV et les formats d'export du produit sont la référence. Un fichier ressemblant visuellement à un modèle peut différer par l'encodage, les séparateurs, les noms de colonnes ou les dates.

## Responsabilités du système distant

Publiez les fichiers complets et évitez qu'un lecteur prenne un fichier encore en cours d'écriture. Conservez un identifiant de lot et le résultat de traitement. Décidez explicitement de la reprise après erreur pour ne pas réinjecter des opérations comptables déjà acceptées.

## Référentiel client HTTP

L'adaptateur générique attend des lectures par identifiant : `GET {base}/company/{id}` et `GET {base}/contact/{id}`. Le résultat est un objet dont les champs alimentent le mapping, avec une date `updatedAt` pour le suivi de fraîcheur. Un identifiant absent répond `404`.

La recherche utilise `GET {base}/company?q=...&limit=10` ou l'équivalent contact et retourne un tableau d'objets identifiables. L'administrateur configure l'authentification et les correspondances de champs. Les coordonnées peuvent relever d'objets séparés et ne doivent pas être inventées dans le mapping.

Pour les deltas entrants et les champs tenus par la source, voir [Synchronisation](/documentation/api-synchronisation/).