---
title: "Guia: cadastrar empresas pela API"
description: "Cadastre empresas da carteira do escritório pela API, confira as pendências (certificado, inscrição municipal, endereço) e mantenha o cadastro atualizado."
url: https://docs.emissordenota.com/guias/cadastrar-empresas
language: pt-BR
---
# Cadastrar empresas

Cada empresa da carteira do escritório é um recurso da API. Este guia mostra como cadastrar uma empresa, conferir se ela está pronta para emitir e manter o cadastro em dia.

## Antes de começar

- A chave precisa do escopo empresas:escrever.
- O plano do escritório define quantas empresas cabem na carteira. Ao passar do limite, a API responde 403 com o código limite_de_empresas.
- O certificado digital A1 é enviado pelo painel. A API não recebe o arquivo nem a senha do certificado.

## Cadastre a empresa

*PASSO 1 DE 3*

CNPJ, razão social, regime tributário e CEP bastam para criar o cadastro. O endereço é completado a partir do CEP.

**Requisição**

```bash
curl -X POST https://api.emissordenota.com/v1/empresas \
  -H "Authorization: Bearer $EDN_KEY" \
  -H "Idempotency-Key: empresa-12345678000190" \
  -H "Content-Type: application/json" \
  -d '{
    "cnpj": "12345678000190",
    "razao_social": "Studio Aurora Design Ltda",
    "nome_fantasia": "Studio Aurora",
    "inscricao_municipal": "48291037",
    "regime_tributario": "simples_nacional",
    "email": "financeiro@studioaurora.com.br",
    "endereco": { "cep": "01310100", "numero": "1578", "complemento": "Sala 42" }
  }'
```

**Resposta · 201 Created**

```json
{
  "id": "emp_8Kq2mXv41c",
  "cnpj": "12345678000190",
  "razao_social": "Studio Aurora Design Ltda",
  "regime_tributario": "simples_nacional",
  "municipio": { "codigo_ibge": "3550308", "nome": "São Paulo", "uf": "SP" },
  "situacao": "pendente",
  "pendencias": ["certificado"]
}
```

## Confira se ela pode emitir

*PASSO 2 DE 3*

Uma empresa só emite quando a situacao é pronta. Enquanto houver pendências, POST /nfse responde 422 e aponta o que falta.

| Pendência | Como resolver |
| --- | --- |
| certificado | O escritório envia o certificado A1 da empresa pelo painel. |
| inscricao_municipal | Informe a inscrição municipal com POST /empresas/{id}. |
| endereco | O CEP não trouxe o endereço completo. Envie logradouro, bairro e município. |

**Consultando a situação**

```bash
curl https://api.emissordenota.com/v1/empresas/emp_8Kq2mXv41c \
  -H "Authorization: Bearer $EDN_KEY"
```

Depois que o certificado é enviado, a situação passa para pronta e a lista de pendências volta vazia.

## Mantenha o cadastro em dia

*PASSO 3 DE 3*

Para alterar dados, envie só os campos que mudaram. O CNPJ não pode ser alterado.

**Requisição**

```bash
curl -X POST https://api.emissordenota.com/v1/empresas/emp_8Kq2mXv41c \
  -H "Authorization: Bearer $EDN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "regime_tributario": "lucro_presumido",
    "email": "fiscal@studioaurora.com.br"
  }'
```

Assine o evento certificado.vencendo para avisar o escritório antes que a empresa fique impedida de emitir.

## Erros comuns

| Status | Código | O que significa |
| --- | --- | --- |
| 403 | limite_de_empresas | A carteira chegou ao limite do plano do escritório. |
| 409 | empresa_ja_cadastrada | O CNPJ já está na carteira. O id existente vem em erro.detalhes. |
| 422 | dados_invalidos | CNPJ com dígito incorreto, CEP inexistente ou regime tributário desconhecido. |
