Pular para o conteúdo
notemnotemDocumentação

Referência da API › Serviços

Listar serviços

Lista os serviços cadastrados na empresa, ativos e inativos.

GET/api/v1/empresas/{id}/servicos

A lista é paginada. Cada serviço define o código do serviço, a tributação e a retenção usadas nas notas.

Parâmetros

idtextono caminhoobrigatório
Empresa da organização da chave (de outra organização → 404). UUID (RFC 9562); fora do padrão → 400 REQUISICAO_INVALIDA com campo id. · UUID
limiteinteirona consulta
de 1 a 100 · Padrão: 50
cursortextona consulta

Respostas

200 Lista paginada

Campos da resposta
dadoslista de objeto
dados[].idtexto
UUID
dados[].id_externotexto ou null
até 100 caracteres
dados[].nometexto
dados[].ativobooleano
Padrão: true
dados[].codigo_servicotexto
Formato: ^\d{6}$
dados[].descricao_servicotexto ou null
dados[].codigo_municipaltexto ou null
dados[].codigo_nbstexto ou null
Formato: ^\d{9}$
dados[].descricao_padraotexto
dados[].tributacao_isstexto
Valores: tributavel, imunidade, exportacao, nao_incidencia
dados[].tipo_imunidadetexto ou null
Valores: nao_informado, entes_federativos, templos, partidos_sindicatos_entidades, livros_jornais_papel, fonogramas_musicais
dados[].retencao_isstexto
Valores: nao_retido, retido_tomador, retido_intermediario
dados[].classificacao_ibscbsobjeto ou null
dados[].classificacao_ibscbs.codigo_classificacaotexto
Formato: ^\d{6}$
dados[].classificacao_ibscbs.csttexto ou null
dados[].classificacao_ibscbs.descricaotexto ou null
dados[].classificacao_ibscbs.indicador_operacaotexto ou null
Formato: ^\d{6}$
dados[].classificacao_ibscbs.consumidor_finalbooleano
Padrão: false
dados[].classificacao_ibscbs.atividade_simplestexto ou null
Somente ME/EPP. 10 só com 16.01; 11 só com 99.04.01; 12/13 só com 7.02 e 7.05. Enviada a partir do próximo leiaute. · Valores: 07, 08, 09, 10, 11, 12, 13, 14, 90
dados[].classificacao_ibscbs.situacaotexto
a_revisar = indicador retirado da tabela oficial · Valores: completa, pendente, a_revisar
dados[].indicador_operacao_ibscbstexto ou null
Obsoleto: use classificacao_ibscbs.indicador_operacao. Ainda aceito; se enviado junto com um valor diferente em classificacao_ibscbs, responde 422. · Obsoleto.
dados[].numero_beneficio_municipaltexto ou null
proximo_cursortexto ou null

404 Erro no formato padrão

Limites

Esta operação: 60 por minuto. Valem também os limites gerais da chave. Veja Limites de uso.