Blog

033 – Santander

30 de outubro de 2015 - Posted by: - In category: Carteiras bancárias - No responses

Identificação: “33“, “033” ou “Santander“

Geração de boleto

Além dos dados gerais, esses itens devem ser especialmente preenchidos:

  • BENEFICIARIO_COD_CLIENTE – 07 dígitos;
  • CONTA_CORRENTE_NUMERO – 05 dígitos;
  • NOSSO_NUMERO – Até 12 dígitos;
  • CARTEIRA – 03 dígitos;
  • CONVENIO_NUMERO (Letras);
  • IOS  – (Letras) padrão “0”.

WebService

Para usar o registro de boleto on-line (via WebService) voce deve ter acesso a área de desenvolvedor (https://developer.santander.com.br/), os devem ser passados os seguintes parâmetros na criação da conexão (função ‘Boleto – WebService – Inicializar‘):

  1. Código do banco Santander: “033” (Letras);
  2. Verdadeiro ou Falso indicando se é produção;
  3. Mapa com as configurações:
  • CLIENT_ID (Letras): Fornecido pelo banco.
  • CLIENT_SECRET (Letras): Fornecido pelo banco.
  • CONVENIO_NUMERO (Letras): Fornecido pelo banco;
  • WORKSPACE_ID (Letras): Um UUID para identificar o grupo de boletos (EX: ‘00000000-0000-0000-0000-000000000000‘ – esse é inválido, deve-se passar um válido), este item é obrigatório, caso não exista será necessário passar o WORKSPACE_CREATE como verdadeiro para criar a primeira vez;
  • WORKSPACE_CREATE (Lógico): Se passar como verdadeiro o Workspace será criado automaticamente caso não exista.
  • BOLETO_GERAR_PIX (Lógico): Indica se um PIX deve ser criado e vinculado ao boleto. Se for verdadeiro deve ser informado os dois itens seguintes.
  • PIX_RECEBEDOR_CHAVE_TIPO (Letras): Tipo da chave PIX: “EMAIL“, “CPF“, “CNPJ“, “CELULAR“, ou “EVP” (chave aleatória);
  • PIX_RECEBEDOR_CHAVE_CODIGO (Letras): Chave PIX que irá ser usada no recebimento.

Certificado é obrigatório.

Deve ser adicionado em forma PKCS12 (*.pfx) ou PEM (*.key e *.cer).

Se for no padrão PKCS12:

  • CERTIFICADO_PFX (Letras): Caminho completo do arquivo com o certificado usado na conexão com o banco (e-CNPJ do titular da conta);
  • CERTIFICADO_SENHA (Letras): Senha do arquivo de certificado (PFX);

Se for no padrão PEM:

  • CER (Letras): Certificado em formato PEM (texto em base64);
  • KEY (Letras): Chave privada do certificado PEM (texto em base64);

Após inicializar você pode enviar novos boletos para registro imediato, bem como consultar a situação dos boletos, bem como baixar (cancelar) um boleto em cobrança.

Registro de boleto via WebService

No registro deve ser enviado o maior número de dados do boleto. O retorno deve ser salvo para posterior consulta ou baixa. Para emissão do PIX adicione o parâmetro “BOLETO_GERAR_PIX” como verdadeiro.

Na emissão o item “DATA_EMISSAO” (Data) deve ser preenchido ( issueDate ).

A multa deve ser informada através do item: “MULTA_ATRASO_PERCENTUAL” vai para “interestPercentage”, (Fracionado) 12,34 = 12,34% se atrasar.

O percentual de juros deve ser informado com “JUROS_PERCENTUAL_MENSAL” (Fracionado), 5.25 = 5,25% por mês, ele preenche o item “finePercentage”.

Consulta de boleto via WebService

Após inicializar você pode consultar os boletos registrados através da função “Boleto – WebService – Consultar Boleto“, no mapa deve ser informado os seguintes itens:

  • NOSSO_NUMERO (Letras);
  • CONVENIO_NUMERO (Letras);
  • PAGADOR_DOCUMENTO (Letras): Informar o CPF/CNPJ do devedor/pagador.

Observações sobre o WebService

  1. O ambiente de homologação/testes é ‘mockado’, ou seja, ele retorna dados simulados / fixos, não tem as mesmas validações do ambiente de produção. Após testes básicos pode ser fazer necessário adaptações no ambiente de produção. (Revisado em 10/02/2026).
  2. O retorno do arquivo PDF não está disponível em homologação (revisado em 12/03/2026).

Remessa CNAB

Na criação da remessa informar:

  • BENEFICIARIO_CODIGO: Código de Transmissão (nota 1). Informação cedida pelo banco que identifica o arquivo remessa do cliente

Nos boletos/itens da remessa, informar:

  • PAGADOR_DOCUMENTO – CPF ou CNPJ do pagador;
  • DOCUMENTO_DESCRICAO – Informar a identificação do titulo na empresa;
  • CARTEIRA_CODIGO – Com 1 digito, sendo:

    1 = ELETRÔNICA COM REGISTRO

    2 = ELETRÔNICA COM REGISTRO

    3 = CAUCIONADA ELETRÔNICA

    5 = RÁPIDA COM REGISTRO (BLOQUETE EMITIDO PELO CLIENTE).
  • OPERACAO – Com dois digitos, sendo:

    01 = ENTRADA DE TÍTULO

    02 = BAIXA DE TÍTULO

    04 = CONCESSÃO DE ABATIMENTO

    05 = CANCELAMENTO ABATIMENTO

    06 = PRORROGAÇÃO DE VENCIMENTO

    07 = ALT. NÚMERO CONT.CEDENTE

    08 = ALTERAÇÃO DO SEU NÚMERO

    09 = PROTESTAR

    18 = SUSTAR PROTESTO
  • DOCUMENTO_ESPECIE: Espécie de documento:

    01 = DUPLICATA

    02 = NOTA PROMISSÓRIA

    03 = APÓLICE / NOTA DE SEGURO

    05 = RECIBO

    06 = DUPLICATA DE SERVIÇO

    07 = LETRA DE CAMBIO

Leave a comment