Saltar al contenido

Conector de Mirakl para Jitterbit Studio

Resumen

El conector de Mirakl establece acceso a Mirakl.

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

El conector de Mirakl se accede desde la pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza primero para configurar una conexión de Mirakl. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que están destinadas a ser utilizadas como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

Juntos, una conexión específica de Mirakl y sus actividades se conocen como un punto final de Mirakl:

Tipos de actividades de Mirakl

  • Leer: Recupera datos de objetos de Mirakl y está destinado a ser utilizado como fuente en una operación.

  • Crear: Crea datos de objetos en Mirakl y está destinado a ser utilizado como destino en una operación.

  • Actualizar: Actualiza datos de objetos en Mirakl y está destinado a ser utilizado como destino en una operación.

  • Eliminar: Elimina datos de objetos de Mirakl y está destinado a ser utilizado como destino en una operación.

Nota

Este conector es un conector basado en Connector SDK, que puede ser mencionado por Jitterbit al comunicar cambios realizados en conectores construidos con el Connector SDK.

Los puntos finales creados con este conector se incluyen en informes de uso de puntos finales y cuentan para su licencia.

Requisitos previos y versiones de API compatibles

El conector de Mirakl requiere el uso de una versión de agente 10.1 o posterior. Estas versiones de agente descargan automáticamente la última versión del conector cuando es necesario.

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

Limitaciones

Limitaciones de la API de Mirakl

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

  • La actividad de Mirakl Read no puede recuperar registros de objetos cuando el campo paginate está configurado como false en el esquema de la solicitud. Para recuperar con éxito los registros de objetos, paginate debe configurarse como true en el esquema de la solicitud.

  • La actividad de Mirakl Create no retiene el campo value para el nodo shop_additional_fields en su esquema de solicitud. Cuando value se establece como false en el esquema de la solicitud, la salida devuelve el value como si estuviera configurado en true.

Limitaciones del conector de Mirakl

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

Objeto Operación de API
Inteligencia de Negocios
  • BI01: Recuperar inteligencia de negocios.
Mensajes
  • M12: Responder a un hilo.
  • OR43: Crear un mensaje en un pedido.
Pedidos
  • OR74: Subir 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: Subir informes de integración de productos y errores 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 múltiples solicitudes de cotización.
  • Q05: Agregar un mensaje a una solicitud de cotización de tienda.
  • S32: Subir documentos comerciales para asociar con una tienda.

Solución de problemas

Si experimenta problemas con el conector de Mirakl, se recomiendan los siguientes pasos de solución de problemas:

  1. Haga clic en el botón Probar en la configuración de conexión para asegurarse de que la conexión sea exitosa y de que la última versión del conector se haya descargado en el agente (a menos que se esté utilizando la política de organización Desactivar actualización automática del conector).

  2. Verifique los registros de operaciones para cualquier información escrita durante la ejecución de la operación.

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

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

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

    Para más información sobre el registro detallado del conector, consulte Registro detallado para conectores que utilizan agentes privados de Jitterbit.

  5. Si utiliza agentes privados, puede consultar los registros del agente para obtener más información.

  6. Para consideraciones adicionales de solución de problemas, consulte Solución de problemas de operaciones.