Conectar a Cleo Integration Cloud: trocar arquivos EDI por mailboxes de parceiros

Preencha o endereço da sua instância Cleo e o usuário e a senha do mailbox emitidos pelo seu administrador Cleo, teste o login, mapeie cada parceiro e ative.

O conector da Cleo troca arquivos EDI com seus parceiros comerciais por meio de um mailbox de parceiro na sua instância do Cleo Integration Cloud: arquivos novos chegam à pasta de download do mailbox e viram pedidos, e arquivos de saída, como avisos de embarque e faturas, são enviados de volta pelo mailbox. Esta conexão não usa um par de chaves de API — não há Client ID para procurar na Cleo. Em vez disso, você entra com o endereço da sua instância e uma conta de mailbox, exatamente como descrito abaixo.

Pré-requisitos#

• Uma instância do Cleo Integration Cloud na qual você consiga entrar, e o endereço dela — o mesmo que você usa para abrir o Cleo Integration Cloud ou o Harmony no navegador.
• Um mailbox de parceiro configurado nessa instância para os parceiros com quem você trocará arquivos. O usuário e a senha do mailbox são emitidos pelo seu próprio administrador Cleo quando o mailbox de parceiro é criado.
• Pelo menos um parceiro comercial EDI cujos arquivos passem por esse mailbox — por exemplo, pedidos de compra entrantes, e avisos de embarque e faturas saintes.
• Uma coisa para confirmar com seu administrador Cleo antes de começar: se a sua instância tem a verificação por chave de API ativada para chamadas à API. Só nesse caso você precisará de uma chave de API — a maioria das instâncias não tem, e a maioria das pessoas deixa esse campo vazio.

Obter credenciais#

1. Anote o endereço da sua instância Cleo. É o endereço com o qual você entra no Cleo Integration Cloud ou no Harmony, por exemplo https://mycompany.cleointegration.com. Ele será a URL base da próxima etapa — é obrigatório e precisa ser a sua própria instância, não um endereço compartilhado ou de exemplo.
2. Peça ao seu administrador Cleo o usuário e a senha do mailbox de parceiro. Eles foram emitidos juntos quando o mailbox foi criado, e é essa conta que a conexão usa para entrar e trocar arquivos — é uma conta de mailbox dentro da sua instância, não o seu login pessoal, a menos que o administrador os tenha tornado iguais.
3. Se a senha foi perdida, não tente adivinhar: seu administrador Cleo redefine a senha do mailbox dentro da sua instância Cleo, e você passa a usar a nova senha. Não há uma página de recuperação separada para esta conexão fora da instância.
4. Somente se o administrador confirmar que sua instância exige uma chave de API para chamadas à API: peça também essa chave de API e guarde-a junto com as credenciais do mailbox. Se a sua instância não exige, você não precisa de mais nada — não procure um Client ID ou Client Secret, porque esta conexão não os usa.

Preencher no Integration#

1. Abra Integration → Marketplace → Cleo → Nova conexão.
2. URL base: o endereço da sua instância Cleo, por exemplo https://mycompany.cleointegration.com. Este campo é obrigatório. Copie-o exatamente como você o usa para entrar — um endereço errado significa que o teste da próxima etapa não terá onde entrar.
3. Usuário do mailbox: o nome de usuário do mailbox que seu administrador Cleo emitiu quando o mailbox de parceiro foi criado. Preencha a conta do mailbox em si, não um endereço de e-mail pessoal.
4. Senha do mailbox: a senha emitida junto com esse usuário. Ela é criptografada em repouso e nunca exibida. Se você redefinir essa senha dentro da sua instância Cleo mais tarde, atualize-a aqui também, ou a conexão deixará de entrar.
5. Chave de API (opcional): deixe este campo vazio, a menos que sua instância tenha a verificação por chave de API ativada para chamadas à API. Só nesse caso, cole a chave de API que seu administrador lhe deu. Deixar vazio é o normal para a maioria das instâncias — um campo vazio aqui não torna a conexão incompleta.

Testar a conexão#

Clique em Testar a conexão. O teste entra na URL base com o usuário e a senha do mailbox e os troca por um token de login. Se passar, significa uma única coisa: o endereço da instância está acessível e essa conta de mailbox consegue entrar. O teste não baixa nem envia nenhum arquivo do mailbox, e não verifica suas pastas de download e upload — portanto, um teste aprovado não significa, por si só, que os arquivos EDI já possam fluir. A configuração de pastas e parceiros é tratada na próxima seção, e as perguntas frequentes abaixo explicam o que verificar se o login funciona, mas os arquivos não se movem.

Mapping / escolher modelo#

