---
title: "Cancelamento de NFe."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Nfe-filtro--Cancelar/post"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md

# Cancelamento de NFe.

`POST` `/api/v1/Nfe/{filtro}/Cancelar`

Registra um <strong>Evento de Cancelamento</strong> para uma nota fiscal eletrônico (NFe). Esta operação invalida a existência jurídica do documento perante a SEFAZ. ⚠️ **NOTAS REJEITADAS**: Caso o documento fiscal esteja com status de <strong>Rejeitado</strong>, o processo de cancelamento nesta API acionará automaticamente a <strong>Inutilização de Numeração</strong>. Isso garante que a sequência numérica do emissor permaneça íntegra e em conformidade com as normas da SEFAZ, evitando "buracos" na numeração fiscal. ⏳ **PRAZO LEGAL**: O cancelamento deve respeitar o prazo regulamentar definido pela legislação estadual vigente (geralmente 24h para NFe). Após este período, a operação poderá exigir procedimentos administrativos ou estar sujeita a penalidades por cancelamento extemporâneo. 📄 **CONDIÇÃO DE USO**: Só é possível cancelar uma nota que tenha sido <strong>Autorizada</strong> ou <strong>Rejeitada</strong> (via inutilização), e cujo <strong>Fato Gerador</strong> (saída da mercadoria) ainda não tenha ocorrido. 🧪 **TESTE**: Em ambiente de homologação, o cancelamento é processado junto aos servidores de teste, permitindo validar a estrutura da justificativa (mínimo 15 caracteres) e o comportamento da inutilização para números rejeitados.

## Path parameters

- `filtro` (string, required) - Chave de acesso da nota fiscal (44 dígitos) ou Código ERP.

## Header parameters

- `DocumentoEmissor` (string, required) - Documento do emissor.

## Request body

Content types: `application/json-patch+json`, `application/json`, `text/json`, `application/*+json`

## Responses

- `204` - No Content
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `404` - Not Found
- `500` - Internal Server Error

## OpenAPI definition

```yaml
openapi: 3.0.4
info:
  title: Stone Tax API
  version: 1.0.0
servers:
  - url: https://stone-tax-sdx.stone.com.br
    description: Ambiente de Desenvolvimento
  - url: https://stone-tax.stone.com.br
    description: Ambiente de Produção
paths:
  /api/v1/Nfe/{filtro}/Cancelar:
    post:
      tags:
        - Nfe
      summary: Cancelamento de NFe.
      description: >-
        Registra um <strong>Evento de Cancelamento</strong> para uma nota fiscal
        eletrônico (NFe). Esta operação invalida a existência jurídica do
        documento perante a SEFAZ.


        ⚠️ **NOTAS REJEITADAS**: Caso o documento fiscal esteja com status de
        <strong>Rejeitado</strong>, o processo de cancelamento nesta API
        acionará automaticamente a <strong>Inutilização de Numeração</strong>.
        Isso garante que a sequência numérica do emissor permaneça íntegra e em
        conformidade com as normas da SEFAZ, evitando "buracos" na numeração
        fiscal.


        ⏳ **PRAZO LEGAL**: O cancelamento deve respeitar o prazo regulamentar
        definido pela legislação estadual vigente (geralmente 24h para NFe).
        Após este período, a operação poderá exigir procedimentos
        administrativos ou estar sujeita a penalidades por cancelamento
        extemporâneo.


        📄 **CONDIÇÃO DE USO**: Só é possível cancelar uma nota que tenha sido
        <strong>Autorizada</strong> ou <strong>Rejeitada</strong> (via
        inutilização), e cujo <strong>Fato Gerador</strong> (saída da
        mercadoria) ainda não tenha ocorrido.


        🧪 **TESTE**: Em ambiente de homologação, o cancelamento é processado
        junto aos servidores de teste, permitindo validar a estrutura da
        justificativa (mínimo 15 caracteres) e o comportamento da inutilização
        para números rejeitados.
      parameters:
        - name: filtro
          in: path
          description: Chave de acesso da nota fiscal (44 dígitos) ou Código ERP.
          required: true
          schema:
            type: string
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          required: true
          schema:
            type: string
      requestBody:
        description: Dados para o cancelamento da nota fiscal.
        content:
          application/json-patch+json:
            schema:
              $ref: "#/components/schemas/CancelarNotaFiscalInputModel"
          application/json:
            schema:
              $ref: "#/components/schemas/CancelarNotaFiscalInputModel"
          text/json:
            schema:
              $ref: "#/components/schemas/CancelarNotaFiscalInputModel"
          application/*+json:
            schema:
              $ref: "#/components/schemas/CancelarNotaFiscalInputModel"
      responses:
        "204":
          description: No Content
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "401":
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "403":
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "404":
          description: Not Found
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    CancelarNotaFiscalInputModel:
      required:
        - justificativa
      type: object
      properties:
        justificativa:
          maxLength: 255
          minLength: 15
          type: string
          description: Justificativa do cancelamento. (Mínimo de 15 caracteres)
      additionalProperties: false
      description: Dados para cancelamento de nota fiscal (NFe ou NFCe).
    ResponseErrorResult:
      type: object
      properties:
        status:
          type: integer
          format: int32
        titulo:
          type: string
          nullable: true
        erros:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    BearerAuth:
      type: http
      description: Autenticação via token JWT. Obtenha o token através do endpoint
        /Autenticacao/ObterToken usando Basic Auth. O token expira em 1 hora.
      scheme: bearer
      bearerFormat: JWT
```