E-Rechnung mit enventa ERP: so wird aus der enventa-Rechnung eine XRechnung oder ZUGFeRD

Was enventa Trade ERP heute kann

Das System hieß bis 2025 eNVenta ERP und stammt von Nissen & Velten, die seit 2022 zur enventa Group gehört. Laut Hersteller wurde nur der Name geändert, Funktionen und Services blieben erhalten. Wer also nach „eNVenta XRechnung“ sucht, meint dasselbe Produkt.

Zielgruppe sind B2B-Händler im technischen Bereich mit vier Schwerpunkten: technischer Handel, Stahlhandel, Biegerei und SHK-Handel. Die Produktseite wirbt mit „Hosted in Germany“; ob daneben ein Betrieb im eigenen Rechenzentrum möglich ist, nennt sie nicht. An Schnittstellen führt enventa unter anderem EDI für Bestellungen, Lieferscheine, Rechnungen und Produktdaten, eine DATEV-Schnittstelle für FiBu-Daten, die Verbandsanbindungen E/D/E, NORDWEST und nexmart, BMECat, GAEB, DATANORM, BVBS 2.0 für Biegemaschinen, den Webservice WebAccess für Shopsysteme und eine Gateway-Architektur mit Adaptern für Fremdsysteme.

Für die E-Rechnung gibt es das Modul „Trade ERP ZUGFeRD / XRechnung“. Der Hersteller beschreibt es so: Sie können damit „mit öffentlichen Auftraggebern und anderen Kunden elektronische Rechnungen austauschen“, die XML-Daten stecken in einem PDF, das als Sichtkontrolle dient. Nicht öffentlich genannt werden das Profil für ZUGFeRD (ein normales PDF mit denselben Rechnungsdaten als eingebettetem XML), die unterstützte XRechnung-Version, die Mindestversion des ERP und die Lizenzkosten. Klären Sie diese Punkte mit Ihrem enventa-Betreuer.

Der passende Weg für enventa Trade ERP

1. Modulstatus klären: Fragen Sie, ob das ZUGFeRD-/XRechnung-Modul lizenziert ist und ob es reine XRechnung (für Behörden) und ZUGFeRD (für Industriekunden) ausgeben kann. Ist beides vorhanden, bleibt der Rechnungsausgang im ERP.
2. Stichprobe unabhängig prüfen: Schicken Sie vor dem Echtbetrieb einige Rechnungen mit Rabatten, Zuschlägen, Gutschriften und mehreren Steuersätzen an POST /v1/invoices/validate-pdf oder öffnen Sie sie im kostenlosen Viewer. Die Prüfung läuft gegen EN 16931 und XRechnung 3.0.
3. Ohne Modul, Weg A: Die Rechnung wird weiter aus enventa gedruckt. Ein Skript oder die Anbindung durch Coreventa übergibt die PDF zusammen mit Kopf- und Positionsdaten an generate. Das Layout bleibt, die API bettet die XRechnung ein und prüft das Ergebnis. Aufwand: einige Tage für Mapping und Test.
4. Weg B mit vorhandenen EDI-Daten: Wenn Sie Rechnungen schon per EDI an Großkunden senden, liegen die Rechnungsdaten bereits strukturiert vor. Ein Mapping von dort nach JSON (ein Textformat für Daten) spart die Datenbeschaffung; die Sicht-PDF rendert dann der Server.
5. Empfang: Eingangsrechnungen von Werken und Lieferanten lesen und prüfen Sie im Viewer oder lesen die XML per extract aus.

Fragen Sie Ihren enventa-Betreuer wörtlich: „Ist das Modul Trade ERP ZUGFeRD / XRechnung bei uns lizenziert, welches ZUGFeRD-Profil und welche XRechnung-Version gibt es aus, ab welcher Programmversion läuft es, und was kostet die Lizenz?“

Beispiel: enventa-Rechnung als ZUGFeRD in einem Aufruf

Zuerst die Prüfung einer Datei, die das enventa-Modul erzeugt hat:

