Weesy Docs

Empresas

Configurar a emissão de NFS-e

PUT https://apifiscal.weesy.com.br/v1/empresas/{cnpj}/configuracao-nfse

Abrir na referência interativa

Define a série e o número do próximo RPS (o número provisório que a nota recebe antes de virar NFS-e), o regime tributário e se a empresa tem incentivo fiscal. Normalmente se faz uma vez, antes da primeira nota.

Parâmetros

NomeOndeTipoDescrição
cnpj
obrigatório		caminhostring

CNPJ da empresa, só números.

Exemplo de chamada

cURL

curl --request PUT \
  --url "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/configuracao-nfse" \
  --header "Authorization: Bearer $WEESY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "serie": "02",
  "proximoRps": "1",
  "regime": {
    "situacaoSimplesNacional": 3,
    "regimeEspecial": 0,
    "regimeApuracaoSimples": 1
  },
  "incentivoFiscal": false
}'

Node.js

const resposta = await fetch("https://apifiscal.weesy.com.br/v1/empresas/21664333000195/configuracao-nfse", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "serie": "02",
    "proximoRps": "1",
    "regime": {
      "situacaoSimplesNacional": 3,
      "regimeEspecial": 0,
      "regimeApuracaoSimples": 1
    },
    "incentivoFiscal": false
  }),
});
console.log(resposta.status, await resposta.text());

Python

import os

import requests

resposta = requests.put(
    "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/configuracao-nfse",
    headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
    json={
        "serie": "02",
        "proximoRps": "1",
        "regime": {
            "situacaoSimplesNacional": 3,
            "regimeEspecial": 0,
            "regimeApuracaoSimples": 1,
        },
        "incentivoFiscal": False,
    },
    timeout=30,
)
print(resposta.status_code, resposta.text)

PHP

<?php

$corpo = <<<'JSON'
{
  "serie": "02",
  "proximoRps": "1",
  "regime": {
    "situacaoSimplesNacional": 3,
    "regimeEspecial": 0,
    "regimeApuracaoSimples": 1
  },
  "incentivoFiscal": false
}
JSON;

$contexto = stream_context_create(["http" => [
    "method" => "PUT",
    "header" => implode("\r\n", ["Authorization: Bearer " . getenv("WEESY_TOKEN"), "Content-Type: application/json"]),
    "content" => $corpo,
    "ignore_errors" => true, // lê o corpo também nas respostas de erro
]]);
$resposta = file_get_contents("https://apifiscal.weesy.com.br/v1/empresas/21664333000195/configuracao-nfse", false, $contexto);
echo $http_response_header[0], PHP_EOL, $resposta, PHP_EOL;

C#

using System.Net.Http.Headers;
using System.Text;

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

var corpo = """
    {
      "serie": "02",
      "proximoRps": "1",
      "regime": {
        "situacaoSimplesNacional": 3,
        "regimeEspecial": 0,
        "regimeApuracaoSimples": 1
      },
      "incentivoFiscal": false
    }
    """;

using var resposta = await http.PutAsync(
    "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/configuracao-nfse",
    new StringContent(corpo, Encoding.UTF8, "application/json"));
Console.WriteLine($"{(int)resposta.StatusCode} {await resposta.Content.ReadAsStringAsync()}");

Corpo da requisição

CampoTipoDescrição
seriestring

Série de RPS a configurar para a empresa.

proximoRpsstring

Próxima numeração de RPS a configurar.

regimeobject

Enquadramento tributário que será usado na emissão.

regime.situacaoSimplesNacionalinteger

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

CódigoSignificado
1Não optante
2MEI
3ME/EPP
ValorSignificado
1Não optante
2MEI
3ME/EPP
regime.regimeEspecialinteger

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

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

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

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

Indica se a empresa possui incentivo fiscal.

Exemplo

JSON
{
  "serie": "02",
  "proximoRps": "1",
  "regime": {
    "situacaoSimplesNacional": 3,
    "regimeEspecial": 0,
    "regimeApuracaoSimples": 1
  },
  "incentivoFiscal": false
}

Respostas

Campos da resposta 200

CampoTipoDescrição
cnpj
obrigatório		string

CNPJ da empresa da sua conta.

razaoSocial
obrigatório		string

Razão social cadastrada da empresa.

inscricaoMunicipalstring 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.nomestring

Nome do município.

municipio.ufstring

Sigla da unidade federativa.

nfseobject

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

nfse.padraostring

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.padraoPorRegimearray 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.seriestring

Série usada para emissão de RPS.

nfse.proximoRpsstring

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

nfse.regimeobject

Enquadramento tributário usado na emissão.

nfse.regime.situacaoSimplesNacionalinteger

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

CódigoSignificado
1Não optante
2MEI
3ME/EPP
ValorSignificado
1Não optante
2MEI
3ME/EPP
nfse.regime.regimeEspecialinteger

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

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

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

CódigoSignificado
1Tributos federais e ISSQN apurados pelo Simples Nacional
2Tributos federais pelo Simples; ISSQN fora do Simples, pela legislação municipal
3Tributos federais e ISSQN fora do Simples, pelas legislações de cada tributo
ValorSignificado
1Federais e ISSQN pelo Simples Nacional
2Federais pelo Simples; ISSQN fora
3Federais e ISSQN fora do Simples
nfse.incentivoFiscalboolean

Indica se a empresa declara incentivo fiscal.

certificadoobject

Informações sobre o certificado digital da empresa.

certificado.situacao
obrigatório		string

Situação do certificado digital A1 da empresa.

ValorSignificado
validoCertificado presente e dentro da validade — emissão liberada
vencidoCertificado presente, mas vencido — emissão bloqueada até enviar um novo
ausenteA empresa ainda não enviou o certificado
certificado.validoAtestring (date) ou null

Data de vencimento do certificado digital.

certificado.cnpjstring

CNPJ identificado no certificado digital.

Empresas

← Voltar ao início