Emissão Automática de Boletos - API - Histórico de revisão

Gabriel em 18h07min de 21 de outubro de 2024

2024-10-21T18:07:24Z

← Edição anterior		Edição das 15h07min de 21 de outubro de 2024
Linha 120:		Linha 120:

	Cadastrar o boleto e vincular o portador para a empresa.		Cadastrar o boleto e vincular o portador para a empresa.

			'''PRONTO! Agora realize o teste de emitir o boleto, verificar se registrou e efetuar o pagamento.'''

Gabriel em 18h06min de 21 de outubro de 2024

2024-10-21T18:06:05Z

← Edição anterior		Edição das 15h06min de 21 de outubro de 2024
Linha 1:		Linha 1:
	O que é necessário saber antes de configurar ?		O que é necessário saber antes de configurar ?

	# Contratar o ~~plano~~ de acordo com a quantidade de boletos mensal.		# Contratar o pacote de emissão boleto API da POST Sistemas, de acordo com a quantidade de boletos mensal.
	# Solicitar ao banco a emissão de boletos pela API. Pode haver interpretações por parte do banco, explique que é para emitir o boleto usando a API e não o arquivo de remessa.		# Solicitar ao banco a emissão de boletos pela API. Pode haver interpretações por parte do banco, explique que é para emitir o boleto usando a API e não o arquivo de remessa.
			<blockquote>Este serviço deve ser contratado junto ao banco. Se desejar emitir com PIX, solicite essa opção.</blockquote>Importante estar atento para não afetar o que o cliente já tenha contratado.
	~~Deve~~ ser ~~realizado a contratação do serviço~~ junto ao banco. ~~Inclusive~~ com a opção ~~de emitir o PIX com o boleto~~.

	Importante estar atento para não afetar o que o cliente já tenha contratado.

	=== Como configurar no sistema ===		=== Como configurar no sistema ===

Gabriel em 18h01min de 21 de outubro de 2024

2024-10-21T18:01:07Z

← Edição anterior		Edição das 15h01min de 21 de outubro de 2024
Linha 1:		Linha 1:
	~~Banco~~		O que é necessário saber antes de configurar ?

	Solicitar ao banco ~~para habilitar~~ a emissão de boletos pela API.		# Contratar o plano de acordo com a quantidade de boletos mensal.
			# Solicitar ao banco a emissão de boletos pela API. Pode haver interpretações por parte do banco, explique que é para emitir o boleto usando a API e não o arquivo de remessa.

			Deve ser realizado a contratação do serviço junto ao banco. Inclusive com a opção de emitir o PIX com o boleto.

			Importante estar atento para não afetar o que o cliente já tenha contratado.

	Como configurar no sistema		=== Como configurar no sistema ===

	Passo a passo de como configurar a emissão de boletos pela API, no sistema.		Passo a passo de como configurar a emissão de boletos pela API, no sistema.

	As instruções a seguir têm como objetivo orientar a configuração da emissão, abordando os requisitos técnicos necessários. Este guia não fornecerá explicações sobre como acessar as configurações nem sobre conceitos como portador e conta. É importante ter um bom entendimento do processo para evitar possíveis problemas.		As instruções a seguir têm como objetivo orientar a configuração da emissão, abordando os requisitos técnicos necessários. Este guia não fornecerá explicações sobre como acessar as configurações nem sobre conceitos como portador e conta. É importante ter um bom entendimento do processo para evitar possíveis problemas.

	Portador		==== Portador ====

	Cadastrar um novo portador no contas a receber.		Cadastrar um novo portador no contas a receber.

Linha 19:		Linha 20:
	Ind.Cob.Banco: Escolher o banco.		Ind.Cob.Banco: Escolher o banco.

			==== Configurações ====
	Configurações
	~~# Cod.Módulo 1005 - Projeto Bco~~

	~~Chave Tipo Boleto: Escolher o formato que será impresso.~~

	~~Chave ID Portador Boletos: Escolher o portador (padrão) de emissão, manter "0" e configurar com a origem do portador criado. OU, avaliar e manter somente no padrão caso seja único.~~

	~~Chave Versão: Alterar para 1 - Modelo Novo.~~
	{\| class="wikitable"		{\| class="wikitable"
	\|+		\|+Cod.Módulo 1005 - Projeto Bco
	!Chave		!Chave
	!Valor		!Valor
Linha 47:		Linha 40:
	\|}		\|}

			==== Configuração ID.Origem do Portador ====
	Configuração ID.Origem do Portador

	Entrar na configuração com ID.Origem do portador (pode ser acessado pelas configurações no cadastro do portador).		Entrar na configuração com ID.Origem do portador (pode ser acessado pelas configurações no cadastro do portador).

	Considerar que cada banco tenha as suas configurações específicas.		Considerar que cada banco tenha as suas configurações específicas.

	===== SICREDI =====		=== SICREDI ===

	====== Grupo API ======		===== Grupo API =====
	Será necessário solicitar as credenciais para o banco.		Será necessário solicitar as credenciais para o banco.
	{\| class="wikitable"		{\| class="wikitable"
Linha 81:		Linha 72:
	\|}		\|}

	====== Grupo Banco ======		===== Grupo Banco =====
	Preencher conforme o cadastro do cliente com o banco e suas necessidades de emissão.		Preencher conforme o cadastro do cliente com o banco e suas necessidades de emissão.

	====== Grupo Geral ======		===== Grupo Geral =====
	Essas são as configurações padrões, podem haver mais chaves no sistema de situações específicas.		Essas são as configurações padrões, podem haver mais chaves no sistema de situações específicas.
	{\| class="wikitable"		{\| class="wikitable"
Linha 93:		Linha 84:
	\|-		\|-
	\|Tipo de Envio		\|Tipo de Envio
	\|API		\|0 - API
	\|		\|
	\|-		\|-
Linha 103:		Linha 94:
	\|0 - Normal: somente boleto		\|0 - Normal: somente boleto
	1 - Híbrido: boleto e pix.		1 - Híbrido: boleto e pix.
	\|~~verificar~~ no contrato cliente/banco.		\|Verificar no contrato cliente/banco.
	\|-		\|-
	\|IDEmpresa		\|IDEmpresa
Linha 126:		Linha 117:
	\|}		\|}

	====== Tipo de pagamento ======		===== Tipo de pagamento =====
	Cadastrar Ind.Boleto API no cadastro de Tipo de pagamento.		Cadastrar Ind.Boleto API no cadastro de Tipo de pagamento.

