Invoices - Repass

repass.invoices gerencia as notas fiscais do fluxo fiscal, com envio do arquivo (PDF/XML), validação ou rejeição e download por URL pré-assinada.

Envio

submit envia um upload multipart (PDF/XML) junto dos campos declarados e não é re-tentado automaticamente; em caso de falha, reenvie de forma controlada. O arquivo pode ser um Blob/File ou um descritor { data, filename?, contentType? }, onde data é um Blob, Uint8Array ou ArrayBuffer.

await repass.invoices.submit("inv_…", fileBlob, {
  nfNumber: "12345",
  issuerCnpj: "12.345.678/0001-90",
  declaredAmountCents: 25000, // R$ 250,00
  recipientName: "Repass Tecnologia LTDA",
}); // → Invoice

Consulta

// Listar (RepassPage; filtros por status e por competência)
await repass.invoices.list({ status: "validated" }); // → RepassPage<Invoice>

// Recorte por competência (mês): criadas em [created_after, created_before)
await repass.invoices.list({
  created_after: "2026-06-01T00:00:00.000Z",
  created_before: "2026-07-01T00:00:00.000Z",
}); // → RepassPage<Invoice>

// Buscar uma nota
await repass.invoices.retrieve("inv_…"); // → Invoice

Validação, rejeição e cobrança

remind cobra novamente a NF pendente (lembrete ao afiliado); só vale enquanto a nota está pending.

await repass.invoices.validate("inv_…");                  // → Invoice (aprova a nota)
await repass.invoices.reject("inv_…", { reason: "valor diverge" }); // → Invoice (rejeita com motivo)
await repass.invoices.remind("inv_…");                    // → Invoice (cobra novamente a NF pendente)

Download

file retorna uma URL pré-assinada (com expiração) para baixar o arquivo enviado.

await repass.invoices.file("inv_…"); // → InvoiceFile ({ url, expiresAt })

Para o schema completo de cada corpo (campos declarados, tipos de arquivo aceitos e status) e os campos de cada objeto retornado, consulte a Referência da API. As regras de negócio estão em Fiscal.