Plataforma · 11
Automações e integrações
Como uma empresa automatiza o trabalho de rotina sem abrir mão das aprovações, e como seu ERP e outros sistemas trocam registros com a plataforma.
Automações
Uma automação se lê como Quando, Só se, Então, e é montada em uma tela visual:
- Quando: o que a dispara. Chega uma mensagem de outro sistema; um lote é registrado, entregue, beneficiado ou muda de status; um certificado é adicionado, retirado ou está para vencer; uma aprovação espera tempo demais; um relatório fica pronto; uma constatação nova é aberta; um fornecedor envia um aviso de recall ou um pedido de evidência; um número passa de um valor; ou um agendamento.
- Só se: condições como "o produto é …" ou "o país do destinatário está na UE".
- Então: avisar no console, mandar e-mail aos membros, propor uma mudança de status, um certificado ou uma configuração de regra de lotes, gerar um relatório ou enviar uma mensagem a outro sistema. Há ramificações, uma etapa repetida para cada lote e valores calculados.
Uma automação pode pedir uma revisão antes de uma etapa: ela pausa e uma pessoa decide se continua ou para. Tudo o que mudaria os registros é preparado como proposta, e uma pessoa ainda precisa aprová-la.
Os operadores criam rascunhos e testam automações; em uma execução de teste, as condições são avaliadas de verdade e as ações são apenas simuladas. Um proprietário ou administrador ativa a automação depois de ler um resumo do que ela vai fazer, para onde envia mensagens e quais propostas prepara. Cada execução é listada com o motivo de cada etapa ter rodado ou sido pulada. Proprietários e administradores podem interromper todas as automações de uma vez.
Modelos cobrem o trabalho comum, como um alerta de vencimento de certificado, um pacote EUDR a cada entrega, a retenção de lotes cujo certificado foi retirado, aprovações esperando demais e um relatório semanal de inventário ou retrato do painel. Usar um modelo cria um rascunho para revisar.
Conectar um ERP
O ERP e os outros sistemas de uma empresa se conectam em Configurações ▸ Integrações:
| Direção | Como |
|---|---|
| Do ERP para a A-REX | um endpoint de entrada recebe as mensagens do ERP (recebimentos de mercadoria, tíquetes de colheita, entregas) no formato do próprio ERP. Mensagens que não batem com os campos esperados vão para quarentena, para que uma pessoa as corrija ou descarte. Uma mensagem pode disparar uma automação, que prepara propostas; ela nunca muda os registros diretamente |
| Da A-REX para o ERP | webhooks enviam eventos (um lote registrado, uma entrega executada, um certificado vencendo, um aviso de recall) ao ERP. Cada mensagem é assinada, e trechos de código prontos mostram como conferir a assinatura |
| Nos dois sentidos, por programa | clientes de máquina e chaves de API chamam a API com permissões e limites próprios |
Os identificadores da própria empresa (os números de lote do ERP, códigos de item, códigos de parceiro) ficam guardados ao lado dos da A-REX, para que cada lado continue usando os seus. Toda integração pode ser praticada antes em um sandbox.
A API e cada evento estão descritos em arquivos OpenAPI e AsyncAPI; veja Desenvolvedores e agentes.
Leitura complementar
Na ajuda: Automatize o trabalho de rotina, Conecte seu ERP e outros sistemas.