PONTO DE ENTRADAEm revisão

F040FET

ExecBlock("F040FET", .F., .F., nSavRec)

Complementa a gravação do título de FETHAB no contas a receber. Contexto, diagnóstico e limites da documentação.

F040FETFINXFINExecBlockPARAMIXBFETHAB

01 · VISÃO GERAL

Visão geral

O índice Financeiro P12 associa F040FET a MATXATU/FINXFIN e ao complemento da gravação do título de FETHAB; a ficha específica permanece em construção. (TOTVS, s.d., ref. 1) A listagem de chamadas registra ExecBlock("F040FET", .F., .F., nSavRec) em FINXFIN. (TOTVS, s.d., ref. 2) O mecanismo genérico de ExecBlock disponibiliza seu quarto argumento por PARAMIXB. (TOTVS, s.d., ref. 3) Essa evidência não confirma o significado de nSavRec nem o tratamento do retorno. FETHAB significa Fundo Estadual de Transporte e Habitação; o manual MTFUNDOS, de 08/08/2022, é contexto histórico para a integração fiscal. (TOTVS, 2022, ref. 4) Esta ficha está em revisão: a leitura integral das páginas específicas foi limitada por bloqueio de acesso e o exemplo não foi executado em Protheus.

02 · SINTAXE

Sintaxe

ExecBlock("F040FET", .F., .F., nSavRec)

Parâmetros

PARAMIXB

ContextualContexto de execução

Contexto disponibilizado pelo quarto argumento de ExecBlock. Não é um argumento formal obrigatório da User Function. A listagem mostra nSavRec sem array explícito; presença, tipo e significado efetivos precisam ser confirmados no release-alvo.

Retorno

Contrato específico não confirmado nas fontes públicas localizadas. O Return sem expressão pertence apenas ao exemplo de diagnóstico e não estabelece o retorno exigido pelo padrão.

03 · EXEMPLO PRÁTICO

Exemplo de diagnóstico

#Include "Protheus.ch"



User Function F040FET()

    Local uContexto := Nil



    // A variável pode refletir um valor simples; não presumimos um array.

    If Type("PARAMIXB") <> "U"

        uContexto := PARAMIXB

    EndIf



    // Em homologação, registra apenas o tipo, sem dados do título.

    ConOut("F040FET: tipo do contexto = " + ValType(uContexto))

Return

Resultado esperado

Quando a rotina efetivamente acionar o ponto de entrada, o console deverá mostrar o tipo recebido, sem expor o valor do contexto. Se nada aparecer, primeiro confira compilação, RPO, ambiente e cenário. A ausência da mensagem não prova que o PE foi descontinuado.

BOAS PRÁTICAS

Confirme a chamada e o cenário de geração do título no release e patch utilizados.
Preserve as áreas de trabalho caso a customização futura selecione ou reposicione aliases.
Comece pelo diagnóstico do tipo de PARAMIXB, sem imprimir dados do título.
Compare o processamento sem customização e com o exemplo em homologação.
Registre a versão validada e mantenha os comentários didáticos junto ao código.
No manual MTFUNDOS, MV_FETNAT identifica a natureza do FETHAB. (TOTVS, 2022, ref. 4) Confira a configuração efetiva em homologação antes de investigar a ausência do título; esse parâmetro não é um argumento do PE.
Roteiro editorial de teste: compare um cenário com geração de FETHAB e outro sem geração, mantendo os demais dados iguais. Registre quantas vezes o diagnóstico aparece e quais títulos resultam. A repetição de uma linha no índice de chamadas não estabelece a quantidade de execuções por operação.

ARMADILHAS COMUNS

Não presumir que PARAMIXB seja array nem que PARAMIXB[1] represente o contexto.
Não deduzir a tabela ou o registro recebido apenas pelo nome nSavRec.
Não atribuir ao retorno .T./.F. um efeito de autorização ou cancelamento não documentado.
Não assumir execução após commit, bloqueio de registro ou alias posicionado.
Exemplo não compilado nem executado em Protheus; a leitura integral das fontes continua pendente.

Conteúdos relacionados

REFERÊNCIAS

Situação: Em revisão
Página criada em: 20/10/2026 às 09:41
Última revisão em: 20/10/2026 às 09:45
Idioma original: Português
Revisão: Usina.BR