Vorher haben Sie eine ZUGFeRD-Rechnung aus dem enventa-Modul, von der Sie nicht wissen, ob der Kunde sie annimmt. Nachher haben Sie einen Prüfbericht, der jeden Formatfehler mit der betroffenen Angabe nennt, bevor die Rechnung rausgeht.

Der folgende Kasten ist für Ihre IT oder Ihr Systemhaus gedacht. Als Inhaber reicht es zu wissen: So sieht ein Beispiel aus, das die Prüfung besteht.

# ZUGFeRD-PDF aus dem enventa-Modul gegen EN 16931 prüfen:
curl -X POST https://api.einfache-rechnungen.de/v1/invoices/validate-pdf \
  -H "X-API-Key: erk_ihr_key" \
  -H "Content-Type: application/json" \
  -d '{"pdf_base64": "JVBERi0xLjcK…"}'

Ohne Modul erzeugen Sie die E-Rechnung aus der gedruckten PDF und den Daten. Das Beispiel zeigt eine Stahlhandelsrechnung: Flachstahl mit Preis je 100 kg, Edelstahl-Rundstab mit Legierungszuschlag als Positionszuschlag, Sägeschnitte als eigene Position und die Anlieferung mit Kran-Lkw als Zuschlag auf Belegebene. Das JSON ist gegen XRechnung 3.0 geprüft.

Vorher gibt es nur die gedruckte Stahlrechnung aus enventa. Nachher ist es dieselbe PDF mit eingebetteten Rechnungsdaten, in denen Preis je 100 kg und Legierungszuschlag so stehen, dass der Kunde sie maschinell nachrechnen kann.

# PDF aus enventa plus Rechnungsdaten an die API:
curl -X POST https://api.einfache-rechnungen.de/v1/invoices/generate \
  -H "X-API-Key: erk_ihr_key" \
  -H "Content-Type: application/json" \
  -d @stahlrechnung.json

{
  "invoice": {
    "invoice_number": "RE-26-118204",
    "issue_date": "2026-10-02",
    "delivery_date": "2026-10-01",
    "due_date": "2026-11-01",
    "currency": "EUR",
    "buyer_reference": "40117",
    "purchase_order_reference": "4500093315",
    "seller": {
      "name": "Rheinstahl Handel GmbH",
      "address": {"street": "Industriering 40", "postal_code": "47138", "city": "Duisburg", "country_code": "DE"},
      "vat_id": "DE987654321",
      "electronic_address": "faktura@rheinstahl-handel.example",
      "electronic_address_scheme": "EM",
      "contact": {
        "name": "Debitorenbuchhaltung",
        "phone": "+49 203 555200",
        "email": "faktura@rheinstahl-handel.example"
      }
    },
    "buyer": {
      "name": "Metallbau Kessler GmbH",
      "address": {
        "street": "Am Bahndamm 7",
        "postal_code": "45478",
        "city": "Mülheim an der Ruhr",
        "country_code": "DE"
      },
      "electronic_address": "rechnungseingang@kessler-metallbau.example",
      "electronic_address_scheme": "EM"
    },
    "payment_means": {"code": "58", "iban": "DE02120300000000202051"},
    "lines": [
      {
        "line_id": "10",
        "name": "Flachstahl S235JR 60x8 mm",
        "description": "Preis je 100 kg",
        "quantity": "1250",
        "unit_code": "KGM",
        "unit_price_net": "108.00",
        "price_base_quantity": "100",
        "line_net_amount": "1350.00",
        "tax_category": "S",
        "tax_rate": "19"
      },
      {
        "line_id": "20",
        "name": "Rundstahl 1.4301 Ø 40 mm",
        "quantity": "380",
        "unit_code": "KGM",
        "unit_price_net": "5.10",
        "line_charges": [{"amount": "349.60", "reason": "Legierungszuschlag 0,92 EUR/kg"}],
        "line_net_amount": "2287.60",
        "tax_category": "S",
        "tax_rate": "19"
      },
      {
        "line_id": "30",
        "name": "Sägeschnitt",
        "quantity": "14",
        "unit_code": "C62",
        "unit_price_net": "3.50",
        "line_net_amount": "49.00",
        "tax_category": "S",
        "tax_rate": "19"
      }
    ],
    "charges": [{"amount": "85.00", "reason": "Anlieferung mit Kran-Lkw", "tax_category": "S", "tax_rate": "19"}],
    "tax_breakdown": [{"category": "S", "rate": "19", "taxable_amount": "3771.60", "tax_amount": "716.60"}],
    "totals": {
      "line_net_amount": "3686.60",
      "charge_total_amount": "85.00",
      "net_amount": "3771.60",
      "tax_amount": "716.60",
      "gross_amount": "4488.20",
      "payable_amount": "4488.20"
    }
  },
  "invoice_pdf_base64": "JVBERi0xLjcKJeLjz9MK…",
  "options": {"profile": "XRECHNUNG", "syntax": "CII", "allow_unverified_visual": true}
}

