Settings
Open Settings → Plugins → Billingo. Fields are laid out under four tabs -- General, Credentials, Invoice, and Payment Mapping -- plus a details sidebar shown on every tab.
Sidebar (every tab)
| Field | Description |
|---|---|
| Enable | Turns the plugin's invoicing behavior on. |
| Send email | Emails the invoice once it's issued. |
| Send via Billingo | Also triggers Billingo's own send action when creating the invoice, so drafts don't need to be sent manually every time. |
| Electronic invoice | Marks generated invoices as electronic. |
General
| Field | Description |
|---|---|
| Unit | The unit label (e.g. db) used on invoice line items. Default: db. |
| Note | Free-text note added to generated invoices. |
Credentials
| Field | Description |
|---|---|
| API Key | The Billingo API key. Required. Site-overridable. |
| Invoice block ID | The Billingo invoice block the invoice numbers are drawn from. Site-overridable. |
Invoice
| Field | Description |
|---|---|
| Trigger | When an invoice is generated: Order (created together with the order) or Status (created once the order reaches a status selected below). Required. |
| Trigger status | Multi-select of order statuses. Only used, and only required, when Trigger is set to Status. |
| Invoice type | The Billingo invoice type: draft, proforma, or invoice. |
| Invoice language | The invoice language, or Számlázási cím alapján (based on the billing address's country -- falls back to English if that country has no matching language). Site-overridable. |
| Add SKU | Adds the product SKU to the product's comment field on Billingo. |
| Tax override | If set, replaces every invoice item's tax rate with the selected value. |
| Entitlement for tax override | Required when Tax override needs a NAV-mandated entitlement code (e.g. an exemption reason) attached to it. |
| Tax override if 0% | If set, replaces the tax rate only for items that would otherwise be 0%. |
| Entitlement for 0% tax override | Required when Tax override if 0% needs an entitlement code attached. |
| Tax override EU/EUK | Overrides tax with EU (if the billing country is an EU member state) or EUK (otherwise). Independent of the override fields above. |
| Tax override for shipping | Also applies the EU/EUK override (above) to the shipping line item, not just product items. |
Payment Mapping
| Field | Description |
|---|---|
| Payment Mapping | An editable table mapping each store payment method to a Billingo payment method and a payment deadline (in days). Rows can be added, reordered, and deleted. |
Where this is used
- API Key and Invoice block ID (resolved per site) are used for every Billingo API call the invoice provider makes.
- Trigger / Trigger status control when
Yui\Billingo\providers\BillingoInvoiceProvideris invoked through yStore's shared invoicing system. - Invoice type, Invoice language, Add SKU, and the tax override fields shape what's sent to Billingo for each invoice item.
- Payment Mapping determines which Billingo payment method and deadline is recorded for each store payment method used on an order.
- Invoice creation outcomes (success, failure, or the invoicing service being unreachable) are reported as
invoice.created,invoice.failed, andinvoice.errornotifications throughyui/craft-core's shared notification system, visible wherever the store surfaces plugin notifications. - See the Billingo overview for how these settings fit into the invoice provider and license page.