# Intégrer les factures par e-mail

- 2026-08-07

Configurez un expéditeur vérifié, envoyez à la boîte générique avec exactement une balise de format et recevez des réponses adossées à une preuve dans le fil d’origine.

## Import par e-mail pour chaque compte Enterprise

Utilisez ce canal pour des flux de factures contrôlés et de faible volume.

L’import par e-mail est inclus dans chaque abonnement Enterprise actif. Activez-le dans le profil et vérifiez au moins un expéditeur avant la première facture.

Envoyez à la boîte générique einvoice@api.invoice-converter.com avec exactement une balise prise en charge dans l’objet. Sans balise, ou avec plusieurs balises, rien n’est traité et l’expéditeur reçoit les balises valides par e-mail.

> **Disponibilité**: Aucune liste d’autorisation de compte ni approbation manuelle n’est requise. L’accès Enterprise, le réglage du profil et la vérification de l’expéditeur protègent toujours le canal.

## 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.

1. Démarrez un abonnement Enterprise et activez l’import par e-mail dans le profil.
2. Ajoutez l’adresse d’envoi et ouvrez le lien de vérification reçu dans cette boîte.
3. Choisissez un retour vers l’expéditeur initial ou une adresse collective vérifiée, puis sélectionnez la langue de réponse.
4. Copiez la boîte générique du profil, choisissez une balise documentée et testez chaque route nécessaire avec un PDF représentatif.

## Choisir le format cible avec une balise dans l’objet

| Cible | Balise dans l’objet | Réponse réussie |
| --- | --- | --- |
| XRechnung | [XRechnung] | XML validé et rapport HTML de validation lié à l’artefact. |
| ZUGFeRD / Factur-X | [ZUGFeRD] | PDF/A-3 hybride validé et rapport HTML de validation lié à l’artefact. |
| EN 16931 | [EN16931] | XML UBL validé et rapport HTML de validation lié à l’artefact. |
| UBL | [UBL] | XML UBL validé et rapport HTML de validation lié à l’artefact. |
| CII | [CII] | XML CII 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.

1. Un expéditeur vérifié envoie de vraies pièces jointes PDF à une ou plusieurs boîtes propres au format.
2. 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.
3. Chaque PDF accepté devient une tâche stricte avec validation d’artefact obligatoire, sans remplacement de brouillon ni d’avertissement.
4. La sortie n’est émise qu’après validation faisant autorité, preuve persistée et contrôle de parité de l’artefact.
5. 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é.
- Lorsque l’utilisation par défaut est activée, chaque valeur du profil vendeur (nom, adresse, numéro de TVA, contact) remplace la valeur correspondante extraite du PDF. Une différence crée un avertissement, pas un blocage.

## É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 service

- 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 10 MB; les limites du fournisseur peuvent être inférieures et é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

- 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. |

## Configuration et assistance

Configurez les expéditeurs, formats, destination de réponse et langue dans le profil.

- [Consulter la documentation External API V1](/developer-api)
- [Activer Enterprise avec import par e-mail](/pricing)