Mudanças entre as edições de "Integração API Sicredi"

De Tek-System Wiki
Ir para navegação Ir para pesquisar
Linha 184: Linha 184:


=== Outras Funcionalidades ===
=== Outras Funcionalidades ===
Processamentos específicos disponíveis nas grades referente as duplicatas em alguns cadastros do sistema como Contas a Receber, Borderô Remessa Bancária, Borderô de Recebimento e Ficha de Histórico do Cliente e Retorno Bancário.
Clicar com botão direito na grade, e verificar os processamentos disponíveis para cada cadastro.
==== SICREDI: Prorrogar Boleto ====
Efetuar a alteração da data de vencimento de um boleto. A data de vencimento consiste no último dia para pagamento do boleto sem acréscimo de multa, juros e outros.
Antes de executar o processamento para prorrogação, o usuário deverá efetuar a prorrogação do título no sistema. Após alteração realizada, executar o processamento para alteração no Sicredi.
Não é possível realizar prorrogação do boleto no mesmo dia da emissão.
==== SICREDI: Solicitar Baixa de Boleto ====
Baixar um boleto no Sicredi. O processo de baixa consiste na ação de invalidar o boleto.
Ao executar o título será baixado no Sicredi.
==== SICREDI: Verificar Situação do Boleto ====
Irá exibir informações da situação do título selecionado referente ao boleto no Sicredi.

Edição das 13h03min de 26 de julho de 2024

APIs de Recebimento Sicredi

Documentação para utilização das APIs de Cobrança do Sicredi para permitir realizar envio e retorno de remessas bancárias sem utilizar a troca de arquivos, além da emissão de Boletos Híbridos.

Boletos Híbridos

O boleto híbrido é o meio de cobrança que utiliza as funcionalidades do recebimento por PIX e por Boleto no mesmo documento de pagamento.

O recebimento por QRCode é identificado de forma imediata pelo Sicredi.

Credenciais

Será necessário contratar junto ao gerente da conta do Sicredi a modalidade da API para Cobrança Online. Ao contratar o produto, será disponibilizado o código do beneficiário (código do convênio) , importante para utilização da integração.

