OpenCart + AtoShip
Instala la extensión de AtoShip en tu tienda OpenCart, conéctala con una clave API y obtén sincronización automática de pedidos, etiquetas de transportistas con descuento y seguimiento de vuelta, todo en un mismo flujo.
Cómo funciona
La integración usa una extensión ligera de PHP que agrega una API REST a tu tienda OpenCart. AtoShip se conecta a esa API con un token Bearer, sin redirecciones de OAuth ni configuraciones complicadas.
El cliente hace un pedido
Los pedidos nuevos aparecen en tu tienda OpenCart
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 de vuelta en el pedido
Instalación
Paso 1 — Descarga la extensión
Descarga atoship-for-opencart.zip desde el botón de la barra lateral. Es un paquete de extensión estándar de OpenCart 4.x.
Paso 2 — Instala mediante el instalador de extensiones
En el panel de administración de tu OpenCart:
- Ve a Extensions → Installer
- Haz clic en Upload y selecciona el archivo
.zip - Espera el mensaje verde de éxito
- Haz clic en el botón Install junto a la extensión atoship
Paso 3 — Activa el módulo
Después de instalar, activa el módulo:
- Ve a Extensions → Extensions y luego selecciona Modules en el menú desplegable de tipo
- Busca Atoship y haz clic en el botón verde Install (si aún no está instalado)
- Haz clic en el botón azul Edit
- Cambia el Status a Enabled y haz clic en Save
- Copia la API Key que se muestra en esta página de ajustes: la necesitarás en el siguiente paso
Paso 4 — Conecta desde AtoShip
En tu panel de AtoShip:
- Ve a Channels → Add Channel → OpenCart
- Introduce la URL de tu tienda (p. ej.
https://your-store.com) - Pega la API Key que copiaste en el Paso 3
- Haz clic en Connect Store
AtoShip validará las credenciales, confirmará la conexión y registrará un endpoint de webhook en tu tienda. Los pedidos existentes empezarán a sincronizarse automáticamente.
Ajustes de la extensión
Todos los ajustes están en Extensions → Modules → Atoship → Edit.
API Key
Se genera automáticamente al instalar. Es el token Bearer que AtoShip usa para autenticar todas las llamadas a la API. Cópiala durante la configuración y pégala en el cuadro de conexión de AtoShip. Usa Regeneratesi sospechas que la clave se ha visto comprometida: ten en cuenta que regenerarla desconectará tu conexión actual de AtoShip y tendrás que volver a conectarte.
HMAC Secret
Se usa para firmar las cargas de webhook que tu tienda envía a AtoShip (p. ej. eventos de pedidos nuevos, cambios de estado). Se configura automáticamente, sin ninguna acción manual.
Estado Enviado / Estado Entregado
Controla qué estado de pedido de OpenCart se asigna cuando AtoShip escribe de vuelta un número de seguimiento (Enviado) o cuando el transportista informa la entrega (Entregado). Por defecto: Enviado → estado 3, Entregado → estado 5 (Complete). Ajústalos para que coincidan con la configuración de estados de pedido de tu OpenCart.
Webhook URL
AtoShip la define automáticamente durante el paso de conexión. Se muestra en solo lectura como referencia. Es el endpoint de tu cuenta de AtoShip que recibe los eventos de pedidos en tiempo real desde OpenCart.
Qué se sincroniza
OpenCart → AtoShip
- Número de pedido, fecha y total
- Direcciones de envío y facturación
- Líneas de pedido con SKU y cantidad
- Imágenes de productos
- Nombre y correo del cliente
- Estado del pedido
AtoShip → OpenCart
- Número de seguimiento y nombre del transportista
- URL de seguimiento del transportista
- Comentario en el historial del pedido (Enviado / Entregado)
- Actualización de estado del pedido (Enviado → Complete)
- Widget de seguimiento en la página de pedido del cliente
Widget de seguimiento para el cliente
Una vez que se compra una etiqueta en AtoShip, los clientes ven un widget en tiempo real de AtoShip Shippingen la parte superior de la página de detalles de su pedido (/index.php?route=account/order.info).
Transportista y servicio
Insignia del transportista (FedEx, UPS, USPS, DHL), nombre del transportista y nivel de servicio de un vistazo.
Barra de progreso
Indicador visual de 4 pasos: Preparando → Recogido → En tránsito → Entregado. Se actualiza automáticamente conforme cambia el estado de seguimiento.
Número de seguimiento
Número de seguimiento en el que se puede hacer clic, que enlaza directamente a la página de seguimiento del transportista.
Cronología de seguimiento
Los 5 eventos de seguimiento más recientes con marca de tiempo, actualizados automáticamente por el cron de seguimiento de AtoShip.
El widget se inyecta a través del sistema de eventos de OpenCart y no requiere modificaciones de plantillas. Solo se muestra al cliente dueño del pedido (verificado por la sesión).
Solución de problemas
"Unauthorized" al conectar
Asegúrate de copiar la API Key exactamente desde la página de ajustes de la extensión, sin espacios de más. Confirma también que el Status del módulo esté en Enabled y guardado.
Los pedidos no se sincronizan
Revisa la URL de la tienda en AtoShip Channels → Edit. Debe coincidir exactamente con la URL pública de tu tienda OpenCart (incluyendo o excluyendo www). Lanza una sincronización manual desde la página de Channels para probar.
El seguimiento no se actualiza en los pedidos de OpenCart
Los webhooks requieren que tu tienda sea accesible públicamente. Si tu tienda está detrás de un firewall o en localhost, los webhooks no llegarán. Usa el botón Resend Tracking en la página de detalle del pedido en AtoShip para enviar los datos de seguimiento manualmente.
La extensión no aparece después de subirla
OpenCart 4.x no carga las extensiones de forma automática. Después de subir el zip, debes hacer clic en Install sobre la extensión en la lista del Installer. Si no la ves, limpia la caché en Dashboard → (ícono de engranaje) → Refresh.
Requisitos
- OpenCart 4.0.x o superior
- PHP 8.0+
- Extensión cURL habilitada
- Tienda accesible mediante una URL pública HTTPS
- Cuenta de administrador con permiso de Extensions
v1.0.0· OpenCart 4.0+ · PHP 8.0+