Gabriel em 17h46min de 21 de outubro de 2024

2024-10-21T17:46:48Z

Mostrar alterações

Gabriel: Criou página com 'Banco Solicitar ao banco para habilitar a emissão de boletos pela API. Como configurar no sistema Passo a passo de como configurar no sistema. ***Ver para habilitar o ID.Origem # Cod.Módulo 1005 - Projeto Bco Chave Tipo Boleto: Escolher o formato que será impresso. Chave ID Portador Boletos: Escolher o portador de emissão. Chave Versão: Alterar para 1 - Modelo Novo. Portador Cadastrar um portador novo no contas a receber. Ind.Tipo de...'

2024-10-18T17:32:05Z

Criou página com 'Banco Solicitar ao banco para habilitar a emissão de boletos pela API. Como configurar no sistema Passo a passo de como configurar no sistema. <nowiki>***</nowiki>Ver para habilitar o ID.Origem # Cod.Módulo 1005 - Projeto Bco Chave Tipo Boleto: Escolher o formato que será impresso. Chave ID Portador Boletos: Escolher o portador de emissão. Chave Versão: Alterar para 1 - Modelo Novo. Portador Cadastrar um portador novo no contas a receber. Ind.Tipo de...'

Página nova

Banco

Solicitar ao banco para habilitar a emissão de boletos pela API.

Como configurar no sistema

Passo a passo de como configurar no sistema.

<nowiki>***</nowiki>Ver para habilitar o ID.Origem

# Cod.Módulo 1005 - Projeto Bco

Chave Tipo Boleto: Escolher o formato que será impresso.

Chave ID Portador Boletos: Escolher o portador de emissão.

Chave Versão: Alterar para 1 - Modelo Novo.

Portador

Cadastrar um portador novo no contas a receber.

Ind.Tipo deve ser 2 - Banco.

Ind.Cob.Banco: Escolher a instituição bancária.

ID.Conta: Escolher a conta do banco no plano de contas.

Gravar

Entrar na configuração do portador que vai habilitar após estar gravado para abrir a tela de configurações da parametrização.

Configuração Portador API

Consiste em 3 grupos, API, Banco e Geral.

API

Será necessário ter as credenciais do banco.

Ambiente: 1 - Produção

Usuário: Fornecido pelo banco.

Senha: Fornecido pelo banco ou internet banking.

X-API-KEY: Access token gerado pelo portal do desenvolvedor.

Banco

Nesse grupo é necessário preencher conforme o cadastro do cliente com o banco e suas predefinições.

Geral

Tipo de Envio: API

Tipo de Registro: 0 - Obrigar registro.

Tipo de Cobrança:

0 - Normal: somente boleto

1 - Híbrido: boleto e pix.

IDEmpresa: Define a empresa responsável pelo boleto.

Gerar Dados: Opção que o sistema irá gerar para o boleto. Habilitar ambos.

Prefixo: Valor fixo na máscara do boleto. É necessário verificar os boletos já emitidos e sua máscara para evitar duplicidade. Colocar um número de 3 até 9.

Sequencial: sequencia dos boletos.

Data Consulta: armazena a data do dia anterior para o uso do retorno.

Emitente Razão: Razão do emitente fixo para impressão dos boletos. Vai substituir a razão, na impressão, configurado no boleto.

CNPJ do emitente fixo para impressão dos boletos. Vai substituir o CNPJ, na impressão, configurado no boleto.

Emitente endereço 1: Parte do endereço fixo para a emissão do boleto. Formato de exemplo:

"Título logradouro" "Logradouro", "número" - "complemento"

Emitente endereço 2: Parte do endereço fixo para a emissão do boleto. Formato de exemplo:

"Bairro" - "Cidade"/"UF" - CEP:"CEP"

Fechar e abrir o sistema para carregar as novas configurações.

Cadastrar Ind.Boleto API no cadastro de Tipo de pagamento.

Clicar em "Empresas" para abrir o cadastro de tipo de pagamento por empresa.

Cadastrar o boleto e vincular o portador para a empresa.