Pular para o conteúdo
notemnotemDocumentação

Referência da API › Situação da empresa

Consultar situação

Diz se a empresa está pronta para emitir no ambiente da chave e o que falta.

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

Use antes da primeira emissão e sempre que uma emissão for recusada com EMPRESA_NAO_PRONTA. A notem confere o cadastro, a configuração fiscal, o certificado, os serviços e o convênio do município.

Itens em avisos não impedem a emissão.

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

Respostas

200 Situação

Campos da resposta
ambientetexto
Valores: homologacao, producao
pronta_para_emitirbooleano
itenslista de objeto
itens[].itemtexto
Valores: empresa_ativa, certificado, configuracao_fiscal, servico_ativo, classificacao_ibscbs, municipio
itens[].okbooleano ou null
itens[].mensagemtexto
itens[].verificado_emtexto ou null
data e hora ISO 8601
avisoslista de objeto
Alertas que não impedem a emissão. Antes da data de obrigatoriedade do IBS/CBS do ambiente (padrão 01/01/2027), serviços ativos sem classificação geram aviso; a partir dela viram o item classificacao_ibscbs.
avisos[].itemtexto
Valores: classificacao_ibscbs, atividade_simples
avisos[].mensagemtexto
pendenciaslista de texto
Lista dos item com ok diferente de true.

404 Erro no formato padrão

Limites

Valem também os limites gerais da chave. Veja Limites de uso.