Conector Mirakl para Jitterbit Integration Studio

Resumo

O conector Mirakl estabelece acesso a 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 por meio da conexão.

O conector Mirakl é acessado na aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).

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 que devem ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

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

Tipos de atividade Mirakl

Leitura: Recupera dados de objeto do Mirakl e deve ser usado como fonte em uma operação.
Criar: Cria dados de objeto no Mirakl e se destina a 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 objeto do Mirakl e deve ser usado como alvo em uma operação.

Nota

Este conector é um Connector SDK, que pode ser consultado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.

Pré-requisitos e versões de API suportadas

O conector Mirakl requer o uso de uma versão de 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 usa a API REST do Mirakl, acessível na URL personalizada da sua instância no formato de 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 tem esses problemas devido às limitações presentes na API REST do Mirakl:

O Mirakl Leia a atividade não consegue recuperar registros de objetos quando o paginate campo está definido para false no esquema de solicitação. Para recuperar registros de objetos com sucesso, paginate deve ser definido como true no esquema de solicitação.
O Mirakl Criar a atividade não retém o value campo para o shop_additional_fields nó em seu esquema de solicitação. Quando value está definido para false no esquema de solicitação, a saída retorna o value conforme definido para true.

Limitações do conector Mirakl

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

Objeto	Operação de API
Inteligência de Negócios	BI01: Recuperar inteligência de negócios.
Mensagens	M12: Responder a um tópico. OR43: Criar uma mensagem sobre um pedido.
Pedidos	OR74: Carregar 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 as categorias do 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: Carregar relatórios de integração e erros de produtos do sistema de informações do operador. VL01: Enviar um arquivo para criar, atualizar ou excluir listas de valores.
Cotações	Q01: Crie uma ou mais solicitações de cotação. Q05: Adicione uma mensagem a uma solicitação de cotação de loja. S32: Carregue documentos comerciais para associar a uma loja.

Solução de problemas

Se você tiver problemas com o conector Mirakl, estas etapas de solução de problemas são recomendadas:

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 para o agente (a menos que esteja usando a Desativar atualização automática do conector política da organização).
Verifique os registros de operação para qualquer informação escrita durante a execução da operação.
Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.
Se estiver usando agentes privados, você pode habilitar registro detalhado do conector para este conector adicionando esta entrada de configuração do registrador ao do seu agente privado logback.xml arquivo:
```
<logger name="org.jitterbit.connector.verbose.logging.mirakl" level="DEBUG"/>
```
Para obter mais informações sobre o registro detalhado de conectores, consulte Registro detalhado para conectores que usam agentes privados Jitterbit.
Se estiver usando agentes privados, você pode verificar os registros do agente para obter mais informações.
Para considerações adicionais sobre solução de problemas, consulte Solução de problemas de operação.