E-Rechnungs-Integration (SAL13)

Transaktion: SAL13 E-Rechnungs-Integration
API: GET /api/salesHead/getXInvoiceXml/{id}

Business-Zweck

E-Rechnungen (XRechnung, ZUGFeRD) sind für B2G und zunehmend B2B Pflicht. Partner extrahieren nach Rechnungserstellung das XML aus reybex und übergeben es an Peppol-Gateways, E-Mail-Versand oder Archivsysteme.

→ Order-to-Cash Phase 9

Kernbegriffe

Begriff	Bedeutung
XRechnung	EN 16931 XML-Format
ZUGFeRD	PDF + eingebettetes XML
getXInvoiceXml	XML-Export API
einvoiceNumber	E-Rechnungs-ID
isInvoiceSend	Versandstatus E-Rechnung
Leitweg-ID	B2G-Empfängerkennung

Fachlicher Ablauf

1. Rechnung vollständig (Kunde, USt, Positionen)
2. XML abrufen
3. Validierung gegen EN 16931
4. Versand + Status in reybex

Partner-Szenarien

Szenario 1 – XML abrufen

curl -G "$BASE_URL/api/salesHead/getXInvoiceXml/2222333344445555" \
  -H "Authorization: Bearer $TOKEN"

Response (Struktur):

{
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>...",
  "format": "XRechnung",
  "salesHeadId": 2222333344445555,
  "docNumber": "RE-2026-00123"
}

Szenario 2 – Nach FiBu-Übergabe

Typische Reihenfolge: RE → FiBu → E-Rechnung – projektabhängig.

# 1. Rechnung transferieren
curl -X POST "$BASE_URL/api/salesHead/transferInvoicesToFinance" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"salesHeadIds": [2222333344445555]}'

# 2. XML holen
curl -G "$BASE_URL/api/salesHead/getXInvoiceXml/2222333344445555" \
  -H "Authorization: Bearer $TOKEN"

Szenario 3 – B2G Leitweg-ID

Kunde mit Behörden-Leitweg-ID in Stammdaten pflegen (SAL01). Fehlende ID → Validierungsfehler im XML.

Hilfs-Endpoints:

POST /api/salesHead/getEInvoicePrefixList
{ "customerId": 1000001 }

POST /api/salesHead/getCustomerTaxpayerPkList
{ "customerId": 1000001 }

Szenario 4 – Connector E-Rechnung-Status

GET /api/salesHead/connector?isInvoiceSend=1 – Spezialfilter für übermittelte E-Rechnungen (Shop-Rückmeldung).

Voraussetzungen

• SAL13 in Mandant aktiviert
• Rechnung mit vollständigen Pflichtfeldern
• Kunde: USt-ID, Adresse, ggf. Leitweg-ID
• Rechnungs-DocType E-Rechnungs-fähig

Auswirkungen im ERP

Aktion	Auswirkung
XML-Export	Kein Statuswechsel allein
Versand UI/Workflow	isInvoiceSend, einvoiceNumber
Connector	Rückmeldung an Shop

Typische Fehlerquellen

Fehler	Ursache
Leeres XML	RE unvollständig
Schema-Fehler	Pflichtfeld fehlt (BT-* Felder)
Falsche USt	vatKey / B2B EU
Doppelversand	Idempotenz im Gateway

Weiterlesen

• Rechnungen

• Rechnungslauf & FiBu

• Kunden & Kontakte

• FIN Modulübersicht