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