E-Commerce-Integrationen
Einen PrestaShop- oder WooCommerce-Shop oder Ihre eigene Website mit Novadesko verbinden, um Bestand, Produkte, Bestellungen und Rechnungen zu synchronisieren.
Die E-Commerce-Integrationen verbinden Ihren Onlineshop mit Novadesko: Bestellungen, Kunden und Zahlungen gelangen in Novadesko, und Bestand und Preise aus Novadesko werden an den Shop zurückgegeben. Unter Integrationen stehen drei Karten zur Verfügung: PrestaShop, WooCommerce und Novadesko Connect (für eine Website, die Sie selbst entwickeln).
Die E-Commerce-Integrationen erfordern den E-Commerce-Tarif. Ohne diesen Tarif weist ein Banner auf der Karte darauf hin, und die Verbindungen bleiben inaktiv.
Was Sie tun werden
- Das PrestaShop-Modul oder die WooCommerce-Erweiterung von der jeweiligen Karte herunterladen.
- Den Shop mit einem API-Schlüssel verbinden.
- Festlegen, welche Seite für Bestand und Katalog maßgeblich ist und wann die Rechnung erstellt wird.
- Die Synchronisierung im Protokoll verfolgen.
Was synchronisiert wird
| Richtung | Daten |
|---|---|
| Shop zu Novadesko | Bestellungen, Kunden, Zahlungen (sobald die Bestellung als „bezahlt“ gilt), Erstattungen und Gutschriften. |
| Novadesko zu Shop | Preise und verfügbarer Bestand der Produkte, einschließlich Varianten und Kombinationen. |
| Beide Richtungen | Übertragung des Shop-Katalogs an Novadesko: Die Produkte werden über Artikelnummer oder EAN verknüpft und angelegt, falls sie fehlen. |
An den Shop wird der verfügbare Bestand gesendet: der tatsächliche Bestand abzüglich der durch offene Bestellungen reservierten Mengen. Nummer und PDF der Novadesko-Rechnung erscheinen in der Bestellansicht, in PrestaShop ebenso wie in WooCommerce.
Einen PrestaShop- oder WooCommerce-Shop verbinden
- Öffnen Sie Integrationen und dann die Karte PrestaShop oder WooCommerce.
- Laden Sie im Modulbereich die ZIP-Datei herunter (Versionsnummer, Build und Neuerungen sind angegeben).
- Installieren Sie sie in Ihrem Shop: Module > Modul hochladen in PrestaShop, Plugins > Installieren > Plugin hochladen in WordPress.
- Erstellen Sie auf der Novadesko-Karte einen API-Schlüssel. Das Secret wird nur ein einziges Mal angezeigt: Kopieren Sie es sofort.
- Fügen Sie den Schlüssel in den Moduleinstellungen in Ihrem Shop ein und starten Sie die Verbindung.
- Der Shop erscheint unter Verbundene Shops. Klicken Sie auf Bearbeiten, um die Synchronisierung einzustellen.
| Modul | Kompatibilität |
|---|---|
| PrestaShop „Novadesko Connect“ | PrestaShop 8 und 9. |
| WooCommerce „Novadesko Connector“ | Aktuelles WooCommerce, mit oder ohne HPOS-Bestellspeicherung. |
Die Einstellungen eines Shops
| Einstellung | Auswahl |
|---|---|
| Zeitpunkt der Rechnung | Bei Zahlung, bei Versand, bei abgeschlossener Bestellung oder manuell. |
| Maßgeblich für den Bestand | Novadesko (Standard) oder der Shop. |
| Maßgeblich für den Katalog | Novadesko (Standard) oder der Shop. |
Die Rechnung folgt dem normalen Nummernkreis Ihres Unternehmens. Eine Bestellung erzeugt nie zwei Rechnungen, und keine Rechnung wird automatisch über Peppol versendet. Ein Wert, der durch die Regel „maßgeblich“ abgelehnt wird, erscheint im Protokoll als Konflikt.
Auf der Karte können Sie eine Verbindung außerdem pausieren, fortsetzen oder trennen, einen Schlüssel widerrufen und das Synchronisierungsprotokoll filtern.
Novadesko Connect für Ihre eigene Website
Novadesko Connect (früher „Shop Connect“) ist die REST-API, die eine selbst entwickelte Website mit Novadesko verbindet. Sie umfasst den Bestand (tatsächlich, reserviert, verfügbar), Produkte und Varianten, Bestellungen, Kunden, Zahlungen, Rechnungen, Gutschriften, PDFs und signierte Webhooks.
- Öffnen Sie Integrationen > Novadesko Connect und erstellen Sie einen API-Schlüssel.
- Folgen Sie der Entwicklerdokumentation: web.novadesko.com/developers/connect (Einstieg, Authentifizierung, Referenz, Webhooks, Beispiele).
- Verwenden Sie bei Bedarf ein offizielles SDK: PHP, Laravel, Python oder JavaScript / Node. Sie lassen sich aus der Dokumentation herunterladen.
Die API akzeptiert 300 Anfragen pro Minute und Schlüssel. Webhooks werden gebündelt (höchstens ein Versand alle 10 Sekunden pro Typ) und nach einer Reihe von Fehlschlägen pausiert: Behalten Sie das Protokoll auf der Karte im Blick.