Skip to main content
An invoice is a numbered document sent to one of your customers with a link to pay it by card. Talescria works out the totals, numbers it (INV-0001, INV-0002, …), emails it with a PDF, sends reminders, and emails a receipt when it’s paid. Scopes: invoices:write to issue, send and void; invoices:read to read. Both cover recurring series too. Before your first invoice, complete your business details in the dashboard: they’re printed on every invoice (409 PROFILE_INCOMPLETE otherwise).

Issue an invoice

You send lines; Talescria computes the figures. Each line is quantity × unitPrice, the subtotal is their sum, tax is the subtotal × rateBasisPoints / 10,000 rounded half up, and the total is subtotal + tax. In the example: £2,500.00 + £180.00 = £2,680.00 subtotal, £536.00 VAT, £3,216.00 total. The response includes url, the page where the customer views and pays the invoice (https://pay.talescria.com/i/…), and emailed. If the email couldn’t be sent, the invoice still exists: resend it with POST /v1/invoices/{id}/send.

Status

Reminders go out before and after the due date, and a receipt is emailed when the invoice is paid, if you’ve switched them on in your invoice settings.

Correcting an invoice

An issued invoice never changes: your customer’s records must match yours. To correct one, void it and issue a new one.

Recurring invoices

A series issues an invoice to the same customer on a schedule.
  • frequency is weekly, biweekly, monthly or quarterly. Add endDate to stop after a date.
  • Each invoice is issued at 09:00 UTC on its day and is due dueDays later.
  • Monthly and quarterly series keep the start date’s day of the month, moved earlier in shorter months: a series starting on the 31st issues on the 30th in November and the 28th in February.
  • A series starting today issues its first invoice immediately and returns it as invoice. If that first invoice fails, the series is cancelled and you get the error.
  • GET /v1/invoice-series/{id} shows the series, its nextIssueAt, and lastError if the latest issue failed.
  • POST /v1/invoice-series/{id}/cancel stops it. Invoices already issued are unaffected.