Chaves de API

Chaves permitem que outro sistema (ERP, Salesforce, n8n, um assistente de IA) acesse sua conta.

Criar uma chave

1. No painel, abra API.
2. Clique em Criar chave, dê um nome que identifique a integração (ex.: Salesforce produção) e marque só as permissões necessárias.
3. Copie a chave na hora. Ela começa com pk_live_ e não será mostrada de novo.

Permissões

Permissão	Libera
invoices:read	Listar e consultar notas e ver se a empresa está pronta para emitir
invoices:write	Emitir notas
invoices:cancel	Cancelar notas
webhooks:manage	Cadastrar e remover webhooks

Boas práticas

• Uma chave por integração: se uma vazar, você revoga só ela.
• Guarde a chave em cofre de segredos (no Salesforce: Named Credential), nunca no código.
• Revogar desativa a chave na hora.