Notas fiscais (NF-e)

Listar NF-e

GET https://apifiscal.weesy.com.br/v1/nfe

Lista as NF-e da empresa do token no período de emissão (emitidaDe e emitidaAte, até 366 dias). Para saber de cancelamentos, consulte de novo os períodos recentes: a situacao da nota muda para cancelada. Siga o proximoCursor até ele vir nulo.

Parâmetros

Nome	Onde	Tipo	Descrição
emitidaDe obrigatório	query	string (date)	Primeiro dia do período de emissão.
emitidaAte obrigatório	query	string (date)	Último dia do período de emissão (inclusive), no máximo 366 dias depois de `emitidaDe`.
situacao	query	string	Traz só as notas nesta situação. Sem o filtro, vêm as autorizadas, as canceladas e as denegadas. Valores: `autorizada`, `cancelada`, `denegada`.
limite	query	integer	Quantas notas vêm por página, de 1 a 100. Sem o parâmetro, vêm 50.
cursor	query	string	Para pegar a próxima página, repasse o `paginacao.proximoCursor` da resposta anterior.

Exemplo de chamada

cURLcurl --request GET \
  --url "https://apifiscal.weesy.com.br/v1/nfe?emitidaDe=2026-10-01&emitidaAte=2026-10-31" \
  --header "Authorization: Bearer $WEESY_TOKEN"

Node.jsconst resposta = await fetch("https://apifiscal.weesy.com.br/v1/nfe?emitidaDe=2026-10-01&emitidaAte=2026-10-31", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
  },
});
console.log(resposta.status, await resposta.text());

Pythonimport os

import requests

resposta = requests.get(
    "https://apifiscal.weesy.com.br/v1/nfe?emitidaDe=2026-10-01&emitidaAte=2026-10-31",
    headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
    timeout=30,
)
print(resposta.status_code, resposta.text)

PHP<?php

$contexto = stream_context_create(["http" => [
    "method" => "GET",
    "header" => implode("\r\n", ["Authorization: Bearer " . getenv("WEESY_TOKEN")]),
    "ignore_errors" => true, // lê o corpo também nas respostas de erro
]]);
$resposta = file_get_contents("https://apifiscal.weesy.com.br/v1/nfe?emitidaDe=2026-10-01&emitidaAte=2026-10-31", false, $contexto);
echo $http_response_header[0], PHP_EOL, $resposta, PHP_EOL;

C#using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("WEESY_TOKEN"));

using var resposta = await http.GetAsync("https://apifiscal.weesy.com.br/v1/nfe?emitidaDe=2026-10-01&emitidaAte=2026-10-31");
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");

Respostas

200: Página de NF-e.
400: Algum dado está errado ou faltando. A lista erros diz qual campo e o que corrigir (code = validacao). (formato de erro)
401: Token ausente, errado ou revogado (credencialinvalida). Confira o cabeçalho Authorization. (formato de erro)
403: Você não tem permissão para esta operação com este tipo de token (escopoinsuficiente). Exemplo: o token de API de uma empresa tentando mudar o webhook do integrador. Regra geral: 404 quando o registro não existe ou não é seu; 403 quando a operação existe, mas o seu tipo de token não pode usá-la. (formato de erro)
503: erpindisponivel — a leitura está fora do ar. Tente de novo em alguns minutos. (formato de erro)

Campos da resposta 200

Campo Tipo Descrição

dados
obrigatório array de object

dados[].chaveAcesso
obrigatório

string

A chave de acesso, 44 posições. É o identificador da nota.

dados[].numero
obrigatório

integer

Número da nota (da chave de acesso).

dados[].serie
obrigatório

integer

Série da nota (da chave de acesso).

dados[].emitidaEm

string (date)

Data de emissão.

dados[].situacao

string

A situação da nota na SEFAZ.

Valor	Significado
`autorizada`	Autorizada pela SEFAZ.
`cancelada`	Foi cancelada depois de autorizada.
`denegada`	A SEFAZ denegou o uso (irregularidade do emitente ou do destinatário).

paginacao
obrigatório

object

Como pegar a próxima página. Enquanto temMais for true, chame a mesma rota passando cursor=<proximoCursor>. A lista vem da atualização mais recente para a mais antiga, e o cursor vale por 24 horas. Registros criados enquanto você pagina não bagunçam as páginas: eles aparecem numa nova consulta.

paginacao.limite
obrigatório

integer

Quantos registros vêm por página (padrão 50, máximo 100).

paginacao.proximoCursor

string ou null

Código da próxima página. Repasse como veio, sem alterar — ele já leva os filtros. null quando acabou.

paginacao.temMais
obrigatório

boolean

true se ainda há mais páginas.

Exemplo de resposta 200

JSON

{
  "dados": [
    {
      "chaveAcesso": "35261054763582000197550010000002811000002810",
      "numero": 281,
      "serie": 1,
      "emitidaEm": "2026-10-14",
      "situacao": "autorizada"
    }
  ],
  "paginacao": {
    "limite": 50,
    "proximoCursor": null,
    "temMais": false
  }
}

← Voltar ao início