# 27. Januar 2025: Shopify-Updates

27\. Januar 2025

Ab dem 27. Januar wird Channable auf die neue API von Shopify umstellen, da die aktuelle Version [veraltet](https://shopify.dev/docs/apps/build/graphql/migrate/new-product-model#whats-changing).

Wenn du eine Shopify-Verbindung hast, die eines der in diesem Artikel aufgeführten Felder verwendet, musst du [jetzt handeln](#h_01JJ4HPAQCC0YZT7ZYH66XSR3D) um Produkt- oder Projektprobleme zu verhindern.

#### Betroffene Felder

| Name des Channable-Felds | Altes Format - Beispielwert | Neues Format - Beispielwert                                     |
| ------------------------ | --------------------------- | --------------------------------------------------------------- |
| created\_at              | '2020-08-13T09:50:02-04:00' | '2020-08-13T13:50:02Z'                                          |
| published\_at            | '2020-08-13T09:50:02-04:00' | '2020-08-13T13:50:02Z'                                          |
| parent\_created\_at      | "web"                       | Keines - Feld veraltet                                          |
| published\_scope         | "web"                       | Keines - Feld veraltet                                          |
| grams                    | 10                          | Keines - Feld veraltet                                          |
| inventory\_management    | "shopify"                   | Keines - Feld veraltet                                          |
| price\_{currency\_code}  | '21.50'                     | [Das veraltete `price_eur` Feld](#h_01JJ4HPAQCRZ5BA07WQKP199DX) |
| shipping\_weight         | 10g                         | 10GRAMS                                                         |
| fulfillment\_service     | "manual'                    | Keines - Feld veraltet                                          |

### Was du tun musst

{% stepper %}
{% step %}

#### Aktualisiere deine Shopify-Verbindung

{% hint style="info" %}
Diese Aktion erstellt keine neue Shopify-Verbindung.
{% endhint %}

Aktualisiere deine Shopify-Verbindung, indem du diese Schritte ausführst:

{% stepper %}
{% step %}
Gehe zu **Firmeneinstellungen** > **Verbindungen** und finde deine Shopify-Verbindung.
{% endstep %}

{% step %}
Klicke **Bearbeiten**.
{% endstep %}

{% step %}
Klicke **Verbindung aktualisieren**. Du wirst zu Shopify weitergeleitet.
{% endstep %}

{% step %}
Melde dich bei Shopify an.
{% endstep %}

{% step %}
Akzeptiere die Zugriffsbereiche, auf die Channable zugreifen möchte.

{% hint style="warning" %}
Wenn du nach der Weiterleitung zu Shopify keine Aufforderung zur Erteilung der Berechtigung erhältst, überprüfe, ob du in Shopify die richtigen Berechtigungen hast, wie [hier](https://help.shopify.com/en/manual/your-account/staff-accounts/staff-roles/permissions/permissions-descriptions).
{% endhint %}
{% endstep %}

{% step %}
Du wirst zurück zu Channable geleitet. Klicke **Erstellen** um deine bestehende Shopify-Verbindung durch die neue zu ersetzen.

Deine Shopify-Verbindung wird aktualisiert. Wenn die Aktualisierung erfolgreich ist, wird "read\_locations" im Feld **Scope**.

<figure><img src="https://content.gitbook.com/content/Celgbro04804WOVz6ZV0/blobs/vsTXINe13OpwRYCrQ5c5/24157966824082" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}
{% endstep %}

{% step %}

#### Betroffene Felder neu zuordnen oder bearbeiten

**Hinweis:** Diesen Schritt kannst du erst ab dem 27. Januar ausführen.

Sobald du deine Shopify-Verbindung aktualisiert hast, musst du die betroffenen Felder neu zuordnen oder bearbeiten. Die genaue Vorgehensweise hängt davon ab, welche Felder du verwendest und wie das Shopify-API-Update sie verändert hat.

#### Das veraltete `price_currency` Feld

Die Preisfelder, die die Struktur `price_currency` hatten, sind jetzt strukturiert als `price_country`. `price_usd` und `price_gbp` werden automatisch importiert und Channable ordnet diese Felder automatisch neu zu. Du musst die folgenden Schritte nur ausführen, wenn du das `price_eur` Feld oder ein anderes benutzerdefiniertes Preiswährungsfeld verwendest.

<figure><img src="https://content.gitbook.com/content/Celgbro04804WOVz6ZV0/blobs/BcpDKae8GELG4AoUchx0/24132112047122" alt=""><figcaption></figcaption></figure>

Folge einer der Optionen unten:

{% stepper %}
{% step %}

###

Gehe zu **Einrichtung** und finde deinen Shopify-Import.\
In der Spalte „Bearbeiten“ klicke **Mapping bearbeiten**.\
Ordne eines der neuen Währungsfelder jedem der alten Felder zu. Jedes „Projektfeld“ kann nur einem „Importfeld“ zugeordnet werden.
{% endstep %}

{% step %}

###

Finde alle Stellen, an denen das veraltete `price_eur` Feld verwendet wird.\
Jedes Mal, wenn `price_eur` verwendet wird, wähle eines der neuen `price_{country_code}` Felder aus.

{% hint style="info" %}
Wenn wir ein Preisfeld für das Land, das du auswählen möchtest, nicht unterstützen, bitte [kontaktiere den Support](https://helpcenter.channable.com/hc/en-us/articles/360016311759-How-can-I-contact-Channable) und wir helfen dir beim Einrichten.
{% endhint %}
{% endstep %}
{% endstepper %}

#### Andere veraltete Felder

Die folgenden Felder wurden durch das Shopify-API-Update veraltet:

* published\_scope
* grams
* inventory\_management
* price\_{currency}
* fulfillment\_service

Diese Felder werden automatisch aus allen Shopify-Importen entfernt, du musst sie also nicht neu zuordnen.

Wenn diese Felder jedoch in Regeln / KI-Regeln / Exporten verwendet werden, musst du sie an diesen Stellen ändern oder entfernen. Andernfalls schlägt der Export / die Regel / die KI-Regel fehl, wenn die Shopify-API-Migration stattfindet.
{% endstep %}
{% endstepper %}

#### Neues Werteformat für einige Felder

Die Werte der folgenden Felder werden automatisch neu formatiert:

* `created_at`, `published_at`, `parent_created_at`: Werte werden nicht mehr lokalisiert, sondern in der UTC-Zeitzone angegeben. Beispiel: '2020-08-13T09:50:02-04:00' → '2020-08-13T13:50:02Z'.
* `shipping_weight`: Die Gewichtsschreibweise wird nicht mehr abgekürzt, sondern in GROSSBUCHSTABEN ausgeschrieben. Beispiel: "10g" → "10GRAMS", "2kg" → "2KILOGRAMS".

Hinweis: Du musst diese Felder nicht bearbeiten oder neu zuordnen — die Änderungen werden automatisch angewendet.