External billing mode: invoices from your own software
In external billing mode, the official invoices and credit notes come from your own invoicing software, while ioumi still handles the contract, signature and payment collection and sends exactly those invoices to your customer.
Normally, ioumi automatically creates the invoice for every payment and sends it to your customer. Sometimes, though, the official invoices need to come from another system, for example because you already use invoicing software that your bookkeeping works with, or because special invoicing requirements apply in your country, such as Verifactu in Spain. That is what external billing mode is for.
How it works
Section titled “How it works”- ioumi creates a draft invoice. For every payment, ioumi creates the invoice data as usual, but does not send an invoice of its own.
- A webhook reports the new invoice. The “Invoice created” event (
invoice.created) sends your automation all the data: customer, line items, amounts, tax rates and service period. Webhooks explains how to subscribe to the event. - Your invoicing software creates the official invoice. Your automation, for example in Make or n8n, creates the invoice there with an official number.
- The number and PDF go back to ioumi. The automation sends the invoice number and the PDF back via the API.
- ioumi sends the official invoice. Your customer receives the email with the PDF from your invoicing software. From then on, this invoice with its number also appears in the customer portal and in ioumi.
Credit notes, for example for a refund, work the same way.
What you need
Section titled “What you need”- Invoicing software with an interface that lets you create invoices and retrieve them as PDFs
- An automation, for example with Make or n8n, or your own custom code
- External billing mode activated by us
We activate external billing mode for you. Write to us at support@ioumi.com and we will discuss together whether it is right for you. We set up the mode and the permissions needed for reporting back together with you. The technical details are in the API documentation under Settings › Integrations › API Documentation.
What changes and what stays the same
Section titled “What changes and what stays the same”- Payments work as before. Collection, payment plan, reminders and payouts work exactly as they do without external billing mode.
- Accounting export: Invoices from your invoicing software appear in the accounting export as soon as their official number and PDF have reached ioumi.
- Once sent, it stays sent. If your automation sends the data for an invoice again, ioumi does not send the email to your customer a second time.