Troubleshooting

This guide provides solutions to common issues you might encounter while installing or using the Billing System.

General Issues

The Tablet Won't Open (F7 Key)

Possibilities:

1. Wrong Job: Check if your job is listed in Config.AllowedJobs in config.lua.

2. Keybind Conflict: Another resource might be using the same key. Try changing Config.Keybind.

3. Resource Not Started: Ensure src-billing is started in your server.cfg.

4. Console Errors: Open the F8 console to check for any client-side JavaScript or Lua errors.

Solution:

• Type /ensure src-billing in the console to restart the resource.

• Check the F8 console for error messages.

• Ensure you have a job that is allowed to open the tablet.

---

Technical Issues

Framework Not Detected

By default, the bridge uses Config.Framework = 'auto'. Occasionally, detection might fail if your framework resource is named differently.

Check:

• Is your framework (QBox, QBCore, or ESX) started before src-billing?

• Are you using a highly modified or renamed version of a framework?

Solution:

• Manually set the framework in config.lua:

  Config.Framework = 'qbox' -- or 'qb', 'esx'

Database Errors

If you see errors related to MySQL or missing tables in your server console.

Check:

• Did you import sql/billing.sql?

• Are the table names exactly as expected?

Solution:

• Re-import the SQL file.

• Ensure your database connection string in server.cfg is correct.

---

Payment Issues

Money Not Being Removed

If a player pays an invoice but no money is taken from their account.

Check:

• Check the server console for errors when the payment is made.

• If using a Custom Framework, verify your Bridge.RemoveMoney implementation in bridge/server.lua.

Solution:

• Ensure the Bridge.RemoveMoney function returns true on success and false on failure.

Physical Receipt Not Given

Check:

• Is ox_inventory started?

• Is Config.ReceiptSettings.Enabled = true?

• Do you have the receipt item added to your inventory's items list?

---

UI Issues

Black Screen or Layout Glitches

If the tablet UI appears broken or shows a black screen.

Possibilities:

1. NUI Focus: Something might be blocking the NUI focus.

2. Build Error: If you modified the web code, the build might have failed.

Solution:

• Restart the resource: ensure src-billing.

• If you made changes to the web folder, run npm run build again.

• Clear your local browser cache (FiveM cache folder).

---

Getting More Help

If you're still having issues:

1. Check the Logs: Both server console and F8 client console contain vital clues.

2. Verify Dependencies: Ensure ox_lib and/or ox_inventory are up to date if you're using them.

3. Open an Issue: If you believe you've found a bug, please report it on the GitHub repository with detailed logs.