Point of Sale
Handel detaliczny i gastronomia
Do czego służy
Model a shop till: configuration, cash-controlled sessions, orders with lines and payment lines per method. It records what happened at the till; it is not a payment terminal integration, and card numbers must never be stored.
Co pakiet robi, a czego nie robi
Shop tills: a point-of-sale configuration, cash-controlled sessions that are opened and closed, orders with lines, and payment lines per method. A refund and the closing of a session need a human approval from a manager; agents may only propose them. Line subtotals and the order total are computed from the lines, receipts get a gapless yearly number, and paying is refused until the payments cover the total; change and cash differences are still entered. Paying also creates a draft stock move per line from the order's stock location, for the warehouse to validate. Card numbers must never be stored; keep only the payment provider's reference. Needs the Products package.
Szczegóły modułu
- Wersja:
0.3.0 - Autor: SpaceCorps
- Licencja: AGPL-3.0-or-later
- Wymaga rdzenia:
^0.2(aktualny rdzeń to 0.2.0) - Dojrzałość: Eksperymentalny
- Kategorie: Sprzedaż
Modele
pos_config
A point of sale (a till or a shop) and its rules
Grupa odczytu: pos.user. Grupa zapisu: pos.manager.
| Pole | Rodzaj | Klasa danych | Dane osobowe | Grupa | Agenci widzą | Opis |
|---|---|---|---|---|---|---|
name | text | none | nie | pos.user | jawnie | Name of the till or shop, for example Main street shop |
currency | text | none | nie | pos.user | jawnie | ISO 4217 currency code, for example EUR |
receipt_header | longtext | none | nie | pos.user | jawnie | Text printed at the top of receipts |
cash_control | bool | none | nie | pos.user | jawnie | Whether sessions must count the cash in the drawer when they open and close |
default_opening_cash | money | none | nie | pos.user | jawnie | Cash normally left in the drawer overnight (minor currency units) |
allow_refunds | bool | none | nie | pos.user | jawnie | Whether cashiers may propose refunds at this point of sale |
active | bool | none | nie | pos.user | jawnie | Whether the point of sale is in use |
pos_session
One shift of selling at a point of sale, from opening to closing the cash drawer
Grupa odczytu: pos.user. Grupa zapisu: pos.user.
| Pole | Rodzaj | Klasa danych | Dane osobowe | Grupa | Agenci widzą | Opis |
|---|---|---|---|---|---|---|
config_id | ref → pos_config | none | nie | pos.user | jawnie | The point of sale the session belongs to |
cashier | text | internal | tak | pos.user | zamaskowane | Name of the cashier who opened the session |
opened_on | date | none | nie | pos.user | jawnie | Day the session was opened (YYYY-MM-DD) |
closed_on | date | none | nie | pos.user | jawnie | Day the session was closed (YYYY-MM-DD) |
opening_cash | money | financial | nie | pos.user | wstrzymane | Cash counted in the drawer at opening (minor currency units) |
expected_cash | money | financial | nie | pos.user | wstrzymane | Cash the drawer should hold at closing: opening cash plus cash payments (entered, not computed) |
closing_cash | money | financial | nie | pos.user | wstrzymane | Cash actually counted in the drawer at closing |
cash_difference | money | financial | nie | pos.user | wstrzymane | Closing cash minus expected cash; negative means money is missing |
note | longtext | none | nie | pos.user | jawnie | Explanation for any cash difference |
state | select (open, closed) | none | nie | pos.user | jawnie | Session status: open, closed |
pos_order
A sale rung up at a point of sale
Grupa odczytu: pos.user. Grupa zapisu: pos.user.
| Pole | Rodzaj | Klasa danych | Dane osobowe | Grupa | Agenci widzą | Opis |
|---|---|---|---|---|---|---|
session_id | ref → pos_session | none | nie | pos.user | jawnie | The session the sale was made in |
receipt_number | sequence | none | nie | pos.user | jawnie | Number printed on the receipt, such as R-2026-000042: a gapless series that starts again each year, assigned when the sale is created |
stock_location_id | ref → inventory_location | none | nie | pos.user | jawnie | Where the goods leave stock; paying creates the stock moves from this location |
ordered_on | date | none | nie | pos.user | jawnie | Day of the sale (YYYY-MM-DD) |
customer_id | ref → party | none | nie | pos.user | jawnie | The customer, when one was identified |
tax_total | money | none | nie | pos.user | jawnie | Tax included in the total (minor currency units) |
total | money | none | nie | pos.user | jawnie | Total paid by the customer including tax: the sum of the line subtotals (minor currency units) |
note | longtext | none | nie | pos.user | jawnie | Remark about the sale |
state | select (draft, paid, refunded, cancelled) | none | nie | pos.user | jawnie | Sale status: draft, paid, refunded, cancelled |
pos_order_line
One product line of a sale
Grupa odczytu: pos.user. Grupa zapisu: pos.user.
| Pole | Rodzaj | Klasa danych | Dane osobowe | Grupa | Agenci widzą | Opis |
|---|---|---|---|---|---|---|
order_id | ref → pos_order | none | nie | pos.user | jawnie | The sale the line belongs to |
product_id | ref → product | none | nie | pos.user | jawnie | The product sold |
description | text | none | nie | pos.user | jawnie | Text shown on the receipt |
quantity | number | none | nie | pos.user | jawnie | Units sold |
unit_price | money | none | nie | pos.user | jawnie | Price per unit including tax (minor currency units) |
discount_bp | number | none | nie | pos.user | jawnie | Discount in basis points: 1000 means 10.00 percent |
subtotal | money | none | nie | pos.user | jawnie | Line total after discount: quantity times unit price, less the discount (minor currency units) |
pos_payment
A payment received against a sale; a sale may be paid with several methods
Grupa odczytu: pos.user. Grupa zapisu: pos.user.
| Pole | Rodzaj | Klasa danych | Dane osobowe | Grupa | Agenci widzą | Opis |
|---|---|---|---|---|---|---|
order_id | ref → pos_order | none | nie | pos.user | jawnie | The sale the payment is for |
method | select (cash, card, bank_transfer, voucher, other) | none | nie | pos.user | jawnie | How the customer paid: cash, card, bank_transfer, voucher, other |
amount | money | financial | nie | pos.user | wstrzymane | Amount paid with this method (minor currency units) |
paid_on | date | none | nie | pos.user | jawnie | Day of the payment (YYYY-MM-DD) |
provider_reference | text | financial | tak | pos.user | wstrzymane | Reference from the card terminal or payment provider; never a card number |
Przepływy pracy
pos_session
| Akcja | Przenosi | Kto może uruchomić | Zatwierdzenie |
|---|---|---|---|
pos_session.close | state: open → closed | pos.manager | tak |
pos_order
| Akcja | Przenosi | Kto może uruchomić | Zatwierdzenie |
|---|---|---|---|
pos_order.pay | state: draft → paid | pos.user | nie |
pos_order.cancel | state: draft → cancelled | pos.user | nie |
pos_order.refund | state: paid → refunded | pos.manager | tak |
Grupy uprawnień
Grupy używane przez tę aplikację:
pos.managerpos.user
Kroki zatwierdzania
Kroki, które agent może tylko zaproponować:
pos_session.closepos_order.refund
Co agenci mogą, a czego nie mogą
Agent może odczytywać, wyszukiwać, tworzyć i aktualizować rekordy tej aplikacji oraz uruchamiać akcje niewymagające zatwierdzenia, w ramach grup uprawnień swojego tokenu.
Te kroki może tylko zaproponować, a człowiek musi je zatwierdzić: pos_session.close, pos_order.refund, pos_config.delete, pos_session.delete, pos_order.delete, pos_order_line.delete, pos_payment.delete.
Dane osobowe są maskowane jako tokeny zastępcze: pos_session.cashier.
Te pola są całkowicie wstrzymane i niedostępne dla agentów: pos_session.opening_cash, pos_session.expected_cash, pos_session.closing_cash, pos_session.cash_difference, pos_payment.amount, pos_payment.provider_reference.
Zależności
Każda zależność podaje akceptowane wersje. Aplikacje wbudowane są wersjonowane razem z rdzeniem, więc wymaganie wobec nich sprawdza się względem wersji rdzenia.
Instalacja tej aplikacji z marketplace instaluje też brakujące zależności, w jednym planie potwierdzanym raz.
Instalacja
Zainstaluj ją w aplikacji Customize (Marketplace) lub z wiersza poleceń:
obop modules install-from posWymaga bazy danych i uprawnień administratora.
Zbuduj własną
Przewodnik po modułach pokazuje, jak pisze się takie aplikacje