Saltar al contenido

Conector Mirakl en Jitterbit Studio

Resumen

El conector Mirakl establece acceso a Mirakl.

El conector Mirakl proporciona una interfaz para crear una conexión Mirakl, la base utilizada para generar instancias de actividades Mirakl. Estas actividades, una vez configuradas, interactúan con Mirakl a través de la conexión.

Se accede al conector Mirakl desde la pestaña Extremos de proyecto y conectores de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza para configurar primero una conexión Mirakl. Los tipos de actividades asociados con esa conexión se utilizan luego para crear instancias de actividades que se pretende utilizar como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión Mirakl específica y sus actividades se denominan extremo Mirakl:

Tipos de actividades Mirakl

  • Leer: Recupera datos de objetos de Mirakl y se pretende utilizar como origen en una operación.

  • Crear: Crea datos de objetos en Mirakl y se pretende utilizar como destino en una operación.

  • Actualizar: Actualiza datos de objetos en Mirakl y se pretende utilizar como destino en una operación.

  • Eliminar: Elimina datos de objetos de Mirakl y se pretende utilizar como destino en una operación.

Los extremos creados con este conector se incluyen en reportes de uso de extremos y cuentan para tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Disable Auto Connector Update.

El conector Mirakl utiliza la API REST de Mirakl, accesible en la URL personalizada de tu instancia con el formato https://marketplace.{environment}.{customerName}.com.br. Consulta la documentación de la API para obtener información sobre los nodos de esquema y los campos.

Limitaciones

Limitaciones de la API de Mirakl

El conector Mirakl tiene estos problemas debido a limitaciones presentes en la API REST de Mirakl:

  • La actividad Leer de Mirakl no puede recuperar registros de objetos cuando el campo paginate está configurado en false en el esquema de solicitud. Para recuperar registros de objetos correctamente, paginate debe estar configurado en true en el esquema de solicitud.

  • La actividad Crear de Mirakl no retiene el campo value para el nodo shop_additional_fields en su esquema de solicitud. Cuando value está configurado en false en el esquema de solicitud, la salida devuelve value configurado en true.

Limitaciones del conector Mirakl

El conector Mirakl actualmente admite la mayoría de objetos y operaciones de API en la API REST de Mirakl. A continuación se enumeran varias excepciones. Estas operaciones de API se admiten a través del conector HTTP de Harmony:

Objeto Operación de API
Inteligencia empresarial
  • BI01: Recuperar inteligencia empresarial.
Mensajes
  • M12: Responder a un hilo.
  • OR43: Crear un mensaje en un pedido.
Pedidos
  • OR74: Cargar documentos para adjuntar a un pedido.
Productos
  • CA01: Sincronizar categorías del Marketplace desde el sistema de información del operador con Mirakl.
  • H01: Importar un archivo para agregar las categorías del Catálogo del operador a Mirakl.
  • P21: Sincronizar productos desde el sistema de información del operador con Mirakl.
  • P41: Importar productos al sistema de información del operador.
  • P43: Cargar reportes de integración y errores de productos desde el sistema de información del operador.
  • VL01: Enviar un archivo para crear, actualizar o eliminar listas de valores.
Cotizaciones
  • Q01: Crear una o varias solicitudes de cotización.
  • Q05: Agregar un mensaje a una solicitud de cotización de tienda.
  • S32: Cargar documentos comerciales para asociar con una tienda.

Solución de problemas

Si experimentas problemas con el conector de Mirakl, se recomiendan estos pasos para la solución de problemas:

  1. Haz clic en el botón Test en la configuración de conexión para asegurar que la conexión sea exitosa y para descargar la versión más reciente del conector en el agente (a menos que se use la política de organización Disable Auto Connector Update).

  2. Revisa los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.

  3. Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  4. Si utilizas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de logger al archivo logback.xml de tu agente privado:

    <logger name="org.jitterbit.connector.verbose.logging.mirakl" level="DEBUG"/>

    Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores usando agentes privados de Jitterbit.

  5. Si utilizas agentes privados, puedes revisar los registros del agente para obtener más información.

  6. Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.