{"id":340,"date":"2016-02-22T11:53:01","date_gmt":"2016-02-22T14:53:01","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=340"},"modified":"2025-08-08T11:48:43","modified_gmt":"2025-08-08T14:48:43","slug":"756-banco-cooperativo-do-brasil-s-a-bancoob","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2016\/02\/756-banco-cooperativo-do-brasil-s-a-bancoob\/","title":{"rendered":"756 &#8211; BANCO COOPERATIVO DO BRASIL S.A. (BANCOOB\/SICOOB) na API do Maker"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Integra\u00e7\u00e3o via WebService<\/h2>\n\n\n\n<p>Vers\u00e3o inicial: 1.1.0<\/p>\n\n\n\n<p>Identifica\u00e7\u00e3o: \u201c<strong>756<\/strong>\u201c, \u201c<strong>BANCOOB<\/strong>\u201d.<\/p>\n\n\n\n<p>Site: <a href=\"https:\/\/www.sicoob.com.br\">https:\/\/www.sicoob.com.br<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Par\u00e2metros obrigat\u00f3rios<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>AGENCIA_NUMERO<\/strong> \u2013 (Letras ou Inteiro) Ag\u00eancia com quatro d\u00edgitos, sem do dig\u00edto verificador (DV) \/ (Cooperativa);<\/li>\n\n\n\n<li><strong>AGENCIA_DV<\/strong> \u2013 (Letras ou Inteiro) D\u00edgito verificador da ag\u00eancia com uma \u00fanica posi\u00e7\u00e3o (Cooperativa DV);<\/li>\n\n\n\n<li><strong>CARTEIRA<\/strong> \u2013 (Letras ou Inteiro) Um&nbsp;d\u00edgito indicando a carteira: &#8220;1&#8221;, &#8220;3&#8221;, &#8220;9&#8221;, \u2026;<\/li>\n\n\n\n<li><strong>CARTEIRA_MODALIDADE<\/strong> \u2013 (Letras ou Inteiro) Dois d\u00edgitos indicando a carteira: &#8220;01&#8221;, &#8220;02&#8221;, &#8220;03&#8221;, \u2026;<\/li>\n\n\n\n<li><strong>CONTA_CORRENTE_NUMERO<\/strong> \u2013 (Letras ou Inteiro) Conta corrente com sete d\u00edgitos sem o DV;<\/li>\n\n\n\n<li><strong>CONTA_CORRENTE_DV<\/strong> \u2013 Somente o d\u00edgito verificador da conta corrente com 1 caracter&nbsp;(Letras ou Inteiro);<\/li>\n\n\n\n<li><strong>NOSSO_NUMERO<\/strong> \u2013 (Letras) N\u00famero sequencial \u00fanico com 07 posi\u00e7\u00f5es que identifica a cobran\u00e7a no banco e no seu sistema, este ser\u00e1 o c\u00f3digo compartilhado e ser\u00e1 retornado pelo banco nos arquivos de retorno, assim como no extrato da conta;<\/li>\n\n\n\n<li><strong>CARTEIRA_CONVENIO<\/strong> &#8211; N\u00famero do Cliente;<\/li>\n\n\n\n<li><strong>CARTEIRA_CONVENIO_DV<\/strong> &#8211; Digito verificador do n\u00famero do cliente.<\/li>\n\n\n\n<li><strong>DATA_VENCIMENTO<\/strong> \u2013 (Data) Data de vencimento do boleto;<\/li>\n\n\n\n<li><strong>VALOR_BOLETO<\/strong> (N\u00famero) \u2013 Valor nominal do boleto, n\u00famero com at\u00e9 2 casas decimais.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Par\u00e2metros opcionais<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><b>PARCELA<\/b> (N\u00famero) \u2013 N\u00famero da parcela, padr\u00e3o &#8220;001&#8221;.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Arquivo de Remessa<\/h2>\n\n\n\n<p>Para envio de arquivos de remessa adicione al\u00e9m dos dados b\u00e1sicos as seguintes informa\u00e7\u00f5es.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Cabe\u00e7alho\/Cria\u00e7\u00e3o da remessa<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>BENEFICIARIO_DOCUMENTO<\/strong> &#8211; ;<\/li>\n\n\n\n<li><strong>BENEFICIARIO_NOME<\/strong> &#8211; ;<\/li>\n\n\n\n<li><strong>AGENCIA_NUMERO<\/strong> &#8211; ;<\/li>\n\n\n\n<li><strong>AGENCIA_DV<\/strong> &#8211; ;<\/li>\n\n\n\n<li><strong>CONTA_CORRENTE_NUMERO<\/strong> &#8211; N\u00famero com 8 digitos;<\/li>\n\n\n\n<li><strong>CONTA_CORRENTE_DV<\/strong> &#8211; DV com 1 digito;<\/li>\n\n\n\n<li><strong>CARTEIRA_CONVENIO<\/strong> &#8211; N\u00famero do Cliente;<\/li>\n\n\n\n<li><strong>CARTEIRA_CONVENIO_DV<\/strong> &#8211; Digito verificador do n\u00famero do cliente;<\/li>\n\n\n\n<li><strong>LOTE_LAYOUT_VERSAO<\/strong> (Opcional) Letras, padr\u00e3o &#8220;045&#8221;;<\/li>\n\n\n\n<li><strong>ARQUIVO_LAYOUT_VERSAO<\/strong> (Opcional) Letras, padr\u00e3o &#8220;087&#8221;.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Detalhe\/Boleto<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>JUROS_PERCENTUAL_MENSAL &#8211; Informar o valor percentual de juros&nbsp;por m\u00eas, EX: para 2,5o% informar: 2.5;<\/li>\n\n\n\n<li>MULTA_ATRASO_PERCENTUAL &#8211; ;<\/li>\n\n\n\n<li>DATA_EMISSAO &#8211; Data da emiss\u00e3o do titulo (Se deixar em branco ser\u00e1 usado hoje).<\/li>\n\n\n\n<li>DOCUMENTO_ESPECIE &#8211; Esp\u00e9cie do T\u00edtulo :<br>01 = Duplicata Mercantil<br>02 = Nota Promiss\u00f3ria<br>03 = Nota de Seguro<br>05 = Recibo<br>06 = Duplicata Rural<br>08 = Letra de C\u00e2mbio<br>09 = Warrant<br>10 = Cheque<br>12 = Duplicata de Servi\u00e7o<br>13 = Nota de D\u00e9bito<br>14 = Triplicata Mercantil<br>15 = Triplicata de Servi\u00e7o<br>18 = Fatura<br>20 = Ap\u00f3lice de Seguro<br>21 = Mensalidade Escolar<br>22 = Parcela de Cons\u00f3rcio<br>99 = Outros.<\/li>\n\n\n\n<li><strong>INSTRUCAO_COBRANCA1<\/strong> e&nbsp;<strong>INSTRUCAO_COBRANCA2<\/strong>: Primeira e segunda instru\u00e7\u00e3o codificada:<br>Regras de impress\u00e3o de mensagens nos boletos:<br>* Primeira instru\u00e7\u00e3o (SEQ 34) = 00 e segunda (SEQ 35) = 00, n\u00e3o imprime nada.<br>* Primeira instru\u00e7\u00e3o (SEQ 34) = 01 e segunda (SEQ 35) = 01, desconsidera-se as instru\u00e7\u00f5es CNAB e imprime as mensagens relatadas no trailler do arquivo.<br>* Primeira e segunda instru\u00e7\u00e3o diferente das situa\u00e7\u00f5es acima, imprimimos o conte\u00fado CNAB:<br>00 = AUSENCIA DE INSTRUCOES<br>01 = COBRAR JUROS<br>03 = PROTESTAR 3 DIAS UTEIS APOS VENCIMENTO<br>04 = PROTESTAR 4 DIAS UTEIS APOS VENCIMENTO<br>05 = PROTESTAR 5 DIAS UTEIS APOS VENCIMENTO<br>07 = NAO PROTESTAR<br>10 = PROTESTAR 10 DIAS UTEIS APOS VENCIMENTO<br>15 = PROTESTAR 15 DIAS UTEIS APOS VENCIMENTO<br>20 = PROTESTAR 20 DIAS UTEIS APOS VENCIMENTO<br>22 = CONCEDER DESCONTO SO ATE DATA ESTIPULADA<br>42 = DEVOLVER APOS 15 DIAS VENCIDO<br>43 = DEVOLVER APOS 30 DIAS VENCIDO.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Integra\u00e7\u00e3o via WebService<\/h1>\n\n\n\n<p>A integra\u00e7\u00e3o \u00e9 feita atrav\u00e9s da API V1, V2 ou V3.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Configura\u00e7\u00e3o da conex\u00e3o<\/h3>\n\n\n\n<p>Para inicializar a conex\u00e3o devem ser passados os seguintes par\u00e2metros:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CLIENT_ID <\/strong>(Letras) &#8211; Identificador \u00fanico do aplicativo cliente (UUID\/GUID);<\/li>\n\n\n\n<li><strong>CERTIFICADO_ARQUIVO <\/strong>&#8211; Caminho completo do certificado (A1) que ser\u00e1 utilizado na conex\u00e3o, no formato (PKCS12 \/ PFX) (Ver mais na <a rel=\"noreferrer noopener\" href=\"https:\/\/developers.sicoob.com.br\/portal\/documentacao?slugItem=seguranca&amp;slugSubItem=certificado-digital\" target=\"_blank\">Documenta\u00e7\u00e3o do SICOOB<\/a>);<\/li>\n\n\n\n<li><strong>CERTIFICADO_SENHA<\/strong> (Letras) &#8211; Senha do certificado;<\/li>\n\n\n\n<li><strong>BENEFICIARIO_DOCUMENTO<\/strong> (Letras) &#8211; Documento (CNPJ) do recebedor\/benefici\u00e1rio do boleto;<\/li>\n\n\n\n<li><strong>CARTEIRA_CONVENIO<\/strong> (Letras) &#8211; N\u00famero do cliente &#8211; &#8220;N\u00famero do contrato: N\u00famero que identifica o benefici\u00e1rio na plataforma de atendimento da cooperativa.&#8221;;<\/li>\n\n\n\n<li>&#8220;<strong>versao<\/strong>&#8221; (Letras): Par\u00e2metro opcional para informar a vers\u00e3o a ser utilizada (&#8220;v1&#8221;, &#8220;v2&#8221; ou &#8220;v3&#8221;).<\/li>\n<\/ul>\n\n\n\n<p><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Cadastro de Boletos<\/h3>\n\n\n\n<p>Usar a fun\u00e7\u00e3o &#8220;<strong>Boleto &#8211; WebService &#8211; Incluir Boleto<\/strong>&#8221; passando os dados de registros, com as seguintes observa\u00e7\u00f5es:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>NOSSO_NUMERO<\/strong>&nbsp;(Inteiro): <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">N\u00e3o informar<\/mark><\/strong>, ser\u00e1 gerado e retornado pelo banco;<\/li>\n\n\n\n<li><strong>DOCUMENTO_NUMERO<\/strong> (Letras): Define o campo &#8220;seuNumero&#8221;, que o Sicoob descreve como &#8220;N\u00famero identificador do boleto no sistema do benefici\u00e1rio.&#8221; (Tamanho m\u00e1ximo 18);<\/li>\n\n\n\n<li><strong>INSTRUCOES <\/strong>(Letras): Um texto com at\u00e9 5 linhas, cada linha ser\u00e1 uma mensagem com o m\u00e1ximo de 40 caracteres;<\/li>\n\n\n\n<li><strong>BOLETO_GERAR_PDF <\/strong>(L\u00f3gico): Indica se ser\u00e1 retornado o PDF, por padr\u00e3o \u00e9 Falso, para retornar o PDF coloque Verdadeiro (True).<br><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Consultar Situa\u00e7\u00e3o do Boleto<\/h2>\n\n\n\n<p>Para consultar a situa\u00e7\u00e3o do boleto voc\u00ea deve chamar a fun\u00e7\u00e3o &#8220;<strong>Boleto &#8211; WebService &#8211; Consultar&nbsp;Boleto<\/strong>&#8221; e passar um mapeamento com um ou mais dos seguintes itens:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>NOSSO_NUMERO <\/strong>(Letras): Nosso n\u00famero do boleto a pesquisar;<\/li>\n\n\n\n<li><strong>LINHA_DIGITAVEL <\/strong>(Letras): Linha digit\u00e1vel do boleto a ser pesquisado;<\/li>\n\n\n\n<li><strong>CODIGO_BARRAS <\/strong>(Letras): C\u00f3digo de barras do boleto a ser pesquisado;<\/li>\n<\/ul>\n\n\n\n<p>Para que a consulta retorne uma segunda via do boleto, no mapa um PDF do boleto adicione o seguinte item:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>BOLETO_GERAR_PDF <\/strong>(L\u00f3gico): Indica se ser\u00e1 retornado o PDF, por padr\u00e3o \u00e9 Falso, para retornar o PDF coloque Verdadeiro (True).<\/li>\n<\/ul>\n\n\n\n<p><strong>OBSERVA\u00c7\u00c3O:<\/strong> Se o boleto j\u00e1 tiver sido pago, ou n\u00e3o puder ser reemitido, a op\u00e7\u00e3o de emitir PDF retornar\u00e1 um conte\u00fado VAZIO. Use a consulta SEM gerar o PDF para obter os detalhes.<\/p>\n\n\n\n<p><\/p>\n\n\n\n<p>No retorno vir\u00e1, entre outras informa\u00e7\u00f5es, a situa\u00e7\u00e3o do boleto, indicando se ele j\u00e1 foi quitado no item &#8220;<strong>BOLETO_SITUACAO<\/strong>&#8220;.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Baixar Boleto<\/h2>\n\n\n\n<p>Para baixar (remover a cobran\u00e7a), utilize a fun\u00e7\u00e3o &#8220;Boleto &#8211; WebService &#8211; Baixar Boleto&#8221;, passando no par\u00e2metro com os dados do boleto uma mapa contendo:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>NOSSO_NUMERO <\/strong>(Letras): O mesmo valor usado na emiss\u00e3o (nossoNumero);<\/li>\n\n\n\n<li><strong>DOCUMENTO_NUMERO <\/strong>(Letras): O mesmo valor enviado na emiss\u00e3o (seuNumero).<\/li>\n<\/ul>\n\n\n\n<p>OBS: A modalidade \u00e9 sempre 1 (SIMPLES COM REGISTRO).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Configura\u00e7\u00e3o do Java<\/h2>\n\n\n\n<p>O servidor do Sicoob usa criptografia que pode exigir configura\u00e7\u00e3o adicional no Java do servidor.<\/p>\n\n\n\n<p>O erro impede a conex\u00e3o\/comunica\u00e7\u00e3o e nos logs \u00e9 retratado com a mensagem:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">javax.net.ssl.SSLProtocolException: The size of the handshake message (X) exceeds the maximum allowed size (Y)<\/pre>\n\n\n\n<p>Para mais informa\u00e7\u00f5es veja o t\u00f3pico: <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2023\/05\/configuracao-e-erros-do-java\/\" data-type=\"post\" data-id=\"2878\">Configura\u00e7\u00e3o e Erros do Java<\/a>, o t\u00f3pico &#8220;Erro de tamanho da mensagem de Handshake&#8221;<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Integra\u00e7\u00e3o via WebService Vers\u00e3o inicial: 1.1.0 Identifica\u00e7\u00e3o: \u201c756\u201c, \u201cBANCOOB\u201d. Site: https:\/\/www.sicoob.com.br Par\u00e2metros obrigat\u00f3rios Par\u00e2metros opcionais Arquivo de Remessa Para envio de arquivos de remessa adicione al\u00e9m dos dados b\u00e1sicos as seguintes informa\u00e7\u00f5es. Cabe\u00e7alho\/Cria\u00e7\u00e3o da remessa Detalhe\/Boleto Integra\u00e7\u00e3o via WebService A integra\u00e7\u00e3o \u00e9 feita atrav\u00e9s da API V1, V2 ou V3. Configura\u00e7\u00e3o da conex\u00e3o Para inicializar [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[27],"tags":[],"class_list":["post-340","post","type-post","status-publish","format-standard","hentry","category-boleto-bancario-carteiras-suportadas"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/340","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=340"}],"version-history":[{"count":64,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/340\/revisions"}],"predecessor-version":[{"id":4078,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/340\/revisions\/4078"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=340"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=340"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=340"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}