{"info":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","description":"

Every e-invoice you receive, as one JSON.

\n

POST an XRechnung, ZUGFeRD/Factur-X, Peppol, FatturaPA or KSeF file — XML or hybrid PDF — and get canonical EN 16931 JSON, a validation report with plain-language fix hints, a readable PDF, and CSV or DATEV exports. One stateless endpoint per output, nothing stored.

\n

Try it now. Every request below already carries a real XRechnung 3.0 invoice in its body, so Send works immediately: the demo quota is 20 invoices per IP per day and needs no key.

\n

With a key. Set the collection variable apiKey; it is sent as x-api-key. A trial key is 100 invoices over 30 days — invoicein.peculiar.systems.

\n

One invoice = one credit whatever outputs you ask for. A file carrying several invoices (a FatturaPA lot) costs one per invoice.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"58098057","collectionId":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","publishedId":"2sBYAxRVjo","public":true,"customColor":{"top-bar":"FDFCF8","right-sidebar":"303030","highlight":"0F766E"},"publishDate":"2026-09-09T17:08:37.000Z"},"item":[{"name":"1 · Everything in one call","id":"56cf4a97-fabe-4dd8-8776-c19ecb4fec62","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0\n urn:fdc:peppol.eu:2017:poacc:billing:01:1.0\n RE-2026-0421\n 2026-08-30\n 2026-09-29\n 380\n EUR\n 04011000-12345-03\n \n \n rechnung@nordlicht-werkstatt.de\n \n Kanalstraße 12\n Kiel\n 24103\n DE\n \n \n DE123456789\n VAT\n \n \n Nordlicht Werkstatt GmbH\n \n \n Buchhaltung\n +49 431 0000000\n rechnung@nordlicht-werkstatt.de\n \n \n \n \n \n ap@beispiel-bau.de\n \n Hafenweg 3\n Hamburg\n 20095\n DE\n \n \n Beispiel Bau AG\n \n \n \n \n 58\n \n DE02120300000000202051\n Nordlicht Werkstatt GmbH\n \n \n Zahlbar innerhalb 30 Tagen ohne Abzug.\n \n 59.82\n \n 314.86\n 59.82\n \n S\n 19\n VAT\n \n \n \n \n 314.86\n 314.86\n 374.68\n 374.68\n \n \n 1\n 3.5\n 314.86\n \n Wartung Lüftungsanlage\n \n S\n 19\n VAT\n \n \n 89.96\n \n","options":{"raw":{"language":"xml"}}},"url":"https://invoicein-api.peculiar.systems/v1/invoice?include=validation&lang=en","description":"

POST any received e-invoice and get canonical EN 16931 JSON plus a validation report with plain-language fix hints.

\n

The body below is a real XRechnung 3.0 (UBL) invoice, so you can press Send straight away — no key needed, 20 invoices per IP per day. Replace it with your own XRechnung, ZUGFeRD/Factur-X, Peppol, FatturaPA or KSeF file; a hybrid PDF goes in the same way with Content-Type application/pdf.

\n

Nothing is stored: the file is parsed in memory and discarded with the response.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","invoice"],"host":["https://invoicein-api.peculiar.systems"],"query":[{"description":{"content":"

Extras to add: validation, html, pdf, csv, datev (comma separated).

\n","type":"text/plain"},"key":"include","value":"validation"},{"description":{"content":"

Language of the fix hints: en, de, pl, it, fr.

\n","type":"text/plain"},"key":"lang","value":"en"}],"variable":[]}},"response":[],"_postman_id":"56cf4a97-fabe-4dd8-8776-c19ecb4fec62"},{"name":"2 · Validation report only","id":"171463a9-176a-4965-bacb-1d597851b42d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0\n urn:fdc:peppol.eu:2017:poacc:billing:01:1.0\n RE-2026-0421\n 2026-08-30\n 2026-09-29\n 380\n EUR\n 04011000-12345-03\n \n \n rechnung@nordlicht-werkstatt.de\n \n Kanalstraße 12\n Kiel\n 24103\n DE\n \n \n DE123456789\n VAT\n \n \n Nordlicht Werkstatt GmbH\n \n \n Buchhaltung\n +49 431 0000000\n rechnung@nordlicht-werkstatt.de\n \n \n \n \n \n ap@beispiel-bau.de\n \n Hafenweg 3\n Hamburg\n 20095\n DE\n \n \n Beispiel Bau AG\n \n \n \n \n 58\n \n DE02120300000000202051\n Nordlicht Werkstatt GmbH\n \n \n Zahlbar innerhalb 30 Tagen ohne Abzug.\n \n 59.82\n \n 314.86\n 59.82\n \n S\n 19\n VAT\n \n \n \n \n 314.86\n 314.86\n 374.68\n 374.68\n \n \n 1\n 3.5\n 314.86\n \n Wartung Lüftungsanlage\n \n S\n 19\n VAT\n \n \n 89.96\n \n","options":{"raw":{"language":"xml"}}},"url":"https://invoicein-api.peculiar.systems/v1/validate?lang=en","description":"

The findings without the invoice body — official rule sets (EN 16931, XRechnung/KoSIT, Peppol, FatturaPA, KSeF) plus arithmetic cross-checks, each with the field and a fix.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","validate"],"host":["https://invoicein-api.peculiar.systems"],"query":[{"description":{"content":"

Language of the fix hints: en, de, pl, it, fr.

\n","type":"text/plain"},"key":"lang","value":"en"}],"variable":[]}},"response":[],"_postman_id":"171463a9-176a-4965-bacb-1d597851b42d"},{"name":"3 · Canonical JSON only","id":"8defb847-baaa-4a90-9d2f-ec2a31d24197","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0\n urn:fdc:peppol.eu:2017:poacc:billing:01:1.0\n RE-2026-0421\n 2026-08-30\n 2026-09-29\n 380\n EUR\n 04011000-12345-03\n \n \n rechnung@nordlicht-werkstatt.de\n \n Kanalstraße 12\n Kiel\n 24103\n DE\n \n \n DE123456789\n VAT\n \n \n Nordlicht Werkstatt GmbH\n \n \n Buchhaltung\n +49 431 0000000\n rechnung@nordlicht-werkstatt.de\n \n \n \n \n \n ap@beispiel-bau.de\n \n Hafenweg 3\n Hamburg\n 20095\n DE\n \n \n Beispiel Bau AG\n \n \n \n \n 58\n \n DE02120300000000202051\n Nordlicht Werkstatt GmbH\n \n \n Zahlbar innerhalb 30 Tagen ohne Abzug.\n \n 59.82\n \n 314.86\n 59.82\n \n S\n 19\n VAT\n \n \n \n \n 314.86\n 314.86\n 374.68\n 374.68\n \n \n 1\n 3.5\n 314.86\n \n Wartung Lüftungsanlage\n \n S\n 19\n VAT\n \n \n 89.96\n \n","options":{"raw":{"language":"xml"}}},"url":"https://invoicein-api.peculiar.systems/v1/parse","description":"

The invoice as one shape for every input syntax, fields named by the semantic model (BT/BG numbers). No validation, so it is the fastest call.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","parse"],"host":["https://invoicein-api.peculiar.systems"],"query":[],"variable":[]}},"response":[],"_postman_id":"8defb847-baaa-4a90-9d2f-ec2a31d24197"},{"name":"4 · Human-readable HTML","id":"3eedb164-dfb4-498a-bc7d-39a6d4e030f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0\n urn:fdc:peppol.eu:2017:poacc:billing:01:1.0\n RE-2026-0421\n 2026-08-30\n 2026-09-29\n 380\n EUR\n 04011000-12345-03\n \n \n rechnung@nordlicht-werkstatt.de\n \n Kanalstraße 12\n Kiel\n 24103\n DE\n \n \n DE123456789\n VAT\n \n \n Nordlicht Werkstatt GmbH\n \n \n Buchhaltung\n +49 431 0000000\n rechnung@nordlicht-werkstatt.de\n \n \n \n \n \n ap@beispiel-bau.de\n \n Hafenweg 3\n Hamburg\n 20095\n DE\n \n \n Beispiel Bau AG\n \n \n \n \n 58\n \n DE02120300000000202051\n Nordlicht Werkstatt GmbH\n \n \n Zahlbar innerhalb 30 Tagen ohne Abzug.\n \n 59.82\n \n 314.86\n 59.82\n \n S\n 19\n VAT\n \n \n \n \n 314.86\n 314.86\n 374.68\n 374.68\n \n \n 1\n 3.5\n 314.86\n \n Wartung Lüftungsanlage\n \n S\n 19\n VAT\n \n \n 89.96\n \n","options":{"raw":{"language":"xml"}}},"url":"https://invoicein-api.peculiar.systems/v1/render.html?lang=en","description":"

The same A4 layout for every syntax — for an approver who wants to see the invoice rather than the XML.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","render.html"],"host":["https://invoicein-api.peculiar.systems"],"query":[{"description":{"content":"

Language of the fix hints: en, de, pl, it, fr.

\n","type":"text/plain"},"key":"lang","value":"en"}],"variable":[]}},"response":[],"_postman_id":"3eedb164-dfb4-498a-bc7d-39a6d4e030f2"},{"name":"5 · Human-readable PDF","id":"19773915-0205-41f1-887d-8461e9ce53a1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0\n urn:fdc:peppol.eu:2017:poacc:billing:01:1.0\n RE-2026-0421\n 2026-08-30\n 2026-09-29\n 380\n EUR\n 04011000-12345-03\n \n \n rechnung@nordlicht-werkstatt.de\n \n Kanalstraße 12\n Kiel\n 24103\n DE\n \n \n DE123456789\n VAT\n \n \n Nordlicht Werkstatt GmbH\n \n \n Buchhaltung\n +49 431 0000000\n rechnung@nordlicht-werkstatt.de\n \n \n \n \n \n ap@beispiel-bau.de\n \n Hafenweg 3\n Hamburg\n 20095\n DE\n \n \n Beispiel Bau AG\n \n \n \n \n 58\n \n DE02120300000000202051\n Nordlicht Werkstatt GmbH\n \n \n Zahlbar innerhalb 30 Tagen ohne Abzug.\n \n 59.82\n \n 314.86\n 59.82\n \n S\n 19\n VAT\n \n \n \n \n 314.86\n 314.86\n 374.68\n 374.68\n \n \n 1\n 3.5\n 314.86\n \n Wartung Lüftungsanlage\n \n S\n 19\n VAT\n \n \n 89.96\n \n","options":{"raw":{"language":"xml"}}},"url":"https://invoicein-api.peculiar.systems/v1/render.pdf?lang=en","description":"

As above, as a PDF/A4 file.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","render.pdf"],"host":["https://invoicein-api.peculiar.systems"],"query":[{"description":{"content":"

Language of the fix hints: en, de, pl, it, fr.

\n","type":"text/plain"},"key":"lang","value":"en"}],"variable":[]}},"response":[],"_postman_id":"19773915-0205-41f1-887d-8461e9ce53a1"},{"name":"6 · CSV export","id":"dd62e43d-7b03-4920-a5b1-eab5fdb659b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0\n urn:fdc:peppol.eu:2017:poacc:billing:01:1.0\n RE-2026-0421\n 2026-08-30\n 2026-09-29\n 380\n EUR\n 04011000-12345-03\n \n \n rechnung@nordlicht-werkstatt.de\n \n Kanalstraße 12\n Kiel\n 24103\n DE\n \n \n DE123456789\n VAT\n \n \n Nordlicht Werkstatt GmbH\n \n \n Buchhaltung\n +49 431 0000000\n rechnung@nordlicht-werkstatt.de\n \n \n \n \n \n ap@beispiel-bau.de\n \n Hafenweg 3\n Hamburg\n 20095\n DE\n \n \n Beispiel Bau AG\n \n \n \n \n 58\n \n DE02120300000000202051\n Nordlicht Werkstatt GmbH\n \n \n Zahlbar innerhalb 30 Tagen ohne Abzug.\n \n 59.82\n \n 314.86\n 59.82\n \n S\n 19\n VAT\n \n \n \n \n 314.86\n 314.86\n 374.68\n 374.68\n \n \n 1\n 3.5\n 314.86\n \n Wartung Lüftungsanlage\n \n S\n 19\n VAT\n \n \n 89.96\n \n","options":{"raw":{"language":"xml"}}},"url":"https://invoicein-api.peculiar.systems/v1/export.csv?level=lines","description":"

Flat CSV — one row per line item, or one per document with level=documents.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","export.csv"],"host":["https://invoicein-api.peculiar.systems"],"query":[{"description":{"content":"

lines or documents

\n","type":"text/plain"},"key":"level","value":"lines"}],"variable":[]}},"response":[],"_postman_id":"dd62e43d-7b03-4920-a5b1-eab5fdb659b5"},{"name":"7 · DATEV Buchungsstapel","id":"24899cd0-cea2-4340-8c0b-c3a09c89bfc5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0\n urn:fdc:peppol.eu:2017:poacc:billing:01:1.0\n RE-2026-0421\n 2026-08-30\n 2026-09-29\n 380\n EUR\n 04011000-12345-03\n \n \n rechnung@nordlicht-werkstatt.de\n \n Kanalstraße 12\n Kiel\n 24103\n DE\n \n \n DE123456789\n VAT\n \n \n Nordlicht Werkstatt GmbH\n \n \n Buchhaltung\n +49 431 0000000\n rechnung@nordlicht-werkstatt.de\n \n \n \n \n \n ap@beispiel-bau.de\n \n Hafenweg 3\n Hamburg\n 20095\n DE\n \n \n Beispiel Bau AG\n \n \n \n \n 58\n \n DE02120300000000202051\n Nordlicht Werkstatt GmbH\n \n \n Zahlbar innerhalb 30 Tagen ohne Abzug.\n \n 59.82\n \n 314.86\n 59.82\n \n S\n 19\n VAT\n \n \n \n \n 314.86\n 314.86\n 374.68\n 374.68\n \n \n 1\n 3.5\n 314.86\n \n Wartung Lüftungsanlage\n \n S\n 19\n VAT\n \n \n 89.96\n \n","options":{"raw":{"language":"xml"}}},"url":"https://invoicein-api.peculiar.systems/v1/export.datev?skr=03&creditor_account=70000","description":"

EXTF 700 booking batch (cp1252) for the incoming invoice.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","export.datev"],"host":["https://invoicein-api.peculiar.systems"],"query":[{"description":{"content":"

Chart of accounts: 03 or 04.

\n","type":"text/plain"},"key":"skr","value":"03"},{"description":{"content":"

Creditor account number, 4-9 digits.

\n","type":"text/plain"},"key":"creditor_account","value":"70000"}],"variable":[]}},"response":[],"_postman_id":"24899cd0-cea2-4340-8c0b-c3a09c89bfc5"},{"name":"8 · Supported formats","id":"ffa2b2e2-ff5f-423d-9546-b30a70ad9613","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://invoicein-api.peculiar.systems/v1/formats","description":"

Every input format and rule-set version currently accepted, plus the languages the fix hints are available in.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","formats"],"host":["https://invoicein-api.peculiar.systems"],"query":[],"variable":[]}},"response":[],"_postman_id":"ffa2b2e2-ff5f-423d-9546-b30a70ad9613"},{"name":"9 · Explain a rule id","id":"2598d1d0-6bbb-414a-9706-eed90390dd37","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://invoicein-api.peculiar.systems/v1/rules/BR-DE-1?lang=en","description":"

Plain-language explanation for any rule id from a validation report — the same text that backs invoicein.peculiar.systems/rules.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","rules","BR-DE-1"],"host":["https://invoicein-api.peculiar.systems"],"query":[{"description":{"content":"

Language of the fix hints: en, de, pl, it, fr.

\n","type":"text/plain"},"key":"lang","value":"en"}],"variable":[]}},"response":[],"_postman_id":"2598d1d0-6bbb-414a-9706-eed90390dd37"},{"name":"10 · Canonical field guide","id":"ae2b85c6-e129-4e56-92e8-cd6e123826a5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://invoicein-api.peculiar.systems/v1/schema","description":"

Every field of the canonical JSON with its BT/BG number.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","id":"bb956b1b-2e7a-4ad4-a36f-b625296f0ec3","name":"InvoiceIn — inbound e-invoice API","type":"collection"}},"urlObject":{"path":["v1","schema"],"host":["https://invoicein-api.peculiar.systems"],"query":[],"variable":[]}},"response":[],"_postman_id":"ae2b85c6-e129-4e56-92e8-cd6e123826a5"}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]}},"variable":[{"key":"baseUrl","value":"https://invoicein-api.peculiar.systems","description":"API base URL."},{"key":"apiKey","value":"","description":"Optional. Leave empty to use the keyless demo quota (20 invoices/IP/day)."}]}