Caja (POS)
Base path: /api/pos
GET /pos
Get all POS orders.
Auth: Logged in
Query parameters:
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number |
limit | integer | Items per page |
POST /pos
Create a new POS order.
Auth: Logged in
Request body:
| Field | Type | Required | Description |
|---|---|---|---|
client_id | integer | Yes | Client ID (required for checkout) |
staff_id | integer | Yes | Staff member ID |
items | array | Yes | Array of order items |
payment_method | string | Yes | cash, card, online |
discount_code | string | No | Discount code |
gift_card_code | string | No | Gift card code |
loyalty_points | integer | No | Loyalty points to redeem |
notes | string | No | Order notes |
Order Item
{
"type": "service",
"id": 3,
"quantity": 1,
"price": 25.00
}
Type can be service, product or package.
GET /pos/:id
Get a single POS order with items.
GET /pos/favorites
Get favourite POS items for the logged-in staff member.
PUT /pos/favorites
Update favourites.
Request body: Array of favourite items with position.
Payment Methods
| Method | Description |
|---|---|
cash | Cash |
card | PIN/card (via SumUp) |
online | Online payment (via Mollie/Stripe) |
Selling Gift Cards
Gift cards can be sold via the POS. The card is automatically created with the specified amount and can be sent by email.