InvoiceIn

io.github.peculiar-systems由 GitHub 帳號 peculiar-systems 發布v0.1.3更新於 Nov 2, 2026

XRechnung, Factur-X, Peppol, PINT AE, FatturaPA, KSeF → JSON + fix hints. Hosted; MIT=examples only

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

託管式 MCP 伺服器,用來解析並驗證收到的歐洲與阿聯酋電子發票,輸出正規化的 EN 16931 JSON、驗證結果、HTML、CSV 或 DATEV 匯出。

可以做什麼
  • 將單張電子發票解析為正規化 EN 16931 JSON,包含賣方、買方、明細行、合計與付款資訊
  • 依官方規則集(XSD、EN 16931、XRechnung、Peppol BIS、PINT AE、FatturaPA、KSeF、算術檢查)驗證發票並列出錯誤與警告
  • 將發票渲染成自帶樣式的可列印 HTML 頁面,標籤可選語言
  • 將發票匯出為平面 CSV 表格,方便試算表或資料庫匯入
  • 把收到的採購發票轉成德國記帳用的 DATEV Buchungsstapel 匯入檔
適用情境
適合需要檢查、讀取或轉換企業收到的電子發票(XRechnung、Factur-X/ZUGFeRD、Peppol、FatturaPA、KSeF、RO e-Factura、PINT AE)時使用,例如記帳、資料登錄或快速確認發票是否合規。
執行需求
遠端 streamable HTTP 端點,不需本機執行環境或安裝套件。X-Api-Key 標頭為選用:未提供時依 IP 每天 20 張發票的示範額度;試用金鑰可從產品頁取得。請求需送出真實的 User-Agent。
安裝前請注意
發票檔案會上傳到第三方託管服務;README 表示不儲存任何內容,但檔案內容仍會離開本機。沒有金鑰時依 IP 限流。驗證結果僅供參考,不構成法律意見。此服務並非開源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 InvoiceIn,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.peculiar-systems%2Finvoicein/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "invoicein": {
      "type": "http",
      "url": "https://invoicein-api.peculiar.systems/mcp"
    }
  }
}

README

InvoiceIn — examples

[MCP server rated A on Glama] [Run in Postman]

Any European or UAE (PINT AE) e-invoice a business receives → one canonical EN 16931 JSON, a validation report with plain-language fix hints, a PDF, CSV or DATEV export. One stateless endpoint, nothing stored.

Accepts: XRechnung (UBL and CII), EN 16931 UBL 2.1 Invoice/CreditNote, Peppol BIS Billing 3, CII D16B, ZUGFeRD 1.0 / 2.x and Factur-X hybrid PDFs, Italy's FatturaPA 1.2, Poland's KSeF FA(2)/FA(3), Romania's RO e-Factura (CIUS-RO), the UAE's PINT AE (Billing and Self-Billing).

Validated against: EN 16931 validation artefacts 1.3.17, XRechnung 3.0.2 (KoSIT Schematron 2.6.0), Peppol BIS Billing 3, FNFE CTC-FR 1.4.0.04 (the BR-FR rules; runs when seller and buyer are both established in France), CIUS-RO 1.0.1, OpenPeppol's PINT AE 1.0.4 for the UAE (free check page: https://invoicein.peculiar.systems/uae), the UBL, CII, FatturaPA and KSeF schemas — plus arithmetic cross-checks on every format and market conventions no Schematron reads (German Skonto terms in free text, the Polish KSeF number). The live list with versions is at GET /v1/formats.

This repository holds runnable examples, sample invoices you can test with, and the MCP registry manifest. The service itself is not open source.

Nothing you send is stored: the document is parsed in memory and the response is built from it. Privacy (full policy) · Terms

The bridge in bridge/ is a transparent proxy, not a second implementation: it mirrors whatever tools/list returns from the hosted server, so the two can never drift. The five tools and their annotations — all read-only, non-destructive, idempotent, closed-world — are in bridge/tools.json, checked by tests/. A static analyser reading the bridge source alone sees one dispatch callback and no tools; that is the proxy, not the tool surface.

60 seconds

bash
curl -X POST "https://invoicein-api.peculiar.systems/v1/invoice?include=validation&lang=en" \  -H "X-Api-Key: $INVOICEIN_KEY" \  -F file=@samples/factur-x-en16931.pdf

No key yet? Leave the header out: 5 invoices a day per IP, same output, and every answer says how many are left. A free key — 100 invoices, no card, no expiry — is issued at once, on the product page or with one call:

bash
curl -X POST "https://invoicein-api.peculiar.systems/v1/keys" \  -H "Content-Type: application/json" -d '{"email": "[email protected]"}'

The response (full example):

