Instruções de Cobrança

Instruções de Cobrança

As instruções de cobrança são orientações impressas no boleto destinadas ao caixa do banco ou ao sistema de processamento. Elas definem as regras de recebimento do boleto e são fundamentais para garantir que a cobrança seja processada corretamente.

O Que São Instruções de Cobrança?

As instruções aparecem no campo “Instruções” do boleto bancário (também chamado de “Instruções de Cobrança” ou “Instruções ao Caixa”). São lidas pelo operador de caixa ou pelo sistema automatizado do banco no momento do pagamento.

┌─────────────────────────────────────────────────────────────────┐
│  INSTRUÇÕES (Texto de responsabilidade do Beneficiário)        │
├─────────────────────────────────────────────────────────────────┤
│  Sr. Caixa, não receber após 30 dias do vencimento             │
│  Multa de 2% após o vencimento                                 │
│  Juros de 1% ao mês (0,033% ao dia)                            │
│  Não conceder desconto                                         │
└─────────────────────────────────────────────────────────────────┘

Instruções vs Informações

Não confunda instruções com informações ao pagador:

• Instruções (boleto.instrucao): Destinadas ao caixa/banco, definem regras de recebimento
• Informações (boleto.info): Destinadas ao pagador, identificam a cobrança (ex: “Pedido #123”)

---

Campos Disponíveis

A API oferece duas formas de enviar instruções:

Método	Campo	Descrição
Texto livre	boleto.instrucao	Até 8 linhas de 100 caracteres cada
Campos numerados	boleto.instrucao1 a boleto.instrucao5	5 campos individuais (sobrescrevem cadastro da conta)

Quando usar cada método

• Use boleto.instrucao para enviar todas as instruções de uma vez (texto multilinha)
• Use boleto.instrucao1 a boleto.instrucao5 para sobrescrever instruções específicas cadastradas na conta

---

Boas Práticas

1. Seja Claro e Objetivo

As instruções devem ser diretas e sem ambiguidade. O operador de caixa precisa entender rapidamente o que fazer.

Bom

Não receber após 30 dias do vencimento

Ruim

Favor verificar a possibilidade de recebimento considerando eventuais atrasos

2. Especifique Prazos com Clareza

Sempre indique prazos de forma absoluta ou relativa ao vencimento.

Forma	Exemplo	Observação
Relativa	Não receber após 30 dias do vencimento	Mais comum e recomendada
Absoluta	Não receber após 15/03/2024	Útil para casos específicos

3. Informe Encargos Corretamente

Se houver multa e juros, especifique os valores para orientar o caixa em pagamentos após o vencimento.

boleto.instrucao=Multa de 2% após o vencimento
boleto.instrucao=Juros de 0,033% ao dia (1% ao mês)

Consistência

Os valores informados nas instruções devem corresponder aos campos boleto.multa e boleto.juros. Inconsistências podem gerar confusão no momento do pagamento.

4. Trate Descontos com Cuidado

Se o boleto possui desconto, deixe claro as condições:

boleto.instrucao=Desconto de R$ 50,00 até 10/02/2024
boleto.instrucao=Não conceder desconto após esta data

5. Inclua Contato para Dúvidas

Uma boa prática é incluir um canal de contato na última linha:

boleto.instrucao=Em caso de dúvidas: (11) 1234-5678

---

Exemplos por Cenário

Cobrança Padrão

Instrução básica para a maioria dos boletos comerciais:

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-02-15" \
  -d "boleto.documento=COB-001" \
  -d "boleto.titulo=DM" \
  -d "boleto.valor=1500.00" \
  -d "boleto.multa=2.00" \
  -d "boleto.juros=1.00" \
  -d "boleto.instrucao=Sr. Caixa, não receber após 30 dias do vencimento" \
  -d "boleto.instrucao=Multa de 2% após o vencimento" \
  -d "boleto.instrucao=Juros de 1% ao mês" \
  -d "boleto.pagador.nome=Maria Silva" \
  -d "boleto.pagador.cprf=000.000.000-00" \
  -d "boleto.pagador.endereco.cep=01310-100" \
  -d "boleto.pagador.endereco.uf=SP" \
  -d "boleto.pagador.endereco.localidade=São Paulo" \
  -d "boleto.pagador.endereco.bairro=Bela Vista" \
  -d "boleto.pagador.endereco.logradouro=Av. Paulista" \
  -d "boleto.pagador.endereco.numero=1000" \
  -o boleto-padrao.pdf

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-02-15'),
        ('boleto.documento', 'COB-001'),
        ('boleto.titulo', 'DM'),
        ('boleto.valor', '1500.00'),
        ('boleto.multa', '2.00'),
        ('boleto.juros', '1.00'),
        ('boleto.instrucao', 'Sr. Caixa, não receber após 30 dias do vencimento'),
        ('boleto.instrucao', 'Multa de 2% após o vencimento'),
        ('boleto.instrucao', 'Juros de 1% ao mês'),
        ('boleto.pagador.nome', 'Maria Silva'),
        ('boleto.pagador.cprf', '000.000.000-00'),
        ('boleto.pagador.endereco.cep', '01310-100'),
        ('boleto.pagador.endereco.uf', 'SP'),
        ('boleto.pagador.endereco.localidade', 'São Paulo'),
        ('boleto.pagador.endereco.bairro', 'Bela Vista'),
        ('boleto.pagador.endereco.logradouro', 'Av. Paulista'),
        ('boleto.pagador.endereco.numero', '1000'),
    ]
)

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

