New webhook event: invoice.schedule_failed
invoice.schedule_failed tells you a scheduled invoice could not be issued, so you find out without opening the dashboard.
Scheduled invoices are set from the API, with PUT /v1/companies/{company_id}/invoices/{invoice_id}/schedule, so the warning that one failed had to reach the API too: if you integrate, you may never open the dashboard where the notice appears.
Subscribe to invoice.schedule_failed and you get the failure when it happens, with the reason.
What else changed
- It fires in Test as well as Live. You should be able to see in sandbox the failure mode that awaits you in production.
- On a managed account it also reaches the managing party, like the recurring-invoice pause event: whoever can unblock that NIF is the one who needs to know.
Endpoints
- PUT/v1/companies/{company_id}/invoices/{invoice_id}/scheduleSchedules the invoice whose failure this event reports
Where to go next
The street number is no longer required in an address
`address.number` is now optional: omit it when the address has none, or when `street` already carries it.
A fully discounted line no longer kills the invoice
A line discounted to zero used to reject the whole invoice. Zero is now judged on the invoice total, with `INVOICE_ZERO_AMOUNT`.