F100FIM

PE apos compensacao de titulos (FINA100). Permite reagir a quitacoes cruzadas, NCC vs SE1, abatimentos.

Assinatura: User Function F100FIM() --> NIL

Retorna: NIL

Modulo: SIGAFIN · Rotina: FINA100 · Momento: Apos compensacao confirmada

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

Pegadinhas

Compensa NCC com SE1 normal — atualiza ambos. PE pode ver lado SE1 ou NCC dependendo do contexto.
Em conciliacao bancaria, garanta que F100 nao gere SE5 duplicada antes de processar.

Quando usar

Trigger pra acao subsequente automatica
Geracao de relatorio/log
Integracao assincrona via fila

Exemplo (template)

User Function F100FIM()
    // Operacao ja gravada — trigger pra acoes pos-evento

    Begin Sequence
        // Logica custom apos gravacao
        // Exemplos: notificar, sincronizar, gerar log
        FwLogger():Info("F100FIM disparado", {;
            "filial": cFilAnt,                                ;
            "user":   RetCodUsr()                             ;
        })
    Recover
        FwLogger():Error("Falha em F100FIM: " + ErrorBlock())
    End Sequence

Return

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 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

SE1 — compensacao de titulos (geralmente posicionada quando PE dispara)
Relacionadas: SE2, SE5