Warum API-Integration unverzichtbar ist
Das Portal hat eine Weboberfläche für manuelle Eingabe, aber für Unternehmen mit mehr als 5-10 Lieferscheinen täglich ist manuelle Eingabe nicht tragbar. API-Integration ermöglicht automatische Erstellung, Empfangsbestätigung und Statussynchronisation.
Systemarchitektur
- Protokoll: HTTPS (TLS 1.2+)
- Format: JSON
- Authentifizierung: Qualifiziertes Zertifikat (Mutual TLS) + API-Schlüssel
- Dokumentation: Nach Registrierung auf dem Portal verfügbar
Wichtige API-Endpunkte
| Endpunkt | Methode | Beschreibung |
|---|---|---|
| /api/v1/lieferscheine | POST | Neuen E-Lieferschein erstellen |
| /api/v1/lieferscheine/{id} | GET | Einzelnen Lieferschein anzeigen |
| /api/v1/lieferscheine | GET | Lieferscheine auflisten (mit Filtern) |
| /api/v1/empfangsscheine | POST | Empfangsschein erstellen |
| /api/v1/lieferscheine/{id}/status | GET | Status abfragen |
| /api/v1/lieferscheine/{id}/pdf | GET | PDF-Version zum Drucken |
Integration mit gängigen ERP-Systemen
SAP
SAP PI/PO oder SAP Integration Suite verwenden. Mapping aus dem SD-Modul.
Microsoft Dynamics
Power Automate oder benutzerdefinierte Konnektoren verwenden.
Lokale ERP-Systeme
Die meisten lokalen ERP-Lösungen entwickeln bereits E-Lieferschein-Module.
Häufige Integrationsprobleme
- Zertifikat nicht korrekt konfiguriert — muss auf dem Server sein
- Falsches Datumsformat — API erwartet ISO 8601
- Fehlende Pflichtfelder — API gibt Fehler 400 zurück
- Empfänger nicht registriert
- Timeout bei großen Sendungen — aufteilen auf mehrere Lieferscheine
Webhook-Benachrichtigungen
Das Portal unterstützt Webhooks für Echtzeit-Statusupdates.
Fazit
API-Integration ist der einzig nachhaltige Ansatz für Unternehmen mit hohem Volumen.
Arhivix hat eine fertige Portal-Integration — verbinden Sie Ihr ERP mit Arhivix, und es kommuniziert für Sie mit dem Portal.
