Saltar al contenido

Conector Mirakl

Resumen

El conector Mirakl establece el 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 Conexiones de la paleta de componentes de diseño (consulte 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 actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que están destinadas a usarse como fuentes (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 actividad de Mirakl

  • Leer: Recupera datos de objetos de Mirakl y está diseñado para usarse como fuente en una operación.

  • Crear: Crea datos de objetos en Mirakl y está diseñado para usarse como objetivo en una operación.

  • Actualizar: Actualiza los datos del objeto en Mirakl y está diseñado para usarse como objetivo en una operación.

  • Borrar: Elimina los datos del objeto de Mirakl y está diseñado para usarse como objetivo en una operación.

Nota

Este conector es un SDK de conector, al que Jitterbit puede hacer referencia cuando comunica cambios realizados en conectores creados con el SDK de Connector.

Requisitos Previos y Versiones de API Compatibles

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

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

Limitaciones

Limitaciones de la API de Mirakl

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

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

  • El Mirakl Crear la actividad no retiene el value campo para el shop_additional_fields nodo en su esquema de solicitud. Cuando value se establece en false en el esquema de solicitud, la salida devuelve el value como está establecido en true.

Limitaciones del Conector Mirakl

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

Objeto Operación API
Inteligencia de Negocios
  • 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 de Marketplace desde el sistema de información del operador con Mirakl.
  • H01: Importe un archivo para agregar las categorías de Catálogo del operador a Mirakl.
  • P21: Sincronizar productos del sistema de información del operador con Mirakl.
  • P41: Importar productos al sistema de información del operador.
  • P43: Cargar informes de errores e integración de productos desde el sistema de información del operador.
  • VL01: Enviar un archivo para crear, actualizar o eliminar listas de valores.
Cotizaciones
  • P01: Cree una o varias solicitudes de cotización.
  • P05: Agregue un mensaje a una solicitud de cotización de tienda.
  • ** S32:** Cargar documentos comerciales para asociarlos con una tienda.

Solución de Problemas

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

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

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

  3. Habilite el registro de depurar de operación (para Agentes en Nube o para Agentes Privados) para generar archivos de registro y datos adicionales.

  4. Si utiliza Agentes Privados, puede habilitar registro detallado del conector para este conector utilizando esta entrada de configuración específica del nombre y nivel del registrador:

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

  5. Si utiliza Agentes Privados, puede consultar los registros de agentes para más información.