Importar Boleto Já Registrado

Em alguns cenários, você pode ter boletos que já foram registrados diretamente no banco ou em outro sistema e deseja apenas gerar o PDF através do Boleto Cloud.

Quando Usar

Migração de outro sistema de boletos
Boletos registrados diretamente no internet banking
Integração com sistemas legados
Reimpressão de boletos já existentes

Como Funciona

Você informa todos os dados do boleto, incluindo o número/NIB já registrado
Define boleto.instrucao.registrar = false para evitar novo registro
O Boleto Cloud gera apenas o PDF sem enviar ao banco

Exemplo de Requisição

curl -X POST "https://sandbox.boletocloud.com/api/v1/boletos" \
  -u "api-key_SUA-API-KEY:token" \
  -d "boleto.conta.token=TOKEN_DA_CONTA" \
  -d "boleto.instrucao.registrar=false" \
  -d "boleto.numero=12345678901" \
  -d "boleto.emissao=2024-01-15" \
  -d "boleto.vencimento=2024-01-30" \
  -d "boleto.documento=EXT-001" \
  -d "boleto.titulo=DM" \
  -d "boleto.valor=750.00" \
  -d "boleto.pagador.nome=Roberto Lima" \
  -d "boleto.pagador.cprf=000.000.000-00" \
  -d "boleto.pagador.endereco.cep=00000-000" \
  -d "boleto.pagador.endereco.uf=BA" \
  -d "boleto.pagador.endereco.localidade=Salvador" \
  -d "boleto.pagador.endereco.bairro=Barra" \
  -d "boleto.pagador.endereco.logradouro=Av. Oceânica" \
  -d "boleto.pagador.endereco.numero=800" \
  -o boleto-externo.pdf

Response response = ClientBuilder.newClient()
    .target("https://sandbox.boletocloud.com/api/v1/boletos")
    .register(HttpAuthenticationFeature.basic("api-key_SUA-API-KEY", "token"))
    .request(WILDCARD)
    .post(Entity.form(new Form()
        .param("boleto.conta.token", "TOKEN_DA_CONTA")
        .param("boleto.instrucao.registrar", "false")
        .param("boleto.numero", "12345678901")
        .param("boleto.emissao", "2024-01-15")
        .param("boleto.vencimento", "2024-01-30")
        .param("boleto.documento", "EXT-001")
        .param("boleto.titulo", "DM")
        .param("boleto.valor", "750.00")
        .param("boleto.pagador.nome", "Roberto Lima")
        .param("boleto.pagador.cprf", "000.000.000-00")
        .param("boleto.pagador.endereco.cep", "00000-000")
        .param("boleto.pagador.endereco.uf", "BA")
        .param("boleto.pagador.endereco.localidade", "Salvador")
        .param("boleto.pagador.endereco.bairro", "Barra")
        .param("boleto.pagador.endereco.logradouro", "Av. Oceânica")
        .param("boleto.pagador.endereco.numero", "800")));

import requests
from requests.auth import HTTPBasicAuth

response = requests.post(
    'https://sandbox.boletocloud.com/api/v1/boletos',
    auth=HTTPBasicAuth('api-key_SUA-API-KEY', 'token'),
    data={
        'boleto.conta.token': 'TOKEN_DA_CONTA',
        'boleto.instrucao.registrar': 'false',
        'boleto.numero': '12345678901',
        'boleto.emissao': '2024-01-15',
        'boleto.vencimento': '2024-01-30',
        'boleto.documento': 'EXT-001',
        'boleto.titulo': 'DM',
        'boleto.valor': '750.00',
        'boleto.pagador.nome': 'Roberto Lima',
        'boleto.pagador.cprf': '000.000.000-00',
        'boleto.pagador.endereco.cep': '00000-000',
        'boleto.pagador.endereco.uf': 'BA',
        'boleto.pagador.endereco.localidade': 'Salvador',
        'boleto.pagador.endereco.bairro': 'Barra',
        'boleto.pagador.endereco.logradouro': 'Av. Oceânica',
        'boleto.pagador.endereco.numero': '800'
    }
)

if response.status_code == 201:
    with open('boleto-externo.pdf', 'wb') as f:
        f.write(response.content)

Parâmetros Importantes

Campo	Descrição
`boleto.numero`	Número/NIB do boleto já registrado no banco
`boleto.instrucao.registrar`	Deve ser `false` para não registrar novamente

Veja Também

Numeração (NIB) - Entenda o Número Identificador Bancário
Controlar Momento do Registro - Opções de controle de registro
Campos do Boleto - Todos os campos disponíveis
Criar Boleto - Referência completa de criação de boletos