Sistemas conectados
Registre os sistemas da sua operação —sua loja, SAP, o armazém, o ERP— com a chave com que chamam e o endpoint que o Bruxel avisa, e veja se o canal deles está saudável.
O que é um sistema conectado e para que serve?
É o registro de um sistema da sua empresa que conversa com o Bruxel: sua loja on-line, SAP, o armazém (WMS), o ERP ou um middleware. Fica em Canais → Sistemas conectados e diz duas coisas: com qual chave de API do Bruxel esse sistema chama e qual endpoint de webhook o Bruxel avisa.
Com isso o Bruxel sabe de quem é cada aviso e cada chamada. Os fluxos usam isso para dar como feitas as etapas da raia desse sistema (guia «Fluxos e percursos»), e a conciliação por fonte, para saber qual sistema informou cada valor (guia «Conciliação por fonte»).
Quem pode ver e registrar sistemas conectados?
Ver a lista exige o papel de Operador ou superior; um Leitor ou um Editor vê um aviso de que seu papel não basta. Registrar, trocar a chave e o endpoint, diagnosticar, pausar, reativar e excluir exigem Administrador ou Proprietário. Um fornecedor não vê esta tela.
Se a tela disser «Este recurso ainda não está disponível na sua conta», a sua organização está com ele desligado.
Como registro um sistema?
Em «Registrar um sistema», preencha estes campos e clique em «Registrar»:
- Nome: como a sua equipe o reconhece, por exemplo «SAP middleware».
- Tipo: SAP, Armazém (WMS), ERP, Outra loja on-line, Middleware ou Outro sistema. Adobe Commerce só aparece se a sua organização tiver essa conexão (guia «Conectar a sua loja Adobe Commerce»).
- Código (opcional): o nome do sistema nos fluxos. Em minúsculas, começando com letra, com dígitos e sublinhado, até 40 caracteres. Se ficar vazio, sai do nome («SAP middleware» → sap_middleware).
- Chave com que chama e Endpoint que avisamos (abaixo).
- Endereço da loja (opcional): só os tipos de loja pedem.
Como vinculo a chave de API e o endpoint de um sistema?
A chave é criada em Canais → Chaves de API e o endpoint em Canais → Webhooks: crie-os lá primeiro. Só aparecem chaves vigentes, nem revogadas nem vencidas, e do endpoint aparece só o domínio. Uma chave e um endpoint são de um só sistema: os que outro sistema já tem não aparecem.
Um sistema que não é loja pode ter só a chave (se só chama o Bruxel) ou só o endpoint (se só recebe avisos). Para trocá-los depois, «Trocar chave e endpoint», escolha e «Salvar». O que já chegou fica com o sistema que tinha naquele momento: trocar um vínculo só muda o que chega depois.
Uma chave sem vínculo conta pelo nome: o que chega com uma chave chamada «SAP» é de sap, a menos que sap já tenha sua própria chave vinculada.
O que significa o estado de cada sistema?
Cada sistema mostra com qual chave ele chama e quem avisamos, quando chamou pela última vez e quem chamou, quantos avisos faltam entregar, quantas falhas seguidas acumula e o último erro. No canto superior direito, o estado:
| Estado | O que significa |
|---|---|
| Em dia | O canal está saudável. Em uma loja, diz que ela veio buscar o conteúdo, não que o escreveu: se algo não aparecer lá, confira no painel da sua loja. |
| Entregando | Tudo saudável, mas há avisos na fila sem entregar. Alguns segundos é normal; se durar, verifique o sistema. |
| Com falhas | O endpoint continua ligado, mas acumula falhas seguidas. Com 20, ele se desliga sozinho. |
| Sem canal | O endpoint se desligou sozinho depois de falhas demais ou, em uma loja, não há endpoint: nenhum aviso chega. |
| Pausado | Alguém da sua equipe o pausou nesta tela. |
| Sem vínculo | Não tem chave nem endpoint: os fluxos não conseguem reconhecer o que é dele. |
O que faço se um sistema não recebe avisos ou aparece com falhas?
«Diagnosticar» verifica, em ordem, se há uma chave vigente, se ele já chamou com ela, se há um endpoint, se está ligado e se chegou pelo menos um aviso. Em uma loja verifica os cinco; em outro sistema, só o que está vinculado. Mostra a primeira verificação que falha e o que fazer. Só lê: não envia nada a lugar nenhum.
Se o endpoint se desligou sozinho, conserte o sistema e clique em «Reativar canal»: ele volta a ligar e a contagem de falhas recomeça do zero. Se você já tem o máximo de endpoints ligados, desligue ou exclua outro em Webhooks antes. Cada tentativa de entrega aparece em Webhooks (guia «Webhooks»).
O que acontece se eu pausar ou excluir um sistema?
«Pausar» o marca como «Pausado» nesta tela e «Retomar» o traz de volta. Não desliga o webhook nem revoga a chave: isso se faz em Webhooks e em Chaves de API.
«Excluir» e depois «Sim, excluir» apagam só o registro do sistema: o webhook e a chave continuam como estão. Não é possível excluir um sistema cujos avisos um fluxo lê: mude essa etapa ou arquive o fluxo antes.