Les fichiers ERP peuvent être transmis à Afakto de trois façons : import manuel, sFTP ou API REST. Cet article présente les deux méthodes automatisées. Pour l'import manuel, voir Import manuel des données.
Choisir un mode d'échange
Mode push : vos systèmes envoient les fichiers à Afakto, par sFTP ou API.
Mode pull : Afakto récupère les fichiers dans vos systèmes à intervalles programmés.
La méthode adaptée dépend de vos politiques de sécurité et de votre infrastructure. Elle est définie avec votre équipe de mise en place Afakto.
sFTP
Les fichiers peuvent être échangés par sFTP de deux façons.
| Afakto récupère les fichiers | Vous envoyez les fichiers à Afakto |
Mode d'échange | Mode pull | Mode push |
Serveur sFTP | Hébergé par vous | Hébergé par Afakto |
Votre action | Déposer les fichiers sur votre serveur sFTP | Déposer les fichiers sur le serveur sFTP d'Afakto |
Action d'Afakto | Se connecte à votre serveur et récupère les fichiers | Traite les fichiers dès qu'ils sont déposés |
Authentification | Définie par vous | Mot de passe |
Fréquence recommandée | Récupération quotidienne | Dépôt quotidien |
Afakto récupère les fichiers sur votre serveur
Votre ERP dépose les fichiers acheteurs et créances sur un serveur sFTP que vous mettez à disposition. Afakto se connecte à ce serveur et récupère les fichiers à intervalles programmés. Une récupération quotidienne est recommandée.
Transmettez à l'équipe de mise en place Afakto les informations de connexion à votre serveur : l'adresse, la méthode d'authentification et les identifiants.
Vous envoyez les fichiers sur le serveur d'Afakto
Afakto met à disposition un serveur sFTP, gratuitement. Votre ERP dépose les fichiers acheteurs et créances sur ce serveur, puis Afakto les importe. Un dépôt quotidien est recommandé.
L'équipe de mise en place Afakto vous communique les informations de connexion au serveur. L'authentification se fait par mot de passe.
API REST
Documentation Swagger
L'API Afakto est décrite dans un fichier Swagger (OpenAPI 3.1) : https://app.afakto.com/v3/api-docs/springdocDefault
Ce fichier est accessible publiquement. Chargez-le dans n'importe quel visualiseur Swagger pour consulter les endpoints et les structures de données avant de démarrer votre intégration.
Endpoint
Tous les fichiers sont envoyés vers un endpoint unique : POST /api/datastreams/upload (multipart/form-data).
La requête contient deux champs :
Champ | Valeur |
| Le fichier à importer. Le format CSV est recommandé. |
|
|
|
Si vos fichiers contiennent plusieurs COMPANY_CODE, ignorez ce champ. |
La réponse indique le nombre d'enregistrements insérés, mis à jour et supprimés, ainsi que le nombre d'échecs.
Avant d'envoyer vos fichiers
Envoyez d'abord le fichier acheteurs, puis le fichier créances. Les créances dont l'acheteur n'existe pas dans Afakto ne sont pas importées.
Le fichier créances doit contenir toutes les pièces ouvertes de chaque société qu'il couvre. Les pièces absentes du fichier sont considérées comme soldées. Voir Fichier créances : toujours envoyer l'ensemble complet.
Le fichier journal client ne peut pas être envoyé via l'API.
Accès et identifiants
L'authentification utilise l'e-mail et le mot de passe d'un compte utilisateur Afakto. Pour une intégration automatisée, demandez à votre administrateur Afakto de créer un compte dédié plutôt que d'utiliser un compte personnel.
Une fois connecté à Afakto, la documentation de l'API est également disponible dans l'application. Vous y verrez comment obtenir un jeton d'authentification et pourrez tester directement des requêtes.
Si vous n'avez pas encore accès à Afakto, contactez votre administrateur Afakto.