Usina BRAdvPL Guia
Entrar
← Todos os tópicos
PONTO DE ENTRADAEm revisão

F300FIL

User Function F300FIL()

Trata o título processado no retorno SISPAG da antiga FINA300.

F300FILFINA300
01 · VISÃO GERAL

Visão geral

A ficha histórica documenta aCpos com quatro posições: número do título, tamanho da parcela, tamanho do título e RecNo. O exemplo oficial lê diretamente PARAMIXB, sem um array externo adicional. (TOTVS, ref. 1) A listagem P12.2210 confirma aCpos como quarto argumento em FA300PROCESSA. (Ref. 2) Uso legado: o SISPAG foi descontinuado em 20/08/2022. A tabela oficial indica FA430FIL na migração para FINA430; isso não comprova contratos idênticos. (Ref. 3)

02 · SINTAXE

Sintaxe

User Function F300FIL()

Parâmetros

PARAMIXB[1]
CharacterContexto de execução

Número do título. (Ref. 1)

PARAMIXB[2]
NumericContexto de execução

Tamanho da parcela. (Ref. 1)

PARAMIXB[3]
NumericContexto de execução

Tamanho do título. (Ref. 1)

PARAMIXB[4]
NumericContexto de execução

RecNo do título. (Ref. 1)

Retorno

A ficha não preenche o contrato de retorno e seu exemplo termina sem valor. A chamada listada não atribui resultado. Não há comprovação de retorno lógico de aprovação ou de substituição do array. (Refs. 1–2)

03 · EXEMPLO PRÁTICO

Conferir dimensões do contexto em homologação legada

#Include "Protheus.ch"

User Function F300FIL()
    // Adaptação defensiva da leitura de aCpos no exemplo oficial (ref. 1).
    // Apenas estudo de ambiente legado; SISPAG descontinuado.
    Local aDados := PARAMIXB
    If ValType(aDados) == "A"
        If Len(aDados) >= 4
            If ValType(aDados[2]) == "N" .And. ValType(aDados[3]) == "N"
                // Não registra número do título nem RecNo.
                ConOut("F300FIL: tamanho parcela=" + Str(aDados[2]) + ;
                    "; tamanho titulo=" + Str(aDados[3]))
            EndIf
        EndIf
    EndIf
Return Nil
Resultado esperado

Propõe observar os tamanhos recebidos, sem posicionar aliases ou alterar títulos. Não é uma nova implementação recomendada de SISPAG. Exemplo não compilado nem executado em Protheus.

BOAS PRÁTICAS
  • PARAMIXB[1] contém o número do título; não usar PARAMIXB[1] como se fosse o array aCpos inteiro.
  • RecNo não identifica sozinho tabela, filial e ordem de pesquisa. Não reposicionar nem gravar usando apenas o número recebido sem conferir o chamador.
  • Não migrar pela simples troca do nome para FA430FIL: verificar a documentação própria, o layout CNAB e o contexto da FINA430.
  • Distinguir processamento do retorno bancário, identificação do título e gravação da baixa. O trecho isolado não confirma commit.
  • Roteiro editorial de homologação: comparar o fluxo padrão e a customização nas operações descritas, conferir os registros resultantes e registrar release e patch.
  • Em revisão: fontes e exemplo conferidos documentalmente; código não compilado nem executado em Protheus. Posição exata na transação e comportamento no release-alvo não confirmados.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. F300FIL - Tratamento de título processado. TDN. Consulta em 2026-10-23.
  2. EURAI. Pontos de Entrada P12.2210 - Parte 2. Universo do Desenvolvedor, 2023. Consulta em 2026-10-23.
  3. TOTVS. SISPAG - Descontinuada em 20/08/22. TDN. Consulta em 2026-10-23.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha