Przejdź do treści
Biblioteka skilli
Finanse i księgowość · Konwersja i formaty

invoapi

/invoapi

Tworzy, sprawdza i konwertuje niemieckie i europejskie e-faktury, takie jak XRechnung i ZUGFeRD, przez API invoapi, także naprawiając błędy walidacji.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
29.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
9
Przestarzałość

Brak sygnałów. Repozytorium zmienione 29.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Tworzy, sprawdza i konwertuje niemieckie i europejskie e-faktury, takie jak XRechnung i ZUGFeRD, przez API invoapi, także naprawiając błędy walidacji.

Oryginalny opis (EN)

Create, validate, read and convert German and European e-invoices (XRechnung, ZUGFeRD / Factur-X, EN 16931, UBL, CII, Peppol BIS) with the invoapi REST API. Use when the user wants to generate an e-invoice or E-Rechnung from data, check an incoming XML or ZUGFeRD PDF against the official rules (KoSIT validator, EN 16931 schematron), fix validation errors such as BR-DE-15 or BR-CO-25, extract invoice data from XML/PDF, convert between formats, or integrate e-invoicing into code (shop, ERP, CRM, script).

Jak działa

  1. Choose the format
  2. Endpoints
  3. Workflow for generating
  4. Minimal XRechnung request
  5. Limits and errors
  6. Other ways in
Sekcje z nagłówków SKILL.md, w oryginale · 91 linii, 616 słów
Podgląd SKILL.md
---
name: invoapi
description: Create, validate, read and convert German and European e-invoices (XRechnung, ZUGFeRD / Factur-X, EN 16931, UBL, CII, Peppol BIS) with the invoapi REST API. Use when the user wants to generate an e-invoice or E-Rechnung from data, check an incoming XML or ZUGFeRD PDF against the official rules (KoSIT validator, EN 16931 schematron), fix validation errors such as BR-DE-15 or BR-CO-25, extract invoice data from XML/PDF, convert between formats, or integrate e-invoicing into code (shop, ERP, CRM, script).
---

# invoapi: e-invoices from JSON

invoapi turns one JSON invoice model into any supported e-invoice format and validates documents with the official rule sets. Totals and the VAT breakdown are always calculated server-side. Invoice contents are processed per request and not stored.

- API base: `https://api.invoapi.de`
- Docs: https://invoapi.de/docs (OpenAPI: https://api.invoapi.de/openapi.json)
- Auth: `Authorization: Bearer $INVOAPI_API_KEY` (or header `X-API-Key`). Keys start with `inv_live_` or `inv_test_` and are created at https://invoapi.de/dashboard/api-keys.

Never print, log or commit the API key. Read it from the environment (`INVOAPI_API_KEY`); if it is missing, ask the user to create one in the dashboard and set the variable.

## Choose the format

| Need | Request |
|---|---|
| German public sector buyer (Behörde), Leitweg-ID | `"format": "xrechnung"` (UBL default, `"syntax": "cii"` possible) |
| B2B invoice a human also reads | `"format": "zugferd", "output": "pdf", "profile": "en16931"` (PDF/A-3 with embedded XML) |
| Cross-border / Peppol network | `"format": "peppol"` |
| Plain EN 16931 | `"format": "en16931"` |

## Endpoints

| Method | Path | Purpose |
|---|---|---|
| POST | `/api/v1/generate` | JSON invoice to XML or ZUGFeRD PDF, validated by default |
| POST | `/api/v1/validate` | Check XML / ZUGFeRD PDF (raw `application/xml`, `application/pdf`, multipart `file`, or JSON with `xml` / `content_base64` / `invoice`) |
| POST | `/api/v1/parse` | Any supported document into the canonical JSON model |
| POST | `/api/v1/convert` | Between JSON, UBL, CII, HTML, PDF (`target`: xml, pdf, json, html) |
| POST | `/api/v1/render` | Readable HTML or PDF of an XML invoice (returns the document itself) |
| POST | `/api/v1/detect` | Identify format, syntax and version without validating |
| POST | `/api/v1/calculate` | Totals and VAT breakdown only, no document |
| GET | `/api/v1/formats` | Supported formats and versions |

## Workflow for generating

