Tutoriais/Financeiro/CadastroContasPIX: mudanças entre as edições

Edição atual tal como às 01h48min de 12 de dezembro de 2025

A rotina de Configuração de PIX é utilizada para habilitar o recebimento de valores via Pix através do sistema. Nesta tela, você vincula sua Chave Pix à conta bancária e, quando necessário, configura as credenciais de integração automática (API) com o banco.

PRÉ-REQUISITO

Antes de iniciar, certifique-se de ter selecionado a Conta Bancária correta na tela de pesquisa anterior.

1. Dados Principais

Nesta etapa, definem-se as características da chave e o modo de operação.

Campo / Parâmetro	Função e Instruções
Chave Pix	Informe a chave exatamente como cadastrada no banco (CPF, CNPJ, Celular, E-mail ou Chave Aleatória).
Tipo de Chave	Selecione o tipo correspondente à chave informada.
Tipo Pix	Define como o sistema irá gerar os QR Codes: Estático: Gera um código fixo e simples. Não realiza baixa automática e não exige credenciais de API. Dinâmico: Integração direta com o banco. Gera um QR Code único para cada venda, permite consulta de status e baixa automática do financeiro.

1.1. Credenciais para Pix Dinâmico

Caso selecione o tipo Dinâmico, campos adicionais serão exibidos conforme o banco selecionado. Estas informações são fornecidas pelo gerente da conta ou pelo portal de desenvolvedores do banco.

Campo / Parâmetro	Função e Instruções
Client ID	Identificador da aplicação.
Client Secret	Senha da aplicação ou Token de Produção.
Developer Key	Chave de desenvolvedor (Exclusivo para alguns bancos, como Banco do Brasil).
Certificado / Chave Privada	Locais para selecionar os arquivos de autenticação digital (extensões .pem, .key, .cer ou .pfx) salvos no computador.
Token Temporário	(Exclusivo Itaú) Campo utilizado para colar o código temporário gerado no site do banco, necessário para solicitar o certificado definitivo via sistema.

2. Gerenciamento de Arquivos e Certificados

Para bancos que exigem certificados digitais específicos para API (como Sicredi, Sicoob ou Itaú), utilize os botões auxiliares disponíveis na tela:

Exportar Arquivos: Salva uma cópia dos arquivos de certificado e chave privada gerados pelo sistema em uma pasta local. Utilize esta função para fazer backup ou caso precise enviar os arquivos manualmente para o banco.
Solicitar Certificado: (Específico para Itaú) Realiza a troca do Token Temporário pelas credenciais definitivas de produção.

SEGURANÇA

Os arquivos de Chave Privada garantem a segurança das transações. Mantenha-os em local seguro e nunca os compartilhe com pessoas não autorizadas.

3. Taxas e Contabilidade

Configure os custos operacionais e a integração contábil na aba Taxas.

Campo / Parâmetro	Função e Instruções
Taxa (%)	Percentual cobrado pelo banco sobre cada recebimento Pix.
Conta Contábil da Taxa	Conta de despesa (Plano de Contas) onde será lançado o valor da tarifa bancária automaticamente. Obrigatório se a empresa utiliza integração contábil e houve preenchimento de taxa percentual.

4. Diagnóstico e Testes

Para garantir que a configuração está correta antes de iniciar as vendas, utilize o botão Mais Opções (Disponível no modo Dinâmico):

Testar Certificado: Valida se o arquivo de certificado selecionado está legível e dentro da validade.
Testar Chave Privada: Verifica a integridade do arquivo de chave.
Homologação: O sistema tenta criar uma cobrança de teste (geralmente de valor simbólico) no ambiente de homologação do banco para confirmar se as credenciais estão funcionando.

@@ Linha 1: / Linha 1: @@
 {{Cabecalho
-  | [[Financeiro]] > [[Cadastros]]
+  | [[Tutoriais]]
-  | Configuração de PIX
+  | Cadastros de Contas PIX [FIT086]
 }}
 A rotina de '''Configuração de PIX''' é utilizada para habilitar o recebimento de valores via Pix através do sistema. Nesta tela, você vincula sua Chave Pix à conta bancária e, quando necessário, configura as credenciais de integração automática (API) com o banco.
