Pular para o conteúdo
notemnotemDocumentação

Referência da API › Empresas

Excluir empresa

Exclui uma empresa que nunca emitiu nota.

DELETE/api/v1/empresas/{id}

Use para remover um cadastro feito por engano. A exclusão é definitiva e remove também os serviços, a configuração fiscal e o certificado guardado.

Só é permitida se a empresa nunca usou um número de nota e não tem notas em nenhum ambiente, porque números já usados precisam continuar registrados. Caso contrário, a resposta é 409 EMPRESA_POSSUI_HISTORICO; desative a empresa com ativa: false.

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
Idempotency-Keytextono cabeçalho
Chave de idempotência (até 100 caracteres) aceita em POST, PATCH, PUT e DELETE; vale 24 h por integração e ambiente, exceto emissão, cancelamento, análise e substituição de notas (associação duradoura ao pedido). Mesmo conteúdo devolve a mesma resposta (cabeçalho Idempotent-Replayed true); conteúdo diferente devolve 409 IDEMPOTENCIA_CONFLITO. Obrigatória em emissão, cancelamento e substituição. · até 100 caracteres

Respostas

204 Excluída (serviços, certificado e configuração removidos)

404 Erro no formato padrão

409 EMPRESA_POSSUI_HISTORICO — use ativa false

Limites

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