Cadastrar empresa
POST
/empresasCadastra o CNPJ emissor. Para testar sem certificado, mande simulado: true (só emite com chave sk_test_).
Corpo da requisição
cnpjobrigatóriostringCNPJ, só dígitos.
razao_socialobrigatóriostringRazão social.
emailemailE-mail da empresa (responde aos e-mails ao tomador).
email_tomador_padraobooleanNotas sem enviar_email_tomador usam este padrão.
enderecoobjectEndereço com código IBGE do município.
informacoes_complementares_padraostringVai nas notas que não mandam servico.informacoes_complementares.
inscricao_estadualstringInscrição estadual.
referencia_externastringId da empresa no seu sistema.
simuladobooleanEmpresa de teste: com chave sk_test_ as notas não vão à SEFIN nem à prefeitura (dispensa certificado). Padrão: false.
telefonestringTelefone.
texto_email_tomadorstringParágrafo do e-mail ao tomador.
Retorno
201 Created
Autenticação
Bearer sk_test_ / sk_live_
curl -X POST https://api.seelo.com.br/v1/empresas \
-H "Authorization: Bearer sk_test_••••" \
-H "Content-Type: application/json" \
-d '{
"cnpj": "46399735000130",
"razao_social": "NTR SOLUTIONS LTDA",
"email": "financeiro@cliente.com.br",
"endereco": {
"logradouro": "Rua das Trincheiras",
"numero": "100",
"bairro": "Centro",
"codigo_ibge": "2507507",
"uf": "PB",
"cep": "58000000"
},
"referencia_externa": "emp_123",
"simulado": false
}'201
{ "id": "8b0d6f0e-2c1a-4f4e-9a57-3f1e2d9c4a10", "objeto": "empresa", "status": "pendente_configuracao", "cnpj": "46399735000130", "razao_social": "NTR SOLUTIONS LTDA", "email": "financeiro@cliente.com.br", "ativo": true, "certificado": null, "configuracao_fiscal": null, "credenciais_prefeitura": false, "criado_em": "2026-11-01T14:00:00-03:00", "email_tomador_padrao": false, "endereco": { "logradouro": "Rua das Trincheiras", "numero": "100", "complemento": null, "bairro": "Centro", "codigo_ibge": "2507507", "uf": "PB", "cep": "58000000" }, "informacoes_complementares_padrao": null, "inscricao_estadual": null, "logo_url": null, "producao_liberada_em": null, "referencia_externa": "emp_123", "simulado": false, "telefone": "83999990000", "texto_email_tomador": null }