PUNTO DE ENTRADAEn revisión

F040FAC

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

Complementa la grabación del título de FACS generado en cuentas por cobrar. Contrato técnico en revisión.

F040FACFINXFINExecBlockPARAMIXBFACS

01 · DESCRIPCIÓN GENERAL

Descripción general

El índice oficial relaciona F040FAC con la grabación complementaria del título de FACS en cuentas por cobrar. Su fila registra MATXATU y FINXFIN; la ficha específica continúa marcada como “Em construção” (en construcción). (TOTVS, s.d., ref. 1) El manual MTFUNDOS, actualizado el 08/08/2022, identifica FACS como Fundo de Apoio a Cultura da Soja. Este contexto histórico explica la sigla sin establecer su aplicación fiscal actual. (TOTVS, s.d., ref. 4) La documentación de FINA040 presenta los campos “Vlr. FACS” y “Parc. FACS”. Ayudan a reconocer el tema en el proceso funcional, pero no demuestran qué campos o aliases estarán disponibles dentro de este PE. (TOTVS, s.d., ref. 5) La lista pública muestra FINXFIN llamando a ExecBlock("F040FAC", .F., .F., nSavRec). (TOTVS, s.d., ref. 2) El mecanismo genérico de ExecBlock expone su cuarto argumento mediante PARAMIXB, no mediante parámetros directos en la firma de la User Function. (TOTVS, s.d., ref. 3)

02 · SINTAXIS

Sintaxis

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

Parámetros

PARAMIXB

ContextualContexto de ejecución

Contexto expuesto por el cuarto argumento de ExecBlock. No es un argumento formal obligatorio de la User Function. La lista muestra nSavRec sin array explícito; presencia, tipo y significado efectivos requieren comprobación en el release utilizado.

Retorno

Contrato específico no confirmado en las fuentes públicas localizadas. Return sin expresión pertenece solamente al ejemplo de diagnóstico y no establece el retorno exigido por el estándar.

03 · EJEMPLO PRÁCTICO

Ejemplo de diagnóstico

#Include "Protheus.ch"



User Function F040FAC()

    Local uContexto := Nil



    // La variable puede reflejar un valor simple; no suponemos un array.

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

        uContexto := PARAMIXB

    EndIf



    // En pruebas, registra solo el tipo, sin datos del título.

    ConOut("F040FAC: tipo del contexto = " + ValType(uContexto))

Return

Resultado esperado

Cuando la rutina ejecute el punto de entrada, la consola deberá mostrar el tipo recibido sin exponer el valor del contexto. Si no aparece nada, compruebe primero compilación, RPO, ambiente y escenario. La ausencia del mensaje no demuestra que el PE haya sido descontinuado.

BUENAS PRÁCTICAS

Confirme la llamada y el escenario de generación del título en el release y patch utilizados.
Preserve las áreas de trabajo si una personalización futura selecciona o reposiciona aliases.
Comience por diagnosticar el tipo de PARAMIXB sin imprimir datos del título.
Compare el procesamiento sin personalización y con este ejemplo en pruebas.
Registre la versión validada y conserve los comentarios didácticos en el código.
El índice fiscal documenta MV_FACNAT como naturaleza de FACS y MV_AGFETHA como control de agrupación de títulos de FETHAB, FACS y FABOV. (TOTVS, s.d., ref. 6) Úselos como puntos de diagnóstico del ambiente, no como argumentos del PE ni como prueba del momento de su ejecución.

ERRORES COMUNES

No suponga que PARAMIXB sea un array ni que PARAMIXB[1] represente el contexto.
No deduzca la tabla o el registro recibido solamente del nombre nSavRec.
No atribuya al retorno .T./.F. un efecto de autorización o cancelación no documentado.
No suponga ejecución después del commit, bloqueo del registro ni alias posicionado.
El ejemplo no fue compilado ni ejecutado en Protheus; la lectura integral de las fuentes continúa pendiente.

Contenido relacionado

REFERENCIAS

Estado: En revisión
Página creada el: 20/10/2026 a las 09:02
Última revisión el: 20/10/2026 a las 09:42
Idioma original: Portugués
Revisión: Usina.BR