Pular para o conteúdo principal

FNC003 — Parâmetros de Boleto (enriquecimento)

Menu: Financeiro > Parâmetros de Boleto

Objetivo​

A tela FNC003 cadastra, por combinação de banco, agência e forma de pagamento, os parâmetros de cobrança bancária (boleto) de cada empresa: carteira, layout de remessa/retorno, instruções de protesto/multa/juros, dados do cedente/titular/matriz e as credenciais de integração via API (PJBank, Pix ou ACBr, incluindo o onboarding de certificado digital do Itaú). Todas as emissões de boleto, geração de arquivos de remessa e processamento de retorno dependem do parâmetro aqui configurado para o banco/agência/forma de pagamento usados na cobrança.

Fluxo principal​

  1. Clicar em Novo para iniciar um parâmetro de boleto (empresa da sessão é preenchida automaticamente com valores padrão). (Dados Principais) — source/FNC003/UFNC003.pas:778-801 (TfrmFNC003.btnNovoClick)
  2. Informar o Banco (F9 para buscar); o sistema valida se está cadastrado em Bancos e Agências. (Dados Principais) — source/FNC003/UdmFNC003.pas:439-449 (TdmFNC003.tabBOLETOCD_BANCOValidate)
  3. Informar a Agência (depende do Banco já informado); o sistema valida se está cadastrada para esse banco. (Dados Principais) — source/FNC003/UdmFNC003.pas:527-540 (TdmFNC003.tabBOLETOCD_AGENCIAValidate)
  4. Informar a Forma de Pagamento (depende de Banco e Agência); o sistema impede duplicidade para o mesmo banco/agência. (Dados Principais) — source/FNC003/UdmFNC003.pas:383-402 (TdmFNC003.tabBOLETOCD_FORMAPAGTOValidate)
  5. Se emissão é 'Banco Emite', informar a Sequência do Boleto (e de Remessa, se aplicável) na aba Informações Adicionais. (Informações Adicionais) — source/FNC003/UFNC003.pas:684-689 (TfrmFNC003.btnSalvarClick)
  6. Se o boleto é emitido em nome da matriz, preencher os dados na aba Dados da Matriz (pessoa tipo Empresa). (Dados da Matriz) — source/FNC003/UdmFNC003.pas:818-836 (TdmFNC003.tabBOLETOCD_EMPMATRIZValidate)
  7. Se houver integração via API, selecionar o tipo (PJBank, PIX ou ACBr) na aba Integração API e preencher as credenciais/carteira exigidas. (Integração API) — source/FNC003/UdmFNC003.pas:209-234 (Habilita_CamposAPI)
  8. Para Itaú via ACBr, clicar em 'Gerenciar Certificado' para gerar o CSR, enviar ao banco e testar a conexão mTLS. (Integração API > Itaú) — source/FNC003/UFNC003.pas:1767-1782 (TfrmFNC003.btnGerenciarCertITAUClick)

Campos obrigatórios​

CampoCondiçãoMensagemFonte
Código do Bancosempre, ao salvarsource/FNC003/UFNC003.pas:662-666 (TfrmFNC003.btnSalvarClick)
Código da Agênciasempre, ao salvarsource/FNC003/UFNC003.pas:667-671 (TfrmFNC003.btnSalvarClick)
Código da Forma de Pagamentosempre, ao salvarsource/FNC003/UFNC003.pas:672-682 (TfrmFNC003.btnSalvarClick)
Sequência do Boleto (NM_SEQBOLETO)quando Tipo de Emissão = 'Banco Emite' (TP_EMISSAO=1)source/FNC003/UFNC003.pas:684-689 (TfrmFNC003.btnSalvarClick)
Diretório de Destino do Arquivo de Retornosempre, ao salvarsource/FNC003/UFNC003.pas:619-624 (TfrmFNC003.btnSalvarClick)
Diretório de Destino do Arquivo de Remessaquando o botão de seleção de diretório de remessa está habilitadosource/FNC003/UFNC003.pas:626-631 (TfrmFNC003.btnSalvarClick)
Histórico de Tarifas, Sequência de Boletos, Banco/Agência/Conta de Repassequando Integração com API = 'PJBank' (e Tipo Conta Crédito = Repasse, para dados bancários)source/FNC003/UdmFNC003.pas:1029-1049 (TdmFNC003.tabBOLETOBeforePost)
Carteira Pixquando Integração com API = 'PIX'source/FNC003/UdmFNC003.pas:1051-1061 (TdmFNC003.tabBOLETOBeforePost)
Histórico da Taxa de Boletoquando Valor da Taxa de Boleto > 0source/FNC003/UdmFNC003.pas:1078-1082 (TdmFNC003.tabBOLETOBeforePost)
Histórico e Tipo de Conta de Desconto Automático, Histórico e Tipo de Conta de Custo Recompraquando Tipo Remessa = 'Vendor' e Banco = Banco do Brasil ou Itaúsource/FNC003/UdmFNC003.pas:999-1023 (TdmFNC003.tabBOLETOBeforePost)
Client ID e Senha (challenge) do certificado Itaúao gerar CSR na tela de gerenciamento de certificado Itaúsource/FNC003/Utilitarios/uITAUConfig.pas:356-381 (SemMetacaractere)

