Notas fiscais (NF-e)
Consultar uma NF-e
GET https://apifiscal.weesy.com.br/v1/nfe/{chaveAcesso}
Abrir na referência interativaO resumo da nota pela chave de acesso. Chave de outra empresa responde como inexistente (404).
Parâmetros
| Nome | Onde | Tipo | Descrição |
|---|---|---|---|
| chaveAcesso obrigatório | caminho | string | A chave de acesso da NF-e, 44 posições, sem espaços. |
Exemplo de chamada
cURL
curl --request GET \
--url "https://apifiscal.weesy.com.br/v1/nfe/35261054763582000197550010000002811000002810" \
--header "Authorization: Bearer $WEESY_TOKEN"Node.js
const resposta = await fetch("https://apifiscal.weesy.com.br/v1/nfe/35261054763582000197550010000002811000002810", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
},
});
console.log(resposta.status, await resposta.text());Python
import os
import requests
resposta = requests.get(
"https://apifiscal.weesy.com.br/v1/nfe/35261054763582000197550010000002811000002810",
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/35261054763582000197550010000002811000002810", 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/35261054763582000197550010000002811000002810");
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");Respostas
- 200: A nota.
- 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)
- 404: Não encontrado. Pode ser que não exista ou que pertença a outra empresa — por segurança, os dois casos respondem igual. (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 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| chaveAcesso obrigatório | string | A chave de acesso, 44 posições. É o identificador da nota. | ||||||||
| numero obrigatório | integer | Número da nota (da chave de acesso). | ||||||||
| serie obrigatório | integer | Série da nota (da chave de acesso). | ||||||||
| emitidaEm | string (date) | Data de emissão. | ||||||||
| situacao | string | A situação da nota na SEFAZ.
|