Aller au contenu principal

Intégration · 2026-08-07

Export Markdown

Intégrer les factures par e-mail

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

CibleBalise dans l’objetRé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ésultatContenu de la réponsePièces jointes
ÉmisLe fichier est terminé et la validation faisant autorité a réussi.Artefact principal demandé et rapport HTML correspondant.
PartielAu 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éeLes 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 techniqueLa 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

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

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

CanalUsage adaptéContrôle d’intégration
Canal e-mailFlux 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 V1Flux 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.

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 principale

    Lue à 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émentaire

    Le 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 champs

    Lorsque l’utilisation par défaut est activée, chaque valeur enregistrée du profil vendeur (nom, adresse, numéro de TVA, contact) remplace la valeur extraite correspondante. Une différence crée un avertissement, pas un blocage.

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

  1. Expéditeur vérifié

    Un compte activé envoie de vrais PDF.

  2. Boîte de format

    L’adresse choisit XRechnung ou ZUGFeRD.

  3. Tâche stricte

    Extraction et génération fonctionnent sans dérogation de brouillon.

  4. Porte de preuve

    Validation, persistance de preuve et parité doivent réussir.

  5. Réponse dans le fil

    Artefact et rapport reviennent dans un ou plusieurs messages; le fractionnement reste dans le fil.

Chaque état final

Résultat de conversion stricte
  • É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.