Emitir e consultar NFS-e

Consultar NFS-e

GET https://apifiscal.weesy.com.br/v1/nfse/{id}

Mostra a nota com a situação atual, o número e o código de verificação da prefeitura e os links para o PDF e o XML.

Parâmetros

Nome	Onde	Tipo	Descrição
id obrigatório	caminho	string	Identificador do recurso consultado.

Exemplo de chamada

cURLcurl --request GET \
  --url "https://apifiscal.weesy.com.br/v1/nfse/6ade6278e8340a492a46b564" \
  --header "Authorization: Bearer $WEESY_TOKEN"

Node.jsconst resposta = await fetch("https://apifiscal.weesy.com.br/v1/nfse/6ade6278e8340a492a46b564", {
  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/nfse/6ade6278e8340a492a46b564",
    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/nfse/6ade6278e8340a492a46b564", 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/nfse/6ade6278e8340a492a46b564");
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");

Respostas

200: NFS-e.
401: Token ausente, errado ou revogado (credencialinvalida). Confira o cabeçalho Authorization. (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)

Campos da resposta 200

Campo Tipo Descrição

id
obrigatório

string

Identificador da NFS-e na Weesy.

idIntegracao
obrigatório

string

Identificador informado pelo integrador na emissão.

status
obrigatório

string

Situação atual do processamento da NFS-e.

Valor	Significado
`recebida`	Recebemos a nota e vamos enviar à prefeitura
`em_processamento`	Enviada à prefeitura, aguardando a resposta
`autorizada`	Autorizada pela prefeitura
`rejeitada`	Recusada pela prefeitura — corrija e emita de novo
`erro`	Não conseguimos falar com a prefeitura — tente de novo
`cancelamento_solicitado`	Cancelamento pedido, aguardando a prefeitura
`cancelada`	Cancelada pela prefeitura
`cancelamento_rejeitado`	A prefeitura recusou o cancelamento

ambiente
obrigatório

string

Ambiente em que a emissão foi solicitada.

Valor	Significado
`simulacao`	Teste sem certificado — a Weesy responde no lugar da prefeitura
`homologacao`	Teste no ambiente de testes da prefeitura — precisa de certificado
`producao`	A nota de verdade, com valor fiscal

empresa
obrigatório

object

A empresa que emitiu a nota.

empresa.cnpj
obrigatório

string

CNPJ sem pontos, barra ou traço (14 posições). Já aceita o CNPJ com letras, que começa a valer em 2026.

empresa.razaoSocial
obrigatório string

empresa.inscricaoMunicipal string ou null

empresa.municipio
obrigatório

object

Identificação do município por código IBGE, nome e UF.

empresa.municipio.codigoIbge
obrigatório

string

Código IBGE do município.

empresa.municipio.nome

string

Nome do município.

empresa.municipio.uf

string

Sigla da unidade federativa.

tomador
obrigatório

object

Dados do tomador registrados na nota.

tomador.tipoPessoa
obrigatório

string

Tipo de pessoa do tomador.

Valores: F, J.

tomador.cpfCnpj
obrigatório

string

CPF ou CNPJ registrado para o tomador.

tomador.nome
obrigatório

string

Nome ou razão social do tomador.

tomador.inscricaoMunicipal

string ou null

Inscrição municipal informada para o tomador.

tomador.email

string ou null

E-mail registrado para o tomador.

tomador.telefone

string ou null

Telefone registrado para o tomador.

tomador.endereco

object

Endereço registrado para o tomador.

tomador.endereco.cep
obrigatório

string

CEP do endereço, sem pontuação.

tomador.endereco.logradouro
obrigatório

string

Tipo e nome do logradouro.

tomador.endereco.numero
obrigatório

string

Número do endereço. Sem número? Mande S/N.

tomador.endereco.complemento

string

Complemento do endereço, quando aplicável.

tomador.endereco.bairro
obrigatório

string

Bairro do endereço.

tomador.endereco.codigoIbge
obrigatório

string

Código IBGE do município do endereço.

tomador.endereco.cidade string

tomador.endereco.uf string

servico
obrigatório

object

Serviço congelado na nota.

servico.id integer

servico.descricao string

servico.itemListaServico string

servico.codigoTributacaoMunicipio string ou null

servico.codigoTributacaoNacional string ou null

servico.nbs string

servico.cIndOp string

servico.cClassTrib string

servico.cst string

discriminacao

string

Descrição da prestação registrada na nota.

competencia

string (date)

Data de competência da prestação.

valores
obrigatório

object

Valores calculados e registrados para a nota.

valores.servico

number

Valor do serviço prestado.

valores.deducoes

number

Valor das deduções consideradas.

valores.descontoIncondicionado

number

Valor do desconto incondicionado.

valores.descontoCondicionado

number

Valor do desconto condicionado.

valores.baseCalculo

number

Base de cálculo apurada para o ISS.

valores.aliquotaIss

number

Alíquota de ISS aplicada no cálculo, em percentual.

valores.iss

number

Valor de ISS apurado.

valores.issRetido

boolean

Indica a retenção do ISS.

valores.retencoesFederais

object

Valores de retenções federais.

valores.retencoesFederais.pis

number

Valor da retenção de PIS.

valores.retencoesFederais.cofins

number

Valor da retenção de COFINS.

valores.retencoesFederais.csll

number

Valor da retenção de CSLL.

valores.retencoesFederais.ir

number

Valor da retenção de Imposto de Renda.

valores.retencoesFederais.inss

number

Valor da retenção de INSS.

valores.liquido

number

Valor líquido da prestação.

ibsCbs

object

Ausente quando a nota não tem o grupo IBS/CBS.

ibsCbs.cIndOp string

ibsCbs.cClassTrib string

ibsCbs.cst string

ibsCbs.localidadeIncidencia

string

Código IBGE do município.

rps

object

Numeração e série do RPS da nota.

rps.numero string

rps.serie string

documento

object

Ausente até autorizar.

documento.numero string

documento.codigoVerificacao string

documento.chaveAcesso string ou null

documento.emitidoEm

string (date-time)

Data e hora no horário de Brasília (ex. 2026-10-26T09:27:34-03:00).

provedor

object

A última resposta da prefeitura (ou do sistema nacional).

provedor.padrao string

provedor.codigo string ou null

provedor.mensagem string ou null

provedor.protocolo string ou null

historico

array de object

Histórico das mudanças de situação da NFS-e.

historico[].status
obrigatório

string

Em que pé está a nota. Novos valores podem aparecer: trate valor desconhecido sem quebrar.

Valor	O que quer dizer	O que fazer
`recebida`	Recebemos a nota e vamos enviar à prefeitura	Aguardar
`em_processamento`	Enviada à prefeitura, aguardando a resposta	Aguardar
`autorizada`	A prefeitura autorizou — a nota tem número e código de verificação	Pronto: baixe o PDF e o XML
`rejeitada`	A prefeitura recusou por algum dado errado	Leia o motivo em `mensagens`, corrija e emita de novo com o mesmo `idIntegracao`
`erro`	Não conseguimos falar com a prefeitura (fora do ar, demora)	Tentar emitir de novo
`cancelamento_solicitado`	Pedimos o cancelamento, aguardando a prefeitura	Aguardar
`cancelada`	A prefeitura cancelou a nota	—
`cancelamento_rejeitado`	A prefeitura recusou o cancelamento — a nota continua valendo	Leia o motivo; às vezes é preciso cancelar no site da prefeitura

Valor	Significado
`recebida`	Recebemos a nota e vamos enviar à prefeitura
`em_processamento`	Enviada à prefeitura, aguardando a resposta
`autorizada`	Autorizada pela prefeitura
`rejeitada`	Recusada pela prefeitura — corrija e emita de novo
`erro`	Não conseguimos falar com a prefeitura — tente de novo
`cancelamento_solicitado`	Cancelamento pedido, aguardando a prefeitura
`cancelada`	Cancelada pela prefeitura
`cancelamento_rejeitado`	A prefeitura recusou o cancelamento

historico[].em
obrigatório

string (date-time)

Data e hora em UTC, terminada em Z (ex. 2026-10-26T12:27:34Z).

historico[].mensagens array de object

historico[].mensagens[].codigo string

historico[].mensagens[].mensagem string

cancelamento

object

Dados e situação da solicitação de cancelamento, quando houver.

cancelamento.motivo integer

cancelamento.justificativa string

cancelamento.solicitadoEm

string (date-time)

Data e hora em UTC, terminada em Z (ex. 2026-10-26T12:27:34Z).

cancelamento.concluidoEm string (date-time) ou null

links
obrigatório

object

Endereços relativos para consultar a nota e obter seus documentos, conforme disponibilidade.

links.self
obrigatório string

links.xml

string ou null

Nulo até autorizar.

links.pdf

string ou null

Nulo até autorizar.

criadoEm
obrigatório

string (date-time)

Instante de criação do registro na Weesy.

atualizadoEm
obrigatório

string (date-time)

Instante da última atualização do registro.

Exemplo de resposta 200

JSON

{
  "id": "6ade6278e8340a492a46b564",
  "idIntegracao": "pedido-10432",
  "status": "autorizada",
  "ambiente": "producao",
  "empresa": {
    "cnpj": "21664333000195",
    "razaoSocial": "WEESY SOFTWARE LTDA",
    "inscricaoMunicipal": "249122",
    "municipio": {
      "codigoIbge": "3547809",
      "nome": "Santo André",
      "uf": "SP"
    }
  },
  "tomador": {
    "tipoPessoa": "J",
    "cpfCnpj": "11222333000181",
    "nome": "EMPRESA EXEMPLO LTDA",
    "endereco": {
      "cep": "01001000",
      "logradouro": "Rua Exemplo",
      "numero": "100",
      "bairro": "Centro",
      "codigoIbge": "3550308",
      "cidade": "São Paulo",
      "uf": "SP"
    }
  },
  "servico": {
    "id": 42,
    "descricao": "Suporte técnico",
    "itemListaServico": "01.07",
    "codigoTributacaoMunicipio": "620910000",
    "nbs": "115013000",
    "cIndOp": "100301",
    "cClassTrib": "000001",
    "cst": "000"
  },
  "discriminacao": "Suporte técnico — outubro/2026",
  "competencia": "2026-10-26",
  "valores": {
    "servico": 100,
    "deducoes": 0,
    "baseCalculo": 100,
    "aliquotaIss": 3,
    "iss": 0,
    "issRetido": false,
    "liquido": 100
  },
  "rps": {
    "numero": "7",
    "serie": "02"
  },
  "documento": {
    "numero": "947",
    "codigoVerificacao": "H45N1MFG0",
    "emitidoEm": "2026-10-26T09:28:10-03:00"
  },
  "provedor": {
    "padrao": "gissonline",
    "codigo": null,
    "mensagem": null,
    "protocolo": "8335350"
  },
  "historico": [
    {
      "status": "recebida",
      "em": "2026-10-26T12:27:34Z",
      "mensagens": []
    },
    {
      "status": "em_processamento",
      "em": "2026-10-26T12:27:35Z",
      "mensagens": []
    },
    {
      "status": "autorizada",
      "em": "2026-10-26T12:28:10Z",
      "mensagens": []
    }
  ],
  "links": {
    "self": "/v1/nfse/6ade6278e8340a492a46b564",
    "xml": "/v1/nfse/6ade6278e8340a492a46b564/xml",
    "pdf": "/v1/nfse/6ade6278e8340a492a46b564/pdf"
  },
  "criadoEm": "2026-10-26T12:27:34Z",
  "atualizadoEm": "2026-10-26T12:28:10Z"
}

← Voltar ao início