CMFX invoicing
Invoicing addon
WHMCS creates its own invoice for orders and renewals, which serves as a proforma invoice; the final invoice has to be issued in a separate invoicing system. If that is done by hand, the same details have to be typed in again after every payment. This addon connects WHMCS with the Hungarian Cashman FX invoicing system: when a proforma invoice is paid, it automatically issues the corresponding Cashman FX invoice.
The addon is built on WHMCS’s own events, and it also makes the issued invoices available inside WHMCS: customers see them in the client area, and administrators on the addon’s page. It is for providers using WHMCS who issue their invoices in Cashman FX.
How it works
Invoice on payment. When a WHMCS invoice is marked as paid, the addon puts together the Cashman FX invoice: alongside the customer’s name or company name, address, tax number and EU VAT number, it adds the line items of the proforma invoice. The invoice is in Hungarian for a Hungarian customer and in English otherwise, and its currency is the customer’s. The VAT rate is chosen based on the proforma’s tax rate; with a 0% rate, it marks the item as reverse charge for an EU customer and as outside the scope of VAT for a customer outside the EU. The payment method follows from the payment gateway (PayPal, card, Barion, otherwise bank transfer). The notes contain the proforma number, the transaction ID and the account credit used. Credit top-up items are not put on the invoice, and no invoice is created for a zero-amount proforma that wasn’t paid from credit.
The issued invoice’s number and download link are stored in the addon’s database, the customer receives the link by email, and the action is recorded in the activity log. If issuing the invoice fails, the administrator gets an email with the error and the invoice details, without the Cashman login credentials.
Monthly consolidated invoice. In the settings, you can designate a checkbox-type custom client field; customers who have it ticked don’t get an invoice for every payment. Their paid items are queued, and on the WHMCS cron run on the first day of the month (or on the next run if the one on the 1st is missed), one consolidated invoice is created per customer from them, which the addon sends by email. If a customer’s consolidated invoice can’t be created, the administrator is notified, and the addon doesn’t try again that month, so that an interrupted request can’t lead to a duplicate invoice.
Notifications. Customers on consolidated invoicing don’t receive WHMCS’s invoice created, payment reminder and payment confirmation emails.
Stored data. The addon uses two tables of its own: one holds the issued invoices (number, link, date, amount, the related proforma), and the other the items waiting for the consolidated invoice. In the WHMCS settings, it also records the month in which the monthly invoicing last ran. Deactivating the addon doesn’t delete the tables. The Cashman login credentials are kept only in the addon’s settings.
Main features
- Automatic Cashman FX invoice when a WHMCS invoice is paid.
- VAT rate, payment method, language and currency taken from the proforma and the customer’s details.
- Monthly consolidated invoice for customers marked with the client field chosen in the settings.
- Unneeded WHMCS notifications skipped for customers on consolidated invoicing.
- Invoice list with download links in the client area, visible to the account owner and to users with permission to view invoices.
- A paginated, sortable list for administrators, filterable by customer and issue date.
- Email notification to the administrator on errors.
- Developer mode, which sends the invoices to the Cashman FX test server.
- Only accepts invoice links pointing to the Cashman FX server; it doesn’t store or send out any other link.