Mapear atributos de productos para WooCommerce Checkout

Resumen 

Mapea los atributos de productos de WooCommerce (como color, tamaño y otras personalizaciones) en la extensión de Zonos para asegurar que los pedidos se importen desde Zonos a tu tienda WooCommerce con los atributos correctos.

Paso 1: Encuentra tus atributos de producto

1. Navega a la pestaña Productos en tu Admin de WordPress.

2. Desde la navegación de la izquierda, haz clic en Atributos para ver o gestionar tus atributos de producto globales. Los atributos también se pueden establecer al agregar un nuevo producto.

Si estás utilizando una aplicación de terceros para atributos personalizados como Product Add-Ons for WooCommerce, sigue las instrucciones en la documentación de la aplicación para localizar los atributos.

Paso 2: Identifica la ruta del atributo desde Zonos

Para mapear atributos en la extensión de Zonos, primero necesitarás entender cómo se pasan a Zonos. Para localizar estos datos:

1. Crea un pedido de prueba para un producto con el atributo que deseas mapear.
2. Procede a través de Zonos Checkout y selecciona un nivel de servicio. Esto generará una cotización de landed cost. (No necesitas completar el pedido.)
3. En Dashboard, ve a Cotizaciones.
4. Encuentra la cotización para tu pedido de prueba y haz clic en Detalles de la Cotización.
5. En la sección Detalles de la API a la derecha, expande el menú desplegable de nivel raíz, luego expande:
   • items
   • metadata

Este bloque de metadatos muestra cómo se pasan los atributos de producto de WooCommerce a Zonos en la solicitud de API.

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

Una vez que hayas localizado el atributo en el JSON de metadatos, regresa a la configuración de Mapeo de Zonos en tu extensión de WooCommerce.

1. Bajo Campo de atributo, selecciona Atributo Personalizado.
2. En el campo Alias, ingresa una etiqueta descriptiva (por ejemplo, Color, Tamaño o Grabado Personalizado).
3. En el campo Ruta del artículo del carrito, ingresa la ruta al valor del atributo, basada en la estructura que observaste en los metadatos.

Ejemplo de mapeo de atributos personalizados

Vamos a ver cómo puedes mapear un producto que tiene un atributo personalizado para grabado personalizado, color y tamaño.

Si estás utilizando el plugin Product Add-ons de WooCommerce, los atributos a veces se pasan dentro de un array bajo la clave addons. El bloque JSON a continuación muestra los atributos que se pasaron 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 Configuraciones de Mapeo bajo Atributos, cada uno de estos atributos debe ser mapeado de la siguiente manera:

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

• addons le dice al sistema que busque en el array de addons
• .0 apunta al primer objeto en ese array
• .value devuelve el valor del campo value de ese objeto
• attribute_pa_color y attribute_size son objetos que no están en un array y pueden ser mapeados directamente.

Prueba el mapeo de atributos de producto

Una vez que hayas mapeado el atributo, realiza un pedido de prueba completo en Zonos Checkout. Una vez que el pedido haya sido procesado, verifica los detalles del pedido en WooCommerce para asegurarte de que los atributos de producto se importaron correctamente.