Mappa gli attributi prodotto per WooCommerce Checkout

Panoramica 

Mappa gli attributi prodotto WooCommerce (come colore, taglia e altre personalizzazioni) nell’estensione Zonos per assicurarti che gli ordini vengano importati da Zonos nel tuo negozio WooCommerce con gli attributi corretti.

Passaggio 1: trova i tuoi attributi prodotto

1. Vai alla scheda Products nel tuo WordPress Admin.

2. Nella navigazione a sinistra, fai clic su Attributes per visualizzare o gestire gli attributi prodotto globali. Gli attributi possono anche essere impostati quando aggiungi un nuovo prodotto.

Se usi un’app di terze parti per attributi personalizzati come Product Add-Ons for WooCommerce, segui le istruzioni nella documentazione dell’app per individuare gli attributi.

Passaggio 2: identifica il percorso dell’attributo da Zonos

Per mappare gli attributi nell’estensione Zonos, devi prima capire come vengono passati a Zonos. Per individuare questi dati:

1. Crea un ordine di test per un prodotto con l’attributo che vuoi mappare.
2. Procedi attraverso Zonos Checkout e seleziona un service level. Questo genererà una quotazione di landed cost. (Non è necessario completare l’ordine.)
3. In Dashboard, vai a Quotes.
4. Trova la quotazione per il tuo ordine di test e apri Quote Details.
5. Nella sezione API Details a destra, espandi il menu a discesa di livello root, quindi espandi:
   • items
   • metadata

Questo blocco metadata mostra come gli attributi prodotto vengono passati da WooCommerce a Zonos nella richiesta API.

Passaggio 3: mappa l’attributo nell’estensione Zonos

Una volta individuato l’attributo nel JSON dei metadata, torna alle impostazioni Zonos Mapping nella tua estensione WooCommerce.

1. In Attribute field, seleziona Custom Attribute.
2. Nel campo Alias, inserisci un’etichetta descrittiva (ad es. Color, Size o Custom Engraving).
3. Nel campo Cart item path, inserisci il percorso al valore dell’attributo, in base alla struttura osservata nei metadata.

Esempio di mappatura di attributi personalizzati

Vediamo come puoi mappare un prodotto che ha un attributo personalizzato per incisioni personalizzate, colore e taglia.

Se usi il plugin Product Add-ons di WooCommerce, gli attributi a volte vengono passati all’interno di un array sotto la chiave addons. Il blocco JSON seguente mostra gli attributi passati a Zonos.

Esempio di blocco JSON:

{
  "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 sotto Attributes, ciascuno di questi attributi dovrebbe essere mappato come segue:

Nota: Il formato del percorso addons.0.value funziona così:

• addons indica al sistema di cercare nell’array addons
• .0 punta al primo oggetto di quell’array
• .value restituisce il valore dal campo value di quell’oggetto
• attribute_pa_color e attribute_size sono oggetti che non sono in un array e possono essere mappati direttamente.

Testa la mappatura degli attributi prodotto

Una volta mappato l’attributo, effettua un ordine di test completo in Zonos Checkout. Una volta elaborato l’ordine, controlla i dettagli dell’ordine in WooCommerce per assicurarti che gli attributi prodotto siano stati importati correttamente.