Skip to main content
GET
/
notas
Listar notas fiscais
curl --request GET \
  --url https://api.tiny.com.br/public-api/v3/notas \
  --header 'Authorization: Bearer <token>'
{
  "itens": [
    {
      "situacao": 1,
      "tipo": "E",
      "numero": "<string>",
      "serie": "<string>",
      "chaveAcesso": "<string>",
      "dataEmissao": "<string>",
      "dataPrevista": "<string>",
      "cliente": {
        "nome": "<string>",
        "codigo": "<string>",
        "fantasia": "<string>",
        "tipoPessoa": "J",
        "cpfCnpj": "<string>",
        "inscricaoEstadual": "<string>",
        "rg": "<string>",
        "telefone": "<string>",
        "celular": "<string>",
        "email": "<string>",
        "endereco": {
          "endereco": "<string>",
          "numero": "<string>",
          "complemento": "<string>",
          "bairro": "<string>",
          "municipio": "<string>",
          "cep": "<string>",
          "uf": "<string>",
          "pais": "<string>"
        },
        "id": 123
      },
      "enderecoEntrega": {
        "endereco": "<string>",
        "numero": "<string>",
        "complemento": "<string>",
        "bairro": "<string>",
        "municipio": "<string>",
        "cep": "<string>",
        "uf": "<string>",
        "pais": "<string>",
        "nomeDestinatario": "<string>",
        "cpfCnpj": "<string>",
        "tipoPessoa": "<string>",
        "telefone": "<string>",
        "inscricaoEstadual": "<string>"
      },
      "valor": 123,
      "valorProdutos": 123,
      "valorFrete": 123,
      "vendedor": {
        "id": 123,
        "nome": "<string>"
      },
      "idFormaEnvio": 123,
      "idFormaFrete": 123,
      "codigoRastreamento": "<string>",
      "urlRastreamento": "<string>",
      "fretePorConta": "<string>",
      "qtdVolumes": 123,
      "pesoBruto": 123,
      "pesoLiquido": 123,
      "id": 123,
      "ecommerce": {
        "id": 123,
        "nome": "<string>",
        "numeroPedidoEcommerce": "<string>",
        "numeroPedidoCanalVenda": "<string>",
        "canalVenda": "<string>"
      },
      "origem": {
        "id": "<string>",
        "tipo": "pedido_compra"
      }
    }
  ],
  "paginacao": {
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Query Parameters

tipo
enum<string>

Pesquisa por tipo de nota

  • E - Entrada
  • S - Saida
Available options:
E,
S
numero
integer

Pesquisa por número da nota

cpfCnpj
string

Pesquisa por CPF ou CNPJ

dataInicial
string

Pesquisa por data de criação

Example:

"2023-01-01"

dataFinal
string

Pesquisa por data de criação

Example:

"2023-01-01"

situacao
enum<number>

Pesquisa pela situacão da nota

  • 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
Available options:
1,
2,
3,
4,
5,
6,
7,
8,
9,
10
numeroPedidoEcommerce
string

Pesquisa pelo número do pedido no e-commerce

idVendedor
integer

Pesquisa por identificador do vendedor

idFormaEnvio
integer

Pesquisa por identificador da forma de envio

idVenda
integer

Pesquisa por identificador da venda

marcadores
string[]

Pesquisa por marcadores

orderBy
enum<string>

Define a ordenação da listagem por ordem crescente ou decrescente

  • asc - Crescente
  • desc - Descrescente
Available options:
asc,
desc
limit
integer
default:100

Limite da paginação

offset
integer
default:0

Offset da paginação

Response

OK

itens
· object[]
paginacao
· object