Wichtig: In diesem Weg prüft die API nicht, ob das sichtbare PDF mit der eingebetteten XML übereinstimmt. Beide müssen aus demselben Rechnungsdatensatz stammen; dafür sorgt Ihr Skript oder die Anbindung.

Der Betrag für Position 10 lautet 1.250 × 108,00 / 100 = 1.350,00. Position 20 ergibt 380 × 5,10 = 1.938,00 plus 349,60 Legierungszuschlag, also 2.287,60.

Feldzuordnung

Die Tabelle zeigt, wo die Angaben Ihrer enventa-Rechnung in der E-Rechnung landen. Kürzel wie BR-DE-26, BT-10 oder BG-3 stammen aus der Norm EN 16931. Sie müssen sie nicht kennen; wichtig ist der erklärende Satz daneben.

Stolpersteine im Stahl- und technischen Handel mit enventa Trade ERP

• Preis je 100 kg ohne Basismenge: Steht auf der Rechnung „108,00 € je 100 kg“ und wird als Stückpreis 108,00 übergeben, errechnet die Prüfung 135.000 € statt 1.350 € und antwortet mit HTTP 422 für die Position. So lösen Sie es: Preis unverändert lassen und price_base_quantity: "100" setzen. Geben Sie zusätzlich price_base_quantity_unit_code an, muss er gleich unit_code sein.
• Kilogramm und Tonne gemischt: Manche Positionen werden in kg, andere in t geführt. Beides ist erlaubt, aber jede Position braucht den Code ihrer eigenen Einheit (KGM oder TNE). Ein Umrechnen nur im Preis, nicht in der Menge, führt zu falschen Positionsbeträgen.
• Zuschläge doppelt: Legierungs- oder Schnittzuschläge dürfen entweder als eigene Position oder als line_charges erscheinen, nicht beides. Bei Weg A richten Sie sich nach der gedruckten Rechnung, damit Sichtbild und Daten übereinstimmen.
• EDI-Kunden doppelt beliefert: Großkunden, die Ihre Rechnungen schon per EDI erhalten, sollten nicht zusätzlich eine ZUGFeRD-Datei bekommen. Sonst droht eine doppelte Erfassung beim Kunden. Legen Sie je Kunde genau einen elektronischen Versandweg fest.
• Bewehrung für kommunale Baustellen: Liefern Biegereien an Gemeinden oder Landesbehörden, verlangt das Rechnungsportal in der Regel eine XRechnung mit Leitweg-ID in buyer_reference und einem Ansprechpartner des Verkäufers mit Telefon und E-Mail. Fehlt der Kontakt, meldet die Prüfung einen Fehler und die API liefert HTTP 422 statt einer ungültigen Rechnung.

Häufige Fragen

enventa Trade ERP ist ein Produkt der enventa technical trade solutions GmbH (enventa Group). einfache-rechnungen.de ist ein unabhängiges Angebot und steht in keiner Verbindung zum Hersteller.

Kosten: Die Prüfung und Erzeugung kostet 0 € für 10 Rechnungen im Monat, danach ab 7,99 € netto. Eine Anbindung durch Coreventa ist ein Festpreisprojekt; den Rahmen klären wir im kostenlosen Erstgespräch. Ihre Rechnungs- und Kundendaten bleiben dabei auf deutschen Servern (Hetzner).