Chave de acesso
Em Configurações > API e webhooks (dono ou administrador, com a verificação em duas etapas), crie a chave. Ela aparece uma vez só; guarde num cofre de segredos. Envie em todas as chamadas: Authorization: Bearer fsk_test_…. Enquanto o Fiscalo emite em produção restrita, as chaves são de teste.
Especificação
A especificação OpenAPI 3.1 está em api.fiscalo.com.br/v1/openapi.json. Importe no Postman, no Insomnia ou no Swagger Editor, ou gere o cliente da sua linguagem. A página de desenvolvedores tem exemplos de emissão.
Webhooks
Cadastre a URL (HTTPS, endereço público) e receba nota.autorizada, nota.rejeitada, nota.cancelada e nota.substituida. Cada aviso tem o cabeçalho Fiscalo-Assinatura: t=…,v1=…: confira o HMAC-SHA256 de t.corpo com o segredo do webhook e recuse avisos com mais de 5 minutos. Responda 2xx em até 10 segundos; sem isso, fazemos até 7 tentativas, com espera crescente (de 1 minuto a 24 horas).
Limites
300 chamadas por minuto por chave. Erros vêm em JSON ({ "erro": "…" }), com o detalhe de cada campo quando os dados são inválidos.
Não achou o que precisava? Escreva para [email protected].