Empresas e emitentes
Uma conta Conota pode operar documentos de várias empresas. Cada emitente mantém os próprios dados cadastrais, configurações fiscais, certificado e sequências de numeração.
O CNPJ do emitente não é apenas um campo do payload: ele identifica a empresa responsável pelo documento e determina certificado, credenciais fiscais, numeração e comunicação com o autorizador.
Rotas
| Operação | Rota |
|---|---|
| Listar empresas da conta | GET /v1/empresas |
| Cadastrar | POST /v1/empresas |
| Detalhe | GET /v1/empresas/{cpf_cnpj} |
| Atualizar | PUT /v1/empresas/{cpf_cnpj} |
| Configurar NF-e / NFS-e / NFC-e | PUT /v1/empresas/{cpf_cnpj}/nfe · /nfse · /nfce |
| Enviar certificado A1 | PUT /v1/empresas/{cpf_cnpj}/certificado |
| Validade dos certificados | GET /v1/empresas/certificados |
| Em que número cada série está | GET /v1/empresas/numeracao |
O {cpf_cnpj} na URL aceita CNPJ alfanumérico.
A barra da máscara é separador de caminho. /v1/empresas/11.222.333/0001-81 não é uma
rota válida — responde 404.
Use 11222333000181. Ponto e hífen até passam (11.222.333.0001-81), mas só dígitos é mais
simples. CPF com máscara funciona (125.244.567-90), porque não tem barra.
Em query string e no corpo, a máscara completa é aceita.
Configuração é por tipo de documento
Cadastrar a empresa não basta. Cada tipo de documento tem a própria configuração:
- NF-e — ambiente, CRT, série;
- NFC-e — exige CSC configurado, além da série;
- NFS-e — município, inscrição municipal, regime, provedor e, em alguns municípios, credenciais da prefeitura.
Emitir sem a configuração correspondente falha antes de chegar ao autorizador.
Antes de emitir
Garanta que os dados do emitente estejam atualizados e que as configurações do tipo de documento tenham sido concluídas.
Mudanças de razão social, endereço, regime tributário ou credenciais municipais podem exigir atualização cadastral antes de novas emissões.
Desde 31/07/2026 o CNPJ pode ter letras nas 12 primeiras posições (os 2 dígitos verificadores seguem numéricos). A API do Conota aceita o formato novo em todos os pontos que tratam documento.