Documentation
Register the two items that make the paperwork physical — the paper invoice and the payment receipt — in ox_inventory, qs-inventory, qs-advanced-inventory or qb-inventory.
Quasar Billing uses two items to make the paperwork physical. They are not decoration — they are how an invoice exists in the world instead of only in a menu.
Item | When it is given | What using it does |
|---|---|---|
| The moment somebody is billed. | Renders a real paper invoice over the game — torn edges, rubber stamps, live data. A PAID stamp appears once it is settled. |
|
To whoever paid, on settlement. |
Renders a thermal till receipt with the amount, the method and the fee. |
Both papers carry an open in billing button, and that button is the only way the app opens from an item. Taking a piece of paper out of your pocket should not be the same gesture as opening an app.
Both items must be unique and metadata-capable. A stackable invoice cannot carry its own reference, amount and issuer — the paper would have nothing to render.
Add both entries to the inventory you run. The item names are fixed — billing looks for them by name.
ox_inventory — ox_inventory/data/items.lua. The server.export on each item is what hands the rendering back to billing:
['qs_invoice'] = {
label = 'Invoice',
weight = 0,
stack = false,
close = true,
server = { export = 'qs-billing.useInvoice' },
},
['qs_receipt'] = {
label = 'Invoice receipt',
weight = 0,
stack = false,
close = true,
server = { export = 'qs-billing.useReceipt' },
},qs-inventory — qs-inventory/shared/items.lua. The bridge registers the usable hooks itself, so only the shared entries are needed, plus the two images in qs-inventory/html/images.
['qs_invoice'] = { name = 'qs_invoice', label = 'Invoice', weight = 0,
type = 'item', image = 'qs_invoice.png',
unique = true, useable = true, shouldClose = true,
description = 'An invoice waiting to be paid' },
['qs_receipt'] = { name = 'qs_receipt', label = 'Invoice receipt', weight = 0,
type = 'item', image = 'qs_receipt.png',
unique = true, useable = true, shouldClose = true,
description = 'Proof of payment' },qs-advanced-inventory — the same export surface as qs-inventory, so the entries are identical. Add both to its shared items file, plus the two images.
['qs_invoice'] = { name = 'qs_invoice', label = 'Invoice', weight = 0,
type = 'item', image = 'qs_invoice.png',
unique = true, useable = true, shouldClose = true,
description = 'An invoice waiting to be paid' },
['qs_receipt'] = { name = 'qs_receipt', label = 'Invoice receipt', weight = 0,
type = 'item', image = 'qs_receipt.png',
unique = true, useable = true, shouldClose = true,
description = 'Proof of payment' },qb-inventory — qb-core/shared/items.lua. The bridge registers both useable hooks itself; only the shared entries are needed, plus qs_invoice.png and qs_receipt.png in your inventory images.
qs_invoice = { name = 'qs_invoice', label = 'Invoice', weight = 0,
type = 'item', image = 'qs_invoice.png',
unique = true, useable = true, shouldClose = true,
description = 'An invoice waiting to be paid' },
qs_receipt = { name = 'qs_receipt', label = 'Invoice receipt', weight = 0,
type = 'item', image = 'qs_receipt.png',
unique = true, useable = true, shouldClose = true,
description = 'Proof of payment' },Nothing breaks. Invoices are still issued, still paid and still collected — the paperwork simply is not materialised, and players work from the app alone.
The resource will not let you discover that by accident, though. It prints a console warning at boot and shows a red card in the Admin panel, both naming exactly which item is missing from which inventory.
If you do not want physical paperwork at all, turn it off properly in Admin → Features → Paper items rather than leaving the items unregistered. The warning then stops, because you have made a decision instead of having an oversight.
A player who is not carrying their invoice can still pay at a terminal by identifying themselves — the machine looks their invoices up on the billing network instead of reading a document.
If you want that convenience to cost something, there is an optional network lookup fee for exactly this case, off by default. It gives the paper item a reason to exist beyond flavour: bringing your paperwork is the cheap option. See Usage.