¶
A integração com a API bancária do Credisis, foi desenvolvida com o objetivo de facilitar a gestão financeira de sua empresa.
Com essa integração você não precisará enviar arquivos de remessa ao banco ou processar retornos em seu sistema, pois o registro dos boletos é realizado pela impressão do mesmo ou através da comunicação em massa. Além disso, as baixas das faturas ocorrem automaticamente em até 24 horas (de acordo com as tarefas de consulta configuradas em seu sistema).
Nessa forma de registro, os boletos ficam disponíveis para pagamento em até 1 hora após a impressão/comunicação dos mesmos.
¶ Requisitos para integração API:
-
Sistema operacional Debian 10;
-
Novo convênio com o banco (necessário para não interferir nos boletos já gerados na carteira de boletos via remessa e retorno).
Como funciona o registro dos boletos
Para as carteiras de cobrança do tipo API e Gateway, a comunicação do boleto ocorre ao requisitar a impressão/PDF pela interface do IXC, onde o comando de comunicação/impressão é solicitado ao banco, também realizando o registro desse boleto no sistema bancário.
O registro dos boletos pela carteira de API pode ser feito de três formas:
- Gerando o PDF/Imprimindo o boleto no financeiro do cliente;
- Realizando a comunicação em massa com o gateway.
- Ou pela rotina de envio de faturas via e-mail automático.
O envio de faturas via e-mail automático não é recomendado, pois se a fatura não puder ser gerada por qualquer inconsistência nos dados cadastrais do cliente ou por algum problema com a fatura em sí, isto irá travar a tarefa de envio de e-mails e não realizará a comunicação do boleto.
A forma de registro de boletos mais recomendada é a comunicação em massa com o gateway, pois facilita na demanda de registro de grandes quantidades de boletos.
A comunicação em massa seria como o envio das remessas ao banco em uma carteira tradicional/manual.
Você pode fazer essa comunicação em intervalos de tempo, como algumas formas de exemplo:
-Diária
-Semanal
-Mensal
Como configurar a carteira de cobrança no IXC
Para a homologação de uma carteira API, é indicado abrir um novo convênio de conta bancária. Caso deseje utilizar um que já esteja em uso no IXC e/ou que já tenha boletos emitidos por ele, deve estar ciente de que podem ocorrer divergências nos relatórios provenientes de arquivos de retorno.
Entre as divergências estão: Informação de Título não encontrado nos processamentos de retorno (quem se referem a títulos da carteira de API), liquidações atreladas a boletos divergentes, etc.**
Além disso, é crucial evitar a geração de novos boletos pela antiga carteira de remessa/retorno, que utiliza o mesmo convênio, após a homologação da carteira de API.
Dados bancários necessários para a integração
Primeiramente, contate o Suporte de Carteira de Cobrança da IXC Soft. Para realizar a integração da sua cartera de API Credisis no IXC, você irá precisar de alguns dados, sendo eles:
- Número da agência com digito verificador;
- Número da conta com digito verificador;
- Token da API Credisis;
- Número do convênio ou código beneficiário/cedente.
Criando a carteira
- Acesse o menu Sistema;
- Clique em Cadastros;
- Selecione a pasta Financeiro;
- Em seguida, escolha a opção Carteira de cobrança;
- Por fim, clique no botão Novo:
Na primeira aba chamada Carteira de cobrança, você fará as seguintes configurações:
- Descrição: Aqui você irá definir a nomeação da carteira;
- Conta: Aqui você irá criar a conta, responsável por armazenar seus dados bancários;
- Tipo de recebimento: Neste campo você deve selecionar a opção Gateway;
- Enviar e-mail para cliente ao gerar: Marcar como Não, pois seu uso em carteiras do tipo Gateway pode acarretar em duplicidade de cobrança.
- Planejamento analítico: utilize o padrão 240, ou cadastre um novo Planejamento analítico.
Criando a conta
- Conta: Defina o nome para a conta;
- Tipo da Conta: Marque a opção Banco;
- Data de abertura: Informe o dia em que está configurando a conta para esta carteira;
- Planejamento analítico: Acesse a wiki sobre Como configurar o Planejamento analítico. Lembrando que o planejamento criado deve conter o mesmo nome que colocou na conta.
- Filial: Selecione o ID da filial para a qual será criada esta conta (a filial deve conter o CNPJ igual ao do beneficiário da conta no banco).
Na aba seguinte, chamada Banco:
- Banco: Selecione o ID de acordo com o cadastro nacional de Bancos, no caso do Credisis é: 097 - Central Cred;
- Agência: Número da sua agência bancária;
- Dígito verificador da agência: Preencha com o dígito da agência, se houver;
- Número da conta: Número da sua conta bancária;
- Dígito verificador da conta: Informe o dígito verificador de sua conta bancária.
Ao salvar sua nova conta, insira o novo registro a sua carteira de cobrança.
Aba Configurações gateway
- Gateway: Selecione o CrediSIS;
- Importado gateway: Mantenha marcado na opção: Não. Será marcada a opção Sim, apenas em casos de carteira importada;
- Token: Insira o token gerado pelo Credisis;
- Envia e-mail Gateways: Marque como Não;
- Número convênio: Insira o número do seu convênio Credisis;
- Tarifas Gateway: Aqui você define o lançamento das tarifas gateway, pois o banco não faz isso de forma automática.
Para tal, acesse a wiki de Tarifas Gateway e API.
¶ Aba Juros/Multas/Desconto
Para a configuração dessa aba, siga as instruções de Juros/Multas/Desconto
¶ Aba Instruções
Para a configuração dessa aba, verifique: Instruções
¶ Aba Impressão
Para a configuração dessa aba, verifique a Wiki Impressão.
¶ Aba Recebimento
Para a configuração dessa aba, siga as instruções presentes em: Recebimento para valores divergentes
Agenda de tarefas
Após a configuração da carteira de cobrança, é necessário configurar as tarefas que irão executar as baixas das faturas de forma automática em seu sistema.
Recomendamos cadastrar até 4 tarefas de consulta divididas entre as 24h do dia para as carteiras de APIs bancárias (Ex: 06h50, 12h50, 18h50, 23h50).
Para criar estas tarefas, siga as etapas a seguir:
- Acesse o Menu Ferramentas;
- Selecione Ferramentas;
- Em seguida, clique em Agenda de tarefas,
- Após isto, clique no botão Novo:
- Tarefa: Selecione Consulta de pagamentos e cobranças CrediSis Api;
- Minuto (0-59): Coloque o valor dos minutos, entre 0 e 59 min.
- Hora (0-23): Coloque o valor da hora, entre 0 e 23. Podendo incluir mais horários utilizando a vírgula, exemplo:
- Horas (0-23): 6,12,18,23
Após configurado, sua agenda de tarefas ficará desta maneira:
Caso deseje um intervalo de consulta reduzido, por exemplo, executar a tarefa a cada 30 minutos, é possível. Porém, ressaltamos o risco de gerar lentidão e possíveis travamentos em seu servidor.
Sempre busque horários em que não vá conflitar com demais tarefas em seu servidor. E procure o seu setor de TI para analisar o impacto em seu servidor.
Para configurar a tarefa a cada 30 minutos, você pode inserir os valores nos campos:
Minuto (0-59): */30
Hora (0-23): */1
Desta forma, o seu servidor irá executar a tarefa a cada hora do dia, com um intervalo de 30 minutos.
Retorne ao menu API Bancária
Retorne ao menu Carteira de Cobrança