venabo bietet eine direkte Schnittstelle zum ERP-System c-entron. Damit die Kommunikation zwischen beiden Systemen reibungslos funktioniert, müssen in Ihrer c-entron-Installation die notwendigen API-Routen verfügbar und erreichbar sein.
Voraussetzungen
Die venabo-Schnittstelle benötigt Zugriff auf bestimmte API-Endpoints von c-entron. Diese sind in der offiziellen c-entron API-Dokumentation beschrieben und müssen in der von Ihnen eingesetzten Version vorhanden sein.
💡 Tipp: Die offizielle c-entron API-Dokumentation finden Sie unter: https://erp.c-entron.de/CentronServiceHelp/
Benötigte API-Routen
venabo nutzt aktuell die folgenden Routen. Alle aufgeführten Endpoints müssen seitens Ihres c-entron-Systems erreichbar sein:
Account- und Adressverwaltung
/Account/GetAccountAddresses/Account/GetAccount/Account/GetAccountTypes/GetAddressByI3D
Artikel & Barcode
/SearchArticles/GetArticleByArticleI3D/SearchBarCode2ThroughPaging/GetDefaultWarehouse
Belege (Receipts)
/SearchReceiptsThroughPaging/GetReceiptByI3D/CreateNewReceipt/CreateArticleReceiptItemsV2/SaveReceipt
Sonstige benötigte Routen
/GetActiveAssetConditions
⚠️ Hinweis: Die aufgeführten Endpoints entsprechen dem aktuellen Stand der venabo-Implementierung. Ändert c-entron einzelne Routen (z. B. durch Umbenennung, Verlagerung oder Entfernung), kann das die Funktion der Schnittstelle beeinträchtigen. Prüfen Sie vor der Einrichtung oder einem Update, ob alle benötigten Endpoints in Ihrer c-entron-Version weiterhin verfügbar sind.
Einrichtung – Schritt für Schritt
Gehen Sie als Administrator oder technischer Ansprechpartner wie folgt vor:
- Prüfen Sie die eingesetzte API-Version von c-entron und gleichen Sie diese mit der oben verlinkten Dokumentation ab.
- Stellen Sie sicher, dass alle oben genannten API-Routen in Ihrer Installation vorhanden und aktiv sind.
- Konfigurieren Sie bei Bedarf die API-Zugriffsrechte, damit venabo die Endpoints aufrufen darf.
- Testen Sie die Erreichbarkeit der Routen, bevor Sie die Schnittstelle in venabo aktivieren.
- Wenden Sie sich bei Unklarheiten an den venabo-Support oder direkt an den c-entron-Support.
Praxisbeispiel
Szenario: Sie möchten in venabo eine neue Leistung erfassen und diese direkt als Beleg in c-entron anlegen. venabo ruft dabei nacheinander mehrere API-Routen auf.
| Schritt | Aktion in venabo | Aufgerufene API-Route |
|---|---|---|
| 1 | Kundenkonto auswählen | /Account/GetAccount |
| 2 | Lieferadresse laden | /Account/GetAccountAddresses |
| 3 | Artikel per Barcode suchen | /SearchBarCode2ThroughPaging |
| 4 | Neuen Beleg erstellen | /CreateNewReceipt |
| 5 | Artikel zum Beleg hinzufügen | /CreateArticleReceiptItemsV2 |
| 6 | Beleg speichern | /SaveReceipt |
Ist auch nur eine dieser Routen in Ihrer c-entron-Installation nicht erreichbar, bricht der Prozess an der entsprechenden Stelle ab.
Häufige Fragen
Was passiert, wenn eine API-Route in c-entron nicht verfügbar ist?
venabo kann den jeweiligen Prozessschritt nicht ausführen und gibt eine Fehlermeldung aus. Prüfen Sie in diesem Fall, ob die Route in Ihrer c-entron-Version existiert und ob die Zugriffsrechte korrekt konfiguriert sind.
Muss ich nach einem c-entron-Update die Schnittstelle neu einrichten?
Nicht zwingend – aber Sie sollten nach jedem Update prüfen, ob alle benötigten Endpoints weiterhin unter denselben Routen erreichbar sind. c-entron kann API-Routen umbenennen oder entfernen, ohne dass venabo automatisch davon erfährt.
Wo finde ich die passenden Zugriffsrechte in c-entron?
Die Konfiguration der API-Zugriffsrechte erfolgt in der c-entron-Administrationsoberfläche. Wenden Sie sich bei Fragen dazu direkt an den c-entron-Support oder Ihren c-entron-Systemadministrator.
Kann ich die Schnittstelle auch ohne vollständige API-Abdeckung teilweise nutzen?
Das hängt davon ab, welche Funktionen Sie in venabo einsetzen. Einige Prozesse benötigen nur einen Teil der Routen. Für einen vollständigen und fehlerfreien Betrieb empfiehlt venabo jedoch, alle aufgeführten Endpoints bereitzustellen.
Zusammenfassung
| Thema | Details |
|---|---|
| Ziel der Schnittstelle | Datenaustausch zwischen venabo-Leistungserfassung und c-entron ERP |
| Voraussetzung | Alle benötigten API-Routen müssen in c-entron verfügbar und erreichbar sein |
| Anzahl benötigter Routen | 13 Endpoints in 4 Kategorien |
| API-Dokumentation | https://erp.c-entron.de/CentronServiceHelp/ |
| Bei Problemen | venabo-Support oder c-entron-Support kontaktieren |