Allgemeines
Falcana bietet eine Schnittstelle zum Onlineshop WooCommerce, welche Daten zwischen WooCommerce und falcana abgleicht. Somit können Kunden, Produkte und Bestellungen aus WooCommerce direkt an falcana übertragen werden.
„Der Abgleich der Daten zwischen WooCommerce und falcana“ ist eine kostenpflichtige Erweiterung von falcana. Für eine Freischaltung oder individuelle Anpassung wenden Sie sich bitte an das falcana-Team.
Webhooks
In WooCommerce können Webhooks hinterlegt werden, welche beim Anlegen oder Ändern von Daten diese automatisch an falcana übertragen (neu angelegt bzw. aktualisiert):
Kunden: Wird ein Kunde in WooCommerce neu angelegt, aktualisiert oder gelöscht, so werden die Änderungen in falcana übernommen.
Produkte: Wird ein Produkt in WooCommerce neu angelegt, aktualisiert oder gelöscht, so werden die Änderungen in falcana übernommen.
Bestellungen: Wird eine Bestellung in WooCommerce neu angelegt, aktualisiert oder gelöscht, so werden die Änderungen in falcana übernommen.
Abgleich der Daten
Werden Änderungen an Kunden, Produkte oder Bestellungen in WooCommerce durchgeführt (z.B. Neuanlage eines Kunden, Löschen eines Artikels, Aktualisieren einer Bestellung), so werden diese sofort mit falcana abgeglichen.
Es kann bei der Schnittstelleneinrichtung definiert werden, bei welchem Bestellstatus Bestellungen an falcana übertragen werden.
Übertragene Daten
Im folgenden Wird beschrieben, welche Daten von WooCommerce in falcana übernommen werden.
Adressen
Wird ein Kunde von Regiondo übermittelt, so werden folgende Kundendaten in falcana als Adresse angelegt/aktualisiert:
| Bezeichnung falcana | Bezeichnung WooCommerce | Details |
| Name 1 | Nachname (last_name) | Handelt es sich um einen Firmenkunden, so wird der Firmenname gegebenenfalls auf Name 1 und Name 2 in falcana aufgeteilt. |
| Name 2 | Vorname (first_name) | – |
| Art | – | Bei Firmenkunden wird hier in falcana „Firma“ gesetzt, ansonsten „Privatperson“. |
| Tel. | Telefon (phone) | – |
| Straße | Adresszeile 1 (address_1), Adresszeile 2 (address_2) | Die Adresszeilen werden in das Feld „Straße“ in falcana übernommen. |
| Stadt | Stadt (city) | – |
| State | Bundesland / Landkreis (state) | – |
| PLZ | Postleitzahl (postcode) | – |
| Land | Land / Region (country) | – |
| Typ | Rolle (role) | Wurde durch falcana ein Standard-Typ definiert, so wird immer dieser verwendet. Ist dies nicht der Fall, wird der Typ über die Rolle in WooCommerce gesetzt. |
Artikel
Wird ein Produkt von WooCommerce übermittelt, so werden folgende Produktdaten in falcana als Artikel angelegt/aktualisiert:
| Bezeichnung falcana | Bezeichnung WooCommerce | Details |
| Artikelname | Produktname (title) | – |
| der angegebene Preis ist netto | Preise mit Steuern eingegeben (article_price_is_net) | – |
| Produktgruppe | Produkt-Kategorie (id) | Wird eine Produktgruppe übertragen, welche in falcana noch nicht existiert, so wird diese angelegt und zugeordnet. |
| Details | Produktbeschreibung (description) | – |
| VK-Preis | Regulärer Preis (regular_price) | – |
| VK-Preis-Neu | Angebotspreis (sale_price) | – |
Auftragsmappe / Rechnung
Wird eine Bestellung von WooCommerce übermittelt, so werden folgende Bestelldaten in falcana als Auftragsmappe mit Rechnung angelegt/aktualisiert:
| Bezeichnung falcana | Bezeichnung WooCommerce | Details |
| Allgemeine Info | Kundenanmerkung (customer_note) | – |
| Bestellnummer | Bestellnummer (number) | – |
| Bezeichnung falcana | Bezeichnung WooCommerce | Details |
| Sonder-Zahlungskondition | Zahlungsmethode (method_id, payment_method) | – |
| Allgemeine Anmerkungen | Kundenanmerkung (customer_note) | – |
| z. Hd. (Lieferadresse) | Vorname (first_name), Nachname (last_name) | Wird nur bei Firmenkunden gesetzt. |
| Name (Lieferadresse) | Firma (company), Vorname (first_name), Nachname (last_name) | Für Firmenkunden wird die Firma gesetzt, für Privatkunden wird Vorname und Nachname gesetzt. |
| Straße (Lieferadresse) | Adresszeile 1 (address_1), Adresszeile 2 (address_2) | Die Adresszeilen werden in das Feld „Straße“ in falcana übernommen. |
| Stadt (Lieferadresse) | Stadt (city) | – |
| PLZ (Lieferadresse) | Postleitzahl (postcode) | – |
| Land (Lieferadresse) | Land / Region (country) | – |
Rechnungspositionen werden sowohl für den bestellten Artikel, als auch für Gutscheine oder berechnete Versandkosten angelegt.
| Bezeichnung falcana | Bezeichnung WooCommerce | Details |
| Artikelname | Produktname (name) | – |
| Artikel-Nr. | Artikelnummer (sku) | – |
| der angegebene Preis ist netto | Preise mit Steuern eingegeben (position_price_is_net) | – |
| VK-Preis | Regulärer Preis (price) | – |
| VK-Preis-Neu | Kosten (total) | – |
| Anzahl | Anz. (quantity) | – |
| Einheit | – | Ist fix „Stk.“. |
| Mwst.-Satz | – | Wird aus der Bestellung berechnet und in falcana neu angelegt, falls noch nicht vorhanden. |
Einrichtung in falcana
Bei der Schnittstelleneinrichtung werden von falcana die zu WooCommerce verlinkten Daten mithilfe von speziellen Individualfelder gekennzeichnet. Diese werden von falcana eingerichtet.
- Auftragsmappe: Bestellnummer der WooCommerce-Bestellung.
- Artikel: Checkbox, ob der Artikel an WooCommerce beim Speichern übertragen werden soll.
Für die Kommunikation zwischen WooCommerce und falcana muss in WooCommerce ein Consumer-Key erzeugt und in falcana verschlüsselt hinterlegt werden. Zusätzlich werden in den API-Einstellungen von WooCoomerce die Webhook-URLs von falcana hinterlegt.