Será necessário acessar o portal de desenvolvedor do Sicredi (https://developer.sicredi.com.br/api-portal/pt-br) para criar as credenciais de Homologação e Produção.

Credenciais necessárias

  • Código do Beneficiário
  • Token (Homologação)
  • Token (Produção)

Configurações do Sistema

Necessário solicitar liberação da funcionalidade licenciada ao setor responsável: INTEGRACAO_API_SICREDI

Cadastro da Conta Corrente

Incluir ou alterar cadastro da conta corrente que será utilizada para integração com o Sicredi.

Preencher os dados:

  • Registro/Endereço: CNPJ/CEI, Inscrição Estadual e Endereço Completo;
  • Informações Bancárias: Banco, Agência, Conta e Digito Conta, Titular e Documento do Titular;
  • Padrões da Remessa: Descrição, Carteira, Lay-Out Remessa, Lay-Out Impressão Boleto;

Atenção aos campos:

  • Descrição Padrão de Remessa: preencher descrição como API_SICREDI;
  • Próximo Slip: Sem necessidade de informar, será gerado pelo Sicredi no momento da geração da remessa bancária;
  • Layout Config Remessa: Utilizar layout padrão SICREDI: INTEGRAÇÃO COM API – REMESSA;
  • Layout Config Boleto: Sem necessidade de configurar, boleto será impresso pelo Sicredi através da Api.

Configurações da Unidade de Codificação

Incluir na TekStore da conta do Suporte a unidade de codificação correspondente as configurações que serão utilizadas para Api do Sicredi. Seguir padrão JSON já conhecido para as demais integrações.

 Nome da Unit deverá ser P10_SICREDI_CONFIGURACAO_XXXX. Onde XXXX corresponde ao código do cliente cadastrado na Tek-System.

Exemplo de configuração:

[
  {
    "contaBancaria": 0,
    "ambiente": "HOMOLOGACAO", 
    "_comentario_": "Conta 0 - Usada em Requisições sem Autenticação - Não remover - É necessária!"      
  },
  {
    "contaBancaria": 0,
    "_comentario_": "Api Sicredi",
    "ambiente": "HOMOLOGACAO",
    "token_sandbox": "",    
    "token_producao": "",    
    "username_producao": "",
    "password_producao": "",
    "cooperativa": "",
    "posto": "",
    "codigoBeneficiario": "",
    "autoIncPadraoRemessa": 0,        
    "tipoTitulo": "A",
    "protestar": false,
    "diasAposVencimentoParaProtestar": 0,
    "instrucaoNegativacao": false,
    "diasAposVencimentoParaNegativar": 0,
    "vlrTxMulta": "00000.00",
    "diasAposVencimentoParaAceitarRecebimento": 0,
    "tipoDescontoBoleto": "B",
    "vlrDescontoAtencipado": "00000000000000.00",    
    "mensagemBoleto1": "",
    "mensagemBoleto2": "",
    "mensagemBoleto3": "",
    "mensagemBoleto4": "",                
    "tokenWebhookTekSystem": "",
    "urlWebhook": "" 
  }
]  

Descrição dos campos:

contaBancaria: Código da conta corrente do Sicredi cadastrada no sistema Tek-System;

ambiente: Informar qual ambiente a conta está sendo utilizada. PRODUCAO/HOMOLOGACAO;

token_sandbox: Token que será utilizado para geração do Token da API em ambiente Sandbox;

Observação sobre o ambiente Sandbox: Apesar de existir, não é possível realizar uma validação completa. Sugerimos que utilize o ambiente de produção com valores pequenos adotando alguns cuidados: 
a) Contate o gerente da conta para comunicar sobre o teste, solicitando isenção das taxas cobradas pelas operações;
b) Contate o contador da empresa solicitando orientações sobre a forma que irá conduzir os testes (considerando que haverá movimentação financeira na conta);
c) Após os testes, analise minunciosamente os extratos e relatórios de movimento na conta, observando os reflexos das operações. 

token_producao: Token gerado no Sicredi que será utilizado para geração do Token da API em ambiente Produção;

AutoIncPadraoRemessa: Corresponde a sequência do cadastro de padrão da remessa da conta corrente.

TipoTitulo: Indica a espécie do título que será enviado na remessa bancária. Utilizar A-Duplicata Mercantil Indicação;

protestar: Indicar true/false para protesto dos títulos. O protesto é a ação através da qual o portador de um título comercial cujo pagamento não foi efetuado dentro do prazo, garante seu pagamento por ações judiciais. Utilizar apenas se instrução de negativação não for utilizado;

diasAposVencimentoParaProtestar: Indica quantidade de dias após vencimento para protesto do título. Informar apenas se protestar for verdadeiro. Caso contrário, campo será desconsiderado;

instrucaoNegativacao: Indicar true/false para negativação dos títulos. A negativação é o ato de inserir uma pessoa em cadastros de maus pagadores, tais como Serasa e o Serviço Central de Proteção ao Crédito (SCPC), porque não pagou uma conta, uma prestação ou outra obrigação financeira. Utilizar apenas se instrução de protesto não for utilizado;

diasAposVencimentoParaNegativar: Indica quantidade de dias após vencimento para negativação do título. Informar apenas se protestar for verdadeiro. Caso contrário, campo será desconsiderado;

taxaMulta: Informar percentual para valor de multa. Ex: 02.00;

mensagemBoleto1: Primeira mensagem individual a ser impressa no boleto. Limite de 80 caracteres. Uso opcional;

mensagemBoleto2: Segunda mensagem individual a ser impressa no boleto. Limite de 80 caracteres. Uso opcional;

mensagemBoleto3: Terceira mensagem individual a ser impressa no boleto. Limite de 80 caracteres. Uso opcional;

mensagemBoleto4: Quarta mensagem individual a ser impressa no boleto. Limite de 80 caracteres. Uso opcional;

