PONTO DE ENTRADAEm revisão

F040FAC

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

Complementa a gravação do título de FACS gerado no contas a receber. Contrato técnico em revisão.

F040FACFINXFINExecBlockPARAMIXBFACS

01 · VISÃO GERAL

Visão geral

F040FAC é relacionado no índice oficial ao complemento da gravação do título de FACS no contas a receber. A linha registra MATXATU e FINXFIN; a ficha específica consta como “Em construção”. (TOTVS, s.d., ref. 1) O manual MTFUNDOS, atualizado em 08/08/2022, identifica FACS como Fundo de Apoio a Cultura da Soja. Esse contexto histórico explica a sigla, sem determinar a aplicação fiscal atual. (TOTVS, s.d., ref. 4) A documentação de FINA040 apresenta os campos “Vlr. FACS” e “Parc. FACS”. Eles ajudam a reconhecer o assunto no fluxo funcional, mas não provam quais campos ou aliases estarão disponíveis dentro deste PE. (TOTVS, s.d., ref. 5) A listagem pública registra FINXFIN chamando ExecBlock("F040FAC", .F., .F., nSavRec). (TOTVS, s.d., ref. 2) O mecanismo genérico de ExecBlock expõe o quarto argumento em PARAMIXB; não há passagem direta pela assinatura da User Function. (TOTVS, s.d., ref. 3)

02 · SINTAXE

Sintaxe

ExecBlock("F040FAC", .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 F040FAC()

    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("F040FAC: 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.
O índice fiscal documenta MV_FACNAT como natureza de FACS e MV_AGFETHA como controle de aglutinação dos títulos de FETHAB, FACS e FABOV. (TOTVS, s.d., ref. 6) Use-os como pontos de conferência no diagnóstico do ambiente, não como argumentos recebidos pelo PE nem como prova de quando ele executa.

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:02
Última revisão em: 20/10/2026 às 09:42
Idioma original: Português
Revisão: Usina.BR