ERP-Anbindungen im Überblick

ERP-Anbindungen verbinden TaprNext mit Ihrem Buchhaltungssystem. Freigegebene AP-Rechnungen werden als Einkaufsrechnungen ins ERP gebucht. Für AR werden Verkaufsrechnungen aus dem ERP abgerufen und via PEPPOL versendet.

So funktioniert die ERP-Integration

Die Integration arbeitet bidirektional:

• AP (eingehend): TaprNext bucht freigegebene Einkaufsrechnungen in Ihr ERP
• AR (ausgehend): Verkaufsrechnungen werden aus dem ERP geholt und für die PEPPOL-Übertragung vorbereitet

ERP-Anbindungen werden pro Rechtseinheit unter Tapr Settings → General → Legal Entity Setup konfiguriert. Jede Entity kann einen anderen ERP-Typ und ein anderes Unternehmen verwenden.

Unterstützte ERPs

ERP	Type Code	AP (Post)	AR (Fetch)
ERPNext	erpnext	Yes	Yes
Microsoft Dynamics 365	d365	Yes	Yes
SAP S/4HANA	sap_s4hana	Yes	Yes
SAP Business One	sap_b1	Yes	Yes
Oracle NetSuite	netsuite	Yes	Yes
Xero	xero	Yes	Yes
QuickBooks	quickbooks	Yes	Yes
Odoo	odoo	Yes	Yes
Sage Intacct	sage	Yes	Yes
Bexio	bexio	Yes	Yes
Abacus	abacus	Yes	Yes

Konfiguration pro Entity

Jede Legal-Entity-Zeile erfordert:

Feld	Beschreibung
ERP Integration Enabled	Hauptschalter für die ERP-Anbindung dieser Entity
ERP Type	ERP aus der unterstützten Liste wählen
ERP Company Name	Firmenname wie im ERP hinterlegt
AR ERP Fetch Enabled	Abruf von Verkaufsrechnungen für den PEPPOL-Versand aktivieren
ERP Config (JSON)	Verbindungsdetails (URL, Standardkonten, Mappings)
ERP Secrets (JSON)	Verschlüsselte Zugangsdaten (API-Schlüssel, Tokens, Passwörter)

Zugangsdaten aktualisieren

ERP-Zugangsdaten werden im Ruhezustand verschlüsselt. Zum Aktualisieren:

1. Checkbox Change ERP Secrets aktivieren
2. Neue Zugangsdaten im Feld ERP Secrets eintragen
3. Speichern — die Zugangsdaten werden verschlüsselt abgelegt
4. Die Checkbox wird automatisch zurückgesetzt

Teilaktualisierungen sind möglich; Sie können einzelne Credential-Felder ändern, ohne alle anderen erneut einzugeben.

Schnelleinrichtung

ERPNext

// ERP Config
{
  "url": "https://your-erpnext.com",
  "company": "Your Company Name",
  "default_expense_account": "5000 - Expenses - COMP",
  "default_payable_account": "2100 - Creditors - COMP"
}

// ERP Secrets
{
  "api_key": "your-api-key",
  "api_secret": "your-api-secret"
}

Microsoft Dynamics 365

// ERP Config
{
  "environment_url": "https://your-org.crm.dynamics.com",
  "company": "Your Legal Entity",
  "tenant_id": "your-azure-tenant-id"
}

// ERP Secrets
{
  "client_id": "app-registration-client-id",
  "client_secret": "app-registration-secret"
}

Verbindung testen

Nach der Konfiguration:

1. Test Connection — prüft Authentifizierung und API-Zugriff
2. Test Post — erstellt ein Entwurfsdokument im ERP (nicht freigegeben)
3. Prüfen Sie das Testdokument im ERP, um das Feldmapping zu bestätigen

Sync-Verhalten

Richtung	Was passiert	Häufigkeit
AP → ERP	Freigegebene Rechnungen werden als Einkaufsrechnungen gebucht	Bei Freigabe (oder manuell)
ERP → AR	Verkaufsrechnungen mit PEPPOL-Flag werden zum Versand abgerufen	Alle 10 Minuten

Für schnellere Reaktion kann das ERP nach einem Ereignis (Rechnung bereit, gebucht, bezahlt, storniert) notify_erp_activity aufrufen, um den AR-Fetch oder ausstehende AP-Buchungen für eine Legal Entity sofort zu starten.

AP-Workflow-Status

Konfigurieren Sie eigene Workflow-Status für die ERP-Buchung:

Status	Wann
ERP Ready State	Rechnung ist freigegeben und bereit zur Buchung
Post ERP Success State	Rechnung wurde erfolgreich gebucht
Post ERP Error State	Buchung fehlgeschlagen — siehe Fehlerprotokoll

Multi-ERP-Setup

Verschiedene Entities können unterschiedliche ERPs nutzen:

Entity	ERP	Company
Acme GmbH (DE)	ERPNext	Acme GmbH
Acme BV (NL)	D365	NL Operating
Acme AB (SE)	SAP S/4HANA	SE Subsidiary

ERP-Config und Zugangsdaten jeder Entity sind unabhängig.

Fehlerbehebung

Problem	Lösung
”Connection refused”	URL prüfen, HTTPS sicherstellen, Firewall-Regeln prüfen
”Authentication failed”	API-Schlüssel neu erzeugen oder OAuth-Token-Ablauf prüfen
”Permission denied”	ERP-Benutzer mit den erforderlichen Rollen prüfen (Purchase User, Sales User)
“Company mismatch”	ERP Company Name muss exakt übereinstimmen
”Duplicate document”	Rechnung bereits gebucht — prüfen Sie den vorhandenen Eintrag im ERP