canonical: https://jentic.com/apis/prebanco.com.br/prebanco

# Prebanco API de Registro de Boleto com QR Code

The API de Registro de Boleto com QR Code registers Bradesco boletos de cobrança in Brazil, either as hybrid boletos that carry a Pix QR code or as plain boletos without one. A single registration call takes the beneficiary's CPF or CNPJ and contract details, the payer's (sacado) name, address, and CPF or CNPJ, the issue and due dates, the nominal value, and optional interest, late fee, discount, partial payment, and protest instructions. When cindcdCobrMisto is S, the beneficiary's Pix key goes in ialiasAdsaoCta and the response can return the Pix EMV code in wqrcdPdraoMercd. Requests are signed under Bradesco's server-to-server authentication scheme.

## For AI agents

Register a Bradesco boleto de cobrança, with or without a Pix QR code, for a payer, due date, and amount, including interest, late fee, discount, and protest instructions.

## Scope

Does not query, cancel, or settle boletos, send Pix transfers, or issue fiscal invoices. Use for registering Bradesco boletos with or without a Pix QR code only.

## Capabilities

- Register a Bradesco boleto with a Pix QR code by setting cindcdCobrMisto to S and passing the beneficiary Pix key in ialiasAdsaoCta
- Register a plain boleto without a QR code for a payer, due date (dvctoTitloCobr), and nominal value (vnmnalTitloCobr)
- Add late interest, late fees, and up to three tiered early-payment discounts to a boleto
- Set automatic protest instructions through tipoRegistro and the protest day counts
- Allow partial payments with cindcdPgtoParcial and qtdePgtoParcial
- Record the final beneficiary (sacador avalista) and payer contact details on the boleto

## Use cases

### Agent-issued boletos through Jentic

A developer's billing agent needs to issue a Bradesco boleto when an invoice is approved. Through Jentic the agent finds the registration operation by intent and fills the payer, due date, and value fields from the invoice. The bearer token and access-token client id are held by your own instance; the X-Brad-Signature JWS still has to be produced per request with your partner certificate, as Bradesco's server-to-server guide requires.

Example prompt: Call POST `/v1/boleto-hibrido/registrar-boleto` with registrarTitulo 1, cindcdCobrMisto S, the beneficiary Pix key in ialiasAdsaoCta, dvctoTitloCobr 30.11.2026, vnmnalTitloCobr 15000, and the payer's name and CPF, then return wqrcdPdraoMercd

### Hybrid boleto with Pix for faster settlement

Brazilian payers often prefer Pix over paying a boleto barcode. A hybrid registration with cindcdCobrMisto set to S and fase 1 registers the boleto and generates its Pix QR code in one step, so the customer can pay by barcode or by Pix from the same document.

Example prompt: Register a boleto with cindcdCobrMisto S and fase 1 and return the EMV QR code from wqrcdPdraoMercd to show the payer

### Collections with interest, fines, and protest

Receivables teams need overdue boletos to accrue charges and, if unpaid, go to protest. The registration body accepts a late interest percentage or daily value (ptxJuroVcto, vdiaJuroMora), a late fee (pmultaAplicVcto or vmultaAtrsoPgto), start days for each, and a tipoRegistro of 002 for a boleto with a protest instruction.

Example prompt: Register a boleto with tipoRegistro 002, pmultaAplicVcto set for a late fee, qdiaInicMulta 1, and ctpoPrzProte 5 days for protest

## Key resources

- **Boleto registration** — Register a boleto de cobrança with or without a Pix QR code, including payer, value, dates, charges, discounts, and protest settings

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 67 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 67 / 100
  - Developer Experience & Jentic Compatibility: 62 / 100
  - AI-Readiness & Agent Experience: 67 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 50 / 100
- **View full report:** https://jentic.com/apis/prebanco.com.br/prebanco/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring this API by hand means obtaining a bearer token through Bradesco's server-to-server flow, sending the access-token client id, building X-Brad-Signature, X-Brad-Nonce, X-Brad-Timestamp, and X-Brad-Algorithm headers, and filling a long Portuguese-named body. Through Jentic you install once, import it from the API Directory, store the bearer token and client id once, and your agent calls it with the per-request signature headers.
- **Permission scoping:** The spec has a single operation and carries the beneficiary, payer, and amount in the request body, so rules bound whether your agent may register boletos at all, not which payer or contract. Keep the operation out of any agent that should not issue charges.
- **Credential handling:** Your Bradesco bearer token and client id are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'register a boleto' or 'issue a boleto with Pix QR code', and Jentic returns this operation with its input schema, so the agent sees which of the many abbreviated Portuguese fields are required.

## Related APIs

- **Banco Inter API** — Pix charges, boletos, payments, and statements from Banco Inter business accounts
- **Boleto Cloud API** — Multi-bank boleto issuance with Pix, batch issuance, and CNAB files
- **API NotaGuard** — Lists and downloads a company's NF-e, NFC-e, and NFS-e fiscal documents

## FAQ

### What authentication does the Boleto com QR Code API use?

Per its OpenAPI spec, the API uses a bearer token issued by Bradesco's token endpoint under the server-to-server flow, plus required request headers: access-token carrying the partner client id, X-Brad-Signature with a JWS signed by the partner's private certificate, X-Brad-Nonce, X-Brad-Timestamp, and X-Brad-Algorithm. Through Jentic the bearer token and client id are stored by your own instance; the signature headers are computed per request.

### Can I register a boleto with a Pix QR code?

Yes. POST `/v1/boleto-hibrido/registrar-boleto` registers a hybrid boleto when cindcdCobrMisto is S, with the beneficiary's Pix key in ialiasAdsaoCta. The fase field chooses between registering and generating the QR code (1) and linking a boleto to a QR code (2), and the Pix EMV code is carried in wqrcdPdraoMercd.

### What are the rate limits for the Boleto com QR Code API?

The OpenAPI spec does not specify rate limits. Check Bradesco's developer guide for APIs (Guia para consumo de APIs Bradesco), which the spec references for authentication, for current limits on boleto registration.

### Is there a Bradesco boleto MCP server?

You don't need an MCP server to give your agent this boleto API. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls the registration operation on demand without loading another server's tool definitions into its context.

### Can I limit what my agent is allowed to do with this API?

The spec has one operation, so the useful limit is whether the agent may issue boletos at all. Allow POST `/v1/boleto-hibrido/registrar-boleto` only for the agent that runs billing, leave it out for agents that should just read invoices, and every boleto the billing agent registers is logged.

### How do I issue a boleto through Jentic?

Search Jentic for 'register a boleto with Pix QR code', load POST `/v1/boleto-hibrido/registrar-boleto`, and send the required fields such as registrarTitulo, the beneficiary CPF or CNPJ parts, the contract identifiers, dvctoTitloCobr, vnmnalTitloCobr, and the payer details. To run it on your own infrastructure, install Jentic One from its GitHub repo.