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

FINCMTC

User Function FINCMTC()

Interpreta os campos da leitora de cheques no TOTVS Recibo.

FINCMTCFINXFIN
01 · VISÃO GERAL

Visão geral

A ficha específica do TOTVS Recibo, com escopo de localização e release 12.1.2210 ou superior atualizado, recebe PARAMIXB[1] e exige seis elementos: banco, agência, código postal, cheque, conta e DV da conta. A listagem P12.2210 também passa {cCmc7}. A tabela e o exemplo oficiais usam posições distintas em alguns campos; o código abaixo demonstra a tabela descrita, não um leiaute bancário universal. Não foi encontrada implementação útil no GitHub. (Refs. 1–2)

02 · SINTAXE

Sintaxe

User Function FINCMTC()

Parâmetros

PARAMIXB[1]
CaractereContexto de execução

Texto recebido da leitora; conferir o prefixo 0< descrito na documentação. (Refs. 1–2)

Retorno

Array obrigatório de seis campos na ordem documentada; não é retorno lógico.

03 · EXEMPLO PRÁTICO

Exemplo editorial baseado na documentação

#Include "Protheus.ch"

User Function FINCMTC()
    // Exemplo baseado na tabela oficial; leiaute deve ser homologado.
    Local cLeitura := PARAMIXB[1]
    Local aCampos := {}
    // Banco, agencia, postal, cheque, conta e DV, nessa ordem.
    AAdd(aCampos, SubStr(cLeitura,2,3))
    AAdd(aCampos, SubStr(cLeitura,5,3))
    AAdd(aCampos, SubStr(cLeitura,8,4))
    AAdd(aCampos, SubStr(cLeitura,12,8))
    AAdd(aCampos, SubStr(cLeitura,20,10))
    AAdd(aCampos, SubStr(cLeitura,30,1))
Return aCampos
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.
// FINXFIN.PRX - FINCMC7TC() -> ACMC7TC := EXECBLOCK("FINCMTC",.F.,.F.,{CCMC7})
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
  • Conferir o leiaute e o prefixo da leitora com dados sintéticos. Não registrar números reais de cheque/conta em logs. Validar comprimentos e política de erro no chamador antes da implantação.
  • 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. PE FINCMTC - Personalización de los datos ingresados en la lectora de cheques TOTVS Recibo. TDN. Consulta em 2026-10-24.
  2. EURAI. Pontos de Entrada P12.2210 - Parte 2. Universo do Desenvolvedor, 2023. Consulta em 2026-10-24.
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