Installation

Install the Advanced Billing System — invoices, payments, taxes, late fees and reminders in one interface.

Requirements

• A FiveM server on a recent recommended artifact build.
• ox_lib, started before the billing resource.
• oxmysql with a working mysql_connection_string — invoices, payments and reminders are stored in the database.
• ESX, QBCore, Qbox or Standalone — detected automatically. On a framework the script uses its money and job systems; on standalone it uses its own accounts table.
• Optional: an inventory (ox_inventory, qb-inventory) if you want the portable billing device and receipts as usable items.

Asset download

After purchase the resource is granted to your Cfx.re account. Assign it to your server key in Keymaster and download the ZIP. Full walkthrough: Cfx.re asset escrow.

Installation

1. Extract the ZIP into your resources folder and keep the folder name unchanged.
2. Add the resource to server.cfg after oxmysql, ox_lib, your framework and your inventory:

# server.cfg
ensure oxmysql
ensure ox_lib
ensure es_extended        # or qb-core / qbx_core — skip on standalone
ensure ox_inventory       # optional, only for the item-based device
ensure <venom-billing-folder>

1. Restart the server. The database tables are created automatically on first boot — no manual SQL required. If your database user cannot CREATE tables, import install.sql from the resource folder instead.
2. Open the billing interface with the command or keybind from the config (default /billing) to confirm the UI loads.

Tip: Watch the first boot in the server console: the resource prints the detected framework and confirms the tables it created. Any red line there is the first thing to fix.

Items (optional)

To hand out the portable billing device and printed receipts as items, add them to your inventory. Example for ox_inventory (ox_inventory/data/items.lua):

['billing_device'] = {
    label = 'Billing Device',
    weight = 250,
    stack = false,
    close = true,
    description = 'Create and send invoices on the go',
},
['invoice_receipt'] = {
    label = 'Invoice Receipt',
    weight = 5,
    stack = true,
},

Note: Item names are examples — copy the exact names and the QBCore variant from the items/ folder shipped with the script, then restart your inventory before the billing resource.

Permissions

By default any player can create invoices for themselves; issuing invoices on behalf of a business is limited to the jobs you list in the config (see Config). Admin tools use an ACE permission:

# server.cfg
add_ace group.admin venombilling.admin allow

Verify the install

• Create a test invoice to yourself, pay it, and check that it moves from Pending to Paid on the dashboard.
• Confirm the money moved in your framework's accounts.
• Check resmon: the script idles at 0.00ms.

Next steps

Set taxes, late fees, reminders, layouts and themes on the Config page.