cronotaDocumentação da API

/invoices

As notas do ambiente da chave, as mais novas primeiro.

Server URLhttps://cronota.clowk.in/api/v1
GET/invoices

Autorização

Bearer token: sk_live_… (Live) ou sk_test_… (Sandbox). A chave define a empresa e o ambiente.

Parâmetros

statusstring · queryopcional

Atalho: um status ou vários separados por vírgula, como authorized,cancelled.

competencestring · queryopcional

Atalho: o mês de competência inteiro, AAAA-MM.

customer_idstring · queryopcional

Atalho: só as notas deste tomador.

qobject · queryopcional

Filtros em q[campo_predicado]. Campos: status, source, nfse_number, access_key, amount_cents, competence, issued_at, cancelled_at, substituted_at, created_at, updated_at, customer_id, invoice_template_id, schedule_id, replaces_invoice_id e, do tomador, customer_document, customer_name, customer_email. Exemplos: q[status_in][]=authorized, q[amount_cents_gteq]=10000, q[issued_at_gteq]=2026-11-01, q[customer_document_start]=112223.

sortstring · queryopcional

Um campo, ou -campo para decrescente; vários com vírgula. Padrão -created_at.

pageinteger · queryopcional

A página, a partir de 1. A resposta diz total e has_more.

limitinteger · queryopcional

Itens por página, de 1 a 100.

Respostas

200A lista.
objectstringopcional
dataobject[]opcional
idstringopcional
Formato uuid
objectstringopcional
livemodebooleanopcional
statusstringopcional
Um de queued, sending, unknown, authorized, rejected, cancelled, substituted, pending_approval, blocked_plan, draft, imported
amountstringopcional
competencestringopcional
descriptionstringopcional
customer_idstring | nullopcional
Formato uuid
template_idstring | nullopcional
Formato uuid
nfse_numberstring | nullopcional
access_keystring | nullopcional

A chave de acesso de 50 dígitos.

dpsobject | nullopcional
seriesstringopcional
numberintegeropcional
pdf_readybooleanopcional
errorsobject[]opcional

Os erros do Sefin, numa nota rejeitada.

codestringopcional
messagestringopcional
sefin_codestringopcional
issued_atstring | nullopcional
Formato date-time
cancelled_atstring | nullopcional
Formato date-time
replaces_invoice_idstring | nullopcional

A nota que esta substitui.

Formato uuid
substituted_atstring | nullopcional
Formato date-time
public_urlstring | nullopcional

O link público da nota (PDF e XML, sem login), válido por 7 dias. Só em notas da API e de integrações.

Formato uri
public_url_expires_atstring | nullopcional
Formato date-time
created_atstringopcional
Formato date-time
pageintegeropcional
limitintegeropcional
totalintegeropcional

Quantos itens os filtros acham, em todas as páginas.

has_morebooleanopcional

Há uma próxima página.

401Chave ausente, errada, revogada ou vencida.
errorobjectopcional
codestringopcional

Estável, para o seu código decidir.

messagestringopcional

Para pessoas, em português.

fieldsobjectopcional

Nos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).