Magento 2 – 2FA

2. Introduce los datos en Qapla’

En Magento 2, la configuración está finalizada.

Accede a Configuración > Canales > [Nombre del Canal] > Configurar > E-Commerce, selecciona la plataforma e introduce la URL y el Access Token de Magento 2.

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

Nota: El Access Token siempre puede recuperarse seleccionando “Qapla Integration” en System / Integrations.

3. 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 2 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.

Estados de pago personalizados para pedidos contra reembolso (COD)
Algunas plataformas CMS permiten personalizar los estados de pago además de los estándar del sistema.
Si has configurado estados de pago personalizados para identificar pedidos contra reembolso (COD), es fundamental comunicarlo al Servicio de Atención al Cliente de Qapla’ para garantizar una correcta gestión de la importación.
Si solo utilizas los estados estándar, no se requiere ninguna acción.
Escribe a support@qapla.it indicando el texto exacto de los estados de pago personalizados utilizados para el contrarreembolso. Una vez confirmada la configuración por Atención al Cliente de Qapla’, los pedidos con esos estados se reconocerán automáticamente como COD.

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

• Importar imágenes de productos
• Importar peso
• 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 del atributo personalizado que se debe leer.

Preasignación de transportistas
Es posible importar automáticamente el transportista elegido en el checkout en Magento 2. Sin embargo, en Magento 2 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 2 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 2.
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 tratarse de textos libres, la correcta interpretación del transportista requiere un mapeo específico.
Para configurar correctamente esta función:

1. Analiza algunos pedidos reales en tu plataforma Magento 2 (puedes usar WS Test) para verificar los valores del campo shipping_description.

2. Según lo detectado, introdúcelos en el 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.

3. Escribe a support@qapla.it para completar la configuración, indicando el nombre del canal, todos los códigos y el transportista correspondiente.

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.

4. Actualización del pedido en Magento 2

Para activar la actualización automática en Magento 2, 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 2 introduciendo el Tracking Number.

• Añadir la lista de productos a la información del envío (documento de envío).

• Generar factura al completar el pedido en Magento 2.

5. 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 2 > Configurar Conector.
En esta sección, define la hora a la que Qapla’ realizará la importación de envíos desde Magento 2.

• Se pueden 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 a las horas configuradas.

¿No funciona?

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

Si no funciona, se recomienda solicitar una verificación al administrador del sitio Magento 2.

Resolución de problemas (Troubleshooting)

En general, las conexiones a los servidores responden con códigos de error HTTP.