Primeiros passos
Da sua conta à primeira consulta.
Sua integração começa com uma consulta
Uma única API conecta os cadastros e os documentos fiscais da sua empresa. Use uma chave técnica para identificar a conta em cada requisição.
1. Crie uma chave
No painel, acesse Desenvolvedores → Chaves da API. Dê um nome à integração, escolha o ambiente, as permissões e a validade. O segredo aparece uma única vez: guarde-o no servidor da sua integração.
2. Consulte sua identidade
Faça GET /api/v1/me com o cabeçalho Authorization: Bearer AQUI_VAI_A_CHAVE. Inclua a permissão identity:read. A resposta informa empresa, ambiente, permissões e validade.
3. Localize seus cadastros
Consulte clientes, produtos e serviços antes de preparar documentos. Os IDs usados nas requisições pertencem ao NF3 e à empresa identificada pela chave.
4. Prepare e revise
A emissão tem etapas distintas: preparar o rascunho, conferir o conteúdo, confirmar a transmissão e acompanhar o resultado. O exemplo de autenticação ao lado é apenas uma consulta de identidade.