---
title: "Solicitar o cancelamento de um boleto. (por Id do boleto)"
method: POST
path: "/pj/forintegration/cobranca/v1/boletos/{boletoId}/solicitacoes/cancelamentos"
tags: ["Cancelar boleto"]
---

# Solicitar o cancelamento de um boleto. (por Id do boleto)

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

## Request

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

## Path parameters

- `boletoId` string, uuid, required: Código do boleto. exemplo: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

## 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

- SwaggerCobrancaBs2PjCobrancaBoletosSolicitacoesSolicitacaoNovoCancelamentoPorId: Dados da solicitação de cancelamento identificada pelo boletoId, incluindo status e justificativa.
  - `solicitacaoId` string, uuid, nullable: Identificador único da solicitação de cancelamento no formato GUID. Exemplo: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  - `boletoId` string, uuid, nullable: Identificador único do boleto no formato GUID. Exemplo: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
  - `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)