---
title: "Cadastra uma empresa (CNPJ) para monitoramento"
method: POST
path: "/v1/companies"
tags: ["Empresas"]
---

# Cadastra uma empresa (CNPJ) para monitoramento

`POST /v1/companies`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/companies`
- Auth: HTTP bearer

Cadastra o CNPJ na conta. Ele nasce em estado `DRAFT` (produção) —
o próximo passo é enviar o certificado A1 em
`POST /companies/{id}/certificate`. A chave de teste de emissão não
cadastra empresa (403).

## Request body

- CriarEmpresaRequest
  - `cnpj` string, required: Só dígitos.
  - `nomeExibicao` string
  - `nsuInicial` integer: Avançado — de onde retomar a consulta ao ADN, se este CNPJ já era monitorado por outro sistema. Ausência = 0 (histórico completo).

## Response `201`

Criada

- Empresa
  - `id` string
  - `cnpj` string
  - `ambiente` 'SANDBOX' | 'PRODUCAO'
  - `ambienteAdn` 'HOMOLOGACAO' | 'PRODUCAO': Qual Ambiente de Dados Nacional (da Receita Federal) é consultado. HOMOLOGACAO nunca gera cobrança.
  - `escopoMonitoramento` 'RECEBIDAS' | 'EMITIDAS' | 'AMBAS': O que conta como visível/cobrável para esta empresa — todas as notas são sempre consultadas e guardadas, isso só afeta exibição e franquia.
  - `nomeExibicao` string, nullable
  - `razaoSocial` string, nullable
  - `estado` 'DRAFT' | 'VALIDATING' | 'ANALISANDO_HISTORICO' | 'INITIAL_SYNC' | 'ACTIVE' | 'PAUSED_BY_USER' | 'PAUSED_CERTIFICATE' | 'PAUSED_BILLING' | 'ERROR' | 'REMOVAL_PENDING' | 'REMOVED'
  - `nsuInicial` string
  - `nsuUltimoConfirmado` string, nullable
  - `ultimaConsultaEm` string, date-time, nullable
  - `monitorarDesde` string, date-time, nullable: Só notas emitidas a partir desta data aparecem e são cobradas. Ausência (null) = sem corte, todo o histórico aparece.
  - `certificadoValidoAte` string, date-time, nullable
  - `criadaEm` string, date-time
  - `atualizadaEm` string, date-time

## Other responses

- `400`: Corpo ou parâmetros inválidos.
- `401`: Chave de API ausente, inválida ou revogada.
- `403`: A chave de teste (`sdr_test_`) não faz esta operação: ela emite NFS-e e NF-e na homologação e lê empresas. Use uma chave de produção (`sdr_live_`).
- `409`: Este CNPJ já está cadastrado em outra conta Sudrel.
- `429`: 120 requisições por minuto por chave excedidas (janela fixa de 60 s, alinhada ao relógio). Sem cabeçalho `Retry-After`: espere a virada do minuto. Nas rotas de conta, empresas e documentos o corpo é este; nas de emissão, lote, webhooks e eventos é problem+json `limite_de_requisicoes`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)