🔑 Tem API? Como integro o meu sistema?
Em 30 segundos: Sim — API REST com chaves que você mesmo cria no painel, em Integrações → "API para o seu sistema" (planos pagos; a documentação é aberta a todos). A chave gnk_live_ aparece uma única vez — guardamos só a assinatura — e tem escopo próprio: emissão ou somente leitura, com revogação imediata. O quickstart de 4 passos já vem com a sua chave no exemplo, e o primeiro comando emite uma nota de teste, sem valor fiscal, para validar a integração de ponta a ponta. Na emissão, o cabeçalho Idempotency-Key protege: repetir a chamada com a mesma chave em até 24 horas devolve a mesma nota, sem emitir duas vezes; sem o cabeçalho, cada chamada emite uma nota nova. Erros vêm com código, mensagem e dica em português.
Como funciona
- No painel, abra Integrações → API para o seu sistema e crie uma chave escolhendo o escopo: emissão (emite e consulta) ou somente leitura (consulta e baixa PDF/XML — não emite).
- Copie a chave na hora: ela aparece uma única vez. Guardamos só a assinatura — nem a gente consegue vê-la de novo.
- Siga o quickstart de 4 passos, que já mostra os exemplos com a sua chave: o primeiro comando emite uma nota de teste, sem valor fiscal, que some sozinha em 24h — a integração validada de ponta a ponta, sem risco.
- A documentação completa está em gerenota.com.br/api, gerada do código a cada versão. Para a sua IA (Claude Code, Cursor, um agente no seu ERP), o mesmo guia em Markdown puro fica em /llms-full.txt — cole-o inteiro no assistente, ou use o botão Copiar guia para a sua IA na página Integrações.
- Mande o cabeçalho Idempotency-Key (um texto único seu por pedido) em toda emissão: se o seu sistema repetir a chamada com a mesma chave em até 24 horas (timeout, retry), volta a mesma nota — nunca uma segunda; sem o cabeçalho, cada chamada emite uma nota nova. Vazou a chave de API ou trocou de fornecedor? Revogue na página — o acesso cai na hora.
gerenota.
ERP faturamento
gnk_live_a1b2…
Escopo emissão · último uso hoje
Dashboard financeiro
gnk_live_9f8e…
Somente leitura — consulta e baixa XML; não emite
Criar chave
Nome + escopo; a chave aparece uma única vez
Criar
Exemplo: o ERP do Ricardo emite no fechamento com uma chave de escopo "emissão"; o dashboard do financeiro usa outra, somente leitura. Cada sistema com a sua — revogar uma não derruba a outra.
Pronto para ver na prática? Fale com a gente no WhatsApp — conta e primeira empresa
em menos de 5 minutos com tudo em mãos, e toda emissão passa pela sua confirmação.