Commercelayer API / WebServices

Conecta Commercelayer con Qapla’

Para conectar Commercelayer con Qapla’, se deberán seguir los siguientes pasos:

1. Obtén las credenciales

Para la conexión servirán los siguientes datos:

    • URL
    • Client ID
    • Client Secret
    • Scope

2. Añade los datos en Qapla’

Completa la configuración en Qapla’ yendo a la configuración del canal: 2. E-commerce > Commercelayer.

Después de la inserción, haz clic en «Guardar y ejecutar prueba».

3. 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 CommerceLayer y haciendo clic en Importación manual.

Estados excluidos de la importación
Puedes excluir 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 la sección “Importaciones > Pedidos” puedes activar las siguientes opciones:

  • Importar imágenes de los productos
    Campo a importar como referencia de pedido: permite seleccionar qué campo de CommerceLayer usar como Referencia de Pedido en Qapla’. Las opciones disponibles son:
    • Atributo «number» del objeto «shipment»
    • Atributo «number» del objeto «order»
    • Atributo «reference» del objeto «shipment»
    • Atributo «reference» del objeto «order»
  • Gestión del contra reembolso (COD). Dado que en CommerceLayer no existe un método de pago predefinido para el contra reembolso, es posible forzar el reconocimiento de un pedido COD configurando los dos campos siguientes. Si ambos se dejan vacíos, Qapla’ utilizará los valores predeterminados. Actualmente solo se puede definir un valor por campo.
    • Tipo de método de pago para pedidos COD: ejemplo wire_transfer
    • Referencia del método de pago para pedidos COD: ejemplo cash_on_delivery

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.

4. Actualización del pedido en CommerceLayer

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

  • No actualizar el pedido

  • Actualizar el pedido a “Enviado” cuando el envío sea rastreable.

  • Actualizar el pedido a “Enviado” cuando la mercancía esté en manos del transportista (los estados reconocidos por Qapla’ son: Enviado, En tránsito, En reparto).

  • Actualizar los envíos en CommerceLayer insertando el número de seguimiento.

¿No funciona?

Qapla’ utiliza las APIs oficiales (Web Services) de CommerceLayer.
Si no funciona, te recomendamos solicitar una verificación al administrador que gestiona tu sitio en CommerceLayer.