---
title: "Listar notas fiscais"
method: GET
path: "/notas"
tags: ["Notas"]
---

# Listar notas fiscais

`GET /notas`

## Query parameters

- `tipo` 'E' | 'S'
- `numero` integer
- `cpfCnpj` string
- `dataInicial` string
- `dataFinal` string
- `situacao` unknown
- `numeroPedidoEcommerce` string
- `idVendedor` integer
- `idFormaEnvio` integer
- `idVenda` integer
- `marcadores` string[]
- `orderBy` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `itens` ListagemNotaFiscalModelResponse[]
    - `situacao` string, nullable — - 1 - Pendente - 2 - Emitida - 3 - Cancelada - 4 - Enviada Aguardando Recibo - 5 - Rejeitada - 6 - Autorizada - 7 - Emitida Danfe - 8 - Registrada - 9 - Enviada Aguardando Protocolo - 10 - Denegada
    - `tipo` 'E' | 'S', nullable — - E - Entrada - S - Saida
    - `numero` string, nullable
    - `serie` string, nullable
    - `chaveAcesso` string, nullable
    - `dataEmissao` string, nullable
    - `dataPrevista` string, nullable
    - `cliente` NotaFiscalClienteModel — 
      - `nome` string, nullable
      - `codigo` string, nullable
      - `fantasia` string, nullable
      - `tipoPessoa` 'J' | 'F' | 'E' | 'X', nullable — - J - Juridica - F - Fisica - E - Estrangeiro - X - Estrangeiro No Brasil
      - `cpfCnpj` string, nullable
      - `inscricaoEstadual` string, nullable
      - `rg` string, nullable
      - `telefone` string, nullable
      - `celular` string, nullable
      - `email` string, nullable
      - `endereco` EnderecoModel — 
        - `endereco` string, nullable
        - `numero` string, nullable
        - `complemento` string, nullable
        - `bairro` string, nullable
        - `municipio` string, nullable
        - `cep` string, nullable
        - `uf` string, nullable
        - `pais` string, nullable
      - `id` integer
    - `enderecoEntrega` EnderecoEntregaModelResponse — 
      - `endereco` string, nullable
      - `numero` string, nullable
      - `complemento` string, nullable
      - `bairro` string, nullable
      - `municipio` string, nullable
      - `cep` string, nullable
      - `uf` string, nullable
      - `pais` string, nullable
      - `nomeDestinatario` string, nullable
      - `cpfCnpj` string, nullable
      - `tipoPessoa` string, nullable
      - `telefone` string, nullable
      - `inscricaoEstadual` string, nullable
    - `valor` number, float, nullable
    - `valorProdutos` number, float, nullable
    - `valorFrete` number, float, nullable
    - `vendedor` VendedorResponseModel — 
      - `id` integer
      - `nome` string, nullable
    - `idFormaEnvio` integer, nullable
    - `idFormaFrete` integer, nullable
    - `codigoRastreamento` string, nullable
    - `urlRastreamento` string, nullable
    - `fretePorConta` string, nullable
    - `qtdVolumes` integer, nullable
    - `pesoBruto` number, float, nullable
    - `pesoLiquido` number, float, nullable
    - `id` integer
    - `ecommerce` EcommerceResponseModel — 
      - `id` integer, nullable
      - `nome` string, nullable
      - `numeroPedidoEcommerce` string, nullable
      - `numeroPedidoCanalVenda` string, nullable
      - `canalVenda` string, nullable
    - `origem` NotaFiscalOrigemModelResponse — 
      - `id` string, nullable
      - `tipo` 'pedido_compra' | 'venda' | 'notafiscal' | 'ordemservico' | 'cobranca' | 'devolucao', nullable — - pedido_compra - Pedido Compra - venda - Venda - notafiscal - Nota Fiscal - ordemservico - Ordem Servico - cobranca - Cobranca - devolucao - Devolucao
  - `paginacao` PaginatedResultModel — 
    - `limit` integer
    - `offset` integer
    - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/olist/apis/olist-erp-api-v3.md) · [All operations](https://skmtc.net/olist/apis/olist-erp-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olist/olist-erp-api-v3/versions/c351400bb11f/schema)