diasAposVencimentoParaAceitarRecebimento: indica a quantidade de dias corridos após Data de Vencimento, em que a cobrança do Boleto poderá ser paga;

tipoDescontoBoleto: indica o tipo de desconto do boleto. Podendo ser as opções: A - VALOR e B - PERCENTUAL;

tokenWebhookTekSystem: token da configuração do cliente cadastrada na TekHook.

urlWebhook: Url de callback que foi utilizada para registro no Sicredi.

Funcionalidades

 Antes de prosseguir, verifique se os processamentos específicos, indicadores e relatórios específicos foram liberados para o usuário responsável pela utilização da API.

Remessa Bancária

Gerar Remessa Bancária

Incluir remessa bancária dos títulos para gerar boletos.

ImgSicrediRemessa01.png

Os títulos não podem possuir informações de boletos já gerados. Estes campos são preenchidos pelo sistema após processar a remessa.

IntegracaoItau 002.png

Na aba de Totalização/Outras, em Geração, deverá ser informado o layout SICREDI: INTEGRAÇÃO COM API – REMESSA.

Campo de instrução deverá ser informado BOLETO(GERAR BOLETO HÍBRIDO). As demais opções ainda não estão disponíveis para utilização.

ImgSicrediRemessa02.png

Clique no botão Processar: O Sistema realizará a transmissão dos títulos para API do Sicredi.

Após finalizar o processo, será possível verificar a situação dos títulos no banco através dos Processamentos acessíveis na grade da guia Duplicatas do cadastro da Remessa ou na grade de duplicatas do cadastro de contas a receber (Menu Manutenção >> Contas a Receber).

ImgSicrediRemessa03.png

Retorno Bancário

Para incluir o retorno bancário processado via API, acesse no Módulo Financeiro o menu Integração >> Banco >> Retorno Bancário. Preencha as informações de conta e layout do arquivo.

Layout: TEK-> ITAU: INTEGRAÇÃO COM API – RETORNO 
ImgSicrediRetorno01.png

Ao clicar no botão 'Carregar', será informada a data do dia anterior para executar a consulta. O Sicredi não disponibiliza a informação de liquidações por período, sugerimos que seja processada a consulta referente a movimentação do dia anterior para capturar todas as informações registradas na data informada.

ImgSicrediRetorno02.png

Após executar o processamento, será salvo o arquivo.json com as informações das movimentações encontradas.

Clique no botão Interpretar para realizar a identificação dos títulos liquidados.
Clique no botão Gravar para aplicar as baixas identificadas. 

As informações de pagamento do boleto, seja por QRCode ou Código de Barras, podem ser visualizadas no arquivo de retorno de remessa disponibilizado diariamente pelo banco.

Na movimentação do boleto, serão informados o Código da Barras, Linha Digitável e a URL QRCode PIX.

Ret03.png

Outras Funcionalidades

Processamentos específicos disponíveis nas grades referente as duplicatas em alguns cadastros do sistema como Contas a Receber, Borderô Remessa Bancária, Borderô de Recebimento e Ficha de Histórico do Cliente e Retorno Bancário.

Clicar com botão direito na grade, e verificar os processamentos disponíveis para cada cadastro.

SICREDI: Prorrogar Boleto

Efetuar a alteração da data de vencimento de um boleto. A data de vencimento consiste no último dia para pagamento do boleto sem acréscimo de multa, juros e outros.

Antes de executar o processamento para prorrogação, o usuário deverá efetuar a prorrogação do título no sistema. Após alteração realizada, executar o processamento para alteração no Sicredi.

Não é possível realizar prorrogação do boleto no mesmo dia da emissão.

SICREDI: Solicitar Baixa de Boleto

Baixar um boleto no Sicredi. O processo de baixa consiste na ação de invalidar o boleto.

Ao executar o título será baixado no Sicredi.

SICREDI: Verificar Situação do Boleto

Irá exibir informações da situação do título selecionado referente ao boleto no Sicredi.