CIGAM WIKI - Contribuições do usuário [pt-br]

GF - Como Fazer - Open Banking para Banco do Brasil

2022-07-22T16:24:41Z

Claudia.Felles: /* Quais os Módulos necessários para utilizar a Funcionalidade Open Banking do Banco do Brasil”? */

[[categoria:Como_Fazer_Finanças]]

=='''O que significa Open Banking?'''==

Open Banking é um conceito relativamente novo na realidade do mercado financeiro brasileiro. Porém, ele tem ganhado cada vez mais atenção em todo o mundo.
Traduzido, o termo significa “banco aberto”, mas uma tradução mais precisa seria “sistema financeiro aberto”.
O conceito em si trata de algo de simples compreensão. Basicamente, Open Banking é a defesa de que o sistema financeiro adote a tecnologia de forma mais ampla e padronizada, como forma de incentivar e ampliar a oferta e a qualidade dos produtos e serviços financeiros.
A base do Open Banking está na premissa de que os dados pertencem aos consumidores. Logo, caso eles autorizem, esses dados devem ser disponibilizados para que eles possam ter acesso a produtos e serviços que forem mais convenientes.
Na prática, há um pedido para que as instituições abram suas API’s (sigla em inglês para Interface de Programação de Aplicativos) para que terceiros desenvolvam e aprimorem os sistemas e suas funcionalidades.
O objetivo do Open Banking é desenvolver sistemas integrados, que facilitem o controle e transferência de informações de dados, histórico, contas, empréstimos etc. Todo o tipo de produto e serviço oferecido pelos bancos seria integrado de maneira a evitar processos complicados e dispendiosos.
À primeira vista, pode parecer que com o Open Banking as informações dos clientes ficarão soltas e desprotegidas. No entanto, os bancos e instituições financeiras ainda serão responsáveis pela proteção de dados sigilosos.

 

=='''Serviços Disponíveis pela API do Banco nesta Versão?'''==

'''Menu > Utilidades/Diversos > Genéricos > Parâmetros > Configurações'''
 
<center>
{| class="wikitable"
|-
! SERVIÇO !! COBRANÇA
|-
| Registro de Boleto via API || SIM
|-
| Open Banking PIX no Boleto || SIM
|-
| Retorno de Cobrança via API || SIM
|-
| Alteração de Juros via API || SIM
|-
| Alteração de Multa via API || SIM
|-
| Alteração de Vencimento via API || SIM
|-
| Alteração de Baixa via API || SIM
|-
| Retorno de Cobrança com Registro em Cartório via API || NÃO
|-
|}
</center>
 

=='''Como obter as Credenciais para utilizar a Funcionalidade Open Banking?'''==
 
As credenciais do Banco do Brasil devem ser obtidas através do acesso ao Portal Developers (pdf caminho citado).
 
'''I:\CIGAM\Implementa\Documentos\Apoio a implementação\Open Banking Manual Banco\02 Portal Developers - Credenciais de produção.pdf'''
 
Este acesso deve ser feito pelo '''responsável da conta corrente na empresa'''. No momento da geração das credenciais devem ser incluídos os “Escopos” (Funcionalidades da API) tais como Cobrança, Pagamento e PIX.
 
Qualquer geração de credenciais com um contexto diferente deste, seja porque a pessoa a gerar as credenciais '''não é o responsável da conta''' ou por algum dos serviços tenha ficado de fora do escopo, irá resultar em erro no momento do uso da API.
 
'''Ex: {"statusCode":403,"error":"Forbidden","message":"Application key is not allowed to call this resource method"};”'''
 

=='''Quais os Módulos necessários para utilizar a Funcionalidade Open Banking do Banco do Brasil?'''==

• Módulo Gestão Financeira;

=='''Quais são as parametrizações necessárias para utilizar a funcionalidade do Open Banking?'''==

Para utilizar esta funcionalidade é necessário possuir o Cadastro do Portador para o Banco do Brasil.
O cadastro quando preenchido corretamente garante que não ocorrerá inconsistências no momento do registro do Open Banking.
 
Como boa prática de implementação é mais coerente criar um novo Portador para Open Banking evitando assim de alterar o Portador utilizado para CNAB caso necessite realizar algum processo via remessa ou retorno, quando a API do Banco estiver com instabilidade.
 
Essa parametrização deverá validar os últimos Sequenciais da numeração de Boletos do Portador utilizado para as Remessas, pois assim garante que não ocorrerá conflito enviar uma numeração de Título já registrado.
 
 
'''Itens Importantes na Parametrização:'''
 
'''- Processar retornos pelo número do Boleto:''' esta opção deve estar marcada, pois caso contrário ocorrerá problemas na gravação das informações e envio para Banco.
 
Caso tenha sido realizado movimentações com esta opção desmarcada, não será possível realizar a Baixa, pois sistema não consegue localizar devido não possuir o '''Nosso Número''' gravado nas tabelas envolvidas.
 
Para solucionar essa questão será necessário:
 
'''1-''' Identificar o '''Nosso Número''' do registro a ser baixado (Lançamento Financeiro);
 
'''2-''' Gravar o '''Nosso Número''' nas seguintes tabelas:
 
'''GFBOLETOS:''' campo a ser atualizado '''NOSSO_NRO''' com a informação do Nosso Número.
 
'''GFLAUXIL:''' campo a ser atualizado '''CODIGO_BARRAS''' com a informação do Nosso Número.
 
- A variação da Carteira do Banco do Brasil;
 
- Quando se tratar do Portador Open Banking do BB, o campo "Identificação do serviço" deve ser em Branco.
 
Para o correto funcionamento da rotina é necessário que os dados do Portador esteja com todas informações necessárias, inclusive o '''Convênio'''.
 
'''Menu > Finanças > Gestão Financeira > Parâmetros > Portadores'''
 
Este cadastro é apenas uma demonstração de parametrização:
 
<center>'''Cadastro de Portador'''
[[Arquivo:Cadastro Portador OpenBanking.png|750x500px|semmoldura|nenhum|Cadastro_Portador_OpenBanking]]
 
Quando se tratar do Portador Open Banking do BB, o campo "Identificação do serviço" deve ser em Branco.
 
'''Conta:''' o preenchimento da Conta deve ser sem caracteres especiais, somente números.
 
 
'''Convênio:'''
 
"Cada Conta Corrente é um Convênio" - (7 posições).
"Uma Conta Corrente pode ter vários Convênios".
"Quando tenho mais de um Convênio, muda o Código do Convênio e a variação da Carteira conforme a tabela abaixo:"
Variação da Carteira (caso tenha mais de um Convênio):
 
'''019 (Código de 2 + DV)'''
 
'''027'''
 
'''035'''
 
'''043...'''
 
'''Carteira (Serviço):'''
 
'''011 -''' (Cobrança simples Boleto por correio)
 
'''031 -''' (Cobrança simples Vinculada)
 
'''017 -''' (Cobrança simples Imprime Boleto - considerado como Única)
 
'''051 -''' (Carteira Descontada), modalidade utilizada é 04.
 
Demais são considerados atributos.
 
'''Modalidades de Serviço do Banco do Brasil consideradas:'''
 
01 - Simples
 
04 - Vinculada (esta Modalidade esta atrelada somente a '''Carteira 051''', logo não deve ser utilizada para outras Carteiras)
 
'''Regra do Sistema para Banco do Brasil Open Banking:'''
 
'''Identificador do Serviço:''' as opções para este campo são:
 
'''01 -''' Simples
 
'''04 -''' Vinculado
 
Valores diferentes destes serão tratados = '''01 -''' Simples
 

 
'''Espécie:''' este campo para Open Banking é considerado para identificar o Tipo de Boleto de Cobrança. Quando este campo estiver em Branco o Sistema irá considerar sempre '''04 -''' DUPLICATA SERVICO.
 
'''01 -''' CHEQUE
 
'''02 -''' DUPLICATA MERCANTIL
 
'''03 -''' DUPLICATA MTIL POR INDICACAO
 
'''04 -''' DUPLICATA SERVICO
 
'''05 -''' DUPLICATA SRVC P/INDICAO
 
'''06 -''' DUPLICATA RURAL
 
'''07 -''' LETRA DE CAMBIO
 
'''08 -''' NOTA DE CRÉDITO COMERCIAL
 
'''9-''' NOTA DE CREDITO A EXPORTACAO
 
'''10-''' NOTA DE CREDITO INDULTRIAL
 
'''11-''' NOTA DE CREDITO RURAL
 
'''12-''' NOTA PROMISSORIA
 
'''13-''' NOTA PROMISSORIA RURAL
 
'''14-''' TRIPLICATA MERCANTIL
 
'''15-''' TRIPLICATA DE SERVICO
 
'''16-''' NOTA DE SEGURO
 
'''17-''' RECIBO
 
'''18-''' FATURA
 
'''19-''' NOTA DE DEBITO
 
'''20-''' APOLICE DE SEGURO
 
'''21-''' MENSALIDADE ESCOLAR
 
'''22-''' PARCELA DE CONSORCIO
 
'''23-''' DIVIDA ATIVA DA UNIAO
 
'''24-''' DIVIDA ATIVA DE ESTADO
 
'''25-''' DIVIDA ATIVA DE MUNICIPIO
 
'''31-''' CARTAO DE CREDITO
 
'''32-''' BOLETO PROPOSTA
 
'''33-''' BOLETO APORTE
 
'''99-''' OUTROS
 
<center>'''Guia CNAB'''
[[Arquivo:Portador_Guia_CNAB3.png|700x500px|semmoldura|nenhum|Portador_Guia_CNAB3]]
 
<center>'''Guia Configurações'''
[[Arquivo:Cadastro Portador Config.png|700x500px|semmoldura|nenhum|Cadastro_Portador_Config]]
 
 
'''Irá surgir a necessidade de realizar a alteração de Vencimento, Multa ou Juros do Lançamento Financeiro já registrado pelo Open Banking, qual é o passo a passo para proceder diante dessa modificação?'''
 
Regra Sistema para Vencimento, Multa ou Juros:
 
Cadastro do Portador deve possuir Comando de Remessa com as novas opções:
 
'''Tipo de Comando =''' Alteração de Vencimento (para alteração de Vencimento).
 
'''Tipo de Comando =''' Alteração de Multa para Multa (para alteração de Multa).
 
'''Tipo de Comando =''' Alteração de Juros para Juros (para alteração de Juros).
 
Caso não seja parametrizado neste primeiro momento as opções de Multa e Juros o sistema cria automaticamente (Somente Juros e Multa).
 
Ao acessar o Lançamento Financeiro em modo Modificar e alterar o campo Multa de ou Juros de, automaticamente após alteração da Multa, o Sistema irá criar essa parametrização do Comando de Remessa com sugestão, sendo passível de alteração, no Cadastro do Portador no botão Remessas e depois no botão Comandos.
 
'''Comando sugestão para Multa:'''
 
'''Código Operação''' = ATM
 
'''Comando''' = ATM
 
'''Descrição''' = ALTERAÇÃO DE MULTA PARA OPEN BANKING
 
'''Tipo de Comando''' = Alteração de Multa
 
'''Comando sugestão para Juros:'''
 
'''Código Operação''' = ATJ
 
'''Comando''' = ATK
 
'''Descrição''' = ALTERAÇÃO DE JUROS PARA OPEN BANKING
 
'''Tipo de Comando''' = Alteração de Juros
 
<center>'''Botão Remessas > Comandos'''
[[image:bt_Comando_Remessa_cop.png.png|center|semmoldura|750px|Comando Remessa]]
 
 
<center>'''Botão Retornos > Códigos de Retorno'''
[[image:bt_Codigo_Ret.png|center|semmoldura|750px|Código de Retorno]]
 
 
Para iniciar a configuração através do “Assistente de Parâmetros do Open Banking”, basta selecionar o botão “Open Banking”:
 
'''Menu > Finanças > Gestão Financeira > Parâmetros > Configuração de Bancos'''
 
 
<center>'''Configurações de Banco'''
[[Arquivo:Configuracoes Banco.png|750x550px|semmoldura|nenhum|Configuracoes_Banco]]
 
 
Para dar início ao processo de parametrização, basta selecionar o botão “Avançar”:
 
 

=='''Tela Inicial Configuração do Assistente Open Banking:'''==
 
'''IMPORTANTE:''' Devido a uma especificação do Banco do Brasil, as Credenciais do Banco geradas são válidas para o escopo de serviços (APIs) do Cliente no momento da sua criação.
 
Caso haja adição de novos serviços ao escopo do Cliente, por exemplo, Credenciais para a API de Cobrança e posteriormente adicione a API do '''PIX''' ao seu escopo, será necessário excluir as Credenciais Antigas no Portal Developers e criar novas, contendo as duas APIs.
 
Depois disso, ele deverá inseri-las no Sistema novamente, substituindo as antigas.
 
Para iniciar a configuração é necessário ter em mãos os seguintes dados: (Cliente, Chave de Autorização e Gw-app-Key).
Sem essas informações não será possível dar continuidade na parametrização do Open Banking para o Banco do Brasil.
 
<center>'''Tela Inicial Assistente de Parâmetros Open Banking'''
[[Arquivo:Tela Inicial Wizard2.png|750x500px|nenhum|Tela_Inicial_Wizard2.png]]
 


=='''Etapa 1 (Parâmetros: Passo 1 de 4):'''==


Uma das etapas mais importantes e que requer um cuidado maior e sigilo das informações nesta parametrização.
 
Essas informações são disponibilizadas pelo Banco a qual deve ser restrita somente a pessoa responsável pelo setor Financeiro da Empresa.
 
O assistente tem como objetivo proporcionar que o próprio usuário tenha autonomia para executar esse passo a passo sem necessidade de passar essas informações restritas da Empresa para qualquer pessoa que não seja ele mesmo.
 
Reforçando, mesmo que tenha dificuldades para executar esta etapa, não repasse nenhuma informação relacionado aos acessos dos tokens.
 
Dados em mãos para informar os respectivos campos, basta copiar e colar as informações.
 
Developer Application Key, Client Id, Cliente Secret, e o Scope que passa vir preenchido automaticamente por padrão.
 
Os campos:
 
Client ID e Client Secret possuem uma tecnologia de criptografia, ou seja, após informar os dados nos campos o sistema irá criptografar as informações garantindo e mantendo a segurança das informações.
 
Caso haja necessidade de alterações, basta clicar no ícone do "Cadeado", será aberta a tela de Criptografia e após colar ou digitar as informações em tela e selecionar o botão "Confirmar".
 
Também tenha alguma dúvida no dado informado e necessitar validar o dado seguindo os mesmos passos da alteração será aberta a tela de Criptografia e após colar ou digitar as informações em tela e selecionar o botão "Validar", sistema confirma se os dados são os mesmos.
 
Observamos que esta tela possui duas guias, uma de Homologação e Produção. Preencher conforme a necessidade do processo, caso precise realizar testes, parametrize em homologação e posteriormente parametrize o de Produção ou se preferir, pode preencher os dois se possuir os dados.
 
Lembrando que esses dados são confidenciais de uso e exclusivo de cada usuário.
 
Através dessas informações o sistema irá se comunicar com API do Banco para poder realizar os registros dos Lançamentos.
 
Após informado os dados, basta selecionar o botão "Avançar", para seguir os próximos passos.
 
'''Developer Application Key:''' conforme orientação do Banco esses dados são de cunho da própria Desenvolvedora de Software, ou seja, elas serão fixas do Sistema CIGAM, sendo setadas por padrão.
 
'''Client ID:''' Identificação da Aplicação, é necessário informar a codificação passada pelo Banco. Este dado é criptografado.
 
'''Client Secret:''' Credencial do banco, é necessário informar a codificação passada pelo Banco. Este dado é criptografado.

 
 
<center>'''Parâmetros: Passo 1 de 4'''
[[Arquivo:Parametros Passo 1de4.png|750x500px|nenhum|Parametros_Passo_1de4]]
 
Atualizado o Scope para Versão 2 do Open Banking sendo setado por padrão, para maiores informações acessar o título do Manual:
 
'''Quais são as novidades após atualização para Versão 2 do Open Banking?'''

=='''Etapa 2 (Portador de Remessa e Retorno - Pagamento: Passo 2 de 4):'''==

Nesta etapa deve ser selecionado o Portador que será considerado para o envio da Remessa de Pagamento (onde estarão os boletos em aberto) e nesta mesma tela informar o qual Portador será considerado para o Retorno de Pagamento (onde serão liquidados os retornos de Pagamentos).
 
Nesta etapa, é possível pular, caso não utilize ainda o Envio de Pagamentos do Open Banking.
 
'''Pular:''' caso deseja pular essa etapa e prosseguir com o processo de parametrização do Open Banking.
 
'''Avançar:''' dá continuidade ao processo de parametrização, após selecionado uma opção.
 
Para continuar a parametrização selecione o botão "Pular" e siga para os próximos passos.
 
<center>'''Portador de Remessa e Retorno: Passo: 2 de 4'''
[[Arquivo:Passo 2 Portador Pagamentos 2.png|750x500px|nenhum|Passo_2_Portador_Pagamentos_2]]
 

=='''Etapa 3 (Convênios de Cobrança: Passo 3 de 4):'''==
 
Nesta etapa o sistema avalia sua base de dados, e localiza os Convênios parametrizados para o Banco do Brasil, onde serão listados.
O sistema possibilita a parametrização de Convênios específicos bem como caso seja optado, selecionando o botão "Pular" o sistema criará automaticamente o Convênio "Geral", ao qual utiliza dados do Portador registrado.
 
'''Pular:''' caso deseja pular essa etapa e prosseguir com o processo de parametrização do Open Banking.
 
'''Avançar:''' dá continuidade ao processo de parametrização, após selecionado uma opção.
 
<center>'''Convênios de Cobrança: Passo 3 de 4'''
[[Arquivo:Passo 3 Convenios Cobranca 2.png|750x500px|nenhum|Passo_3_Convenios_Cobranca_2]]
 

=='''Etapa 3 (Portador de Remessa e Retorno - Cobrança: Passo 3 de 4):'''==
 
Nesta etapa deve ser selecionado o Portador que será considerado para o envio da Remessa de Cobrança (onde estarão os boletos em aberto) e nesta mesma tela informar o qual Portador será considerado para o Retorno de Cobrança (onde serão liquidados os retornos de Cobranças).
 
'''Avançar:''' dá continuidade ao processo de parametrização, após selecionado uma opção.
 
<center>'''Portador de Remessa e Retorno - Cobrança: Passo 3 de 4'''
[[Arquivo:Passo 3 Convenios Cobranca Portador.png|750x500px|nenhum|Passo_3_Convenios_Cobranca_Portador]]
 
Atualizado Wizard para Versão 2 do Open Banking, disponibilizando duas opções:
 
'''- Direto''': esta opção tem como finalidade registrar o Boleto no momento da sua geração, ou seja, quando selecionado ativa propriedade ao qual ao gerar o Boleto Bancário o sistema automaticamente envia o registro Open Banking, sem a necessidade de fazer o processo de envio da Remessa Open Banking do título.
 
'''- PIX''': esta opção tem como finalidade registrar uma operação PIX para os Boletos emitido de forma Direta (opção '''Direto''' marcado).
 
Esta opção é válida '''SOMENTE''' para o Banco do Brasil.
 
Para maiores informações acessar o título do Manual:
 
'''Quais são as novidades após atualização para Versão 2 do Open Banking?'''

=='''Etapa 4 (Relatório: Passo 4 de 4):'''==

 
Nesta etapa o sistema irá buscar automaticamente o Modelo de Relatório Padrão, caso exista no ambiente, facilitando assim todo processo de parametrização e implementação para usuário.
 
A busca é realizado '''(%CIGAM_INSTAL%RF00071_remessas.RTF)''', com isso é importante que o Modelo de Relatório (RF00071_remessas.RTF) esteja devidamente localizado na pasta padrão do Cigam_Instal, como por exemplo:
 
'''%CIGAM_INSTAL%''' = P:\Cigam11\Projects\Controle\MACIEL\Financeiro_Open_Banking
 
"P:\Cigam11\Projects\Controle\MACIEL\Financeiro_Open_Banking\Modelos\Relatorios\Gestao Financeira\RF00071_remessas.RTF"
 
Clicar em "Avançar" para dar seguimento.
 
<center>'''Assistente de Parâmetros Open Banking: Passo 4 de 4'''
[[Arquivo:Assistente Passo 4.png|750x500px|semmoldura|nenhum|Assistente_Passo_4]]
 
 

=='''Etapa Conclusão (Parâmetros de Convênio Open Banking - Conclusão):'''==

 
Esta etapa o sistema faz validação da comunicação com o Banco através da API verificando o ambiente se esta tudo ok, listando em tela.
 
Após a consulta estar "OK", basta clicar no botão "Concluir" e seu ambiente estará apto para utilizar a funcionalidade Open Banking.
 
<center>'''Parâmetros de Convênio Open Banking: Passo Final - Conclusão'''
[[Arquivo:Etapa Final Conclusao.png|750x500px|nenhum|Etapa_Final_Conclusao]]
 
'''Homologação:''' Conexão realizada com sucesso.
 
'''Produção:''' O servidor remoto retornou um erro: (401) Não Autorizado. Isso ocorre quando não houve a parametrização dos dados em Produção como foi realizado no ambiente de Homologação conforme o passo a passo, ou possa ter ocorrido algum erro na comunicação com o Banco.
 
<center>'''Convênio Cadastrado com Sucesso - Cobrança'''
[[Arquivo:Convenio Cobranca Homolog.png|750x500px|nenhum|Convenio_Cobranca_Homolog]]
 
'''Ambiente:''' lista qual é o ambiente cadastrado, sendo apenas duas opções: Homologação e Produção.
 
'''Convênios:''' neste grupo serão listados todos os convênios cadastrados, bem como todas informações pertinentes como:
 
- Portador;
 
- Agência;
 
- Número Conta;
 
- Portador de retorno;
 
'''- Direto:''' esta opção tem como finalidade registrar o Boleto no momento da sua geração, ou seja, quando selecionado ativa propriedade ao qual ao gerar o Boleto Bancário o sistema automaticamente envia o registro Open Banking, sem a necessidade de fazer o processo de envio da Remessa Open Banking do título.
 
Também quando selecionada, terá uma particularidade na questão da Emissão de Boletos em lote pela Rotina de Emissão de Boletos Personalizados. A rotina na guia '''Opções''' tem a opção '''Enviar somente Lançamentos não marcados e marca-los''', caso esteja desmarcada o Registro Open Banking ocorrerá da mesma forma que o sistema irá marcar a opção '''Boleto Impresso''' do Lançamento Financeiro, registrando a Operação Open Banking.
Isso ocorre para manter a integridade, já que esta operação é considerada única no registro, sendo então necessário marcar a '''Boleto Impresso''', para poder conseguir realizar alterações como Alteração de Vencimento ou mesmo a Baixa, sendo uma condição de Sistema.
 
'''- PIX:''' esta opção fica habilitada somente quando selecionado a opção Direto, ela tem como finalidade registrar uma operação PIX para os Boletos emitido de forma Direta (opção Direto marcado).
 
Esta opção é válida SOMENTE para o Banco do Brasil.
 
Ao emitir o Boleto do Lançamento o sistema marca as 3 opções:
 
- Boleto Impresso;
 
- Remessa Enviada;
 
- Código de Barras Lido;
 
'''U.N Ced.:''' esta opção tem como finalidade possibilitar o envio e registro de Boletos de outras Unidades de Negócio.
 
Basta informar a Unidade desejada no campo e o sistema entenderá quando realizado o processo de registro de um título que não seja da Unidade Matriz, então sistema identifica e realiza o processo de envio e registro.
Se deixar em Branco a Unidade Cedente irá considerar para todas Unidades de Negócio.
 
 
<center>'''Convênio Cadastrado com Sucesso - Pagamento'''
[[Arquivo:Convenio Pagamento Homolog.png|750x500px|nenhum|Convenio_Pagamento_Homolog]]
 
'''Ambiente:''' lista qual é o ambiente cadastrado, sendo apenas duas opções: Homologação e Produção.
 