1. Build the canonical invoice (see [references/invoice-model.md](references/invoice-model.md)). Required: `invoice_number`, `issue_date`, `seller`, `buyer`; add `line_items` and `payment`.
2. `POST /api/v1/generate` with `{"format": ..., "invoice": {...}}`. Validation runs by default (`"validate": true`).
3. Read the response:
   - `valid: true`: done. XML is in `document.content`, PDF in `document.content_base64`, name in `document.filename`.
   - `valid: false`: fix every issue with `severity: "error"` in `validation.issues`. Each issue names the `rule`, the canonical `field`, an `explanation` and a `suggestion`. Regenerate. See [references/errors.md](references/errors.md).
   - `valid: null`: no rule set could run. Never treat that as valid.
4. Also read `warnings`: the API reports values it filled in (for example the buyer reference fallback).

Do not compute totals yourself and do not send `totals` or `taxes`: the API recalculates them with exact decimal arithmetic. Use `/calculate` to preview amounts.

## Minimal XRechnung request

```bash
curl -s https://api.invoapi.de/api/v1/generate \
  -H "Authorization: Bearer $INVOAPI_API_KEY" -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "format": "xrechnung",
  "invoice": {
    "invoice_number": "RE-2026-0001",
    "issue_date": "2026-10-29",
    "due_date": "2026-11-12",
    "buyer_reference": "04011000-12345-34",
    "seller": {
      "name": "Muster GmbH", "vat_id": "DE123456789",
      "email": "rechnung@muster.de", "phone": "+49 30 1234567",
      "address": {"street": "Musterstraße 1", "city": "Berlin", "postal_code": "10115", "country_code": "DE"}
    },
    "buyer": {
      "name": "Beispiel GmbH",
      "electronic_address": "einkauf@beispiel.de", "electronic_address_scheme": "EM",
      "address": {"street": "Teststraße 10", "city": "Hamburg", "postal_code": "20095", "country_code": "DE"}
    },
    "line_items": [
      {"name": "Beratung", "quantity": 8, "unit_code": "HUR", "unit_price": 145, "vat_category": "S", "vat_rate": 19}
    ],
    "payment": {"means_code": "58", "iban": "DE02120300000000202051"}
  }
}
JSON
```

More examples (ZUGFeRD PDF with logo, validating a file, parsing, converting): [references/examples.md](references/examples.md).

## Limits and errors

- HTTP errors use `{"error": {"code", "message", "details", "request_id"}}`.
- `402 QUOTA_EXHAUSTED`: the free plan's 100 invoices are used up; the user can upgrade at https://invoapi.de/preise.
- `429 RATE_LIMITED`: wait for the `Retry-After` header, then retry.
- `401`: wrong key, unconfirmed e-mail or disabled account.

## Other ways in

- MCP server for AI assistants: `https://api.invoapi.de/mcp` (OAuth). Setup: https://invoapi.de/mcp
- PHP SDK, n8n node, WooCommerce plugin: https://invoapi.de/integrationen
Pliki w paczce (4)
  • SKILL.md 5 KB
  • references/errors.md 2 KB
  • references/examples.md 2 KB
  • references/invoice-model.md 4 KB

Wersje

W bazie nie ma innych skilli o nazwie invoapi.

Migawka bazy z 13.11.2026 · wersja paczki 3ea08d1a0345 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90pdf-to-einvoice
    Zamienia wystawioną fakturę PDF w e-fakturę ZUGFeRD, Factur-X lub XRechnung, dołączając dane XML bez zmiany wyglądu PDF, albo sprawdza istniejącą e-fakturę.
  • 95germany-einvoice
    Odpowiada na pytania o niemieckie e-fakturowanie: XRechnung, ZUGFeRD, ERechV, Peppol, Leitweg-ID, obowiązek B2B, EN 16931 i archiwizację GoBD, w tym przygotowanie XML.
  • 100pdfvera
    Zamienia niemieckie faktury PDF w e-faktury XRechnung lub ZUGFeRD, a brazylijskie wyciągi bankowe w OFX, CSV lub Excel.
  • 100einvoice-consistency
    Sprawdza fakturę elektroniczną w CII XML lub Factur-X PDF pod kątem arytmetyki i wymaganych pól wg EN 16931 i wypisuje niespełnione reguły.
  • 96sfi-reference
    Opisuje konfigurację rozszerzenia SFI w Rossum dla XML, JSON oraz e-faktur ZUGFeRD i X-Rechnung.
  • 100jp-pint-invoice-validation
    Waliduje e-faktury Peppol JP PINT w XML UBL względem schematów OASIS i reguł Schematron, opcjonalnie sprawdzając numer T sprzedawcy w rejestrze.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.