> For the complete documentation index, see [llms.txt](https://sbscripts.gitbook.io/sb-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sbscripts.gitbook.io/sb-scripts/sb-jobs/receipts.md).

# Receipts

Every paid order gives the customer a receipt item. Using it opens a receipt showing the order. The item has to exist in your inventory before the resource starts, or nobody will receive one.

The item name must match `Config.Receipt.itemName`, which is `sbjobs_receipt` by default.

### What a receipt stores

| Key           | Example                      | Type   |
| ------------- | ---------------------------- | ------ |
| `business`    | `Burger Shot`                | string |
| `cashier`     | `John Smith`                 | string |
| `date`        | `01/06/2025 14:32`           | string |
| `method`      | `cash` or `card`             | string |
| `discountPct` | `10` (`0` means no discount) | string |
| `items`       | JSON list of order lines     | string |

Each line in `items` holds the item name, quantity, unit price and line total.

### qb-inventory

Add to `qb-core/shared/items.lua`:

```lua
sbjobs_receipt = {
    name        = 'sbjobs_receipt',
    label       = 'Receipt',
    weight      = 0,
    type        = 'item',
    image       = 'sbjobs_receipt.png',
    unique      = false,
    useable     = true,
    shouldClose = true,
    description = 'A purchase receipt.',
},
```

### ox\_inventory

Add to `ox_inventory/data/items.lua`:

```lua
["sbjobs_receipt"] = {
    label = "Receipt",
    weight = 0,
    stack = true,
    close = true,
    description = "A purchase receipt.",
    client = {
        image = "sbjobs_receipt.png",
    }
},
```

The image file name must match the file in your inventory images folder. Older setups used `reciept.png` with that spelling. If that's the file you have, use that name instead.

### Turning receipts off

Set `enabled = false` in `Config.Receipt`. Purchases work the same, but customers don't get an item.
