Map productattributen voor WooCommerce Checkout

Map productattributen zoals kleur, maat en andere aanpassingen voor uw WooCommerce-winkel.

Overzicht

Map uw WooCommerce-productattributen (zoals kleur, maat en andere aanpassingen) in de Zonos-extensie om ervoor te zorgen dat bestellingen van Zonos naar uw WooCommerce-winkel worden geïmporteerd met de correcte attributen.

Stap 1: Vind uw productattributen

Ga naar het tabblad Products in uw WordPress Admin.
Klik in de navigatie aan de linkerkant op Attributes om uw globale productattributen te bekijken of beheren. Attributen kunnen ook worden ingesteld bij het toevoegen van een nieuw product.

Als u een third-party app gebruikt voor aangepaste attributen zoals Product Add-Ons for WooCommerce, volg dan de instructies in de documentatie van de app om de attributen te vinden.

Stap 2: Identificeer het attributepad van Zonos

Om attributen te mappen in de Zonos-extensie, moet u eerst begrijpen hoe ze naar Zonos worden doorgegeven. Volg deze stappen om deze gegevens te vinden:

Maak een testbestelling voor een product met het attribuut dat u wilt mappen.
Ga door Zonos Checkout en selecteer een service level. Dit genereert een landed cost-offerte. (U hoeft de bestelling niet te voltooien.)
Ga in Dashboard naar Quotes.
Zoek de offerte voor uw testbestelling en klik op Quote Details.
Vouw in de sectie API Details aan de rechterkant het dropdownmenu op rootniveau uit en vouw vervolgens uit:
- items
- metadata

Dit metadata-blok toont hoe productattributen van WooCommerce naar Zonos worden doorgegeven in het API-verzoek.

Stap 3: Map het attribuut in de Zonos-extensie

Zodra u het attribuut in de metadata JSON hebt gevonden, keert u terug naar de Zonos Mapping-instellingen in uw WooCommerce-extensie.

Selecteer onder Attribute field Custom Attribute.
Voer in het veld Alias een beschrijvend label in (bijv. Color, Size of Custom Engraving).
Voer in het veld Cart item path het pad naar de waarde van het attribuut in, gebaseerd op de structuur die u in de metadata hebt waargenomen.

Voorbeeld van het mappen van aangepaste attributen

Laten we doorlopen hoe u een product kunt mappen met een aangepast attribuut voor custom engraving, kleur en maat.

Als u de Product Add-ons-plugin van WooCommerce gebruikt, worden attributen soms doorgegeven in een array onder de addons-key. Het JSON-blok hieronder toont de attributen die naar Zonos zijn doorgegeven.

Example 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 Mapping settings onder Attributes moet elk van deze attributen als volgt worden gemapped:

Custom Attribute↕	Alias↕	Cart item path↕
Engraving	Custom Engraving	`addons.0.value`
Color	Color	`attribute_pa_color`
Size	Size	`attribute_size`

Opmerking: Het padformaat addons.0.value werkt als volgt:

addons vertelt het systeem om in de addons-array te zoeken

.0 wijst naar het eerste object in die array

.value retourneert de waarde uit het value-veld van dat object

attribute_pa_color en attribute_size zijn objecten die niet in een array staan en direct kunnen worden gemapped.

Test de productattribuut-mapping

Zodra u het attribuut hebt gemapped, plaatst u een volledige testbestelling in Zonos Checkout. Zodra de bestelling is verwerkt, controleert u de orderdetails in WooCommerce om te verifiëren dat de productattributen correct zijn geïmporteerd.

Boek een demo