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

F340FCPTOP

User Function F340FCPTOP()

Substitui a consulta de seleção dos títulos na compensação a pagar.

F340FCPTOPFINA340
01 · VISÃO GERAL

Visão geral

O agrupador oficial descreve filtro de seleção no ambiente TOPconnect. A chamada P12.2210 recebe {cQry} e atribui o retorno a cQry em FA340QRYTI: trata-se de substituição do texto, diferente da concatenação observada em F340FLCP. O artigo oficial sobre NDF e INS mostra PARAMIXB[1] recebendo a consulta. Uma regra fiscal de inclusão de tipos exige análise própria; não reproduzir remoção indiscriminada de literais SQL. (Refs. 1–3) Pesquisa com evidência indexada do TDN; não foi recuperada uma ficha específica completa.

02 · SINTAXE

Sintaxe

User Function F340FCPTOP()

Parâmetros

PARAMIXB[1] / cQry
CharacterContexto de execução

Consulta recebida, conforme exemplo do suporte e chamada comunitária. (Refs. 1–2)

Retorno

Texto de consulta devolvido ao chamador. O exemplo editorial preserva a consulta recebida.

03 · EXEMPLO PRÁTICO

Exemplo editorial baseado na documentação

#Include "Protheus.ch"

User Function F340FCPTOP()
    // Exemplo editorial baseado na passagem e substituição observadas.
    Local cConsulta := PARAMIXB[1]
    // Mantém integralmente os filtros; não altera tipos fiscais.
Return cConsulta
Resultado esperado

Proposta didática com o comportamento descrito nos comentários. Conferir o contexto antes de compilar em homologação. Em revisão: exemplo não compilado nem executado em Protheus. Aliases, bloqueios, posição na transação e compatibilidade devem ser conferidos no release e patch utilizados.

04 · EXEMPLO PRÁTICO

Chamada observada e contexto

// Trecho do chamador P12.2210 (EURAI, ref. 2); não é implementação do PE.
// FINA340.PRX - FA340QRYTI() -> CQRY := EXECBLOCK("F340FCPTOP",.F.,.F.,{CQRY})
Resultado esperado

O registro mostra argumentos e uso imediato do retorno quando presentes. Não inclui o corpo completo do chamador nem comprova a posição do commit.

BOAS PRÁTICAS
  • Não aplicar StrTran global em INS ou converter a consulta inteira para maiúsculas como solução genérica: isso pode alterar literais e critérios alheios à regra. Comparar a lista final de títulos, filiais e saldos.
  • Uma chamada sem quarto argumento não documenta um layout de PARAMIXB. Preservar identificadores do chamador e não inventar campos ou posições.
  • Roteiro de homologação: comparar o fluxo padrão e o customizado, testar sucesso, recusa e repetição e conferir saldos, movimentos e contabilização conforme o processo.
  • Em revisão: exemplo não compilado nem executado em Protheus. Aliases, bloqueios, posição na transação e compatibilidade devem ser conferidos no release e patch utilizados.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. DT F340FCPTOP Cria filtro na rotina de compensação cp. TDN. Consulta em 2026-10-24.
  2. EURAI. Pontos de Entrada P12.2210 - Parte 2. Universo do Desenvolvedor, 2023. Consulta em 2026-10-24.
  3. TOTVS. FINA340: compensação de NDF e INS. Central de Atendimento. Exemplo e contexto funcional.
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