Guía de integración con WooCommerce

Guía de integración con WooCommerce

Conecta WooCommerce con AtoShip para automatizar el flujo de envíos de tu tienda WordPress.

Requisitos previos

Antes de conectar:

• WordPress con WooCommerce instalado
• Se recomienda WooCommerce 5.0 o superior
• Una cuenta de AtoShip
• Acceso de administrador en WordPress

Métodos de instalación

Opción 1: Plugin de WordPress

1. Ve a Plugins → Añadir nuevo
2. Busca "AtoShip Shipping"
3. Haz clic en Instalar ahora
4. Activa el plugin
5. Configúralo en Ajustes

Opción 2: Conexión por REST API

1. Genera las claves de API de WooCommerce
2. Introdúcelas en el panel de AtoShip
3. Configura los ajustes de sincronización

Generar claves de API

En WooCommerce:

1. Ve a WooCommerce → Ajustes
2. Haz clic en la pestaña "Avanzado"
3. Haz clic en "REST API"
4. Añade una clave:
   • Descripción: AtoShip
   • Usuario: Administrador
   • Permisos: Lectura/Escritura
5. Genera la clave de API
6. Copia el Consumer Key y el Secret

Conectar con AtoShip

En el panel de AtoShip:

1. Ve a Ajustes → Integraciones
2. Haz clic en "Añadir tienda"
3. Selecciona WooCommerce
4. Introduce:
   • URL de la tienda
   • Consumer Key
   • Consumer Secret
5. Haz clic en Conectar

Configuración de sincronización

Ajustes de importación de pedidos:

Configurar webhooks

Actualizaciones automáticas: Los webhooks permiten la sincronización en tiempo real.

Cómo configurarlos:

1. WooCommerce → Ajustes → Avanzado → Webhooks
2. Añade un webhook:
   • Nombre: AtoShip Order Update
   • Tema (Topic): Order updated
   • URL de entrega: (proporcionada por AtoShip)
   • Secret: (proporcionado por AtoShip)

Mapeo de datos

Qué se importa:

• Número de pedido
• Datos del cliente
• Dirección de envío
• Información del producto
• Notas del pedido
• Método de envío

Gestión del peso:

• Peso del producto tomado de WooCommerce
• Se puede sobrescribir mediante mapeo por SKU
• Peso predeterminado como respaldo

Mapeo de métodos de envío

Asigna los métodos de WC a los transportistas:

WC "Flat Rate" → USPS Priority Mail
WC "Free Shipping" → USPS Ground Advantage
WC "Local Pickup" → Do not import

Flujo de pedidos

Proceso estándar:

WC Order (Processing) → Import → Ship → Update to Completed

Actualizaciones de estado:

Compatibilidad con varios sitios

WordPress Multisitio (Multisite):

• Conecta cada sitio por separado
• Claves de API independientes por sitio
• Vista unificada en AtoShip

Gestión de variaciones

Variaciones de producto:

• Se importa el título completo de la variación
• SKU para el mapeo
• Los atributos quedan visibles

Campos personalizados

Añadir datos personalizados: Los campos personalizados de WooCommerce se pueden:

• Pasar a las notas de la etiqueta
• Usar en reglas de envío
• Mapear a los detalles del paquete

Probar la conexión

Verifica la configuración:

1. Crea un pedido de prueba en WC
2. Comprueba que se importe en AtoShip
3. Crea una etiqueta de prueba
4. Verifica que el estado en WC se actualice

Problemas frecuentes

Errores de conexión:

Los pedidos no se sincronizan:

1. Verifica el estado del pedido
2. Comprueba la entrega del webhook
3. Revisa los registros de errores
4. Prueba la conexión de la API

Consejos de rendimiento

Para tiendas grandes:

• Usa webhooks (no sondeo)
• Procesa los pedidos por lotes
• Programa la sincronización en horas de baja demanda
• Limpia los pedidos antiguos periódicamente

Consideraciones de seguridad

Buenas prácticas:

• Usa solo HTTPS
• Rota las claves de API periódicamente
• Limita el acceso por IP si es posible
• Monitorea el uso de la API

Compatibilidad con plugins

Compatibilidad confirmada:

• WooCommerce Subscriptions
• WooCommerce Bookings
• WPML
• La mayoría de plugins de envío

Pueden requerir configuración:

• Plugins de checkout personalizados
• Plugins de gestión de pedidos
• Algunos maquetadores de páginas (page builders)

Actualizar la integración

Cuando WooCommerce se actualice:

• Prueba después de cada actualización
• Comprueba el estado de los webhooks
• Verifica que la API siga funcionando
• Revisa posibles funciones obsoletas (deprecations)

Desconectar

Para desconectar:

1. Desactiva el plugin (si lo usaste)
2. Elimínalo en los ajustes de AtoShip
3. Borra las claves de API en WC
4. Elimina los webhooks

Recursos de ayuda

Cómo obtener ayuda:

• Documentación de WooCommerce
• Guía de integración de AtoShip
• Foros de soporte de WordPress
• [email protected]