M010INC
PE apos inclusao de produto (SB1). Util pra criar regras fiscais associadas, log de auditoria, integracao com catalogo externo.
Assinatura: User Function M010INC() --> NIL
Retorna: NIL
Modulo: SIGAFAT/SIGAEST (Cadastros) · Rotina: MATA010 · Momento: Apos inclusao do produto
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
Exemplo
User Function M010INC()
// Replica produto pra base de e-commerce
U_SyncProdEcom(SB1->B1_COD)
ReturnPegadinhas
- PE dispara tambem em inclusao via ExecAuto.
- Em produtos PA (acabado), tipicamente tem estrutura de engenharia (SG1) — voce pode validar isso aqui.
Quando usar
- Sincronizar registro novo com sistema externo (CRM, e-commerce, EDI)
- Gerar registros vinculados em tabelas Z customizadas
- Enviar notificacao por email/SMS apos cadastro
- Criar workflow de aprovacao
Cuidados gerais
- Erro aqui nao reverte a operacao: o registro ja foi gravado. Falha do PE deve ser apenas logada — nao tentar rollback.
- 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
- SB1 — produto (geralmente posicionada quando PE dispara)
- Relacionadas: SBM, SB5, SG1