PrestaShop + AtoShip
Conecta tu tienda PrestaShop con la API WebService integrada, sin plugin ni extensión. Genera una clave API en tu panel de administración, pégala en AtoShip y los pedidos empiezan a llegar de inmediato.
Cómo funciona
PrestaShop incluye una API WebService REST integrada. AtoShip se conecta a ella mediante una clave WebService que creas en tu panel de administración. No hay módulos adicionales que instalar: todo funciona desde el primer momento.
El cliente hace un pedido
Los nuevos pedidos aparecen en el back office de PrestaShop
Los pedidos se sincronizan con AtoShip
Se importan automáticamente con datos del cliente, artículos y direcciones
Compras la etiqueta y el seguimiento regresa
El número de seguimiento se escribe en el pedido de PrestaShop
Configuración (sin plugin)
Paso 1 — Activa la API WebService
El WebService de PrestaShop está desactivado por defecto. Actívalo primero:
- Ve a Parámetros avanzados → WebService
- Pon Activar el WebService de PrestaShop en Sí
- Haz clic en Guardar
Si no ves el menú WebService, comprueba que tu instalación de PrestaShop sea accesible por HTTPS. La API WebService solo funciona por completo a través de una conexión segura.
Paso 2 — Crea una clave WebService
Aún en Parámetros avanzados → WebService:
- Haz clic en Añadir nueva clave de webservice
- Haz clic en Generar para crear una clave API aleatoria
- En Permisos, activa los siguientes recursos con acceso GETcomo mínimo:
orders,customers,addresses,products,order_details - Activa también el acceso PUT para
ordersyorder_histories(necesario para escribir el seguimiento de vuelta) - Pon el Estado en Activado
- Haz clic en Guardar
- Copia la clave API generada: la necesitarás en el siguiente paso
Paso 3 — Conecta desde AtoShip
En tu panel de AtoShip:
- Ve a Canales → Añadir canal → PrestaShop
- Introduce la URL de tu tienda (p. ej.
https://your-store.com) - Pega la clave API WebService del Paso 2
- Haz clic en Conectar tienda
AtoShip validará las credenciales con GET /api/ y detectará el nombre de tu tienda automáticamente. Los pedidos empezarán a sincronizarse en el siguiente ciclo programado del cron.
Referencia de permisos del WebService
Estos son exactamente los permisos que necesita AtoShip y por qué:
| Recurso | GET | PUT | Por qué |
|---|---|---|---|
| orders | GET | PUT | Leer pedidos, actualizar datos de seguimiento |
| order_details | GET | — | Leer artículos y cantidades |
| order_histories | GET | PUT | Actualizar el estado del pedido al enviar o entregar |
| customers | GET | — | Leer nombre y correo del cliente |
| addresses | GET | — | Leer direcciones de envío y facturación |
| products | GET | — | Sincronizar el catálogo de productos |
Puedes conceder más permisos: AtoShip solo usará los que aparecen arriba.
Qué se sincroniza
PrestaShop → AtoShip
- Número de pedido, fecha y total
- Direcciones de envío y facturación
- Artículos con nombre de producto y cantidad
- Nombre y correo del cliente
- Estado del pedido
- Catálogo de productos
AtoShip → PrestaShop
- Número de seguimiento y nombre del transportista
- Actualización del estado del pedido (Enviado / Entregado)
- Comentario en el historial del pedido con los datos del transportista
Solución de problemas
La conexión falla con «Invalid API key»
Comprueba que el WebService esté Activado y que el estado de la clave sea Activadoen Parámetros avanzados → WebService. Confirma también que la clave tenga al menos acceso GET aorders.
El menú WebService no aparece en el administrador
Ve a Parámetros avanzados → Rendimiento y comprueba si la caché está causando problemas en el menú. Además, el menú WebService requiere permisos de nivel administrador: revisa tu rol de administrador.
Los pedidos no se sincronizan
AtoShip sincroniza en un ciclo programado del cron. Usa Sincronizar ahora en la página de Canales para lanzar una sincronización inmediata. Si eso falla, revisa la URL de la tienda: debe incluir el protocolo (https://) y coincidir exactamente con la URL donde está instalado PrestaShop.
El seguimiento no se actualiza en los pedidos de PrestaShop
Asegúrate de que la clave WebService tenga acceso PUT a orders y order_histories. También puedes usar el botón Reenviar seguimiento en la página de detalle del pedido en AtoShip para enviar el seguimiento manualmente.
Requisitos
- PrestaShop 1.7.x u 8.x
- API WebService activada (Parámetros avanzados → WebService)
- Tienda accesible mediante una URL pública HTTPS
- Cuenta de administrador para crear claves WebService