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
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.frequencyisweekly,biweekly,monthlyorquarterly. AddendDateto stop after a date.- Each invoice is issued at 09:00 UTC on its day and is due
dueDayslater. - 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, itsnextIssueAt, andlastErrorif the latest issue failed.POST /v1/invoice-series/{id}/cancelstops it. Invoices already issued are unaffected.