Conecta WooCommerce con Qapla’
Para permitir que Qapla’ se comunique con tu WooCommerce, sigue los pasos indicados a continuación.
1. Crea una clave de la API REST (Habilita las APIs)
Desde el panel de administración de WordPress, haz clic en: WooCommerce / Ajustes.
Haz clic en Avanzado y luego en REST API.
Haz clic en «Añadir clave».
2. Genera una clave
Introduce “Qapla’” en el campo Descripción.
IMPORTANTE: En el campo Usuario, selecciona un usuario con permisos de administrador del sitio.
Configura «Permiso» en «Lectura / Escritura».
3. Introduce los datos en Qapla’
La configuración en WooCommerce ha finalizado.
Ve a Ajustes > Canales > [Nombre del canal] > Configurar > E-Commerce, selecciona la plataforma y pega la clave generada previamente en WooCommerce.
Después de introducirla, haz clic en “Guardar y ejecutar prueba”.
4. Activación de la importación de pedidos
Para activar la importación de pedidos, accede a: Ajustes > Canales > [Nombre del canal] > Configurar > Importaciones > Pedidos
Selecciona el modo de importación deseado:
- Automática: Qapla’ consultará tu plataforma cada hora (en punto, p. ej., 9:00, 10:00, 11:00, etc.) para importar nuevos pedidos y actualizar los existentes.
- Manual: puedes iniciar la importación en cualquier momento desde la sección Etiquetas, seleccionando WooCommerce y haciendo clic en Importación manual.
Estados excluidos de la importación.
Puedes excluir estados de pedido específicos de la importación (además de los excluidos por defecto), adaptando el flujo a tus necesidades operativas.
Estados de pago personalizados para contra reembolso (COD)
Algunas plataformas CMS permiten personalizar los estados de pago más allá de los estándar del sistema.
Si has configurado estados de pago personalizados para identificar pedidos con contra reembolso (COD), es fundamental notificarlo al Customer Care de Qapla’ para garantizar una gestión correcta de la importación.
Si utilizas solo estados estándar, no es necesaria ninguna acción.
Escribe a support@qapla.it indicando la redacción exacta de los estados de pago personalizados usados para COD. Una vez que el Customer Care de Qapla’ confirme la configuración, los pedidos con estos estados de pago se reconocerán automáticamente como pedidos con contra reembolso.
Ajustes avanzados
Dentro de “Importaciones > Pedidos” puedes activar las siguientes opciones:
- Importar imágenes de los productos
- Importar el peso
- No importar datos internos en las notas de los productos: evita importar notas de productos cuyo nombre comienza con el carácter “_”, que generalmente son datos internos de la plataforma.
- Código arancelario y País de origen: permite importar estos datos desde los productos del pedido, si están disponibles en el CMS. Introduce en el campo correspondiente el nombre exacto del atributo personalizado a leer.
Establecer peso por defecto
Define un peso predeterminado para aplicar a los pedidos importados.
Establecer número de bultos por defecto
Define un número predeterminado de bultos para cada pedido importado.
5. Actualización del pedido en WooCommerce
Para activar la actualización automática en WooCommerce, ve a: Ajustes > Canales > [Nombre del canal] > Configurar > Actualizaciones > E-commerce
Habilita las opciones de actualización disponibles:
- Nunca
- Cuando el envío ha salido
- Cuando el envío ha sido recogido por el transportista
- Cuando el envío está entregado
- Añadir una nota de pedido con el número de seguimiento (Tracking Number)
¿No funciona?
Qapla’ utiliza las APIs oficiales (Web Services) de WooCommerce.
Si no funciona, te recomendamos solicitar una verificación al administrador que gestiona tu sitio en WooCommerce.
Resolución de problemas (Troubleshooting)
| Error | Descripción | Solución |
|---|---|---|
| 401 Unauthorized | Qapla’ no está autorizado para acceder | Las claves proporcionadas son incorrectas o no se autorizaron siguiendo el procedimiento anterior. |
| 403 Forbidden | El servidor prohíbe el acceso de Qapla’ | Verifica que el sitio no tenga estrategias de seguridad activas (firewall) y asegúrate de que las IP de Qapla’ estén autorizadas. Para solicitar el listado completo y actualizado de IPs, contacta con support@qapla.it. |
| 404 Not Found | La URL o el endpoint al que se intenta acceder no existe | Verifica que la URL del sitio sea correcta y confirma que el sitio realmente sea WooCommerce. |
| 500 Internal Server Error | Error interno del servidor del sitio | Verifica la causa en tu servidor. |
| Bad HTTP response | El sitio no es accesible | La URL del sitio es incorrecta, está fuera de línea o ya no existe. |
| 301 Moved Permanently | La URL del sitio redirige a otra | Introduce la URL correcta del sitio. |
| 302 Found | La URL del sitio redirige a otra | Introduce la URL correcta del sitio. |
| Could not resolve host: www.xxx.xx | La URL no existe | Introduce la URL correcta del sitio. |
| OpenSSL SSL_connect: Connection reset by peer in connection to www.xxx.xx:443 | Problemas con el certificado del sitio | Verifica el certificado HTTPS del sitio. |
En general, las conexiones a los servidores responden con códigos de error HTTP.