Cobrança Sem Tolerância

Para boletos que não devem ser aceitos após o vencimento:

-d "boleto.instrucao=ATENÇÃO: Não receber após o vencimento" \
-d "boleto.instrucao=Pagamento somente até a data de vencimento" \
-d "boleto.instrucao=Dúvidas: financeiro@empresa.com"

Cobrança com Desconto

Para boletos com incentivo de pagamento antecipado:

-d "boleto.instrucao=Desconto de 5% (R$ 75,00) para pagamento até 05/02/2024" \
-d "boleto.instrucao=Após esta data, cobrar valor integral" \
-d "boleto.instrucao=Não receber após 30 dias do vencimento" \
-d "boleto.instrucao=Multa de 2% e juros de 1% a.m. após vencimento"

Cobrança de Condomínio

Para boletos de taxa condominial:

-d "boleto.instrucao=Taxa condominial - Mês referência: Janeiro/2024" \
-d "boleto.instrucao=Multa de 2% e juros de 1% a.m. após vencimento" \
-d "boleto.instrucao=Não receber após 60 dias do vencimento" \
-d "boleto.instrucao=Administradora: (11) 1234-5678"

Cobrança de Mensalidade Escolar

Para boletos de instituições de ensino:

-d "boleto.instrucao=Mensalidade escolar - Competência: Fevereiro/2024" \
-d "boleto.instrucao=Multa de 2% após o vencimento" \
-d "boleto.instrucao=Juros de 1% ao mês (0,033% ao dia)" \
-d "boleto.instrucao=Não receber após 90 dias do vencimento" \
-d "boleto.instrucao=Secretaria: (11) 9876-5432"

---

O Que Evitar

Instruções Muito Longas

Cada linha tem limite de 100 caracteres. Textos longos serão truncados.

Bom

Não receber após 30 dias do vencimento

Ruim

Este boleto não poderá ser aceito para pagamento em nenhuma agência bancária caso a data de pagamento seja superior a 30 dias...

Informações Confidenciais

Nunca inclua dados sensíveis nas instruções:

• Senhas ou códigos de acesso
• Dados bancários do beneficiário
• Informações pessoais detalhadas do pagador

Instruções Conflitantes

Evite contradições entre as instruções e os campos do boleto:

Problema	Exemplo
Multa diferente	boleto.multa=2.00 mas instrução diz “Multa de 5%“
Prazo conflitante	Desconto até dia 10, mas instrução diz “Desconto até dia 15”

Linguagem Informal

Mantenha tom profissional e formal:

Bom

Em caso de dúvidas, contate o SAC: 0800 123 4567

Ruim

Qualquer problema é só ligar pra gente!

---

Modelo de Instruções Recomendado

Para a maioria dos casos comerciais, este conjunto de instruções cobre os cenários mais comuns:

Linha 1: Sr. Caixa, não receber após [X] dias do vencimento
Linha 2: Multa de [X]% após o vencimento
Linha 3: Juros de [X]% ao mês ([X]% ao dia)
Linha 4: [Regra de desconto, se houver]
Linha 5: Em caso de dúvidas: [telefone/email]

Exemplo completo:

-d "boleto.instrucao=Sr. Caixa, não receber após 30 dias do vencimento" \
-d "boleto.instrucao=Multa de 2% após o vencimento" \
-d "boleto.instrucao=Juros de 1% ao mês (0,033% ao dia)" \
-d "boleto.instrucao=Desconto de R$ 25,00 até 5 dias antes do vencimento" \
-d "boleto.instrucao=Dúvidas: financeiro@empresa.com | (11) 1234-5678"

---

Veja Também

• Campos do Boleto - Referência completa dos campos instrucao e info
• Sobrescrever Mensagens - Como personalizar instruções por boleto
• Boleto com Descontos - Configuração de descontos escalonados
• Sobrescrever Multa e Juros - Personalização de encargos