---
title: "Consultar Notas Fiscais Canceladas"
method: GET
path: "/v1/vendas/nfe/canceladas"
tags: ["Vendas NF-e"]
---

# Consultar Notas Fiscais Canceladas

`GET /v1/vendas/nfe/canceladas`

## Request

- Base URL: `https://api.sankhya.com.br`
- URL: `https://api.sankhya.com.br/v1/vendas/nfe/canceladas`
- Auth: API key in header `Authorization`

Retorna lista paginada de Notas Fiscais modelo 55 (venda) que possuem cancelamento registrado.

## Query parameters

- `page` integer, required
- `modifiedSince` string, date-time
- `codigoEmpresa` integer, required
- `codigoNota` integer
- `numeroNota` integer
- `serieNota` string
- `codigoCliente` integer
- `dataCancelamentoInicio` string
- `dataCancelamentoFinal` string

## Response `200`

Sucesso.

- RespostaPaginadaNfeCancelada
  - `metadados` VendasNFeCanceladasMetadados
    - `paginaAtual` integer
    - `totalRegistros` integer
  - `registros` RetornoNfeCancelada[]
    - `codigoNota` integer: Código interno da Nota Fiscal (NUNOTA).
    - `numeroNota` integer: Número da Nota Fiscal (NUMNOTA).
    - `serieNota` string: Série da Nota Fiscal.
    - `modelo` string: Modelo do documento fiscal. Sempre `55` neste endpoint.
    - `codigoEmpresa` integer
    - `nomeEmpresa` string
    - `codigoCliente` integer
    - `nomeCliente` string
    - `chaveNFe` string
    - `status` string: Status fixo indicando que a nota está cancelada.
    - `valorTotal` number, double
    - `dataEmissao` string: Data de emissão/negociação da nota no formato DD-MM-YYYY.
    - `dataHoraAlteracao` string, date-time: Data/hora da última alteração da nota.
    - `dataCancelamento` string, nullable: Data do cancelamento (TGFCAN.DTCANC) no formato DD/MM/YYYY. `null` se o registro de cancelamento não for encontrado.
    - `protocoloCancelamento` string, nullable: Número do protocolo de cancelamento na SEFAZ (TGFCAN.NUMPROTOCCAN).
    - `motivoCancelamento` string, nullable: Justificativa informada para o cancelamento (TGFCAN.MOTCANCEL).
    - `cnpjCpfEmitente` string, nullable: CNPJ/CPF da Empresa emitente (TSIEMP.CGC).
    - `camposNaoMapeados` object: Campos retornados pelo ERP sem mapeamento direto no contrato.
    - `camposAdicionais` object: Campos adicionais (AD_) da entidade CabecalhoNota.

## Other responses

- `400`: Erro na requisição.
- `401`: Não autorizado.
- `500`: Erro interno.

## Changes

- **2026-11-03** `b3c833e7aab1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sankhya/apis/api-sankhya/changes/v1/vendas/nfe/canceladas/get.md)

---

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