'''Convênios:''' neste grupo serão listados todos os convênios cadastrados, bem como todas informações pertinentes como:
 
- Portador;
 
- Agência;
 
- Número Conta;
 
- Portador de retorno;
 
<center>'''Ícone Credenciais'''
[[Arquivo:Icone Credenciais API.png|750x500px|nenhum|Icone_Credenciais_API]]
 
Através deste ícone é possível verificar os Parâmetros API parametrizados, tanto em homologação quanto em produção.
 
 
<center>'''Ícone Endereços'''
[[Arquivo:Icone Endereços.png|750x500px|nenhum|Icone_Endereços]]
 
Através deste ícone é possível verificar todos endereços de URLs parametrizados.

=='''O que significa a Categoria Open Banking de acesso?'''==
 
 A Categoria Open Banking é uma Categoria que é habilitada mediante a utilização de um Portador parametrizado com as Configurações de Banco Open Banking. A mesma tem como objetivo proporcionar maior agilidade e gerenciamento das atividades relacionadas a Remessa de Cobrança Online.
 
'''Categoria Open Banking'''
 
 
<center>'''Categoria Open Banking'''
[[Arquivo:Categoria Open Banking.png|750x500px|semmoldura|nenhum|Categoria_Open_Banking]]
 
 

'''Registrar:''' item de categoria tem como funcionalidade registrar o Boleto Bancário Online. Substitui todo o processo de geração do arquivo de Remessa de Cobrança, acessar o site e remeter ao Banco esse arquivo, com apenas um clique na opção.
 
'''Reenviar:''' item de categoria tem como funcionalidade possibilitar o reenvio de registros que estão com alguma pendência ou algum erro de parametrização. Será habilitado somente quando já possuir movimento de "Registro" enviado, cuja Situação estiver com pendência ou erro.
 
'''Baixar:''' item de categoria tem como funcionalidade comunicar o Banco referente a Baixa do movimento em questão do Boleto Bancário. Utilizado para eventuais falhas operacionais, como registrado um movimento por engano, ou negociações diretamente com cliente a parte. Eliminando então também todo processo de geração do arquivo de Remessa Bancária com Comando de Remessa de Baixa e o processo de remeter ao Banco o arquivo, sendo realizado tudo online através desta opção.
 
'''Registrar Alteração:''' item de categoria tem como funcionalidade registrar uma alteração ocorrida referente ao "Vencimento" do Lançamento Financeiro.
Ao realizar alteração da Data de Vencimento do Lançamento Financeiro que está com "Situação Open Banking" igual "Registrado" e ocorrer alteração no Vencimento, o sistema emite uma mensagem possibilitando já o envio da alteração no momento ou mais tarde através desta opção de "Registrar Alteração".
 
'''Histórico:''' item de categoria tem como funcionalidade gravar todas movimentações realizadas relativo ao Open Banking. Registros, Baixas, Erros...


='''Layout e Detalhamento de Campos API'''=

==Registro de Boletos==
<center>

