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.
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" } }'{ "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
- certificadoO escritório envia o certificado A1 da empresa pelo painel.
- inscricao_municipalInforme a inscrição municipal com POST /empresas/{id}.
- enderecoO CEP não trouxe o endereço completo. Envie logradouro, bairro e município.
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.
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
StatusCódigoO que significa
- 403limite_de_empresasA carteira chegou ao limite do plano do escritório.
- 409empresa_ja_cadastradaO CNPJ já está na carteira. O id existente vem em erro.detalhes.
- 422dados_invalidosCNPJ com dígito incorreto, CEP inexistente ou regime tributário desconhecido.