Mapear atributos de produtos para WooCommerce Checkout

Visão Geral 

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

Passo 1: Encontre seus atributos de produto

1. Navegue até a aba Produtos no seu Admin do WordPress.

2. No menu à esquerda, clique em Atributos para visualizar ou gerenciar seus atributos de produto globais. Os atributos também podem ser definidos ao adicionar um novo produto.

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

Passo 2: Identifique o caminho do atributo do Zonos

Para mapear atributos na extensão Zonos, você primeiro precisará entender como eles são passados para o Zonos. Para localizar esses dados:

1. Crie um pedido de teste para um produto com o atributo que você deseja mapear.
2. Prossiga pelo Zonos Checkout e selecione um nível de serviço. Isso gerará uma cotação de landed cost. (Você não precisa concluir o pedido.)
3. No Dashboard, vá para Cotações.
4. Encontre a cotação para seu pedido de teste e clique em Detalhes da Cotação.
5. Na seção Detalhes da API à direita, expanda o dropdown de nível raiz e, em seguida, expanda:
   • items
   • metadata

Esse bloco de metadados mostra como os atributos de produtos são passados do WooCommerce para o Zonos na solicitação da API.

Passo 3: Mapeie o atributo na extensão Zonos

Depois de localizar o atributo no JSON de metadados, retorne às configurações de Mapeamento do Zonos na sua extensão WooCommerce.

1. Sob Campo de Atributo, selecione Atributo Personalizado.
2. No campo Alias, insira um rótulo descritivo (por exemplo, Cor, Tamanho ou Gravação Personalizada).
3. No campo Caminho do item do carrinho, insira o caminho para o valor do atributo, com base na estrutura que você observou nos metadados.

Exemplo de mapeamento de atributos personalizados

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

Se você estiver usando o plugin Product Add-ons do WooCommerce, os atributos às vezes são passados dentro de um array sob a chave addons. O bloco JSON abaixo mostra os atributos que foram passados para o Zonos.

Exemplo de bloco JSON:

{
  "addons": [
    {
      "name": "Gravação Personalizada",
      "value": "Feito para durar",
      "price": 0,
      "field_name": "1226-1748963436",
      "field_type": "custom_text",
      "id": 1748963436,
      "price_type": "flat_fee"
    }
  ],
  "variation": {
    "attribute_pa_color": "azul",
    "attribute_size": "Grande"
  }
}

Nas Configurações de Mapeamento sob Atributos, cada um desses atributos deve ser mapeado da seguinte forma:

Nota: O formato de caminho addons.0.value funciona assim:

• addons informa ao sistema para olhar no array de addons
• .0 aponta para o primeiro objeto nesse array
• .value retorna o valor do campo value desse objeto
• attribute_pa_color e attribute_size são objetos que não estão em um array e podem ser mapeados diretamente.

Teste o mapeamento de atributos do produto

Depois de mapear o atributo, faça um pedido de teste completo no Zonos Checkout. Após o processamento do pedido, verifique os detalhes do pedido no WooCommerce para garantir que os atributos do produto foram importados corretamente.