# WooCommerce Schnittstelle konfigurieren

{% hint style="info" %}
1\) Bevor die WooCommerce Anbindung konfiguriert werden kann,\
muss der **Shop zuerst angebunden werden**. Dies ist [**hier**](/shopanbindung/shop-anbinden.md) beschrieben.
{% endhint %}

{% hint style="info" %}
2\) Installieren Sie im nächsten Schritt das WooCommerce Plugin "dupp\_products\_plugin.zip"!

(Das Plugin dient dazu, Ihre Shop Kundengruppen mit desk4-Preislisten verbinden zu können). 
{% endhint %}

Anleitung: 

Laden Sie das aktuelle Plugin herunter:

{% file src="/files/vQ6gw8UQTe0cKuChSur7" %}

Gehen Sie im Backend Ihres WooCommerce-Shops auf **Plugins --> Neues Plugin hinzufügen**

<figure><img src="/files/CM8z2Tu3AEwu9UhMlK6l" alt=""><figcaption></figcaption></figure>

Klicken Sie auf **Plugin hochladen** und dann auf **Durchsuchen**.&#x20;

Laden Sie nun das zuvor heruntergeladene Plugin in den Shop und installieren Sie dieses.&#x20;

<figure><img src="/files/IwkIngkxMFvJ3KeoLKPh" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Manchmal ist es möglich, dass beim Mac die zip-Datei nicht als solche erkannt wird. In diesem Fall können Sie die Datei neu packen und dann nochmal hochladen.&#x20;
{% endhint %}

Aktivieren Sie anschließend das Plugin.&#x20;

<figure><img src="/files/uppG9FBrxr8Ly4SRjHiL" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
3\) Ist der Shop angebunden und das Plugin installiert, können Sie die Schnittstelle nach der unten stehenden Anleitung konfigurieren.
{% endhint %}

Die Konfiguration der Shop Schnittstelle finden Sie im linken Seitenmenü unter **Shopanbindung**. Öffnen Sie mit Hilfe des roten Stift-Buttons den jeweiligen WooCommerce-Shop,\
den Sie konfigurieren möchten.\
Anschließend klicken Sie im oberen Reiter auf **Optionen** und gelangen in folgende Ansicht:

<figure><img src="/files/pATXbr09dIHlpJIpbdPX" alt=""><figcaption></figcaption></figure>

### Zahlungsbedingungenzuweisung

Weisen Sie die Shop-Zahlungsarten den äquivalenten Desk4-Zahlungsbedingungen zu.\
Klicken Sie auf den "**Eintrag hinzufügen**"-Button, um eine neue Zuweisung zu erzeugen.

Wählen Sie nun auf der linken Seite das Modul für die Shop-Zahlungs-Art\
(in **WordPress** unter **WooCommerce ->** **Einstellungen -> Zahlungen.** \
Klicken Sie evtl. auf **alle Zahlungsmethoden**, um sich alle Zahlungsmethoden anzeigen zu lassen.)

und auf der rechten Seite die passende desk4-Zahlungsbedingung\
(in **desk4** unter **Einstellungen -> Finanzen -> Zahlungsbedingungen**)

{% hint style="warning" %}
Sie sollten beim Klicken auf "Wählen" der Shop-Zahlungs-Art" schon alle verfügbaren Zahlungsbedingungen aus Ihrem Shop angezeigt bekommen. \
\
![](/files/QVL9UwfMwpRjauFpOlXU)

Falls dies nicht der Fall ist, prüfen Sie, ob Sie die Domain (<mark style="color:red;">z.B. mit oder ohne "www"?</mark>) und den Schlüssel im Reiter "Shop" richtig eingetragen haben.

{% endhint %}

#### Zahlungsbedingungen manuell zuweisen

Die Zahlungsbedingungen sollten Ihnen automatisch alle angezeigt werden, wenn Sie die Domain und den Schlüssel richtig eingetragen haben (vgl. obiges Info-Kästchen).

Für den Fall, dass alles richtig eingetragen ist und Sie weitere Zahlungsbedingungen händisch eintragen möchten, können Sie dies nach folgender Anleitung tun.&#x20;

Klicken Sie direkt auf die Zahlungsmethode

<figure><img src="/files/t7DQ5csBOXAty1LgQRAN" alt=""><figcaption></figcaption></figure>

Kopieren Sie dann den letzten Teil der URL nach "section=".

<figure><img src="/files/mrxscALOWcvWIyCGcIUk" alt=""><figcaption></figcaption></figure>

Tragen Sie dann bei Name den Namen und bei Modul den herauskopierten Teil der URL ein.&#x20;

