Acks funcionais (CONTRL / 997)

O que são acks funcionais

No EDI B2B, o "200 OK" do transporte só diz que os bytes chegaram. O ack funcional (CONTRL no EDIFACT, 997 no X12) confirma que o interchange foi lido e aceito — é o que parceiros de verdade esperam.

Como ativar

Na edição da integração, seção Modo de operação, marque Acks funcionais (CONTRL / 997).

O que acontece com a flag ativada

Recebendo EDI (inbound):

1. O Lefia valida o interchange contra a spec da mensagem (validador estrito, catálogo).
2. Gera o CONTRL/997 referenciando o interchange (UNB/ISA) com o veredito:

- aceito — documento limpo;
- aceito com erros — violações de spec detectadas; o Lefia processa best-effort e o ack lista as mensagens com problema;
- rejeitado — interchange ilegível (também marca a mensagem em erro).

1. O ack volta na própria resposta do webhook (campo ack) e fica registrado na mensagem (card "Ack funcional" no monitor).

Enviando EDI (outbound):

1. O envio registra as referências de envelope do documento (o que permite correlação).
2. A mensagem fica "aguardando ack".
3. Quando o parceiro devolve o CONTRL/997 (pelo mesmo webhook), o Lefia correlaciona automaticamente e atualiza o status do ack na mensagem enviada.

Onde ver

No Monitor, abra o detalhe da mensagem: o card "Ack funcional" mostra o status, a origem (gerado por nós / recebido do parceiro) e o documento do ack.