> For the complete documentation index, see [llms.txt](https://zloma-scripts.gitbook.io/zloma-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zloma-scripts.gitbook.io/zloma-scripts/zloma_vehicleshop-paid/api-reference/callbacks.md).

# Callbacks

The resource uses `lib.callback.register` for server/client communication.

***

## Core Shop Callbacks

| Callback                               | Description                                                 |
| -------------------------------------- | ----------------------------------------------------------- |
| `zloma_vehicleshop:getAllShops`        | Returns dealership list filtered for the current player     |
| `zloma_vehicleshop:getShopData`        | Returns categories and vehicles for a specific salon        |
| `zloma_vehicleshop:getShopInfo`        | Returns basic salon information                             |
| `zloma_vehicleshop:purchaseVehicle`    | Validates and completes a normal purchase                   |
| `zloma_vehicleshop:getTradeInVehicles` | Returns eligible owned vehicles for trade-in                |
| `zloma_vehicleshop:executeTradeIn`     | Runs the trade-in purchase flow                             |
| `zloma_vehicleshop:startTestDrive`     | Starts a timed test drive                                   |
| `zloma_vehicleshop:endTestDrive`       | Ends an active test drive                                   |
| `zloma_vehicleshop:hasActiveTestDrive` | Returns whether the player already has a running test drive |
| `zloma_vehicleshop:getTuningCache`     | Loads cached preview tuning data                            |
| `zloma_vehicleshop:setTuningCache`     | Stores cached preview tuning data                           |

***

## Admin Callbacks

| Callback                                        | Description                                   |
| ----------------------------------------------- | --------------------------------------------- |
| `zloma_vehicleshop:adminGetAllShops`            | Returns all salons for the admin panel        |
| `zloma_vehicleshop:adminGetShopById`            | Returns one salon with detailed configuration |
| `zloma_vehicleshop:adminCreateSalon`            | Creates a new salon                           |
| `zloma_vehicleshop:adminUpdateSalon`            | Updates salon data                            |
| `zloma_vehicleshop:adminDeleteSalon`            | Deletes a salon                               |
| `zloma_vehicleshop:adminAddVehicle`             | Adds a vehicle to a salon                     |
| `zloma_vehicleshop:adminUpdateVehicle`          | Updates vehicle data                          |
| `zloma_vehicleshop:adminRemoveVehicle`          | Removes a vehicle                             |
| `zloma_vehicleshop:adminCreateCategory`         | Creates a category                            |
| `zloma_vehicleshop:adminUpdateCategory`         | Updates a category                            |
| `zloma_vehicleshop:adminDeleteCategory`         | Deletes a category                            |
| `zloma_vehicleshop:adminUpdateBusinessSettings` | Updates business-mode settings for a salon    |

***

## Business Callbacks

| Callback                                     | Description                                           |
| -------------------------------------------- | ----------------------------------------------------- |
| `zloma_vehicleshop:bossCheckAccess`          | Validates whether a player can use the business menu  |
| `zloma_vehicleshop:bossGetData`              | Loads business dashboard data                         |
| `zloma_vehicleshop:bossSetShopOpen`          | Opens or closes the dealership                        |
| `zloma_vehicleshop:bossSetShowroom`          | Controls which vehicles are visible in showroom stock |
| `zloma_vehicleshop:bossSetPrice`             | Sets active sale price                                |
| `zloma_vehicleshop:bossSetDiscount`          | Sets discount percentage                              |
| `zloma_vehicleshop:bossGetEmployees`         | Returns employee list                                 |
| `zloma_vehicleshop:bossHireEmployee`         | Hires by identifier                                   |
| `zloma_vehicleshop:bossHireByServerId`       | Hires an online player by server ID                   |
| `zloma_vehicleshop:bossGetEmployedServerIds` | Returns online employee IDs                           |
| `zloma_vehicleshop:bossFireEmployee`         | Removes an employee                                   |
| `zloma_vehicleshop:bossSetEmployeeGrade`     | Changes employee grade                                |
| `zloma_vehicleshop:bossGetTransactions`      | Returns dealership transactions                       |
| `zloma_vehicleshop:bossGetStatistics`        | Returns statistics/dashboard metrics                  |
| `zloma_vehicleshop:bossWithdraw`             | Withdraws from shop balance                           |
| `zloma_vehicleshop:bossDeposit`              | Deposits into shop balance                            |
| `zloma_vehicleshop:bossPaySalary`            | Pays salary to an employee                            |
| `zloma_vehicleshop:bossPayBonus`             | Pays a bonus                                          |
| `zloma_vehicleshop:bossPlaceOrder`           | Places a procurement order                            |
| `zloma_vehicleshop:bossAcceptOrder`          | Accepts an order for delivery                         |
| `zloma_vehicleshop:customerPlaceOrder`       | Places a customer order                               |
| `zloma_vehicleshop:deliveryConfirm`          | Confirms delivery completion                          |
| `zloma_vehicleshop:deliveryCancelOrder`      | Cancels an order                                      |

***

## Important NUI Callbacks

### Customer UI

* `selectVehicle`
* `changeColor`
* `selectCategory`
* `navigateVehicle`
* `getVehicleInfo`
* `close`
* `notify`
* `camRotate`

### Admin UI

* `adminGetShops`
* `adminTeleportToShop`
* `startLocationPicker`
* `startSpawnEditor`
* `startPedPropEditor`
* `hideUiForCoords`
* `adminEditSalon`
* `adminAddVehicle`
* `adminUpdateVehicle`
* `adminRemoveVehicle`
* `adminCreateCategory`
* `adminUpdateCategory`
* `adminDeleteCategory`

### Boss UI

* `bossGetData`
* `bossSetShopOpen`
* `bossSetShowroom`
* `bossSetPrice`
* `bossSetDiscount`
* `bossPlaceOrder`
* `bossAcceptOrder`
* `cancelDelivery`
* `bossGetEmployees`
* `bossHireEmployee`
* `bossFireEmployee`
* `bossSetEmployeeGrade`
* `bossGetTransactions`
* `bossGetStatistics`
* `bossWithdraw`
* `bossDeposit`
* `bossPaySalary`
* `bossPayBonus`
* `startDelivery`
* `bossHireByServerId`
* `bossGetNearbyPlayers`

### Delivery HUD

* `deliveryToggleBed`
* `deliveryCancelFromHUD`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://zloma-scripts.gitbook.io/zloma-scripts/zloma_vehicleshop-paid/api-reference/callbacks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.