{| class="wikitable sortable"
|-
! Nº!!Campo JSON!!Descriçao do Banco!!Campo CIGAM!!Tabela!!Obrigatório!!Ex.Homolog!!Observações
|-
| 1 ||numeroConvenio||Número do convênio de Cobrança do Cliente||Número Controle||Portador||Obrigatório|| 3128557 || Em produção, informar o número do convênio de cobrança, com 7 dígitos.
|-
| 2 || numeroCarteira || Características do serviço de boleto bancário e como ele deve ser tratado pelo banco. || Carteira || Portador || Obrigatório || 17 || Em produção, informar o número da carteira de cobrança.
|-
| 3 || numero Variacao Carteira || Número da variação da carteira do convênio de cobrança. || Variação || Portador || Obrigatório || 35 || Em produção, informar o número da variação da carteira de cobrança.
|-
| 4 || codigoModalidade || Identifica a característica dos boletos dentro das modalidades de cobrança existentes no banco.
'''Domínios:'''
 
01 - SIMPLES
 
04 - VINCULADA
|| Tipo Serviço || Portador || Obrigatório || 1 ou 4 ||
|-
| 5 || dataEmissao || Data de emissão do boleto (formato "dd.mm.aaaaa"). || Data Documento || Boletos || Obrigatório || “15.12.2020” || Qualquer data, a partir da data atual, no formato “dd.mm.aaaa”.
|-
| 6 || dataVencimento || Data de vencimento do boleto. || Vencimento || Boletos || Obrigatório || “31.03.2021” || Qualquer data maior ou igual que a data de emissão, no formato “dd.mm.aaaa”.
|-
| 7 || valorOriginal || Valor do boleto no registro. || Saldo || LANCAM || Obrigatório || 123.45 || Valor do boleto no registro, em reais. Deve ser maior que a soma dos campos “valorDesconto” e “valorAbatimento”, se informados. Deve ser maior do que zero. No caso de emissão com valor equivocado, sugerimos cancelar o boleto e emitir um novo.
|-
| 8 || valorAbatimento || Valor do abatimento (reduz valor do boleto) expresso em moeda corrente. || 0 || 0 || Opcional || 12.34 || Valor de dedução do boleto. Se informado, deve ser maior que zero.
|-
| 9 || quantidade DiasProtesto || Quantos dias após a data de vencimento do boleto para iniciar o processo de cobrança através de protesto. (valor inteiro >= 0). || Protesto || Portador || Opcional || 0 ou maior que zero || Quantidade de dias após a data de vencimento do boleto para iniciar o processo de cobrança através de protesto. (3 a 5 dias úteis ou 6 a 29, 35, 40 ou 45 dias corridos)
|-
|10||indicador Aceite Titulo Vencido||Indicador de que o boleto pode ou não ser recebido após o vencimento. Se não informado, será assumida a informação de limite de recebimento parametrizada no convênio.|| X || X || Obrigatório || S ou N || Quando informado “S”, em conjunto com o campo “numeroDias LimiteRecebimento”, será definida a quantidade de dias corridos após o vencimento que este boleto ficará disponível para pagamento. Atenção: neste caso, se o campo “numeroDias LimiteRecebimento” ficar com valor zero, também será assumida a informação de limite de recebimento parametrizada no convênio.

Quando informado “N”, está definindo que o boleto NÃO permite pagamento em atraso.

Quando informado “N”, está definindo que o boleto NÃO permite pagamento em atraso.
|-
| 11 || numeroDias LimiteRecebimento || Número de dias limite para recebimento. Informar valor inteiro > 0. || X || X || Opcional || 0 ou maior que zero ||
|-
| 12 || codigoAceite || Código para identificar se o boleto de cobrança foi aceito (reconhecimento da dívida pelo Pagador).
'''Domínios:'''
 
A - ACEITE
 
N - NAO ACEITE
|| Aceite || Portador || Obrigatório || A ou N ||
|-
| 13 || codigoTipoTitulo || Código para identificar o tipo de boleto de cobrança. [[#Domínios: codigoTipoTitulo|Clique aqui]] para visualizar os Domínios. || Especie || Portador || Obrigatório || 2 ||
|-
| 14 || descricao TipoTitulo || Descrição do tipo de boleto. || 0 || 0 || Opcional || “DM” || Descrição do tipo de boleto. Se houver dúvidas com relação ao tipo, consultar as regras da Febraban.
|-
| 15 ||indicador Permissao RecebimentoParcial|| Código para identificação da autorização de pagamento parcial do boleto.
'''Domínios:'''
 
S - SIM
 
N - NÃO
|| X || X || Obrigatório || S ou N ||
|-
| 16 || numeroTitulo Beneficiario || Número de identificação do boleto (correspondente ao SEU NÚMERO), no formato STRING (Limitado a 15 caracteres - Letras Maiúsculas). || Serie || LANCAM || Opcional || “123456” ||
|-
| 17 || campo Utilizacao Beneficiario || Informações adicionais sobre o beneficiário. || Lançamento || LANCAM || Opcional || “UM TEXTO” || Pode ter até 30 caracteres, em maiúsculas.
|-
| 18 || numero TituloCliente || Número de identificação do boleto (correspondente ao NOSSO NÚMERO). || Nosso Número || Boletos || Obrigatório || “00031285570000030000” || Formato STRING, com 20 dígitos, que deverá ser formatado da seguinte forma: “000” + (número do convênio com 7 dígitos) + (10 algarismos - se necessário, completar com zeros à esquerda).
|-
| 19 || mensagem Bloqueto Ocorrencia || Mensagem definida pelo beneficiário para ser impressa no boleto (Limitado a 30 caracteres) || Texto 4 || Boletos || Opcional || “Outro texto” || Mensagem definida pelo beneficiário para ser impressa no boleto. Pode ter até 165 caracteres, sendo que cada 55 caracteres equivalem a uma linha de mensagem. Atenção: não são permitidos caracteres de escape ( \r ou \n ).
|-
| 20 || desconto || Define a ausência ou a forma como será concedido o desconto para o Título de Cobrança. || X || X || Opcional || ||
|-
| 20.1 || tipo || Define como o desconto será concedido.
'''Domínio:'''
0 - Sem desconto
 
1 - Valor fixo até a data informada
 
2 - percentual até a data informada.
|| Valor Desconto || LANCAM || Opcional || 0 ou 1 ou 2 ||
|-
| 20.2 || dataExpiracao || Define a data de expiração do desconto (somente se tipo > 0), no formato “dd.mm.aaaa”. || Vencimento* || LANCAM || Opcional || “30.01.2021” ||
|-
| 20.3 || porcentagem || Define a porcentagem do desconto (somente se tipo = 2). || X || X || Opcional || 5.00 ||
|-
| 20.4 || valor || Define o valor do desconto (somente se tipo = 1). || Valor Desconto* || LANCAM || Opcional || 12.34 ||
|-
| 21 || segundoDesconto || Define a forma como será concedido um segundo desconto para o boleto. Só pode ser usado se for definido um primeiro desconto. O tipo do segundo desconto será igual ao do primeiro desconto. || X || X || Opcional || ||
|-
| 21.1 || dataExpiracao || Define a data de expiração do desconto, no formato “dd.mm.aaaa”. Deve ser posterior a data de expiração do primeiro desconto. || X || X || Opcional || “10.02.2021” ||
|-
| 21.2 || porcentagem || Define a porcentagem do desconto (somente se o tipo = 2). || X || X || Opcional || 5.00 ||
|-
| 21.3 || valor || Define o valor do desconto (somente se o tipo = 1). || X || X || Opcional || 12.34 ||
|-
| 22 || terceiroDesconto || Define a forma como será concedido um terceiro desconto para o boleto. Só pode ser usado se for definido um segundo desconto. O tipo do terceiro desconto será igual ao do primeiro desconto. || X || X || Opcional || ||
|-
| 22.1 || dataExpiracao || Define a data de expiração do desconto, no formato “dd.mm.aaaa”. Deve ser posterior a data de expiração do segundo desconto. || X || X || Opcional || 20.02.2021” ||
|-
| 22.2 || porcentagem || Define a porcentagem do desconto (somente se o tipo = 2). || X || X || Opcional || 5.00 ||
|-
| 22.3 || valor || Define o valor do desconto (somente se o tipo = 1). || X || X || Opcional || 12.34 ||
|-
| 23 || jurosMora || Código utilizado pela FEBRABAN para identificar o tipo de taxa de juros. [[#Domínios: jurosMora|Clique aqui]] para visualizar os Domínios.
|| X || X || Opcional || || Se informado ‘0’ (zero) ou ‘3’ (três), os campos “PERCENTUAL DE JUROS DO TÍTULO” e “VALOR DO JUROS DO TÍTULO” não devem ser informados ou ser informados igual a ‘0’ (zero).
O valor de juros e multa incidem sobre o valor atual do boleto (valor do boleto - valor de abatimento).
|-
| 23.1 || tipo || Código utilizado pela FEBRABAN para identificar o tipo da taxa de juros. [[#Domínios: tipo (jurosMora)|Clique aqui]] para visualizar os Domínios.
|| Juros Dia || LANCAN || Opcional || 0 ou 1 ou 2 ou 3 ||
|-
| 23.2 || porcentagem || Define a taxa mensal de juros (somente informar se tipo = 2). A taxa incide sobre o valor atual do boleto (valorOriginal - valorAbatimento) || X || X || Opcional || 1.00 ||
|-
| 23.3 || valor || Define o valor fixo por dia de atraso (somente informar se tipo = 1). || Juros Dia || LANCAM || Opcional || 0.33 ||
|-
| 24 || multa || Define a forma que será cobrada (ou não) a multa por atraso no pagamento. || X || X || Opcional || ||
|-
| 24.1 || tipo || Código utilizado pela FEBRABAN para identificar o tipo da multa. [[#Domínios: tipo (multa)|Clique aqui]] para visualizar os Domínios.
|| Valor Multa || LANCAM || Opcional || 0 ou 1 ou 2 ||
|-
| 24.2 || data || Define a data a partir da qual será cobrada a multa (somente informar se tipo = 1 ou 2). Deve ser posterior a data de vencimento do boleto. || Tolerância Multa || LANCAM || Opcional || “01.04.2021” ||
|-
| 24.3 || porcentagem || Define a porcentagem da multa (somente informar se tipo = 2). A porcentagem incide sobre o valor atual do boleto (valorOriginal - valorAbatimento). || Valor || LANCAM || Opcional || 2.00 ||
|-
| 24.4 || valor || Define o valor da multa (somente informar se tipo = 1). || Valor Multa || LANCAM || Opcional || 10.00 ||
|-
| 25 || pagador || Identifica o pagador do boleto. || X || X || Obrigatório || ||
|-
| 25.1 || tipoInscricao || Define o tipo do inscrição do pagador.
'''Domínio:'''
 
1 - Pessoa física
 
2 - Pessoa Jurídica.
|| X || X || Obrigatório || 1 ou 2 ||
|-
| 25.2 || numeroInscricao || Define o número de inscrição do pagador; se pessoa física, CPF; se pessoa jurídica, CNPJ. Numérico, deve ser preenchido sem ponto, hífen, barra, e sem zeros à esquerda. || X || X || Obrigatório || 97965940132 (PF) ou 74910037000193 (PJ) ||
|-
| 25.3 || nome || Identifica o nome do pagador. Pode ter até 30 caracteres. || Pessoa || Empresa || Obrigatório || “Odorico Paraguassu” ||
|-
| 25.4 || endereco || Identifica o endereço do pagador. Pode ter até 30 caracteres. || X || X || Obrigatório || “Avenida Dias Gomes 1970” ||
|-
| 25.5 || cep || Identifica o CEP do pagador. Numérico, deve ser preenchido sem ponto ou hífen, e sem zeros à esquerda. || CEP || Empresa || Obrigatório || 77458000 ||
|-
| 25.6 || cidade || Identifica a cidade do pagador. Pode ter até 30 caracteres. || Municipio || Empresa || Obrigatório || “Sucupira” ||
|-
| 25.7 || bairro || Identifica o bairro do pagador. Pode ter até 30 caracteres. || Bairro || Empresa || Obrigatório || “Centro” ||
|-
| 25.8 || uf || Identifica o estado (UF) do pagador. Deve ter 2 caracteres e ser um estado válido. || UF || Empresa || Obrigatório || “TO” ||
|-
| 25.9 || telefone || Define o número de telefone do pagador. Pode ter até 30 caracteres. || Fone || Empresa || Opcional || “63987654321” ||
|-
| 26 || beneficiarioFinal || Identifica o beneficiário final (antigo avalista) do boleto, se houver. || X || X || Opcional || ||
|-
| 26.1 || tipoInscricao || Define o tipo do inscrição do beneficiário final (antigo avalista).
'''Domínio:'''
 
1 - Pessoa física
 
2 - Pessoa Jurídica.
|| X || X || Opcional || 1 ou 2 ||
|-
| 26.2 || numeroInscricao || Define o número de inscrição do beneficiário final (antigo avalista); se pessoa física, CPF; se pessoa jurídica, CNPJ. Numérico, deve ser preenchido sem ponto, hífen, barra, e sem zeros à esquerda. || X || X || Opcional || 66779051870 (PF) ou 98959112000179 (PJ) ||
|-
| 26.3 || nome || Identifica o nome do beneficiário final (antigo avalista). Pode ter até 30 caracteres. || X || X || Opcional || “Dirceu Borboleta” ||
|-
| 27 || quantidadeDiasNegativacao || Quantidade de dias, após o vencimento do Boleto, que o Boleto será Negativado || Protesto || Portador || Opcional || 0 ou maior que zero ||
|-
| 28 || orgaoNegativador || Código do órgão negativador selecionado.
'''Domínio:'''
 
10 - SERASA
 
11 - QUOD.
|| X || X || Opcional || 10 ou 11 ||
|-
| 29 || indicadorPix || Código para informar se o boleto terá um QRCode Pix atrelado. Se não informado, ou utilizado caractere inválido, o sistema assumirá ‘N’.
'''Domínio:'''
 
S - QRCode dinâmico
 
N - sem Pix.
|| X || X || Opcional || S ou N || Atenção: conforme regulamentação do Bacen, é permitido somente para modalidade de cobrança simples (ver codigoModalidade).
|-
|}

</center>

==='''Domínios: codigoTipoTitulo'''===

• 1 - CHEQUE
 
• 2 - DUPLICATA MERCANTIL
 
• 3- DUPLICATA MTIL POR INDICACAO
 
• 4 - DUPLICATA DE SERVICO
 
• 5 - DUPLICATA DE SRVC P/INDICACAO
 
• 6 - DUPLICATA RURAL
 
• 7 - LETRA DE CAMBIO
 
• 8 - NOTA DE CREDITO COMERCIAL
 
• 9 - NOTA DE CREDITO A EXPORTACAO
 
• 10 - NOTA DE CREDITO INDULTRIAL
 
• 11 - NOTA DE CREDITO RURAL
 
• 12 - NOTA PROMISSORIA
 
• 13 - NOTA PROMISSORIA RURAL
 
• 14 - TRIPLICATA MERCANTIL
 
• 15 - TRIPLICATA DE SERVICO
 
• 16 - NOTA DE SEGURO
 
• 17 - RECIBO
 
• 18 - FATURA
 
• 19 - NOTA DE DEBITO
 
• 20 - APOLICE DE SEGURO
 
• 21- MENSALIDADE ESCOLAR
 
• 22 - PARCELA DE CONSORCIO
 
• 23 - DIVIDA ATIVA DA UNIAO
 
• 24- DIVIDA ATIVA DE ESTADO
 
• 25 - DIVIDA ATIVA DE MUNICIPIO
 
• 31 - CARTAO DE CREDITO
 
• 32 - BOLETO PROPOSTA
 
• 33 - BOLETO APORTE
 
• 99 - OUTROS.
 

==='''Domínios: jurosMora'''===

• 0 - DISPENSAR
 
• 1 - VALOR DIA ATRASO
 
• 2 - TAXA MENSAL
 
• 3 - ISENTO
 

==='''Domínios: tipo (jurosMora)'''===

• 0 - Dispensar
 
• 1 - Valor fixo por dia de atraso
 
• 2 - Taxa mensal
 
• 3 - Isento
 

==='''Domínios: tipo (multa)'''===

• 0 - Dispensar
 
• 1 - Valor fixo (a partir da data estipulada no registro)
 
• 2 - Percentual (a partir da data estipulada no registro).
 

==Retorno de Boletos==

<center>

{| class="wikitable"
|-
! Nº !! Campo JSON !! Descriçao do Banco !! Campo CIGAM !! Tabela !! Obrigatório !! Exemplo para HOMOLOGAÇÃO !! Observações
|-
| 1 || gw-app-key || É a chave de acesso do aplicativo do desenvolvedor utilizada em produção, obtida no Portal do Desenvolvedor. Essa chave será usada para identificação do aplicativo. || 0 || 0 || Obrigatório || 0021239456d80136 bebf005056891bed || >>REVISAR<<
|-
| 2 || indicadorSituacao || Situação do boleto.
'''Domínios:'''
 
A - Em ser
 
B - Baixados/ Protestados/ Liquidados
|| X || X || Obrigatório || A ou B || Campo obrigatoriamente MAIÚSCULO.
|-
| 3 || agenciaBeneficiario || Indica o número da agência cadastrada como beneficiária do convênio, sem o dígito verificador e sem zeros a esquerda. || Agência || Portador || Obrigatório || 452 ||
|-
| 4 || contaBeneficiario || Indica o número da conta cadastrada como beneficiária do convênio, sem o dígito verificador e sem zeros a esquerda. || Conta Número || Portador || Obrigatório || 123873 ||
|-
| 5 || carteiraConvenio || Indica o número da carteira do convênio de cobrança. || Carteira || Portador || Obrigatório || 17 ||
|-
| 6 || variacaoCarteiraConvenio || Indica o número da variação do convênio de cobrança. || Variação || Portador || Opcional || 35 ||
|-
| 7 || modalidadeCobranca || Indica a modalidade de cobrança na qual o boleto está cadastrado no BB.
'''Domínio''':
 
1 - Simples
 
4 - Vinculada.
|| Tipo Serviço || Portador || Opcional || 1 ou 4 ||
|-
| 8 || cnpjPagador || Indica o CNPJ do pagador a ser pesquisado, sem o dígito e sem zeros a esquerda. || CNPJ/CPF || Cobrança || Opcional || 543483490001 || Informar em conjunto com digitoCnpjPagador.
|-
| 9 || digitoCNPJPagador || Indica o dígito do CNPJ do pagador a ser pesquisado, sem zeros a esquerda.
|| X || X || Opcional || 48 || Informar em conjunto com cnpjPagador.
|-
| 10 || cpfPagador || Indica o CPF do pagador a ser pesquisado, sem o dígito e sem zeros a esquerda.
|| CNPJ/CPF || Cobrança || Opcional || 979659401 || Informar em conjunto com digitoCpfPagador.
|-
| 11 || digitoCPFPagador || Indica o dígito do CPF do pagador a ser pesquisado, sem zeros a esquerda.
|| X || X || Opcional || 32 || Informar em conjunto com cpfPagador.
|-
| 12 || dataInicioVencimento || Data inicial de vencimento que delimita o período da consulta, formato dd.mm.aaaa. Se informada data posterior a atual, o campo dataFimVencimento deve ser preenchido com data posterior ou igual a dataInicioVencimento. Se informada data anterior ou igual a data atual e o campo dataFimVencimento não for informado, o sistema assume a data atual como dataFimVencimento.|| X || X || Opcional || 01.01.2021 ||
|-
| 13 || dataFimVencimento || Data final de vencimento que delimita o período da consulta, formato dd.mm.aaaa. Se informada, deve ser uma data posterior ou igual a dataInicioVencimento. || X || X || Opcional || 30.01.2021 ||
|-
| 14 || dataInicioRegistro || Data inicial de registro que delimita o período da consulta, formato dd.mm.aaaa. Deve ser anterior ou igual a data atual. || X || X || Opcional || 01.11.2020 ||
|-
| 15 || dataFimRegistro || Data fim de registro que delimita o período da consulta, formato dd.mm.aaaa.
|| X || X || Opcional || 30.11.2020 || Se informada, deve ser posterior ou igual a dataInicioRegistro, e igual ou anterior à data atual. Se não informada, o sistema assume a data atual.
|-
| 16 || dataInicioMovimento || Data início de movimento que delimita o período de consulta de boletos baixados, liquidados ou protestados, formato dd.mm.aaaa. || X || X || Opcional || 01.12.2020 || Deve ser anterior ou igual à data atual.
|-
| 17 || dataFimMovimento || Data fim de movimento que delimita o período de consulta de boletos baixados, liquidados ou protestados, formato dd.mm.aaaa. || X || X || Opcional || 15.12.2020 || Se informada, deve ser posterior ou igual a dataInicioMovimento, e igual ou anterior à data atual. Se não informada, o sistema assume a data atual.
|-
| 18 || codigoEstadoTituloCobranca || Código da situação atual do boleto. [[#Domínios: codigoEstadoTituloCobranca|Clique aqui]] para visualizar os Domínios. || X || X || Opcional || entre 1 e 21 ||
|-
| 19 || boletoVencido || Define se a pesquisa trará apenas boletos vencidos ou não. || X || X || Opcional || S ou N || Sempre MAIÚSCULA.
|-
| 20 || indice || Representa o índice da listagem pelo qual sua pesquisa se iniciará, podendo retornar até 300 registros por chamada. O default é 0, o que trará os resultados de 0 a 299 (se houver). || X || X || Opcional || qualquer inteiro || Quando o resultado da pesquisa tiver mais que 300 registros, na resposta, o campo indicadorContinuidade retornará com “S”. Recomendamos utilizar o valor do campo proximoIndice (informado na resposta), no campo indice da próxima chamada, para retornar com os próximos registros.
|-
|}
</center>


==='''Domínios: codigoEstadoTituloCobranca'''===

1 - NORMAL
 
2 - MOVIMENTO CARTORIO
 
3 - EM CARTORIO
 
4 - TITULO COM OCORRENCIA DE CARTORIO
 
5 - PROTESTADO ELETRONICO
 
6 - LIQUIDADO
 
7 - BAIXADO
 
8 - TITULO COM PENDENCIA DE CARTORIO
 
9 - TITULO PROTESTADO MANUAL
 
10 - TITULO BAIXADO/PAGO EM CARTORIO
 
11 - TITULO LIQUIDADO/PROTESTADO
 
12 - TITULO LIQUID/PGCRTO
 
13 - TITULO PROTESTADO AGUARDANDO BAIXA
 
14 - TITULO EM LIQUIDACAO
 
15 - TITULO AGENDADO BB
 
16 - TITULO CREDITADO
 
17 - PAGO EM CHEQUE - AGUARD.LIQUIDACAO
 
18 - PAGO PARCIALMENTE
 
19 - PAGO PARCIALMENTE CREDITADO
 
21 - TITULO AGENDADO OUTROS BANCOS

==Alteração de Boletos==

<center>

{| class="wikitable"
|-
! Nº !! Campo JSON !! Descriçao do Banco !! Campo CIGAM !! Tabela !! Obrigatório !! Exemplo para HOMOLOGAÇÃO !! Observações
|-
| 1 || numeroConvenio || Identifica o número do convênio de cobrança. || Número Controle || Portador || Obrigatório || 3128557 ||
|-
| 2 || indicador Cancelar Abatimento || Indica a intenção (ou não) de cancelar o abatimento concedido a um boleto. || X || X || Obrigatório || S ou N ||
|-
| 3 || alteracaoAbatimento || X || X || X || Parcial || ||
|-
| 3.1 || novoValorAbatimento || Novo valor do abatimento (reduz valor do boleto) expresso em moeda corrente. || X || X || Parcial || 2.00 ||
|-
| 4 || indicador Alterar DataDesconto || Indica a intenção (ou não) de alterar a data de desconto(s) concedido(s) em um boleto. || X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo alteracaoDataDesconto.
|-
| 5 || alteracao DataDesconto || Nova data limite do Primeiro Desconto || X || X || Parcial || || Observar as regras para datas de desconto no campo desconto da Geração de Boletos.
|-
| 5.1 || novaData LimitePrimeiro Desconto || Nova data limite do Primeiro Desconto || X || X || Parcial || “01.01.2021” ||
|-
| 5.2 || novaData Limite SegundoDesconto || Nova data limite do Segundo Desconto || X || X || Parcial || “10.01.2021” ||
|-
| 5.3 || novaData LimiteTerceiro Desconto || Nova data limite do Terceiro Desconto || X || X || Parcial || “20.01.2021” ||
|-
| 6 || indicador Alterar Desconto || Indica a intenção (ou não) de alterar o desconto concedido em um boleto. || X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo alteracaoDesconto.
|-
| 7 || alteracaoDesconto || || X || X || Parcial || || Observar as instruções sobre o campo desconto na Geração de Boletos.
|-
| 8 || indicador Alterar EnderecoPagador || Indica a intenção (ou não) de alterar o endereço do pagador no boleto. Se sim, deve ser usado em conjunto com o campo alteracaoEndereco. || X || X || Obrigatório || S ou N || '''Atenção:''' a alteração do endereço não implica em nova geração ou envio de boleto. Isso é responsabilidade do beneficiário.
|-
| 9 || alteracaoEndereco || || X || X || Parcial || || Observar as instruções sobre o campo pagador na Geração de Boletos.
|-
| 10 || indicador AlterarPrazo BoletoVencido || Indica a intenção (ou não) de alterar o prazo para recebimento de boleto vencido. || X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo alteracaoPrazo.
|-
| 11 || alteracaoPrazo || || X || X || Parcial || ||
|-
| 11.1 || quantidade DiasAceite || Define a quantidade e dias corridos após o vencimento em que o boleto poderá ser recebido. Equivalente ao campo numeroDiasLimiteRecebimento na Geração de Boletos. || X || X || Parcial || 0 ou maior que zero ||
|-
| 12 || indicador AlterarSeuNumero || Indica a intenção (ou não) de alterar o campo numeroTituloBeneficiario (equivalente ao SEU NÚMERO) no boleto. || X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo alteracaoSeuNumero.
|-
| 13 || alteracaoSeuNumero || || X || X || Parcial || || Observar as instruções sobre o campo numeroTituloBeneficiario na Geração de Boletos.
|-
| 14 || indicador AtribuirDesconto || Indica a intenção (ou não) de atribuir desconto ao boleto. || X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo desconto.
|-
| 15 || desconto || || X || X || Parcial || || Observar as instruções sobre o campo desconto na Geração de Boletos. Lembrete: o tipo definido para o primeiro desconto será replicado no segundo e no terceiro desconto (se informados).
|-
| 16 || indicador Cancelar Protesto || Indica a intenção (ou não) de cancelar uma instrução de protesto enviada ao BB na mesma data ou que ainda não tenha sido processada pelo BB.
'''Domínios:'''
 
S - Sim, desejo alterar
 
N - Não, não desejo alterar
|| X || X || Obrigatório || S ou N ||
|-
| 17 || indicadorCobrarJuros || Indica a intenção (ou não) de cobrar juros no boleto.
'''Domínios:'''
 
S - Sim, desejo alterar
 
N - Não, não desejo alterar
|| X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo juros.
|-
| 18 || juros || || || || Parcial || || Observar as instruções sobre o campo juros na Geração de Boletos.
|-
| 19 || indicadorCobrarMulta || Indica a intenção (ou não) de cobrar multa no boleto.
'''Domínios:'''
 
S - Sim, desejo alterar
 
N - Não, não desejo alterar
|| X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo multa.
|-
| 20 || multa || || X || X || Parcial || || Observar as instruções sobre o campo multa na Geração de Boletos.
|-
| 21 || indicador Dispensar Juros || Indica a intenção (ou não) de dispensar os juros sobre o boleto.
'''Domínios:'''
 
S - Sim, desejo alterar
 
N - Não, não desejo alterar
|| X || X || Obrigatório || S ou N ||
|-
| 22 || indicador Dispensar Multa || Indica a intenção (ou não) de dispensar a multa sobre o boleto.
'''Domínios:'''
 
S - Sim, desejo alterar
 
N - Não, não desejo alterar
|| X || X || Obrigatório || S ou N ||
|-
| 23 || indicadorIncluirAbatimento || Indica a intenção (ou não) de incluir abatimento em um boleto.
'''Domínios:'''
 
S - Sim, desejo alterar
 
N - Não, não desejo alterar
|| X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo abatimento.
|-
| 24 || abatimento || || X || X || Parcial || ||
|-
| 24.1 || valorAbatimento || Define o valor a ser concedido como abatimento. || X || X || Parcial || 10.00 ||
|-
| 25 || indicadorNegativar || Indica a intenção (ou não) de negativar ou cancelar a negativação do boleto.
'''Domínios:'''
 
S - Sim, desejo alterar
 
N - Não, não desejo alterar
|| X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo negativacao. Não confundir com protesto.
|-
| 26 || negativacao || || X || X || Parcial || ||
|-
| 26.1 || quantidade DiasNegativacao* || Quantidade de dias, após o vencimento do boleto, em que o boleto será negativado. || Protesto || Portador || Parcial || qualquer inteiro ||
|-
| 26.2 || tipoNegativacao || Código para identificação do tipo de negativação que deverá ser aplicada ao boleto.
'''Domínio:'''
 
1 - incluir
 
2 - alterar prazo
 
3 - cancelar
 
4 - excluir
|| X || X || Parcial || 1 ou 2 ou 3 ou 4 ||
|-
| 26.3 || indicador Nova DataVencimento || Indica a intenção (ou não) de atribuir nova data de vencimento ao boleto. || X || X || Obrigatório || S ou N || Se sim, deve ser usado em conjunto com o campo alteracaoData.
|-
| 27 || alteracaoData || || X || X || Parcial || ||
|-
| 27.1 || novaDataVencimento || Define a nova data de vencimento, formato “dd.mm.aaaa”. || Vencimento || LANCAM || Parcial || “30.04.2021" ||
|-
| 28 || indicadorProtestar || Indica a intenção (ou não) de protestar o boleto. || X || X || Obrigatório || S ou N || Não confundir com negativação.
|-
| 28.1 || indicador SustacaoProtesto || Indica a intenção (ou não) de sustar/cancelar um comando de protesto que já tenha sido processado pelo BB. || X || X || Obrigatório || S ou N ||
|-
| 29 || indicador SustacaoProtesto || Indica a intenção (ou não) de sustar/cancelar um comando de protesto que já tenha sido processado pelo BB. || X || X || Obrigatório || S ou N ||
|}
</center>


='''Como realizar a criação de Lançamentos utilizando a funcionalidade Open Banking?'''=
 
Para a criação de Lançamentos Financeiros acessar o caminho de Menu:
 

'''Menu > Finanças > Gestão Financeira > Movimentos > Lançamentos'''
 

Acessar o botão “Criar” e informar os dados necessários para a criação do Lançamento Financeiro a Receber utilizando o Portador parametrizado para Open Banking.
 
 
'''1- Etapa criação do Lançamento:'''
 
 
<center>'''Criação do Lançamento Financeiro a Receber'''
[[Arquivo:Create Lanc Open Banking.png|750x500px|semmoldura|nenhum|Criação do Lançamento Financeiro]]
 
 

'''2- Etapa Impressão do Boleto Bancário do Lançamento Financeiro:'''
 
Nesta etapa pode ser realizado a impressão do Boleto Bancário diretamente pelo próprio Lançamento Financeiro ou através da rotina de Emissão em lote "Emissão de Boletos Personalizados":
 
 
<center>'''Impressão do Boleto Bancário do Lançamento Financeiro'''
[[Arquivo:Imprimir Boleto Lanc.png|750x500px|semmoldura|nenhum|Impressão Boleto Bancário]]
 
 

'''3- Etapa do Registro do Boleto Open Banking:'''
 
Nesta etapa pode ser realizado o "Registro" do Boleto diretamente pelo próprio Lançamento Financeiro ou através da rotina de Emissão em lote "Emissão de Boletos Personalizados":
Basta acessar a Categoria "Open Banking" e selecionar o Item de Categoria "Registrar".
Sistema irá realizar a comunicação através das parametrizações realizadas das Urls e Tokens de acesso e listará a situação do Registro do Boleto Bancário através do Relatório.
 
 
<center>'''Registrar Boleto Open Banking através Lançamento Financeiro'''
[[Arquivo:Boleto Impresso Registrar OP.png|750x500px|semmoldura|nenhum|Registro Boleto Open Banking]]
 
 
<center>'''Relatório Remessa Bancária OnLine'''
[[Arquivo:Relat Registro Open Banking.png|750x500px|semmoldura|nenhum|Relatório Remessa Bancária Online]]
 
 
Após o registro automaticamente o sistema marca as opções de:
 
- Remessa Enviada
 
- Códigos de Barras Lido
 
 
<center>'''Boleto Bancário Registrado'''
[[Arquivo:Lanc Registrado Validar Historico.png|750x500px|semmoldura|nenhum|Lanc_Registrado_Validar_Historico]]
 
 
Para verificar todas as movimentações realizada sobre Open Banking, elas estão sendo gravadas no Item de Categoria "Histórico" que fica na Categoria "Open Banking".
Ao selecionar o Item de Categoria "Histórico" deve listar o Registro do Boleto Bancário.
 
 
<center>'''Item de Categoria Histórico de Movimentos Open Banking'''
[[Arquivo:Item Categoria Historico.png|750x500px|semmoldura|nenhum|Item_Categoria_Histórico]]
 
 

='''Como realizar o Envio em Lote Open Banking através da rotina Remessa de Cobrança Open Banking?'''=

Assim como é possível realizar o Envio do Registro do Boleto Bancário através do próprio Lançamento Financeiro, existe a possibilidade de realizar esse processo em Lote, quando se tratar de vários registros a serem enviados.
Através do Menu:
 
 
'''Menu: Finanças > Gestão Financeira > Rotinas > EDI> Transmite > Remessa Cobranças Bancárias > Remessa de Cobrança Open Banking'''
 
 
<center>'''Remessa de Cobrança Open Banking'''
[[Arquivo:Remessa_de_Cobranca_Open_Banking_BB3.png|750x500px|semmoldura|nenhum|Remessa_de_Cobranca_Open_Banking]]
 
 
Esta rotina tem um conceito muito simples em relação aos filtros, foram disponibilizados campos essências que permitem ter uma rastreabilidade dos movimentos.

'''Unidade de Negócio:''' informe a Unidade de Negócio desejada para realizar o filtro para busca dos movimentos.
 
'''Data:''' informe a Data desejada para realizar o filtro para busca dos movimentos.
 
'''Vencimento:''' informe o período de Vencimento desejado para realizar o filtro para busca dos movimentos.
 
'''Lançamento:''' informe a faixa de Lançamentos desejada para realizar o filtro para busca dos movimentos.
 
'''Tipo de Pagamento:''' informe o Tipo de Pagamento desejado para realizar o filtro para busca dos movimentos.
 
'''Série:''' informe a Série desejada para realizar o filtro para busca dos movimentos.
 
'''Nota Fiscal:''' informe a faixa de Nota Fiscal desejada para realizar o filtro para busca dos movimentos.
 
'''Conta Financeira:''' informe a Conta Financeira desejada para realizar o filtro para busca dos movimentos.
 
'''Empresa:''' informe a faixa de Empresa desejada para realizar o filtro para busca dos movimentos.
 
'''Cobrança:''' informe a faixa de Empresa de Cobrança desejada para realizar o filtro para busca dos movimentos.
 
 
Após informado os filtros e confirmado a operação da rotina o sistema gera um relatório com a listagem dos movimentos.
Na coluna "Registro", será listado se houve a confirmação ou ocorreu algum erro.
 
 
<center>'''Relatório Remessa de Cobrança Open Banking'''
[[Arquivo:Relat Remessa Bancaria Open Banking.png|750x500px|semmoldura|nenhum|Relat_Remessa_Bancaria_Open_Banking]]
 
 

='''Como realizar o Retorno de Cobrança Open Banking?'''=

Esta rotina tem como funcionalidade realizar a consulta dos registros enviados para o Banco não só através do Open Banking como também títulos enviados pela rotina de Remessa Bancárias e efetuar as liquidações dos registros que já foram pagos ou baixados. Porém as buscas para títulos não gerados pelo CIGAM e o retorno do registro de baixa estão disponíveis apenas para Versão 2 da API do Open Banking.
 
'''IMPORTANTE:''' caso o retorno apresente o erro:(500) Erro Interno do Servidor é possível que o Cadastro do Portador esteja com algum parâmetro incorreto, como por exemplo um caractere especial na Conta ou na Agência.
 
'''Regras de Busca do Sistema para localizar os títulos a partir da Versão API = v2'''
 
1- O sistema tenta localizar os títulos pelo Número do Lançamento;
 
2- Caso os títulos tenham sido gerados pelo CIGAM irá localizar pelo '''Nosso Número''', avaliando então a tabela '''GFBOLETOS''' pela coluna '''NOSSO_NRO'''.
 
3- Caso os títulos tenham sido gerados por outro sistema irá localizar pelo '''Nosso Número''', avaliando então a tabela '''GFLAUXIL''' pela coluna '''CODIGO_BARRAS'''.
 
'''Como faço para atualizar com a nova Versão API = v2?'''
 
Simples acesse a opção do índice do Manual:
 
'''Quais são as novidades após atualização para Versão 2 do Open Banking?'''
 
 
'''Menu: Finanças > Gestão Financeira > Rotinas > EDI> Recebe > Retorno Cobranças Bancárias > Retorno de Cobrança Open Banking'''
 
<center>'''Rotina Retorno de Cobrança Open Banking'''
[[Arquivo:Retorno_Boletos_Open_Banking_V.png|750x500px|semmoldura|nenhum|Retorno_Boletos_Open_Banking]]
 
 

'''Empresa:''' possibilita realizar o filtro por Empresa, consultando todos os registros da Empresa informada.
 
'''Unidade de Negócio:''' possibilita realizar o filtro por Unidade de Negócio.
 
'''Lançamento:''' possibilita realizar filtro por faixa de Lançamento.
 
'''Vencimento:''' possibilita realizar filtro por faixa de Vencimento.
 
'''Movimento/Registro:''' possibilita realizar filtro por faixa do período do Movimento ou do Registro. Data que delimita o período da Consulta de Boletos liquidados, Baixados ou Protestados.
 
'''Situação do Boleto:''' filtro com duas opções:
 
'''A - Em ser (abertos):''' listam os registros que se encontram com Status "Abertos" no Banco.
 
'''B - Baixadas/Protestados/Liquidados:''' listam os registros que se encontram com Status "Baixados/Protestados/Liquidados".
 
'''Cód. Situação Atual Boleto:''' listagem para realizar filtro através do Código da Situação do Boleto no Banco conforme layout.
 
<center>'''Rotina Rotina Retorno de Cobrança Open Banking guia Parâmetros'''
[[Arquivo:Retorno_Boletos_Open_Banking_V3.png|750x500px|semmoldura|nenhum|Retorno_Boletos_Open_Banking_2]]
 
 

'''Tipo de Retorno:''' há 3 opções para o retorno.
 
'''* Listagem:''' quando selecionado essa opção, ao executar a rotina, apenas listará o status do registro do Boleto Bancário junto ao Banco.
 
'''* Retorno:''' quando selecionado essa opção, ao executar a rotina, o sistema irá executar o retorno dos registros confirmados e já irá realizar a liquidação caso haja registros pagos, sem executar a listagem.
 
'''* Ambos:''' quando selecionado essa opção irá executar tanto a opção de "Listagem" quanto a opção de "Retorno".
 
'''Portador para Liquidação:''' este campo tem como finalidade informar qual será o Portador utilizado para os registros que serão liquidados. Caso não seja informado nenhum Portador neste campo, será utilizado o Portador de Retorno parametrizado para Open Banking.
 
'''Portador Carteira de Desconto:''' este campo é para informar o Portador de Carteira de Desconto, para Contratos Bancários, para os registros que possuem Duplicatas negociadas com o Banco.
 
'''Histórico de Liquidação:''' campo para informar o Histórico que será utilizado para os registros que serão liquidados.
 
'''Não contabilizar Juros e Descontos nas liquidações da Carteira Descontada:''' esta opção tem como finalidade não contabilizar os Juros e Descontos para as liquidações de Carteira Descontada, ou seja, caso possua duplicatas com o Banco negociada e o registro possuir Juros, Desconto, possibilita o usuário não contabiliza-los marcando esta opção.
 
'''Não gerar lançamentos de tarifa de cobrança:''' esta opção tem como finalidade quando selecionada não gerar a liquidação do valor da tarifa de cobrança.
 
'''Data para Liquidação:''' quando zerado a Data será habilitado para selecionar as opções. Esta opção tem como finalidade realizar a busca para liquidação de duas formas:
 
- '''Ocorrência:''' os títulos serão liquidados com a Data de Ocorrência do Título (Data Recebimento do Título) ao qual foi processado no Banco.
 
- '''Crédito:''' os títulos serão liquidados com a Data de Crédito (Data de Crédito Liquidação) em que foi processado no Banco.
Ou seja, se o título foi pago por exemplo na Data 31/08/2020 o banco irá processar esse pagamento e o retorno será creditado na conta no dia 01/09/2020, porém o pagamento foi realizado no dia anterior e creditado no dia posterior.
 
A Data para Liquidação é trazida por padrão a Data atual como sugestão, sendo possível altera-lá ou quando zerada habilita para buscar automaticamente a Data de Ocorrência ou Crédito.
 
 
'''Modelo de Relatório:''' o modelo de relatório utilizado pode ser obtido através do caminho padrão.
Nome do Modelo: (RF00071_remessas).
<center>'''Relatório Retorno Bancário Online'''
[[Arquivo:Relat Retorno Bancario Online.png|750x500px|semmoldura|nenhum|Relat_Retorno_Bancario_Online]]
 
 
Ao acessar o Lançamento Financeiro após o Retorno de Cobrança Open Banking, realizando as liquidações o sistema altera o status do Lançamento Financeiro.
 
'''Menu: Finanças > Gestão Financeira > Movimentos > Lançamentos'''
 
<center>'''Lançamento Financeiro Liquidado através da Rotina de Cobrança Open Banking'''
[[Arquivo:Lançamento Liquidado Retorno.png|750x500px|nenhum|Lançamento_Liquidado_Retorno.png]]
 

='''Como realizar a Alteração de Vencimento do Lançamento já Registrado Open Banking e reenviá-lo novamente?'''=

Irá surgir a necessidade de realizar a alteração do Vencimento do Lançamento Financeiro já registrado pelo Open Banking, qual é o passo a passo para proceder diante dessa modificação?
 
'''Dado que''' já temos um Lançamento Financeiro já Registrado Open Banking, basta acessar o Lançamento Financeiro desejado através do caminho do Menu:
 
'''Menu > Finanças > Gestão Financeira > Movimentos > Lançamentos'''
 
Acessar o Lançamento Financeiro em modo Modificar e alterar o campo "Venc.Original", automaticamente após alteração do Vencimento, o sistema insere o Comando "05" no campo "Comando de Remessa" e diante disso já emite uma mensagem:
 
'''Confirma o envio da alteração do título ao banco?'''
 
'''Importante:''' para o envio da alteração do Vencimento o sistema já considera o campo '''Vencimento''', caso seja utilizado a '''Modalidade''' como '''Seguinte''' por exemplo, onde é possível ter um Vencimento Original diferente do Vencimento.
 
<center>'''Lançamento Financeiro a Receber já Registrado'''
[[Arquivo:AlterarVenc Lanc1.png|750x500px|nenhum|AlterarVenc_Lanc1]]
 
 
Vencimento alterado, sistema insere o Comando "05" no campo "Comando de Remessa" e ao salvar o registro é emitido a mensagem: "Confirma o envio da alteração do título ao banco?"
 
<center>'''Vencimento alterado e registro salvo'''
[[Arquivo:Vencimento Alterado Msn.png|750x500px|nenhum|Vencimento_Alterado_Msn]]
 
'''Sim:''' é enviado o registro de alteração do Open Banking e se registrado com sucesso, sistema retira então o Comando de Remessa.
 
<center>'''Processo Concluído com Sucesso'''
[[Arquivo:Processo_Concluido_Sucesso_Lanc.png|750x500px|nenhum|Processo_Concluido_Sucesso_Lanc]]
 
Há possibilidades do tempo de comunicação com API do Banco não retornar imediatamente a confirmação do recebimento da Alteração do Vencimento. Quando ocorrer essa situação, sistema emite uma mensagem, solicitando aguardar, para tentar novamente o envio da alteração do vencimento.
Quando ocorrer essa situação, será necessário aguardar e após realizar o envio novamente ou através do próprio Lançamento ou através da rotina de Remessa de Cobrança - Open Banking, que remeterá as alterações para o Banco.
<center>'''Processo Pendente Alteração - Aguardar'''
[[Arquivo:Alteração Vencimento Processo Pendente Envio Aguardar.png|750x500px|nenhum|Alteração_Vencimento_Processo_Pendente_Envio_Aguardar]]
 
Já quando selecionado a opção '''Não''':
 
'''Não:''' não faz a comunicação do envio da alteração do vencimento via Open Banking. Este registro não foi notificado, logo será necessário realiza-lo através do próprio Lançamento ou através da rotina de Remessa de Cobrança Open Banking.
 
No Lançamento Financeiro é habilitado o botão "Reenviar Registro" no Item de Categoria "Open Banking".
Quando selecionado o botão '''Registrar Alteração''', sistema faz a comunicação via Open Banking e registra alteração de vencimento realizada.
 
<center>'''Lançamento Não Registrado a alteração de Vencimento com o Comando de Remessa'''
[[Arquivo:Botao Registrar Alteracao Habilitado.png|750x500px|nenhum|Botao_Registrar_Alteracao_Habilitado]]
 
Ao selecionar o botão "Registrar Alteração" sistema emite a mensagem para confirmar o envio.
 
<center>'''Botão Registrar Alteração'''
[[Arquivo:Registrar Alteracao Selecionado.png|750x500px|nenhum|Registrar_Alteracao_Selecionado]]
 
Após a confirmação o sistema registra alteração
 
<center>'''Processo Concluído com Sucesso'''
[[Arquivo:Processo_Concluido_Sucesso_Lanc.png|750x500px|nenhum|Processo_Concluido_Sucesso_Lanc]]
 
 
<center>'''Lançamento alterado e registrado'''
[[Arquivo:Lançamento alterado registrado.png|750x500px|nenhum|Lançamento_alterado_registrado]]
 

='''Como realizar a Alteração de Multa do Lançamento já Registrado Open Banking e reenviá-lo novamente?'''=

'''Irá surgir a necessidade de realizar a alteração da Multa do Lançamento Financeiro já registrado pelo Open Banking, qual é o passo a passo para proceder diante dessa modificação?'''
 
Dado que já temos um Lançamento Financeiro já Registrado Open Banking, basta acessar o Lançamento Financeiro desejado através do caminho do Menu:
 
'''Menu > Finanças > Gestão Financeira > Movimentos > Lançamentos'''
 
'''Regra Sistema para Multa ou Juros:'''
 
Se no cadastro do Portador não possuir Comando de Remessa com as novas opções:
 
'''Tipo de Comando =''' Alteração de Multa para Multa
 
'''Tipo de Comando =''' Alteração de Juros para Juros
 
Ao acessar o Lançamento Financeiro em modo Modificar e alterar o campo '''Multa de''', automaticamente após alteração da Multa, o Sistema irá criar essa parametrização do Comando de Remessa com '''sugestão''', sendo passível de alteração, no Cadastro do Portador no botão '''Remessas''' e depois no botão '''Comandos'''.
 
'''Comando sugestão para Multa:'''
 
'''Código Operação =''' ATM
 
'''Comando =''' ATM
 
'''Descrição =''' ALTERAÇÃO DE MULTA PARA OPEN BANKING
 
'''Tipo de Comando =''' Alteração de Multa
 
 
<center>'''Cadastro do Portador Comando de Remessa Multa'''
[[Arquivo:Cadastro Portador Comando Remessa ATM.png|750x500px|nenhum|Cadastro_Portador_Comando_Remessa_ATM]]
 
 

'''Como é identificado a alteração da Multa para Banco?'''
 
Através das tags enviadas para API gravadas no Histórico do Open Banking Dados API:
 
'''indicadorCobrarMulta''':'''S''' – indica que há multa no registro.
 
'''indicadorDispensarMulta''': '''S''' – indica que a multa foi zerada e não há mais ocorrência de multa para o registro enviado.
 
'''tipoMulta''': 1, - indica que a Multa é maior que 0,01 centavo.
 
'''tipoMulta''': 0, - indica que a Multa é menor que 0,01 centavo não registrando a operação de multa.
 
'''valorMulta''': 0.44, - indica o valor da multa.
 
'''dataInicioMulta''': "23.09.2021", - indica a data do movimento da alteração da multa enviado.
 
 
<center>'''Lançamento Financeiro a Receber já Registrado alterando a Multa'''
[[Arquivo:Alteração Multa Lancto.png|750x500px|nenhum|Alteração_Multa_Lancto]]
 
 

Tags enviadas para API Banco:
 
 
<center>'''Dados API Tags referente a Multa'''
[[Arquivo:Lancto Registrado Alteração Multa Lancto.png|750x500px|nenhum|Lancto_Registrado_Alteração_Multa_Lancto]]
 
 

='''Como realizar a Alteração de Juros do Lançamento já Registrado Open Banking e reenviá-lo novamente?'''=

'''Irá surgir a necessidade de realizar a alteração de Juros do Lançamento Financeiro já registrado pelo Open Banking, qual é o passo a passo para proceder diante dessa modificação?'''
 
Dado que já temos um Lançamento Financeiro já Registrado Open Banking, basta acessar o Lançamento Financeiro desejado através do caminho do Menu:
 
'''Menu > Finanças > Gestão Financeira > Movimentos > Lançamentos'''
 
'''Regra Sistema para Multa ou Juros:'''
 
Se no cadastro do Portador não possuir Comando de Remessa com as novas opções:
 
'''Tipo de Comando =''' Alteração de Multa para Multa
 
'''Tipo de Comando =''' Alteração de Juros para Juros
 
Ao acessar o Lançamento Financeiro em modo Modificar e alterar o campo '''Juros Dias de''' ou '''Juros Mês de''', automaticamente após alteração dos Juros, o Sistema irá criar essa parametrização do Comando de Remessa com '''sugestão''', sendo passível de alteração, no Cadastro do Portador no botão '''Remessas''' e depois no botão '''Comandos'''.
 
'''Comando sugestão para Juros:'''
 
'''Código Operação =''' ATJ
 
'''Comando =''' ATJ
 
'''Descrição =''' ALTERAÇÃO DE JUROS PARA OPEN BANKING
 
'''Tipo de Comando =''' Alteração de Juros
 
 
<center>'''Cadastro do Portador Comando de Remessa Juros'''
[[Arquivo:Cadastro Portador Comando Remessa ATJ.png|750x500px|nenhum|Cadastro_Portador_Comando_Remessa_ATJ]]
 
 

'''Como é identificado a alteração de Juros para Banco?'''
 
Através das tags enviadas para API gravadas no Histórico do Open Banking Dados API:
 
'''indicadorCobrarJuros''':'''S''' – indica que há Juros no registro.
 
'''indicadorDispensarJuros''': '''S''' – indica que o Juros foi zerado e não há mais ocorrência de Juros para o registro enviado.
 
'''tipoJuros''': 1, - indica que os Juros é maior que 0,01 centavo.
 
'''tipoMulta''': 0, - indica que os Juros é menor que 0,01 centavo não registrando a operação de Juros.
 
'''valorJuros''': 0.46, - indica o valor dos Juros.
 
 
<center>'''Lançamento Financeiro a Receber já Registrado alterando os Juros'''
[[Arquivo:Lancto Registrado Alteração Juros Dia.png|750x500px|nenhum|Lancto_Registrado_Alteração_Juros_Dia]]
 
 

Tags enviadas para API Banco:
 
 
<center>'''Dados API Tags referente aos Juros''
[[Arquivo:Dados API Juros.png|750x500px|nenhum|Dados_API_Juros]]
 
 

='''Como realizar a Alteração dos 3 juntos (Vencimento/Juros/Multa) do Lançamento já Registrado Open Banking e reenviá-lo novamente?'''=

Irá surgir a necessidade de realizar a alteração do Vencimento do Lançamento Financeiro já registrado pelo Open Banking, qual é o passo a passo para proceder diante dessa modificação?
 
'''Dado que''' já temos um Lançamento Financeiro já Registrado Open Banking, basta acessar o Lançamento Financeiro desejado através do caminho do Menu:
 
'''Menu > Finanças > Gestão Financeira > Movimentos > Lançamentos'''
 
Acessar o Lançamento Financeiro em modo Modificar e alterar o campo "Venc.Original", automaticamente após alteração do Vencimento, o sistema insere o Comando "05" no campo "Comando de Remessa" e diante disso já emite uma mensagem:
 
'''Confirma o envio da alteração do título ao banco?'''
 
'''Importante:''' para o envio da alteração do Vencimento o sistema já considera o campo '''Vencimento''', caso seja utilizado a '''Modalidade''' como '''Seguinte''' por exemplo, onde é possível ter um Vencimento Original diferente do Vencimento.
 
<center>'''Lançamento Financeiro a Receber já Registrado'''
[[Arquivo:AlterarVenc Lanc1.png|750x500px|nenhum|AlterarVenc_Lanc1]]
 
 
Vencimento alterado, sistema insere o Comando "05" no campo "Comando de Remessa" e ao salvar o registro é emitido a mensagem: "Confirma o envio da alteração do título ao banco?"
 
<center>'''Vencimento alterado e registro salvo'''
[[Arquivo:Vencimento Alterado Msn.png|750x500px|nenhum|Vencimento_Alterado_Msn]]
 
'''Sim:''' é enviado o registro de alteração do Open Banking e se registrado com sucesso, sistema retira então o Comando de Remessa.
 
<center>'''Processo Concluído com Sucesso'''
[[Arquivo:Processo_Concluido_Sucesso_Lanc.png|750x500px|nenhum|Processo_Concluido_Sucesso_Lanc]]
 
Há possibilidades do tempo de comunicação com API do Banco não retornar imediatamente a confirmação do recebimento da Alteração do Vencimento. Quando ocorrer essa situação, sistema emite uma mensagem, solicitando aguardar, para tentar novamente o envio da alteração do vencimento.
Quando ocorrer essa situação, será necessário aguardar e após realizar o envio novamente ou através do próprio Lançamento ou através da rotina de Remessa de Cobrança - Open Banking, que remeterá as alterações para o Banco.
<center>'''Processo Pendente Alteração - Aguardar'''
[[Arquivo:Alteração Vencimento Processo Pendente Envio Aguardar.png|750x500px|nenhum|Alteração_Vencimento_Processo_Pendente_Envio_Aguardar]]
 
Já quando selecionado a opção '''Não''':
 
'''Não:''' não faz a comunicação do envio da alteração do vencimento via Open Banking. Este registro não foi notificado, logo será necessário realiza-lo através do próprio Lançamento ou através da rotina de Remessa de Cobrança Open Banking.
 
No Lançamento Financeiro é habilitado o botão "Reenviar Registro" no Item de Categoria "Open Banking".
Quando selecionado o botão '''Registrar Alteração''', sistema faz a comunicação via Open Banking e registra alteração de vencimento realizada.
 
<center>'''Lançamento Não Registrado a alteração de Vencimento com o Comando de Remessa'''
[[Arquivo:Botao Registrar Alteracao Habilitado.png|750x500px|nenhum|Botao_Registrar_Alteracao_Habilitado]]
 
Ao selecionar o botão "Registrar Alteração" sistema emite a mensagem para confirmar o envio.
 
<center>'''Botão Registrar Alteração'''
[[Arquivo:Registrar Alteracao Selecionado.png|750x500px|nenhum|Registrar_Alteracao_Selecionado]]
 
Após a confirmação o sistema registra alteração
 
<center>'''Processo Concluído com Sucesso'''
[[Arquivo:Processo_Concluido_Sucesso_Lanc.png|750x500px|nenhum|Processo_Concluido_Sucesso_Lanc]]
 
 
<center>'''Lançamento alterado e registrado'''
[[Arquivo:Lançamento alterado registrado.png|750x500px|nenhum|Lançamento_alterado_registrado]]
 

='''Quais são as novidades após atualização para Versão 2 do Open Banking?'''=

Disponibilizado a Versão 2 para Open Banking que traz algumas novidades para o processo de Registro no Banco.
 
'''Para começar o que devo fazer para atualizar para Versão 2 do Open Banking?'''
 
Simples, basta atualizar com a versão que contempla a'''OS 664835/1'''.
 
Nela terá um componente que quando atualizado a Base através do Assistente de Atualização (Atualiza CIGAM) será adicionado nos Parâmetros Open Banking da Configuração de Bancos, especificamente nas Credenciais, o registro '''Versão API''' = v2.
 
'''Finanças > Gestão Financeira > Parâmetros > Configurações de Bancos'''
 
<center>'''Parâmetros Open Banking'''
[[Arquivo:Parametros OP V2 Credenciais.png|750x500px|nenhum|Parametros_OP_V2_Credenciais]]
 
A partir desta Versão o Sistema passa a realizar a busca para localizar os títulos da seguinte forma:
 
1- O sistema tenta localizar os títulos pelo Número do Lançamento;
 
2- Caso os títulos tenham sido gerados pelo CIGAM irá localizar pelo '''Nosso Número''', avaliando então a tabela '''GFBOLETOS''' pela coluna '''NOSSO_NRO'''.
 
3- Caso os títulos tenham sido gerados por outro sistema irá localizar pelo '''Nosso Número''', avaliando então a tabela '''GFLAUXIL''' pela coluna '''CODIGO_BARRAS'''.
 
Também nesta versão estão disponíveis as tags para Envio da Série/NF, sendo utilizado a Tag na API '''NumeroTituloBeneficiario'''. A regra é '''Serie''' '''NF''' '''Complemento Duplicata''', bem como descrito com espaços em Branco entre eles. Para verificar esse registro, basta acessar após o Registro no Banco o Histórico Open Banking na guia '''Envio''' e localizar para Tag '''NumeroTituloBeneficiario'''.
 
<center>'''Quais são as mudanças ocorridas no Assistente de Parâmetros de Convênio Open Banking?'''
 
Para o Scope foi adicionado um novo complemento para atender ao PIX, logo o Scope passa a ficar desta forma por padrão:
 
'''cobrancas.boletos-requisicao cobrancas.boletos-info payments.transfer-batch-request payments.transfers-info payments.batch-slips payments.batch-barcode-collection-form-request cob.write cob.read pix.read pix.write'''
 
Copie e cole no campo Scope esse dado.
 
<center>'''Parâmetros de Convênio Open Banking'''
[[Arquivo:Wizard passo 3 de 4 Direto PIX.png|750x500px|nenhum|Wizard_passo_3_de_4_Direto_PIX]]
 
Atualizado Wizard para Versão 2 do Open Banking, disponibilizando duas opções:
 
'''- Direto''': esta opção tem como finalidade registrar o Boleto no momento da sua geração, ou seja, quando selecionado ativa propriedade ao qual ao gerar o Boleto Bancário o sistema automaticamente envia o registro Open Banking, sem a necessidade de fazer o processo de envio da Remessa Open Banking do título.
 
'''- PIX''': esta opção fica habilitada somente quando selecionado a opção '''Direto''', ela tem como finalidade registrar uma operação PIX para os Boletos emitido de forma Direta (opção '''Direto''' marcado).
 
Esta opção é válida '''SOMENTE''' para o Banco do Brasil.
 
Ao emitir o Boleto do Lançamento o sistema marca as 3 opções:
 
- Boleto Impresso;
 
- Remessa Enviada;
 
- Código de Barras Lido;
 
Outra mudança é no '''Histórico''' Open Banking, ao qual passa criar o registro com '''Status Open Banking''' já '''Registrado'''.
 
Também ao acessar os '''Dados API''' é enviado a tag: "indicadorPix": "S", pois a opção PIX esta selecionada.
 
Disponibilizado o Modelo de Relatório para o Boleto Banco do Brasil já com o QRCode:
 
'''I:\CIGAM\DOC\Modelos_relatorios\Gestão Financeira\Bloquetos Merge\0098_brasil_PIX.rtf'''

='''Como realizar a Baixa de um Lançamento Financeiro Registrado Open Banking e enviar o Registro de Baixa?'''=

'''IMPORTANTE:''' O processo de Cancelamento de Notas Fiscais, não atende a baixa automatica dos Boletos, logo deve ser baixado manualmente os registros dos Lançamentos Financeiros.
 
 
Para realizar o processo de '''Baixa''' de um Lançamento Financeiro que foi registrado via Open Banking, basta acessar o Lançamento Financeiro.
 
'''Menu > Finanças > Gestão Financeira > Movimentos > Lançamentos'''
 
Selecionar a opção de Menu Lateral do Lançamento Financeiro '''Open Banking''' e a opção de '''Baixar'''.
 
<center>'''Lançamento Financeiro Registrado/Baixar'''
[[Arquivo:Opção Baixar Lancto.png|750x500px|nenhum|Opção_Baixar_Lancto]]
 
<center>'''Lançamento Financeiro Confirmando Operação'''
[[Arquivo:Deseja Baixar.png|750x500px|nenhum|Deseja_Baixar]]
 
<center>'''Lançamento Financeiro Baixado com Sucesso'''
[[Arquivo:Baixado Sucesso.png|750x500px|nenhum|Baixado_Sucesso]]
 
Agora basta acessar a rotina de Retorno de Cobrança Open Banking através do Menu:
 
'''Menu > Finanças > Gestão Financeira > Rotinas > Operacionais > Open Banking > Retorno de Cobrança Open Banking '''
 
Modelo de Relatório utilizado:
 
%CIGAM_INSTAL%\Modelos_relatorios\Gestão Financeira\RF00071_remessas.RTF
 
<center>'''Retorno de Cobrança Open Banking'''
[[Arquivo:Retorno OP Baixado.png|750x500px|nenhum|Retorno_OP_Baixado]]
 
<center>'''Retorno de Cobrança Open Banking'''
[[Arquivo:Retorno OP Baixado Verso.png|750x500px|nenhum|Retorno_OP_Baixado_Verso]]
 
Após confirmado a rotina emite a Listage de Retorno com o título baixado registrado.
 
<center>'''Listagem_Retorno_Bancario_Online'''
[[Arquivo:Listagem Retorno Bancario Online.png|750x500px|nenhum|Listagem_Retorno_Bancario_Online]]
 
Com isso para validar o Retorno da API do Banco é gravado no Histórico Open Banking do Lançamento Financeiro.
 
Acessando Lançamento Financeiro:
 
<center>'''Listagem_Retorno_Bancario_Online'''
[[Arquivo:Lancamento Financeiro Historico.png|750x500px|nenhum|Lancamento_Financeiro_Historico]]
 
<center>'''Acessando Dados API do Lançamento Financeiro'''
[[Arquivo:Dados API Lancto.png|750x500px|nenhum|Dados_API_Lancto]]
 
O sistema grava para '''Envio''' seguinte mensagem:
 
'''BAIXADO PELO PROCESSO DE RETORNO, CÓDIGO DE BAIXA: BAIXADO POR SOLICITACAO'''
 
<center>'''Acessando Dados API do Lançamento Financeiro'''
[[Arquivo:Dados API Envio Baixado.png|750x500px|nenhum|Dados_API_Envio_Baixado]]
 

='''Como realizar a Variação do Tipo de Cobrança de Simples para Vinculada?'''=

Conforme layout do Banco para Open Banking para diferenciar o Tipo de Cobrança:
 
'''1- Cobrança Simples'''
 
'''4- Cobrança Vinculada'''
 
Para realizar este processo no Sistema deve ser parametrizado no Cadastro do Portador com a seguinte regra de sistema:
 
Tudo que for diferente de 4 (Cobrança Vinculada) será considerado 1 (Cobrança Simples), ou seja, caso seja deixado em Branco ou informado qualquer número diferente de 4 o sistema irá considerar sempre 1.
 
'''Menu > Finanças > Gestão Financeira > Parâmetros > Portadores'''
 
O Campo considerado para esta informação é o '''Identificação do serviço''' na guia '''CNAB'''.
 
<center>'''1- Cobrança Simples'''
[[Arquivo:Cadastro Portador Cobranca Simples.png|750x500px|nenhum|Cadastro_Portador_Cobranca_Simples]]
 

<center>'''4- Cobrança Vinculada'''
[[Arquivo:Cadastro Portador Cobranca Vinculada 4.png|750x500px|nenhum|Conbranca_Vinculada]]
 

='''Como parametrizar para envio Open Banking a Negativação ou Protesto?'''=

Para enviar um '''PROTESTO''':
 
Basta acessar o Cadastro do Portador e inserir os dias no campo '''Protestar após''' na guia '''Configurações.
 

'''Menu > Finanças > Gestão Financeira > Parâmetros > Portadores'''

 
<center>'''Dias de Protesto Cadastro do Portador'''
[[Arquivo:Cadastro Portador Negativacao BB5.png|750x500px|nenhum|Cadastro_Portador_Negativacao_BB5]]
 

Quando se tratar de '''Protesto''' o sistema deve enviar as tags para API do Banco da seguinte forma:
 
Setar os dias conforme parametrização no Cadastro do Portador na tag '''"quantidadeDiasProtesto": "1",''' e na tag '''"quantidadeDiasNegativacao": "0",'''.
 
Exemplo de envio da API:
 
'''"quantidadeDiasProtesto": "1",'''
 
'''"quantidadeDiasNegativacao": "0",'''
 

Já para enviar uma '''NEGATIVAÇÃO''':
 
Basta acessar o Cadastro do Portador e inserir os dias no campo '''Negativar após''' na guia '''Configurações.
 

'''Menu > Finanças > Gestão Financeira > Parâmetros > Portadores'''

 
<center>'''Dias de Protesto Cadastro do Portador'''
[[Arquivo:Cadastro Portador Negativacao BB.png|750x500px|nenhum|Cadastro_Portador_Negativacao_BB]]
 

Quando se tratar de '''Negativação''' o sistema deve enviar as tags para API do Banco da seguinte forma:
 
Setar os dias conforme parametrização no Cadastro do Portador e nas tags deve ser zerado '''"quantidadeDiasProtesto": "0",''' e na tag '''"quantidadeDiasNegativacao": "7",''' e deve conter o órgão negativador na tag '''"orgaoNegativador": "10",''', sendo SERASA = 10 .
 
Exemplo de envio da API:
 
'''"quantidadeDiasProtesto": "0",'''
 
'''"quantidadeDiasNegativacao": "7",'''
 
'''"orgaoNegativador": "10",'''

='''Como cadastrar as Mensagens de Retorno API Financeira Sugestão Usuário?'''=

As Mensagens de Retorno API Financeira é uma funcionalidade para facilitar a identificar e de orientação para com as mensagens provindas das APIs que o Sistema tem conexão.
 
Elas foram implementadas para Open banking.
 
Para acessar o cadastro basta acessar através do Menu:
 
'''Menu: Finanças > Gestão Financeira > Parâmetros > Mensagens de Retorno API Financeiro'''
 

<center>'''Mensagens de Retorno API Financeiro'''
[[Arquivo:Mensagens Retorno API Financeiro.png|750x500px|nenhum|Mensagens_Retorno_API_Financeiro]]
 

'''Banco:''' código do Banco conforme codificação no orgão que rege os Bancos Febraban.
 
'''Código Erro:''' código do erro conforme layout das APIS dos Bancos.
 
'''Status:''' é o código de Status de erro do Servidor retornado da API dos Bancos. (Código HTTP)
 
'''Descrição do Erro (Banco):''' essa descrição é oriunda do Banco retornada pela API deles.
 
'''Sugestão CIGAM:''' esta mensagem é interna do Sistema, ou seja, quando internamente identificarmos uma situação a qual a Mensagem retornada pelo Banco não é clara, vamos alimentar com Mensagens de sugestão, para orientar as possíveis causas, dando um norte para situação.
 
'''Sugestão Cliente:''' este campo é reservado para o próprio usuário, possibilitando cadastrar Mensagens que ele identificar para facilitar no processo de entendimento das Mensagens de Retorno das APIs.
 
Agora através desta aplicação, quando ocorrer um Erro de Open Banking é possível verificar através dos links dispostos na tela de Lançamento Financeiro no campo Situação Open Banking, terá um link para tabela do erro ocorrido.
 
<center>'''Lançamento Financeiro Mensagens de Retorno API Financeiro'''
[[Arquivo:Mensagens Retorno API Financeiro BB OP.png|750x500px|nenhum|Mensagens_Retorno_API_Financeiro_BB_OP]]
 
Ou também através do Histórico Open Banking:
 
<center>'''Lançamento Financeiro Mensagens de Retorno API Financeiro Histórico Open Banking'''
[[Arquivo:Historico OP Mensagens Retorno API Financeiro BB OP.png|750x500px|nenhum|Historico_OP_Mensagens_Retorno_API_Financeiro_BB_OP]]

='''Não Escopo Retorno Open Banking Cartório?'''=

Referente ao retorno para liquidação em Cartório, o Banco tem uma limitação e não foi desenvolvido ainda por parte do Banco na API, as custas e tarifas de Cartório, impossibilitando o Sistema realizar essa liquidação.
 
A sugestão para registros de Cartório é realizar via Remessa de CNAB de Retorno manual, até o Banco do Brasil liberar essa funcionalidade na API.

Como Fazer Finanças

2022-07-20T11:43:45Z

Claudia.Felles:

<DynamicPageList>
category = Como_Fazer_Finanças
ordermethod = sortkey
order = ascending

</DynamicPageList>

Como Fazer Finanças

2022-07-20T11:37:48Z

Claudia.Felles:

GF - Como Fazer - Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria

2022-07-07T17:37:01Z

Claudia.Felles: /* Quais são as parametrizações necessárias para utilizar a Funcionalidade Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria? */

[[categoria:Como_Fazer_Finanças]]

=='''O que é a Conciliação Automática do CIGAM?'''==

A Conciliação Automática nada mais é que uma rotina facilitadora para auxiliar no processo financeiro de conferência do Extrato Bancário.
Através desta rotina é possível bater as informações dos débitos e créditos do Extrato do Banco com os registros (Lançamentos da base ou fazer a criação deles através da rotina).
Este manual tem como objetivo demonstrar como é realizado o processo de criação do Lançamento Financeiro através da rotina.

=='''Quais os Módulos necessários para utilizar a Funcionalidade Conciliação Automática”?'''==

• Módulo Gestão Financeira;

=='''Quais são as parametrizações necessárias para utilizar a Funcionalidade Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria?'''==
 
'''OBSERVAÇÃO:''' A rotina não atende arquivos OFX.
 
Para utilizar esta funcionalidade é necessário possuir no Cadastro do Portador as Categorias parametrizadas bem como os Modelos de Lançamentos para cada Categoria.
 
'''Menu > Finanças > Gestão Financeira > Parâmetros > Portadores'''
 
Este cadastro é apenas uma demonstração de parametrização, neste cadastro é possível parametrizar vários registros para mesma Categoria variando os Históricos do Banco e os Modelos de Lançamento. Em casos de mesma categoria para liberação e bloqueio, deve-se cadastrar apenas a categoria referente ao bloqueio, respeitando sua descrição e marcando o checkbox "Desconsiderar", já a liberação entrará automaticamente no extrato como um movimento, não necessitando tal parametrização.
 
É através do campo "Histórico Banco" que o sistema identifica automaticamente os Modelos de Lançamentos parametrizados.
Essa descrição deve ser uma cópia autêntica da descrição provinda do arquivo Extrato importado.
 
É um campo chave para estar realizando a identificação do Modelo de Lançamento a ser utilizado nos registros importados.
 
<center>'''Cadastro de Portador botão "Conciliação"'''
[[Arquivo:Cadastro Portador Botão Conciliação.png|750x500px|semmoldura|nenhum|Cadastro_Portador_Botão_Conciliação]]
 
'''Portador:''' informar o Portador desejado ou apenas deixar em Branco para criar um registro genérico. A parametrização para outros Portadores, pode ser realizada no próprio Cadastro de Configuração de Bancos.
 
'''Banco:''' informar o código do Banco a ser configurado.
 
'''Categoria:''' informar o código de Categoria conforme o layout Febraban ou o próprio Layout do Banco.
 
'''Histórico Banco:''' informar a codificação passada pelo Banco.
 
'''Descrição:''' informar a codificação passada pelo Banco.
 
'''Modelo:''' informar a codificação passada pelo Banco.

=='''Como é realizado esse processo da Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria ?'''==
 
 Após realizado a parametrização será demonstrado como sistema se comporta para a busca da variação dos Modelos de Lançamentos para os registros importados de mesma Categoria.
 
Acessar o Menu:
 
'''Menu > Finanças > Gestão Financeira > Rotinas > EDI > Recebe > Extrato Bancário Personalizado'''
 
Nesta tela é necessário informar o Modelo do Portador, juntamente com EDI parametrizado.
 
Informar o arquivo txt a ser importado no campo "Arquivo Importar" e confirmar a operação.
 
<center>'''CNAB Retorno Extrato Bancário -Personalizado"'''
[[Arquivo:CNAB Retorno Extrato Bancário - Personalizado.png|750x500px|semmoldura|nenhum|CNAB Retorno Extrato Bancário - Personalizado]]
 
 
Confirmar a operação nesta mensagem:
 
<center>'''CNAB Retorno Extrato Bancário -Personalizado_Mensagem'''
[[Arquivo:1-Mensagem Extrato Bancario.png|750x500px|semmoldura|nenhum|1-Mensagem_Extrato_Bancario]]
 
Nesta tela será listado os Portadores encontrados com Status na "cor verde" e para seguir o processo, basta confirmar a operação.
 
<center>'''Portadores Encontrados'''
[[Arquivo:Portadores Encontrados.png|750x500px|semmoldura|nenhum|Portadores_Encontratos]]
 
Nesta etapa sistema lista o que já foi identificado, caso já seja a primeira importação não será listado como status vermelho, mas se for a segunda importação e o registro constar em ambos arquivos, sistema informa com status em vermelho, alertando se deseja excluir e importar novamente, ou simplesmente não excluir e importar.
 
<center>'''Registros Extrato'''
[[Arquivo:Registros Extrato.png|750x500px|semmoldura|nenhum|Registros_Extrato]]
 
Após importação e confirmação o sistema passa a identificar através das parametrizações realizadas da mesma Categoria variando os Modelos de Lançamento buscando através do campo "Histórico do Banco" conforme descrição do arquivo a ser importado.
Através deste processo que os registros que não estão criado no sistema, a rotina irá criar conforme os Modelos de Lançamentos.
 
<center>'''Criação de Lançamentos Extrato'''
[[Arquivo:Criação de Lançamentos Extrato.png|750x500px|semmoldura|nenhum|Criação de Lançamentos Extrato]]

GF - Como Fazer - Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria

2022-07-07T17:36:20Z

[[categoria:Como_Fazer_Finanças]]

=='''O que é a Conciliação Automática do CIGAM?'''==

A Conciliação Automática nada mais é que uma rotina facilitadora para auxiliar no processo financeiro de conferência do Extrato Bancário.
Através desta rotina é possível bater as informações dos débitos e créditos do Extrato do Banco com os registros (Lançamentos da base ou fazer a criação deles através da rotina).
Este manual tem como objetivo demonstrar como é realizado o processo de criação do Lançamento Financeiro através da rotina.

=='''Quais os Módulos necessários para utilizar a Funcionalidade Conciliação Automática”?'''==

• Módulo Gestão Financeira;

=='''Quais são as parametrizações necessárias para utilizar a Funcionalidade Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria?'''==
 
'''OBSERVAÇÃO:''' A rotina não atende arquivos OFX.
 
Para utilizar esta funcionalidade é necessário possuir no Cadastro do Portador as Categorias parametrizadas bem como os Modelos de Lançamentos para cada Categoria.
 
'''Menu > Finanças > Gestão Financeira > Parâmetros > Portadores'''
 
Este cadastro é apenas uma demonstração de parametrização, neste cadastro é possível parametrizar vários registros para mesma Categoria variando os Históricos do Banco e os Modelos de Lançamento. Em casos de mesma categoria para liberação ou bloqueio, deve-se cadastrar apenas a categoria referente ao bloqueio, respeitando sua descrição e marcando o checkbox "Desconsiderar", já a liberação entrará automaticamente no extrato como um movimento, não necessitando tal parametrização.
 
É através do campo "Histórico Banco" que o sistema identifica automaticamente os Modelos de Lançamentos parametrizados.
Essa descrição deve ser uma cópia autêntica da descrição provinda do arquivo Extrato importado.
 
É um campo chave para estar realizando a identificação do Modelo de Lançamento a ser utilizado nos registros importados.
 
<center>'''Cadastro de Portador botão "Conciliação"'''
[[Arquivo:Cadastro Portador Botão Conciliação.png|750x500px|semmoldura|nenhum|Cadastro_Portador_Botão_Conciliação]]
 
'''Portador:''' informar o Portador desejado ou apenas deixar em Branco para criar um registro genérico. A parametrização para outros Portadores, pode ser realizada no próprio Cadastro de Configuração de Bancos.
 
'''Banco:''' informar o código do Banco a ser configurado.
 
'''Categoria:''' informar o código de Categoria conforme o layout Febraban ou o próprio Layout do Banco.
 
'''Histórico Banco:''' informar a codificação passada pelo Banco.
 
'''Descrição:''' informar a codificação passada pelo Banco.
 
'''Modelo:''' informar a codificação passada pelo Banco.

=='''Como é realizado esse processo da Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria ?'''==
 
 Após realizado a parametrização será demonstrado como sistema se comporta para a busca da variação dos Modelos de Lançamentos para os registros importados de mesma Categoria.
 
Acessar o Menu:
 
'''Menu > Finanças > Gestão Financeira > Rotinas > EDI > Recebe > Extrato Bancário Personalizado'''
 
Nesta tela é necessário informar o Modelo do Portador, juntamente com EDI parametrizado.
 
Informar o arquivo txt a ser importado no campo "Arquivo Importar" e confirmar a operação.
 
<center>'''CNAB Retorno Extrato Bancário -Personalizado"'''
[[Arquivo:CNAB Retorno Extrato Bancário - Personalizado.png|750x500px|semmoldura|nenhum|CNAB Retorno Extrato Bancário - Personalizado]]
 
 
Confirmar a operação nesta mensagem:
 
<center>'''CNAB Retorno Extrato Bancário -Personalizado_Mensagem'''
[[Arquivo:1-Mensagem Extrato Bancario.png|750x500px|semmoldura|nenhum|1-Mensagem_Extrato_Bancario]]
 
Nesta tela será listado os Portadores encontrados com Status na "cor verde" e para seguir o processo, basta confirmar a operação.
 
<center>'''Portadores Encontrados'''
[[Arquivo:Portadores Encontrados.png|750x500px|semmoldura|nenhum|Portadores_Encontratos]]
 
Nesta etapa sistema lista o que já foi identificado, caso já seja a primeira importação não será listado como status vermelho, mas se for a segunda importação e o registro constar em ambos arquivos, sistema informa com status em vermelho, alertando se deseja excluir e importar novamente, ou simplesmente não excluir e importar.
 
<center>'''Registros Extrato'''
[[Arquivo:Registros Extrato.png|750x500px|semmoldura|nenhum|Registros_Extrato]]
 
Após importação e confirmação o sistema passa a identificar através das parametrizações realizadas da mesma Categoria variando os Modelos de Lançamento buscando através do campo "Histórico do Banco" conforme descrição do arquivo a ser importado.
Através deste processo que os registros que não estão criado no sistema, a rotina irá criar conforme os Modelos de Lançamentos.
 
<center>'''Criação de Lançamentos Extrato'''
[[Arquivo:Criação de Lançamentos Extrato.png|750x500px|semmoldura|nenhum|Criação de Lançamentos Extrato]]

GF - Como Fazer - Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria

2022-07-07T17:32:03Z

[[categoria:Como_Fazer_Finanças]]

=='''O que é a Conciliação Automática do CIGAM?'''==

A Conciliação Automática nada mais é que uma rotina facilitadora para auxiliar no processo financeiro de conferência do Extrato Bancário.
Através desta rotina é possível bater as informações dos débitos e créditos do Extrato do Banco com os registros (Lançamentos da base ou fazer a criação deles através da rotina).
Este manual tem como objetivo demonstrar como é realizado o processo de criação do Lançamento Financeiro através da rotina.

=='''Quais os Módulos necessários para utilizar a Funcionalidade Conciliação Automática”?'''==

• Módulo Gestão Financeira;

=='''Quais são as parametrizações necessárias para utilizar a Funcionalidade Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria?'''==
 
'''OBSERVAÇÃO:''' A rotina não atende arquivos OFX.
 
Para utilizar esta funcionalidade é necessário possuir no Cadastro do Portador as Categorias parametrizadas bem como os Modelos de Lançamentos para cada Categoria.
 
'''Menu > Finanças > Gestão Financeira > Parâmetros > Portadores'''
 
Este cadastro é apenas uma demonstração de parametrização, neste cadastro é possível parametrizar vários registros para mesma Categoria variando os Históricos do Banco e os Modelos de Lançamento. Em casos de mesma categoria para liberação ou bloqueio, deve-se cadastrar apenas a categoria referente ao bloqueio respeitando sua descrição, pois a liberação entrará automaticamente no extrato como um movimento.
 
É através do campo "Histórico Banco" que o sistema identifica automaticamente os Modelos de Lançamentos parametrizados.
Essa descrição deve ser uma cópia autêntica da descrição provinda do arquivo Extrato importado.
 
É um campo chave para estar realizando a identificação do Modelo de Lançamento a ser utilizado nos registros importados.
 
<center>'''Cadastro de Portador botão "Conciliação"'''
[[Arquivo:Cadastro Portador Botão Conciliação.png|750x500px|semmoldura|nenhum|Cadastro_Portador_Botão_Conciliação]]
 
'''Portador:''' informar o Portador desejado ou apenas deixar em Branco para criar um registro genérico. A parametrização para outros Portadores, pode ser realizada no próprio Cadastro de Configuração de Bancos.
 
'''Banco:''' informar o código do Banco a ser configurado.
 
'''Categoria:''' informar o código de Categoria conforme o layout Febraban ou o próprio Layout do Banco.
 
'''Histórico Banco:''' informar a codificação passada pelo Banco.
 
'''Descrição:''' informar a codificação passada pelo Banco.
 
'''Modelo:''' informar a codificação passada pelo Banco.

=='''Como é realizado esse processo da Conciliação Automática (Extrato Bancário Personalizado) variação de Modelos de Lançamentos para mesma Categoria ?'''==
 
 Após realizado a parametrização será demonstrado como sistema se comporta para a busca da variação dos Modelos de Lançamentos para os registros importados de mesma Categoria.
 
Acessar o Menu:
 
'''Menu > Finanças > Gestão Financeira > Rotinas > EDI > Recebe > Extrato Bancário Personalizado'''
 
Nesta tela é necessário informar o Modelo do Portador, juntamente com EDI parametrizado.
 
Informar o arquivo txt a ser importado no campo "Arquivo Importar" e confirmar a operação.
 
<center>'''CNAB Retorno Extrato Bancário -Personalizado"'''
[[Arquivo:CNAB Retorno Extrato Bancário - Personalizado.png|750x500px|semmoldura|nenhum|CNAB Retorno Extrato Bancário - Personalizado]]
 
 
Confirmar a operação nesta mensagem:
 
<center>'''CNAB Retorno Extrato Bancário -Personalizado_Mensagem'''
[[Arquivo:1-Mensagem Extrato Bancario.png|750x500px|semmoldura|nenhum|1-Mensagem_Extrato_Bancario]]
 
Nesta tela será listado os Portadores encontrados com Status na "cor verde" e para seguir o processo, basta confirmar a operação.
 
<center>'''Portadores Encontrados'''
[[Arquivo:Portadores Encontrados.png|750x500px|semmoldura|nenhum|Portadores_Encontratos]]
 
Nesta etapa sistema lista o que já foi identificado, caso já seja a primeira importação não será listado como status vermelho, mas se for a segunda importação e o registro constar em ambos arquivos, sistema informa com status em vermelho, alertando se deseja excluir e importar novamente, ou simplesmente não excluir e importar.
 
<center>'''Registros Extrato'''
[[Arquivo:Registros Extrato.png|750x500px|semmoldura|nenhum|Registros_Extrato]]
 
Após importação e confirmação o sistema passa a identificar através das parametrizações realizadas da mesma Categoria variando os Modelos de Lançamento buscando através do campo "Histórico do Banco" conforme descrição do arquivo a ser importado.
Através deste processo que os registros que não estão criado no sistema, a rotina irá criar conforme os Modelos de Lançamentos.
 
<center>'''Criação de Lançamentos Extrato'''
[[Arquivo:Criação de Lançamentos Extrato.png|750x500px|semmoldura|nenhum|Criação de Lançamentos Extrato]]

GF Importar EDIFIN

2022-06-30T17:27:38Z

Claudia.Felles: /* Registro de Impostos de Retenção */

[[Finanças]] >
[[GF_Gestão Financeira|Gestão Financeira]] >
[[GF_Rotinas|Rotinas]] >
[[GF_Rotinas_EDI|EDI]] >
[[GF_Rotinas_EDI_Recebe|Recebe]] >
[[GF_Importar EDIFIN|Importar EDIFIN]]
 
 
==Importar EDIFIN==

Rotina utilizada para liquidar Lançamentos a “Receber” e para importar arquivos de Lançamentos do Tipo ‘Pagar’ com ‘Situação’ em ‘Aberto’ com vínculo de retenções de impostos(ex.: IR, ICMS, COFINS,....).
 
 
===Guia Geral===
 
[[Image:Importgf.png|center|semmoldura|650px|Importa EDIFIN]]
 
 
====Grupo Arquivo a ser Importado=====

====Grupo salvar arquivo Processado em====

====Grupo Lançamentos====

====Grupo Deferimentos====

====Grupo Exclusão com Documento Informado====

====Grupo Exclusão com Remessa enviada Marcada====

==== Grupo Na Liquidação considerar do arquivo====

====Liquidação de Lançamentos a Receber====

A rotina de importação de EDIFIN permite operações de ‘B’aixa para lançamentos de ‘Previsão’ de ‘Contratos’ que não geram faturamento, fazendo com que o sistema mude o lançamento para efetivo e efetua a liquidação normalmente.
 
 
Obs.: Uma vez já importado Lançamento de Liquidação, o mesmo não será feito duas vezes, para não haver duplicidade de Lançamentos Liquidados, apenas para juros, multa, outras despesas e/ou desconto.
 
 

===Guia Retenção/Ordem de Serviço===
 
[[Image:Retordemgf.png|center|semmoldura|650px|Importa EDIFIN]]
===Grupo Retenção===
===Grupo Ordem de Serviço===
====Lançamentos com vínculo de retenções de impostos====
Para a criação de retenção de impostos, conforme cada Lançamento, o checkbox ‘Gerar Lançamento de Retenção’ NÃO poderá estar marcado. E para verificar as posições da(s) linha(s) de retenção de impostos, no arquivo, olhar o layout que se encontra em I:\CIGAM\DOC\EDI\ EDIFIN Lançamentos Financeiros 8i.
 
 
Obs.: para o campo ‘Alíquota’, caso estiver com porcentagem zerada no arquivo, será utilizado o percentual informado na retenção do Código do Imposto, no Cadastro de Impostos, com exceção do imposto de retenção do tipo ‘Efetivo’, que sempre pegará a porcentagem informada no Código do Imposto.Para os demais impostos, entretanto, se ambos estiverem com alíquota zerada, dará mensagem de erro.

==Botões==
'''Botão Confirmar:'''
 
 
'''Botão Cancelar:'''



='''Layout EDIFIN'''=

=='''Lançamentos'''==
<center>
{| class="wikitable"
|-
! Linha !! Campo !! Atributo !! Máscara !! Posição !! Faixa Válida !! Comentários
|-
| 1 || Tipo Registro || Car || 1A || 1 a 1 || "'''L'''" ||
|-
| 2 || Operação || Car || 1A || 3 a 3 || "'''I'''"nclusão; "'''E'''"xclusão; "'''B'''"aixa.
|| Ver em [[#Observações|observações]]
|-
| 3 || Lançamento || Num || ########A || 5 a 16 || || • Inclusão = 0 ou o número; • Exclusão e Baixa = obrigatório informar o nº do lançamento ou do Documento.
|-
| 4 || Data || Data || ##/##/##A || 18 a 25 || || Emissão ou Data da Liquidação (Baixa).
|-
| 5 || Vencimento || Data || ##/##/##A || 27 a 34 || ||
|-
| 6 || NF || Num || 10A || 36 a 45 || ||
|-
| 7 || Fatura || Num || 10A || 47 a 56 || ||
|-
| 8 || Complemento || Car || 5A || 58 a 62 || || Parcela. Ex.:"1/4"
|-
| 9 || Codigo Historico || Car || UUUA || 64 a 66 || ||
|-
| 10 || Histórico || Memo || 201 || 68 a 268 || ||
|-
| 11 || Conta || Car || UU.UU.UUA || 270 a 277 || ||
|-
| 12 || Tipo || Car || XA || 279 a 279 || "'''R'''"eceber; "'''c'''"Recebido; "'''P'''"agar; "'''d'''"Pago; "'''E'''"ntrada; "'''S'''"aida.
|| • Exclusão e Baixa = "branco"; • Inclusão= "R", "P", "E" ou "S".
|-
| 13 || Valor || Num || N11.2CA || 281 a 298 || ||
|-
| 14 || Empresa || Car || UUUUUUA || 300 a 305 || ||
|-
| 15 || Cobranca || Car || UUUUUUA || 307 a 312 || ||
|-
| 16 || Cheque || Num || 9A || 314 a 322 || ||
|-
| 17 || Portador || Car || UUUA || 324 a 326 || ||
|-
| 18 || Emissão || Data || ##/##/##A || 328 a 335 || ||
|-
| 19 || C_Partida || Num || ########A || 337 a 348 || || • Exclusão = Cpartida; • Inclusão e Baixa = 0.
|-
| 20 || Saldo || Num || N11.2CA || 350 a 367 || ||
|-
| 21 || Conferido || Car || 1A || 369 a 369 || || "branco"
|-
| 22 || Campo20 || Num || 3.2A || 371 a 376 || || 0
|-
| 23 || Situação || Car || UA || 378 a 378 || [[#Faixas Válidas - Campo: Situação|Clique aqui]] para visualizar as Faixas. || • Inclusão = informar situação,; • Exclusão=”branco”; • Baixa=”L”.
|-
| 24 || Conciliado || Car || UA || 380 a 380 || || "branco"
|-
| 25 || Série || Car || UUUUUA || 382 a 386 || ||
|-
| 26 || Contabilizado || Car || UA || 388 a 388 || " " a Contabilizar; "'''C'''"ontabilizado; "'''A'''"bertura; "'''N'''"ão Contabilizar.
||
|-
| 27 || Usuário || Car || 3A || 390 a 392 || || "branco"
|-
| || '''Modificação'''
|-
| 28 || Tipo de Pagamento || Car || 2A || 394 a 395 || ||
|-
| 29 || Numero no Banco || Car || 15A || 397 a 411 || ||
|-
| 30 || Campo 28 || Num || N11.2CA || 413 a 430 || || 0
|-
| 31 || Juros Dia || Num || N11.2CA || 432 a 449 || ||
|-
| 32 || Ultima Liquidação || Data || ##/##/##A || 451 a 458 || || "branco"
|-
| 33 || Unidade de Negocio || Car || 3A || 460 a 462 || ||
|-
| 34 || Documento || Car || 12A || 464 a 475 || || Informar um código único identificador do lançamento, obrigatório quando não informado o nº do lançamento e desejar excluir, modificar ou informar rateios.
|-
| 35 || Tipo Documento || Car || UA || 477 a 477 || [[#Faixas Válidas - Campo: Tipo Documento|Clique aqui]] para visualizar as Faixas. || Caso seja informado Documento informar também o tipo, caso contrário = "branco".
|-
| 36 || Valor Indexado || Num || N10.5CA || 479 a 498 || || 0
|-
| 37 || Saldo Indexado || Num || N10.5CA || 500 a 519 || || 0
|-
| 38 || Tolerância Vencimento || Num || 3A || 521 a 523 || ||
|-
| 39 || Campo37 || Num || N3.2%A || 525 a 531 || ||
|-
| 40 || Valor Multa || Num || N11.2CA || 533 a 550 || ||
|-
| 41 || Tolerância Multa || Num || 3A || 552 a 554 || ||
|-
| 42 || Tolerância Juros || Num || 3A || 556 a 558 || ||
|-
| 43 || Campo41 || Num || N3.2%A || 560 a 566 || || 0
|-
| 44 || Tipo Juros || Car || UA || 568 a 568 || "'''S'''"imples; "'''C'''"omposto. ||
|-
| 45 || Valor Desconto || Num || N11.2CA || 570 a 587 || ||
|-
| 46 || Lançamento Vinculado || Num || ########A || 589 a 600 || || 0
|-
| 47 || Data Inclusão || Data || ##/##/##A || 602 a 609 || || "branco"
|-
| 48 || Sacador Avalista || Car || UUUUUUA || 611 a 616 || || "branco"
|-
|
|-
| 49 || Modalidade || Car || UA || 618 a 618 || "'''V'''"ista; "'''A'''"presentação; " " Prazo; "'''E'''"ntrada.
|| 0
|-
| 50 || Modalidade Pagamento || Car || UA || 620 a 620 || " " Exato; "'''A'''"nterior; "'''S'''"eguinte; "'''P'''"revisto. ||
|-
| 51 || Espécie Documento || Car || 2A || 622 a 623 || || "branco"
|-
| 52 || Vencimento || Data || ##/##/##A || 625 a 632 || ||
|-
| || '''Original'''
|-
| 53 || Projeto || Car || 12A || 634 a 645 || || "branco"
|-
| 54 || Campo52 || Car || 8A || 647 a 654 || || "branco"
|-
| 55 || Índice || Car || UUUUUA || 656 a 660 || ||
|-
| 56 || Bloqueto Impresso || Logical || 1A || 662 a 662 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 57 || Duplicata Impressa || Logical || 1A || 664 a 664 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 58 || Remessa enviada || Logical || 1A || 666 a 666 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 59 || Autorizado Por || Car || 3A || 668 a 670 || || "branco"
|-
| 60 || Autorizado Em || Data || ##/##/##A || ##/##/##A || || "branco"
|-
| 61 || Data Modificação || Data || ##/##/##A || 681 a 688 || || "branco"
|-
| 62 || Usuário Criação || Car || 3A || 690 a 692 || || "branco"
|-
| 63 || Sessão || Num || 8A || 694 a 701 || || 0
|-
| 64 || Campo60 || Data || ##/##/##A || 703 a 710 || || "branco"
|-
| 65 || Campo61 || Data || ##/##/##A || 712 a 719 || || "branco"
|-
| 66 || Campo62 || Data || ##/##/##A || 721 a 728 || || "branco"
|-
| 67 || Campo63 || Data || ##/##/##A || 730 a 737 || || "branco"
|-
| 68 || Campo64 || Car || UUUUUUA || 739 a 744 || || "branco"
|-
| 69 || Campo65 || Car || UUUUUUA || 746 a 751 || || "branco"
|-
| 70 || Campo66 || Car || UUUUUUA || 753 a 758 || || "branco"
|-
| 71 || Campo67 || Car || UUUUUUA || 760 a 765 || || "branco"
|-
| 72 || Ordem Endereço Cobrança || Car || UA || 767 a 767 || ||
|-
| 73 || Campo69 || Car || UA || 769 a 769 || || "branco"
|-
| 74 || Pagamento || Car || UA || 771 a 771 || "'''L'''"iberado; "'''B'''"loqueado; "'''A'''"utorizado. || “branco”
|-
| 75 || Listar DAÍ || Car || 2A || 773 a 774 || " "Não; "'''A'''"bertura NF; "'''S'''"im. || "branco"
|-
| 76 || Código de Barras Lido || Car || 2A || 776 a 777 || "'''S'''" e "'''N'''" || "N"
|-
| 77 || Data DIRF || Car || 2A || 779 a 780 || || "branco"
|-
| 78 || Campo74 || Car || 3A || 782 a 784 || || "branco"
|-
| 79 || Campo75 || Car || 3A || 786 a 788 || || "branco"
|-
| 80 || Ordem Conta Corrente || Car || 3A || 790 a 792 || ||
|-
| 81 || Previsão || Logical || 1ª || 794 a 794 || "'''S'''"im e "'''N'''"ão ||
|-
| 82 || Listar DIRF || Logical || 1ª || 796 a 796 || "'''S'''"im e "'''N'''"ão || "N"
|-
| 83 || Possui Cheques Títulos || Logical || 1ª || 798 a 798 || "'''S'''"im e "'''N'''"ão || "N"
|-
| 84 || Sequência || Num || N8.6CA || 800 a 817 || || 0
|-
| 85 || Campo81 || Num || N8.6CA || 819 a 836 || || 0
|-
| 86 || Campo82 || Num || N11.2CA || 838 a 855 || || 0
|-
| 87 || Campo83 || Num || N11.2CA || 857 a 874 || || 0
|-
| 88 || Campo84 || Num || N11.2CA || 876 a 893 || || 0
|-
| 89 || Campo85 || Num || N11.2CA || 895 a 912 || || 0
|-
| 90 || Sessão || Car || 20ª || 914 a 933 || || "branco"
|-
| || '''Operador'''
|-
| 91 || Campo87 || Car || Car || 935 a 954 || || "branco"
|-
| 92 || Hora Criação || Time || HH:MM:SS || 956 a 963 || || "branco"
|-
| 93 || Usrlanc1 || Car || 20 || 965 a 984 || || "branco"
|-
| 94 || Usrlanc2 || Data || ##/##/##A || 986 a 993 || || "branco"
|-
| 95 || Usrlanc3 || Num || N11.2CA || 995 a 1012 || || 0
|-
| 96 || Numero OS || Num || 6P0 || 1014 a 1019 || ||
|-
| 97 || Item OS || Num || 3 || 1021 a 1023 || ||
|-
| 98 || Valor Juros || Num || 13.2CA || 1025 a 1044 || || Somente Liquidação
|-
| 99 || Valor Multa || Num || 13.2CA || 1046 a 1065 || || Somente Liquidação
|-
| 100 || Outras Despesas || Num || 11.2CA || 1067 a 1083 || || Somente Liquidação
|-
| 101 || Valor Desconto || Num || 11.2CA || 1085 a 1101 || || Somente Liquidação
|-
| 102 || Autorizacao Cartao || Car || 25A || 1103 a 1127 || ||
|-
| 103 || NSU_Autenticacao Bancaria || Car || 25A || 1129 a 1153 || ||
|-
|}

==='''Faixas Válidas - Campo: Situação'''===

• "'''A'''"berto
 
• "'''B'''"onificação
 
• "'''C'''"artório
 
• "'''D'''"evolvido
 
• "'''E'''"xecutado
 
• "'''I'''"nadimplente
 
• "'''J'''"uros/CM/Multa
 
• "'''L'''"iquidado
 
• "'''P'''"rotestado
 
• "'''U'''"nificado
 
• "'''X'''" Adiantado
 
• "'''R'''"etenção
 
• "'''S'''"aldo Inicial

==='''Faixas Válidas - Campo: Tipo Documento'''===

• "'''P'''"edido;
 
• "'''O'''"rdem;
 
• " " Geral;
 
• "'''U'''"nificado;
 
• "'''C'''"ontrato;
 
• "'''F'''"olha;
 
• "'''A'''"grupado;
 
• "'''D'''"evolução;
 
• "'''R'''"etenção;
 
• "'''M'''" Diferimento.

==='''Observações'''===

Entre cada campo deve haver um caracter de espaço (ASC 32)
Utilizar vírgula como separador decimal nos valores, sendo opcional o separador de milhar (‘ponto’) (Ex: 1234,56 ou 1.234,56)
Utilizar barras simples para separar dia, mês e ano (Ex.: 25/04/01)
Utilizar dois pontos para separar hora, minuto e segundo (Ex.:12:35:56)
Os campos livres (CampoXX ou UsrXX) são opcionais, não necessitam de preenchimento, no caso, utilizar espaços ou omitir quando (últimos campos).
A Situação na inclusão depende do tipo.
Não existe tratamento para baixa parcial
Quanto a Operação de Exclusão: Quando a exclusão for pelo Número do Documento verificar opções de Exclusão na tela, pois está leva em consideração o Tipo e a Contabilização do Lançamento. O Padrão é ‘Aberto’ e ‘Não
Contabilizado’. Quando não informado registro de Rateio, será gerado o rateio Padrão conforme o Tipo
e Situação do Lançamento.

=='''Rateios Contábeis/Gerenciais/Diferimento'''==
<center>
{| class="wikitable"
|-
! Linha !! Nome Campo !! Atributo !! Faixa Válida !! Máscara !! Nova Posição Inicial !! Comentário
|-
| 1 || Tipo Registro || A || "'''R'''" (rateio) "'''D'''" (Diferimento) || 1 || 1 a 1 ||
|-
| 2 || Lançamento || N || || 8 || 3 a 14 ||
|-
| 3 || Reduzido Contábil || A || || UUUUUU || 16 a 21 || Código Contábil
|-
| 4 || % Contábil || N || || 3,8 || 23 a 34 ||
|-
| 5 || Conta Gerencial || A || || UUUUUU || 36 a 41 ||
|-
| 6 || % Gerencial || N || || 3.8 || 43 a 54 ||
|-
| 7 || Data || D || || DD/MM/AA || 56 a 63 ||
|-
| 8 || Tipo Documento || A || " " Geral || UA || 65 a 65 || "branco"
|-
| 9 || Documento || A || || 12A || 67 a 78 ||
|-
|}
</center>

É obrigatório ser informado o nº do Lançamento ou o Documento. Se Lançamento e Documento estiver
em branco irá assumir o último número de Lançamento gerado para o último Registro de Lançamento
importado. Somente para registro = "R". Se o registro "R" não for enviado logo após o registro "L"
correspondente, o rateio será criado conforme o rateio "Padrão" conforme as regras de contabilização de
acordo com o Tipo e Situação do Lançamento. Os registros de Rateios podem ser informados abaixo de
cada registro "L" correspondente.
 
Se Lançamento e Documento estiver em branco irá assumir o último número de Lançamento gerado para o último Registro de Lançamento importado.
 
 
'''Ex.'''
<ul><pre>
L I 000012345600 24/04/07
R 000012345600 666666 100,00000000
L I 000012345601 24/04/07
R 000012345601 777777 100,00000000
</pre></ul>

Podem ser gerados todos os registros "R" no final do arquivo após os registros de lançamentos. Neste
caso devem ser informados os números dos lançamentos/documentos correspondentes
 
<ul><pre>
L I 000012345600 24/04/07
L I 000012345601 24/04/07
R 000012345600 666666 100,00000000
R 000012345601 777777 100,00000000
</pre></ul>

Em ambos os formatos de importação, prevalecerá o rateio indicado no arquivo. Para os lançamentos
que não possuírem registros de rateio, será gerado o rateio conforme o rateio padrão de acordo com a
parametrização de cada lançamento.
 
 
'''Diferimentos:'''
 
Os diferimentos são informados no EDI com o tipo de registro "D" (Diferimento). Quando é lido este
registro, o sistema passa a gerar dois novos lançamentos financeiros vinculados ao original da seguinte
forma:
 
• "Tipo Documento" = "M" Diferimento
 
• "Documento" = <Número do lançamento original>
 
Serão gerados um lançamento de entrada e outro de saída, com o lançamento vinculado um apontando
para o outro.
 
O valor desses lançamentos será igual ao valor do lançamento original multiplicado pelo percentual de
diferimento. A data será de acordo com a data informada no registro de diferimento.
O portador, a conta e o histórico ficarão conforme definido na regra. Para contas a receber, o rateio do
lançamento de saída será igual ao original e o lançamento de entrada conforme o que vem no EDI. Para
contas a pagar a regra é invertida.

=='''Comissões'''==
<center>
{| class="wikitable"
|-
! Linha !! Nome do Campo !! Atributo !! Faixa Válida !! Máscara !! Posição !! Comentário
|-
| 1 || Tipo Registro || A || "C" || 1 || 1 a 1 || "C"
|-
| 2 || Lançamento || N || || 8 || 3 a 14 ||
|-
| 3 || Representante || A || || UUUUUU || 16 a 21 ||
|-
| 4 || Comissão (%) || N || || 3.7 || 23 a 34 || %
|-
| 5 || Tipo Documento || A || " "Geral || UA || 36 a 36 || "branco"
|-
| 6 || Documento || A || || 12A || 38 a 49 ||
|-
|}
</center>

'''Atenção:''' É obrigatório ser informado o nº do Lançamento ou o Documento.

=='''CONSISTÊNCIAS: Faixa válida'''==
<center>
{| class="wikitable"
|-
| 1 || Tipo de lançamento: "L", "R", "D" ou "C".
|-
| 2 || Operação: "I", "E" ou "B"
|-
| 3 || Data: Diferente de zero
|-
| 4 || Vencimento: Diferente de zero e maior do que a emissão.
|-
| 5 || Tipo de lançamento: "R", "c", "P", "d", "E" ou "S"
|-
| 6 || Valor : Maior do que zero
|-
| 7 || Empresa: Empresa cadastrada
|-
| 8 || Cobrança: Cobrança cadastrada
|-
| 9 || Emissão: Diferente de zero
|-
| 10 || Saldo: Menor ou igual ao Valor
|-
| 11 || Situação: "A", "B", "C", "D", "E", "I", "J", "L", "P", "U", "X", "R" ou "S".
|-
| 12 || Contabilizado: " ", "A", "C" ou "N"
|-
| 13 || Tipo de Pagamento: Tipo cadastrado
|-
| 14 || U.N.: U.N. cadastrada
|-
| 15 || Tipo Documento: " ", "P", "O" ou "U"
|-
| 16 || Tipo Juros: " ", "S" ou "C"
|-
| 17 || Modalidade Vencimento: " ", "V" ou "A"
|-
| 18 || Modalidade Pagamento: " ", "A", "S" ou "P"
|-
| 19 ||Previsão: "S" ou "N"
|-
| 20 || Listar Dirf: "S" ou "N"
|-
| 21 || Reduzido Contábil: Reduzido Contábil cadastrado
|-
| 22 || Rateio Contábil: Maior que zero até 100
|-
| 23 || Reduzido Gerencial: Reduzido Gerencial cadastrado
|-
| 24 || Rateio Gerencial: Maior que zero até 100
|-
| 25 || Representante: Representante cadastrado
|-
| 26 || Percentual de Comissão: Maior que zero até 100
|-
|}
</center>

Para contas a receber, o rateio do lançamento de saída será igual ao original e o lançamento de entrada
conforme o que vem no EDI. Para contas a pagar a regra é invertida.

=='''Registro RENEGOCIAÇÃO '''==

'''OBSERVAÇÃO:''' Não Tratado.
<center>
{| class="wikitable"
|-
! Linha !! Nome do Campo !! Atributo !! Máscara !! Posição !! Faixa Válida !! Comentários
|-
| 001 || Tipo Registro || Car || 1 || 1 A 1 || "'''N'''" ||
|-
| 002 || Operação || Car || 1 || 3 A 3 || '''A'''=Acréscimo '''D'''=Desconto '''U'''=Unificação ||
|-
| 003 || Modelo Lançamento || Car || 5 || 5 A 9 || || Código do modelo de lançamento a ser criado conforme o valor de acréscimo.
|-
| 004 || Valor Acréscimo/Desconto || Num || 1.2 || 11 a 24 || || Valor de acréscimo/Desconto na negociação. Diferença entre o Valor Negociado e a soma dos lançamentos envolvidos.
|-
| 005 || Data Negociação || Data || DD/MM/AA || 26 A 33 || || Data da geração do novo compromisso
|-
| 006 || Vencimento || Data || DD/MM/AA || 35 A 42 || || Vencimento do novo compromisso
|-
| 007 || Valor Negociado || Num || 11.2 || 44 a 57 || || Novo valor
|-
| 008 || Código Histórico || Car || UUU || 59 a 61|| ||
|-
| 009 || Complem.Histórico || Memo || 201 || 63 a 263 || ||
|-
| 010 || Conta Financeira || Car || UU.UU.UU || 265 a 272 || ||
|-
| 011 || Portador || Car || UUU || 274 a 276 || ||
|-
| 012 || Contabilizado || Car || U || 278 a 278 || " " a Contabilizar; "'''C'''"ontabilizado; "'''A'''"bertura; "'''N'''"ão Contabilizar. ||
|-
| 013 || Fatura || Num || 10 || 280 a 289 || ||
|-
| 014 || Complemento || Car || 5 || 291 a 295 || || Parcela Ex.:"1/4"
|-
| 015 || Tipo de Pagamento || Car || 2 || 297 a 298 || ||
|-
| 016 || Numero no Banco || Car || 15 || 300 a 314 || ||
|-
| 017 || Atualizar Unidade Negócio || Car || U || 316 a 316 || '''I''' = Informar '''O''' = Original '''P''' = Padrão ||
|-
| 018 || Unidade de Negocio || Car || 3 || 318 a 320 || Informar se a opção anterior for "'''I'''" = Informar ||
|-
| 019 || Documento || Car || 12 || 322 a 333 || ||
|-
| 020 || Tolerância Vencimento || Num || 3A || 335 a 337 || ||
|-
| 021 || Juros Dia || Num || N11.2CA || 339 a 352 || || Para o lançamento a receber
|-
| 022 || Valor Multa || Num || N11.2CA || 354 a 367 || || Para o lançamento a receber
|-
| 023 || Tolerância Multa || Num || 3A || 369 a 371 || || Para o lançamento a receber
|-
| 024 || Tolerância Juros || Num || 3A || 373 a 375 || || Para o lançamento a receber
|-
| 025 || Tipo Juros || Car || UA || 377 a 377 || "'''S'''"imples "'''C'''"omposto || Para o lançamento a receber
|-
| 026 || Valor Desconto || Num || N11.2CA || 379 a 392 || || Para o lançamento a receber
|-
| 027 || Modalidade Vencimento || Car || UA || 394 a 394 || "'''V'''"ista; "'''A'''"presentação; " " Prazo; "'''E'''"ntrada. ||
|-
| 028 || Modalidade Pagamento || Car || UA || 396 a 396 || " " Exato; "'''A'''"nterior; "'''S'''"eguinte; "'''P'''"revisto. ||
|-
| 029 || Buscar última fatura || Car || U || 398 a 398 || Sim Não ||
|-
| 030 || Parcelar Unificado || Car || U || 400 a 400 || Sim Não ||
|-
| 031 || Número de Parcelas || Num || 3 || 402 a 404 || ||
|-
| 032 || Periodicidade || Num || 3 || 406 a 408 || ||
|-
| 033 || Histórico Liquidação Originais || Car || UUU || 410 a 412 || ||
|-
| 034 || Portador Liquidação Originais || Car || UUU || 414 a 416 || ||
|-
|}
</center>

=='''Registro de Impostos de Retenção'''==

'''Importante:''' Para impostos cujo regime de pagamento esteja igual a "Efetivo" o sistema irá
validar apenas o código do imposto e o código DARF do arquivo. As outras informações do
arquivo cfe layout não serão validadas. Para esse regime, o sistema irá considerar as
informações cadastradas no programa Impostos e Contribuições.
 
{| class="wikitable"
|-
! Linha !! Nome do Campo !! Atributo !! Faixa Válida !! Máscara !! Posição !! Comentários
|-
| 001 || Tipo Registro || A || || || ||
|-
| 002 || Código do Imposto || A || Qualquer código de imposto cadastrado no CIGAM || 6A || 003 a 008 || Será validado na importação.
|-
| 003 || Código DARF || N || Qualquer código DARF cadastrado no Cigam || 4P0 || 010 a 013 || Será validado na importação.
|-
| 004 || Base Imposto || N || || 13.2CA || 015 a 030 || Caso for informado em branco ou zero será utilizado o próprio valor do lançamento
|-
| 005 || Alíquota do Imposto || N || || 3.2 || 032 a 037 || Caso for informado em branco ou zero será utilizada a alíquota informada no cadastro de Impostos e contribuições.
|-
| 006 || Valor do Imposto || N || || N11.2CA || 039 a 054 || Caso for deixado em branco será calculado conforme a Base de Imposto e a Alíquota.
|-
| 007 || Histórico || A || || 3A || 056 a 058 ||
|-
| 008 || Conta Financeira || A || || UU.UU.UU || 060 a 067 ||
|-
| 009 || Portador || A || || 3A || 069 a 071 ||
|-
|}

GF Importar EDIFIN

2022-06-30T17:27:01Z

Claudia.Felles: /* Registro de Impostos de Retenção */

[[Finanças]] >
[[GF_Gestão Financeira|Gestão Financeira]] >
[[GF_Rotinas|Rotinas]] >
[[GF_Rotinas_EDI|EDI]] >
[[GF_Rotinas_EDI_Recebe|Recebe]] >
[[GF_Importar EDIFIN|Importar EDIFIN]]
 
 
==Importar EDIFIN==

Rotina utilizada para liquidar Lançamentos a “Receber” e para importar arquivos de Lançamentos do Tipo ‘Pagar’ com ‘Situação’ em ‘Aberto’ com vínculo de retenções de impostos(ex.: IR, ICMS, COFINS,....).
 
 
===Guia Geral===
 
[[Image:Importgf.png|center|semmoldura|650px|Importa EDIFIN]]
 
 
====Grupo Arquivo a ser Importado=====

====Grupo salvar arquivo Processado em====

====Grupo Lançamentos====

====Grupo Deferimentos====

====Grupo Exclusão com Documento Informado====

====Grupo Exclusão com Remessa enviada Marcada====

==== Grupo Na Liquidação considerar do arquivo====

====Liquidação de Lançamentos a Receber====

A rotina de importação de EDIFIN permite operações de ‘B’aixa para lançamentos de ‘Previsão’ de ‘Contratos’ que não geram faturamento, fazendo com que o sistema mude o lançamento para efetivo e efetua a liquidação normalmente.
 
 
Obs.: Uma vez já importado Lançamento de Liquidação, o mesmo não será feito duas vezes, para não haver duplicidade de Lançamentos Liquidados, apenas para juros, multa, outras despesas e/ou desconto.
 
 

===Guia Retenção/Ordem de Serviço===
 
[[Image:Retordemgf.png|center|semmoldura|650px|Importa EDIFIN]]
===Grupo Retenção===
===Grupo Ordem de Serviço===
====Lançamentos com vínculo de retenções de impostos====
Para a criação de retenção de impostos, conforme cada Lançamento, o checkbox ‘Gerar Lançamento de Retenção’ NÃO poderá estar marcado. E para verificar as posições da(s) linha(s) de retenção de impostos, no arquivo, olhar o layout que se encontra em I:\CIGAM\DOC\EDI\ EDIFIN Lançamentos Financeiros 8i.
 
 
Obs.: para o campo ‘Alíquota’, caso estiver com porcentagem zerada no arquivo, será utilizado o percentual informado na retenção do Código do Imposto, no Cadastro de Impostos, com exceção do imposto de retenção do tipo ‘Efetivo’, que sempre pegará a porcentagem informada no Código do Imposto.Para os demais impostos, entretanto, se ambos estiverem com alíquota zerada, dará mensagem de erro.

==Botões==
'''Botão Confirmar:'''
 
 
'''Botão Cancelar:'''



='''Layout EDIFIN'''=

=='''Lançamentos'''==
<center>
{| class="wikitable"
|-
! Linha !! Campo !! Atributo !! Máscara !! Posição !! Faixa Válida !! Comentários
|-
| 1 || Tipo Registro || Car || 1A || 1 a 1 || "'''L'''" ||
|-
| 2 || Operação || Car || 1A || 3 a 3 || "'''I'''"nclusão; "'''E'''"xclusão; "'''B'''"aixa.
|| Ver em [[#Observações|observações]]
|-
| 3 || Lançamento || Num || ########A || 5 a 16 || || • Inclusão = 0 ou o número; • Exclusão e Baixa = obrigatório informar o nº do lançamento ou do Documento.
|-
| 4 || Data || Data || ##/##/##A || 18 a 25 || || Emissão ou Data da Liquidação (Baixa).
|-
| 5 || Vencimento || Data || ##/##/##A || 27 a 34 || ||
|-
| 6 || NF || Num || 10A || 36 a 45 || ||
|-
| 7 || Fatura || Num || 10A || 47 a 56 || ||
|-
| 8 || Complemento || Car || 5A || 58 a 62 || || Parcela. Ex.:"1/4"
|-
| 9 || Codigo Historico || Car || UUUA || 64 a 66 || ||
|-
| 10 || Histórico || Memo || 201 || 68 a 268 || ||
|-
| 11 || Conta || Car || UU.UU.UUA || 270 a 277 || ||
|-
| 12 || Tipo || Car || XA || 279 a 279 || "'''R'''"eceber; "'''c'''"Recebido; "'''P'''"agar; "'''d'''"Pago; "'''E'''"ntrada; "'''S'''"aida.
|| • Exclusão e Baixa = "branco"; • Inclusão= "R", "P", "E" ou "S".
|-
| 13 || Valor || Num || N11.2CA || 281 a 298 || ||
|-
| 14 || Empresa || Car || UUUUUUA || 300 a 305 || ||
|-
| 15 || Cobranca || Car || UUUUUUA || 307 a 312 || ||
|-
| 16 || Cheque || Num || 9A || 314 a 322 || ||
|-
| 17 || Portador || Car || UUUA || 324 a 326 || ||
|-
| 18 || Emissão || Data || ##/##/##A || 328 a 335 || ||
|-
| 19 || C_Partida || Num || ########A || 337 a 348 || || • Exclusão = Cpartida; • Inclusão e Baixa = 0.
|-
| 20 || Saldo || Num || N11.2CA || 350 a 367 || ||
|-
| 21 || Conferido || Car || 1A || 369 a 369 || || "branco"
|-
| 22 || Campo20 || Num || 3.2A || 371 a 376 || || 0
|-
| 23 || Situação || Car || UA || 378 a 378 || [[#Faixas Válidas - Campo: Situação|Clique aqui]] para visualizar as Faixas. || • Inclusão = informar situação,; • Exclusão=”branco”; • Baixa=”L”.
|-
| 24 || Conciliado || Car || UA || 380 a 380 || || "branco"
|-
| 25 || Série || Car || UUUUUA || 382 a 386 || ||
|-
| 26 || Contabilizado || Car || UA || 388 a 388 || " " a Contabilizar; "'''C'''"ontabilizado; "'''A'''"bertura; "'''N'''"ão Contabilizar.
||
|-
| 27 || Usuário || Car || 3A || 390 a 392 || || "branco"
|-
| || '''Modificação'''
|-
| 28 || Tipo de Pagamento || Car || 2A || 394 a 395 || ||
|-
| 29 || Numero no Banco || Car || 15A || 397 a 411 || ||
|-
| 30 || Campo 28 || Num || N11.2CA || 413 a 430 || || 0
|-
| 31 || Juros Dia || Num || N11.2CA || 432 a 449 || ||
|-
| 32 || Ultima Liquidação || Data || ##/##/##A || 451 a 458 || || "branco"
|-
| 33 || Unidade de Negocio || Car || 3A || 460 a 462 || ||
|-
| 34 || Documento || Car || 12A || 464 a 475 || || Informar um código único identificador do lançamento, obrigatório quando não informado o nº do lançamento e desejar excluir, modificar ou informar rateios.
|-
| 35 || Tipo Documento || Car || UA || 477 a 477 || [[#Faixas Válidas - Campo: Tipo Documento|Clique aqui]] para visualizar as Faixas. || Caso seja informado Documento informar também o tipo, caso contrário = "branco".
|-
| 36 || Valor Indexado || Num || N10.5CA || 479 a 498 || || 0
|-
| 37 || Saldo Indexado || Num || N10.5CA || 500 a 519 || || 0
|-
| 38 || Tolerância Vencimento || Num || 3A || 521 a 523 || ||
|-
| 39 || Campo37 || Num || N3.2%A || 525 a 531 || ||
|-
| 40 || Valor Multa || Num || N11.2CA || 533 a 550 || ||
|-
| 41 || Tolerância Multa || Num || 3A || 552 a 554 || ||
|-
| 42 || Tolerância Juros || Num || 3A || 556 a 558 || ||
|-
| 43 || Campo41 || Num || N3.2%A || 560 a 566 || || 0
|-
| 44 || Tipo Juros || Car || UA || 568 a 568 || "'''S'''"imples; "'''C'''"omposto. ||
|-
| 45 || Valor Desconto || Num || N11.2CA || 570 a 587 || ||
|-
| 46 || Lançamento Vinculado || Num || ########A || 589 a 600 || || 0
|-
| 47 || Data Inclusão || Data || ##/##/##A || 602 a 609 || || "branco"
|-
| 48 || Sacador Avalista || Car || UUUUUUA || 611 a 616 || || "branco"
|-
|
|-
| 49 || Modalidade || Car || UA || 618 a 618 || "'''V'''"ista; "'''A'''"presentação; " " Prazo; "'''E'''"ntrada.
|| 0
|-
| 50 || Modalidade Pagamento || Car || UA || 620 a 620 || " " Exato; "'''A'''"nterior; "'''S'''"eguinte; "'''P'''"revisto. ||
|-
| 51 || Espécie Documento || Car || 2A || 622 a 623 || || "branco"
|-
| 52 || Vencimento || Data || ##/##/##A || 625 a 632 || ||
|-
| || '''Original'''
|-
| 53 || Projeto || Car || 12A || 634 a 645 || || "branco"
|-
| 54 || Campo52 || Car || 8A || 647 a 654 || || "branco"
|-
| 55 || Índice || Car || UUUUUA || 656 a 660 || ||
|-
| 56 || Bloqueto Impresso || Logical || 1A || 662 a 662 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 57 || Duplicata Impressa || Logical || 1A || 664 a 664 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 58 || Remessa enviada || Logical || 1A || 666 a 666 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 59 || Autorizado Por || Car || 3A || 668 a 670 || || "branco"
|-
| 60 || Autorizado Em || Data || ##/##/##A || ##/##/##A || || "branco"
|-
| 61 || Data Modificação || Data || ##/##/##A || 681 a 688 || || "branco"
|-
| 62 || Usuário Criação || Car || 3A || 690 a 692 || || "branco"
|-
| 63 || Sessão || Num || 8A || 694 a 701 || || 0
|-
| 64 || Campo60 || Data || ##/##/##A || 703 a 710 || || "branco"
|-
| 65 || Campo61 || Data || ##/##/##A || 712 a 719 || || "branco"
|-
| 66 || Campo62 || Data || ##/##/##A || 721 a 728 || || "branco"
|-
| 67 || Campo63 || Data || ##/##/##A || 730 a 737 || || "branco"
|-
| 68 || Campo64 || Car || UUUUUUA || 739 a 744 || || "branco"
|-
| 69 || Campo65 || Car || UUUUUUA || 746 a 751 || || "branco"
|-
| 70 || Campo66 || Car || UUUUUUA || 753 a 758 || || "branco"
|-
| 71 || Campo67 || Car || UUUUUUA || 760 a 765 || || "branco"
|-
| 72 || Ordem Endereço Cobrança || Car || UA || 767 a 767 || ||
|-
| 73 || Campo69 || Car || UA || 769 a 769 || || "branco"
|-
| 74 || Pagamento || Car || UA || 771 a 771 || "'''L'''"iberado; "'''B'''"loqueado; "'''A'''"utorizado. || “branco”
|-
| 75 || Listar DAÍ || Car || 2A || 773 a 774 || " "Não; "'''A'''"bertura NF; "'''S'''"im. || "branco"
|-
| 76 || Código de Barras Lido || Car || 2A || 776 a 777 || "'''S'''" e "'''N'''" || "N"
|-
| 77 || Data DIRF || Car || 2A || 779 a 780 || || "branco"
|-
| 78 || Campo74 || Car || 3A || 782 a 784 || || "branco"
|-
| 79 || Campo75 || Car || 3A || 786 a 788 || || "branco"
|-
| 80 || Ordem Conta Corrente || Car || 3A || 790 a 792 || ||
|-
| 81 || Previsão || Logical || 1ª || 794 a 794 || "'''S'''"im e "'''N'''"ão ||
|-
| 82 || Listar DIRF || Logical || 1ª || 796 a 796 || "'''S'''"im e "'''N'''"ão || "N"
|-
| 83 || Possui Cheques Títulos || Logical || 1ª || 798 a 798 || "'''S'''"im e "'''N'''"ão || "N"
|-
| 84 || Sequência || Num || N8.6CA || 800 a 817 || || 0
|-
| 85 || Campo81 || Num || N8.6CA || 819 a 836 || || 0
|-
| 86 || Campo82 || Num || N11.2CA || 838 a 855 || || 0
|-
| 87 || Campo83 || Num || N11.2CA || 857 a 874 || || 0
|-
| 88 || Campo84 || Num || N11.2CA || 876 a 893 || || 0
|-
| 89 || Campo85 || Num || N11.2CA || 895 a 912 || || 0
|-
| 90 || Sessão || Car || 20ª || 914 a 933 || || "branco"
|-
| || '''Operador'''
|-
| 91 || Campo87 || Car || Car || 935 a 954 || || "branco"
|-
| 92 || Hora Criação || Time || HH:MM:SS || 956 a 963 || || "branco"
|-
| 93 || Usrlanc1 || Car || 20 || 965 a 984 || || "branco"
|-
| 94 || Usrlanc2 || Data || ##/##/##A || 986 a 993 || || "branco"
|-
| 95 || Usrlanc3 || Num || N11.2CA || 995 a 1012 || || 0
|-
| 96 || Numero OS || Num || 6P0 || 1014 a 1019 || ||
|-
| 97 || Item OS || Num || 3 || 1021 a 1023 || ||
|-
| 98 || Valor Juros || Num || 13.2CA || 1025 a 1044 || || Somente Liquidação
|-
| 99 || Valor Multa || Num || 13.2CA || 1046 a 1065 || || Somente Liquidação
|-
| 100 || Outras Despesas || Num || 11.2CA || 1067 a 1083 || || Somente Liquidação
|-
| 101 || Valor Desconto || Num || 11.2CA || 1085 a 1101 || || Somente Liquidação
|-
| 102 || Autorizacao Cartao || Car || 25A || 1103 a 1127 || ||
|-
| 103 || NSU_Autenticacao Bancaria || Car || 25A || 1129 a 1153 || ||
|-
|}

==='''Faixas Válidas - Campo: Situação'''===

• "'''A'''"berto
 
• "'''B'''"onificação
 
• "'''C'''"artório
 
• "'''D'''"evolvido
 
• "'''E'''"xecutado
 
• "'''I'''"nadimplente
 
• "'''J'''"uros/CM/Multa
 
• "'''L'''"iquidado
 
• "'''P'''"rotestado
 
• "'''U'''"nificado
 
• "'''X'''" Adiantado
 
• "'''R'''"etenção
 
• "'''S'''"aldo Inicial

==='''Faixas Válidas - Campo: Tipo Documento'''===

• "'''P'''"edido;
 
• "'''O'''"rdem;
 
• " " Geral;
 
• "'''U'''"nificado;
 
• "'''C'''"ontrato;
 
• "'''F'''"olha;
 
• "'''A'''"grupado;
 
• "'''D'''"evolução;
 
• "'''R'''"etenção;
 
• "'''M'''" Diferimento.

==='''Observações'''===

Entre cada campo deve haver um caracter de espaço (ASC 32)
Utilizar vírgula como separador decimal nos valores, sendo opcional o separador de milhar (‘ponto’) (Ex: 1234,56 ou 1.234,56)
Utilizar barras simples para separar dia, mês e ano (Ex.: 25/04/01)
Utilizar dois pontos para separar hora, minuto e segundo (Ex.:12:35:56)
Os campos livres (CampoXX ou UsrXX) são opcionais, não necessitam de preenchimento, no caso, utilizar espaços ou omitir quando (últimos campos).
A Situação na inclusão depende do tipo.
Não existe tratamento para baixa parcial
Quanto a Operação de Exclusão: Quando a exclusão for pelo Número do Documento verificar opções de Exclusão na tela, pois está leva em consideração o Tipo e a Contabilização do Lançamento. O Padrão é ‘Aberto’ e ‘Não
Contabilizado’. Quando não informado registro de Rateio, será gerado o rateio Padrão conforme o Tipo
e Situação do Lançamento.

=='''Rateios Contábeis/Gerenciais/Diferimento'''==
<center>
{| class="wikitable"
|-
! Linha !! Nome Campo !! Atributo !! Faixa Válida !! Máscara !! Nova Posição Inicial !! Comentário
|-
| 1 || Tipo Registro || A || "'''R'''" (rateio) "'''D'''" (Diferimento) || 1 || 1 a 1 ||
|-
| 2 || Lançamento || N || || 8 || 3 a 14 ||
|-
| 3 || Reduzido Contábil || A || || UUUUUU || 16 a 21 || Código Contábil
|-
| 4 || % Contábil || N || || 3,8 || 23 a 34 ||
|-
| 5 || Conta Gerencial || A || || UUUUUU || 36 a 41 ||
|-
| 6 || % Gerencial || N || || 3.8 || 43 a 54 ||
|-
| 7 || Data || D || || DD/MM/AA || 56 a 63 ||
|-
| 8 || Tipo Documento || A || " " Geral || UA || 65 a 65 || "branco"
|-
| 9 || Documento || A || || 12A || 67 a 78 ||
|-
|}
</center>

É obrigatório ser informado o nº do Lançamento ou o Documento. Se Lançamento e Documento estiver
em branco irá assumir o último número de Lançamento gerado para o último Registro de Lançamento
importado. Somente para registro = "R". Se o registro "R" não for enviado logo após o registro "L"
correspondente, o rateio será criado conforme o rateio "Padrão" conforme as regras de contabilização de
acordo com o Tipo e Situação do Lançamento. Os registros de Rateios podem ser informados abaixo de
cada registro "L" correspondente.
 
Se Lançamento e Documento estiver em branco irá assumir o último número de Lançamento gerado para o último Registro de Lançamento importado.
 
 
'''Ex.'''
<ul><pre>
L I 000012345600 24/04/07
R 000012345600 666666 100,00000000
L I 000012345601 24/04/07
R 000012345601 777777 100,00000000
</pre></ul>

Podem ser gerados todos os registros "R" no final do arquivo após os registros de lançamentos. Neste
caso devem ser informados os números dos lançamentos/documentos correspondentes
 
<ul><pre>
L I 000012345600 24/04/07
L I 000012345601 24/04/07
R 000012345600 666666 100,00000000
R 000012345601 777777 100,00000000
</pre></ul>

Em ambos os formatos de importação, prevalecerá o rateio indicado no arquivo. Para os lançamentos
que não possuírem registros de rateio, será gerado o rateio conforme o rateio padrão de acordo com a
parametrização de cada lançamento.
 
 
'''Diferimentos:'''
 
Os diferimentos são informados no EDI com o tipo de registro "D" (Diferimento). Quando é lido este
registro, o sistema passa a gerar dois novos lançamentos financeiros vinculados ao original da seguinte
forma:
 
• "Tipo Documento" = "M" Diferimento
 
• "Documento" = <Número do lançamento original>
 
Serão gerados um lançamento de entrada e outro de saída, com o lançamento vinculado um apontando
para o outro.
 
O valor desses lançamentos será igual ao valor do lançamento original multiplicado pelo percentual de
diferimento. A data será de acordo com a data informada no registro de diferimento.
O portador, a conta e o histórico ficarão conforme definido na regra. Para contas a receber, o rateio do
lançamento de saída será igual ao original e o lançamento de entrada conforme o que vem no EDI. Para
contas a pagar a regra é invertida.

=='''Comissões'''==
<center>
{| class="wikitable"
|-
! Linha !! Nome do Campo !! Atributo !! Faixa Válida !! Máscara !! Posição !! Comentário
|-
| 1 || Tipo Registro || A || "C" || 1 || 1 a 1 || "C"
|-
| 2 || Lançamento || N || || 8 || 3 a 14 ||
|-
| 3 || Representante || A || || UUUUUU || 16 a 21 ||
|-
| 4 || Comissão (%) || N || || 3.7 || 23 a 34 || %
|-
| 5 || Tipo Documento || A || " "Geral || UA || 36 a 36 || "branco"
|-
| 6 || Documento || A || || 12A || 38 a 49 ||
|-
|}
</center>

'''Atenção:''' É obrigatório ser informado o nº do Lançamento ou o Documento.

=='''CONSISTÊNCIAS: Faixa válida'''==
<center>
{| class="wikitable"
|-
| 1 || Tipo de lançamento: "L", "R", "D" ou "C".
|-
| 2 || Operação: "I", "E" ou "B"
|-
| 3 || Data: Diferente de zero
|-
| 4 || Vencimento: Diferente de zero e maior do que a emissão.
|-
| 5 || Tipo de lançamento: "R", "c", "P", "d", "E" ou "S"
|-
| 6 || Valor : Maior do que zero
|-
| 7 || Empresa: Empresa cadastrada
|-
| 8 || Cobrança: Cobrança cadastrada
|-
| 9 || Emissão: Diferente de zero
|-
| 10 || Saldo: Menor ou igual ao Valor
|-
| 11 || Situação: "A", "B", "C", "D", "E", "I", "J", "L", "P", "U", "X", "R" ou "S".
|-
| 12 || Contabilizado: " ", "A", "C" ou "N"
|-
| 13 || Tipo de Pagamento: Tipo cadastrado
|-
| 14 || U.N.: U.N. cadastrada
|-
| 15 || Tipo Documento: " ", "P", "O" ou "U"
|-
| 16 || Tipo Juros: " ", "S" ou "C"
|-
| 17 || Modalidade Vencimento: " ", "V" ou "A"
|-
| 18 || Modalidade Pagamento: " ", "A", "S" ou "P"
|-
| 19 ||Previsão: "S" ou "N"
|-
| 20 || Listar Dirf: "S" ou "N"
|-
| 21 || Reduzido Contábil: Reduzido Contábil cadastrado
|-
| 22 || Rateio Contábil: Maior que zero até 100
|-
| 23 || Reduzido Gerencial: Reduzido Gerencial cadastrado
|-
| 24 || Rateio Gerencial: Maior que zero até 100
|-
| 25 || Representante: Representante cadastrado
|-
| 26 || Percentual de Comissão: Maior que zero até 100
|-
|}
</center>

Para contas a receber, o rateio do lançamento de saída será igual ao original e o lançamento de entrada
conforme o que vem no EDI. Para contas a pagar a regra é invertida.

=='''Registro RENEGOCIAÇÃO '''==

'''OBSERVAÇÃO:''' Não Tratado.
<center>
{| class="wikitable"
|-
! Linha !! Nome do Campo !! Atributo !! Máscara !! Posição !! Faixa Válida !! Comentários
|-
| 001 || Tipo Registro || Car || 1 || 1 A 1 || "'''N'''" ||
|-
| 002 || Operação || Car || 1 || 3 A 3 || '''A'''=Acréscimo '''D'''=Desconto '''U'''=Unificação ||
|-
| 003 || Modelo Lançamento || Car || 5 || 5 A 9 || || Código do modelo de lançamento a ser criado conforme o valor de acréscimo.
|-
| 004 || Valor Acréscimo/Desconto || Num || 1.2 || 11 a 24 || || Valor de acréscimo/Desconto na negociação. Diferença entre o Valor Negociado e a soma dos lançamentos envolvidos.
|-
| 005 || Data Negociação || Data || DD/MM/AA || 26 A 33 || || Data da geração do novo compromisso
|-
| 006 || Vencimento || Data || DD/MM/AA || 35 A 42 || || Vencimento do novo compromisso
|-
| 007 || Valor Negociado || Num || 11.2 || 44 a 57 || || Novo valor
|-
| 008 || Código Histórico || Car || UUU || 59 a 61|| ||
|-
| 009 || Complem.Histórico || Memo || 201 || 63 a 263 || ||
|-
| 010 || Conta Financeira || Car || UU.UU.UU || 265 a 272 || ||
|-
| 011 || Portador || Car || UUU || 274 a 276 || ||
|-
| 012 || Contabilizado || Car || U || 278 a 278 || " " a Contabilizar; "'''C'''"ontabilizado; "'''A'''"bertura; "'''N'''"ão Contabilizar. ||
|-
| 013 || Fatura || Num || 10 || 280 a 289 || ||
|-
| 014 || Complemento || Car || 5 || 291 a 295 || || Parcela Ex.:"1/4"
|-
| 015 || Tipo de Pagamento || Car || 2 || 297 a 298 || ||
|-
| 016 || Numero no Banco || Car || 15 || 300 a 314 || ||
|-
| 017 || Atualizar Unidade Negócio || Car || U || 316 a 316 || '''I''' = Informar '''O''' = Original '''P''' = Padrão ||
|-
| 018 || Unidade de Negocio || Car || 3 || 318 a 320 || Informar se a opção anterior for "'''I'''" = Informar ||
|-
| 019 || Documento || Car || 12 || 322 a 333 || ||
|-
| 020 || Tolerância Vencimento || Num || 3A || 335 a 337 || ||
|-
| 021 || Juros Dia || Num || N11.2CA || 339 a 352 || || Para o lançamento a receber
|-
| 022 || Valor Multa || Num || N11.2CA || 354 a 367 || || Para o lançamento a receber
|-
| 023 || Tolerância Multa || Num || 3A || 369 a 371 || || Para o lançamento a receber
|-
| 024 || Tolerância Juros || Num || 3A || 373 a 375 || || Para o lançamento a receber
|-
| 025 || Tipo Juros || Car || UA || 377 a 377 || "'''S'''"imples "'''C'''"omposto || Para o lançamento a receber
|-
| 026 || Valor Desconto || Num || N11.2CA || 379 a 392 || || Para o lançamento a receber
|-
| 027 || Modalidade Vencimento || Car || UA || 394 a 394 || "'''V'''"ista; "'''A'''"presentação; " " Prazo; "'''E'''"ntrada. ||
|-
| 028 || Modalidade Pagamento || Car || UA || 396 a 396 || " " Exato; "'''A'''"nterior; "'''S'''"eguinte; "'''P'''"revisto. ||
|-
| 029 || Buscar última fatura || Car || U || 398 a 398 || Sim Não ||
|-
| 030 || Parcelar Unificado || Car || U || 400 a 400 || Sim Não ||
|-
| 031 || Número de Parcelas || Num || 3 || 402 a 404 || ||
|-
| 032 || Periodicidade || Num || 3 || 406 a 408 || ||
|-
| 033 || Histórico Liquidação Originais || Car || UUU || 410 a 412 || ||
|-
| 034 || Portador Liquidação Originais || Car || UUU || 414 a 416 || ||
|-
|}
</center>

=='''Registro de Impostos de Retenção'''==

'''Importante:''' Para impostos cujo regime de pagamento esteja igual a "Efetivo" o sistema irá
validar apenas o código do imposto e o código DARF do arquivo. As outras informações do
arquivo cfe layout não serão validadas. Para esse regime, o sistema irá considerar as
informações cadastradas no programa Impostos e Contribuições.
 
{| class="wikitable"
|-
! Linha !! Nome do Campo !! Atributo !! Faixa Válida !! Máscara !! Posição !! Comentários
|-
| 001 || Tipo Registro || A || || || ||
|-
| 002 || Código do Imposto || A || Qualquer código de imposto cadastrado no CIGAM || 6A || 003 A 008 || Será validado na importação.
|-
| 003 || Código DARF || N || Qualquer código DARF cadastrado no Cigam || 4P0 || 010 A 013 || Será validado na importação.
|-
| 004 || Base Imposto || N || || 13.2CA || 015 A 030 || Caso for informado em branco ou zero será utilizado o próprio valor do lançamento
|-
| 005 || Alíquota do Imposto || N || || 3.2 || 032 A 037 || Caso for informado em branco ou zero será utilizada a alíquota informada no cadastro de Impostos e contribuições.
|-
| 006 || Valor do Imposto || N || || N11.2CA || 039 A 054 || Caso for deixado em branco será calculado conforme a Base de Imposto e a Alíquota.
|-
| 007 || Histórico || A || || 3A || 056 A 058 ||
|-
| 008 || Conta Financeira || A || || UU.UU.UU || 060 A 067 ||
|-
| 009 || Portador || A || || 3A || 069 A 071 ||
|-
|}

GF Importar EDIFIN

2022-06-30T17:15:52Z

Claudia.Felles: /* Registro RENEGOCIAÇÃO */

GF Importar EDIFIN

2022-06-30T17:14:22Z

Claudia.Felles: /* Registro RENEGOCIAÇÃO */

GF Importar EDIFIN

2022-06-30T15:02:22Z

Claudia.Felles: /* Registro RENEGOCIAÇÃO */

[[Finanças]] >
[[GF_Gestão Financeira|Gestão Financeira]] >
[[GF_Rotinas|Rotinas]] >
[[GF_Rotinas_EDI|EDI]] >
[[GF_Rotinas_EDI_Recebe|Recebe]] >
[[GF_Importar EDIFIN|Importar EDIFIN]]
 
 
==Importar EDIFIN==

Rotina utilizada para liquidar Lançamentos a “Receber” e para importar arquivos de Lançamentos do Tipo ‘Pagar’ com ‘Situação’ em ‘Aberto’ com vínculo de retenções de impostos(ex.: IR, ICMS, COFINS,....).
 
 
===Guia Geral===
 
[[Image:Importgf.png|center|semmoldura|650px|Importa EDIFIN]]
 
 
====Grupo Arquivo a ser Importado=====

====Grupo salvar arquivo Processado em====

====Grupo Lançamentos====

====Grupo Deferimentos====

====Grupo Exclusão com Documento Informado====

====Grupo Exclusão com Remessa enviada Marcada====

==== Grupo Na Liquidação considerar do arquivo====

====Liquidação de Lançamentos a Receber====

A rotina de importação de EDIFIN permite operações de ‘B’aixa para lançamentos de ‘Previsão’ de ‘Contratos’ que não geram faturamento, fazendo com que o sistema mude o lançamento para efetivo e efetua a liquidação normalmente.
 
 
Obs.: Uma vez já importado Lançamento de Liquidação, o mesmo não será feito duas vezes, para não haver duplicidade de Lançamentos Liquidados, apenas para juros, multa, outras despesas e/ou desconto.
 
 

===Guia Retenção/Ordem de Serviço===
 
[[Image:Retordemgf.png|center|semmoldura|650px|Importa EDIFIN]]
===Grupo Retenção===
===Grupo Ordem de Serviço===
====Lançamentos com vínculo de retenções de impostos====
Para a criação de retenção de impostos, conforme cada Lançamento, o checkbox ‘Gerar Lançamento de Retenção’ NÃO poderá estar marcado. E para verificar as posições da(s) linha(s) de retenção de impostos, no arquivo, olhar o layout que se encontra em I:\CIGAM\DOC\EDI\ EDIFIN Lançamentos Financeiros 8i.
 
 
Obs.: para o campo ‘Alíquota’, caso estiver com porcentagem zerada no arquivo, será utilizado o percentual informado na retenção do Código do Imposto, no Cadastro de Impostos, com exceção do imposto de retenção do tipo ‘Efetivo’, que sempre pegará a porcentagem informada no Código do Imposto.Para os demais impostos, entretanto, se ambos estiverem com alíquota zerada, dará mensagem de erro.

==Botões==
'''Botão Confirmar:'''
 
 
'''Botão Cancelar:'''



='''Layout EDIFIN'''=

=='''Lançamentos'''==
<center>
{| class="wikitable"
|-
! Linha !! Campo !! Atributo !! Máscara !! Posição !! Faixa Válida !! Comentários
|-
| 1 || Tipo Registro || Car || 1A || 1 a 1 || "'''L'''" ||
|-
| 2 || Operação || Car || 1A || 3 a 3 || "'''I'''"nclusão; "'''E'''"xclusão; "'''B'''"aixa.
|| Ver em [[#Observações|observações]]
|-
| 3 || Lançamento || Num || ########A || 5 a 16 || || • Inclusão = 0 ou o número; • Exclusão e Baixa = obrigatório informar o nº do lançamento ou do Documento.
|-
| 4 || Data || Data || ##/##/##A || 18 a 25 || || Emissão ou Data da Liquidação (Baixa).
|-
| 5 || Vencimento || Data || ##/##/##A || 27 a 34 || ||
|-
| 6 || NF || Num || 10A || 36 a 45 || ||
|-
| 7 || Fatura || Num || 10A || 47 a 56 || ||
|-
| 8 || Complemento || Car || 5A || 58 a 62 || || Parcela. Ex.:"1/4"
|-
| 9 || Codigo Historico || Car || UUUA || 64 a 66 || ||
|-
| 10 || Histórico || Memo || 201 || 68 a 268 || ||
|-
| 11 || Conta || Car || UU.UU.UUA || 270 a 277 || ||
|-
| 12 || Tipo || Car || XA || 279 a 279 || "'''R'''"eceber; "'''c'''"Recebido; "'''P'''"agar; "'''d'''"Pago; "'''E'''"ntrada; "'''S'''"aida.
|| • Exclusão e Baixa = "branco"; • Inclusão= "R", "P", "E" ou "S".
|-
| 13 || Valor || Num || N11.2CA || 281 a 298 || ||
|-
| 14 || Empresa || Car || UUUUUUA || 300 a 305 || ||
|-
| 15 || Cobranca || Car || UUUUUUA || 307 a 312 || ||
|-
| 16 || Cheque || Num || 9A || 314 a 322 || ||
|-
| 17 || Portador || Car || UUUA || 324 a 326 || ||
|-
| 18 || Emissão || Data || ##/##/##A || 328 a 335 || ||
|-
| 19 || C_Partida || Num || ########A || 337 a 348 || || • Exclusão = Cpartida; • Inclusão e Baixa = 0.
|-
| 20 || Saldo || Num || N11.2CA || 350 a 367 || ||
|-
| 21 || Conferido || Car || 1A || 369 a 369 || || "branco"
|-
| 22 || Campo20 || Num || 3.2A || 371 a 376 || || 0
|-
| 23 || Situação || Car || UA || 378 a 378 || [[#Faixas Válidas - Campo: Situação|Clique aqui]] para visualizar as Faixas. || • Inclusão = informar situação,; • Exclusão=”branco”; • Baixa=”L”.
|-
| 24 || Conciliado || Car || UA || 380 a 380 || || "branco"
|-
| 25 || Série || Car || UUUUUA || 382 a 386 || ||
|-
| 26 || Contabilizado || Car || UA || 388 a 388 || " " a Contabilizar; "'''C'''"ontabilizado; "'''A'''"bertura; "'''N'''"ão Contabilizar.
||
|-
| 27 || Usuário || Car || 3A || 390 a 392 || || "branco"
|-
| || '''Modificação'''
|-
| 28 || Tipo de Pagamento || Car || 2A || 394 a 395 || ||
|-
| 29 || Numero no Banco || Car || 15A || 397 a 411 || ||
|-
| 30 || Campo 28 || Num || N11.2CA || 413 a 430 || || 0
|-
| 31 || Juros Dia || Num || N11.2CA || 432 a 449 || ||
|-
| 32 || Ultima Liquidação || Data || ##/##/##A || 451 a 458 || || "branco"
|-
| 33 || Unidade de Negocio || Car || 3A || 460 a 462 || ||
|-
| 34 || Documento || Car || 12A || 464 a 475 || || Informar um código único identificador do lançamento, obrigatório quando não informado o nº do lançamento e desejar excluir, modificar ou informar rateios.
|-
| 35 || Tipo Documento || Car || UA || 477 a 477 || [[#Faixas Válidas - Campo: Tipo Documento|Clique aqui]] para visualizar as Faixas. || Caso seja informado Documento informar também o tipo, caso contrário = "branco".
|-
| 36 || Valor Indexado || Num || N10.5CA || 479 a 498 || || 0
|-
| 37 || Saldo Indexado || Num || N10.5CA || 500 a 519 || || 0
|-
| 38 || Tolerância Vencimento || Num || 3A || 521 a 523 || ||
|-
| 39 || Campo37 || Num || N3.2%A || 525 a 531 || ||
|-
| 40 || Valor Multa || Num || N11.2CA || 533 a 550 || ||
|-
| 41 || Tolerância Multa || Num || 3A || 552 a 554 || ||
|-
| 42 || Tolerância Juros || Num || 3A || 556 a 558 || ||
|-
| 43 || Campo41 || Num || N3.2%A || 560 a 566 || || 0
|-
| 44 || Tipo Juros || Car || UA || 568 a 568 || "'''S'''"imples; "'''C'''"omposto. ||
|-
| 45 || Valor Desconto || Num || N11.2CA || 570 a 587 || ||
|-
| 46 || Lançamento Vinculado || Num || ########A || 589 a 600 || || 0
|-
| 47 || Data Inclusão || Data || ##/##/##A || 602 a 609 || || "branco"
|-
| 48 || Sacador Avalista || Car || UUUUUUA || 611 a 616 || || "branco"
|-
|
|-
| 49 || Modalidade || Car || UA || 618 a 618 || "'''V'''"ista; "'''A'''"presentação; " " Prazo; "'''E'''"ntrada.
|| 0
|-
| 50 || Modalidade Pagamento || Car || UA || 620 a 620 || " " Exato; "'''A'''"nterior; "'''S'''"eguinte; "'''P'''"revisto. ||
|-
| 51 || Espécie Documento || Car || 2A || 622 a 623 || || "branco"
|-
| 52 || Vencimento || Data || ##/##/##A || 625 a 632 || ||
|-
| || '''Original'''
|-
| 53 || Projeto || Car || 12A || 634 a 645 || || "branco"
|-
| 54 || Campo52 || Car || 8A || 647 a 654 || || "branco"
|-
| 55 || Índice || Car || UUUUUA || 656 a 660 || ||
|-
| 56 || Bloqueto Impresso || Logical || 1A || 662 a 662 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 57 || Duplicata Impressa || Logical || 1A || 664 a 664 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 58 || Remessa enviada || Logical || 1A || 666 a 666 || "'''S'''"im; "'''N'''"ão. || "N"
|-
| 59 || Autorizado Por || Car || 3A || 668 a 670 || || "branco"
|-
| 60 || Autorizado Em || Data || ##/##/##A || ##/##/##A || || "branco"
|-
| 61 || Data Modificação || Data || ##/##/##A || 681 a 688 || || "branco"
|-
| 62 || Usuário Criação || Car || 3A || 690 a 692 || || "branco"
|-
| 63 || Sessão || Num || 8A || 694 a 701 || || 0
|-
| 64 || Campo60 || Data || ##/##/##A || 703 a 710 || || "branco"
|-
| 65 || Campo61 || Data || ##/##/##A || 712 a 719 || || "branco"
|-
| 66 || Campo62 || Data || ##/##/##A || 721 a 728 || || "branco"
|-
| 67 || Campo63 || Data || ##/##/##A || 730 a 737 || || "branco"
|-
| 68 || Campo64 || Car || UUUUUUA || 739 a 744 || || "branco"
|-
| 69 || Campo65 || Car || UUUUUUA || 746 a 751 || || "branco"
|-
| 70 || Campo66 || Car || UUUUUUA || 753 a 758 || || "branco"
|-
| 71 || Campo67 || Car || UUUUUUA || 760 a 765 || || "branco"
|-
| 72 || Ordem Endereço Cobrança || Car || UA || 767 a 767 || ||
|-
| 73 || Campo69 || Car || UA || 769 a 769 || || "branco"
|-
| 74 || Pagamento || Car || UA || 771 a 771 || "'''L'''"iberado; "'''B'''"loqueado; "'''A'''"utorizado. || “branco”
|-
| 75 || Listar DAÍ || Car || 2A || 773 a 774 || " "Não; "'''A'''"bertura NF; "'''S'''"im. || "branco"
|-
| 76 || Código de Barras Lido || Car || 2A || 776 a 777 || "'''S'''" e "'''N'''" || "N"
|-
| 77 || Data DIRF || Car || 2A || 779 a 780 || || "branco"
|-
| 78 || Campo74 || Car || 3A || 782 a 784 || || "branco"
|-
| 79 || Campo75 || Car || 3A || 786 a 788 || || "branco"
|-
| 80 || Ordem Conta Corrente || Car || 3A || 790 a 792 || ||
|-
| 81 || Previsão || Logical || 1ª || 794 a 794 || "'''S'''"im e "'''N'''"ão ||
|-
| 82 || Listar DIRF || Logical || 1ª || 796 a 796 || "'''S'''"im e "'''N'''"ão || "N"
|-
| 83 || Possui Cheques Títulos || Logical || 1ª || 798 a 798 || "'''S'''"im e "'''N'''"ão || "N"
|-
| 84 || Sequência || Num || N8.6CA || 800 a 817 || || 0
|-
| 85 || Campo81 || Num || N8.6CA || 819 a 836 || || 0
|-
| 86 || Campo82 || Num || N11.2CA || 838 a 855 || || 0
|-
| 87 || Campo83 || Num || N11.2CA || 857 a 874 || || 0
|-
| 88 || Campo84 || Num || N11.2CA || 876 a 893 || || 0
|-
| 89 || Campo85 || Num || N11.2CA || 895 a 912 || || 0
|-
| 90 || Sessão || Car || 20ª || 914 a 933 || || "branco"
|-
| || '''Operador'''
|-
| 91 || Campo87 || Car || Car || 935 a 954 || || "branco"
|-
| 92 || Hora Criação || Time || HH:MM:SS || 956 a 963 || || "branco"
|-
| 93 || Usrlanc1 || Car || 20 || 965 a 984 || || "branco"
|-
| 94 || Usrlanc2 || Data || ##/##/##A || 986 a 993 || || "branco"
|-
| 95 || Usrlanc3 || Num || N11.2CA || 995 a 1012 || || 0
|-
| 96 || Numero OS || Num || 6P0 || 1014 a 1019 || ||
|-
| 97 || Item OS || Num || 3 || 1021 a 1023 || ||
|-
| 98 || Valor Juros || Num || 13.2CA || 1025 a 1044 || || Somente Liquidação
|-
| 99 || Valor Multa || Num || 13.2CA || 1046 a 1065 || || Somente Liquidação
|-
| 100 || Outras Despesas || Num || 11.2CA || 1067 a 1083 || || Somente Liquidação
|-
| 101 || Valor Desconto || Num || 11.2CA || 1085 a 1101 || || Somente Liquidação
|-
| 102 || Autorizacao Cartao || Car || 25A || 1103 a 1127 || ||
|-
| 103 || NSU_Autenticacao Bancaria || Car || 25A || 1129 a 1153 || ||
|-
|}

==='''Faixas Válidas - Campo: Situação'''===

• "'''A'''"berto
 
• "'''B'''"onificação
 
• "'''C'''"artório
 
• "'''D'''"evolvido
 
• "'''E'''"xecutado
 
• "'''I'''"nadimplente
 
• "'''J'''"uros/CM/Multa
 
• "'''L'''"iquidado
 
• "'''P'''"rotestado
 
• "'''U'''"nificado
 
• "'''X'''" Adiantado
 
• "'''R'''"etenção
 
• "'''S'''"aldo Inicial

==='''Faixas Válidas - Campo: Tipo Documento'''===

• "'''P'''"edido;
 
• "'''O'''"rdem;
 
• " " Geral;
 
• "'''U'''"nificado;
 
• "'''C'''"ontrato;
 
• "'''F'''"olha;
 
• "'''A'''"grupado;
 
• "'''D'''"evolução;
 
• "'''R'''"etenção;
 
• "'''M'''" Diferimento.

==='''Observações'''===

Entre cada campo deve haver um caracter de espaço (ASC 32)
Utilizar vírgula como separador decimal nos valores, sendo opcional o separador de milhar (‘ponto’) (Ex: 1234,56 ou 1.234,56)
Utilizar barras simples para separar dia, mês e ano (Ex.: 25/04/01)
Utilizar dois pontos para separar hora, minuto e segundo (Ex.:12:35:56)
Os campos livres (CampoXX ou UsrXX) são opcionais, não necessitam de preenchimento, no caso, utilizar espaços ou omitir quando (últimos campos).
A Situação na inclusão depende do tipo.
Não existe tratamento para baixa parcial
Quanto a Operação de Exclusão: Quando a exclusão for pelo Número do Documento verificar opções de Exclusão na tela, pois está leva em consideração o Tipo e a Contabilização do Lançamento. O Padrão é ‘Aberto’ e ‘Não
Contabilizado’. Quando não informado registro de Rateio, será gerado o rateio Padrão conforme o Tipo
e Situação do Lançamento.

=='''Rateios Contábeis/Gerenciais/Diferimento'''==
<center>
{| class="wikitable"
|-
! Linha !! Nome Campo !! Atributo !! Faixa Válida !! Máscara !! Nova Posição Inicial !! Comentário
|-
| 1 || Tipo Registro || A || "'''R'''" (rateio) "'''D'''" (Diferimento) || 1 || 1 a 1 ||
|-
| 2 || Lançamento || N || || 8 || 3 a 14 ||
|-
| 3 || Reduzido Contábil || A || || UUUUUU || 16 a 21 || Código Contábil
|-
| 4 || % Contábil || N || || 3,8 || 23 a 34 ||
|-
| 5 || Conta Gerencial || A || || UUUUUU || 36 a 41 ||
|-
| 6 || % Gerencial || N || || 3.8 || 43 a 54 ||
|-
| 7 || Data || D || || DD/MM/AA || 56 a 63 ||
|-
| 8 || Tipo Documento || A || " " Geral || UA || 65 a 65 || "branco"
|-
| 9 || Documento || A || || 12A || 67 a 78 ||
|-
|}
</center>

É obrigatório ser informado o nº do Lançamento ou o Documento. Se Lançamento e Documento estiver
em branco irá assumir o último número de Lançamento gerado para o último Registro de Lançamento
importado. Somente para registro = "R". Se o registro "R" não for enviado logo após o registro "L"
correspondente, o rateio será criado conforme o rateio "Padrão" conforme as regras de contabilização de
acordo com o Tipo e Situação do Lançamento. Os registros de Rateios podem ser informados abaixo de
cada registro "L" correspondente.
 
Se Lançamento e Documento estiver em branco irá assumir o último número de Lançamento gerado para o último Registro de Lançamento importado.
 
 
'''Ex.'''
<ul><pre>
L I 000012345600 24/04/07
R 000012345600 666666 100,00000000
L I 000012345601 24/04/07
R 000012345601 777777 100,00000000
</pre></ul>

Podem ser gerados todos os registros "R" no final do arquivo após os registros de lançamentos. Neste
caso devem ser informados os números dos lançamentos/documentos correspondentes
 
<ul><pre>
L I 000012345600 24/04/07
L I 000012345601 24/04/07
R 000012345600 666666 100,00000000
R 000012345601 777777 100,00000000
</pre></ul>

Em ambos os formatos de importação, prevalecerá o rateio indicado no arquivo. Para os lançamentos
que não possuírem registros de rateio, será gerado o rateio conforme o rateio padrão de acordo com a
parametrização de cada lançamento.
 
 
'''Diferimentos:'''
 
Os diferimentos são informados no EDI com o tipo de registro "D" (Diferimento). Quando é lido este
registro, o sistema passa a gerar dois novos lançamentos financeiros vinculados ao original da seguinte
forma:
 
• "Tipo Documento" = "M" Diferimento
 
• "Documento" = <Número do lançamento original>
 
Serão gerados um lançamento de entrada e outro de saída, com o lançamento vinculado um apontando
para o outro.
 
O valor desses lançamentos será igual ao valor do lançamento original multiplicado pelo percentual de
diferimento. A data será de acordo com a data informada no registro de diferimento.
O portador, a conta e o histórico ficarão conforme definido na regra. Para contas a receber, o rateio do
lançamento de saída será igual ao original e o lançamento de entrada conforme o que vem no EDI. Para
contas a pagar a regra é invertida.

=='''Comissões'''==
<center>
{| class="wikitable"
|-
! Linha !! Nome do Campo !! Atributo !! Faixa Válida !! Máscara !! Posição !! Comentário
|-
| 1 || Tipo Registro || A || "C" || 1 || 1 a 1 || "C"
|-
| 2 || Lançamento || N || || 8 || 3 a 14 ||
|-
| 3 || Representante || A || || UUUUUU || 16 a 21 ||
|-
| 4 || Comissão (%) || N || || 3.7 || 23 a 34 || %
|-
| 5 || Tipo Documento || A || " "Geral || UA || 36 a 36 || "branco"
|-
| 6 || Documento || A || || 12A || 38 a 49 ||
|-
|}
</center>

'''Atenção:''' É obrigatório ser informado o nº do Lançamento ou o Documento.

=='''CONSISTÊNCIAS: Faixa válida'''==
<center>
{| class="wikitable"
|-
| 1 || Tipo de lançamento: "L", "R", "D" ou "C".
|-
| 2 || Operação: "I", "E" ou "B"
|-
| 3 || Data: Diferente de zero
|-
| 4 || Vencimento: Diferente de zero e maior do que a emissão.
|-
| 5 || Tipo de lançamento: "R", "c", "P", "d", "E" ou "S"
|-
| 6 || Valor : Maior do que zero
|-
| 7 || Empresa: Empresa cadastrada
|-
| 8 || Cobrança: Cobrança cadastrada
|-
| 9 || Emissão: Diferente de zero
|-
| 10 || Saldo: Menor ou igual ao Valor
|-
| 11 || Situação: "A", "B", "C", "D", "E", "I", "J", "L", "P", "U", "X", "R" ou "S".
|-
| 12 || Contabilizado: " ", "A", "C" ou "N"
|-
| 13 || Tipo de Pagamento: Tipo cadastrado
|-
| 14 || U.N.: U.N. cadastrada
|-
| 15 || Tipo Documento: " ", "P", "O" ou "U"
|-
| 16 || Tipo Juros: " ", "S" ou "C"
|-
| 17 || Modalidade Vencimento: " ", "V" ou "A"
|-
| 18 || Modalidade Pagamento: " ", "A", "S" ou "P"
|-
| 19 ||Previsão: "S" ou "N"
|-
| 20 || Listar Dirf: "S" ou "N"
|-
| 21 || Reduzido Contábil: Reduzido Contábil cadastrado
|-
| 22 || Rateio Contábil: Maior que zero até 100
|-
| 23 || Reduzido Gerencial: Reduzido Gerencial cadastrado
|-
| 24 || Rateio Gerencial: Maior que zero até 100
|-
| 25 || Representante: Representante cadastrado
|-
| 26 || Percentual de Comissão: Maior que zero até 100
|-
|}
</center>

Para contas a receber, o rateio do lançamento de saída será igual ao original e o lançamento de entrada
conforme o que vem no EDI. Para contas a pagar a regra é invertida.

=='''Registro RENEGOCIAÇÃO '''==

'''OBSERVAÇÃO:''' Não Tratado.
<center>
{| class="wikitable"
|-
! Linha !! Nome do Campo !! Atributo !! Máscara !! Posição !! Faixa Válida !! Comentários
|-
| 001 || Tipo Registro || Car || 1 || 1 A 1 || "'''N'''" ||
|-
| 002 || Operação || Car || 1 || 3 A 3 || '''A'''=Acréscimo '''D'''=Desconto '''U'''=Unificação ||
|-
| 003 || Modelo Lançamento || Car || 5 || 5 A 9 || || Código do modelo de lançamento a ser criado conforme o valor de acréscimo.
|-
| 004 || Valor Acréscimo/Desconto || Num || 1.2 || 11 a 24 || || Valor de acréscimo/Desconto na negociação. Diferença entre o Valor Negociado e a soma dos lançamentos envolvidos.
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
| 0 || 0 || 0 || 0 || 0 || 0 || 0
|-
|}
</center>

GF Importar EDIFIN

2022-06-30T14:52:31Z

Claudia.Felles: /* CONSISTÊNCIAS: Faixa válida */

GF Importar EDIFIN

2022-06-30T14:49:50Z

Claudia.Felles: /* CONSISTÊNCIAS: Faixa válida */

GF Importar EDIFIN

2022-06-30T14:28:30Z

Claudia.Felles: /* Comissões */

GF Importar EDIFIN

2022-06-30T14:21:39Z

Claudia.Felles: /* Comissões */

GF Importar EDIFIN

2022-06-30T14:12:36Z