Mensagens: causa e ação​

C-0045​

Causa: usuário clicou no botão Excluir com um parâmetro de boleto selecionado

Ação: confirmar para prosseguir com a exclusão (sujeita a checagem de movimentações vinculadas)

Fonte: source/FNC003/UFNC003.pas:582-584 (TfrmFNC003.btnExcluirClick)

C-0048​

Causa: usuário está fechando a tela com um registro em inclusão/edição não salvo

Ação: confirmar para salvar automaticamente antes de fechar, ou cancelar para descartar

Fonte: source/FNC003/UFNC003.pas:507-511 (TfrmFNC003.FormClose)

I-0046​

Causa: exclusão do parâmetro de boleto concluída

Ação: nenhuma ação necessária, apenas confirmação de sucesso

Fonte: source/FNC003/UFNC003.pas:595-601 (TfrmFNC003.btnExcluirClick)

I-0047​

Causa: gravação do parâmetro de boleto concluída com sucesso

Ação: nenhuma ação necessária, apenas confirmação de sucesso

Fonte: source/FNC003/UFNC003.pas:760-771 (TfrmFNC003.btnSalvarClick)

W-0457​

Causa: usuário clicou no atalho para o cadastro de Pessoas (Titular) mas não tem o programa TFA001 liberado no menu

Ação: solicitar ao administrador a liberação de acesso ao cadastro de Pessoas [TFA001]

Fonte: source/FNC003/UFNC003.pas:1298-1300 (TfrmFNC003.BitBtn3Click)

W-1665​

Causa: usuário clicou no atalho para Bancos e Agências mas não tem o programa TFC004 liberado no menu

Ação: solicitar ao administrador a liberação de acesso ao Cadastro de Bancos e Agências [TFC004]

Fonte: source/FNC003/UFNC003.pas:1247-1249 (TfrmFNC003.btnBancoClick)

W-1667​

Causa: usuário clicou no atalho para Formas de Pagamento mas não tem o programa TFC001 liberado no menu

Ação: solicitar ao administrador a liberação de acesso ao Cadastro de Formas de Pagamento [TFC001]

Fonte: source/FNC003/UFNC003.pas:1281-1283 (TfrmFNC003.BitBtn2Click)

Esta Forma de Pagamento já está Cadastrada para o Banco e Agência atual!​

Causa: já existe outro parâmetro de boleto ativo com o mesmo banco, agência e forma de pagamento para a empresa

Ação: usar/editar o parâmetro já existente ou escolher outra forma de pagamento

Fonte: source/FNC003/UdmFNC003.pas:389-396 (TdmFNC003.tabBOLETOCD_FORMAPAGTOValidate)

A Forma de Pagamento não está Cadastrada [TFC001]!​

Causa: código de forma de pagamento digitado não existe no cadastro

Ação: cadastrar a forma de pagamento em Financeiro > Formas de Pagamento (TFC001) ou usar F9 para buscar um código válido

