Amazon-Konnektor für Dolibarr: Bestellungen, FBA, Lager, Sendungsverfolgung und Abrechnungen

Verbinden Sie Dolibarr mit der Selling Partner API von Amazon und lassen Sie die Informationen in beide Richtungen fließen. Bestellungen mit Versand durch Sie oder durch Amazon werden zu Bestellungen, Lieferungen und Rechnungen; der Lagerbestand und die Sendungsnummern gehen an Amazon zurück; Abrechnungen und Retouren werden Zeile für Zeile übernommen. Jeder Austausch hinterlässt eine Warteschlange, deren fehlerhafte Zeilen automatisch erneut ausgeführt werden. Ein Simulationsmodus erlaubt es, alles einzurichten und vorzuführen, ohne Amazon-Konto. 

Für wen? Amazon-Verkäufer, die ihr Geschäft in Dolibarr führen: Marken, Distributoren, länderübergreifende Wiederverkäufer, Online-Händler mit FBM ebenso wie mit FBA, sowie die Integratoren, die sie begleiten. Ein Marketplace oder zwanzig, ein Verkäuferkonto oder mehrere – das Prinzip bleibt dasselbe.

Verkäuferkonten und Instanzen

• Ein Verkäuferkonto enthält die Zugangsdaten einer Amazon-Anwendung, die API-Region und die Standardwerte: Ersatzkunde, Vertriebsmitarbeiter, Lager, Bank, Versandartikel.
• Eine Instanz verbindet dieses Konto mit einem Marketplace: Sie trägt die Währung, die Lager, den Workflow, die Bestandsregel und die Mehrwertsteuer.
• 23 Marketplaces mit ihrer tatsächlichen Kennung eingerichtet, verteilt auf die drei Regionen: Nordamerika, Europa, Fernost.
• Mehrere Verkäuferkonten und so viele Instanzen wie nötig, jeweils mit eigenen Einstellungen.
• Ein Verbindungstest fordert ein Token an und liest anschließend die Marketplaces des Kontos; er unterscheidet ein Problem mit den Zugangsdaten von einem Problem mit der Rolle oder der Region.

Import der Bestellungen

• Import der Bestellungen mit Versand durch den Verkäufer (FBM) und der Bestellungen mit Versand durch Amazon (FBA), damit der Umsatz vollständig ist.
• Käufer, Lieferadresse, Positionen, Beträge, Mehrwertsteuer, Versandkosten und Versandzeitfenster werden übernommen.
• Der Konnektor setzt immer bei der letzten Synchronisierung an. Eine bei Amazon geänderte Bestellung wird erneut übernommen.
• Eine stornierte Bestellung wird geschlossen, ohne dass etwas angelegt wird; eine bei Amazon ausstehende Bestellung bleibt zunächst unberücksichtigt und wird später automatisch übernommen.
• Suche und Filter nach Bestellnummer, Käufer, Ort, Sendungsverfolgung, Status, Versandkanal und Workflow-Zustand.
• Die Detailansicht stellt gegenüber, was von Amazon kommt und was in Dolibarr vorhanden ist, mit direkten Links zu Bestellung, Lieferung und Rechnung.

Ein Workflow mit zehn Schaltern

• Zehn Schalter bestimmen je Instanz, was angelegt wird: Kunde anlegen, Bestellung validieren, Lieferung anlegen, Lieferung validieren, Rechnung anlegen, Rechnung validieren, Zahlung erfassen, Lagerbestand senden, Sendungsnummer senden.
• Ein deaktivierter Schritt wird einfach übersprungen: Die Bestellung bleibt auf der erreichten Stufe und wird manuell abgeschlossen.
• Jeder abgeschlossene Schritt wird sofort festgeschrieben: Ein unterbrochener Durchlauf setzt dort fort, wo er stehengeblieben ist, nie von vorn.
• Ein unbekannter Käufer wird zu einem Geschäftspartner oder wird wahlweise dem Ersatzkunden des Kontos zugeordnet.
• Eine Bestellung, deren Position ein nicht zugeordnetes Angebot trägt, wird auf Fehler gesetzt statt falsch angelegt: zuordnen, erneut starten, sie läuft weiter.
• Die Zahlung wird auf dem Bankkonto des Verkäuferkontos erfasst, mit der Amazon-Bestellnummer als Referenz.

Angebote und Produktzuordnung

• Import der Angebote des Verkäufers: SKU, ASIN, Titel, Marke, Barcode, Preis, Menge, Versandkanal und Status.
• Automatische Zuordnung zum Dolibarr-Produkt über Referenz, Barcode, Zusatzfeld Amazon SKU und schließlich Bezeichnung.
• Eine Übereinstimmung, die allein über die Bezeichnung gefunden wurde, wird als unsicher markiert statt stillschweigend übernommen; bei mehreren gleichnamigen Produkten erfolgt keine Zuordnung.
• Manuelle Zuordnung direkt in der Liste, ohne den Bildschirm zu verlassen, sowie eine Schaltfläche „Alles zuordnen, was zugeordnet werden kann“.
• Ein Angebot, das nie verarbeitet werden soll, wird auf ignoriert gesetzt; fehlende Produkte werden auf Wunsch automatisch angelegt.
• Die Produktkarte von Dolibarr zeigt die Amazon-Angebote an, die ihr zugeordnet sind.

