Tutoriais/Financeiro/CadastroContasPIX - Histórico de revisão

Raul em 01h48min de 12 de dezembro de 2025

2025-12-12T01:48:36Z

← Edição anterior		Edição das 01h48min de 12 de dezembro de 2025
Linha 1:		Linha 1:
	{{Cabecalho		{{Cabecalho
	\| [[Tutoriais]]		\| [[Tutoriais]]
	\| ~~Configuração~~ de PIX		\| Cadastros de Contas PIX [FIT086]
	}}		}}

Raul em 01h46min de 12 de dezembro de 2025

2025-12-12T01:46:55Z

← Edição anterior		Edição das 01h46min de 12 de dezembro de 2025
Linha 1:		Linha 1:
	{{Cabecalho		{{Cabecalho
	\| [[~~Financeiro]] > [[Cadastros~~]]		\| [[Tutoriais]]
	\| Configuração de PIX		\| Configuração de PIX
	}}		}}

Raul em 01h44min de 12 de dezembro de 2025

2025-12-12T01:44:24Z

Mostrar alterações

Raul em 01h44min de 12 de dezembro de 2025

2025-12-12T01:44:18Z

@@ Linha 1: / Linha 1: @@
 {{Cabecalho
   | [[Tutoriais]]
   | Cadastro de Conta Boleto [FIT068]
@@ Linha 77: / Linha 70: @@
 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}}

Raul em 01h43min de 12 de dezembro de 2025

2025-12-12T01:43:17Z

@@ Linha 6: / Linha 6: @@
 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 [[Financeiro/CadastroContasBancarias|Conta Bancária]] correta na tela de pesquisa anterior.}}
+{{Nota|warning|PRÉ-REQUISITO|Antes de iniciar, certifique-se de ter selecionado a [[{{Cabecalho
 == 1. Dados Principais ==

Raul: Criou página com '{{Cabecalho | Financeiro > Cadastros | Configuração de PIX }} 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 Financeiro/CadastroContasBancarias|Con...'

2025-12-12T01:42:32Z

Criou página com '{{Cabecalho | Financeiro > Cadastros | Configuração de PIX }} 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 Financeiro/CadastroContasBancarias|Con...'

Página nova

{{Cabecalho
| [[Financeiro]] > [[Cadastros]]
| Configuração de PIX
}}

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 [[Financeiro/CadastroContasBancarias|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.

{{TabelaCampos|
{{Linha
| 1= Chave Pix
| 2= Informe a chave exatamente como cadastrada no banco (CPF, CNPJ, Celular, E-mail ou Chave Aleatória).
}}
{{Linha
| 1= Tipo de Chave
| 2= Selecione o tipo correspondente à chave informada.
}}
{{Linha
| 1= Tipo Pix
| 2= 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.

{{TabelaCampos|
{{Linha
| 1= Client ID
| 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= Token Temporário
| 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.
}}
}}

== 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.

{{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.}}

== 3. Taxas e Contabilidade ==

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

{{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.
}}
}}

== 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.

{{ContatoSuporte}}