Fonte: source/FNC003/UdmFNC003.pas:398-402 (TdmFNC003.tabBOLETOCD_FORMAPAGTOValidate)

O Banco não está Cadastrado [TFC004]!​

Causa: código de banco digitado não existe no cadastro de Bancos e Agências

Ação: cadastrar o banco em TFC004 ou selecionar um código válido pela busca (F9)

Fonte: source/FNC003/UdmFNC003.pas:445-449 (TdmFNC003.tabBOLETOCD_BANCOValidate)

A Agência não está Cadastrada [TFC004]!​

Causa: código de agência digitado não existe para o banco informado

Ação: cadastrar a agência em TFC004 para esse banco ou selecionar pela busca (F9)

Fonte: source/FNC003/UdmFNC003.pas:535-540 (TdmFNC003.tabBOLETOCD_AGENCIAValidate)

A Sequência não está Cadastrada para a Empresa %s!​

Causa: o nome de sequência informado em Sequência do Boleto/Remessa não está cadastrado para a empresa indicada

Ação: cadastrar a sequência para a empresa ou corrigir o código da empresa da sequência (CD_EMPRSEQUENCIA)

Fonte: source/FNC003/UdmFNC003.pas:654-662 (TdmFNC003.tabBOLETONM_SEQBOLETOValidate)

A Impressora não está Cadastrada [ADM008]!​

Causa: código de impressora digitado não existe no cadastro

Ação: cadastrar a impressora em ADM008 ou buscar um código válido

Fonte: source/FNC003/UdmFNC003.pas:692-699 (TdmFNC003.tabBOLETOCD_IMPRESSORAValidate)

A Pessoa não está Cadastrada [TFA001]!​

Causa: código de pessoa informado em Titular ou Avalista não existe no cadastro de Pessoas

Ação: cadastrar a pessoa em TFA001 ou selecionar um código válido

Fonte: source/FNC003/UdmFNC003.pas:710-714 (TdmFNC003.tabBOLETOCD_TITULARValidate)

A Empresa não está Cadastrada [ADM002]!​

Causa: código informado em Empresa da Sequência não existe no cadastro de empresas

Ação: corrigir o código da empresa ou cadastrá-la em ADM002

Fonte: source/FNC003/UdmFNC003.pas:727-731 (TdmFNC003.tabBOLETOCD_EMPRSEQUENCIAValidate)

A Pessoa não está Cadastrada ou nao é do tipo Empresa. Verifique! [TFA001]​

Causa: o código informado em Empresa Matriz não corresponde a uma pessoa do tipo Empresa

Ação: cadastrar/ajustar a pessoa em TFA001 com Tipo de Pessoa igual a Empresa

Fonte: source/FNC003/UdmFNC003.pas:823-834 (TdmFNC003.tabBOLETOCD_EMPMATRIZValidate)

O Tipo Remessa Vendor só está disponível para o Banco do Brasil e Itaú. Verifique!​

Causa: usuário selecionou Tipo Remessa 'Vendor' com um banco diferente de Banco do Brasil ou Itaú

Ação: selecionar outro Tipo de Remessa ou trocar o Banco para 1 (BB) ou 341 (Itaú)

Fonte: source/FNC003/UdmFNC003.pas:918-922 (TdmFNC003.tabBOLETOTP_BOLETOValidate)

Os campos do quadro "Desconto Eletrônico Automático" devem ser preenchidos. Verifique!​

Causa: parâmetro do tipo remessa Vendor sem Histórico/Tipo de Conta de Desconto Automático preenchidos

Ação: preencher Histórico e Tipo de Conta de Desconto Automático na aba Informações Adicionais

Fonte: source/FNC003/UdmFNC003.pas:1005-1011 (TdmFNC003.tabBOLETOBeforePost)

Os campos do quadro "Custo Recompra [Vendor]" devem ser preenchidos. Verifique!​

Causa: parâmetro do tipo remessa Vendor sem Histórico/Tipo de Conta de Custo Recompra preenchidos

Ação: preencher Histórico e Tipo de Conta de Custo Recompra na aba Informações Adicionais

