# Gambioschnittstelle konfigurieren

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

Die Konfiguration der Shopschnittstelle finden Sie im linken Seitenmenü unter **Shopanbindung.** Öffnen Sie mit Hilfe des **Öffnen ­Buttons** (Stift-Icon, oben rechts), den jeweilgen **Gambioshop**, den Sie konfigurieren wollen. Nun klicken Sie im oberen Reiter auf **Optionen** und gelangen in folgende Ansicht:

Achtung, die folgenden Daten sind nur Beispieldaten:

<figure><img src="/files/HTzzl2Qn5q0cvpphck3I" alt=""><figcaption><p>Beispieldaten der Gambioschnittstelle</p></figcaption></figure>

### **Zahlungsbedingungen zuweisungen**

Weisen Sie die Shop-Zahlungsarten den äquivalenten Desk4-Zahlungsbedingungen zu.&#x20;

{% hint style="success" %}
Welche in desk4 angelegte Zahlungsbedingung\
soll für eine abgerufene Bestellung im Auftrag des Kunden  - pro Zahlungsart im Shop - vorausgewählt sein?<br>

Die Zahlungsarten in Gambio finden Sie unter **Module -> Zahlungsweisen.**&#x20;

Die Zahlungsbedingungen in desk4 finden Sie unter **Einstellungen** -> **Finanzen** -> **Zahlungsbedingungen.**
{% endhint %}

Für die Zuweisung klicken Sie auf **Eintrag hinzufügen** und wählen dort im linken Dropdownmenü die Zahlungsart aus dem Onlineshop und im rechten Dropdownmenü die passende desk4-Zahlungsbedingung.&#x20;

\
Der rote X-Button löscht die Zuweisung in der jeweiligen Zeile.

### <mark style="color:red;">NICHT IM AUSWAHLFELD BEFINDLICHE Zahlungsbedingung zuweisen</mark>

{% hint style="warning" %} <mark style="color:red;">**Wir können einige Module und Zahlungsbedingungen auslesen, aber nicht alle.**</mark>&#x20;

<mark style="color:red;">**Falls Sie Zahlungsarten aus Modulen bzw. Plug-ins benutzen, müssen diese manuell hinzugefügt werden**</mark>
{% endhint %}

<mark style="color:red;">Klicken Sie dafür auf "Eintrag hinzufügen" und dann im Feld der Shop-Zahlungsart ganz unten nochmal auf</mark> <mark style="color:red;"></mark><mark style="color:red;">**Hinzufügen**</mark><mark style="color:red;">.</mark>\
Es öffnet sich ein kleines Fenster:

![](/files/XsXA3ordDDZknMGTJi3h)

In das Feld **Name** tragen Sie den Namen der Zahlungsart ein. Dieser ist frei wählbar. \ <mark style="color:red;">In das Feld</mark> <mark style="color:red;"></mark><mark style="color:red;">**Modul**</mark> <mark style="color:red;"></mark><mark style="color:red;">tragen Sie die passende Modulbezeichnung aus Gambio ein.</mark>&#x20;

