# Shop anbinden

### Bevor Sie den Shop anbinden

* Erstellen Sie mindestens eine **Versandart** unter **Einstellungen** --> **Finanzen** --> **Versandart**. \
  Für die Versandart ist lediglich ein Name einzutragen.
* Erstellen Sie mindestens einen **Versandkostenartikel** unter **Stammdaten** --> **Artikel**. \
  Der Artikel sollte als Versandkostenartikel erkennbar sein (z.B. den Namen "Versandkosten" tragen) und es sollte keine Checkbox für diesen Artikel ausgewählt sein (z.B. KEINE Bestandsführung für den Artikel auswählen). \
  Sie können in desk4 den Preis für den Versandkostenartikel bestimmen, wie Sie möchten. \
  Wenn wir eine Bestellung vom Shop abrufen, tragen wir die im Shop ermittelten Versandkosten in die Position des Versandkostenartikels ein. \
  (Die Zuweisung von Shop-Versandart zu desk4-Versandart und Versandkostenartikelnummer erfolgt später in der "Versandartzuweisung" der Shop-Optionen in desk4.)<br>
* Optional: Um Ihren DHL-Geschäftskundenaccount an desk4 anzubinden, legen Sie zunächst unter **Einstellungen** --> **Versandanbieter** einen DHL Versandanbieter an. [Hier ](https://docs.desk4.de/einstellungen/versandanbieter/dhl-anbindung)erfahren Sie mehr zu diesem Thema. \
  Über die DHL-Anbindung können Sie DHL-Paket-Label in desk4 drucken.&#x20;
* Optional: Richten Sie eine oder mehrere Shipcloud-Paketzuweisungen ein. \
  Mehr über Shipcloud erfahren Sie [hier](https://docs.desk4.de/einstellungen/shipcloud). \
  Über die Shipcloud-Anbindung können Sie Paket-Label in desk4 drucken.&#x20;

{% hint style="info" %} <mark style="color:red;">Die DHL - und die Shipcloud-Anbindung sind Zusatzmodule und müssen zu desk4 dazu gebucht werden.</mark>
{% endhint %}

### **Shopanbindung: neuen Shop erstellen**

Um einen Shop anzulegen, klicken Sie innerhalb des Menüpunktes **Shopanbindung** auf den "**Neuer Shop"**-Button. &#x20;

**Wählen Sie Ihren Shop-Typen mit einem Klick auf eines der folgenden Icons aus:**

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FvYIjsSO6uM953ozoc3br%2Fimage.png?alt=media&#x26;token=a16d4cae-4596-4ffe-8156-6a372bac998a" alt="Shopware 5, Shopware 6, Gambio, Amazon, Shopify, WooCommerce und eBay"><figcaption><p>Shopware 5, Shopware 6, Gambio, Amazon, Shopify, WooCommerce und eBay</p></figcaption></figure>

{% hint style="info" %}
**Aktuell unterstützen wir folgende Shops: Shopware 5, Shopware 6, Gambio, Amazon, Shopify, WooCommerce und eBay**
{% endhint %}

{% hint style="warning" %} <mark style="color:red;">Wie Sie die</mark> <mark style="color:red;"></mark><mark style="color:red;">**Amazon Schnittstelle**</mark> <mark style="color:red;"></mark><mark style="color:red;">anbinden und konfigurieren, finden Sie</mark> [<mark style="color:red;">**hier**</mark>](https://docs.desk4.de/shopanbindung/amazon-schnittstelle-anbinden-und-konfigurieren)<mark style="color:red;">.</mark>&#x20;
{% endhint %}

### **Hauptdaten**

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FYEnmQQ49ZweztkhXdlLZ%2Fimage.png?alt=media&#x26;token=530c8eca-dc31-4b09-8622-cb0ec577dec7" alt=""><figcaption><p>Je nach Shop-Anbindung können die Felder der Hauptdaten variieren</p></figcaption></figure>

* Geben Sie der Shopanbindung einen **Namen**
* Geben Sie die **Domain** des Shops ein (die Web-Adresse, unter der Ihr Shop aufrufbar ist, die Frontend-URL)\ <mark style="color:red;">**ACHTUNG: Bitte prüfen Sie, ob Ihr Shop mit oder ohne "[www](http://www)." erreichbar ist.**</mark> \ <mark style="color:red;">**Bitte tragen Sie die Domain richtig ein, sonst können wir keine Verbindung mit dem Shop aufbauen.**</mark> \
  (<mark style="color:red;">Ausnahme für Shopify:</mark> Für Shopify wird dieser Punkt unten im individuellen Tab beschrieben)
* <mark style="background-color:green;">**Die nächsten beiden Punkte finden Sie nachfolgend im Tab-Menü individuell pro Shop erklärt**</mark>
* Die Checkbox **SSL** wird ausgewählt, wenn Ihr Shop ein SSL-Zertifikat besitzt (http**s**)\
  (Bei Shopify gibt es diese Checkbox nicht. Dort ist SSL automatisch immer eingestellt).
* Über das Dropdown-Menü **Lager** können Sie diesem Shop Lager aus desk4 zuweisen. \
  Die hier ausgewählten Lager dienen einzig dem Bestandsupdate. D.h. die Bestände aus den ausgewählten Lagern werden addiert und bei einem Bestandsupdate an den Shop gesendet.\
  Standardmäßig werden alle Lager angehakt.&#x20;

{% hint style="info" %}
Gut zu wissen: im Verkaufsbeleg wird immer das Hauptlager (unter Einstellungen -> Filialen  -> \[ausgewählte Filiale]) als Lager bei den einzelnen Positionen voreingetragen.&#x20;
{% endhint %}

{% hint style="warning" %}
**Wichtig für Shopware**:&#x20;

**Nutzen Sie nicht das in Shopware bereits vorhandene desk4-Plugin.**

Dieses muss - falls vorhanden - erst vollständig deinstalliert und entfernt werden.&#x20;

Laden Sie dann das für Sie passende Plugin (Shopware 5 oder Shopware 6) herunter und installieren Sie dieses in Ihrem Shop. Ganz unten auf der Seite führen wir Sie zu dem Link für den Download. \
\
**Nutzen Sie für die Anbindung nicht den in Shopware bereits vorhandenen Benutzer (bei Shopware 5) bzw. die bereits vorhandene Integration (bei Shopware 6) für desk4**. Legen Sie nach der folgenden Anleitung einen neuen Benutzer bzw. eine neue Integration an.
{% endhint %}

### Shop Schnittstelle konfigurieren

Loggen Sie sich im Backend des Shops ein und folgen Sie dann - je nach Shop - einer der folgenden Anleitungen:

{% tabs %}
{% tab title="Shopware 5" %}

### Shopware 5

Gehen Sie in Ihrem Shop auf **Einstellungen** --> **Benutzerverwaltung -->** **Benutzer hinzufügen.**

![](https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FdNi4JHgoVx3FUYABuwNG%2Fgrafik.png?alt=media\&token=47137243-1c9b-4cd2-b427-9afe51b8e60b)

Im sich neu öffnenden Fenster:

1. **Aktivieren** Sie den **Benutzer** über das **Kontrollkästchen**
2. <mark style="background-color:yellow;">Geben Sie dem Benutzer einen</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">**Namen**</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">und tragen Sie diesen in desk4 im Feld</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">**API-User**</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">ein</mark>
3. Geben Sie dem Benutzer ein **Passwort**
4. **Aktivieren** Sie den **API-Zugang** über das **Kontrollkästchen**
5. <mark style="background-color:yellow;">Kopieren Sie den</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">**API-Schlüssel**</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">direkt in das Feld</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">**API-Passwort**</mark> <mark style="background-color:yellow;"></mark><mark style="background-color:yellow;">in desk4</mark>
6. Tragen Sie einen Namen und Ihre E-Mail-Adresse in die Stammdaten und wählen Sie die Standardsprache und die Rolle des angelegten Benutzers (local\_admins).

![](https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FThlqGKHTsYv6sEVERTtw%2Fgrafik.png?alt=media\&token=092bd77d-6b63-4900-8168-967ed5772c85)

Um die Einstellungen in Shopware zu speichern, ist die Passwort - Eingabe des eingeloggten Benutzers / Administrators erforderlich.&#x20;
{% endtab %}

{% tab title="Shopware 6" %}

### Shopware 6

In Shopware 6 wird eine Integration für Ihren Shop angelegt und über die Zugangs-ID und den Sicherheitsschlüssel mit desk4 verbunden.

Gehen Sie hierfür in Ihrem Shop auf **Einstellungen** --> **System** --> **Integration** und legen Sie eine neue Integration an.

1. Geben Sie dieser einen **Namen**
2. Aktivieren Sie den Button bei **Administrator**
3. Kopieren Sie die **Zugangs-ID** direkt in das Feld **Client-ID** in desk4
4. Kopieren Sie den **Sicherheitsschlüssel** direkt in das Feld **Client-Secret** in desk4
5. Speichern Sie Ihre Integration in Shopware

![](https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2F7cgdtPHApT8QvZFEAtUH%2Fgrafik.png?alt=media\&token=07a22fac-7316-42bd-be23-3d7aeeabf229)

{% hint style="info" %}
Der Sicherheitsschlüssel in Shopware 6 ist nur bei der Generierung der Integration sichtbar. Sobald die Integration gespeichert wurde, ist dieser nicht mehr aufrufbar.&#x20;

Falls Sie die Integration geschlossen haben, ohne den Sicherheitsschlüssel in desk4 einzutragen, können Sie die Integration neu generieren lassen. Dabei wird sowohl ein neuer Sicherheitsschlüssel als auch eine neue Zugangs-ID angelegt, die wie im Schritt 3 und 4 erläutert, in desk4 einzutragen sind.&#x20;
{% endhint %}

{% endtab %}

{% tab title="Gambio" %}

### Gambio

Geben Sie dem Shop einen **Namen** und tragen Sie als **Domain** die Startseite für den Kunden ein (Frontend-Adresse).&#x20;

**Zugangsschlüssel:**  \
Erzeugen Sie in Gambio einen **Zugangsschlüssel (API-Token)** \
(Gambio -> Kunden -> Rollen und Berechtigungen -> API Tokens verwalten -> Token erzeugen).&#x20;

Kopieren Sie den Token aus dem Textfeld und fügen Sie diesen in das Feld "Zugangsschlüssel" in Ihrer desk4 Shopanbindung ein. Speichern Sie Ihren Zugangsschlüssel.&#x20;

Wählen Sie die Lager aus, die mit dem Shop verbunden werden sollen.&#x20;
{% endtab %}

{% tab title="Shopify" %}

### Shopify&#x20;

{% hint style="info" %}
&#x20;Voraussetzung ist der Zugriff auf das Shopify Developer Dashboard in Ihrem Shopify Shop.
{% endhint %}

### Name und Domain eintragen

1. Als Namen vergeben Sie einen beliebigen Namen für Ihre Anbindung&#x20;
2. Als Domain tragen Sie die myshopify.com-Adresse ein.&#x20;

Gehen Sie dafür im Backend Ihres Shops auf **Einstellungen -> Domains** und kopieren Sie die Adresse, welche auf ".mshopify.com" endet

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FMUNe4dFiIXr2suDUVYK2%2Fimage.png?alt=media&#x26;token=6530bcaa-e412-4ebe-a4ea-713aea6dc02c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2Fo6JTh6EPhKj4YHEKeJDN%2Fimage.png?alt=media&#x26;token=eeadfb1f-b997-4ba2-96a0-9ddc68a68364" alt=""><figcaption></figcaption></figure>

### App erstellen

**1. Developer Dashboard öffnen**

Shopify **Developer Dashboard** aufrufen

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FHchgxNNj03twghyoTSip%2Fimage.png?alt=media&#x26;token=4f7c2bce-c3ac-4815-9f38-2c40ef9c96f7" alt=""><figcaption></figcaption></figure>

2. **App erstellen**

Klicken Sie rechts oben auf **Create App**

Geben Sie der App dann einen Namen (z.B. desk4\_\<kundenname>) und klicken Sie auf „Create“

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FzXmZ2Vp26WBgF8SicHmR%2Fimage.png?alt=media&#x26;token=06842364-384a-4a9b-a3fa-04a5bf4cf283" alt=""><figcaption></figcaption></figure>

3. **Redirect-URL konfigurieren, Embed app deaktivieren und Webhook API Version einstellen**

Die Redirect-**Url** dient nur zur Kontrolle, ob die Authentifizierung erfolgreich war. Geben Sie eine URL ein, die nach der erfolgreichen Erstellung der App aufgerufen werden soll, z.B. <https://desk4.de>

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FgDbvNskK6xfYk3yfKIk8%2Fimage.png?alt=media&#x26;token=0c7149ca-4bad-4c7a-9715-677b8130e285" alt=""><figcaption></figcaption></figure>

Deaktivieren Sie das Häkchen bei **Embed app in Shopify admin**

Stellen Sie die **Webhook API Version** auf die neueste verfügbare Version in der Auswahl.

**4. API Scopes (Berechtigungen) eintragen**

Im Bereich **Scopes** folgende Rechte hinterlegen:

```
read_analytics,read_app_proxy,write_app_proxy,read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_audit_events,read_customer_events,read_cart_transforms,write_cart_transforms,read_all_cart_transforms,read_validations,write_validations,read_cash_tracking,read_channels,write_channels,read_checkout_branding_settings,write_checkout_branding_settings,write_checkouts,read_checkouts,read_companies,write_companies,read_custom_fulfillment_services,write_custom_fulfillment_services,read_custom_pixels,write_custom_pixels,read_customers,write_customers,read_customer_data_erasure,write_customer_data_erasure,read_customer_merge,write_customer_merge,read_delivery_customizations,write_delivery_customizations,read_price_rules,write_price_rules,read_discounts,write_discounts,read_discounts_allocator_functions,write_discounts_allocator_functions,read_discovery,write_discovery,write_draft_orders,read_draft_orders,read_files,write_files,read_fulfillment_constraint_rules,write_fulfillment_constraint_rules,read_fulfillments,write_fulfillments,read_gift_card_transactions,write_gift_card_transactions,read_gift_cards,write_gift_cards,write_inventory,read_inventory,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,read_legal_policies,write_legal_policies,read_delivery_option_generators,write_delivery_option_generators,read_locales,write_locales,write_locations,read_locations,read_marketing_integrated_campaigns,write_marketing_integrated_campaigns,write_marketing_events,read_marketing_events,read_markets,write_markets,read_markets_home,write_markets_home,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_metaobject_definitions,write_metaobject_definitions,read_metaobjects,write_metaobjects,read_online_store_navigation,write_online_store_navigation,read_online_store_pages,write_online_store_pages,write_order_edits,read_order_edits,read_orders,write_orders,write_packing_slip_templates,read_packing_slip_templates,read_payment_terms,write_payment_terms,read_payment_customizations,write_payment_customizations,read_pixels,write_pixels,read_privacy_settings,write_privacy_settings,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,read_publications,write_publications,read_purchase_options,write_purchase_options,write_reports,read_reports,read_resource_feedbacks,write_resource_feedbacks,read_returns,write_returns,read_script_tags,write_script_tags,read_shopify_payments_provider_accounts_sensitive,read_shipping,write_shipping,read_shopify_payments_accounts,read_shopify_payments_payouts,read_shopify_payments_bank_accounts,read_shopify_payments_disputes,write_shopify_payments_disputes,read_content,write_content,read_store_credit_account_transactions,write_store_credit_account_transactions,read_store_credit_accounts,write_theme_code,read_themes,write_themes,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_translations,write_translations,customer_read_orders,customer_write_orders
```

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FNKkRW01K5QoxIueWe4S4%2Fimage.png?alt=media&#x26;token=84e84d7c-1b22-45f4-b8e6-715934fb3777" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
⚠️ Hinweis: Änderungen an den Scopes erfordern immer eine neue App-Version.
{% endhint %}

&#x20;

**5. App veröffentlichen (Release)**

Klicken Sie auf **Release**, setzen Sie die **Versionsnummer** (z.B. 1.0 für die erste Version) und klicken Sie dann im geöffneten Fenster nochmal auf **Release**

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FsmcMTDZMw3Mq2bfuSmoX%2Fimage.png?alt=media&#x26;token=e3847bde-6136-4bbf-bb3b-85bb62264a0f" alt=""><figcaption></figcaption></figure>

**Versionslogik**

* Start bei **1.0**
* Versionsnummer erhöhen bei:
* Änderung der Scopes
* Hinzufügen / Entfernen von Rechten
* Änderung der Webhook-Version

Beispiel:

* 1.0 → Initial
* 1.1 → Neue API-Rechte
* 2.0 → Größere Änderungen

6. **ID und Secret in desk4 einfügen**

Gehen Sie nun auf den Menüpunkt **Settings**.

Hier können Sie die **Client ID** und das **Secret** für die Eintragung in desk4 kopieren.

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FCJ6Tt3SDT0LFqoeH6bpV%2Fimage.png?alt=media&#x26;token=7e0e3439-0953-44a9-9b6c-977b5365b22c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FEnB8zFU2awiPh0WMkGcr%2Fimage.png?alt=media&#x26;token=84bccbef-85fa-49fe-8f20-e91d3a1ce044" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Achtung! Noch nicht speichern.**&#x20;

Speichern Sie in desk4 erst, wenn Sie Schritt 7 abgeschlossen haben.&#x20;
{% endhint %}

**7. App-Installation**

Klicken Sie dann im Menüpunkt **Home** auf **Install app**

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FaZUG80tA8nI7GIay1JYg%2Fimage.png?alt=media&#x26;token=100820e8-4621-42cd-aab0-aedba844eaab" alt=""><figcaption></figcaption></figure>

Sie melden sich nun neu im Shop an und klicken dort nochmals auf **Install**.

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2Fgw35DvMzKLogBDvX9WNV%2Fimage.png?alt=media&#x26;token=a8c3f7a5-83ec-4ed0-a1d1-c2ee2436c415" alt=""><figcaption></figcaption></figure>

Nach erfolgreicher Installation leitet Shopify nun auf die von Ihnen eingetragene Webseite weiter (z.B. <https://desk4.de>).

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FPGyQh1svz5LXgWnKUXnv%2Fimage.png?alt=media&#x26;token=2c37b1b7-0d34-4326-a21f-9e8448269dbe" alt=""><figcaption></figcaption></figure>

&#x20;

**8. Daten in desk4 speichern**

Nun können Sie die neu eingetragenene Daten in Ihrer Shopanbindung in desk4 speichern.&#x20;
{% endtab %}

{% tab title="WooCommerce" %}

### WooCommerce

Um Ihren WooCommerce Shop mit desk4 verbinden zu können, benötigen Sie einen Schlüssel und ein Secret, welche Sie in desk4 an den entsprechenden Stellen eintragen.<br>

\
Generieren Sie diese, indem Sie in **WordPress** zunächst auf\
**WooCommerce -> Einstellungen** klicken. Öffnen Sie anschließend den Tab **Erweitert** und klicken dort auf **Rest API**. Hier können Sie per **Schlüssel hinzufügen** einen neuen Schlüssel erstellen.

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2Fo4ywVxLdnmsYOnN57VN6%2FBild1.PNG?alt=media&#x26;token=f45afd4c-f310-482d-b83e-a60d2c749fe8" alt=""><figcaption></figcaption></figure>

Geben Sie dazu eine **Beschreibung** für den Schlüssel ein, wählen den **Benutzer** aus und setzen die entsprechende **Berechtigung (Lesen/Schreiben)**. Per Klick auf API-Schlüssel erstellen, werden Ihr Schlüssel und das Secret erstellt.

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2F9EWvHKy8rk3qMv08JYQk%2Fimage.png?alt=media&#x26;token=64ad7c21-db69-4189-b40b-eff8805bbf18" alt=""><figcaption></figcaption></figure>

Geben Sie beide nun in die entsprechenden Felder im desk4-Shop ein.

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FW2AlFvTCIvZn9wa9LZFd%2FBild3.PNG?alt=media&#x26;token=04e08a67-a730-4607-be39-b36e1cf876b1" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Tragen Sie Schlüssel und Secret direkt nach dem Erstellen in desk4 ein, da diese beim Verlassen der Seite versteckt werden und nicht mehr aufgerufen werden können. \
Benötigen Sie die Informationen erneut, so können Sie in WooCommerce einen neuen Schlüssel anlegen und das Schlüssel-Secret-Paar in desk4 eintragen.&#x20;
{% endhint %}
{% endtab %}
{% endtabs %}

### **Connector Aktivitäten**

<figure><img src="https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FoWGNF9N82HonAslnFn5m%2Fimage.png?alt=media&#x26;token=8480a983-fc76-4e2a-8a60-1e363fc9ff49" alt=""><figcaption></figcaption></figure>

Je nach Shop variieren die Auswahlmöglichkeiten. Ist die Auswahl nicht gegeben, erfolgt die Aktion zumeist automatisch und muss deswegen nicht mehr ausgewählt werden:

* **Auftragsbestand abziehen**: Bei der Bestandsaktualisierung wird die Anzahl der Artikel, die in Aufträgen geführt sind, vom Bestand abgezogen.\
  (Bei Shopify wird der Auftragsbestand automatisch abgezogen.)
* **Bestellbestand berücksichtigen**: Bei der Bestandsaktualisierung wird die Anzahl der bestellten Artikel auf den Bestand addiert.

**Auf versendet setzen**

Der Status der Bestellung im Shop kann automatisiert auf "Versandt" gesetzt werden. Hierfür haben Sie folgende Möglichkeiten:

* **Durch Lieferschein auf versendet setzen:** Wenn Sie in desk4 den Auftrag aus dem Shop zum Lieferschein weiterführen, wird der Versandstatus im Shop automatisch auf versendet gesetzt
* **Durch Rechnung auf versendet setzen**: Wenn Sie in desk4 den Auftrag aus dem Shop zu einer Rechnung weiterführen, wird der Versandstatus im Shop automatisch auf versendet gesetzt
* **Durch Labeldruck auf versendet setzen**: Wenn ein Label zu dem Auftrag gedruckt wird, wird der Versandstatus im Shop automatisch auf versendet gesetzt
* **Bruttopreise übertragen** (nur für WooCommerce): Die Einstellung muss mit der Shopeinstellung für Brutto-/Nettopreise übereinstimmen (WooCommerce -> Einstellungen -> Steuern). \
  Wenn im Shop eingestellt ist, dass Sie die Preise inklusive Mehrwertsteuer eingeben (Bild), dann klicken Sie in desk4 die Checkbox an, dass Bruttopreise übertragen werden. \
  ![](https://901075246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBlYqQ7S4FQO2M6oDBNFF%2Fuploads%2FskeXTwksdVWJh0QDXWvg%2Fimage.png?alt=media\&token=bcda36b7-925c-42b4-a580-4646c76bf920)\
  \
  Wenn der Shop für Nettopreise eingestellt ist, muss desk4 auch entsprechend konfiguriert sein.\
  Klicken Sie in diesem Fall die Checkbox für "Bruttopreise übertragen" nicht an. \
  \ <mark style="color:$info;">(Auch mit aktivem B2B-Market-Plugin und gemischten Netto und Bruttogruppen ist das der Fall. Die Einstellung dort ist nur für den Preis, den der Kunde angezeigt bekommt.</mark> \ <mark style="color:$info;">Die Übertragung selbst muss trotzdem nach der Shopeinstellung (WooCommerce -> Einstellungen -> Steuern) erfolgen).</mark>

{% hint style="warning" %}
Sie können alle "**auf versendet setzen**" - **Häkchen** bedenkenlos gleichzeitig setzen. desk4 prüft, ob der Status schon auf versendet gesetzt wurde und löst dies nicht mehrfach aus.&#x20;
{% endhint %}

{% hint style="info" %}
**Sendungsverfolgungsnummern**

Sendungsverfolgungsnummern werden nach der Erstellung eines Pakets (DHL oder Shipcloud) an den Shop gesendet (außer WooCommerce).&#x20;

Bei WooCommerce wird nur der Status geändert. &#x20;
{% endhint %}

### Kundenverknüpfung

**Kundenverknüpfung** **zwischen Shopkunden und Ihren angelegten Kunden in desk4**

desk4 kann die E-Mail-Adresse der Shop-Bestellung mit den Kundendaten und den Daten der Ansprechpartner vergleichen.

Wenn die E-Mail-Adresse vorhanden ist, wird die Shop-Bestellung diesem Kunden zugeordnet.\
Wenn die E-Mail-Adresse nicht vorhanden ist, wird automatisch ein neuer Kunde angelegt.

Es ist sinnvoll, beide Checkboxen zu aktivieren.

{% hint style="warning" %} <mark style="color:red;">Wie Sie nun die</mark> <mark style="color:red;"></mark><mark style="color:red;">**Amazon Schnittstelle**</mark> <mark style="color:red;"></mark><mark style="color:red;">anbinden und konfigurieren, finden Sie</mark> [<mark style="color:red;">**hier**</mark>](https://docs.desk4.de/shopanbindung/amazon-schnittstelle-anbinden-und-konfigurieren)<mark style="color:red;">.</mark>&#x20;
{% endhint %}

{% hint style="warning" %} <mark style="color:red;">Wenn Sie nun die</mark> <mark style="color:red;"></mark><mark style="color:red;">**Gambioschnittstelle**</mark> <mark style="color:red;"></mark><mark style="color:red;">konfigurieren wollen klicken Sie</mark> [<mark style="color:red;">**hier.**</mark>](https://docs.desk4.de/shopanbindung/gambioschnittstelle-konfigurieren)&#x20;
{% endhint %}

{% hint style="warning" %} <mark style="color:red;">Wenn Sie nun die</mark> <mark style="color:red;"></mark><mark style="color:red;">**shopify**</mark> <mark style="color:red;"></mark><mark style="color:red;">konfigurieren wollen klicken Sie</mark> [<mark style="color:red;">**hier**</mark>](https://docs.desk4.de/shopanbindung/shopify-schnittstelle-konfigurieren)<mark style="color:red;">**.**</mark>&#x20;
{% endhint %}

{% hint style="warning" %} <mark style="color:red;">Wenn Sie nun das</mark> <mark style="color:red;"></mark><mark style="color:red;">**Shopware-Plugin**</mark> <mark style="color:red;"></mark><mark style="color:red;">installieren wollen klicken Sie</mark> [<mark style="color:red;">**hier.**</mark> ](https://docs.desk4.de/shopanbindung/installation-shopware-plugin)
{% endhint %}

{% hint style="warning" %} <mark style="color:red;">Wenn Sie nun die</mark> <mark style="color:red;"></mark><mark style="color:red;">**WooCommerce**</mark> <mark style="color:red;">**Schnittstelle**</mark> <mark style="color:red;"></mark><mark style="color:red;">konfigurieren möchten, klicken Sie</mark> [<mark style="color:red;">**hier**</mark>](https://docs.desk4.de/shopanbindung/woocommerce-schnittstelle-konfigurieren).
{% endhint %}