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

Edição das 01h44min 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
-  | [[Tutoriais]]
+  | [[Financeiro]] > [[Cadastros]]
-  | Cadastro de Conta Boleto [FIT068]
+  | Configuração de PIX
 }}
-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.
+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|Para cadastrar uma Conta Boleto, é obrigatório já ter cadastrado a [[Tutoriais/Financeiro/CadastroContasBancarias|Conta Bancária]] correspondente.}}
+{{Nota|warning|PRÉ-REQUISITO|Antes de iniciar, certifique-se de ter selecionado a [[Financeiro/CadastroContasBancarias|Conta Bancária]] correta na tela de pesquisa anterior.}}
 == 1. Dados Principais ==
-Preencha as informações básicas para identificar a regra de cobrança.
+Nesta etapa, definem-se as características da chave e o modo de operação.
 {{TabelaCampos|
    {{Linha
-    | 1= Descrição
+    | 1= Chave Pix
-    | 2= Nome para identificar esta configuração (Ex: "Bradesco - Carteira 09").
+    | 2= Informe a chave exatamente como cadastrada no banco (CPF, CNPJ, Celular, E-mail ou Chave Aleatória).
    }}
    {{Linha
-    | 1= Conta Bancária
+    | 1= Tipo de Chave
-    | 2= Selecione a conta corrente vinculada a esta cobrança.
+    | 2= Selecione o tipo correspondente à chave informada.
-* Ao selecionar, o sistema preenche automaticamente o Banco.
    }}
    {{Linha
-    | 1= Tipo de Cobrança
+    | 1= Tipo Pix
-    | 2= Define o modelo de envio:
+    | 2= Define como o sistema irá gerar os QR Codes:
-* '''Com Registro:''' O banco precisa ser notificado da emissão (arquivo remessa ou API). Habilita opções de protesto.
+* '''Estático:''' Gera um código fixo e simples. Não realiza baixa automática e não exige credenciais de API.
-* '''Sem Registro:''' Modelo simplificado (em desuso pela maioria dos bancos).
+* '''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.
-  }}
-  {{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 ==
+=== 1.1. Credenciais para Pix Dinâmico ===
-Defina os encargos e a integração contábil.
+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.
 {{TabelaCampos|
    {{Linha
-    | 1= Percentuais (Juros/Multa)
+    | 1= Client ID
-    | 2= Defina os percentuais cobrados por atraso.
+   | 2= Identificador da aplicação.
+  }}
+  {{Linha
+   | 1= Client Secret
+   | 2= Senha da aplicação ou Token de Produção.
+  }}
+  {{Linha
+   | 1= Developer Key
+   | 2= Chave de desenvolvedor (Exclusivo para alguns bancos, como Banco do Brasil).
+  }}
+  {{Linha
+   | 1= Certificado / Chave Privada
+    | 2= Locais para selecionar os arquivos de autenticação digital (extensões .pem, .key, .cer ou .pfx) salvos no computador.
    }}
    {{Linha
-    | 1= Contas Contábeis
+    | 1= Token Temporário
-    | 2= Informe as contas do plano de contas para integração automática:
+    | 2= (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.
-* '''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 ==
+== 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.
-Nesta etapa, o sistema puxa os dados da empresa.
+{{Nota|danger|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.}}
-{{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 ==
+== 3. Taxas e Contabilidade ==
-Para definir os dados técnicos fornecidos pelo banco (Carteira, Convênio, Código do Cedente), clique no botão '''Configurar'''.
+Configure os custos operacionais e a integração contábil na aba '''Taxas'''.
-#: {{Print|Financeiro_Boleto_Configurar_Carteira.png|Tela de configuração de parâmetros bancários}}
+{{TabelaCampos|
+  {{Linha
+   | 1= Taxa (%)
+   | 2= Percentual cobrado pelo banco sobre cada recebimento Pix.
+  }}
+  {{Linha
+   | 1= Conta Contábil da Taxa
+   | 2= 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.
+  }}
+}}
-Preencha os campos conforme o manual do seu banco.
+== 4. Diagnóstico e Testes ==
-== 5. Boleto Híbrido / Online ==
+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):
-Caso utilize emissão via API (Boleto Híbrido com QR Code Pix), é necessário configurar as credenciais.
+* '''Testar Certificado:''' Valida se o arquivo de certificado selecionado está legível e dentro da validade.
-* [[Financeiro/CadastroBoleto/API|Clique aqui para ver o manual de Configuração de API/Credenciais]].
+* '''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.
 {{ContatoSuporte}}