GuiasCadastrar empresas

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.

PASSO 1 DE 3

Cadastre a empresa

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

Requisição
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": "[email protected]",    "endereco": { "cep": "01310100", "numero": "1578", "complemento": "Sala 42" }  }'
Resposta · 201 Created
{  "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"]}

PASSO 2 DE 3

Confira se ela pode emitir

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

PendênciaComo 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
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.

PASSO 3 DE 3

Mantenha o cadastro em dia

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

Requisição
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": "[email protected]"  }'

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

Erros comuns

StatusCódigoO que significa

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