Empresas

Consultar uma empresa

GET https://apifiscal.weesy.com.br/v1/empresas/{cnpj}

Mostra os dados da empresa, a situação do certificado digital e a configuração de NFS-e.

Parâmetros

Nome	Onde	Tipo	Descrição
cnpj obrigatório	caminho	string	CNPJ da empresa, só números.

Exemplo de chamada

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

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

Respostas

200: A empresa.
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

cnpj
obrigatório

string

CNPJ da empresa da sua conta.

razaoSocial
obrigatório

string

Razão social cadastrada da empresa.

inscricaoMunicipal

string ou null

Inscrição municipal da empresa, quando disponível.

municipio
obrigatório

object

Município de estabelecimento da empresa.

municipio.codigoIbge
obrigatório

string

Código IBGE do município.

municipio.nome

string

Nome do município.

municipio.uf

string

Sigla da unidade federativa.

nfse

object

Parâmetros de emissão de NFS-e da empresa.

nfse.padrao

string

O sistema de NFS-e que a prefeitura da empresa usa hoje, no mesmo enum minúsculo de CapacidadesMunicipio.padrao (gissonline, nacional, barueri, saopaulo…). Pode ganhar valores novos.

nfse.padraoPorRegime

array de object

Padrões de emissão configurados para os regimes e períodos indicados.

nfse.padraoPorRegime[].regime
obrigatório string

nfse.padraoPorRegime[].padrao
obrigatório string

nfse.padraoPorRegime[].desde
obrigatório string (date)

nfse.serie

string

Série usada para emissão de RPS.

nfse.proximoRps

string

Próxima numeração de RPS configurada para emissão.

nfse.regime

object

Enquadramento tributário usado na emissão.

nfse.regime.situacaoSimplesNacional

integer

Situação perante o Simples Nacional — código oficial (opSimpNac da DPS nacional).

Código	Significado
1	Não optante
2	MEI
3	ME/EPP

Valor	Significado
`1`	Não optante
`2`	MEI
`3`	ME/EPP

nfse.regime.regimeEspecial

integer

Regime especial de tributação municipal — código oficial (regEspTrib). Quem não tem regime especial é 0, e isso é uma declaração.

Código	Significado
0	Nenhum
1	Ato cooperado (cooperativa)
2	Estimativa
3	Microempresa municipal
4	Notário ou registrador
5	Profissional autônomo
6	Sociedade de profissionais
9	Outros

Valor	Significado
`0`	Nenhum
`1`	Ato cooperado (cooperativa)
`2`	Estimativa
`3`	Microempresa municipal
`4`	Notário ou registrador
`5`	Profissional autônomo
`6`	Sociedade de profissionais
`9`	Outros

nfse.regime.regimeApuracaoSimples

integer

Regime de apuração do optante ME/EPP — código oficial (regApTribSN). Obrigatório quando situacaoSimplesNacional = 3; ausente nos demais.

Código	Significado
1	Tributos federais e ISSQN apurados pelo Simples Nacional
2	Tributos federais pelo Simples; ISSQN fora do Simples, pela legislação municipal
3	Tributos federais e ISSQN fora do Simples, pelas legislações de cada tributo

Valor	Significado
`1`	Federais e ISSQN pelo Simples Nacional
`2`	Federais pelo Simples; ISSQN fora
`3`	Federais e ISSQN fora do Simples

nfse.incentivoFiscal

boolean

Indica se a empresa declara incentivo fiscal.

certificado

object

Informações sobre o certificado digital da empresa.

certificado.situacao
obrigatório

string

Situação do certificado digital A1 da empresa.

Valor	Significado
`valido`	Certificado presente e dentro da validade — emissão liberada
`vencido`	Certificado presente, mas vencido — emissão bloqueada até enviar um novo
`ausente`	A empresa ainda não enviou o certificado

certificado.validoAte

string (date) ou null

Data de vencimento do certificado digital.

certificado.cnpj

string

CNPJ identificado no certificado digital.

Exemplo de resposta 200

JSON

{
  "cnpj": "21664333000195",
  "razaoSocial": "WEESY SOFTWARE LTDA",
  "inscricaoMunicipal": "249122",
  "municipio": {
    "codigoIbge": "3547809",
    "nome": "Santo André",
    "uf": "SP"
  },
  "nfse": {
    "padrao": "gissonline",
    "padraoPorRegime": [
      {
        "regime": "simples_nacional",
        "padrao": "nacional",
        "desde": "2026-11-01"
      }
    ],
    "serie": "02",
    "proximoRps": "8",
    "regime": {
      "situacaoSimplesNacional": 3,
      "regimeEspecial": 0,
      "regimeApuracaoSimples": 1
    },
    "incentivoFiscal": false
  },
  "certificado": {
    "situacao": "valido",
    "validoAte": "2027-08-11",
    "cnpj": "21664333000195"
  }
}

← Voltar ao início