WooCommerce + AtoShip
Importa los pedidos de tu tienda WooCommerce a atoship, compra etiquetas USPS / UPS / FedEx con descuento y envía los números de seguimiento de vuelta, todo sin salir de ninguno de los dos paneles.
Cómo funciona
La integración tiene dos partes: un plugin de WordPress que vive dentro de tu tienda WooCommerce y una conexión desde tu panel de atoship. Juntos mantienen sincronizados de forma automática los pedidos, los números de seguimiento y los estados de los pedidos.
Llegan nuevos pedidos a WooCommerce
Un cliente hace un pedido en tu tienda
Los pedidos se sincronizan con atoship
Se importan automáticamente con datos del cliente, artículos y pesos
Compras la etiqueta y el seguimiento vuelve
El número de seguimiento y el transportista se escriben en el pedido de WooCommerce
Instalación
Paso 1 — Instala el plugin de WordPress
Descarga el archivo atoship-for-woocommerce.zip desde la barra lateral (o el botón de abajo) y luego ve al panel de administración de WordPress:
- Plugins → Añadir nuevo → Subir plugin
- Elige el archivo .zip y haz clic en Instalar ahora
- Haz clic en Activar
Tras activarlo, el plugin aparece en tu lista de Plugins con las acciones Desactivar y Eliminar.
Paso 2 — Conéctate desde atoship
En tu panel de atoship, ve a Canales → Añadir canal → WooCommerce. Introduce la URL de tu tienda y haz clic en Conectar. Se te redirigirá al panel de WooCommerce para aprobar el acceso a la API; una vez aprobado, ambos lados se conectan automáticamente.
OAuth o claves de API: elige lo que funcione mejor para tu tienda. Se recomienda OAuth, que lo gestiona todo de forma automática.
Paso 3 — Verifica la conexión
Después de autorizar, ve a WooCommerce → Ajustes → AtoShip en tu panel de WordPress. Deberías ver el estado de OAuth como «Conectado» y el correo de tu cuenta de atoship.
Ajustes del plugin
Todos los ajustes están en la pestaña WooCommerce → Ajustes → AtoShip. Esto es lo que hace cada sección:
Ajustes de sincronización de pedidos
- Sincronizar pedidos automáticamente — Cuando está activo, los nuevos pedidos que coincidan con los estados seleccionados se envían automáticamente a atoship.
- Estados de pedido a sincronizar — Elige qué estados de pedido de WooCommerce importar. Por defecto: Procesando y En espera.
- Sincronizar pedidos completados — También importa los pedidos ya marcados como completados (útil para la configuración inicial).
Ajustes de seguimiento
- Completar pedidos automáticamente — Marca automáticamente los pedidos de WooCommerce como «Completado» cuando el seguimiento del transportista muestra la entrega.
- Enviar correo de seguimiento — Envía al cliente un correo de «Tu pedido ha sido enviado» cuando se compra una etiqueta en atoship. Incluye el nombre del transportista, el número de seguimiento y un botón «Rastrea tu paquete».
Configuración de webhooks
Muestra la URL y el secreto del webhook de tu tienda. Se configuran automáticamente: no necesitas cambiarlos a menos que estés depurando. El webhook recibe eventos de etiquetas (creada, anulada) y actualizaciones de seguimiento (enviado, entregado, incidencia) desde atoship en tiempo real.
Registro de depuración
Actívalo para escribir registros detallados en WooCommerce → Estado → Registros (fuente: atoship). Útil para solucionar problemas de sincronización o de webhooks. Mantenlo desactivado en producción: genera mucha información.
Qué se sincroniza
WooCommerce → atoship
- Número de pedido, fecha y total
- Direcciones de facturación y envío
- Líneas de artículos con SKU, cantidad y peso
- Notas del pedido
- Nombre y correo del cliente
atoship → WooCommerce
- Número de seguimiento, transportista y nombre del servicio
- Indicador visual de progreso (Preparando → Recogido → En tránsito → Entregado)
- Cronología completa de seguimiento con eventos y ubicaciones
- Enlace al PDF de la etiqueta (para reimprimir)
- Actualizaciones del estado del pedido (→ Completado)
- Notificaciones de entrega e incidencias
Los datos de seguimiento se guardan como metadatos del pedido (_atoship_tracking_number, _atoship_carrier, etc.) y se muestran en un metabox completo en la página de edición del pedido, sin necesidad de un plugin de seguimiento adicional.
Metabox de seguimiento del pedido
Cuando se compra una etiqueta en atoship, el plugin añade un completo metabox AtoShip Shipping a la página de edición del pedido de WooCommerce. No hace falta un plugin de seguimiento extra: todo está integrado.
Transportista y servicio
Muestra el logo real del transportista (FedEx, UPS, USPS, DHL, etc.), el nombre del transportista y el nivel de servicio (Ground, Priority, Express).
Indicador de progreso
Indicador visual de 4 pasos: Preparando → Recogido → En tránsito → Entregado. Se actualiza automáticamente a medida que cambia el estado de seguimiento.
Cronología de seguimiento
Cronología plegable evento por evento, con marcas de tiempo y ubicaciones, ordenada de más reciente a más antiguo.
Acciones rápidas
Rastrea en el sitio oficial del transportista, ve o reimprime el PDF de la etiqueta, o anula una etiqueta sin usar, todo desde la página del pedido.
El número de seguimiento enlaza con la página de seguimiento de atoship para ver los detalles. Los datos de seguimiento se envían por webhook en tiempo real.
Compra de etiquetas por lotes
El plugin añade una opción «AtoShip - Buy Labels» al menú desplegable de acciones por lotes de los pedidos de WooCommerce. Selecciona varios pedidos, elige la acción y se te llevará directamente a tu panel de atoship con esos pedidos ya prefiltrados, listos para comparar tarifas y comprar etiquetas por lotes.
Tarifas de envío en vivo al finalizar la compra
El plugin registra un método de envío AtoShip Shippingen WooCommerce. Cuando está activado (en WooCommerce → Ajustes → Envío), los clientes ven tarifas de USPS, UPS y FedEx en tiempo real durante el pago: las mismas tarifas con descuento que obtienes al comprar etiquetas en atoship.
Para que las tarifas sean precisas, asegúrate de que tus productos tengan peso y dimensiones definidos. El plugin muestra una advertencia en la página de ajustes si a los productos les faltan datos de peso.
Desconexión
Puedes desconectar desde cualquiera de los dos lados:
- Desde atoship: Ve a Canales, busca tu tienda WooCommerce y elimínala. El plugin del lado de WordPress recibirá la notificación y borrará su token automáticamente.
- Desde WordPress: Ve a WooCommerce → Ajustes → AtoShip y haz clic en «Desconectar». O usa el enlace rojo Eliminar de la página de Plugins: esto desconecta, desactiva y elimina el plugin en un solo paso.
Desconectar no elimina ningún pedido, número de seguimiento ni nota de pedido que ya esté en tu tienda. Simplemente detiene la sincronización.
Solución de problemas
Aviso «AtoShip is not configured»
El plugin está activado pero aún no conectado a atoship. Sigue los pasos de conexión de arriba: una vez que se complete OAuth, el aviso desaparece.
Los pedidos no se sincronizan
Comprueba que «Sincronizar pedidos automáticamente» esté activado y que los estados de pedido coincidan. Los pedidos en estados que no seleccionaste no se importarán. Siempre puedes iniciar una sincronización manual desde la página de Canales de atoship.
El seguimiento no aparece en los pedidos de WooCommerce
Asegúrate de que la URL del webhook sea accesible desde internet. Si tu tienda está detrás de un firewall o en localhost, los webhooks no pueden llegar. Revisa WooCommerce → Estado → Registros por si hay errores de webhook.
Advertencia de productos sin peso
El plugin comprueba el peso de los productos para calcular las tarifas de envío con precisión. Haz clic en los enlaces de productos de la advertencia para definir los pesos. Las tarifas pueden ser imprecisas hasta que se corrija.
Requisitos
- WordPress 5.8+
- WooCommerce 6.0+
- PHP 7.4+
- API REST habilitada (predeterminado en WooCommerce)
- Enlaces permanentes «bonitos» (no «Simple»)
- Se recomienda HTTPS; HTTP funciona mediante OAuth 1.0a
v1.1.0· WooCommerce 6.0+ · PHP 7.4+