756 – BANCO COOPERATIVO DO BRASIL S.A. (BANCOOB/SICOOB) na API do Maker
Integração via WebService
Versão inicial: 1.1.0
Identificação: “756“, “BANCOOB”.
Site: https://www.sicoob.com.br
Parâmetros obrigatórios
- AGENCIA_NUMERO – (Letras ou Inteiro) Agência com quatro dígitos, sem do digíto verificador (DV) / (Cooperativa);
- AGENCIA_DV – (Letras ou Inteiro) Dígito verificador da agência com uma única posição (Cooperativa DV);
- CARTEIRA – (Letras ou Inteiro) Um dígito indicando a carteira: “1”, “3”, “9”, …;
- CARTEIRA_MODALIDADE – (Letras ou Inteiro) Dois dígitos indicando a carteira: “01”, “02”, “03”, …;
- CONTA_CORRENTE_NUMERO – (Letras ou Inteiro) Conta corrente com sete dígitos sem o DV;
- CONTA_CORRENTE_DV – Somente o dígito verificador da conta corrente com 1 caracter (Letras ou Inteiro);
- NOSSO_NUMERO – (Letras) Número sequencial único com 07 posições que identifica a cobrança no banco e no seu sistema, este será o código compartilhado e será retornado pelo banco nos arquivos de retorno, assim como no extrato da conta;
- CARTEIRA_CONVENIO – Número do Cliente;
- CARTEIRA_CONVENIO_DV – Digito verificador do número do cliente.
- DATA_VENCIMENTO – (Data) Data de vencimento do boleto;
- VALOR (Número) – Valor nominal do boleto, número com até 2 casas decimais.
Parâmetros opcionais
- PARCELA (Número) – Número da parcela, padrão “001”.
Arquivo de Remessa
Para envio de arquivos de remessa adicione além dos dados básicos as seguintes informações.
Cabeçalho/Criação da remessa
- BENEFICIARIO_DOCUMENTO – ;
- BENEFICIARIO_NOME – ;
- AGENCIA_NUMERO – ;
- AGENCIA_DV – ;
- CONTA_CORRENTE_NUMERO – Número com 8 digitos;
- CONTA_CORRENTE_DV – DV com 1 digito;
- CARTEIRA_CONVENIO – Número do Cliente;
- CARTEIRA_CONVENIO_DV – Digito verificador do número do cliente;
- LOTE_LAYOUT_VERSAO (Opcional) Letras, padrão “045”;
- ARQUIVO_LAYOUT_VERSAO (Opcional) Letras, padrão “087”.
Detalhe/Boleto
- JUROS_PERCENTUAL_MENSAL – Informar o valor percentual de juros por mês, EX: para 2,5o% informar: 2.5;
- MULTA_ATRASO_PERCENTUAL – ;
- DATA_EMISSAO – Data da emissão do titulo (Se deixar em branco será usado hoje).
- DOCUMENTO_ESPECIE – Espécie do Título :
01 = Duplicata Mercantil
02 = Nota Promissória
03 = Nota de Seguro
05 = Recibo
06 = Duplicata Rural
08 = Letra de Câmbio
09 = Warrant
10 = Cheque
12 = Duplicata de Serviço
13 = Nota de Débito
14 = Triplicata Mercantil
15 = Triplicata de Serviço
18 = Fatura
20 = Apólice de Seguro
21 = Mensalidade Escolar
22 = Parcela de Consórcio
99 = Outros. - INSTRUCAO_COBRANCA1 e INSTRUCAO_COBRANCA2: Primeira e segunda instrução codificada:
Regras de impressão de mensagens nos boletos:
* Primeira instrução (SEQ 34) = 00 e segunda (SEQ 35) = 00, não imprime nada.
* Primeira instrução (SEQ 34) = 01 e segunda (SEQ 35) = 01, desconsidera-se as instruções CNAB e imprime as mensagens relatadas no trailler do arquivo.
* Primeira e segunda instrução diferente das situações acima, imprimimos o conteúdo CNAB:
00 = AUSENCIA DE INSTRUCOES
01 = COBRAR JUROS
03 = PROTESTAR 3 DIAS UTEIS APOS VENCIMENTO
04 = PROTESTAR 4 DIAS UTEIS APOS VENCIMENTO
05 = PROTESTAR 5 DIAS UTEIS APOS VENCIMENTO
07 = NAO PROTESTAR
10 = PROTESTAR 10 DIAS UTEIS APOS VENCIMENTO
15 = PROTESTAR 15 DIAS UTEIS APOS VENCIMENTO
20 = PROTESTAR 20 DIAS UTEIS APOS VENCIMENTO
22 = CONCEDER DESCONTO SO ATE DATA ESTIPULADA
42 = DEVOLVER APOS 15 DIAS VENCIDO
43 = DEVOLVER APOS 30 DIAS VENCIDO.
Integração via WebService
A integração é feita através da API V2.
Configuração da conexão
Para inicializar a conexão devem ser passados os seguintes parâmetros:
- CLIENT_ID (Letras) – Identificador único do aplicativo cliente (UUID/GUID);
- CERTIFICADO_ARQUIVO – Caminho completo do certificado (A1) que será utilizado na conexão, no formato (PKCS12 / PFX) (Ver mais na Documentação do SICOOB);
- CERTIFICADO_SENHA (Letras) – Senha do certificado;
- BENEFICIARIO_DOCUMENTO (Letras) – Documento (CNPJ) do recebedor/beneficiário do boleto;
- CARTEIRA_CONVENIO (Letras) – Número do cliente – “Número do contrato: Número que identifica o beneficiário na plataforma de atendimento da cooperativa.”.
Cadastro de Boletos
Usar a função “Boleto – WebService – Incluir Boleto” passando os dados de registros, com as seguintes observações:
- NOSSO_NUMERO (Inteiro): Não informar, será gerado e retornado pelo banco;
- INSTRUCOES (Letras): Um texto com até 5 linhas, cada linha será uma mensagem com o máximo de 40 caracteres;
- BOLETO_GERAR_PDF (Lógico): Indica se será retornado o PDF, por padrão é Falso, para retornar o PDF coloque Verdadeiro (True).
Consultar Situação do Boleto
Para consultar a situação do boleto você deve chamar a função “Boleto – WebService – Consultar Boleto” e passar um mapeamento com um ou mais dos seguintes itens:
- NOSSO_NUMERO (Letras): Nosso número do boleto a pesquisar;
- LINHA_DIGITAVEL (Letras): Linha digitável do boleto a ser pesquisado;
- CODIGO_BARRAS (Letras): Código de barras do boleto a ser pesquisado;
Para que a consulta retorne uma segunda via do boleto, no mapa um PDF do boleto adicione o seguinte item:
- BOLETO_GERAR_PDF (Lógico): Indica se será retornado o PDF, por padrão é Falso, para retornar o PDF coloque Verdadeiro (True).
OBSERVAÇÃO: Se o boleto já tiver sido pago, ou não puder ser reemitido, a opção de emitir PDF retornará um conteúdo VAZIO. Use a consulta SEM gerar o PDF para obter os detalhes.
No retorno virá, entre outras informações, a situação do boleto, indicando se ele já foi quitado no item “BOLETO_SITUACAO“.
Configuração do Java
O servidor do Sicoob usa criptografia que pode exigir configuração adicional no Java do servidor.
O erro impede a conexão/comunicação e nos logs é retratado com a mensagem:
javax.net.ssl.SSLProtocolException: The size of the handshake message (X) exceeds the maximum allowed size (Y)
Para efetuar a configuração basta adicionar o parâmetro “jdk.tls.maxHandshakeMessageSize” com o valor “130702” na inicialização da JVM. Ficando a linha completa assim:
-Djdk.tls.maxHandshakeMessageSize=130702
Esta configuração é adicionada no final das demais, conforme apontado na imagem a seguir:
Mais informações:
https://support.oracle.com/knowledge/Middleware/2794333_1.html