I. Einrichtung der Schnittstelle
Voraussetzung für die Anbindung:
Ein aktiver API Zugang in Billbee (Einstellungen–> Billbee API)
https://hilfe.billbee.io/article/444-api-zugriff-einrichten
Benötigte Daten:
- Billbee Username (i.d.R. E-Mail Adresse)
- Dein API-Passwort
- OrderStateId/gewünschter Abrufstatus (“3” = bezahlt)
- storageLocationId (0 Standard, nur im Falle von Multilager)
- ordersTag (z.B. “wemalo”)
II. Verhalten der Schnittstelle
Die Schnittstelle synchronisiert die Daten in einem Intervall von 60 Minuten.
Artikel:
Neuen Artikel anlegen:
Es werden alle Produkte importiert. Pichtfelder sind SKU und EAN.
Änderung von Artikeldaten:
Grundsätzlich werden alle Änderungen übernommen, es sei denn, die Änderung erfolgt zu einer SKU/EAN, die bereits in der Wemalo-Datenbank vergeben ist. Auch werden Anpassungen der Artikelmaße nicht übernommen, sollte das Produkt bereits importiert sein
Set-Artikel:
Bundles/Set-Artikel können in WeClapp angelegt werden. Die Schnittstelle übergibt allerdings neben den Unterpositionen auch die Set-SKU, sodass eine weitere Konguration nötig ist. Kontaktiere hierzu bitte deinen Ansprechpartner.
Aufträge:
Auftrag übermitteln:
Sobald “OrderTag” und kongurierter Status (s.o.) gesetzt sind, wird der Auftrag importiert. Nach Abruf erhält der Auftrag das Tag “order_received_by_OrdersTag”.
OrderTags können über eine Regel automatisiert in Billbee erzeugt werden.
Änderung am Auftrag:
Falls Änderungen an einem Auftrag übermittelt werden sollen (nur möglich, wenn der wemalo-Status noch nicht “in Bearbeitung” ist), muss das Tag “order_received_by_OrdersTag” entfernt und erneut das Tag “OrderTag” gesetzt werden, damit der Auftrag im nächsten Intervall berücksichtigt wird.
Änderung ist versandt:
Sobald das Paket übergeben an den Carrier übergeben wurde, wird der Status “Versendet” inkl. der Trackingnummern an Billbee übermittelt. Soll auch der Name des Carriers übermittelt werden, muss das Versandprol in Billbee identisch zu dem Prol aus dem wemalo-System benannt sein. Eine genaue Anleitung findest du hier: https://help.wemalo.com/link