\
Diese finden Sie entweder [über die angezeigte Fehlermeldung in desk4](#meldungen-uber-nicht-zugeordnete-versandkostenartikel-oder-zahlungsmethoden) oder so:\
Notieren Sie sich die Bestellnummer einer Zahlungsbedingung, welche Sie hinzufügen möchten. \
Klicken Sie dann unter "Toolbox" auf "SQL" und geben Sie folgendes in das Abfragefenster ein:&#x20;

Select payment\_class, gambio\_hub\_module, gambio\_hub\_module\_title, orders\_id from orders where orders\_id = *Bestellungsnummer*  (von der Bestellung, die nicht abgerufen werden konnte)

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

Wenn in der unten angefügten Tabelle die Spalte gambio\_hub\_module leer ist, tragen Sie den Inhalt von payment\_class in das desk4-Feld Modul ein. Falls gambio\_hub\_module nicht leer ist, tragen Sie diesen Wert ein.

Dann speichern Sie die neue Zahlungsart und könne deren Bestellungen abrufen.

{% hint style="info" %}
Mehr zu **Zahlungsbedingungen** finden Sie [***hier.***](/einstellungen/finanzen/zahlungsbedingungen.md)&#x20;
{% endhint %}

### **Versandartzuweisung**

Durch den **Eintrag hinzufügen**-Button können Sie eine Shopversandart einer desk4-Versandart zuweisen. Dieser Zuweisung muss in der dritten Spalte ein Versandkostenartikel aus desk4 beigefügt werden.\
**Hierbei werden immer die Versandkosten aus dem Shop übernommen.**

{% hint style="info" %}
Die Mehrwertsteuer des Versandkostenartikels ist immer der Höchststeuersatz aller Versandarten aus dem Shop
{% endhint %}

### <mark style="color:red;">NICHT IM AUSWAHLFELD BEFINDLICHE Versandarten zuweisen</mark>

{% hint style="warning" %} <mark style="color:red;">**Wir können einige Module und Zahlungsbedingungen auslesen, aber nicht alle.**</mark>&#x20;

<mark style="color:red;">**Falls Sie Versandarten aus Modulen bzw. Plug-ins benutzen, müssen diese manuell hinzugefügt werden**</mark>
{% endhint %}

<mark style="color:red;">Klicken Sie dafür auf "Eintrag hinzufügen" und dann im Feld der Shop-Versandart ganz unten nochmal auf</mark> <mark style="color:red;"></mark><mark style="color:red;">**Hinzufügen**</mark><mark style="color:red;">.</mark>\
Es öffnet sich ein kleines Fenster:

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

In das Feld **Name** tragen Sie den Namen der Zahlungsart ein. Dieser ist frei wählbar. \ <mark style="color:red;">In das Feld</mark> <mark style="color:red;"></mark><mark style="color:red;">**Modul**</mark> <mark style="color:red;"></mark><mark style="color:red;">tragen Sie die passende Modulbezeichnung aus Gambio ein.</mark> Die Modulbezeichnung bekommen Sie in der Fehlermeldung angezeigt, wenn nicht alle Module zugeordnet sind (siehe nächster Punkt).

### Meldungen über nicht zugeordnete Versandkostenartikel oder Zahlungsmethoden

Meldungen über nicht zugeordnete Versandkostenartikel oder Zahlungsmethoden bekommen Sie rechts oben angezeigt.&#x20;

Gehen Sie dann auf den Tab "Fehlermeldungen", um die Meldung anzuschauen.&#x20;

Im Beispiel im unteren Bild fehlt die Zuordnung der Shop-Versandart "dp\_dp".&#x20;

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

Merken Sie sich die fehlende Zuordnung und fügen Sie diese in den Optionen hinzu.&#x20;

Machen Sie die Zuordnung dann dementsprechend bei der Zahlungsbedingung oder der Versandart.&#x20;

Beispiel für die Versandart:

Suchen Sie aus der Liste die Versandart mit dem angezeigten Modul (im Beispiel dp\_dp) und ordnen Sie diese einer desk4-Versandart und einem Versandkostenartikel zu.&#x20;

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

<mark style="color:red;">Falls Sie die fehlenden Module nicht in der Auswahlliste finden, können Sie diese gemäß der Anleitung auf dieser Seite (NICHT IM AUSWAHLFELD BEFINDLICHE...) hinzufügen.</mark>&#x20;

### **Preislistenzuweisung**

Wählen Sie hier, welche desk4 Preisliste für das Aktualisieren der Preise in Gambio verwendet werden soll. Die Preislisten werden den von Ihnen in Gambio erstellten Kundengruppen zugewiesen.

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

### **Abzurufende Auftragsstatus**

Hier geben Sie die Kombination an Shop Auftragsstatus und Shop Zahlungsart der Bestellungen ein, die wir aus Ihrem Shop zu desk4 abrufen sollen.

Andere, wie die hier eingestellte Kombinationen werden nicht aus Ihrem Shop abgerufen.

### **Zu setzender Auftragsstatus**

**Shop-In-Bearbeitung-Status:** Welchen Bestellstatus soll die Bestellung im Shop bekommen, nachdem Sie zu desk4 abgerufen wurde? Für gewöhnlich ist dies "**In Bearbeitung**".

**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 oben im Tab "Shop" rechts unter "Connector Aktivitäten" einstellen, ob Sie die Bestellung durch das Weiterführen des Auftrags zu einem Lieferschein oder einer Rechnung oder durch die Erstellung eines Labels auf versendet setzen möchten.) Für gewöhnlich ist der zu setzende Auftragsstatus "**Abgeschlossen**".