A Cleo funciona por troca de arquivos, então o mapeamento é configurado por parceiro comercial em torno das pastas do mailbox desse parceiro. Para cada parceiro, escolha o modelo desse parceiro e verifique duas direções: os arquivos entrantes puxados da pasta de download do mailbox — por exemplo, um arquivo de pedido de compra (850) — devem pousar como um pedido padrão, com número do pedido, linhas, quantidades e dados de entrega nos lugares certos; e os resultados de saída — o aviso de embarque (856) e a fatura (810) gerados a partir do fulfillment — devem ser escritos no formato de arquivo que esse parceiro espera e colocados para upload pelo mailbox. Confirme também que a pasta de download para novos arquivos entrantes e a pasta de upload para arquivos saintes estejam configuradas nas definições de conexão EDI desse parceiro: essas pastas são separadas dos quatro campos de credenciais, e um parceiro sem pastas ou sem mapeamento não tem onde pousar seus arquivos, mesmo quando o teste passa. Confira a prévia de mapeamento com um arquivo real de cada parceiro antes de ativar.

Ativar#

Após ativar, o Integration puxa arquivos novos da pasta de download do mailbox de parceiro na frequência que você definir, transforma arquivos de pedido em pedidos e envia os arquivos de saída — avisos de embarque e faturas — de volta pelo mailbox para entrega a cada parceiro. Só fluem os parceiros com pastas e mapeamento configurados; um parceiro que foi pulado fica em silêncio até a configuração dele terminar. Acompanhe os primeiros arquivos de cada parceiro em Runs / Logs antes de deixar a troca sem supervisão.

Perguntas frequentes#

O teste falha: o login é rejeitado

O usuário ou a senha do mailbox na conexão não correspondem à conta de mailbox na sua instância Cleo, ou a senha foi redefinida na instância depois que você a preencheu aqui. O teste só vai até o login, então uma rejeição nesta etapa é sempre sobre o endereço ou a própria conta do mailbox — não sobre pastas ou mapeamento, aos quais o teste nunca chega.

Verifique primeiro a URL base e certifique-se de que seja o endereço da sua própria instância, exatamente como você o usa para entrar. Depois peça ao seu administrador Cleo que confirme o usuário do mailbox e, se a senha puder ter mudado, que redefina a senha do mailbox dentro da instância. Cole a senha atual na conexão, salve e teste de novo.

Não encontro nenhum Client ID e o campo de chave de API me confunde

Não há nada de errado com a sua configuração da Cleo — esta conexão simplesmente não tem Client ID. A Cleo usa aqui um login na instância em vez de um par de chaves de API, então nenhum Client ID ou Client Secret é emitido para ela. O campo de chave de API é um extra separado e condicional: ele só se aplica quando uma instância tem a verificação por chave de API ativada, o que a maioria não tem.

Pare de procurar um Client ID e preencha apenas o endereço da instância e o usuário e a senha do mailbox. Deixe o campo de chave de API vazio, a menos que seu administrador Cleo confirme que sua instância exige uma chave de API — nesse caso, peça a chave a ele e cole-a. Depois teste a conexão.

O teste passa, mas nenhum arquivo EDI chega de um parceiro

O login funciona, então o endereço e a conta do mailbox estão certos. A lacuna está depois do login: o teste nunca toca os arquivos nem as pastas do mailbox, então um parceiro ainda pode estar sem a configuração da pasta de download, da pasta de upload ou do mapeamento — e, sem isso, os arquivos dele não têm de onde ser coletados e nunca viram pedidos.

Peça ao seu administrador Cleo que confirme que o mailbox de parceiro está recebendo os arquivos desse parceiro e depois abra as definições de conexão EDI desse parceiro e verifique se a pasta de download para arquivos novos e a pasta de upload para arquivos saintes estão ambas configuradas. Conclua o mapeamento desse parceiro na seção Mapping acima, confira-o com um arquivo real e acompanhe Runs / Logs para o próximo arquivo do parceiro.

Os pedidos entram, mas os arquivos de aviso de embarque e de fatura não chegam ao parceiro

A entrada funciona, então o mailbox e o lado de download dele estão certos. A lacuna está no lado de saída da configuração desse parceiro: a pasta de upload dele ou o mapeamento de saída para o aviso de embarque (856) e a fatura (810) nunca foi concluído, então os resultados do fulfillment não têm arquivo para voltar.

Abra as definições de conexão EDI e o mapeamento desse parceiro e conclua o lado de saída: a pasta de upload, mais os mapeamentos 856 e 810 no formato de arquivo que esse parceiro espera. Confira a prévia de mapeamento com um pedido já atendido e depois acompanhe Runs / Logs para o próximo arquivo de saída para esse parceiro.