Integratie · 2026-07-14
Markdown-exportFacturen via e-mail integreren
Configureer een geverifieerde afzender, stuur naar het algemene postvak met precies één formaatlabel en ontvang bewijsgebonden antwoorden in de oorspronkelijke thread.
Per account ingeschakeld e-mailkanaal
Gebruik dit kanaal voor gecontroleerde factuurstromen met een laag volume.
Factuurconversie via e-mail is in de huidige pilot alleen beschikbaar voor ingeschakelde Enterprise-accounts. U hebt een actief abonnement, ingeschakelde e-mailimport en minstens één geverifieerde afzender nodig.
Stuur naar het algemene postvak einvoice@api.invoice-converter.com met precies één ondersteund label in het onderwerp. Zonder label, of met meerdere labels, wordt niets verwerkt en ontvangt de afzender de geldige labels per e-mail.
Beschikbaarheid
Inschakeling en afzenderverificatie worden tijdens onboarding uitgevoerd. Een normaal account activeert het kanaal niet door alleen een e-mail te sturen.
Afzender vóór de eerste factuur instellen
Voltooi deze stappen in het accountprofiel voordat U een postvak- of ERP-regel automatiseert.
- Vraag het Invoice-Converter-team om het e-mailkanaal voor het Enterprise-account in te schakelen.
- Voeg het afzenderadres toe en voltooi de verificatielink die naar dat postvak wordt gestuurd.
- Kies of antwoorden naar de oorspronkelijke afzender of een geverifieerd collectief adres gaan en selecteer de antwoordtaal.
- Kopieer het algemene postvak uit het profiel, kies een gedocumenteerd label en test elke benodigde route met één representatieve PDF.
Doelformaat kiezen met een onderwerplabel
| Doel | Onderwerplabel | Succesvol antwoord |
|---|---|---|
| XRechnung | [XRechnung] | Gevalideerde XML plus het aan het artefact gebonden HTML-validatierapport. |
| ZUGFeRD / Factur-X | [ZUGFeRD] | Gevalideerde hybride PDF/A-3 plus het aan het artefact gebonden HTML-validatierapport. |
| EN 16931 | [EN16931] | Gevalideerde UBL-XML plus het aan het artefact gebonden HTML-validatierapport. |
| UBL | [UBL] | Gevalideerde UBL-XML plus het aan het artefact gebonden HTML-validatierapport. |
| CII | [CII] | Gevalideerde CII-XML plus het aan het artefact gebonden HTML-validatierapport. |
Van ontvangst tot antwoord
Het kanaal bevestigt de provider snel en voert daarna de strikte conversie asynchroon uit.
- Een geverifieerde afzender stuurt echte PDF-bijlagen naar één of meer formaatspecifieke postvakken.
- De inboundprovider registreert het bericht; de dienst bepaalt het ingeschakelde account, de afzender, antwoordbestemming en de gekozen doelformaten.
- Elke geaccepteerde PDF wordt een strikte conversietaak met verplichte artefactvalidatie en zonder concept- of waarschuwingsoverride.
- De uitvoer wordt pas uitgegeven nadat gezaghebbende validatie, opgeslagen bewijs en artefactpariteit zijn geslaagd.
- Antwoordberichten in dezelfde thread retourneren artefacten en HTML-rapporten; zij worden gesplitst wanneer de bijlagegrootte dat vereist, terwijl bericht, item, gebruiksgebeurtenis, bewijs en duurzame antwoordbestanden via ID’s traceerbaar blijven.
Verbruikseenheden en e-mailcontext
Tel het volledige bericht vóór verzending en behandel de tekst als conversie-invoer.
- Elke geaccepteerde PDF verbruikt één conversie-eenheid per overeenkomend doelformaat. Twee PDF’s naar beide formaatpostbussen vereisen bijvoorbeeld vier eenheden.
- Vóór conversie reserveert de dienst alle eenheden van het bericht: eerst uit de inbegrepen maandelijkse bundel, daarna uit beschikbare API-credits.
- Als er onvoldoende dekking is voor alle eenheden, wordt het hele bericht vóór conversie geweigerd. Alleen geslaagde eenheden worden afgerekend nadat duurzame antwoordartefacten zijn opgeslagen; mislukte eenheden worden vrijgegeven.
- Wanneer berichttekst aanwezig is, zijn het onderwerp en de tekst van de geverifieerde e-mail aanvullende conversie-invoer. Zij kunnen ontbrekende wijzigingen, correcties, referenties of factuurgegevens leveren. Bij conflicten hebben geldbedragen, belastingtotalen en factuurregels uit de PDF voorrang; e-mailtekst alleen kan geen factuurregels maken. De e-mailcontext is begrensd en kan worden ingekort; houd handtekeningen en begeleidende tekst daarom beknopt, relevant en ondubbelzinnig.
- Als standaardgebruik is ingeschakeld, vervangt elke verkopersprofielwaarde (naam, adres, btw-nummer, contact) de overeenkomstige waarde uit de PDF. Een verschil geeft een waarschuwing, geen blokkering.
Eindtoestanden en artefacten
| Resultaat | Inhoud van het antwoord | Bijlagen |
|---|---|---|
| Uitgegeven | Het bestand is voltooid en de gezaghebbende validatie is geslaagd. | Het gevraagde hoofdartefact en bijbehorend HTML-validatierapport. |
| Gedeeltelijk | Minstens één bestand is voltooid en minstens één is mislukt of overgeslagen. | Alleen bewijsgebonden artefacten van voltooide bestanden en de status per bestand. |
| Validatie gestopt | Blokkerende validatiedetails verklaren waarom uitgifte is gestopt. | Geen ongevalideerd resultaat en geen artefactgebonden HTML-rapport. |
| Technische afwijzing | Het antwoord benoemt het probleem met afzender, bestand, recht, limiet of verwerking. | Geen resultaat; volg de aanwijzingen voordat U opnieuw probeert. |
Geaccepteerde bestanden en pilotlimieten
Gebruik deze punten als praktische controles voor deze sectie.
- Voeg echte PDF-bestanden toe. Een hernoemde afbeelding of ander document wordt geweigerd, ook wanneer extensie of MIME-type PDF aangeeft.
- Een bericht kan meerdere PDF’s bevatten, maar het kanaal is bedoeld voor gecontroleerde stromen met laag volume, niet voor bulkimport.
- Houd elke bijlage onder de tijdens onboarding genoemde limiet; provider- en omgevingslimieten kunnen wijzigen.
- Bereikt één bericht meerdere herkende formaatpostvakken, dan wordt elke geaccepteerde PDF één keer per gekozen formaat verwerkt.
- Antwoordbijlagen worden gegroepeerd met een drempel van 15 MB per bericht. Als een volgend bestand die drempel zou overschrijden, gaan de resterende bijlagen verder in een ander bericht in dezelfde thread; een afzonderlijk bestand wordt niet gesplitst.
Wat nog menselijke controle vereist
Gebruik deze punten als praktische controles voor deze sectie.
- Vergelijk leverancier, koper, factuurnummer, datums, valuta, belasting, totalen, betalingsgegevens en elke regel met de bronfactuur.
- Bevestig ontvangerspecifieke routeringsreferenties, endpoint-ID’s, bestelgegevens en regels van het afleveringskanaal.
- Controleer bronbewijs met lage zekerheid en elke waarschuwing of validatiedetail voordat U het resultaat doorstuurt.
- Succesvolle technische validatie bewijst het uitgegeven bestand tegen de gekozen regels; zij vervangt geen commerciële, fiscale of ontvangersgoedkeuring.
Kies bewust voor e-mail of API
| Kanaal | Beste toepassing | Integratiecontrole |
|---|---|---|
| E-mailkanaal | Menselijke of postvakregelstromen met laag volume waarbij een antwoordthread nuttig is. | Formaatpostvak, geverifieerde afzender, retouradres, antwoordtaal en resultaat per bericht. |
| External API V1 | Server-naar-serverstromen die idempotentie, polling, gestructureerde status en expliciete downloadcontrole nodig hebben. | Geauthenticeerde verzoeken, klantreferenties, correlatie-ID’s, limietheaders en artefact-endpoints. |
Onboarding en ondersteuning
Deel tijdens onboarding verwachte afzenders, doelformaten, antwoordbestemming, taal en maandvolume.
Stroomdiagrammen
De diagrammen vatten hetzelfde contract samen als de doorzoekbare secties hierboven.
Wat de conversie ingaat en wat U terugkrijgt
Wat erin gaat
PDF-bijlage
Primaire bronWordt zowel via de tekstlaag als met OCR gelezen. Geldbedragen, belastingtotalen en factuurregels komen altijd uit de PDF.
Onderwerp en tekst van de e-mail
AanvullendGeverifieerde e-mailtekst kan referenties, correcties en ontbrekende gegevens leveren. Deze overschrijft nooit PDF-bedragen en kan geen factuurregels aanmaken.
Stamgegevens uit het profiel
Vult hiatenAls standaardgebruik is ingeschakeld, vervangt elke opgeslagen verkopersprofielwaarde (naam, adres, btw-nummer, contact) de overeenkomstige geëxtraheerde waarde. Een verschil geeft een waarschuwing, geen blokkering.
Strikte conversie
Extractie, verrijking en gezaghebbende validatie met bewijs- en pariteitscontroles.
Wat U terugkrijgt
Gevalideerd artefact
XRechnung-XML of hybride ZUGFeRD-/Factur-X-PDF/A-3, afhankelijk van het gebruikte postvak.
HTML-validatierapport
Het artefactgebonden rapport bewijst de validatie van precies het geleverde bestand.
Antwoord in uw thread
Alles komt aan als antwoord op uw oorspronkelijke bericht.
Van postvak naar bewezen antwoord
Geverifieerde afzender
Een ingeschakeld account stuurt echte PDF’s.
Formaatpostvak
Het ontvangeradres kiest XRechnung of ZUGFeRD.
Strikte taak
Extractie en generatie draaien zonder conceptoverride.
Bewijspoort
Validatie, bewijsopslag en pariteit moeten slagen.
Antwoordthread
Artefact en rapport keren in één of meer berichten terug; groottesplitsing blijft in de thread.
Elke eindtoestand
- Uitgegeven
Artefact plus rapport
Alleen bewijsgebonden bytes worden bijgevoegd.
- Gedeeltelijk
Succesvolle bestanden blijven behouden
Artefacten en bestandsfouten delen dezelfde antwoordthread.
- Validatie gestopt
Details, geen artefact
Blokkerende regels stoppen ongevalideerde uitvoer.
- Technische afwijzing
Uitvoerbaar pad voor herhaling
Het antwoord zegt wat U moet wijzigen of herhalen.