-{{Nota|warning|PRÉ-REQUISITO|Antes de iniciar, certifique-se de ter selecionado a [[{{Cabecalho
+{{Nota|warning|PRÉ-REQUISITO|Antes de iniciar, certifique-se de ter selecionado a [[Financeiro/CadastroContasBancarias|Conta Bancária]] correta na tela de pesquisa anterior.}}
- | [[Tutoriais]]
- | Cadastro de Conta Boleto [FIT068]
-}}
-A rotina de '''Cadastro de Conta Boleto''' define as regras de negócio para a emissão de títulos bancários. É neste cadastro que se configura a carteira de cobrança, as instruções de juros e multa, e o vínculo com a contabilidade.
-{{Nota|warning|PRÉ-REQUISITO|Para cadastrar uma Conta Boleto, é obrigatório já ter cadastrado a [[Tutoriais/Financeiro/CadastroContasBancarias|Conta Bancária]] correspondente.}}
-== 1. Dados Principais ==
-Preencha as informações básicas para identificar a regra de cobrança.
-{{TabelaCampos|
-  {{Linha
-   | 1= Descrição
-   | 2= Nome para identificar esta configuração (Ex: "Bradesco - Carteira 09").
-  }}
-  {{Linha
-   | 1= Conta Bancária
-   | 2= Selecione a conta corrente vinculada a esta cobrança.
-* Ao selecionar, o sistema preenche automaticamente o Banco.
-  }}
-  {{Linha
-   | 1= Tipo de Cobrança
-   | 2= Define o modelo de envio:
-* '''Com Registro:''' O banco precisa ser notificado da emissão (arquivo remessa ou API). Habilita opções de protesto.
-* '''Sem Registro:''' Modelo simplificado (em desuso pela maioria dos bancos).
-  }}
-  {{Linha
-   | 1= Emissão / Postagem
-   | 2= Define quem será responsável por imprimir e enviar o boleto (Pelo Cedente ou Pelo Banco).
-  }}
-}}
-== 2. Configurações Financeiras e Contábeis ==
-Defina os encargos e a integração contábil.
-{{TabelaCampos|
-  {{Linha
-   | 1= Percentuais (Juros/Multa)
-   | 2= Defina os percentuais cobrados por atraso.
-  }}
-  {{Linha
-   | 1= Contas Contábeis
-   | 2= Informe as contas do plano de contas para integração automática:
-* '''Multa / Juros:''' Receitas financeiras.
-* '''Descontos:''' Deduções.
-* '''Valor Título:''' Ativo/Banco ou conta transitória.
-* '''Tarifas:''' Despesas bancárias.
-  }}
-}}
-== 3. Dados do Beneficiário ==
-Nesta etapa, o sistema puxa os dados da empresa.
-{{Nota|danger|VALIDAÇÃO|O sistema valida rigorosamente os dados do beneficiário. Certifique-se de que o '''Endereço, CEP, Cidade e CNPJ''' estejam preenchidos corretamente, caso contrário o banco rejeitará o registro do boleto.}}
-== 4. Configuração da Carteira ==
-Para definir os dados técnicos fornecidos pelo banco (Carteira, Convênio, Código do Cedente), clique no botão '''Configurar'''.
-#: {{Print|Financeiro_Boleto_Configurar_Carteira.png|Tela de configuração de parâmetros bancários}}
-Preencha os campos conforme o manual do seu banco.
-== 5. Boleto Híbrido / Online ==
-Caso utilize emissão via API (Boleto Híbrido com QR Code Pix), é necessário configurar as credenciais.
-* [[Financeiro/CadastroBoleto/API|Clique aqui para ver o manual de Configuração de API/Credenciais]].
-{{ContatoSuporte}}
-|Conta Bancária]] correta na tela de pesquisa anterior.}}
 == 1. Dados Principais ==