Mapear atributos de producto para WooCommerce Checkout

Descripción general 

Mapee los atributos de producto de WooCommerce (como color, talla y otras personalizaciones) en la extensión de Zonos para garantizar que los pedidos se importen de Zonos a su tienda WooCommerce con los atributos correctos.

Paso 1: Encuentre sus atributos de producto

1. Navegue a la pestaña Products en su WordPress Admin.

2. En la navegación izquierda, haga clic en Attributes para ver o administrar sus atributos globales de producto. Los atributos también se pueden configurar al agregar un nuevo producto.

Si utiliza una aplicación de terceros para atributos personalizados como Product Add-Ons for WooCommerce, siga las instrucciones de la documentación de la aplicación para localizar los atributos.

Paso 2: Identifique la ruta del atributo desde Zonos

Para mapear atributos en la extensión de Zonos, primero deberá comprender cómo se envían a Zonos. Para localizar estos datos:

1. Cree un pedido de prueba para un producto con el atributo que desea mapear.
2. Avance por Zonos Checkout y seleccione un nivel de servicio. Esto generará una cotización de landed cost. (No es necesario completar el pedido.)
3. En Dashboard, vaya a Quotes.
4. Encuentre la cotización de su pedido de prueba y haga clic en Quote Details.
5. En la sección API Details a la derecha, expanda el menú desplegable de nivel raíz y luego expanda:
   • items
   • metadata

Este bloque de metadata muestra cómo se envían los atributos de producto de WooCommerce a Zonos en la solicitud de API.

Paso 3: Mapee el atributo en la extensión de Zonos

Una vez que haya localizado el atributo en el JSON de metadata, regrese a la configuración de Zonos Mapping en su extensión de WooCommerce.

1. En Attribute field, seleccione Custom Attribute.
2. En el campo Alias, ingrese una etiqueta descriptiva (p. ej., Color, Size o Custom Engraving).
3. En el campo Cart item path, ingrese la ruta al valor del atributo, según la estructura que observó en la metadata.

Ejemplo de mapeo de atributos personalizados

Veamos cómo puede mapear un producto que tiene un atributo personalizado para grabado personalizado, color y talla.

Si utiliza el complemento Product Add-ons de WooCommerce, los atributos a veces se envían dentro de una matriz bajo la clave addons. El bloque JSON a continuación muestra los atributos que se enviaron a Zonos.

Ejemplo de bloque 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"
  }
}

En Mapping settings bajo Attributes, cada uno de estos atributos debe mapearse de la siguiente manera:

Nota: El formato de ruta addons.0.value funciona de la siguiente manera:

• addons indica al sistema que busque en la matriz addons
• .0 apunta al primer objeto de esa matriz
• .value devuelve el valor del campo value de ese objeto
• attribute_pa_color y attribute_size son objetos que no están en una matriz y se pueden mapear directamente.

Pruebe el mapeo de atributos de producto

Una vez que haya mapeado el atributo, realice un pedido de prueba completo en Zonos Checkout. Una vez procesado el pedido, revise los detalles del pedido en WooCommerce para asegurarse de que los atributos de producto se importaron correctamente.