Produktattribute für WooCommerce Checkout zuordnen

Übersicht 

Ordnen Sie Ihre WooCommerce-Produktattribute (wie Farbe, Größe und andere Anpassungen) in der Zonos-Erweiterung zu, um sicherzustellen, dass Bestellungen von Zonos in Ihren WooCommerce-Shop mit den korrekten Attributen importiert werden.

Schritt 1: Ihre Produktattribute finden

1. Navigieren Sie zur Registerkarte Products in Ihrer WordPress-Administration.

2. Klicken Sie in der linken Navigation auf Attributes, um Ihre globalen Produktattribute anzuzeigen oder zu verwalten. Attribute können auch beim Hinzufügen eines neuen Produkts festgelegt werden.

Wenn Sie eine Drittanbieter-App für benutzerdefinierte Attribute wie Product Add-Ons for WooCommerce verwenden, folgen Sie den Anweisungen in der Dokumentation der App, um die Attribute zu finden.

Schritt 2: Den Attributpfad von Zonos identifizieren

Um Attribute in der Zonos-Erweiterung zuzuordnen, müssen Sie zunächst verstehen, wie sie an Zonos übergeben werden. So finden Sie diese Daten:

1. Erstellen Sie eine Testbestellung für ein Produkt mit dem Attribut, das Sie zuordnen möchten.
2. Durchlaufen Sie Zonos Checkout und wählen Sie ein Servicelevel. Dies generiert ein Landed-Cost-Angebot. (Sie müssen die Bestellung nicht abschließen.)
3. Gehen Sie in Dashboard zu Quotes.
4. Suchen Sie das Angebot für Ihre Testbestellung und klicken Sie auf Quote Details.
5. Erweitern Sie im Abschnitt API Details rechts das Dropdown auf Root-Ebene und erweitern Sie dann:
   • items
   • metadata

Dieser Metadatenblock zeigt, wie Produktattribute von WooCommerce an Zonos in der API-Anfrage übergeben werden.

Schritt 3: Das Attribut in der Zonos-Erweiterung zuordnen

Sobald Sie das Attribut im Metadaten-JSON gefunden haben, kehren Sie zu den Zonos Mapping-Einstellungen in Ihrer WooCommerce-Erweiterung zurück.

1. Wählen Sie unter Attribute field Custom Attribute.
2. Geben Sie im Feld Alias eine beschreibende Bezeichnung ein (z. B. Color, Size oder Custom Engraving).
3. Geben Sie im Feld Cart item path den Pfad zum Attributwert ein, basierend auf der Struktur, die Sie in den Metadaten beobachtet haben.

Beispiel für die Zuordnung benutzerdefinierter Attribute

Gehen wir durch, wie Sie ein Produkt zuordnen können, das ein benutzerdefiniertes Attribut für individuelle Gravur, Farbe und Größe hat.

Wenn Sie das Product Add-ons-Plugin von WooCommerce verwenden, werden Attribute manchmal in einem Array unter dem Schlüssel addons übergeben. Der JSON-Block unten zeigt die Attribute, die an Zonos übergeben wurden.

Beispiel-JSON-Block:

{
  "addons": [
    {
      "name": "Custom Engraving",
      "value": "Built to last",
      "price": 0,
      "field_name": "1226-1748963436",
      "field_type": "custom_text",
      "id": 1748963436,
      "price_type": "flat_fee"
    }
  ],
  "variation": {
    "attribute_pa_color": "blue",
    "attribute_size": "Large"
  }
}

In den Mapping settings unter Attributes sollte jedes dieser Attribute wie folgt zugeordnet werden:

Hinweis: Das Pfadformat addons.0.value funktioniert wie folgt:

• addons weist das System an, im addons-Array zu suchen
• .0 verweist auf das erste Objekt in diesem Array
• .value gibt den Wert aus dem value-Feld dieses Objekts zurück
• attribute_pa_color und attribute_size sind Objekte, die nicht in einem Array sind und direkt zugeordnet werden können.

Die Produktattribut-Zuordnung testen

Sobald Sie das Attribut zugeordnet haben, geben Sie eine vollständige Testbestellung in Zonos Checkout auf. Sobald die Bestellung verarbeitet wurde, überprüfen Sie die Bestelldetails in WooCommerce, um sicherzustellen, dass die Produktattribute korrekt importiert wurden.