Lagerbestand in beide Richtungen

• Übermittlung des Lagerbestands an Amazon mit fünf Methoden: feste Menge, realer Bestand, virtueller Bestand, realer Bestand abzüglich einer Reserve, Prozentsatz des realen Bestands.
• Eine optionale Obergrenze und eine angegebene Bearbeitungszeit begleiten jede Übermittlung.
• Eine Vorschau zeigt Angebot für Angebot die Menge, die übermittelt würde: Die Regel lässt sich prüfen, bevor sie ausgelöst wird.
• In der Gegenrichtung wird der von Amazon gehaltene Bestand gelesen und per Lagerbewegung in ein eigenes Lager übernommen: Der Bestand in Dolibarr wird damit vollständig.
• Die Sendungsnummern der validierten Lieferungen gehen an Amazon zurück; damit gilt die Bestellung als versandt und die Auszahlung an den Verkäufer wird ausgelöst.

Abrechnungen und Retouren

• Import der Finanzbewegungen von Amazon, nach Zeitraum gruppiert: Verkäufe, Mehrwertsteuer, Provisionen, FBA-Gebühren, Erstattungen und Abonnement.
• Fünf Summen je Abrechnung – Saldo, Verkäufe, Gebühren, Erstattungen, Sonstiges – und die Aufstellung Zeile für Zeile, verknüpft mit den bekannten Bestellungen.
• Die Antwort auf die Frage der Buchhaltung: warum die Überweisung von Amazon nicht dem Umsatz entspricht.
• Import der von Amazon bearbeiteten Kundenretouren: Kennung, Bestellung, SKU, Zustand der Ware, Grund, Logistikzentrum.
• Eine wiederverkäufliche Retoure wird mit einem Klick durch eine Bewegung im Amazon-Lager wieder eingebucht.

Warteschlangen und Wiederholung

• Jeder Austausch eröffnet eine Warteschlange mit einer Zeile je übernommenem Datensatz und dessen Nutzdaten.
• Eine fehlerhafte Zeile behält ihren Inhalt und ihren Fehlergrund: Sie beheben die Ursache und wiederholen die Fehler, ohne etwas erneut bei Amazon abzufragen.
• Klare Zustände: läuft, abgeschlossen, teilweise, fehlerhaft, nichts zu tun. Fortschritt, Dauer und Auslöser – manuell, geplant, automatisch, Wiederholung.
• Neun geplante Aufgaben eingerichtet: Bestellungen, Workflow, Sendungsverfolgung, Lagerbestand, Amazon-Bestand, Angebote, Abrechnungen, Retouren, Wartung.
• Ein Kommandozeilenskript startet dieselben Verarbeitungen für einen externen Planer oder eine Wiederaufnahme.
• Ein Aufrufprotokoll hält Vorgang, HTTP-Code, Dauer sowie einen Auszug aus Anfrage und Antwort fest.

Sicherheit und personenbezogene Daten

• Die drei Amazon-Zugangsdaten werden verschlüsselt gespeichert und nie wieder im Klartext angezeigt.
• Sie erscheinen niemals im Protokoll: Der Aufruf, der das Token austauscht, hält nur seine Art fest. Das Protokoll kann einem technischen Support zugänglich gemacht werden.
• Eine bei einer Änderung leer gelassene Zugangskennung behält den gespeicherten Wert; jede Änderung macht das zwischengespeicherte Token ungültig.
• Die Daten der Käufer werden nach einer von Ihnen festgelegten Frist automatisch gelöscht, wie Amazon es verlangt. Beträge und Buchhaltungsbelege bleiben erhalten.
• Sieben getrennte Rechte: ansehen, anlegen, löschen, synchronisieren, Workflow ausführen, Protokoll ansehen, konfigurieren.
• Der Simulationsmodus erzeugt Bestellungen, Angebote, Bestände, Finanzbewegungen und Retouren lokal aus Ihren eigenen Produkten: Nichts verlässt den Server, und das Ergebnis ist reproduzierbar.

Technische Informationen

• Kompatibel mit Dolibarr 16 und höher (getestet mit 23.x), PHP 7.4 bis 8.4, MySQL/MariaDB, mandantenfähig.
• Erforderliche Module: Produkte, Bestellungen, Rechnungen, Geschäftspartner. Lager, Lieferungen, Banken und Projekte werden genutzt, sofern sie aktiv sind.
• Installation über das Standardverfahren zum Hochladen von Modulen, ohne Änderung am Dolibarr-Kern.
• 13 eigene Tabellen, vollständiger SP-API-Client mit Paginierung, Wiederaufnahme bei Drosselung, komprimierte Feeds und Berichte.
• 5 Sprachen: Französisch, Englisch, Spanisch, Deutsch, Italienisch. PDF-Dokumentation enthalten, Support durch NextGestion.

Demo des Moduls Amazon Connector
Benutzername : demo
Passwort : demo