Weesy Docs

Serviços

Consultar um serviço

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

Abrir na referência interativa

Mostra um serviço da empresa com os códigos da prefeitura, a NBS e os códigos do IBS/CBS que vão para a nota. Confira antes de emitir a primeira nota com ele.

Parâmetros

NomeOndeTipoDescrição
cnpj
obrigatório
caminhostring

CNPJ da empresa, só números.

id
obrigatório
caminhointeger

O id do serviço, devolvido no cadastro.

Exemplo de chamada

cURL

curl --request GET \
  --url "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/servicos/<id>" \
  --header "Authorization: Bearer $WEESY_TOKEN"

Node.js

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

Respostas

Campos da resposta 200

CampoTipoDescrição
descricao
obrigatório
string

Nome do serviço, como aparece para você. Não pode repetir na mesma empresa.

codigostring ou null

Código livre do integrador, para quem usa a própria codificação de serviços (ex.: 010902220).

servicoMunicipiostring

Código do serviço na lista da prefeitura (veja Listar os códigos de serviço da cidade).

atividadeMunicipiostring

Código da atividade na prefeitura (veja Listar as atividades de um código de serviço), ex. 620910000.

codigoTributacaoMunicipalNacionalstring

cTribMun do padrão nacional.

nbs
obrigatório
string

Código NBS informado para o serviço.

cIndOp
obrigatório
string

Indicador de operação IBS/CBS aplicável ao serviço.

cClassTrib
obrigatório
string

Classificação tributária IBS/CBS informada para o serviço.

exigibilidadeIss
obrigatório
integer

Código de exigibilidade do ISS para este serviço.

consumoPessoal
obrigatório
boolean

Indica se o serviço está classificado como consumo pessoal.

issRetidoPadraoboolean

Valor padrão de retenção de ISS para emissões deste serviço.

aliquotaIssFixadanumber ou null

Vazio = a do município.

tipoTributacaoSaoPaulostring

Só São Paulo.

discriminacaoPadraostring

Texto padrão para discriminar a prestação na nota.

ativo
obrigatório
boolean

Indica se o serviço pode ser usado para novas emissões.

confirmadoPor
obrigatório
string

Quem conferiu os códigos tributários.

id
obrigatório
integer
confirmadoEm
obrigatório
string (date-time)

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

resolvidoobject

O que a API resolve a partir da folha do município.

resolvido.itemListaServicostring
resolvido.codigoTributacaoNacionalstring ou null
resolvido.cststring
resolvido.aliquotaVigentenumber ou null
resolvido.vigenteDesdestring (date) ou null
← Voltar ao início