jsonc
{  "ok": true,  "source":  { "syntax": "UBL", "format": "peppol-bis3", "profile": "Peppol BIS Billing 3.0", "container": "xml" },  "invoice": {                         // canonical EN 16931, field names carry BT/BG numbers in /v1/schema    "document": { "id": "Snippet1", "issue_date": "2017-11-13", "type_code": "380", "currency": "EUR", "due_date": "2017-12-01", ... },    "seller":   { "name": "SupplierOfficialName Ltd", "vat_id": "GB1232434", "electronic_address": { "value": "9482348239847239874", "scheme": "0088" }, ... },    "buyer":    { ... },    "lines":    [ { "id": "1", "quantity": 7, "unit": "DAY", "net_amount": 2800, "tax": { "category": "S", "rate": 25 }, "item": { "name": "item name" } }, ... ],    "tax_breakdown": [ { "taxable_amount": 1325, "tax_amount": 331.25, "category": "S", "rate": 25 } ],    "totals":   { "line_net": 1300, "charges": 25, "net": 1325, "tax": 331.25, "gross": 1656.25, "due": 1656.25 },    "payment":  { "means_code": "30", "remittance_info": "Snippet1", "credit_transfers": [ { "iban": "IBAN32423940", "account_name": "AccountName", "bic": "BIC324098" } ] }  },  "validation": { "valid": true, "errors": 0, "warnings": 0,                  "rule_sets": [ { "id": "XSD:ubl-invoice" }, { "id": "EN16931-UBL", "version": "EN 16931 validation artefacts 1.3.17" }, { "id": "Peppol-UBL" } ],                  "issues": [] },  "timings_ms": { "detect": 0.5, "map": 14.4, "validate": 86.0, "total": 100.8 },  "credits": { "mode": "key", "remaining": 99 }}

When something is wrong, every failed rule carries a hint in the requested language (example, KSeF FA(3) in Polish):

jsonc
{ "id": "XSD-UNEXPECTED-ELEMENT", "severity": "error", "rule_set": "XSD:fa3",  "message": "Element '{http://crd.gov.pl/wzor/2025/06/25/13775/}Adnotacje': This element is not expected. Expected is one of ( {http://crd.gov.pl/wzor/2025/06/25/1 …",  "hint": "XML zawiera element, którego schemat nie dopuszcza w tym miejscu. Nazwa elementu jest błędna, element należy do innego profilu/wersji (np. UBL 2.0 lub ZUGFeRD EXTENDED), jest zdublowany albo jest własnym rozszerzeniem. Usuń go lub zmień jego nazwę.",  "who": "sender", "location": "/*/*[4]/*[8]", "line": 43 }

Endpoints

CallReturns
POST /v1/invoice?include=validation,html,pdf,csv,datev&lang=en|de|pl|it|freverything in one JSON (extras base64/inline)
POST /v1/parsecanonical JSON only
POST /v1/validatevalidation report only
POST /v1/render.html · POST /v1/render.pdfhuman-readable rendering, labels in the five languages
POST /v1/export.csv?level=lines|documentsflat CSV
POST /v1/export.datev?skr=03|04&creditor_account=70000DATEV Buchungsstapel (EXTF 700, cp1252)
GET /v1/formats · GET /v1/rules/{id}?lang=de · GET /v1/schemaformats + rule versions · explain a rule id · field guide
GET /v1/countrieswhich format each country's mandate asks for, and what we validate it with
GET /v1/vat/{number}EU VAT number: format offline, then live VIES, with a dated receipt
GET /v1/peppol/{id}is a counterparty published on Peppol, and what can it receive

Body: multipart field file, or the raw XML/PDF. Send a real User-Agent (Cloudflare rejects the default Python-urllib one with error 1010). Auth: X-Api-Key or Authorization: Bearer. One invoice = one credit whatever outputs you request; a file that carries several invoices (a FatturaPA lot) costs one per invoice. Remaining credits come back in X-Credits-Remaining.

Examples in this repo

Sample invoices

FileWhat it isSource / licence
samples/xrechnung-3.0-ubl.xml, samples/xrechnung-3.0-cii.xmlthe same XRechnung 3.0 invoice in both syntaxesKoSIT XRechnung testsuite, Apache-2.0
samples/peppol-bis3-base-example.xmlPeppol BIS Billing 3 base exampleOpenPeppol, Apache-2.0
samples/factur-x-en16931.pdfFactur-X hybrid PDF, EN 16931 profileZUGFeRD corpus (FNFE-MPE examples), Apache-2.0
samples/ksef-fa3-przyklad-1.xmlKSeF FA(3) official example no. 1Polish Ministry of Finance, public
samples/fatturapa-fpr01.xmlFatturaPA 1.2 official example FPR01Agenzia delle Entrate, public

Both XRechnung files produce the same canonical JSON (only the syntax-specific extensions block differs) — that is the point of the canonical model.

What it does not do

No OCR (a PDF without embedded XML is rejected with pdf-no-xml). Not a Peppol access point, not a French PDP, not a UAE Accredited Service Provider, not a KSeF or SdI client: it reads what you already received and never transmits an invoice anywhere. Factur-X/ZUGFeRD profiles below EN 16931 (MINIMUM, BASIC WL, BASIC) get schema and arithmetic checks only, because the EN 16931 rules would only produce noise there. Validation results are informational, not legal advice.

Licence

The examples in this repository are MIT. Sample invoices keep the licences listed above.

來源:README.md,提交 4657145

工具

5

read_invoice

Read invoice

Parse one European or UAE (PINT AE) e-invoice into canonical EN 16931 JSON and validate it against the official rule sets in the same call. Use it when you need the invoice content (seller, buyer, lines, totals, payment) together with the verdict; use validate_invoice for a verdict-only answer, invoice_to_html / invoice_to_csv / invoice_to_datev for renderings. Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). Returns the parsed invoice, the validation report with fix hints in `lang`, and timings; an unreadable file returns ok=false with error.code/message/hint instead of raising. A FatturaPA lot returns only its first invoice, with a note. For a Polish KSeF invoice, pass the KSeF number in `ksef`: it is checked against the invoice and returned on payment.ksef_number. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

輸入參數kseflangpathfile_base64

validate_invoice

Validate invoice

Validate one European or UAE (PINT AE) e-invoice against the official rule sets (XSD, EN 16931, XRechnung, Peppol BIS, PINT AE, FatturaPA, KSeF, arithmetic) and return the verdict without the invoice body. Use it for pass/fail and the list of errors and warnings; use read_invoice when you also need lines, totals and payment data. Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). Returns the validation report (valid flag, counts, rule sets with versions, failed rules with rule id, severity, fix hint in `lang`, affected field and who must act), the detected source and the document header; an unreadable file returns ok=false with error.code/message/hint instead of raising. For a Polish KSeF invoice, a KSeF number passed in `ksef` is checked too: shape, NIP check digit, and agreement with the invoice it came with. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

