eFacture – Provider FTPS : guide à destination des consultants

Ce guide présente le fonctionnement du provider FTPS dans Ammon eFact, à utiliser lors des présentations clients.

Contexte

Ammon eFact échange des fichiers de facturation électronique avec une plateforme agréée (PA).

Par défaut, cet échange passe par Esker (provider standard). Le provider FTPS est l'alternative pour les clients qui ne disposent pas d'un compte Esker : les fichiers transitent alors par un serveur FTP sécurisé (FTPS) hébergé chez le client ou son partenaire PA.

FTPS = FTP sécurisé par TLS. C'est un protocole standard, différent de SFTP (qui repose sur SSH). Seul FTPS est supporté.

Ce que ça change — et ce que ça ne change pas

Ce qui reste identique	Ce qui change
Processus de validation des factures	Canal d'échange avec la PA : dépôt et lecture de fichiers au lieu d'appels API
Règles de gestion, routage, détection des doublons	Paramétrage du provider (serveur, identifiants)
Intégration des factures d'achat, avec leurs documents	Aucun statut n'est échangé avec la PA (voir ci-dessous)
Interface utilisateur Ammon eFact	—

Le client utilise Ammon eFact de la même façon. Seul le canal de transmission vers la PA change — et, point à annoncer dès la présentation, FTPS ne transporte que des factures, jamais de statuts.

Flux échangés

Flux sortant — Vente

Ammon eFact génère la facture de vente et la dépose dans {racine}/ventes/out. Le format est Factur-X (PDF/A-3 embarquant le XML CII) ou CII (XML seul), selon le paramétrage de la plateforme agréée.

Chaque document est un fichier distinct, nommé d'après l'identifiant de la pièce :

la facture électronique ;
le lisible éventuel ;
chaque pièce jointe, suffixée _pj1, _pj2…

Ammon eFact → facture (.xml ou .pdf) [+ lisible] [+ pièces jointes _pjN] → Serveur FTPS → Plateforme agréée récupère

Flux entrant — Achat

La plateforme agréée (ou le fournisseur) dépose les factures d'achat dans {racine}/achats/in. Un fichier = une facture, dans l'un des formats suivants :

Factur-X (PDF/A-3 embarquant le XML CII) ;
CII (XML) ;
UBL Invoice ou UBL CreditNote (XML).

Ce sont les mêmes formats que ceux reçus via Esker. Les pièces jointes reprises sont celles embarquées dans la facture (dans le PDF Factur-X ou dans le XML) : il n'y a pas de fichier compagnon.

À chaque passage du job de récupération des achats, Ammon eFact lit les fichiers de achats/in, intègre les factures, puis déplace chaque fichier intégré dans achats/in/traites.

Plateforme agréée → dépôt facture (.xml ou .pdf) → achats/in → Ammon eFact intègre → achats/in/traites

Statuts — non supportés en FTPS

FTPS n'a pas de canal de cycle de vie :

