API de NFS-e Nacional do Contta: emite, consulta, cancela e devolve o PDF de notas de serviço pelo emissor nacional (Sefin Nacional), em nome das empresas do seu escritório.
Como funciona. Você manda o FATO (o que foi feito, para quem e quanto). O Contta decide código de serviço, alíquota, retenção e regime pelo cadastro fiscal da empresa e devolve uma PRÉVIA. A nota só sai quando você confirma a prévia com o previa_hash. Faltou algo: a resposta traz pendencias com a pergunta pronta; pedido recusado traz proximo_passo.
Autenticação. Authorization: Bearer ctk_.... A chave é criada por um responsável do escritório (owner/admin) em Contta > Emissão > Chaves de API e age em nome dessa pessoa. Escopos: nfse:emitir (emitir, confirmar, cancelar) e nfse:consultar (consultar, listar, PDF, XML).
Teste e produção. Chave nova emite só na homologação nacional (nota de teste, sem valor fiscal). Nota real exige chave liberada pelo dono do escritório e a empresa liberada para produção.
Idempotência. Mande request_id no corpo ou o header Idempotency-Key: o mesmo pedido repetido devolve o mesmo resultado, sem nota em dobro. Resposta 202 no confirmar = o fisco ainda não respondeu: consulte, nunca confirme de novo.
Limite. 120 pedidos por minuto por chave (HTTP 429 acima disso).