Boleto com Descontos

Você pode criar boletos com desconto para incentivar o pagamento antecipado. O desconto pode ser configurado até uma data limite ou aplicado de forma escalonada.

Tipos de Desconto

Tipo	Descrição
Valor fixo	Desconto de um valor absoluto (ex: R$ 10,00)
Percentual	Desconto de um percentual do valor (ex: 5%)

Exemplo com Desconto por Valor Fixo

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.emissao=2024-01-15" \
  -d "boleto.vencimento=2024-01-30" \
  -d "boleto.documento=DESC-001" \
  -d "boleto.titulo=DM" \
  -d "boleto.valor=500.00" \
  -d "boleto.desconto1.codigo=1" \
  -d "boleto.desconto1.data=2024-01-25" \
  -d "boleto.desconto1.valor=25.00" \
  -d "boleto.pagador.nome=Fernanda Costa" \
  -d "boleto.pagador.cprf=000.000.000-00" \
  -d "boleto.pagador.endereco.cep=00000-000" \
  -d "boleto.pagador.endereco.uf=RS" \
  -d "boleto.pagador.endereco.localidade=Porto Alegre" \
  -d "boleto.pagador.endereco.bairro=Moinhos de Vento" \
  -d "boleto.pagador.endereco.logradouro=Rua Padre Chagas" \
  -d "boleto.pagador.endereco.numero=300" \
  -o boleto-desconto.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.emissao", "2024-01-15")
        .param("boleto.vencimento", "2024-01-30")
        .param("boleto.documento", "DESC-001")
        .param("boleto.titulo", "DM")
        .param("boleto.valor", "500.00")
        .param("boleto.desconto1.codigo", "1")
        .param("boleto.desconto1.data", "2024-01-25")
        .param("boleto.desconto1.valor", "25.00")
        .param("boleto.pagador.nome", "Fernanda Costa")
        .param("boleto.pagador.cprf", "000.000.000-00")
        .param("boleto.pagador.endereco.cep", "00000-000")
        .param("boleto.pagador.endereco.uf", "RS")
        .param("boleto.pagador.endereco.localidade", "Porto Alegre")
        .param("boleto.pagador.endereco.bairro", "Moinhos de Vento")
        .param("boleto.pagador.endereco.logradouro", "Rua Padre Chagas")
        .param("boleto.pagador.endereco.numero", "300")));

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.emissao': '2024-01-15',
        'boleto.vencimento': '2024-01-30',
        'boleto.documento': 'DESC-001',
        'boleto.titulo': 'DM',
        'boleto.valor': '500.00',
        'boleto.desconto1.codigo': '1',
        'boleto.desconto1.data': '2024-01-25',
        'boleto.desconto1.valor': '25.00',
        'boleto.pagador.nome': 'Fernanda Costa',
        'boleto.pagador.cprf': '000.000.000-00',
        'boleto.pagador.endereco.cep': '00000-000',
        'boleto.pagador.endereco.uf': 'RS',
        'boleto.pagador.endereco.localidade': 'Porto Alegre',
        'boleto.pagador.endereco.bairro': 'Moinhos de Vento',
        'boleto.pagador.endereco.logradouro': 'Rua Padre Chagas',
        'boleto.pagador.endereco.numero': '300'
    }
)

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

Exemplo com Desconto Percentual

cURL

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.emissao=2024-01-15" \
  -d "boleto.vencimento=2024-01-30" \
  -d "boleto.documento=DESC-002" \
  -d "boleto.titulo=DM" \
  -d "boleto.valor=1000.00" \
  -d "boleto.desconto1.codigo=2" \
  -d "boleto.desconto1.data=2024-01-25" \
  -d "boleto.desconto1.taxa=5.00" \
  -d "boleto.pagador.nome=Fernanda Costa" \
  -d "boleto.pagador.cprf=000.000.000-00" \
  -d "boleto.pagador.endereco.cep=00000-000" \
  -d "boleto.pagador.endereco.uf=RS" \
  -d "boleto.pagador.endereco.localidade=Porto Alegre" \
  -d "boleto.pagador.endereco.bairro=Moinhos de Vento" \
  -d "boleto.pagador.endereco.logradouro=Rua Padre Chagas" \
  -d "boleto.pagador.endereco.numero=300" \
  -o boleto-desconto-percentual.pdf

Parâmetros de Desconto

Campo	Descrição
`boleto.desconto1.codigo`	`1` = Valor fixo, `2` = Percentual
`boleto.desconto1.data`	Data limite para o desconto
`boleto.desconto1.valor`	Valor do desconto (quando código = 1)
`boleto.desconto1.taxa`	Percentual do desconto (quando código = 2)

Veja Também

Sobrescrever Multa e Juros - Configurar encargos
Criar Boleto - Referência completa de criação de boletos
Campos do Boleto - Todos os campos disponíveis
Obter PDF Atualizado - PDF com encargos calculados