Integração com o ERP que vira projeto de um ano: chaves, webhooks e filas

Quarta, 16h, indústria química. A assistente de compras está fazendo o que faz toda tarde: pegar os pedidos aprovados no sistema de manutenção e digitar um por um no ERP financeiro. São doze pedidos hoje. No sétimo, correia dentada, ela digita 500 em vez de 50. O ERP aceita. O fornecedor entrega na semana seguinte. O almoxarifado recebe dez caixas em vez de uma e só percebe quando não tem onde guardar.

A integração entre os dois sistemas está “em projeto” há catorze meses. O T.I. diz que depende do fornecedor do ERP. O fornecedor do ERP diz que depende da chave de API que o T.I. precisa gerar. Alguém gerou a chave em setembro e ninguém sabe onde ela foi parar. Enquanto isso, a assistente digita.

O mesmo acontece com o relógio de ponto, que exporta um arquivo que alguém importa; com a balança da expedição, que imprime um papel que alguém transcreve; com o CLP da linha 2, que “tem OPC” mas nunca foi conectado a nada.

O que isso custa de verdade

As 450 correias a mais são o custo do erro. Num cenário ilustrativo, a redigitação diária consome duas horas de uma pessoa e produz um erro relevante por mês, entre quantidade, item e fornecedor trocados. Em um ano, a soma dos erros e das horas paga a integração várias vezes.

O custo escondido é o atraso. O pedido aprovado às 10h só existe no ERP às 17h. O pagamento do fornecedor só é liberado quando as duas pontas batem. A nota fiscal que chega antes do pedido no ERP fica parada na portaria. Cada uma dessas esperas é pequena; juntas, são a razão de a compra “demorar”.

E o custo mais caro: quando a integração finalmente existe, feita por um freelancer com um script no servidor de alguém, ninguém sabe o que passou por ela. Um pedido sumiu? Foi o script, foi o ERP, foi a rede? Sem log, a resposta é uma tarde de gente sênior investigando.

Por que acontece

Integração é tratada como projeto de software, com escopo, reunião e cronograma, quando deveria ser configuração. Cada sistema tem seu jeito de conversar, e cada conexão vira uma negociação entre dois fornecedores que não se conhecem.

A chave de API vive no e-mail de quem gerou. O webhook, quando existe, aponta para um servidor que alguém mantém por boa vontade. Quando falha, falha em silêncio: o pedido não chega, ninguém é avisado, e a assistente digita de novo por segurança. Sem uma fila, o que falhou não é reprocessado. Sem log, o que passou não é comprovado.

O que fazer a partir de segunda-feira

1. Liste tudo que é redigitado hoje. De onde vem, para onde vai, quem digita, quanto tempo por dia. É a lista de integrações que valem a pena.
2. Priorize por erro, não por volume. A redigitação que gera erro caro vem primeiro. A que gera só trabalho vem depois.
3. Centralize as chaves. Um cofre, um responsável, uma lista de quais existem e para que servem. Chave em e-mail é chave perdida.
4. Exija log de toda integração, mesmo do script do freelancer: o que passou, quando, se deu certo. Se não dá para responder “esse pedido chegou?”, a integração não está pronta.
5. Defina o que acontece quando falha. Quem é avisado, e como o dado é reenviado. Falha silenciosa é pior que redigitação.
6. Pergunte ao CLP. Máquina com OPC ou Modbus já fala. Falta alguém ouvir.

Como fica no ArkhiX

A Central de Integrações é a tela onde as conexões com ERPs (SAP, TOTVS), gateways e equipamentos são configuradas, não programadas. As chaves são geradas ali, com nome, escopo, validade e responsável, e a trilha registra quem gerou e quem revogou. O webhook da conexão aponta para uma fila: o que falhou fica na fila, é reprocessado e aparece como pendência, não some.

O pedido vai para o ERP financeiro assim que é aprovado na alçada, sem redigitação. As 50 correias saem do ArkhiX e chegam ao ERP como 50. O relógio de ponto integra direto no Ponto & Jornada. O equipamento fala por aqui: o CLP da linha 2 entra pelo gateway e alimenta o Arkhi4.0, a telemetria calcula o OEE e a parada de máquina abre O.S. O catálogo do Marketplace sincroniza com as cotações.

E o que passou por elas fica visível: cada mensagem, com hora, origem, destino e resultado. “Esse pedido chegou no ERP?” tem resposta na tela em dez segundos, sem tarde de investigação. Quando um recurso é liberado no contrato, ele expõe a integração correspondente, então a Central mostra o que já pode ser conectado.

Checklist

• Sei tudo que é redigitado entre sistemas na minha fábrica hoje
• As chaves de integração estão centralizadas, com dono e validade
• Toda integração tem log do que passou e do que falhou
• Quando uma integração falha, alguém é avisado e o dado é reenviado
• O pedido aprovado chega no ERP financeiro sem uma pessoa digitar
• As máquinas que já têm OPC ou Modbus estão conectadas a algo

Se as 500 correias já chegaram na sua fábrica, vale ver a Central de Integrações conectada ao seu ERP e ao seu relógio de ponto, com o log do que passou.