Fonte: source/FNC003/UdmFNC003.pas:1015-1021 (TdmFNC003.tabBOLETOBeforePost)

É obrigatório informar a Carteira Pix. Verifique!​

Causa: Integração com API definida como PIX sem a Carteira Pix preenchida

Ação: informar a Carteira Pix (o módulo Pix precisa estar contratado, senão o campo fica bloqueado em vermelho)

Fonte: source/FNC003/UdmFNC003.pas:1054-1058 (TdmFNC003.tabBOLETOBeforePost)

É obrigatório informar a Sequência dos Boletos para Integração com API. Verifique!​

Causa: Integração com API definida como PJBank sem Sequência de Boletos preenchida

Ação: informar a Sequência do Boleto na aba Informações Adicionais

Fonte: source/FNC003/UdmFNC003.pas:1047-1048 (TdmFNC003.tabBOLETOBeforePost)

É obrigatório informar o Banco, Agência e Conta de Repasse para Integração com API e Tipo Conta Crédito "Repasse". Verifique!​

Causa: Integração PJBank com Tipo Conta Crédito = Repasse, mas Banco/Agência/Conta de Repasse não preenchidos

Ação: preencher Banco, Agência e Conta de Repasse na aba Integração API

Fonte: source/FNC003/UdmFNC003.pas:1032-1041 (TdmFNC003.tabBOLETOBeforePost)

É obrigatório informar o Histórico de Tarifas para Integração com API. Verifique!​

Causa: Integração PJBank sem Histórico de Tarifas informado

Ação: informar o Histórico de Tarifas na aba Integração API

Fonte: source/FNC003/UdmFNC003.pas:1045-1046 (TdmFNC003.tabBOLETOBeforePost)

É obrigatório informar o Histórico para a Taxa de Boleto. Verifique!​

Causa: Valor da Taxa de Boleto maior que zero sem Histórico da Taxa de Boleto informado

Ação: informar o Histórico da Taxa de Boleto ou zerar o Valor da Taxa

Fonte: source/FNC003/UdmFNC003.pas:1080-1081 (TdmFNC003.tabBOLETOBeforePost)

Diretório de Destino do Arquivo de Retorno Inválido. Verifique!​

Causa: o caminho informado em Diretório de Retorno não existe no disco do servidor/estação

Ação: selecionar um diretório válido pelo botão de busca de diretório de retorno

Fonte: source/FNC003/UFNC003.pas:619-624 (TfrmFNC003.btnSalvarClick)

Diretório de Destino do Arquivo de Remessa Inválido. Verifique!​

Causa: o caminho informado em Diretório de Remessa não existe no disco, para um parâmetro que gera arquivo de remessa

Ação: selecionar um diretório válido pelo botão de busca de diretório de remessa

Fonte: source/FNC003/UFNC003.pas:626-630 (TfrmFNC003.btnSalvarClick)

É Obrigatório informar o Código do Banco! / da Agência! / da Forma de Pagamento!​

Causa: tentativa de salvar sem preencher um dos três campos-chave do parâmetro

Ação: preencher Banco, Agência e Forma de Pagamento antes de salvar

Fonte: source/FNC003/UFNC003.pas:662-682 (TfrmFNC003.btnSalvarClick)

Para Emissão do Tipo "Banco Emite" A Sequencia do Boleto Deve Ser Informada. Verifique!​

Causa: Tipo de Emissão definido como 'Banco Emite' sem Sequência do Boleto preenchida

Ação: informar a Sequência do Boleto na aba Informações Adicionais

Fonte: source/FNC003/UFNC003.pas:684-688 (TfrmFNC003.btnSalvarClick)

Já existem movimentações para o Parâmetro selecionado. Verifique[CFC001]!​

Causa: o parâmetro de boleto já tem lançamentos financeiros (CONTAS) vinculados

Ação: não é possível excluir; considere inativar o parâmetro em vez de excluí-lo

Fonte: source/FNC003/UFNC003.pas:585-593 (TfrmFNC003.btnExcluirClick)

Selecione a Conta de Boleto antes de gerenciar o certificado!​

Causa: usuário abriu 'Gerenciar Certificado' sem nenhum parâmetro de boleto carregado na tela

