MA410GRV

PE durante gravacao do pedido. Espelho de MT100GRV mas pra pedido de venda (SC5/SC6).

Assinatura: User Function MA410GRV() --> NIL

Retorna: NIL

Modulo: SIGAFAT · Rotina: MATA410 · Momento: Pre-commit do pedido

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

Acessa M->C5_* (cab) e aCols (itens) — alteracoes valem se PE retornar OK.
Help() retorna sem confirmar.

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

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

SC5 — pedido de venda (geralmente posicionada quando PE dispara)
Relacionadas: SC6, SC9