Todo emissor nasce em homologação (SEFAZ de teste, sem validade fiscal). Não
existe um campo
environment que você define no cadastro. Ver Sandbox
para o que isso significa na prática e como ir pra produção.Antes de integrar o cenário do seu cliente: confira se o regime tributário e a
operação dele (ST, DIFAL, exportação, transporte…) já emitem hoje em Cobertura
Fiscal, documento × regime × cenário, com o erro exato onde não emite.
1
Crie sua conta e gere sua API Key
POST /v1/auth/register cria a conta na hora e responde 202: pedido de
acesso já aprovado, partner (a software house) no plano Dev (R$ 0), convite de
dono por e-mail e assinatura ativa, tudo na mesma transação. A senha é criada
no aceite do convite. Contra abuso: 5 pedidos por minuto por IP, no máximo 3
contas por IP a cada 24 h (a 4ª recusa com 429) e e-mail descartável recusa com
422; e-mail já em uso devolve a mesma resposta, sem criar nada. Os limites
por IP se aplicam também a e-mails já usados.- cURL
- Node.js
- Python
whatsapp exige DDD completo: 10 dígitos (fixo) ou 11 (celular, com o nono
dígito). A validação ignora máscara, aceitando tanto dígitos crus
(11988887777) quanto formatado ((11) 98888-7777), mas rejeita telefone
incompleto (ex.: 11).Resposta de sucesso (202)
Conta criada? O e-mail de convite traz um link para criar a senha
(
POST /v1/invite/accept). Depois de entrar no dashboard,
gere sua ek_test_ em Configurações → API Keys (ou via
POST /v1/auth/api-keys/test/regenerate, autenticado). Ela só aparece uma vez:
guarde-a. Nenhum caminho do cadastro emite ek_live_: a key de produção
exige assinatura de plano pago, ver Autenticação.2
Cadastre uma empresa emissora
Registre o CNPJ que vai emitir os documentos fiscais. A empresa nasce em homologação;
guarde o
id retornado: é o issuerId usado para escolher o emissor na emissão (opcional
com um único emissor, obrigatório a partir do segundo).- cURL
- Node.js
- Python
3
Faça upload do certificado digital
Envie o certificado
.pfx (A1) da empresa emissora. Ele será criptografado e armazenado com segurança.- cURL
- Node.js
- Python
Não tem certificado digital para testes? Em homologação, você pode usar um certificado de teste emitido por qualquer AC (Autoridade Certificadora) habilitada. Veja nosso guia de certificados.
4
Emita sua primeira NF-e
Com a empresa e o certificado configurados, emita a nota.
Quais campos enviar? O exemplo abaixo cobre o mínimo. A lista completa de
campos de emissão, navegável por grupo (Identificação, Destinatário, Itens,
Impostos, Transporte, Pagamento…), gerada direto do contrato real, está no
Catálogo de campos: NF-e. Emitindo NFC-e ou NFS-e?
Veja os catálogos de NFC-e e NFS-e.
- cURL
- Node.js
- Python
Resposta de sucesso
Sua primeira nota fiscal foi emitida e autorizada pelo SEFAZ de homologação.
Próximos passos
Catálogo de campos
Todo campo de NF-e/NFC-e/NFS-e, navegável por grupo, gerado do contrato real
Autenticação
JWT, API Keys e multi-tenancy explicados
Primeira Emissão
Todos os campos obrigatórios detalhados
Webhooks
Notificações em tempo real de cada evento