Skip to main content
Finora Business
Finora Business
Sign InStart Free Trial

Reference

Document Generation

Generate PDF and Excel documents for invoices, receipts, quotations, VAT returns, WHT certificates, and payslips.

The documents module produces file exports from your accounting data — stamped with your business details, ready to email or download. Every endpoint returns a signed URL that's valid for 1 hour.

Invoice PDF

POST/v1/documents/invoice/{invoiceId}/pdf

Generates an invoice PDF with your logo, business address, and line items.

Query parameters

FieldTypeRequired
businessIdstringyes

Response — 200

{
  "success": true,
  "data": {
    "documentType": "invoice",
    "fileName": "INV-2026-001.pdf",
    "url": "https://storage.googleapis.com/...",
    "expiresAt": "2026-04-17T11:30:00.000Z"
  }
}

Receipt PDF

POST/v1/documents/receipt/{receiptId}/pdf

Receipt PDF with payment breakdown and invoice allocation.

Quotation PDF

POST/v1/documents/quotation/{quotationId}/pdf

Quotation PDF with validity date and terms.

Financial Statement PDF

POST/v1/documents/financial-statement/pdf

Combined P&L, Balance Sheet, and Cash Flow for a period.

Body

FieldTypeRequiredNotes
startDateISO 8601yes
endDateISO 8601yes
includeCashFlowbooleannoDefaults to true.

VAT Return

POST/v1/documents/vat-return/pdf

FIRS-ready VAT return for a filing period.

POST/v1/documents/vat-return/excel

Same data in an Excel workbook, suitable for FIRS e-filing.

Body

FieldTypeRequiredNotes
startDateISO 8601yesPeriod start (usually 1st of month).
endDateISO 8601yesPeriod end (last day of month).

WHT Certificate PDF

POST/v1/documents/wht-certificate/{certificateId}/pdf

Withholding tax certificate for a supplier, issued from a WHT deduction.

Payslip PDF

POST/v1/documents/payslip/{payslipId}/pdf

Employee payslip with earnings, deductions, and net pay.

Rate-limit considerations

Each document generation is one API call. For bulk exports (e.g. emailing payslips to 50 employees), expect 50 calls against your rate limit. Batch them with a small delay to stay within the per-minute window.

Related endpoints

Reference index

Back to all modules