Intégration · 2026-07-10
Export MarkdownIntégrer les factures par e-mail
Configurez un expéditeur vérifié, utilisez la boîte propre au format affichée dans votre profil et recevez des messages de réponse adossés à une preuve dans le fil d’origine, fractionnés seulement si la taille des pièces jointes l’exige.
Canal e-mail activé par compte
Utilisez ce canal pour des flux de factures contrôlés et de faible volume.
La conversion par e-mail est réservée aux comptes Enterprise activés dans le pilote actuel. Un abonnement actif, l’import e-mail activé et au moins un expéditeur vérifié sont requis.
Les adresses propres aux formats affichées dans votre profil font foi. Elles peuvent varier selon l’environnement; ne codez donc pas en dur une adresse reprise d’un exemple ou d’une documentation interne.
Disponibilité
L’activation et la vérification des expéditeurs sont réalisées pendant l’intégration. Un compte ordinaire n’active pas le canal en envoyant simplement un e-mail.
Préparer l’expéditeur avant la première facture
Effectuez ces étapes dans le profil avant d’automatiser une boîte ou une règle ERP.
- Demandez à l’équipe Invoice-Converter d’activer le canal e-mail pour le compte Enterprise.
- Ajoutez l’adresse d’envoi et ouvrez le lien de vérification reçu dans cette boîte.
- Choisissez un retour vers l’expéditeur initial ou une adresse collective vérifiée, puis sélectionnez la langue de réponse.
- Copiez les adresses XRechnung et ZUGFeRD du profil et testez chaque route nécessaire avec un PDF représentatif.
Choisir le format cible par l’adresse destinataire
| Cible | Adresse à utiliser | Réponse réussie |
|---|---|---|
| XRechnung | La boîte XRechnung affichée dans le profil activé. | XML validé et rapport HTML de validation lié à l’artefact. |
| ZUGFeRD / Factur-X | La boîte ZUGFeRD affichée dans le profil activé. | PDF/A-3 hybride validé et rapport HTML de validation lié à l’artefact. |
De la réception à la réponse
Le canal accuse rapidement réception auprès du fournisseur, puis exécute la conversion stricte de façon asynchrone.
- Un expéditeur vérifié envoie de vraies pièces jointes PDF à une ou plusieurs boîtes propres au format.
- Le fournisseur entrant enregistre le message; le service résout le compte activé, l’expéditeur, la destination de réponse et les formats cibles sélectionnés.
- Chaque PDF accepté devient une tâche stricte avec validation d’artefact obligatoire, sans remplacement de brouillon ni d’avertissement.
- La sortie n’est émise qu’après validation faisant autorité, preuve persistée et contrôle de parité de l’artefact.
- Des messages de réponse dans le même fil renvoient les artefacts et rapports HTML; ils sont fractionnés si la taille des pièces jointes l’exige, tandis que message, élément, événement d’usage, preuve et fichiers de réponse durables restent traçables par identifiant.
Unités de facturation et contexte de l’e-mail
Comptez le message entier avant l’envoi et traitez son texte comme une entrée de conversion.
- Chaque PDF accepté consomme une unité de conversion par format cible correspondant. Par exemple, deux PDF envoyés aux deux boîtes de format nécessitent quatre unités.
- Avant la conversion, le service réserve toutes les unités du message: d’abord sur le quota mensuel inclus, puis sur les crédits API disponibles.
- Si la couverture ne suffit pas pour toutes les unités, le message entier est rejeté avant conversion. Seules les unités réussies sont débitées après stockage durable des artefacts de réponse; les unités échouées sont libérées.
- Lorsqu’un corps de message est présent, l’objet et le corps de l’e-mail vérifié sont des entrées de conversion complémentaires. Ils peuvent fournir des modifications, corrections, références ou données de facture manquantes. En cas de conflit, les montants, totaux de taxe et lignes du PDF prévalent; le texte de l’e-mail seul ne peut pas créer de lignes de facture. Le contexte e-mail est limité et peut être tronqué; gardez donc signatures et texte d’accompagnement concis, pertinents et sans ambiguïté.
- Les données de base vendeur enregistrées dans votre profil complètent les champs vendeur manquants (nom, adresse, numéro de TVA, contact) lorsque l’utilisation par défaut est activée; elles n’écrasent jamais les valeurs extraites du PDF.
États finaux et artefacts
| Résultat | Contenu de la réponse | Pièces jointes |
|---|---|---|
| Émis | Le fichier est terminé et la validation faisant autorité a réussi. | Artefact principal demandé et rapport HTML correspondant. |
| Partiel | Au moins un fichier a réussi et au moins un autre a échoué ou été ignoré. | Uniquement les artefacts prouvés des fichiers terminés et le statut de chaque fichier. |
| Validation arrêtée | Les détails bloquants expliquent pourquoi l’émission s’est arrêtée. | Aucun résultat non vérifié et aucun rapport HTML lié à un artefact. |
| Rejet technique | La réponse identifie le problème d’expéditeur, de fichier, de droit, de limite ou de traitement. | Aucun résultat; suivez les indications avant de réessayer. |
Fichiers acceptés et limites du pilote
Utilisez ces points comme contrôles pratiques pour cette section.
- Joignez de vrais fichiers PDF. Une image renommée ou un autre document est refusé même si son extension ou son type MIME indique PDF.
- Un message peut contenir plusieurs PDF, mais le canal vise des flux contrôlés de faible volume, pas une ingestion en masse.
- Gardez chaque pièce jointe sous la limite communiquée lors de l’intégration; les limites du fournisseur et de l’environnement peuvent évoluer.
- Si un message atteint plusieurs boîtes de format reconnues, chaque PDF accepté est traité une fois par format sélectionné.
- Les pièces jointes de réponse sont groupées selon un seuil de 15 Mo par message. Si l’ajout d’un fichier dépasse ce seuil, les pièces restantes continuent dans un autre message du même fil; un fichier individuel n’est pas fractionné.
Ce qui exige encore une revue humaine
Utilisez ces points comme contrôles pratiques pour cette section.
- Comparez fournisseur, acheteur, numéro, dates, devise, taxe, totaux, paiement et chaque ligne avec la facture source.
- Confirmez les références de routage, identifiants de point d’accès, commandes et règles de canal propres au destinataire.
- Examinez les preuves source peu fiables et chaque avertissement ou détail de validation avant de transmettre le résultat.
- Une validation technique réussie prouve le fichier émis selon les règles choisies; elle ne remplace pas l’approbation commerciale, fiscale ou du destinataire.
Choisir délibérément e-mail ou API
| Canal | Usage adapté | Contrôle d’intégration |
|---|---|---|
| Canal e-mail | Flux humains ou règles de boîte de faible volume pour lesquels le fil de réponse est utile. | Boîte de format, expéditeur vérifié, adresse de retour, langue et résultat par message. |
| External API V1 | Flux serveur à serveur nécessitant idempotence, interrogation, statut structuré et contrôle explicite du téléchargement. | Requêtes authentifiées, références client, identifiants de corrélation, en-têtes de limite et points d’accès aux artefacts. |
Intégration et assistance
Communiquez les expéditeurs attendus, formats cibles, destination de réponse, langue et volume mensuel pendant l’intégration.
Schémas de flux
Les schémas résument le même contrat que les sections consultables ci-dessus.
Ce qui entre dans la conversion et ce que vous recevez
Ce qui entre
Pièce jointe PDF
Source principaleLue à la fois via sa couche texte et par OCR. Les montants, totaux de taxe et lignes de facture proviennent toujours du PDF.
Objet et corps de l’e-mail
ComplémentaireLe texte vérifié peut fournir références, corrections et données manquantes. Il ne remplace jamais les montants du PDF et ne peut pas créer de lignes de facture.
Données de base du profil
Complète les champsLes données de base vendeur enregistrées dans votre profil (nom, adresse, numéro de TVA, contact) complètent les champs vendeur manquants lorsque l’utilisation par défaut est activée; elles n’écrasent pas les valeurs extraites.
Conversion stricte
Extraction, enrichissement et validation autoritaire avec contrôles de preuve et de parité.
Ce que vous recevez
Artefact validé
XML XRechnung ou PDF/A-3 hybride ZUGFeRD / Factur-X, selon la boîte utilisée.
Rapport de validation HTML
Le rapport lié à l’artefact prouve la validation du fichier livré.
Réponse dans votre fil
Tout arrive en réponse à votre message d’origine.
De la boîte à la réponse prouvée
Expéditeur vérifié
Un compte activé envoie de vrais PDF.
Boîte de format
L’adresse choisit XRechnung ou ZUGFeRD.
Tâche stricte
Extraction et génération fonctionnent sans dérogation de brouillon.
Porte de preuve
Validation, persistance de preuve et parité doivent réussir.
Réponse dans le fil
Artefact et rapport reviennent dans un ou plusieurs messages; le fractionnement reste dans le fil.
Chaque état final
- Émis
Artefact et rapport
Seuls les octets adossés à une preuve sont joints.
- Partiel
Les succès sont conservés
Artefacts terminés et erreurs partagent le fil de réponse.
- Validation arrêtée
Détails, aucun artefact
Les règles bloquantes empêchent toute sortie non vérifiée.
- Rejet technique
Nouvel essai exploitable
La réponse explique quoi modifier ou réessayer.