Mapear atributos de produto para WooCommerce Checkout

Visão geral 

Mapeie os atributos de produto do WooCommerce (como cor, tamanho e outras personalizações) na extensão da Zonos para garantir que os pedidos sejam importados da Zonos para sua loja WooCommerce com os atributos corretos.

Etapa 1: Encontre seus atributos de produto

1. Navegue até a aba Products no WordPress Admin.

2. Na navegação à esquerda, clique em Attributes para ver ou gerenciar seus atributos globais de produto. Os atributos também podem ser configurados ao adicionar um novo produto.

Se você usa um aplicativo de terceiros para atributos personalizados, como Product Add-Ons for WooCommerce, siga as instruções da documentação do aplicativo para localizar os atributos.

Etapa 2: Identifique o caminho do atributo na Zonos

Para mapear atributos na extensão da Zonos, primeiro você precisa entender como eles são enviados à Zonos. Para localizar esses dados:

1. Crie um pedido de teste para um produto com o atributo que deseja mapear.
2. Avance pelo Zonos Checkout e selecione um nível de serviço. Isso gerará uma cotação de landed cost. (Não é necessário concluir o pedido.)
3. No Dashboard, vá para Quotes.
4. Encontre a cotação do seu pedido de teste e clique em Quote Details.
5. Na seção API Details à direita, expanda o menu suspenso do nível raiz e, em seguida, expanda:
   • items
   • metadata

Este bloco de metadata mostra como os atributos de produto do WooCommerce são enviados à Zonos na solicitação de API.

Etapa 3: Mapeie o atributo na extensão da Zonos

Depois de localizar o atributo no JSON de metadata, volte às configurações de Zonos Mapping na sua extensão WooCommerce.

1. Em Attribute field, selecione Custom Attribute.
2. No campo Alias, informe um rótulo descritivo (por exemplo, Color, Size ou Custom Engraving).
3. No campo Cart item path, informe o caminho para o valor do atributo, conforme a estrutura observada na metadata.

Exemplo de mapeamento de atributos personalizados

Vamos ver como você pode mapear um produto que tem um atributo personalizado para gravação personalizada, cor e tamanho.

Se você usa o complemento Product Add-ons do WooCommerce, os atributos às vezes são enviados dentro de uma matriz sob a chave addons. O bloco JSON abaixo mostra os atributos que foram enviados à Zonos.

Exemplo de bloco 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"
  }
}

Em Mapping settings sob Attributes, cada um desses atributos deve ser mapeado da seguinte forma:

Note: O formato de caminho addons.0.value funciona da seguinte forma:

• addons indica ao sistema que busque na matriz addons
• .0 aponta para o primeiro objeto dessa matriz
• .value retorna o valor do campo value desse objeto
• attribute_pa_color e attribute_size são objetos que não estão em uma matriz e podem ser mapeados diretamente.

Teste o mapeamento de atributos de produto

Depois de mapear o atributo, faça um pedido de teste completo no Zonos Checkout. Depois que o pedido for processado, revise os detalhes do pedido no WooCommerce para garantir que os atributos de produto foram importados corretamente.