M461GRV

PE durante gravacao de Nota Fiscal de Saida (MATA461/MATA460). Permite ajuste de campos fiscais antes do commit.

Assinatura: User Function M461GRV() --> NIL

Retorna: NIL

Modulo: SIGAFAT · Rotina: MATA461 · Momento: Pre-commit da NF de Saida

Parametros (PARAMIXB)

Este PE nao recebe parametros via PARAMIXB. A tabela alvo ja esta posicionada quando o PE dispara — opere via (ALIAS)->CAMPO.

Retorno esperado

NIL

Pegadinhas

Ajustes em M->F2_* afetam a NF — cuidado com integracao TSS.
Erros aqui podem deixar TSS com NFe sem retorno.

Quando usar

Ajuste de campos calculados antes do commit
Validacao final consolidada (regras que envolvem multiplos campos)
Override de valores default

Exemplo (template)

User Function M461GRV()
    // Operacao ja gravada — trigger pra acoes pos-evento

    Begin Sequence
        // Logica custom apos gravacao
        // Exemplos: notificar, sincronizar, gerar log
        FwLogger():Info("M461GRV disparado", {;
            "filial": cFilAnt,                                ;
            "user":   RetCodUsr()                             ;
        })
    Recover
        FwLogger():Error("Falha em M461GRV: " + ErrorBlock())
    End Sequence

Return

Cuidados gerais

Idempotencia: PEs podem disparar mais de uma vez em retry ou reprocessamento — codigo deve ser seguro pra rodar varias vezes sem efeito colateral.
Performance critica: PE roda em fluxo do usuario. Operacoes pesadas (loop sobre milhares de registros, chamada HTTP sincrona) podem travar a tela. Use StartJob pra background.
Em JOB sem AppServer ativo: PE chamado via RPC pode ter cFilAnt/cEmpAnt vazios — sempre garanta RpcSetEnv.
Begin Sequence + Recover: erros nao tratados em PE podem deixar transacao Protheus em estado inconsistente. Sempre envolver em Begin Sequence ... End Sequence.
Logging com contexto: use FwLogger com identificacao do PE no log — facilita troubleshooting.