<figure><img src="/files/2vaaggoJpEi1y6oMIKiC" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Wie Sie **Zahlungsbedingungen** in desk4 erstellen, erfahren Sie [**hier**](/einstellungen/finanzen/zahlungsbedingungen.md).
{% endhint %}

### Versandartzuweisung

Über den "Eintrag hinzufügen"-Button können Sie eine Shop-Versandart einer desk4-Versandart zuweisen.

Wählen Sie auf der linken Seite die Shop-Versandart\
(in **WordPress** unter **WooCommerce ->** **Einstellungen -> Versand.**\
Sie können in desk4 alle Shop-Versandarten zuweisen, die im Auswahlfeld in desk4 zur Verfügung stehen. So können Sie sicher sein, alle angebotenen Versandarten abgedeckt zu haben.\
Über den "Hinzufügen" - Link können noch weitere Versandarten hinzugefügt werden, falls diese in WooCommerce aktiviert wurden, aber nicht in der Auflistung erscheinen)

und auf der rechten Seite die passende desk4-Versandart\
(in **desk4** unter **Einstellungen --> Finanzen --> Versandart**).

Dieser Zuweisung muss in der dritten Spalte ein **Versandkostenartikel** aus desk4 beigefügt werden.\
Einen Versandkostenartikel erstellen Sie unter **Stammdaten --> Artikel**. \
Der Artikel sollte als Versandkostenartikel erkennbar sein (z.B. den Namen "Versandkosten" tragen) und es sollte z.B. KEINE Bestandsführung für den Artikel ausgewählt sein.  \
Sie können in desk4 den Preis für den Artikel 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.&#x20;

### Abzurufender Auftragsstatus

Wählen Sie hier den Auftragsstatus der Bestellungen aus, welche aus Ihrem Shop abgerufen werden sollen. \
\
**Status:**\
pending:       Zahlung ausstehend \
processing:  In Bearbeitung \
on-hold:       In Wartestellung \
completed:   Abgeschlossen \
cancelled:    Storniert \
refunded:     Rückerstattet \
failed:           Fehlgeschlagen

### Zu setzender Auftragsstatus

**Shop-In-Bearbeitung-Status:** Welchen Bestellstatus soll die Bestellung im Shop bekommen, nachdem Sie zu desk4 abgerufen wurde?

**Shop-Versendet-Status**: Welchen Bestellstatus soll die Bestellung im Shop bekommen,\
nachdem Sie diese in desk4 durch Ihre Einstellungen im Connector auf "versendet" gesetzt haben?

Sie können außerdem im Tab **Shop** unter **Connector Aktivitäten** einstellen,\
ob Sie die Bestellung durch das Weiterführen des Auftrags zu einem Lieferschein,\
einer Rechnung oder durch die Erstellung eines Labels auf versendet setzen möchten.

Sie können dort 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;

Durch Ihre Einstellungen im Connector bestimmen Sie, bei welcher Aktion der **Shop-Versendet-Status** umgestellt wird.&#x20;

<figure><img src="/files/qNMs7wi4IUTKWKytU9Eb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Entscheiden Sie auch, ob wir **Brutto- oder Nettopreise** übertragen sollen (dies sollte analog zu Ihren Einstellungen im Shop sein).&#x20;

&#x20;\
![](/files/l84r7Zv5CFqI6Qd7C19p)<br>
{% endhint %}

### Preislistenzuweisung

Wählen Sie hier, welche desk4 Preisliste für das aktualisieren der Preise in WooCommerce verwendet werden soll.

{% hint style="info" %}
Wie Sie **Preislisten** in desk4 erstellen, erfahren Sie [**hier**](/einstellungen/artikel/preislisten.md).
{% endhint %}

### Standardzahlungsart

Wählen Sie hier, welche desk4 Zahlungsart für Ihre WooCommerce-Bestellungen voreingestellt werden soll, falls von WooCommerce keine Zahlungsart übermittelt wird.&#x20;

{% hint style="info" %}
Wie Sie **Zahlungsarten** in desk4 erstellen, erfahren Sie [**hier**](/einstellungen/finanzen/zahlungsbedingungen.md).
{% endhint %}

### Bestellungen abrufen und Shop synchronisieren

In der Übersicht der Shop Anbindung können Sie über den Pfeil-Button ![](/files/TLVRX7krECeepW9X0VOT) auswählen, ob Sie die Bestellungen aus Ihrem Shop abrufen, den Bestand oder die Preise aktualisieren möchten.

Per Klick direkt auf **Shop Synchronisieren** werden alle 3 Vorgänge ausgeführt.

<figure><img src="/files/yFKzbgXZB0r8CtwuSjzI" alt=""><figcaption></figcaption></figure>

