Conecte seu ERP e outros sistemas

Seu ERP já conhece suas colheitas, recebimentos e expedições. Conectá-lo significa que ninguém digita nada duas vezes. Tudo fica em Configurações › Integrações, em cinco abas: Webhooks, Entrada, Clientes de máquina, Endereços IP e Identidade de credenciais (a identidade com que os seus passaportes de produto são assinados, veja Identidade de credenciais). Proprietários e administradores configuram as conexões nas empresas de produção; em um sandbox, os operadores também podem configurá-las.

O que chega de outro sistema nunca age sozinho: vira um evento, um rascunho ou uma aprovação, e uma pessoa precisa aprovar.

Escolha o caminho certo

Receba mensagens do seu ERP

1. Em Entrada, selecione Adicionar endpoint de entrada.
2. Remetente: dê um nome (por exemplo, "Recebimentos ERP") e escolha Como o remetente assina.
3. Acesso e limites: se quiser, restrinja os Endereços de remetente permitidos e defina o tamanho e a frequência das mensagens.
4. Mensagem de exemplo: cole uma mensagem típica. Os campos dela viram o formato esperado.
5. Selecione Criar e confirme com o código do autenticador. Copie o Endereço e o segredo para o seu ERP: o segredo aparece uma única vez.

As mensagens que não batem com os campos esperados ficam Em quarentena. Abra uma para Verificar de novo depois de corrigir os campos, ou Descartar.

Envie eventos ao seu ERP (webhooks)

1. Em Webhooks, selecione Adicionar endpoint.
2. Destino: um nome, a URL https do seu sistema e o Formato (CloudEvents (recomendado) ou JSON simples). Marque Automações podem enviar para este endpoint se etapas de automação devem enviar para ele.
3. Eventos: Comece com um modelo (Tudo sobre lotes, Aprovações, Relatórios, Mudanças no diretório, Só problemas, Regras de lotes e complementos) ou escolha os eventos por grupo. Por exemplo, Entrega aguardando e Entrega com falha avisam o seu ERP quando uma entrega aprovada fica parada ou não pode ser feita.
4. Revisão e depois Criar. Copie o segredo de assinatura. A A-REX envia uma solicitação de verificação, e o endpoint fica Ativo quando seu sistema responde.

Um endpoint recebe os eventos da sua própria empresa: eventos reais em uma empresa de produção, eventos de treino em um sandbox. As mensagens levam identificadores e links, não nomes. Cada endpoint lista as Entregas dele com todas as tentativas; as que falham são repetidas, e Recuperar / reenviar pendentes manda de novo o que seu sistema perdeu. Libere no seu firewall os endereços de Endereços IP.

Confira se uma mensagem vem da A-REX

Toda mensagem de webhook é assinada com o segredo do endpoint, que começa com whsec_. O seu sistema precisa conferir essa assinatura antes de confiar em uma mensagem. Abra o endpoint em Webhooks: o painel Verificar assinaturas traz código pronto em TypeScript, Python, Java e C# para a sua equipe de TI copiar. Durante um Rotacionar segredo, o segredo anterior e o novo valem pelo período de sobreposição que você escolher, então passe os dois para a conferência.

Clientes de máquina

Em Clientes de máquina, selecione Criar cliente, escolha o Acesso (Leitura, Proposta) e o Método de autenticação: Chave privada (recomendado) ou Segredo do cliente. Nenhum acesso permite aprovar: o que um sistema propõe espera por uma pessoa. Os segredos de cliente e as chaves de API dizem a que tipo de empresa pertencem: começam com arex_cs_prod_ ou arex_cs_sandbox_, e arex_sk_prod_ ou arex_sk_sandbox_, para que uma chave de treino nunca seja confundida com uma de produção. As chaves criadas antes continuam funcionando.

Descrições da API e dos eventos

Para a sua equipe de TI, a A-REX descreve a API em OpenAPI 3.1 e cada evento de webhook em AsyncAPI 3.0. As duas descrições são geradas pela própria plataforma, então correspondem ao que ela aceita e envia. Os seus desenvolvedores podem pedir os arquivos atuais em Suporte e depois conectar com um cliente de máquina.

Seus próprios códigos

Parceiros, locais e produtos podem ter o código próprio da sua empresa, o mesmo que têm no seu ERP. Assim sua integração encontra um produtor, uma fazenda ou um produto pelo seu código, e as mensagens podem incluí-lo, sem que seu ERP precise conhecer os identificadores da A-REX.

Importação de arquivo

A importação de arquivo (CSV) de recebimentos de colheita, entregas, laudos de laboratório e cadastros está chegando às Integrações. Ela confere cada linha antes, lista os erros e depois cria aprovações pendentes, nunca alterações diretas.

Pratique em um sandbox

Teste tudo antes que a sua empresa de produção use:

• Crie um sandbox a partir da sua organização: Nova empresa › Um sandbox. É uma empresa de prática com dados fictícios, e os endpoints dele recebem os próprios eventos: aprove uma colheita de prática e veja a mensagem real chegar. Operadores podem adicionar endpoints ali; em uma empresa de produção, os endpoints exigem um proprietário ou administrador e o segundo fator dele.
• Em um endpoint, selecione Enviar um evento de exemplo para mandar um exemplo assinado, marcado como exemplo, e ver exatamente a solicitação e a resposta.
• A execução de teste de uma automação só simula as mensagens: nada chega aos seus sistemas reais. Veja Automações.