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}/situacaoUse 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
idEmpresa 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
ambienteValores:
homologacao, producaopronta_para_emitiritensitens[].itemValores:
empresa_ativa, certificado, configuracao_fiscal, servico_ativo, classificacao_ibscbs, municipioitens[].okitens[].mensagemitens[].verificado_emdata e hora ISO 8601
avisosAlertas 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[].itemValores:
classificacao_ibscbs, atividade_simplesavisos[].mensagempendenciasLista 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.