en vente, aucun retour de la PA ne parvient à Ammon eFact : une facture déposée reste au statut EnCoursDepot ;
en achat, les actions de statut (acceptation, refus, suivi de l'état de transmission) ne sont pas transmises à la PA : Ammon eFact affiche un message « geste non supporté par le provider FTPS ».

Un échange de statuts par fichiers pourra faire l'objet d'une évolution distincte, sur un format à spécifier avec la PA.

Arborescence du serveur FTPS

L'arborescence est fixe — elle n'est pas paramétrable. Sous la racine configurée :

{racine}/
├── ventes/
│   └── out/          ← Ammon eFact dépose les factures de vente
└── achats/
    └── in/           ← La PA dépose les factures d'achat
        └── traites/  ← Ammon eFact y déplace les factures intégrées

ventes/out et achats/in doivent exister. achats/in/traites est créé par Ammon eFact s'il manque, à condition que le compte technique ait le droit de créer un répertoire ; sinon, le créer à l'activation.
Ammon eFact ne supprime jamais un fichier. La purge de achats/in/traites est à la charge du client ou de son partenaire PA.

Stratégie de dépôt — dans les deux sens

Pour éviter qu'un fichier partiellement transféré soit consommé, le fichier est déposé avec l'extension .tmp, puis renommé vers son nom final une fois le transfert complet.

AMMON-2026-000012.xml.tmp  →  AMMON-2026-000012.xml

Vente : Ammon eFact applique cette stratégie.
Achat : Ammon eFact ignore les fichiers .tmp de achats/in. La PA doit donc appliquer la même stratégie, sans quoi une facture en cours de dépôt pourrait être lue tronquée.

Nommage des fichiers

Flux	Fichier	Exemple
Vente — facture	`{IdExterneAmmon}.xml` ou `.pdf`	`AMMON-2026-000012.xml`
Vente — pièce jointe	`{IdExterneAmmon}_pj{n}.{extension}`	`AMMON-2026-000012_pj1.pdf`
Achat — facture	Libre, choisi par la PA (`.xml` ou `.pdf`)	`PA-ACHAT-20260611-0042.pdf`

L'identifiant externe d'une facture de vente transmise en FTPS est FTPS:{nomFichier}. Celui d'une facture d'achat est le nom du fichier déposé.

⚠️ Un nom de fichier d'achat ne doit jamais être réutilisé. Ammon eFact reconnaît une facture d'achat déjà reçue à son nom de fichier : un fichier qui reprend le nom d'une facture déjà intégrée n'est pas intégré, et reste dans achats/in avec un message « La facture existe déjà ». Recommander à la PA un nom unique par facture (numéro de facture, SIREN du fournisseur, horodatage).

Ce que le client doit préparer

Pour activer le provider FTPS, le client (ou son infogéreur) doit fournir :

Information	Exemple
Adresse du serveur FTPS	`ftps.monopca.fr`
Port	`21` : FTPS explicite uniquement, le FTPS implicite (`990`) n'est pas géré
Répertoire racine	`/ammon`
Identifiant de connexion	`ammon-pa`
Mot de passe	(transmis de façon sécurisée)
Certificat SSL du serveur (si autorité privée)	À fournir pour validation TLS

Le serveur FTPS est mis en place et maintenu par le client ou son partenaire PA. Val ne fournit pas ce serveur.

Paramétrage dans Ammon Services

La configuration du provider FTPS se fait dans Ammon Services, dans la section dédiée à la plateforme agréée du client.

L'administrateur renseigne :

Le type de provider : FTPS
L'URL du serveur avec la racine : ftps://ftps.monopca.fr:21/ammon. Sans schéma, ftps:// est pris ; sans port, 21. Une URL invalide est refusée à l'enregistrement, avec son motif. ⚠️ Une URL ftp:// est acceptée mais se connecte sans chiffrement : ne pas l'utiliser.
L'identifiant et le mot de passe (stockés de façon chiffrée)

Une fois le provider activé, Ammon eFact utilise automatiquement le serveur FTPS pour tous les échanges PA de ce client.

Traçabilité

Chaque échange est tracé dans Ammon eFact :

vente : dépôt de chaque fichier, nom et taille ;
achat : listage de achats/in, lecture de chaque fichier (nom et taille), déplacement vers traites ;
date et heure de l'opération ;
statut : succès ou erreur avec message exploitable.

Les identifiants et mots de passe ne sont jamais présents dans les traces.

Gestion des erreurs

Situation	Ce qu'Ammon eFact fait
Serveur FTPS indisponible, identifiants invalides	L'échange échoue avec un message ; il est retenté au passage suivant du traitement, une fois la cause corrigée. En vente, le message de chaque pièce en échec s'affiche sur l'écran de recherche des factures après la transmission
Vente : `425 Can't open data connection`	Le serveur exige la reprise de session TLS sur le canal de données, qu'Ammon eFact ne fait pas encore (voir la checklist). Un fichier `.tmp` peut rester dans `ventes/out` : le supprimer avant de relancer
Fichier d'achat illisible ou d'un format non pris en charge	Fichier signalé dans le compte rendu du job et laissé dans `achats/in` ; les autres factures du lot sont intégrées normalement
Fichier d'achat en cours de dépôt (`.tmp`)	Ignoré jusqu'à son renommage
Nom de fichier d'achat déjà intégré	Non réintégré — message « La facture existe déjà », fichier laissé dans `achats/in`
Facture d'achat en doublon métier (même numéro, même fournisseur, même montant TTC)	Intégrée désactivée, comme avec Esker
Déplacement vers `traites` impossible	Signalé dans le compte rendu ; la facture est intégrée mais le fichier reste dans `achats/in`, et il n'y sera plus déplacé automatiquement (« La facture existe déjà » aux passages suivants) : le déplacer à la main une fois la cause corrigée

Checklist avant activation

[ ] Serveur FTPS en place et accessible depuis les IP Ammon
[ ] FTPS explicite (AUTH TLS) en mode passif : port de contrôle et plage de ports passifs ouverts vers les IP Ammon
[ ] Le serveur n'exige pas la reprise de session TLS sur le canal de données (option active par défaut sur FileZilla Server), tant que le correctif en cours n'est pas livré
[ ] Répertoires créés : ventes/out, achats/in (et achats/in/traites si le compte ne peut pas créer de répertoire)
[ ] Droits du compte technique : écriture et renommage sur ventes/out ; lecture et renommage sur achats/in ; écriture sur achats/in/traites
[ ] Identifiants de connexion disponibles
[ ] Certificat TLS du serveur valide (autorité reconnue ou fourni à Val)
[ ] Avec la PA : dépôt en .tmp puis renommage, un nom de fichier unique par facture d'achat, un format parmi Factur-X, CII, UBL
[ ] Client informé qu'aucun statut n'est échangé en FTPS
[ ] Test de connexion réalisé depuis l'environnement Ammon

Questions fréquentes

Le client peut-il garder Esker en parallèle ? Non. Le provider est configuré par plateforme agréée : soit Esker, soit FTPS. La bascule se fait dans Ammon Services.

FTPS et SFTP, c'est pareil ? Non. FTPS = FTP + TLS. SFTP = protocole SSH. Ammon eFact supporte uniquement FTPS. SFTP fera l'objet d'une évolution distincte.

Qui héberge le serveur FTP ? Le client ou son partenaire PA. Val ne fournit pas ce serveur.

Quel format pour les factures ? En vente, Factur-X ou CII, selon le paramétrage de la plateforme agréée ; chaque pièce jointe est un fichier distinct suffixé _pjN. En achat, Factur-X, CII, UBL Invoice ou UBL CreditNote ; seules les pièces jointes embarquées dans la facture sont reprises.

Les statuts remontent-ils, comme avec Esker ? Non. FTPS ne transporte aucun statut, ni en vente ni en achat. C'est la principale différence fonctionnelle avec Esker.

Ammon eFact supprime-t-il les fichiers du serveur ? Jamais. Les factures d'achat intégrées sont déplacées dans achats/in/traites ; les factures de vente restent dans ventes/out, à charge pour la PA de les récupérer et de faire le ménage.

eFacture – Provider FTPS : guide à destination des consultants ​

Contexte ​

Ce que ça change — et ce que ça ne change pas ​

Flux échangés ​

Flux sortant — Vente ​

Flux entrant — Achat ​

Statuts — non supportés en FTPS ​

Arborescence du serveur FTPS ​

Stratégie de dépôt — dans les deux sens ​

Nommage des fichiers ​

Ce que le client doit préparer ​

Paramétrage dans Ammon Services ​

Traçabilité ​

Gestion des erreurs ​

Checklist avant activation ​

Questions fréquentes ​