---
title: "Solicitar o cancelamento de um boleto. (por Nosso número)"
method: POST
path: "/pj/forintegration/cobranca/v1/boletos/{nossoNumero}/solicitacoes/cancelamentos"
tags: ["Cancelar boleto"]
---

# Solicitar o cancelamento de um boleto. (por Nosso número)

`POST /pj/forintegration/cobranca/v1/boletos/{nossoNumero}/solicitacoes/cancelamentos`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `nossoNumero` integer, required: Nosso número do boleto. Exemplo: 123456789

## Request body

- SwaggerCobrancaBs2PjCobrancaBoletosSolicitacoesNovaSolicitacaoNovoCancelamento: Payload para abertura de solicitação de cancelamento de boleto, contendo justificativa. Disponível apenas para carteira simples (carteira 21).
  - `justificativa` string, nullable: Texto justificando a ação realizada.

## Response `200`

Success

- SwaggerCobrancaBs2PjCobrancaBoletosSolicitacoesSolicitacaoNovoCancelamentoPorNossoNumero: Dados da solicitação de cancelamento identificada pelo nosso número do boleto, incluindo status e justificativa.
  - `solicitacaoId` string, uuid, nullable: Identificador único da solicitação de cancelamento no formato GUID. Exemplo: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  - `nossoNumero` integer, nullable: Identificador do boleto gerado pelo banco.
  - `status` integer: Status da solicitação de instrução.
  - `justificativa` string, nullable: Texto justificando a ação realizada.

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/bs2/apis/api-boletos.md) - [All operations](https://skmtc.dev/bs2/apis/api-boletos/llms.txt) - [OpenAPI document](https://skmtc.dev/bs2/apis/api-boletos/revisions/5d82dc00a3f9?raw)