Ir para o conteúdo

Conector Mirakl no Jitterbit Studio

Resumo

O conector Mirakl estabelece acesso ao Mirakl.

O conector Mirakl fornece uma interface para criar uma conexão Mirakl, a base usada para gerar instâncias de atividades Mirakl. Essas atividades, uma vez configuradas, interagem com o Mirakl através da conexão.

Acessa-se o conector Mirakl a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão Mirakl. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Em conjunto, uma conexão Mirakl específica e suas atividades são chamadas de endpoint Mirakl:

Tipos de atividade Mirakl

  • Read: Recupera dados de objetos do Mirakl e destina-se a ser usado como fonte em uma operação.

  • Create: Cria dados de objetos no Mirakl e destina-se a ser usado como destino em uma operação.

  • Update: Atualiza dados de objetos no Mirakl e destina-se a ser usado como destino em uma operação.

  • Delete: Exclui dados de objetos do Mirakl e destina-se a ser usado como destino em uma operação.

Os endpoints criados com este conector estão incluídos em relatórios de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes em nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política de organização Disable Auto Connector Update (Desabilitar atualização automática de conector).

O conector Mirakl usa a API REST Mirakl, acessível na URL personalizada da sua instância no formato https://marketplace.{environment}.{customerName}.com.br. Consulte a documentação da API para obter informações sobre os nós de esquema e campos.

Limitações

Limitações da API Mirakl

O conector Mirakl apresenta estes problemas devido a limitações presentes na API REST Mirakl:

  • A atividade Read do Mirakl não consegue recuperar registros de objetos quando o campo paginate está definido como false no esquema de solicitação. Para recuperar registros de objetos com sucesso, paginate deve estar definido como true no esquema de solicitação.

  • A atividade Create do Mirakl não retém o campo value para o nó shop_additional_fields em seu esquema de solicitação. Quando value está definido como false no esquema de solicitação, a saída retorna value definido como true.

Limitações do conector Mirakl

O conector Mirakl atualmente suporta a maioria dos objetos e operações de API na API REST Mirakl. Várias exceções estão listadas abaixo. Essas operações de API são suportadas através do conector HTTP Harmony:

Objeto Operação de API
Business Intelligence
  • BI01: Recuperar business intelligence.
Mensagens
  • M12: Responder a uma thread.
  • OR43: Criar uma mensagem em um pedido.
Pedidos
  • OR74: Fazer upload de documentos para anexar a um pedido.
Produtos
  • CA01: Sincronizar categorias do Marketplace do sistema de informações do operador com o Mirakl.
  • H01: Importar um arquivo para adicionar categorias de Catálogo do operador ao Mirakl.
  • P21: Sincronizar produtos do sistema de informações do operador com o Mirakl.
  • P41: Importar produtos para o sistema de informações do operador.
  • P43: Fazer upload de relatórios de integração e erro de produtos do sistema de informações do operador.
  • VL01: Enviar um arquivo para criar, atualizar ou excluir listas de valores.
Cotações
  • Q01: Criar uma ou múltiplas solicitações de cotação.
  • Q05: Adicionar uma mensagem a uma solicitação de cotação de loja.
  • S32: Fazer upload de documentos comerciais para associar a uma loja.

Solução de problemas

Se você enfrentar problemas com o conector Mirakl, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política de organização Desabilitar atualização automática do conector).

  2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  3. Ative o log de depuração de operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

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

    Para mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

  5. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

  6. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.