Conector Mirakl para Jitterbit Studio

Resumo

O conector Mirakl estabelece acesso ao Mirakl.

O conector Mirakl fornece uma interface para criar uma conexão Mirakl, a base utilizada para gerar instâncias de atividades Mirakl. Essas atividades, uma vez configuradas, interagem com o Mirakl por meio da conexão.

O conector Mirakl é acessado na aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).

Visão geral do conector

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

Juntos, uma conexão Mirakl específica e suas atividades são referidos como um endpoint Mirakl:

• Ler: Recupera dados de objetos do Mirakl e deve ser usado como uma fonte em uma operação.

• Criar: Cria dados de objetos no Mirakl e deve ser usado como um alvo em uma operação.

• Atualizar: Atualiza dados de objetos no Mirakl e deve ser usado como um alvo em uma operação.

• Excluir: Exclui dados de objetos do Mirakl e deve ser usado como um alvo em uma operação.

Pré-requisitos e versões de API suportadas

O conector Mirakl requer o uso de uma versão do agente 10.1 ou posterior. Essas versões do agente baixam automaticamente a versão mais recente do conector quando necessário.

O conector Mirakl utiliza a API REST do 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 e campos do esquema.

Limitações

Limitações da API Mirakl

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

• A atividade Read do Mirakl não consegue recuperar registros de objetos quando o campo paginate está definido como false no esquema da solicitação. Para recuperar com sucesso os registros de objetos, paginate deve ser definido como true no esquema da 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 da solicitação, a saída retorna o value como definido como true.

Limitações do conector Mirakl

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

Solução de Problemas

Se você encontrar problemas com o conector Mirakl, as seguintes etapas de solução de problemas são recomendadas:

1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização Desativar 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 registro de depuração da 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 registro 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 o registro detalhado do conector, consulte Registro 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.