Conector Mirakl¶

Resumo¶

O Harmony Mirakl Connector 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 Conexões 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 atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a serem usadas como origens (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

Ler: Recupera dados de objetos 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 alvo em uma operação.
Atualizar: Atualiza os dados do objeto no Mirakl e destina-se a ser usado como alvo em uma operação.
Excluir: Exclui dados de objeto do Mirakl e deve ser usado como destino em uma operação.

Nota

Este conector é um SDK do conector, que pode ser referido 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 do agente 10.1 ou mais tarde. Essas versões do agente baixam automaticamente a versão mais recente do conector quando necessário.

O conector Mirakl usa a API REST 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 apresenta estes problemas devido às limitações presentes na API REST Mirakl:

O Mirakl Ler atividade não consegue recuperar registros de objetos quando o paginate campo está definido como false no esquema de solicitação. Para recuperar registros de objetos com êxito, paginate deve ser definido para true no esquema de solicitação.
O Mirakl Criar atividade não retém o value campo para o shop_additional_fields nó em seu esquema de solicitação. Quando value está configurado 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 oferece suporte à 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 por meio do Conector Harmony HTTP:

Objeto	Operação API
Inteligência Empresarial	BI01: Recuperar inteligência de negócios.
Mensagens	M12: Responder a uma conversa. OR43: Criar uma mensagem em um pedido.
Encomendas	OR74: Carregar documentos para anexar a um pedido.
Produtos	CA01: Sincronize categorias do Marketplace do sistema de informações do operador com o Mirakl. H01: Importe um arquivo para adicionar as categorias do Catálogo do operador ao Mirakl. P21: Sincronize produtos do sistema de informações do operador com Mirakl. P41: Importe produtos para o sistema de informações do operador. P43: Faça upload de relatórios de erros e integração de produtos do sistema de informações do operador. VL01: Envie um arquivo para criar, atualizar ou excluir listas de valores.
Cotações	Q01: Crie uma ou várias solicitações de orçamento. Q05: Adicione uma mensagem a uma solicitação de orçamento de loja. S32: Faça upload de 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 da conexão para garantir que a conexão seja bem-sucedida e garantir que a versão mais recente do conector seja baixada para o agente (a menos que você use a Desativar atualização automática do conector política da organização).
Verifique os logs de operação para qualquer informação escrita durante a execução da operação.
Habilite o registro de depurar de operação (para Agentes em Nuvem ou para Agentes Privados) para gerar arquivos de log e dados adicionais.
Se estiver usando Agentes Privados, você pode ativar registro detalhado do conector para este conector usando esta entrada de configuração específica de nome e nível do criador de logs:
```
<logger name="org.jitterbit.connector.verbose.logging.mirakl" level="DEBUG"/>
```
Se estiver usando Agentes Privados, você pode verificar os logs do agente Para maiores informações.