{"id":90,"date":"2015-10-30T17:37:14","date_gmt":"2015-10-30T20:37:14","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=90"},"modified":"2026-04-01T10:39:58","modified_gmt":"2026-04-01T13:39:58","slug":"033-santander","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2015\/10\/033-santander\/","title":{"rendered":"033 &#8211; Santander"},"content":{"rendered":"\n<p>Identifica\u00e7\u00e3o: &#8220;<strong>33<\/strong>&#8220;, &#8220;<strong>033<\/strong>&#8221; ou &#8220;<strong>Santander<\/strong>&#8220;<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Gera\u00e7\u00e3o de boleto<\/h1>\n\n\n\n<p>Al\u00e9m dos dados gerais, esses itens devem ser especialmente preenchidos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>BENEFICIARIO_COD_CLIENTE<\/strong> &#8211; 07 d\u00edgitos;<\/li>\n\n\n\n<li><strong>CONTA_CORRENTE_NUMERO<\/strong> &#8211; 05 d\u00edgitos;<\/li>\n\n\n\n<li><strong>NOSSO_NUMERO<\/strong> &#8211; At\u00e9 12 d\u00edgitos;<\/li>\n\n\n\n<li><strong>CARTEIRA<\/strong> &#8211; 03 d\u00edgitos;<\/li>\n\n\n\n<li><strong>CONVENIO_NUMERO<\/strong> (Letras);<\/li>\n\n\n\n<li><strong>IOS &nbsp;<\/strong>&#8211; (Letras) padr\u00e3o &#8220;0&#8221;.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">WebService<\/h2>\n\n\n\n<p>Para usar o registro de boleto on-line (via WebService)  voce deve ter acesso a \u00e1rea de desenvolvedor (<a href=\"https:\/\/developer.santander.com.br\/\">https:\/\/developer.santander.com.br\/<\/a>), os devem ser passados os seguintes par\u00e2metros na cria\u00e7\u00e3o da conex\u00e3o (fun\u00e7\u00e3o &#8216;<strong>Boleto &#8211; WebService &#8211; Inicializar<\/strong>&#8216;):<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>C\u00f3digo do banco Santander: &#8220;033&#8221; (Letras);<\/li>\n\n\n\n<li>Verdadeiro ou Falso indicando se \u00e9 produ\u00e7\u00e3o;<\/li>\n\n\n\n<li>Mapa com as configura\u00e7\u00f5es:<\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CLIENT_ID <\/strong>(Letras): Fornecido pelo banco.<\/li>\n\n\n\n<li><strong>CLIENT_SECRET <\/strong>(Letras): Fornecido pelo banco.<\/li>\n\n\n\n<li><strong>CONVENIO_NUMERO <\/strong>(Letras): Fornecido pelo banco;<\/li>\n\n\n\n<li><strong>WORKSPACE_ID <\/strong>(Letras): Um UUID para identificar o grupo de boletos (EX: &#8216;<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">00000000-0000-0000-0000-000000000000<\/mark><\/strong>&#8216; &#8211; esse \u00e9 inv\u00e1lido, deve-se passar um v\u00e1lido), este item \u00e9 <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">obrigat\u00f3rio<\/mark><\/strong>, caso n\u00e3o exista ser\u00e1 necess\u00e1rio passar o <strong>WORKSPACE_CREATE <\/strong>como verdadeiro para criar a primeira vez;\n<ul class=\"wp-block-list\">\n<li>Um UUID v\u00e1lido pode ser gerado nesse site: <a href=\"https:\/\/www.uuidgenerator.net\/version4\">https:\/\/www.uuidgenerator.net\/version4<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>WORKSPACE_CREATE <\/strong>(L\u00f3gico): Se passar como verdadeiro o Workspace ser\u00e1 criado automaticamente caso n\u00e3o exista.<\/li>\n\n\n\n<li><strong>BOLETO_GERAR_PIX <\/strong>(L\u00f3gico): Indica se um PIX deve ser criado e vinculado ao boleto. Se for verdadeiro deve ser informado os dois itens seguintes.<\/li>\n\n\n\n<li><strong>PIX_RECEBEDOR_CHAVE_TIPO <\/strong>(Letras): Tipo da chave PIX: &#8220;<strong>EMAIL<\/strong>&#8220;, &#8220;<strong>CPF<\/strong>&#8220;, &#8220;<strong>CNPJ<\/strong>&#8220;, &#8220;<strong>CELULAR<\/strong>&#8220;, ou &#8220;<strong>EVP<\/strong>&#8221; (chave aleat\u00f3ria);<\/li>\n\n\n\n<li><strong>PIX_RECEBEDOR_CHAVE_CODIGO <\/strong>(Letras): Chave PIX que ir\u00e1 ser usada no recebimento.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Certificado \u00e9 <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">obrigat\u00f3rio<\/mark>.<\/h4>\n\n\n\n<p>Deve ser adicionado em forma PKCS12 (*.pfx) ou PEM (*.key e *.cer). <\/p>\n\n\n\n<p>Se for no padr\u00e3o PKCS12:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CERTIFICADO_PFX <\/strong>(Letras): Caminho completo do arquivo com o certificado usado na conex\u00e3o com o banco (e-CNPJ do titular da conta);<\/li>\n\n\n\n<li><strong>CERTIFICADO_SENHA <\/strong>(Letras): Senha do arquivo de certificado (PFX);<\/li>\n<\/ul>\n\n\n\n<p>Se for no padr\u00e3o PEM:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CER  <\/strong>(Letras): Certificado em formato PEM (texto em base64);<\/li>\n\n\n\n<li><strong>KEY <\/strong>(Letras): Chave privada do certificado PEM (texto em base64);<\/li>\n<\/ul>\n\n\n\n<p>Ap\u00f3s inicializar voc\u00ea pode enviar novos boletos para registro imediato, bem como consultar a situa\u00e7\u00e3o dos boletos, bem como baixar (cancelar) um boleto em cobran\u00e7a.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Registro de boleto via WebService<\/h3>\n\n\n\n<p>No registro deve ser enviado o maior n\u00famero de dados do boleto. O retorno deve ser salvo para posterior consulta ou baixa. Para emiss\u00e3o do PIX adicione o par\u00e2metro &#8220;<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">BOLETO_GERAR_PIX<\/mark><\/strong>&#8221; como verdadeiro.<\/p>\n\n\n\n<p>Na emiss\u00e3o o item &#8220;<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">DATA_EMISSAO<\/mark><\/strong>&#8221; (Data) deve ser preenchido ( issueDate ).<\/p>\n\n\n\n<p>A multa deve ser informada atrav\u00e9s do item: &#8220;<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">MULTA_ATRASO_PERCENTUAL<\/mark><\/strong>&#8221; vai para &#8220;interestPercentage&#8221;, (Fracionado) 12,34 = 12,34% se atrasar.<\/p>\n\n\n\n<p>O percentual de juros deve ser informado com &#8220;<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">JUROS_PERCENTUAL_MENSAL<\/mark><\/strong>&#8221; (Fracionado), 5.25 = 5,25% por m\u00eas, ele preenche o item &#8220;finePercentage&#8221;.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Consulta de boleto via WebService<\/h3>\n\n\n\n<p>Ap\u00f3s inicializar voc\u00ea pode consultar os boletos registrados atrav\u00e9s da fun\u00e7\u00e3o &#8220;<strong>Boleto &#8211; WebService &#8211; Consultar Boleto<\/strong>&#8220;, no mapa deve ser informado os seguintes itens:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>NOSSO_NUMERO<\/strong> (Letras);<\/li>\n\n\n\n<li><strong>CONVENIO_NUMERO <\/strong>(Letras);<\/li>\n\n\n\n<li><strong>PAGADOR_DOCUMENTO<\/strong> (Letras): Informar o CPF\/CNPJ do devedor\/pagador.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Observa\u00e7\u00f5es sobre o WebService<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>O ambiente de homologa\u00e7\u00e3o\/testes \u00e9 &#8216;mockado&#8217;, ou seja, ele retorna dados simulados \/ fixos, n\u00e3o tem as mesmas valida\u00e7\u00f5es do ambiente de produ\u00e7\u00e3o. Ap\u00f3s testes b\u00e1sicos pode ser fazer necess\u00e1rio adapta\u00e7\u00f5es no ambiente de produ\u00e7\u00e3o. (Revisado em 10\/02\/2026).<\/li>\n\n\n\n<li>O retorno do arquivo PDF n\u00e3o est\u00e1 dispon\u00edvel em homologa\u00e7\u00e3o (revisado em 12\/03\/2026).<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h1 class=\"wp-block-heading\">Remessa CNAB<\/h1>\n\n\n\n<p>Na cria\u00e7\u00e3o da remessa informar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>BENEFICIARIO_CODIGO<\/strong>:&nbsp;C\u00f3digo de Transmiss\u00e3o (nota 1).&nbsp;Informa\u00e7\u00e3o cedida pelo banco que identifica o arquivo remessa do cliente<\/li>\n<\/ul>\n\n\n\n<p>Nos boletos\/itens da remessa, informar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>PAGADOR_DOCUMENTO<\/strong> &#8211; CPF ou CNPJ do pagador;<\/li>\n\n\n\n<li><strong>DOCUMENTO_DESCRICAO<\/strong> &#8211; Informar a identifica\u00e7\u00e3o do titulo na empresa;<\/li>\n\n\n\n<li><strong>CARTEIRA_CODIGO<\/strong> &#8211; Com 1 digito, sendo:<br><br>1 = ELETR\u00d4NICA COM REGISTRO<br><br>2 = ELETR\u00d4NICA COM REGISTRO<br><br>3 = CAUCIONADA ELETR\u00d4NICA<br><br>5 = R\u00c1PIDA COM REGISTRO (BLOQUETE EMITIDO PELO CLIENTE).<\/li>\n\n\n\n<li><strong>OPERACAO<\/strong> &#8211; Com dois digitos, sendo:<br><br>01 = ENTRADA DE T\u00cdTULO<br><br>02 = BAIXA DE T\u00cdTULO<br><br>04 = CONCESS\u00c3O DE ABATIMENTO<br><br>05 = CANCELAMENTO ABATIMENTO<br><br>06 = PRORROGA\u00c7\u00c3O DE VENCIMENTO<br><br>07 = ALT. N\u00daMERO CONT.CEDENTE<br><br>08 = ALTERA\u00c7\u00c3O DO SEU N\u00daMERO<br><br>09 = PROTESTAR<br><br>18 = SUSTAR PROTESTO<\/li>\n\n\n\n<li><strong>DOCUMENTO_ESPECIE<\/strong>: Esp\u00e9cie de documento:<br><br>01 = DUPLICATA<br><br>02 = NOTA PROMISS\u00d3RIA<br><br>03 = AP\u00d3LICE \/ NOTA DE SEGURO<br><br>05 = RECIBO<br><br>06 = DUPLICATA DE SERVI\u00c7O<br><br>07 = LETRA DE CAMBIO<\/li>\n<\/ul>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Identifica\u00e7\u00e3o: &#8220;33&#8220;, &#8220;033&#8221; ou &#8220;Santander&#8220; Gera\u00e7\u00e3o de boleto Al\u00e9m dos dados gerais, esses itens devem ser especialmente preenchidos: WebService Para usar o registro de boleto on-line (via WebService) voce deve ter acesso a \u00e1rea de desenvolvedor (https:\/\/developer.santander.com.br\/), os devem ser passados os seguintes par\u00e2metros na cria\u00e7\u00e3o da conex\u00e3o (fun\u00e7\u00e3o &#8216;Boleto &#8211; WebService &#8211; Inicializar&#8216;): Certificado [&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-90","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\/90","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=90"}],"version-history":[{"count":42,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/90\/revisions"}],"predecessor-version":[{"id":4281,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/90\/revisions\/4281"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=90"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=90"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=90"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}