eInvoices exporter

Overview

eInvoices Exporter module is responsible for scheduling and delivering HostBill-generated invoices using configured Transport module to target (country-specific) eInvoice system. eInvoices exporter makes use of designated Cron task (Settings → Task list) to periodically (every 5 minutes) schedule and deliver invoices, retry previous failed deliveries, alert staff members about failed deliveries.

Currently available transport modules:

Activating the module

1. The plugin is free and available to all HostBill users. Actual transport module that is being used by eInvoices exporter may require additional order if its not part of your license

2. Go to Settings → Modules, find and activate eInvoices exporter

3. Once the plugin is activated you will be directed to Settings→ Modules→ Plugins to configure the plugin.

Module configuration

Fill in the configuration fields:

1. Module display name

2. Transport module - select from previously activated eInvoice transport module. Without active transport module einvoice export would not work

3. Max Export Attempts - How many attempts for single invoice delivery should be made before marking it as failed.

4. Max exports per run - Number of per-cron run export attempts. If set to 0, no limit will be applied. Useful when target system have rate limits

5. Do not lock invoice - When enabled invoice will not be locked until e-invoice is delivered. In many cases e-invoice should be delivered before local pdf generation/sending to end-customer

6. Final invoices only - Once enabled only invoices with final/paid id will be sent to target system. EU billing mode needs to be enabled in general HostBill settings to issue final invoices

7. Block next invoices processing on failure - Once enabled and single invoice export fails, stop next invoices export until issue is resolved manually. Useful for delivery targets where sequences are crucial

8. Notify staff members about delivery failure - When enabled, Notify staff members via email with "Misc - New transaction" notifications permissions about failed delivery

9. Disable autoexport - Use for testing purposes only. When enabled invoice will not be automatically exported to target system, allowing staff member to trigger export manually

10. Disable autoexport issued before - Invoices older than this date will not be exported automatically. Leave empty to disable this feature. Use YYYY-MM-DD format. Useful for situations where einvoicing is mandatory since certain date
    
    
    

    Open

    

Using eInvoice Exporter module

Transport module defined in module configuration determines if given invoice is suitable to auto-export (ie if customer is from supported country) in admin UI of invoice details staff will see eInvoice action buttons, allowing to track progress of particular invoice export.

Open

Depending on e-invoice delivery status, staff member can:

• Cancel delivery

• Retry failed delivery

• Mark delivery as processed

• Set einvoice id (if invoice was exported externally)

Additionally, by clicking on sign, staff member can check the last attempt request and response reported by a transport module:

Open

Module adds its own listing UI under Payments → eInvoices exporter to bulk manage invoice exports

Open

Disabling email invoice delivery

Optionally, you can define per-client (and let client change this) how eInvoice should be delivered. If customer is determined by Transport module as suitable for e-invoice delivery, client/staff can enable e-invoice as delivery method in Client Automation Settings → Invoice Delivery Method.

Setting delivery method as e-invoice will block sending new invoice emails for given client.

Open

Admin Dashboard Widget

Module adds its own Admin Dashboard Widget: Failed eInvoice Deliveries, allowing staff member to quickly list all invoices that failed to export for some reason on dashboard after login.

Open