M410EXC
PE chamado APOS exclusao do pedido de venda. Tipico pra notificar baixa de reserva, cancelar pre-fatura e auditoria.
Assinatura: User Function M410EXC()
// PARAMIXB[1] (numero): do pedido excluido (algumas versoes)
Return // NIL
Retorna: NIL
Modulo: SIGAFAT · Rotina: MATA410 · Momento: Apos exclusao (SC5/SC6 ja apagadas)
Parametros (PARAMIXB)
// PARAMIXB[1] = numero do pedido excluido (algumas versoes)Retorno esperado
NIL
Exemplo
User Function M410EXC()
Local cNumPed := IIf(ValType(PARAMIXB) == "A", PARAMIXB[1], "")
// SC5/SC6 ja nao existem - use cNumPed em log/integracao externa
FwLogger():Warn("Pedido " + cNumPed + " excluido por " + RetCodUsr())
ReturnPegadinhas
- SC5/SC6 nao existem mais — qualquer consulta nelas retorna vazio.
- PARAMIXB pode trazer info adicional dependendo da versao Protheus — checar versao LIB.
- Cuidado com regressao: SC9 (liberacao) pode ja ter sido excluida em cascata, ou nao.
Quando usar
- Limpar registros vinculados em outras tabelas
- Notificar sistema externo do delete
- Auditar com motivo + usuario que excluiu (LGPD)
Cuidados gerais
- Registro nao existe mais:
DBSeekem tabela origem nao retorna nada. UsePARAMIXBpra info. - 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
StartJobpra background. - Em JOB sem AppServer ativo: PE chamado via RPC pode ter
cFilAnt/cEmpAntvazios — sempre garantaRpcSetEnv. - 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
FwLoggercom 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] (numero) | Numeric | sim | do pedido excluido (algumas versoes) |