{% hint style="info" %} <mark style="color:red;">Achtung: für WooCommerce können Preise und Bestände nicht für Variable Produkte aktualisiert werden.</mark>&#x20;
{% endhint %}

{% hint style="info" %} <mark style="color:red;">Achtung: WooCommerce hat im Standard keine Staffelpreise.</mark>&#x20;

<mark style="color:red;">Falls Sie ein Plugin für Staffelpreise haben, prüfen Sie, ob die Preise beim "Preise aktualisieren" von desk4 an WooCommerce geupdated werden.</mark>&#x20;
{% endhint %}

Abgerufene Bestellungen werden in desk4 als **Aufträge** übernommen und können nach Belieben bearbeitet und zu **Lieferscheinen** und/oder **Rechnungen** weitergeführt werden.

### desk4 Artikel in WooCommerce importieren

#### Export in desk4

Um Artikel aus desk4 in WooCommerce importieren zu können, stellen Sie zunächst sicher,\
dass die gewünschten Artikel in desk4 als **Shop-Artikel** markiert sind.

<figure><img src="/files/46GRXjEBzamJi9UhCAY3" alt=""><figcaption></figcaption></figure>

Navigieren Sie nun zur **„Shopanbindungs“-Übersicht** in desk4 und klicken im\
**WooCommerce-Fenster** auf **Artikelexport**.

<figure><img src="/files/xXkG1uoFKhl2cYbCypPw" alt=""><figcaption></figcaption></figure>

Hier werden Ihnen automatisch alle Artikel exportiert, bei denen das Häkchen „Shopartikel“ angehakt ist.

Die Spalten, welche aktuell exportiert werden lauten:\
"Artikelnummer","Name","Veröffentlicht","Sichtbarkeit im Katalog","Kurzbeschreibung","Beschreibung","Datum, an dem Angebotspreis beginnt","Datum, an dem Angebotspreis endet","Vorrätig?","Lager","Gewicht (kg)","Angebotspreis","Regulärer Preis".

{% hint style="info" %}
**Weitere Informationen exportieren**

Möchten Sie weitere Informationen exportieren, gehen Sie auf Werkzeuge -> Exporte -> Artikelexport.

Dort können Sie nun alle Spalten auswählen, die Sie exportieren möchten.

Es werden Ihnen aber im Standard ALLE Artikel angezeigt.

Möchten Sie nach Shopartikeln filtern, so können Sie auch diese Spalte anzeigen lassen und dann danach filtern, bevor Sie den Export erzeugen.

Erzeugen Sie eine CSV-Datei für den Export.
{% endhint %}

#### Import in WooCommerce

{% hint style="info" %}
Achtung: Achten Sie vor dem Import darauf, dass Ihre Steuer-Einstellungen im Shop auf "No, I will enter prices exclusive of tax" eingestellt sind, da in desk4 Nettopreise exportiert werden.&#x20;

![](/files/pYyCHxy5xSdObdaZXsBt)
{% endhint %}

Gehen Sie anschließend in WooCommerce auf Produkte. Oben auf der Seite können Sie „Import“ anklicken.

<figure><img src="/files/Lo4yrbcQRZHwUIjH3zqR" alt=""><figcaption></figcaption></figure>

Klicken Sie dann auf „Durchsuchen“ und wählen Sie Ihren Export aus.

Im Kontrollkästchen darunter können Sie auswählen, ob existierende Produkte geupdated werden sollen.

<figure><img src="/files/w95fBmNxVXBFquscMyKU" alt=""><figcaption></figcaption></figure>

Im nächsten Fenster mappen Sie Ihre Datei. Sie wählen aus, welche Spalte Ihrer Excel-Datei in welches Feld in WooCommerce importiert werden soll.

Wenn Sie Informationen nicht benötigen, können Sie auch einfach „Do not import“ ausgewählt lassen.

<figure><img src="/files/tH7GJ9TKASh7Itqhhsdd" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Wichtig: Wenn Sie keine Angebotspreise in desk4 haben oder zum Shop übermitteln möchten, sollten die 3 Felder für den Angebotspreis auch nicht gemappt werden.&#x20;

Wenn Sie&#x20;
{% endhint %}

Klicken Sie dann auf „Run the importer“.

Nun werden Ihre Produkte in WooCommerce importiert.

Nach dem Import können Sie die importierten Artikel einsehen und nach Belieben bearbeiten.

{% hint style="info" %}
Wie Sie **Artikel** in desk4 erstellen, erfahren Sie[ **hier**](/stammdaten/artikel.md).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.desk4.de/shopanbindung/woocommerce-schnittstelle-konfigurieren.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.