Empresas
As empresas da carteira do escritório. O id de cada empresa identifica o emissor nas chamadas de NFS-e, clientes, serviços e guias.
Escoposempresas:ler · empresas:escrever
# Produçãohttps://api.emissordenota.com/v1# Sandboxhttps://sandbox.api.emissordenota.com/v1Notificações ao usuário da integração
Inclua notificacoes no corpo da operação para avisar quem usa seu sistema. Informe os contatos desse usuário. A escolha vale só para a operação e seus resultados, inclusive quando a autorização da nota chega depois.
{ "notificacoes": { "destinatario": { "email": "usuario@example.com" }, "eventos": { "empresa.cadastrada": [ "email" ] } }}Omitir notificacoes executa a operação sem solicitar aviso. Cada canal precisa estar liberado no plano para o evento da API. Um pedido sem permissão retorna 403 permissao_insuficiente antes de executar a operação. Informe o WhatsApp com DDI e confirme a autorização do destinatário. Repetir uma chamada concluída com a mesma Idempotency-Key recupera a resposta original sem novo disparo. O sandbox valida a seleção e simula a operação sem efetuar entregas.
No cadastro, solicite empresa.cadastrada ou empresa.bloqueada. Na atualização, empresa.bloqueada está disponível. Para eventos futuros do CNPJ, inclua avisos_automaticos no cadastro ou na atualização. Enviar uma configuração substitui a anterior. Enviar null desativa. Omitir preserva a configuração.
{ "avisos_automaticos": { "destinatario": { "email": "usuario@example.com" }, "eventos": { "guia.disponivel": [ "email" ], "guia.vencendo": [ "email" ], "ecac.nova_mensagem": [ "email" ] } }}A chave precisa também de guias:ler para guias, empresas:ler para certificados e ecac:avisos para a Caixa Postal. Outros eventos automáticos disponíveis incluem guia.vencida, guia.paga, certificado.cadastrado, certificado.vencendo, certificado.vencido, empresa.bloqueada, acesso.disponivel, acesso.aceito e acesso.revogado. Para avisos de acesso, informe o e-mail do usuário convidado.
Endpoints
- GET
/v1/empresasLista as empresas da carteira - POST
/v1/empresasCadastra uma empresa - GET
/v1/empresas/{id}Consulta uma empresa - POST
/v1/empresas/{id}Atualiza os dados cadastrais
O objeto empresa
idstringcnpjstringrazao_socialstringinscricao_municipalstringregime_tributariostringmunicipioobjectsituacaostringpendenciasarraycriada_emstring{ "id": "emp_8Kq2mXv41c", "cnpj": "12345678000190", "razao_social": "Studio Aurora Design Ltda", "nome_fantasia": "Studio Aurora", "inscricao_municipal": "48291037", "regime_tributario": "simples_nacional", "municipio": { "codigo_ibge": "3550308", "nome": "São Paulo", "uf": "SP" }, "email": "financeiro@studioaurora.com.br", "situacao": "pronta", "pendencias": [], "criada_em": "2026-10-02T14:20:31-03:00"}Cadastrar uma empresa
POST/v1/empresas
Cria a empresa na carteira do escritório. Ela nasce com a situação pendente até o certificado A1 ser enviado pelo painel.
Corpo da requisição
cnpjstringobrigatóriorazao_socialstringobrigatórioregime_tributariostringobrigatórioenderecoobjectobrigatóriocepstringobrigatórionumerostringobrigatóriocomplementostringopcionalnome_fantasiastringopcionalinscricao_municipalstringopcionalemailstringopcionalcurl -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", "regime_tributario": "simples_nacional", "endereco": { "cep": "01310100", "numero": "1578" } }'Listar empresas
GET/v1/empresas
Devolve as empresas liberadas para a chave, da mais recente para a mais antiga.
Parâmetros de consulta
situacaostringopcionalcnpjstringopcionallimiteintegeropcionalcursorstringopcional{ "dados": [ { "id": "emp_8Kq2mXv41c", "cnpj": "12345678000190", "razao_social": "Studio Aurora Design Ltda", "situacao": "pronta" } ], "proximo_cursor": null}Atualizar uma empresa
POST/v1/empresas/{id}
Envie só os campos que mudaram. A resposta traz o objeto empresa atualizado.
Erros
StatusCódigoQuando
- 403limite_de_empresasA carteira chegou ao limite do plano.
- 409empresa_ja_cadastradaO CNPJ já está na carteira.
- 422dados_invalidosCNPJ, CEP ou regime inválidos.