### Artikelzuweisung

Hier können Sie die unter **\[Gambio] Module -> Zusammenfassung** aufgelisteten Module einem desk4-Artikel zuweisen, z.B. für Coupons oder eine Nachnahmegebühr.&#x20;

Dafür schreiben Sie den Modulnamen in das Feld "Gambio-Zusammenfassung" und  die Artikelnummer aus desk4, welche Sie verknüpfen möchten in das Feld "desk4-Artikelnummer".&#x20;

Beispiel:&#x20;

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

Sie können so viele Zusammenfassungs-Artikel verknüpfen, wie Sie möchten.&#x20;

### Versandanbieterzuweisung

Ordnen Sie die Versandanbieter aus Ihrem Shop den Versandanbietern aus desk4 zu.&#x20;

Versandanbieter erstellen Sie in desk4 unter **Einstellungen -> Versandanbieter**.&#x20;

### Varianten

{% hint style="warning" %}
Bei Gambio können **Preise und Bestände für Variantenartikel erst ab Gambio 4.7 aktualisiert werden**. \
Dies liegt nicht an desk4, sondern daran, dass die ältere Gambio-API dies nicht vorsah.
{% endhint %}

Das Handling von Varianten ist ab Gambio 4.7 möglich.

Aktivieren Sie im Shop die Option "Artikelvarianten-Artikelnummer anhängen".&#x20;

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

Jede im Shop befindlichen Variante muss mit der mit dem Hauptartikel kombinierten Artikelnummer in desk4 vorhanden sein.

(Hauptartikelnummer)-(Variantenartikelnummer)

{% hint style="danger" %}
**Achtung:**&#x20;

<mark style="color:red;">Weder Hauptartikelnummer, noch Variantenartikelnummer dürfen in Gambio leer sein!</mark>

**Mit anderen Worten:**

<mark style="color:green;">Alle Hauptartikel und alle Variantenausprägungen benötigen eine Artikelnummer.</mark>&#x20;
{% endhint %}

Jede Variante muss also in desk4 als einzelner Artikel angelegt werden.&#x20;

**Beispiele**:

In Gambio werden pro Größe unterschiedliche Artikelnummern per Bindestrich an den Variantenartikel gehängt (wenn die Option "Artikelvarianten-Artikelnummer anhängen" aktiviert wurde)

In Gambio befindet sich ein Hauptartikel (T-Shirt) mit der Artikelnummer DEF123. Zu diesem Artikel wurden Varianten mit der Größe S und M angelegt.&#x20;

Diese Artikel wurden beispielsweise als folgende Artikel angelegt:

* DEF123-s
* DEF123-m

<figure><img src="/files/06J3i95shBgtgtVbZNWy" alt=""><figcaption></figcaption></figure>

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

Damit diese Artikel von desk4 aus synchronisiert werden können (Preise und Bestände), müssen die Artikel mit den Artikelnummern DEF123-m und DEF123-s in desk4 angelegt sein.&#x20;

{% hint style="success" %}
Gut zu Wissen:

Beim Bestellabruf aus dem Shop werden die in der Bestellung vorhandenen Artikel automatisch mit den in Gambio vergebenen Artikelnummern angelegt, falls diese nicht schon in desk4 existieren.&#x20;
{% 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/gambioschnittstelle-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.