輸入參數kseflangpathfile_base64

invoice_to_html

Render invoice as HTML

Render one European e-invoice as a self-contained, printable HTML page: header, seller and buyer, line items, VAT breakdown, totals and payment details in one layout regardless of the source syntax, labels in `lang`. Use it to show an invoice to a person or to print it to PDF from a browser; it does not validate (use validate_invoice) and is not an accounting export (use invoice_to_csv or invoice_to_datev). Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). Returns the HTML document as one text string with inline CSS and no external assets; an unreadable file returns a tool error with the reason. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

輸入參數kseflangpathfile_base64

invoice_to_csv

Export invoice as CSV

Export one European e-invoice as a flat CSV table for a spreadsheet or a database import. Document columns: invoice id, type, issue and due date, currency, seller and buyer name / VAT id / country, buyer and order reference, net / tax / gross / due totals, IBAN, BIC, remittance info, KSeF number, detected format and profile; with level=lines each row adds line id, item name, seller item id, quantity, unit, unit price, net amount, VAT category and rate, note. Use invoice_to_datev for DATEV bookkeeping and read_invoice for the full JSON. Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). A FatturaPA lot yields rows for every invoice in it. Returns the CSV as one text string: comma-separated, header row first, LF line endings, decimal point; an unreadable file returns a tool error with the reason. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

輸入參數ksefpathlevelfile_base64

invoice_to_datev

Export invoice as DATEV Buchungsstapel

Convert one received (purchase) e-invoice into a DATEV Buchungsstapel import file (EXTF format 700) for German bookkeeping in DATEV Kanzlei-Rechnungswesen or Unternehmen online. Use it only for incoming invoices booked on the German side; use invoice_to_csv for a generic table, read_invoice for the raw data, validate_invoice for rule checks (this tool does not validate). Input: XML (UBL, CII, XRechnung, Peppol BIS 3, UAE PINT AE, FatturaPA, KSeF FA(2)/FA(3)) or a ZUGFeRD/Factur-X hybrid PDF up to 25 MB; plain or scanned PDFs without embedded XML are rejected (no OCR). Returns the file content as one text string, decoded in UTF-8: the EXTF header line, the DATEV column header, then one booking row per VAT-rate group with the gross amount and S/H flag (H for credit notes), the expense account chosen by rate under the selected SKR (e.g. SKR03 3400 for 19 %, 3300 for 7 %, 3200 for 0 %, 3120 intra-EU, 3425 reverse charge), the creditor account as Gegenkonto, document and due date, invoice number in Belegfeld 1, seller name as Buchungstext and the seller VAT id on intra-EU / reverse-charge rows. Save it as UTF-8 with CRLF before importing; the account mapping is a default to confirm with the tax advisor. An unreadable file returns a tool error with the reason. Costs one invoice credit per call; without an API key the anonymous quota is 20 invoices per day per IP. Nothing is stored.

輸入參數skrpathfile_base64creditor_account

版本歷史

2
  1. v0.1.3最新Sep 25, 2026
  2. v0.1.2Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分