M460GRV

PE durante gravacao da SC9 (liberacao). Permite ajuste de campos SC9 antes do commit.

Assinatura: User Function M460GRV() --> NIL

Retorna: NIL

Modulo: SIGAFAT · Rotina: MATA460 · Momento: Pre-commit da gravacao SC9

Parametros (PARAMIXB)

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

Retorno

NIL

Pegadinhas

Ajustes em M-> afetam o registro SC9.
Erro aqui pode deixar liberacao inconsistente com SC6.

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 M460GRV()
    // Operacao ja gravada — trigger pra acoes pos-evento

    Begin Sequence
        // Logica custom apos gravacao
        // Exemplos: notificar, sincronizar, gerar log
        FwLogger():Info("M460GRV disparado", {;
            "filial": cFilAnt,                                ;
            "user":   RetCodUsr()                             ;
        })
    Recover
        FwLogger():Error("Falha em M460GRV: " + 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.

Tabelas afetadas

SC9 — liberacao de pedido (geralmente posicionada quando PE dispara)
Relacionadas: SF2, SD2, SE1