Shopify API / WebServices

Conectar Shopify con Qapla’

La conexión se realiza a través de los Web Services oficiales de Shopify.
Para permitir que Qapla’ se comunique con tu Shopify, sigue los pasos a continuación.

1. Instala nuestra App

Instala nuestra APP desde el siguiente enlace: Qapla’ Connector
Haz clic en “Añadir app.”

2. Sigue las instrucciones en Shopify

Copia el Shop Name y el Qapla’ Token que encontrarás una vez instalada la app.

3. Introduce los datos en Qapla’

En el lado de Shopify, la configuración está completada.
Ve a Configuración > Canales > [Nombre del canal] > Configurar > E-Commerce, selecciona la plataforma e introduce la clave generada previamente en Shopify.


Después, haz clic en “Guardar y ejecutar prueba.”

4. 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ático: 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 Shopify y haciendo clic en Importación manual.

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

Estados de pago personalizados para pedidos contra reembolso (COD)
Algunas plataformas CMS permiten personalizar los estados de pago más allá de los predeterminados.
Si has configurado estados de pago personalizados para identificar pedidos COD, es fundamental informar al Customer Care de Qapla’ para garantizar una correcta gestión de la importación.
Si solo usas los estados estándar, no es necesario realizar ninguna acción.
Escribe a support@qapla.it indicando la denominación exacta de los estados de pago personalizados usados para COD. Una vez confirmada la configuración, los pedidos con esos estados se reconocerán automáticamente como pedidos contra reembolso.

Configuraciones avanzadas
Dentro de Importaciones > Pedidos, puedes activar las siguientes opciones:

  • Importar imágenes de los productos
  • Importar el peso

Preasignación de transportistas
Puedes importar automáticamente el transportista preasignado desde Shopify.
Para configurarlo correctamente:

  1. Revisa los pedidos en Shopify para analizar el campo shipping_lines > carrier_identifier > «code» (puedes usar WS Test).
  2. Cada valor del campo «code» corresponde al código de transportista que debe asociarse a los transportistas disponibles en tu canal/cuenta. Introduce el código del transportista en el campo Código de transcodificación en la configuración del transportista. Si deseas asociar varios códigos, introdúcelos separados por comas y sin espacios. Ejemplo: «BARTOLINI,BRT,BRT-IT»
  3. Escribe a support@qapla.it para completar la configuración, enviando 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 y la asignación correcta 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 los pedidos importados.

Establecer número de bultos por defecto
Define un número de bultos predeterminado para cada pedido importado.

5. Actualización del pedido en Shopify

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

  • Enviado

    • Actualiza el pedido a “enviado” cuando el envío sea rastreable.

    • Actualiza el pedido a “enviado” cuando la mercancía esté efectivamente en manos del transportista (Estados Qapla’: Salido, En tránsito, En entrega).
      Ambas actualizaciones incluyen también la inserción del número de seguimiento.

  • Location (sede): selecciona la Location, un valor presente en tu plataforma. El menú desplegable muestra todas las locations leídas automáticamente mediante la conexión con la plataforma.
    Si tu tienda Shopify utiliza varias Locations, te recomendamos crear un canal de Qapla’ separado para cada una y seleccionar la Location específica.
    Solo se puede asociar una Location por canal.

  • Actualizar con los estados de envío: permite actualizar el pedido en Shopify con el estado de avance del envío.
    La actualización se realiza mediante webhook.

Ejemplo:


  • Mapeo de estados de envío en Shopify: permite reasignar algunos estados del envío para que se actualicen en Shopify con un estado distinto del predeterminado.
    • 10 – Punto de recogida: selecciona el estado en el menú desplegable.
    • 95 – Devuelto: selecciona el estado en el menú desplegable.

ATENCIÓN: “Picked Up” y “Ready to Pick up”, según Shopify, parecen referirse a la recogida en tienda, por lo que no se deben usar para puntos de recogida (como recogida por parte del destinatario).

6. 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 > Shopify Connector > Configurar conector.
En esta sección, establece la hora a la que Qapla’ ejecutará la importación de envíos desde Shopify.

  • Es posible configurar hasta dos horarios por canal.
  • Si deseas configurar más de dos, contacta con nuestro Customer Care en support@qapla.it.

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

¿No funciona?

Qapla’ utiliza las APIs (Web Services) oficiales de Shopify.
Si no funciona, se recomienda solicitar la verificación al administrador que gestiona tu sitio en Shopify.

Resolución de problemas

Error Descripción Solución
401 Unauthorized Qapla’ no está autorizado a acceder El shop name y/o el token proporcionados son incorrectos o no se autorizaron siguiendo el procedimiento anterior.
403 Forbidden El servidor prohíbe el acceso a Qapla’ Verifica que el sitio no tenga estrategias de seguridad activas (Firewall) y asegúrate de que las IPs de Qapla’ estén autorizadas. Para solicitar la lista completa y actualizada de IPs, contacta support@qapla.it.
404 Not Found La URL o el endpoint al que se intenta acceder no existe Verifica la URL del sitio y confirma que el sitio sea realmente un Shopify.
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, 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.

Gestión de puntos de recogida

Está disponible la solución Qapla’ PUDO: puntos de recogida para envíos y entregas flexibles.
Ofrece a tus clientes la elección de puntos de entrega de los transportistas e importa toda la información directamente en Qapla’ para la gestión de los envíos.
Consulta todos los detalles en nuestra guía: Plugin PUDO Shopify.