Skip to content

FousBB Digital PJ

Get your BB Digital PJ boletos through an API

Build methods that read your boletos in the Painel de Cobrança, your comprovantes and the Painel de Protesto in BB Digital PJ. A workflow can post each morning's newly paid boletos to your accounting system and email you the overdue ones on Mondays.

Works with your own BB Digital PJ account. Fous is an independent product.

What you can build on BB Digital PJ

  • Get boletos from the Painel de Cobrança

    Build this

    Reads your boletos in the Painel de Cobrança (collections panel) for a range of due dates, with each boleto's payer, amount and status.

    Takes
    Due date from, due date to, payer CPF or CNPJ (optional)
    Returns
    Nosso Número, Seu Nº do Documento, payer name, payer CPF or CNPJ, due date, amount, status, paid date
  • Get payment comprovantes

    Build this

    Reads the comprovantes (receipts) of the transfers and payments made from the company's account in a date range.

    Takes
    Date from, date to, type (optional)
    Returns
    Date, type, beneficiary, beneficiary CPF or CNPJ, amount
  • Check the Painel de Protesto

    Build this

    Reads the boletos in the Painel de Protesto (protest panel): which overdue boletos are in the protest flow and where each one stands.

    Takes
    Nothing
    Returns
    Nosso Número, payer name, payer CPF or CNPJ, due date, amount, protest stage
  • Issue a boleto

    Build this

    Opens Cobrança, Geração de boletos, Gerar Boleto, fills in Informações Básicas, the receiving terms and the Pagador, and registers the boleto.

    Takes
    Payer CPF or CNPJ, payer name and address, Seu Nº do Documento, amount, due date, interest, fine, allow Pix
    Returns
    Nosso Número, Seu Nº do Documento, due date, amount, payer name

Automate BB Digital PJ with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

  • Paid boletos, posted to your accounting system

    Build this
    Starts
    Every weekday at 8:00
    Step 1
    Get the boletos from the Painel de Cobrança due between 60 days ago and 30 days ahead.
    Step 2
    Keep the ones that were not paid on the last run and are paid now.
    Step 3
    Post Nosso Número, Seu Nº do Documento, payer, amount and paid date to your ERP webhook.
  • Overdue boletos and protests, every Monday

    Build this
    Starts
    Every Monday at 7:30
    Step 1
    Get the boletos from the Painel de Cobrança due in the last 90 days.
    Step 2
    Keep the ones past their due date and still unpaid.
    Step 3
    Check the Painel de Protesto for the boletos already in the protest flow.
    Step 4
    Email you both lists, grouped by payer, with amount and due date.
  • Yesterday's comprovantes, handed to accounting

    Build this
    Starts
    Every weekday at 7:00
    Step 1
    Get the comprovantes of yesterday's transfers and payments.
    Step 2
    Stop when there are none.
    Step 3
    Post date, type, beneficiary and amount to your accounting webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get boletos from the Painel de Cobrança” would look like.

Example request
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "autoatendimento.bb.com.br/get_boletos",
    "input": {
      "due_from": "2026-11-01",
      "due_to": "2026-11-30"
    }
  }'
Example response
{
  "status": "completed",
  "data": {
    "boletos": [
      {
        "nosso_numero": "00012345670000101",
        "seu_numero": "NF-4821",
        "payer_name": "Acme Comércio Ltda",
        "payer_document": "12.345.678/0001-90",
        "due_date": "2026-11-10",
        "amount": 4850,
        "status": "paid",
        "paid_date": "2026-11-10"
      }
    ]
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

BB Digital PJ’s own options

Banco do Brasil lets companies issue and manage boletos three ways: by hand in BB Digital PJ, through an API, or from their own system or ERP. Its API is documented on the Portal de Apoio ao Desenvolvedor BB, where calls use credentials and a certificate registered with the bank for mTLS. BB Digital PJ itself has the Painel de Cobrança and the Painel de Protesto.

OptionWhat it coversWhat it takes
Banco do Brasil APIsIssuing and managing boletos from your own code, one of the three channels Banco do Brasil names for cobrança.Credentials from the developer portal and a certificate registered with Banco do Brasil for mTLS calls.
Own system or ERP with BB leiautesYour own system prints boletos and builds the ficha de compensação to Banco do Brasil's leiaute.Following the published leiaute, checked with the Validador online de leiautes.
BB Digital PJ by handPainel de Cobrança, Painel de Protesto, Gerar Boleto, comprovantes, users and limits. Payers import from xls or xlsx, up to 1,000 at once.A Banco do Brasil business account and a user whose access the company has set up.

Read on November 12, 2026: Cobranças ou boletos, Portal de Apoio ao Desenvolvedor BB: dúvidas frequentes, Emissão de Boleto no BB Digital PJ (tutorial).

Signing in to BB Digital PJ

In BB Digital PJ the company decides who gets in: it manages users and their access, sets the hours and the limits for movements on the account, and can use BB Code to confirm transactions. With Fous you sign in once through the site's own sign-in with your own account. The login is sealed with AES-256, never returned by the API or written to logs, and your code and AI agents never see it.

Worth knowing

Boletos are confirmed paid the same day
Banco do Brasil confirms boletos paid anywhere in the banking network on the same day. A morning check of the Painel de Cobrança sees yesterday's payments.
Pix on a boleto needs a registered key
The Permitir liquidação via Pix option only appears when the beneficiário has a chave Pix registered. Without one, a boleto method cannot offer Pix.
Payers are saved after the first boleto
Once a boleto has gone to a CPF or CNPJ, BB Digital PJ fills in that payer's details on the next one. Payers can also be grouped, and a Grupo receives boletos in one pass.
Own-printed boletos changed on 22/02/2025
The fator de vencimento restarted at 1000 on 22/02/2025. Companies that print boletos from their own system or ERP had to update how they build them.

More in Finance: corporate banking and credit

Other industries: Elavon Payments Insider, 自然人电子税务局(扣缴端), Income Tax e-Filing Portal, Agoda YCS, AFPnet, KRA iTax.

Frequently asked questions

Yes, Banco do Brasil offers APIs for boletos, documented on its developer portal, and names the API as one of three ways to issue them alongside BB Digital PJ and your own ERP. Calls use credentials and a certificate registered with the bank. A method you build on BB Digital PJ reads what your own user sees there.

Yes. When your system calls the workflow's webhook with a list of payers, the workflow can run the boleto method you built for each one. BB Digital PJ also issues boletos to a whole Grupo of payers in one pass, and imports up to 1,000 payers at once from an xls or xlsx file.

Yes. BB Digital PJ lets the company manage users and access and set hours and limits for account movements. A method reads and does only what the account it signs in with can, so the access you give that user is the limit for every method.

Yes, when the beneficiário has a chave Pix registered: the boleto form then shows Permitir liquidação via Pix. Banco do Brasil also lists Cobrança Integrada com Pix among its collection products.

No. Fous is an independent product. You sign in to BB Digital PJ with your own account, and each method you build reads or does only what that account can.

Put BB Digital PJ behind an API call

Describe one job in Studio and see the method it builds, with 100 credits a month and no credit card, or book a demo and bring the sites your team signs in to.

Read nextBBVA Net Cash MéxicoBradesco Net EmpresabusinessONLINEElavon Payments InsiderHow methods workHow workflows run

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of BB Digital PJ (Banco do Brasil). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.