Configurar Multa e Juros por Boleto

Como Sobrescrever Multa e Juros

Por padrão, os valores de multa e juros são definidos no cadastro da conta bancária. Porém, você pode sobrescrever esses valores em cada boleto individualmente.

Quando Usar

• Promoções com condições especiais
• Acordos comerciais específicos
• Boletos com regras diferenciadas por cliente
• Negociações de dívidas

Configurações de Multa

Campo	Descrição
boleto.multa.codigo	1 = Valor fixo, 2 = Percentual
boleto.multa.data	Data a partir da qual a multa é cobrada
boleto.multa.valor	Valor da multa (quando código = 1)
boleto.multa.taxa	Percentual da multa (quando código = 2)

Configurações de Juros

Campo	Descrição
boleto.juros.codigo	1 = Valor por dia, 2 = Percentual ao mês
boleto.juros.data	Data a partir da qual os juros são cobrados
boleto.juros.valor	Valor dos juros por dia (quando código = 1)
boleto.juros.taxa	Percentual dos juros ao mês (quando código = 2)

Exemplo com Multa e Juros Personalizados

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=MJ-001" \
  -d "boleto.titulo=DM" \
  -d "boleto.valor=800.00" \
  -d "boleto.multa.codigo=2" \
  -d "boleto.multa.data=2024-01-31" \
  -d "boleto.multa.taxa=2.00" \
  -d "boleto.juros.codigo=2" \
  -d "boleto.juros.data=2024-01-31" \
  -d "boleto.juros.taxa=1.00" \
  -d "boleto.pagador.nome=Lucas Mendes" \
  -d "boleto.pagador.cprf=000.000.000-00" \
  -d "boleto.pagador.endereco.cep=00000-000" \
  -d "boleto.pagador.endereco.uf=SC" \
  -d "boleto.pagador.endereco.localidade=Florianópolis" \
  -d "boleto.pagador.endereco.bairro=Centro" \
  -d "boleto.pagador.endereco.logradouro=Rua Felipe Schmidt" \
  -d "boleto.pagador.endereco.numero=450" \
  -o boleto-multa-juros.pdf

Java

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", "MJ-001")
        .param("boleto.titulo", "DM")
        .param("boleto.valor", "800.00")
        .param("boleto.multa.codigo", "2")
        .param("boleto.multa.data", "2024-01-31")
        .param("boleto.multa.taxa", "2.00")
        .param("boleto.juros.codigo", "2")
        .param("boleto.juros.data", "2024-01-31")
        .param("boleto.juros.taxa", "1.00")
        .param("boleto.pagador.nome", "Lucas Mendes")
        .param("boleto.pagador.cprf", "000.000.000-00")
        .param("boleto.pagador.endereco.cep", "00000-000")
        .param("boleto.pagador.endereco.uf", "SC")
        .param("boleto.pagador.endereco.localidade", "Florianópolis")
        .param("boleto.pagador.endereco.bairro", "Centro")
        .param("boleto.pagador.endereco.logradouro", "Rua Felipe Schmidt")
        .param("boleto.pagador.endereco.numero", "450")));

Python

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': 'MJ-001',
        'boleto.titulo': 'DM',
        'boleto.valor': '800.00',
        'boleto.multa.codigo': '2',
        'boleto.multa.data': '2024-01-31',
        'boleto.multa.taxa': '2.00',
        'boleto.juros.codigo': '2',
        'boleto.juros.data': '2024-01-31',
        'boleto.juros.taxa': '1.00',
        'boleto.pagador.nome': 'Lucas Mendes',
        'boleto.pagador.cprf': '000.000.000-00',
        'boleto.pagador.endereco.cep': '00000-000',
        'boleto.pagador.endereco.uf': 'SC',
        'boleto.pagador.endereco.localidade': 'Florianópolis',
        'boleto.pagador.endereco.bairro': 'Centro',
        'boleto.pagador.endereco.logradouro': 'Rua Felipe Schmidt',
        'boleto.pagador.endereco.numero': '450'
    }
)

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

Data da Multa e Juros

Normalmente, a data de início da multa e juros é o dia seguinte ao vencimento. No exemplo acima, se o vencimento é 30/01, a multa e juros começam a valer a partir de 31/01.

Limites Legais

Respeite os limites legais: multa máxima de 2% e juros máximos de 1% ao mês conforme o Código de Defesa do Consumidor.

Veja Também

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