Ação: selecionar ou cadastrar um parâmetro de boleto antes de gerenciar o certificado Itaú

Fonte: source/FNC003/UFNC003.pas:1770-1773 (TfrmFNC003.btnGerenciarCertITAUClick)

É obrigatório informar o Client ID! / a Senha (challenge) do certificado! / o Client Secret!​

Causa: campos obrigatórios da credencial Itaú não preenchidos antes de gerar o CSR, enviar o CSR ou testar a conexão

Ação: preencher Client ID/Senha na aba Itaú (para gerar o CSR) ou Client Secret (para testar a conexão)

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:356-381 (SemMetacaractere), source/FNC003/Utilitarios/uITAUConfig.pas:1114-1124 (TfrmConfigITAU.btnItauTestarClick)

%s não pode conter "#" nem "$"! Corrija no Cadastro da Empresa [ADM001].​

Causa: a Razão Social, Cidade, Estado, E-mail ou Client ID contém '#' ou '$', caracteres que quebram o arquivo de configuração usado para gerar o CSR

Ação: corrigir o dado no Cadastro da Empresa (ADM001), removendo o caractere especial

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:343-352 (SemMetacaractere)

Não foi possível obter a Razão Social, a Cidade, o Estado e o E-mail da Empresa. Verifique o endereço, o município e o e-mail no Cadastro da Empresa [ADM001]!​

Causa: a empresa não tem endereço/município cadastrado, então a consulta que monta o CSR não retorna esses dados

Ação: completar o cadastro de endereço, município e e-mail da empresa em ADM001

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:364-373 (SemMetacaractere)

O openssl.exe não foi encontrado em %s. Verifique a instalação do sistema!​

Causa: o executável openssl.exe não está na pasta Utilitarios\DLLItau da instalação do ERP

Ação: verificar/reinstalar os arquivos utilitários do sistema (equipe de TI/suporte técnico)

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:721-727 (TfrmConfigITAU.btnItauGerarClick)

Já existe o arquivo %s. Sobrescrever APAGARÁ o certificado atual e gravará um novo. Confirma?​

Causa: já existe uma chave privada gerada anteriormente para essa credencial Itaú

Ação: confirmar apenas se o certificado atual pode ser descartado e substituído por um novo

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:740-744 (TfrmConfigITAU.btnItauGerarClick)

O arquivo informado não é um CSR válido!​

Causa: o arquivo apontado em Certificado não contém o cabeçalho 'BEGIN CERTIFICATE REQUEST' esperado de um CSR

Ação: gerar o CSR pelo botão 'Gerar' desta tela ou apontar para o arquivo .CSR correto

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:952-958 (TfrmConfigITAU.btnItauEnviarClick)

O Token temporário é de USO ÚNICO. Enviar o CSR de %s ao Itaú?​

Causa: confirmação antes de enviar o CSR usando o token temporário fornecido pelo Itaú, que só funciona uma vez

Ação: confirmar apenas quando o CSR e o token estiverem corretos; se recusado pelo banco, é necessário solicitar novo token

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:962-965 (TfrmConfigITAU.btnItauEnviarClick)

Certificado recebido e gravado! Salve a tela e teste a conexão no grupo 3.​

Causa: o Itaú aceitou o CSR e devolveu o certificado, que foi gravado no caminho configurado

Ação: salvar a tela FNC003 e, em seguida, usar o botão 'Testar' para validar a conexão mTLS

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:1073-1081 (TfrmConfigITAU.ProcessaRetornoCsrItau)

Certificado não encontrado: %s / Chave privada não encontrada: %s​

Causa: os campos de caminho do certificado (.CRT/PEM) ou da chave privada (.KEY) apontam para um arquivo inexistente

Ação: gerar o certificado (grupo 1) ou selecionar o arquivo correto pelos botões de certificado/chave na aba Itaú

Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:1126-1138 (TfrmConfigITAU.btnItauTestarClick)

