M410STZ7

PE chamado quando status de um item de pedido (SC6) muda. Permite reagir a mudancas de estado (faturado, parcial, cancelado).

Assinatura: User Function M410STZ7() // PARAMIXB[1] (cStatus): ("L"=liberado, "P"=parcial, "F"=faturado, "C"=cancelado) // PARAMIXB[2] (nRecSC6): (RecNo do item) Return // NIL

Retorna: NIL

Modulo: SIGAFAT · Rotina: MATA410 · Momento: Mudanca de status do item — entrega, faturamento parcial, cancelamento

Parametros (PARAMIXB)

// PARAMIXB[1] = cStatus ("L"=liberado, "P"=parcial, "F"=faturado, "C"=cancelado)
// PARAMIXB[2] = nRecSC6 (RecNo do item)

Retorno esperado

NIL

Pegadinhas

PE de "evento" — disparado varias vezes durante o ciclo de vida do item.
Posicione SC6 manualmente com SC6->(DBGoTo(nRecSC6)).
Em pedidos grandes (1000 itens), PE roda 1000+ vezes — cuidado com I/O.

Quando usar

Customizacao da rotina padrao Protheus

Exemplo (template)

User Function M410STZ7()
    // Implementacao customizada do PE

    Begin Sequence
        // ...
    Recover
        FwLogger():Error("M410STZ7 falhou: " + 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

Veja tambem

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`PARAMIXB[1] (cStatus)`	Character	sim	("L"=liberado, "P"=parcial, "F"=faturado, "C"=cancelado)
`PARAMIXB[2] (nRecSC6)`	Numeric	sim	(RecNo do item)