falcana bietet eine Anbindung zur Webshop-Software Shopify an. Über eine entsprechend konfigurierte Schnittstelle können Bestellungen und Kundendaten von Shopify an falcana übertragen werden.
Hinweis: Bei dieser Schnittstelle handelt es sich um eine kostenpflichtige Erweiterung. Bei Interesse steht das >> falcana Team gerne mit Auskünften zur Verfügung. 🚀
Erforderliche Webhooks
In Shopify werden sogenannte „Webhooks“ hinterlegt, welche beim Anlegen oder Ändern von Daten diese automatisch an falcana übertragen.
➡️ Kunden (Adressen): Wenn sich Daten eines Kunden ändern, werden diese an falcana übertragen und hier ebenfalls aktualisiert.
➡️ Produkte (Artikel): Wenn sich Daten eines Produktes ändern, werden diese an falcana übertragen und hier ebenfalls aktualisiert.
➡️ Bestellungen (Auftragsmappe/Rechnung): Wenn sich Daten einer Bestellung ändern, werden diese an falcana übertragen und hier ebenfalls aktualisiert.
Datenabgleich
Sobald ein Kunde, ein Produkt oder eine Bestellung in Shopify geändert werden, erfolgt bei aktivierter Schnittstelle ein umgehender Datenabgleich.
Nachstehend werden die Inhalte des Datenabgleichs bzw. die möglichen Felder aufgelistet.
Adressen
| Bezeichnung falcana | Bezeichnung Shopify | Details |
|---|---|---|
| Name 1 | Nachname (last_name, company) | Handelt es sich um einen Firmenkunden, so wird der Firmenname (company) 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 (address1), Adresszeile 2 (address2) | Die Adresszeilen werden in das Feld „Straße“ in falcana übernommen. |
| Stadt | Stadt (city) | – |
| State | Bundesland / Landkreis (province) | – |
| PLZ | Postleitzahl (zip) | – |
| Land | Land / Region (country_code) | – |
Ansprechpartner
Ist der Kunde eine Firma, so wird bei gesetztem Nachnamen des Kunden auch ein Ansprechpartner angelegt.
| Bezeichnung falcana | Bezeichnung Shopify | Details |
|---|---|---|
| Name 1 | Nachname (last_name) | – |
| Name 2 | Vorname (first_name) | – |
| Tel. | Telefon (phone) | – |
| E-Mail (email) | – |
Artikel
Sind in Shopify mehrere Varianten für ein Produkt angelegt, so wird jede Variante als eigener Artikel in falcana angelegt.
Es werden nur Artikel abgeglichen, welche eine SKU (= Stock Keeping Unit / Artikelnummer) in Shopify hinterlegt haben.
Wird ein Produkt von Shopify übermittelt, so werden folgende Produktdaten in falcana als Artikel angelegt oder aktualisiert:
| Bezeichnung falcana | Bezeichnung Shopify | Details |
|---|---|---|
| Artikel-Nr. | SKU (sku) | Die SKU muss für alle Artikel in Shopify hinterlegt sein, welche abgeglichen werden sollen. |
| Artikelname | Produktname (title) | – |
| Produktgruppe | Produkt-Kategorie (product_id) | Die Produktgruppe für die übertragenen Artikel kann bei der Schnittstellen-Einrichtung definiert werden. |
| Details | Produktbeschreibung (body_html) | Es wird nur der Text ohne HTML-Formatierungen übernommen. |
| der angegebene Preis ist netto | – | Ob die Preise Brutto oder Netto übergeben werden, kann bei der Schnittstellen-Einrichtung definiert werden. |
| VK-Preis | Vergleichspreis (compare_at_price) | – |
| VK-Preis-Neu | Preis (price) | – |
Auftragsmappe / Rechnung
Wird eine Bestellung von Shopify übermittelt, werden die nachstehenden Bestelldaten in falcana als Auftragsmappe mit Rechnung angelegt oder aktualisiert.
Zusätzlich wird der Kunde für die Bestellung angelegt oder aktualisiert.
| Bezeichnung falcana | Bezeichnung Shopify | Details |
|---|---|---|
| Allgemeine Info | Notizen (order_info) | – |
| Bestellnummer | Bestellnummer (order_number) | Wird in falcana als Individualfeld bei der Schnittstellen-Einrichtung angelegt und mit der Bestellnummer in Shopify befüllt. |
In der Auftragsmappe wird eine neue Rechnung erstellt.
| Bezeichnung falcana | Bezeichnung Shopify | Details |
|---|---|---|
| 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 (delivery_country) | – |
| Dokumentennummer | – | Wird in falcana als Individualfeld bei der Schnittstellen-Einrichtung angelegt und mit der internen Id der Bestellung in Shopify befüllt. |
Für jede Position der Bestellung wird eine Rechnungsposition in falcana erstellt. Zusätzlich werden die Versandkosten als eigene Position angeführt.
| Bezeichnung falcana | Bezeichnung Shopify | Details |
|---|---|---|
| Artikelname | Produktname (name) | – |
| Artikel-Nr. | Artikelnummer (sku) | – |
| der angegebene Preis ist netto | – | Ob die Preise Brutto oder Netto übergeben werden, kann bei der Schnittstellen-Einrichtung definiert werden. |
| VK-Preis | Vergleichspreis (presentment_money) | – |
| VK-Preis-Neu | Preis (shop_money) | – |
| Anzahl | Anzahl (quantity) | – |
| Einheit | – | Ist fix „Stk.“. |
| Mwst.-Satz | Mehrwertsteuer (rate) | – |
Einrichtung in falcana
Bei der Schnittstellen-Einrichtung werden die mit Shopify verlinkten Daten mit Hilfe spezieller Individual-Felder gekennzeichnet. Diese Individual-Felder werden von falcana eingerichtet.
➡️ Auftragsmappe: Bestellnummer der Shopify-Bestellung.
➡️ Rechnung: Interne ID des Rechnungsdokuments.
Wichtig: Hier handelt es sich um einen rein unidirektionalen Datenabgleich. Informationen werden ausschließlich von Shopify nach falcana übertragen. Es findet keine Datenübertragung von falcana nach Shopify statt.