Magento API / Web Services

Conectar Qapla’ con Magento

Para permitir a Qapla’ de comunicar con tu Magento, es necesario configurar y realizar los siguientes pasos:

1. Crear un rol

Selecciona en el panel de administración de Magento: Sistema / Servicios Web / SOAP/XML-RPC-Rol.

Clica sobre «Añade Nuevo Rol» y da como nombre «Todo».

Clica sobre «Recursos Rol», selecciona «Todo», y después clica sobre «Guardar Rol».

2. Crear un Usuario

Una vez que ha sido creado el nuevo Rol, es necesario crear el Usuario.

Seleccionar en el panel de administración de Magento: Sistema / Servicios Web / SOAP/XML-RPC – Usuarios.

Clica sobre «Añade Nuevo Usuario» y rellena como sigue, utilizando como API Key la cadena de caracteres que se encuentra en el menu 1. Canal, dentro de la configuración de los canales en Qapla’.

Nota. El nombre Usuario TIENE que ser «qapla» sin apóstrofo.

Clica sobre «Guarda Usuario».

3. Añadir el Usuario al Rol

Clica sobre Rol Usuario, selecciona «Todo» y después clica sobre «Guarda Usuario».

4. Verificar WS-I Compliance

Seleccionar: Sistema / Configuración / Magento Core API.

Verifica que WS-I Compliance = No

Configura Habilita Cache WSDL = Sì

Clica sobre «Guarda Configuración».

Añade los datos en Qapla

En Magento la configuración se ha finalizado.

Completa la configuración en Qapla’ yendo a Canales > [Nombre Canal] > Configura > 2. E-commerce > Magento.

Selecciona Magento y completa los datos: Username e Store ID.

5. Permisos mínimos de lectura

En caso de problemas de seguridad, estos son los permisos mínimos de lectura que Qapla’ necesita para integrarse con Magento.

6. Permisos mínimos de escritura

En caso de problemas de seguridad, estos son los permisos de escritura mínimos que Qapla’ necesita para integrarse con Magento.

7. Introduce los datos en Qapla’

En Magento, la configuración ha finalizado.

Ve a Configuración > Canales > [Nombre del Canal] > Configurar > E-Commerce, selecciona la plataforma e introduce el Nombre de Usuario y el Store ID de Magento.

Después de introducir los datos, haz clic en «Guardar y Ejecutar Prueba».

8. Activación de la importación de pedidos

Para activar la importación de pedidos, ve a: Configuración > Canales > [Nombre del Canal] > Configurar > Importaciones > Pedidos
Selecciona el modo de importación deseado:

Automática: Qapla’ consultará tu plataforma cada hora (a las .00, 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 Magento y haciendo clic en Importación manual.

Estados excluidos de la importación
Puedes excluir de la importación estados de pedido específicos (además de los excluidos por defecto), personalizando el flujo según tus necesidades operativas.

Configuración avanzada
Dentro de “Importaciones > Pedidos” puedes activar las siguientes opciones:

Importar imágenes de productos
Importar peso

Preasignación de transportistas
Es posible importar automáticamente el transportista elegido en el checkout de Magento. Sin embargo, en Magento esta configuración requiere especial atención, ya que la plataforma no devuelve códigos de transportista estructurados vía web service.
A diferencia de otras plataformas (p. ej., PrestaShop), Magento no proporciona un identificador único del transportista vía API, sino que transmite dos campos de texto genéricos:

«shipping_method», ejemplo: tablerate_bestway
«shipping_description», ejemplo: Mensajería exprés

El campo «shipping_description» es la descripción visible para el cliente durante el checkout y no es un código único, sino una cadena de texto. Este valor puede variar con el tiempo, según la configuración del comerciante en Magento.
Varios métodos de envío (shipping_method) pueden corresponder a distintos transportistas y no siempre es posible identificar con certeza el transportista seleccionado.

Al ser textos libres, la interpretación correcta del transportista requiere un mapeo específico.
Para configurar correctamente esta función:

Analiza algunos pedidos reales en tu plataforma Magento (puedes usar WS Test) para verificar los valores del campo «shipping_description».
En función de lo detectado, introdúcelos en el campo Código de Transcodificación dentro de la configuración del transportista. Si deseas asociar varias cadenas, sepáralas con comas, sin espacios. Ejemplo: «Mensajería exprés,Envío estándar,Mensajería GLS».
Escribe a support@qapla.it para completar la configuración, indicando el nombre del canal, todos los códigos y el transportista al que asociarlos.

En la siguiente importación, los pedidos se asociarán al transportista correcto.
Se recomienda verificar la importación efectiva y la correcta asignación del transportista en uno o más pedidos después de guardar la configuración, para asegurarse de que el mapeo sea correcto.

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 por cada pedido importado.

9. Actualización del pedido en Magento

Para activar la actualización automática en Magento, ve a: Configuración > Canales > [Nombre del Canal] > Configurar > Actualizaciones > E-commerce
Activa las opciones de actualización disponibles:

Complete (Completado)
- Cambiar el pedido a “Completado” cuando el envío haya salido.
- Cambiar el pedido a “Completado” cuando el envío haya sido recogido por el transportista.
- Cambiar el pedido a “Completado” cuando el envío haya sido entregado.
Número de seguimiento: actualiza los envíos en Magento introduciendo el Tracking Number.

10. Activación de la importación de envíos

Para activar la importación de envíos, ve a: Configuración > Canales > [Nombre del Canal] > Configurar > Importaciones > Envíos > Conectores > Conector Magento > Configurar Conector.
En esta sección, define la hora a la que Qapla’ ejecutará la importación de envíos desde Magento.

Es posible configurar hasta dos horarios por canal.
Si deseas configurar más de dos horarios, contacta con nuestro servicio de atención al cliente en support@qapla.it.

La importación se ejecutará automáticamente en los horarios configurados.

¿No funciona?

Qapla’ utiliza les API (Web Services) oficiales de Magento.

Estos servicios son preinstalados y funcionan en todas las instalaciones correctas de Magento hasta la 1.9.X

Si no funcionara, se recomienda revisar con quien administra tu Magento indicando el problema y solicitando la revisión de este.

For SOAP to work within the Magento application, the PHP SOAP extension ("soap.so") needs to be installed on the server. For RPM-based Linux distributions this is normally installed with the command "yum install php-soap". Note that the PHP SOAP extension is not the same thing as the PEAR SOAP extension

Atención: versión 1.9.3.0

Esta versión puede experimentar un conocido bug.
En esta dirección la fix necesaria.

Script para auto test

Un script que utiliza los Web Services Oficiales de Magento, útil para test internos disponible aquí:
https://github.com/qapla-it/php-check-Magento-Web-Service

Resolución de problemas (Troubleshooting)

Error	Descripción	Solución
401 Unauthorized	Qapla’ no está autorizado a acceder	La clave proporcionada es incorrecta o no se autorizó siguiendo el procedimiento indicado arriba.
403 Forbidden	El servidor bloquea el acceso a Qapla’	Verifica que no haya estrategias de seguridad (firewall) activas y asegúrate de que las IP de Qapla’ estén autorizadas. Para solicitar la lista completa y actualizada de IP, escribe a 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 sea realmente un Magento.
500 Internal Server Error	Error interno del servidor	Verifica la causa en tu servidor.
Bad HTTP response	El sitio no es accesible	La URL del sitio es incorrecta, no está en 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.

Módulos en Magento

El Modulo al momento no da soporte.
Se recomienda utilizar los Web Service oficiales de Magento.