Regras de negócio​

  • FNC003.R001 (ver regras/FNC003/FNC003.R001.md)
  • FNC003.R002 (ver regras/FNC003/FNC003.R002.md)
  • FNC003.R003 (ver regras/FNC003/FNC003.R003.md)
  • FNC003.R004 (ver regras/FNC003/FNC003.R004.md)
  • FNC003.R005 (ver regras/FNC003/FNC003.R005.md)
  • FNC003.R006 (ver regras/FNC003/FNC003.R006.md)
  • FNC003.R007 (ver regras/FNC003/FNC003.R007.md)
  • FNC003.R008 (ver regras/FNC003/FNC003.R008.md)
  • FNC003.R009 (ver regras/FNC003/FNC003.R009.md)
  • FNC003.R010 (ver regras/FNC003/FNC003.R010.md)
  • FNC003.R011 (ver regras/FNC003/FNC003.R011.md)
  • FNC003.R012 (ver regras/FNC003/FNC003.R012.md)
  • FNC003.R013 (ver regras/FNC003/FNC003.R013.md)
  • FNC003.R014 (ver regras/FNC003/FNC003.R014.md)
  • FNC003.R015 (ver regras/FNC003/FNC003.R015.md)
  • FNC003.R016 (ver regras/FNC003/FNC003.R016.md)
  • FNC003.R017 (ver regras/FNC003/FNC003.R017.md)
  • FNC003.R018 (ver regras/FNC003/FNC003.R018.md)
  • FNC003.R019 (ver regras/FNC003/FNC003.R019.md)
  • FNC003.R020 (ver regras/FNC003/FNC003.R020.md)
  • FNC003.R021 (ver regras/FNC003/FNC003.R021.md)
  • FNC003.R022 (ver regras/FNC003/FNC003.R022.md)
  • FNC003.R023 (ver regras/FNC003/FNC003.R023.md)
  • FNC003.R024 (ver regras/FNC003/FNC003.R024.md)
  • FNC003.R025 (ver regras/FNC003/FNC003.R025.md)

Perguntas frequentes​

P: Por que não consigo salvar o Parâmetro de Boleto, aparece 'É Obrigatório informar o Código do Banco/Agência/Forma de Pagamento'? R: Esses três campos são obrigatórios para qualquer parâmetro; preencha Banco, Agência e Forma de Pagamento antes de salvar. Fonte: source/FNC003/UFNC003.pas:662-682 (TfrmFNC003.btnSalvarClick)

P: Por que a tela avisa 'Esta Forma de Pagamento já está Cadastrada para o Banco e Agência atual'? R: Já existe um parâmetro para essa mesma combinação de banco, agência e forma de pagamento na empresa; edite o parâmetro existente em vez de criar outro. Fonte: source/FNC003/UdmFNC003.pas:389-396 (TdmFNC003.tabBOLETOCD_FORMAPAGTOValidate)

P: Por que o Tipo Remessa 'Vendor' não fica disponível para o meu banco? R: Vendor só é permitido para Banco do Brasil (código 1) e Itaú (código 341); escolha outro tipo de remessa ou o banco compatível. Fonte: source/FNC003/UdmFNC003.pas:918-922 (TdmFNC003.tabBOLETOTP_BOLETOValidate)

P: Por que preciso preencher Histórico de Tarifas, Sequência e dados de Repasse para ativar a integração PJBank? R: São campos obrigatórios da integração via API PJBank, checados no momento de salvar; sem eles o sistema não permite gravar o parâmetro com essa integração ativa. Fonte: source/FNC003/UdmFNC003.pas:1029-1049 (TdmFNC003.tabBOLETOBeforePost)

P: Por que o campo Carteira Pix aparece em vermelho e não deixa digitar? R: O sistema detectou que o módulo Financeiro-Pix não está contratado na licença da empresa; sem o módulo contratado o campo fica bloqueado e é limpo automaticamente ao salvar. Fonte: source/FNC003/UFNC003.pas:489-501 (iniciar), source/FNC003/UdmFNC003.pas:1054-1055 (TdmFNC003.tabBOLETOBeforePost)

