Serviços

Alterar um serviço

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

Altera o serviço. As próximas notas usam os dados novos; as já emitidas não mudam.

Parâmetros

Nome	Onde	Tipo	Descrição
cnpj obrigatório	caminho	string	CNPJ da empresa, só números.
id obrigatório	caminho	integer	O `id` do serviço, devolvido no cadastro.

Exemplo de chamada

cURLcurl --request PUT \
  --url "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/servicos/<id>" \
  --header "Authorization: Bearer $WEESY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "descricao": "Suporte técnico",
  "atividadeMunicipio": "620910000",
  "nbs": "115013000",
  "cIndOp": "100301",
  "cClassTrib": "000001",
  "exigibilidadeIss": 1,
  "consumoPessoal": false,
  "issRetidoPadrao": false,
  "discriminacaoPadrao": "Suporte técnico mensal ao sistema",
  "ativo": true,
  "confirmadoPor": "Maria Souza (contadora)"
}'

Node.jsconst resposta = await fetch("https://apifiscal.weesy.com.br/v1/empresas/21664333000195/servicos/<id>", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.WEESY_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "descricao": "Suporte técnico",
    "atividadeMunicipio": "620910000",
    "nbs": "115013000",
    "cIndOp": "100301",
    "cClassTrib": "000001",
    "exigibilidadeIss": 1,
    "consumoPessoal": false,
    "issRetidoPadrao": false,
    "discriminacaoPadrao": "Suporte técnico mensal ao sistema",
    "ativo": true,
    "confirmadoPor": "Maria Souza (contadora)"
  }),
});
console.log(resposta.status, await resposta.text());

Pythonimport os

import requests

resposta = requests.put(
    "https://apifiscal.weesy.com.br/v1/empresas/21664333000195/servicos/<id>",
    headers={"Authorization": f"Bearer {os.environ['WEESY_TOKEN']}"},
    json={
        "descricao": "Suporte técnico",
        "atividadeMunicipio": "620910000",
        "nbs": "115013000",
        "cIndOp": "100301",
        "cClassTrib": "000001",
        "exigibilidadeIss": 1,
        "consumoPessoal": False,
        "issRetidoPadrao": False,
        "discriminacaoPadrao": "Suporte técnico mensal ao sistema",
        "ativo": True,
        "confirmadoPor": "Maria Souza (contadora)",
    },
    timeout=30,
)
print(resposta.status_code, resposta.text)

PHP<?php

$corpo = <<<'JSON'
{
  "descricao": "Suporte técnico",
  "atividadeMunicipio": "620910000",
  "nbs": "115013000",
  "cIndOp": "100301",
  "cClassTrib": "000001",
  "exigibilidadeIss": 1,
  "consumoPessoal": false,
  "issRetidoPadrao": false,
  "discriminacaoPadrao": "Suporte técnico mensal ao sistema",
  "ativo": true,
  "confirmadoPor": "Maria Souza (contadora)"
}
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/servicos/<id>", 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 = """
    {
      "descricao": "Suporte técnico",
      "atividadeMunicipio": "620910000",
      "nbs": "115013000",
      "cIndOp": "100301",
      "cClassTrib": "000001",
      "exigibilidadeIss": 1,
      "consumoPessoal": false,
      "issRetidoPadrao": false,
      "discriminacaoPadrao": "Suporte técnico mensal ao sistema",
      "ativo": true,
      "confirmadoPor": "Maria Souza (contadora)"
    }
    """;

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

Corpo da requisição

Campo	Tipo	Descrição
descricao obrigatório	string	Nome do serviço, como aparece para você. Não pode repetir na mesma empresa.
codigo	string ou null	Código livre do integrador, para quem usa a própria codificação de serviços (ex.: `010902220`).
servicoMunicipio	string	Código do serviço na lista da prefeitura (veja Listar os códigos de serviço da cidade).
atividadeMunicipio	string	Código da atividade na prefeitura (veja Listar as atividades de um código de serviço), ex. `620910000`.
codigoTributacaoMunicipalNacional	string	`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.
issRetidoPadrao	boolean	Valor padrão de retenção de ISS para emissões deste serviço.
aliquotaIssFixada	number ou null	Vazio = a do município.
tipoTributacaoSaoPaulo	string	Só São Paulo.
discriminacaoPadrao	string	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.

Exemplo

JSON

{
  "descricao": "Suporte técnico",
  "atividadeMunicipio": "620910000",
  "nbs": "115013000",
  "cIndOp": "100301",
  "cClassTrib": "000001",
  "exigibilidadeIss": 1,
  "consumoPessoal": false,
  "issRetidoPadrao": false,
  "discriminacaoPadrao": "Suporte técnico mensal ao sistema",
  "ativo": true,
  "confirmadoPor": "Maria Souza (contadora)"
}

Respostas

200: Alterado.
400: Algum dado está errado ou faltando. A lista erros diz qual campo e o que corrigir (code = validacao). (formato de erro)
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
descricao obrigatório	string	Nome do serviço, como aparece para você. Não pode repetir na mesma empresa.
codigo	string ou null	Código livre do integrador, para quem usa a própria codificação de serviços (ex.: `010902220`).
servicoMunicipio	string	Código do serviço na lista da prefeitura (veja Listar os códigos de serviço da cidade).
atividadeMunicipio	string	Código da atividade na prefeitura (veja Listar as atividades de um código de serviço), ex. `620910000`.
codigoTributacaoMunicipalNacional	string	`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.
issRetidoPadrao	boolean	Valor padrão de retenção de ISS para emissões deste serviço.
aliquotaIssFixada	number ou null	Vazio = a do município.
tipoTributacaoSaoPaulo	string	Só São Paulo.
discriminacaoPadrao	string	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`).
resolvido	object	O que a API resolve a partir da folha do município.
resolvido.itemListaServico	string
resolvido.codigoTributacaoNacional	string ou null
resolvido.cst	string
resolvido.aliquotaVigente	number ou null
resolvido.vigenteDesde	string (date) ou null

← Voltar ao início