P: Por que aparece um aviso sobre limite de licenças de cobrança por API? R: A quantidade de parâmetros de boleto ativos com integração ACBr excede o número de cobranças contratadas na licença; desative parâmetros não utilizados ou contrate mais cobranças. Fonte: source/FNC003/UdmFNC003.pas:1208-1240 (TdmFNC003.validaLicencas)

P: Não consigo excluir um parâmetro de boleto, aparece mensagem sobre movimentações. Por quê? R: Já existem lançamentos financeiros (contas) usando esse banco/agência/forma de pagamento; exclusão é bloqueada nesse caso, use inativação em vez de exclusão. Fonte: source/FNC003/UFNC003.pas:585-593 (TfrmFNC003.btnExcluirClick)

P: Como gero e envio o certificado digital do Itaú para a integração via API? R: Na aba Itaú, clique em 'Gerenciar Certificado': gere o CSR/chave (grupo 1), envie o CSR usando o token temporário do banco (grupo 2) e depois teste a conexão (grupo 3), na tela auxiliar de gerenciamento. Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:3-24

P: Por que o botão 'Gerenciar Certificado' do Itaú não abre? R: É preciso ter um parâmetro de boleto selecionado/cadastrado na tela antes; sem registro carregado o sistema bloqueia a abertura. Fonte: source/FNC003/UFNC003.pas:1770-1773 (TfrmFNC003.btnGerenciarCertITAUClick)

P: Deu erro de diretório ao salvar o Parâmetro de Boleto. O que fazer? R: Selecione, pelos botões de busca de diretório da aba Informações Adicionais, um caminho de Remessa e de Retorno que realmente exista no computador/servidor. Fonte: source/FNC003/UFNC003.pas:619-631 (TfrmFNC003.btnSalvarClick)

P: Por que ao clicar nos botões de Banco/Forma de Pagamento/Pessoa não abre a outra tela? R: O usuário logado não tem permissão de acesso ao programa de destino (TFC004, TFC001 ou TFA001) liberado no menu; peça ao administrador para conceder o acesso. Fonte: source/FNC003/UFNC003.pas:1242-1307 (TfrmFNC003.btnBancoClick)

P: Deu 'não pode conter # nem $' ao gerar o certificado do Itaú. O que corrigir? R: Algum dado do cadastro da empresa (razão social, cidade, estado ou e-mail) contém '#' ou '$'; corrija esse dado no Cadastro da Empresa (ADM001) e gere o certificado novamente. Fonte: source/FNC003/Utilitarios/uITAUConfig.pas:343-352 (SemMetacaractere)

Dúvidas em aberto (o código não responde)​

  • O que controla exatamente se o botão 'Diretório de Remessa' (btnDiretorio) fica Enabled=True/False, condição usada em btnSalvarClick para exigir o diretório de remessa? — Em UFNC003.pas:626 a validação do diretório de remessa só dispara quando btnDiretorio.Enabled=True, mas o código que lê os eventos do módulo não mostra onde esse Enabled é alterado em tempo de execução (pode estar apenas no .dfm ou em outro trecho não coberto pelas linhas lidas).
  • Quais campos exatamente são obrigatórios/validados em cada uma das abas específicas de banco dentro de Integração API > ACBr (BB, Bradesco, Sicredi, Sicoob, Santander, Caixa, Inter, Safra, C6, Cresol, Banrisul, BTG)? — O código lido só mostra qual aba fica visível conforme o banco (Habilita_CamposAPI em UdmFNC003.pas:259-366) e os botões de seleção de arquivo de certificado (PEM/KEY) por banco em UFNC003.pas, mas não há validação de negócio própria para esses campos nos arquivos do módulo lidos — pode existir em unit externa (ex.: ACBrBoletoWS) não incluída no escopo desta análise.
  • Qual o significado de negócio de cada valor de Tipo Layout (TP_LAYOUT) e Convênio/Carteira por banco, já que são apenas campos texto sem validação própria no módulo? — Carteira (CD_CARTEIRA), Convênio (CD_CONVENIO) e Layout (TP_LAYOUT) não têm rotina de validação própria em UdmFNC003.pas; o código só reage a valores específicos de TP_LAYOUT ('0'/'1') para mostrar/esconder campos, sem documentar o significado de cada código.