Everything, step by step

1Install & first run

1. Run PosMasr-Setup.exe: Next, Next, Finish. It installs the program under Program Files, adds a desktop and Start-menu shortcut (and a kitchen-screen shortcut if you tick it), and opens it.
2. The program opens full screen. Your products, sales and settings live in C:\ProgramData\PosMasr\data, and no update or uninstall ever removes them.

3. Go to Settings → Products and set your prices.
4. Then Printer & receipt (pick the printer and paper width) and Tests → Test print.

2Login & accounts (cashiers)

On first run the program asks you to create the manager account (name + password) — it has every permission. After that, each start shows the login screen: pick the user, type the password, press Login.

• Manager: everything (sell, reports, inventory, credit, products, settings, exit).
• Cashier: selling only. The management buttons are hidden.
• Add a cashier: Settings → Users → Add user. Change passwords or disable accounts there too.
• Users button (3.2): the manager has a Users button in the top bar next to Products — it opens the Users tab straight away. And if the shop is still on the manager account alone after 3 days, a one-time reminder suggests adding cashier accounts.
• Switch cashier (top bar) opens the login screen to hand over the shift without closing the program.
• Every receipt records the cashier; reports can be filtered by cashier.

Manager cards & card login (3.1)

Instead of typing a password every few minutes, a manager can swipe a card — like the supervisor at a big coffee shop: the cashier wants to refund a receipt, the supervisor swipes their card on the reader and it goes through. Any account (manager or cashier) can also log in with its card instead of the password.

• Which reader: any USB card reader that types like a keyboard — a magnetic-stripe reader (MSR) or an RFID/NFC reader. It's sold as a “USB card reader” for roughly 300–900 EGP, and blank cards cost a few pounds each. Plug it in and that's it: no drivers, no settings.
• Register a card: Settings → Users → open the user → the Login card row → Swipe the card now, swipe the card on the reader (you have 20 seconds), then Save. One card belongs to one user only, and the program only ever shows its last 4 digits.
• Card login: on the login screen just swipe the card — you're in right away, no picking your name and no password.
• Approving with the card: when a cashier tries something outside their rights (void a receipt, a return, a discount over the limit, opening the drawer…) the manager sign-in screen appears: the manager swipes their card instead of typing the password. A cashier's card is not accepted there.
• Lost card? Settings → Users → the user → Clear the card, then register a new one. The password always keeps working alongside the card.

3Selling

• Categories on the side. Tap one to show only its products.
• Tap a product to add it to the receipt. Tap again to add one more.
• Select a line, then + / − change the quantity, Remove deletes it, Clear starts a new receipt.
• Open drawer, Reprint last, Void last receipt sit under the receipt.
• Search / barcode box above the products: type part of a name to filter, or scan a barcode to add the item directly. The box is always ready for the scanner.
• Products with tracked stock show the remaining quantity in brackets; sold-out ones look faded (or hidden, if you enable that in Settings).

Scan to add: a pack you do not have yet (4.1)

A customer brings a pack that is not in your products yet. If the ready catalogue knows its barcode, you do not have to leave the sales screen to add it.

• Scan it in the search / barcode box as usual. Instead of “not found”, a small window opens — Not in your products yet — but it is in the catalogue — with the catalogue's picture, the name (you can correct it), the category and an empty price box that says Type the price.
• Type your price. The catalogue never supplies one — the price is always yours.
• Add and sell (Enter) adds the product and puts it on the current sale; it needs a price. Add only (F2) adds it to your products without selling it. Cancel (Esc) adds nothing.
• The name, category and picture are saved with the product; change them later in Settings → Products like any other product. A barcode or name you already have is refused, as in the product screen.
• Cashiers: a cashier without the right to manage products needs a manager's approval to press either Add button.
• It works offline, from the catalogue file on the PC (section 31). A shop that does not share its product list sees the usual “not found”, as before.

4Payment: cash, card, credit

Cash

1. Press Pay.
2. Type the amount received, or use the quick buttons (+50, +100… they add up), or Exact if the customer paid the total.
3. Press OK: the receipt is saved, printed (if enabled), the drawer opens, and the change shows in big digits.

Card

1. Take the payment on the card terminal first and make sure it's approved.
2. Press Card and confirm the amount. The sale is recorded as paid by card (no change, no drawer) and the receipt says “Payment: Card”.

Credit

1. Press Credit after choosing the items.
2. Pick an existing customer or type a new name (and phone). OK.
3. The receipt is saved on the customer's account and printed with their name and balance.

The Credit button in the top bar opens the who-owes screen: every customer and their balance, Statement (all their receipts and payments, printable), Record payment when they pay back, and Print all balances for a paper copy.

5Printer & receipt

Plug it in, then open Settings → Devices

Connect and power the printer before installing; leave Set up connected devices checked. Automatic setup currently covers Epson TM-T20/T20II/T20III, Citizen CT-S310II, Bixolon SRP-350plus, and verified Xprinter, Rongta and POS58/POS80 USB variants. USB versions differ; real shop hardware validation is still required. Connecting a supported printer later may ask for one administrator approval. Use Test for a receipt and drawer pulse; connect the drawer to the printer's drawer socket.

The CH340/CH341 driver is included. Assign the COM port to a scale, pole display or drawer, then set baud and protocol in that device's tab. For an unknown device, check power and cable, then Refresh. A missing serial driver shows the chip name and vendor link; send support the model and hardware IDs. For a LAN printer, select the shop network and click Find printers. The scan runs only when requested.

In Devices, choose a category and model for connection guidance. The catalogue includes ZKTeco, Xprinter and Rongta printers; Zebra, Honeywell, Datalogic and Syble readers; and ZKTeco, Star, APG and Posiflex drawers. A listing does not mean the model is connected or hardware-tested. Keyboard-mode readers work even without a catalogue entry: use Barcode input test with an Enter suffix, without making a sale or saving input. A printer-connected drawer has no separate USB identity; match its cable, voltage and pinout. Dedicated USB and serial drawer variants use different commands and are not all supported.

• Printer: choose the thermal printer; “Default” uses the Windows default printer.
• Paper width: 80 mm (most common) or 58 mm. Leave printable width at 0 for automatic.
• Font size: 100% normal; try 110–125% if it prints small.
• Logo width in mm at the top of the receipt (0 = none).
• Print on every sale: enable after the test print works.
• Shop name, address/phone line and the thank-you footer are in the General tab.

6Cash drawer

• Connected to a network printer (IP) (3.0) — the printer is on the LAN or Wi-Fi and the drawer hangs off its RJ11 port: enter the printer's IP and port 9100 and the pulse goes straight to the printer, bypassing the Windows driver.
• Drawer won't open? Tests → Diagnose drawer now tries every command with 50 / 120 / 250 ms pulses (3.0). If none works: print the raw ESC/POS test first — if the slip prints, commands reach the printer and the fault is the RJ11 cable, the socket (drawer port, not the phone jack) or the drawer voltage (12V vs 24V); if the slip does not print, the Windows driver swallows raw commands — enable the driver's own “Cash drawer: open before printing” option or use the Generic / Text Only driver.
• Connected to the printer — the usual setup: the drawer's RJ11 cable goes into the printer's drawer port. Leave the pin on “both”. In this mode COM ports are irrelevant.
• Kick command: most printers work with ESC p (default). If not, try DLE DC4, BEL, or a custom hex from your printer's manual.
• Send the pulse inside a print job: some printers need this.
• Connected to the PC: only if the drawer uses a USB/serial trigger. Pick the port, or press Detect drawer port in Tests.
• “Open drawer on every sale” opens it automatically when you confirm a cash payment.
• Categories that don't print a receipt on their own (4.0): in Settings → Products → Categories tick No receipt on its own next to a category (a bag of bread, a bottle of water, a service line…). With “print a receipt on every sale” on, a sale made only of those categories is saved and shown as usual but nothing comes out of the printer — the status line says “not printed — items without a receipt”. As soon as the sale has one item from any other category the whole receipt prints. Reprint last always prints it; the kitchen ticket is not affected.

7Barcodes & label printing

• Give each product a barcode in the product editor: type it or scan it into the field.
• On the sales screen, scanning adds the product; scanning again adds one more.
• In Inventory, scanning adds one unit to stock (receiving).

From Inventory select a product and press Print label:

• Choose the product, the label size and the number of copies; a real-size preview appears.
• Presets: 3-across 12×38 mm roll (rotated barcode), pharmacy split label, and singles (40×25, 50×30, 30×20, 60×40…). Or set width/height/columns/gap yourself.
• Each label prints the name, price and a scannable Code 128 barcode. Products without a barcode get one generated and saved.
• Print all products prints a label for every product at once. A dedicated label printer can be set in Settings → Printer.

8Inventory & profit

• Current stock: every product with barcode, stock, full-stock level, cost, price and stock value. Low = orange, out = red. Type to search, or scan to receive one unit. Buttons: Receive quantity, Adjust stock, Edit.
• Running low: what to reorder before it runs out, with a threshold of 10–50%. Shows current stock, full stock, %, suggested quantity and its cost.
• Print stock (3.2): the Print stock button (Ctrl+P) prints the list as you see it — with the search filter applied — on the receipt printer: shop name, date, one line per product with its quantity and unit, grouped by category, running-low rows marked with !, and the item / unit totals at the end. Works on 58 and 80 mm paper.

Profit = selling price − purchase cost, so enter the purchase cost for each product (Inventory or Products). Products without a cost count as all profit.

9Reports

• Pick the period: Today, Yesterday, This week (starts Saturday), This month, Last month, or a custom from/to and Apply.
• The colored tiles show total sales, profit, receipts, items and the average receipt.
• Tabs: by product (best sellers), by day, by hour (peak times), by category, profit, and receipts (every receipt, with void and reprint).
• Cashier filter, and Export CSV saves the visible table as a file that opens in Excel (Arabic intact).
• Receipts (3.2): a Receipts button in the top bar opens this list directly. A search box above it (Ctrl+F) finds a receipt by its number, the customer name or the amount as you type, and Reprint (Ctrl+P) prints the selected one again. F8 still opens the same list for returns.

10Kitchen screen

1. Enable it: Settings → General → Send orders to the kitchen screen.
2. A Kitchen button appears in the top bar — press it to open the board, then move it to the kitchen monitor (if a second screen is connected to the same PC).
3. Three columns: New → Preparing → Ready. The cook taps a ticket to move it on. Clear ready removes delivered orders.
4. Only orders containing a product marked needs cooking appear. Ready-made items (drinks, snacks) show struck through so the cook sees the whole order.

Kitchen screen on another PC (by IP)

1. On the till PC: Settings → General: make sure “Send orders to the kitchen screen” is on, and note this PC's IP shown under the kitchen port (e.g. 192.168.1.10). Both PCs must be on the same network.
2. On the kitchen PC: install the program and open PosMasr-Kitchen.exe (it is in the same folder), press Connection settings at the top, choose Over the network, enter the till's IP and port (default 8077). The status shows at the top; several screens can connect.
3. Windows may ask to allow the program on the network the first time — allow it. If it doesn't connect, check the IP and that the firewall isn't blocking the port.

11Backup & restore

Settings → Tests → Backup & restore opens a two-part screen:

• Where (3.0): the Backup button on the sales screen (manager, Ctrl+B) or Settings → the Backup tab: back up now to a USB stick or folder, restore, open the data folder, and the automatic daily backup settings — all in one place.
• Back up: choose where — on disk (next to the program) or a USB drive (appears automatically when plugged in) — and press Back up now. A dated folder is created with products, settings, logo, credit customers, users and all sales.
• Restore: pick the backups location (or Choose folder…), select a backup from the list (date + receipt count), tick only the parts you want (settings & logo / products & stock / credit customers / users / sales history) and press Restore selected.
• A copy at PosMasr (4.0): the boxed section at the bottom of the Backup tab. Products list only is on from the start and uploads once a day: names, categories, barcodes, prices and costs, so we can hand your list back if the PC dies. Full backup (the same files as a local backup: settings with every password and secret key removed, customers and suppliers, users, sales of the last 400 days, the logo; never the license file, up to 40 MB) is there when you want it, and No copy at PosMasr switches everything off. Upload now sends one immediately; the line under the buttons shows the last upload.
• The shared catalogue (4.0): the product data you upload (names, barcodes, categories, prices and costs) also builds a catalogue we give back to the shops that share, so a new shop starts from a ready list instead of typing hundreds of products. Sales, customers, users and passwords are never part of it, and the catalogue never says which shop sells what. The catalogue is open to shops that share their list — it exists because shops share theirs. You are sharing when A copy at PosMasr is on (products list or full backup), Upload automatically once a day is ticked, and Do not use my products in the shared catalogue is not ticked. If you would rather not take part, tick that box or switch the copy off: the copy, if you keep it, goes on working as a backup, and everything already in your program stays — the products, and the pictures already applied to them — but Pick from the catalogue and the barcode lookup in the product screen are no longer available (section 31). The full wording is in the privacy policy on posmasr.com.
• Restore from PosMasr… downloads your newest copy into a folder you pick (nothing in your data changes yet) and opens the restore screen on it, so you tick the parts you want as usual. It works only on a PC with an activated license — the program proves the copy is yours with its activation key — so a trial cannot restore; on a new PC ask us for the key first. Passwords and secret keys (e-mail, Telegram, e-receipts) are not in the copy: type them again after restoring the settings.

12License & activation

The program runs as a 14-day trial, then asks to be activated. Activation is tied to the machine:

1. Open the license screen: Settings → Tests → License status (it also appears by itself when the trial ends).
2. Read the machine code (e.g. PM-XXXX-XXXX-XXXX) and send it to us — the Copy code button helps.
3. We send you the activation key. Type it and press Activate. The program is activated permanently on this machine.

13Your shop's name & logo

Settings → General: set the shop name (top bar and receipt), the brand name, and press Change logo to pick an image (saved as data\logo.png). The new name and logo appear on the window title, the top bar, receipts and labels — no reinstall needed.

14Keyboard shortcuts

15Expiry dates (new in 1.2)

• Where (3.0): Settings → the License tab shows whether you are on the trial and how many days are left, or which package is active; it shows the machine code with a copy button and a “send on WhatsApp” button, and the Activate / enter key button opens the activation screen.
• Every product can have an expiry date: type it when adding/editing the product (or tap the 📅 calendar with +1/+3/+6/+12-month shortcuts), or select the product in Inventory and press Expiry date.
• In Current stock a new Expiry column: expired = red, close to expiry = orange.
• The Expiring soon tab lists everything that expired or expires within 3 / 7 / 14 / 30 / 60 days, with stock, its value and days left.
• Alerts: the manager sees a red ⚠ N expiring button in the top bar (opens that list) and a once-a-day reminder with the names. Adding an expired item to a receipt shows a warning under the cart (the sale isn't blocked).

16Suppliers & clients (new in 1.2)

An optional feature, switched on in Settings → General → Enable suppliers & clients lists. When on:

• A Suppliers & clients button appears in the top bar: a page with a Suppliers tab and a Clients tab (add / edit / delete).
• Clients: name, phone, notes, this month's purchases, credit balance (if they buy on credit) and last activity. Statement opens the credit ledger. Credit customers and clients are the same list.
• Suppliers: name, phone, notes, number and total of deliveries and the last one. Deliveries shows everything received from that supplier (date, product, quantity, cost, expiry, who received it).
• On a sale: a “Client: none” button above the cart. Pick or type a client and the receipt is recorded and printed with the name — cash, card or credit (pressing Credit with a client picked charges that client). Cleared after every receipt.
• When receiving stock: a “Supplier: none” button in the Inventory. Pick the supplier once and every receive after it (by scan or “Receive quantity”) is logged to that supplier.

17Watch the shop from your phone (new in 1.3)

The program has a small web server built in (no IIS, nothing to install). Turn it on and open its address on your phone: today / week / month sales, sales by hour, latest receipts, best sellers, running-low and expiring items, credit owed and the kitchen queue — refreshing every 30 seconds. View-only; you log in with the manager account.

On the shop Wi-Fi — 3 steps

1. Settings → Remote monitoring tab → tick Run the web server → Save & start. The address appears, e.g. http://192.168.1.35:8090/.
2. Press Allow in firewall and accept the Windows prompt (once). Without it phones on the Wi-Fi can't reach the till.
3. Open the address in the phone's browser (same Wi-Fi), log in with the manager name and password, and add the page to the home screen.

From outside the shop

Forward the port on the router (Port Forwarding) to the till PC. The Router port-forwarding help button explains it step by step, and Check from internet asks posmasr.com to try reaching your shop and tells you open / closed plus your public address. If your public IP changes, register a free DDNS name (No-IP, DuckDNS) and write it under “Public address”.

PosMasr Link — from anywhere, no router setup (3.2)

Egyptian ISPs now put most shops behind carrier-grade NAT (a shared address), so port forwarding no longer reaches the till and a static IP is no longer sold. PosMasr Link solves it: the till keeps one outgoing encrypted connection to our relay link.posmasr.com, and your phone opens https://link.posmasr.com/<code>/ from anywhere — mobile data, another Wi-Fi, another city. Nothing to configure on the router, no DDNS, no certificate.

1. Settings → Remote monitoring → scroll to PosMasr Link → tick Turn on PosMasr Link → Save. The status line says connected to link.posmasr.com within seconds.
2. Your address and its QR are right there: scan the QR with the phone camera (or Copy and send it to yourself), open it, and add the page to the home screen.
3. Log in with the same manager name and password as the dashboard — the Inventory and Manage pages work through it too.

HTTPS with your own SSL certificate

Tick HTTPS in the same tab and choose the certificate: a .pfx/.p12 file with its password (stored encrypted), or one from the Windows certificate store — the easy path with free Let's Encrypt certificates via win-acme, which also renews them automatically. Check certificate shows the name, issuer, expiry and whether it matches your public address. Anyone typing http:// on that port is redirected to https. The certificate must be for a domain name (your DDNS name), not an IP.

Something not working?

Press Run all checks: server → local → LAN → firewall → internet, with ✓/✗ and how to fix the first thing that fails. Advanced overrides (usually leave them): port, listen on one IP, LAN-only, allowed addresses, session length, request log.

18Optional features (new in 1.4)

Settings → Features: every switch here is off by default. Turn on only what your shop needs; the buttons and fields appear after you save, and nothing changes until you do.

• Discounts: a Discount button under the cart — on the selected line or the whole receipt, amount or %, with a cashier ceiling (above it a manager must approve). A per-product sale price shows on the button as “4.00 (was 5.00)”.
• Returns: Reports → Receipts → Return: pick the items and quantities, refund cash / to card / off the credit account. A return receipt with its own number prints and the stock comes back.
• Shifts & Z report: open the shift with the float, cash in/out with a note, and close by counting the drawer — the program prints expected vs counted and the difference, with every detail (cash/card/credit, discounts, returns, VAT, movements).
• Split payment: part cash, part card, on one receipt.
• VAT: a percentage and tax number print on the receipt (prices inclusive) and total in reports.
• By weight & scale barcodes: fractional quantities with units (kg, g, L), a Qty button, and EAN-13 scale labels (price or weight) that add the right quantity on scan.
• Sizes & add-ons: small/medium/large, extra shot, no sugar… a touch picker on add; the choice prints on the receipt and the kitchen ticket.
• Tables & held orders: Hold parks the cart on a table (and sends it to the kitchen); Tables resumes it for payment with the same number.
• Product pictures on the sales buttons — since 4.1 also switched on or off at the bottom of Settings → Products (section 31).
• Supplier invoices & payments, and expenses: what you owe each supplier, rent/salaries/electricity… and a net profit line in the Profit report.
• Daily automatic backup on exit or shift close, and a daily summary on Telegram or e-mail at the time you choose. The phone dashboard installs as an app and gained cards for the drawer, suppliers owed and last backup.
• Close report by e-mail (3.2): Settings → E-mail: your own e-mail account (Gmail app password, Outlook, Zoho — server, port 587, TLS, user, password, from address), the recipients, a send time and what to include (daily summary, Z report, low-stock list, expiring list). Plain text, nothing attached. It goes out once a day: when the last shift is closed (with shifts on, after the send time) or at the send time; a failed send is retried once and logged. Send test now shows the result at once.
• Product editor fields (3.0): three switches that are on by default — Cost & profit, Expiry dates and Stock (on hand & full stock). Switch off what your shop never fills in to hide those fields, columns and filters (see the products section); nothing already saved is lost.

Scale connected to the PC (3.2)

Besides scale barcodes, PosMasr can read the weight straight from the scale over a COM or USB-serial cable (the USB kind shows up as a COM port in Windows). Tap a by-weight product and the weight lands in the cart — no label, no typing.

• Set-up: Settings → Scale tab → switch on Read the weight from the scale, pick the port (Refresh lists what Windows sees), the speed (usually 9600) and the protocol: Auto tries every format; or choose CAS (PD-II / ER / AP), Mettler Toledo (continuous or SICS), DIGI DS (a line with a number + kg/g) or Generic (any bare number, in the unit you pick). Turning it on also switches on fractional quantities.
• Test: put something on the scale and press Test the scale — you see the parsed weight and the raw bytes the scale sent, so a wrong speed or protocol is obvious in seconds.
• Selling: tapping a by-weight product reads the scale (up to 2.5 s) and adds the item with that weight — in grams for gram items, kg otherwise. Only a stable reading is accepted (you can allow moving readings in the tab). If the scale does not answer, the number pad opens with the reason in the status line and a Weigh on the scale button to try again; Ctrl+W re-weighs the selected cart line (it is in the F1 list).

35PosMasr Cloud (5.1)

PosMasr Cloud is the same till, online: the cashier sells on the PC, the shop lives on our servers in Europe (Milan) and you manage it from any browser or phone at app.posmasr.com — no server of your own to set up, and the online side updates itself and is backed up every day. This chapter covers what is different from the desktop edition; everything about selling, printing, the drawer and barcodes in chapters 3 to 7 applies as it is.

35.1 Signing up and the first day

1. Open app.posmasr.com/register: shop name, e-mail, phone, and whether it is one shop or a chain. There is no password: a 6-digit code arrives by e-mail (valid 10 minutes) and signs you in. Every later sign-in works the same way, and the browser remembers your e-mail.
2. The shop starts as a 14-day trial of the Business plan (4 tills, 15 accounts, 1 branch), no card. The checklist you land on has five steps: name the shop, add products, connect a till, invite the team, make the first sale — and it stays in the menu until they are done.
3. Set up your shop: store type (the same ten profiles as the desktop), name and logo, currency, language, VAT on or off; the receipt preview updates as you type.
4. Add products, three ways: tick them in the ready catalogue (52,000+ products with pictures, no prices — you type yours), drop a CSV or Excel export with any column names, or upload a desktop backup: a PosMasr shop moving to the cloud gets its products, customers, suppliers, stock and sales history in one go, and the import shows you 30 days of totals side by side to confirm they match.
5. Invite the team: a cashier gets a name and a till password (typed twice) and signs in on the till only; a manager gets an e-mail invitation valid 7 days and can sign in to the browser too. Rights per person are the same fifteen switches as the desktop, with presets (cashier, senior cashier, stock-taker, accountant), and a login card can be captured from any till with a card reader. The page shows “2 of 6 accounts” so you always know where the plan's limit is.

35.2 Plans, limits and what happens at the edges

A plan is per shop, never per till. It sells three limits — tills selling at the same time (1 / 1 / 2 / 4 / unlimited per branch), user accounts (2 / 3 / 6 / 15 / unlimited) and branches (1 / 1 / 1 / 1 / 2 or more) — plus the features of that plan: Basic is the counter (selling, receipts, products with pictures, discounts, returns and the phone dashboard) for up to 300 products, with the reports of the last 30 days; Cashier adds customers and credit, shifts and cash control, and the full report history; Shop adds stock, receiving, stock-takes, expiry dates, suppliers, labels and the scale; Business adds the kitchen, tables, sizes and extras, e-receipts, the e-mail report, exports and price levels; and Chain adds branches — central prices, stock per branch, transfers and consolidated reports — and printed table QR codes. Business and Chain also include the online menu, ordering from the table and the online shop, which Cashier and Shop can add by the month (35.10); Basic has no add-ons. Prices: Basic 499, Cashier 999, Shop 1,999, Business 2,500, Chain 5,000 + 750 per extra branch, EGP a month. The full matrix is on the Cloud page.

With the discount code AHLAN20, typed at sign-up or on Billing before the first payment, the first 12 months of any plan, add-on or extra branch are 20% off: Basic 399, Cashier 799, Shop 1,599, Business 2,000, Chain 4,000 + 600 per extra branch, EGP a month the first year, then the prices above.

• A till at the limit: a paired PC counts only while a cashier is signed in on it. When the third till signs in on the Shop plan it is told which two are online; sign one of them out (on the till, or from Settings → Tills in the browser with “sign out this till”) or upgrade. A PC that crashed frees its slot within 12 hours, or the moment you sign it out from the browser. Kitchen screens and customer displays never count.
• An account at the limit: active and invited accounts count, the owner included; deactivating one frees the slot at once. The Team page greys the Invite button before you hit the wall.
• A feature outside the plan does not show as a greyed button on the sales screen — a cashier on the Cashier plan simply never sees “kitchen”. Settings → Features lists every switch with its plan badge and an “upgrade” link, so you can see what the next plan adds; since 9 October, Settings → Modules switches whole modules on and off (43.1).
• Changing plan: Billing → Change plan. An upgrade is priced for the rest of the month only (the difference × the days left) and applies the moment it is paid — free and instant during the trial. A downgrade applies on the next billing day; before it the page checks that your accounts and branches fit the smaller plan and lists the features that will stop. Whatever the plan, what you already wrote stays readable and exportable.
• Chain: Settings → Branches adds a branch (the page says “+750 a month from the next cycle” before you save). Each branch has its own tills, stock, header and footer, ETA branch code and settings overrides; Products → Central price lists sets one price for all with per-branch exceptions you can lock; Inventory → Transfers moves stock between branches in one transaction; Reports → Chain views shows every branch on a row.

35.3 Connecting a till with the 6-digit code

A till is a PC in the shop running one of the two till programs (next section). It never sees your e-mail code; it is paired once with a short code and from then on it carries its own identity.

1. In the browser (phone or PC) open Settings → Tills → Connect a till (during the first day it is also the third step of the checklist). A 6-digit code appears, valid for 10 minutes; on Business you can choose whether the new device is a till, a kitchen screen or a customer display.
2. On the till PC: the PosMasr Cloud app opens the sign-in page and offers “Connect this computer”; the PosMasr Windows program asks on first run “How would you like to run PosMasr?” — choose PosMasr Cloud (the other choice, “On this PC”, is the desktop edition) and the pairing window opens.
3. Type the code and a till name (“Till 1”, “Counter”); the first letter of the name becomes the prefix of the provisional receipt numbers, so give tills different initials. Press Connect. Within a second the browser list shows the till online with its name, version and the cashier signed in.
4. The hardware is per till: printer and paper width, drawer, scale, customer display and label sizes live on the till's row in Settings → Tills (the same tabs as the desktop's Settings, with the test buttons executed by that till), so two tills can have different printers.
5. A lost or sold PC: Settings → Tills → Revoke. The device is refused from that moment; anything it still has in its offline queue is refused too, so revoke only what is really gone. A new PC is paired with a new code.

35.4 The two till programs, and the app for Mac and Linux

• The PosMasr Cloud app (download) is a small program that opens the cloud app in its own full-screen window and drives the receipt printer, cash drawer, scale and customer display. F11 toggles the full screen (kiosk), F5 reloads, Ctrl+Shift+D opens the devices list; every other key reaches the page, so the selling screen's shortcuts work as in a browser. Windows 10 and 11; the Mac (.dmg, macOS 14 and newer) and Linux (.deb or .tar.gz, Ubuntu 24.04 / Debian 13 / Mint 22 and newer) versions are the same program, available as a preview — the Mac asks you to allow the first open once in System Settings → Privacy & Security (the steps), and on Linux the printer is a raw lp queue or a network printer on port 9100 (installing).
• The PosMasr Windows program in cloud mode (version 5 and up, Windows 7 and up) keeps every screen and shortcut of the desktop edition. What moves to the browser: users and rights, receiving and stock-takes, reports and statements, the settings of the shop — the program's own buttons for those open the web app instead. Backup and licence tabs are replaced by a PosMasr Cloud tab in Settings: the mode (cloud / on this PC), the pairing and the subscription status. Switching a PC back to “On this PC” unpairs it and returns to the local data folder.
• Phones and tablets open every management page in Chrome or Safari, including the camera barcode scanner in the stock-take and the product editor; selling needs one of the two programs above.

35.5 Selling with no internet, and the provisional receipt number

Both till programs keep a copy of the shop on the PC — products with prices and stock, customers with balances, the cashiers' passwords and cards, the settings, the open shift — refreshed after every change. That copy is what the till sells from when the line drops, and also what it starts from when the PC is switched on with no internet at all.

1. The line drops. The pill in the top bar turns amber: Selling offline, and a strip says “selling offline — 3 receipts waiting” with the time since the line went. Nothing stops for the cashier: cash, card, credit (up to the customer's cached balance) and split sales, returns of receipts this till holds, cash in and out, opening and closing a shift, signing in with a password or a card, a manager's approval.
2. The receipt prints with a provisional number such as A-1043 — the till's initial and a running count — and the line “provisional — final number after sync”. The screen says “saved provisionally as A-1043”. A Z report closed offline prints “offline, provisional” too.
3. What waits: editing products and prices, saving shop settings, the reports and statements, and the browser pages — each refuses with one clear line (“editing products needs the line; selling works offline at the saved prices”). Stock may go below zero on the till; it shows so, and the cloud accepts it when the receipts arrive, because it already happened in the shop.
4. The line is back. The till checks every two seconds; on the first answer the pill turns blue, “syncing 3”, and the queue is sent in order, one receipt at a time. Every sale carries its own key, so a receipt the server already stored — even one whose answer got lost mid-way — is never stored twice. Then the shop copy is refreshed so every number on the till is the cloud's. Sync now in the strip forces a try.
5. After the sync every receipt has its final number, and the till keeps the map from the provisional one: a reprint or a return of A-1043 finds it by either number, and the customer's copy stays valid. The receipt in the browser carries an “offline” mark with its provisional number.
6. If the cloud refuses one receipt (a cashier account that was deactivated meanwhile, a plan feature switched off…) the strip says so and the rest of the queue continues; Settings → PosMasr Cloud on the till lists what is waiting and what was refused, with the reason, so nothing disappears in silence. When the subscription is paused the queue simply waits for the payment.

35.6 Billing, payment and invoices

• Billing → Plan and usage shows the plan, its price, the status and dates (trial ends / paid until), the three limits as “used / allowed” bars with the names of the tills online, and the next invoice.
• Paying: Billing → Payment, by card through Stripe — the card is saved with Stripe, never with us, and renews the plan by itself every month; remove the card from the same page any time. Can't pay by card? Contact us on WhatsApp or at sales@bytesglue.com and we agree another way with you.
• Add-ons: on Cashier and Shop, Billing → Plan sells the online menu (100 EGP a month), table QR codes and ordering (100) and the online shop (300); Basic has none. An add-on bought mid-month is charged for the days left (free during the trial, billed from the first renewal), it is a line on every renewal invoice, and cancelling switches it off at once. Moving up to Business drops the lines, because the plan includes them (35.10).
• Invoices: Billing → Invoices lists every invoice with its lines (the plan, extra branches, the prorated difference of an upgrade, a promo code), its status and the payment that settled it, and prints it as HTML.
• Late or unpaid: after the paid-until day there are 7 days of grace with a banner on every till and browser (and a reminder by e-mail when the grace period starts); then the shop is read-only: no new sales, held orders, shifts or stock writes, while receipts, reports, products, exports and billing keep working and the till shows “subscription paused — pay to keep selling”. The payment flips every till back within a second. A trial that ends unpaid goes read-only at once (nothing was paid). Sixty days read-only cancels the account; the data is deleted 90 days after that, and the export works until then.

35.7 Two-step verification

The browser sign-in is the e-mail code. For the owner and the managers you can add a second step: a 6-digit code from an authenticator app on the phone (Google Authenticator, Microsoft Authenticator, Authy…), so a stolen mailbox alone does not open the shop.

1. Your account → Security → Two-step → Switch on. Add the account to the authenticator app (scan the QR or type the key shown), then type the app's current code to confirm.
2. Save the eight recovery codes the page shows once — printed, or in a password manager. Each opens the account one time if the phone is lost.
3. From then on, after the e-mail code the sign-in asks for the app's code. Cashiers on the till are not affected: they sign in with their till password or card as before. Switch it off from the same page.

35.8 Exporting everything, and leaving

• Settings → Data → Download a copy, on every plan and in every status — even read-only or cancelled. Pick the range of receipts: you get one file, the desktop program's own backup container (“PosMasr backup 1”), with your settings, products, customers, suppliers, users, credit ledgers, receiving, payables, expenses, shifts, and the sales and stock of the range. The list under the button shows your last copies. For Excel, the products also export to CSV from Products → Import and export, and the Business and Chain plans add a CSV behind every report and the accountant feed. To bring the file into the one-time program (5.2 or newer): Settings → Backup → Restore from a file…, pick the file, check what is inside, then “Restore selected”.
• Back to the one-time edition: install PosMasr, choose “On this PC”, and restore the desktop backup from Settings → Backup as any local backup. Cashiers get a one-time password on the way back (the cloud stores passwords in a form that cannot be turned into the desktop's), so set new ones on the first day.
• Deleting the account: the same page, “Delete the account”. It waits 30 days and can be cancelled from the same button; then everything is erased. Export first — the download links work until the deletion.

The activity log (Team → Activity log) records every export, import, plan change, device pairing and sign-in for 13 months, so you can always see who took what.

35.9 Moving a PosMasr desktop shop to the cloud

A shop already selling on the desktop edition keeps its products, pictures, customers and history. Nothing on the old PC changes while you do it.

1. On the desktop till: Settings → Backup → Move to PosMasr Cloud… (also on the PosMasr Cloud tab while the till is still local). The program writes one file (PosMasr-to-Cloud-<shop>-<date>.pmbak, on the Desktop by default) with the products and their pictures, the customers and their balances, the suppliers, the cashiers, the settings and the last year of sales, and ends with “N products, M pictures, X MB”.
2. The upload limit is 48 MB: if the file would pass it, the oldest sales days and then pictures are left out, and the window says how many. Pictures are shrunk to 1200 px; a product whose picture file is missing moves without one.
3. Sign up at app.posmasr.com (or open your account), then Settings → Data → Import a desktop copy: pick the file, choose how many months of sales to bring, and press Start the import. It runs in the background and the page refreshes itself; a file imported before is recognised and nothing is done twice.
4. The report lists what moved (products, pictures, customers, suppliers, accounts, receipts, credit entries, stock, deliveries, expenses, shifts) and the Z check: how many of the last 30 days match the desktop's files to the piastre. Passwords and tokens do not travel: type the e-mail and Telegram settings again.
5. Pair each till (35.3). On the PosMasr Windows program: Settings → PosMasr Cloud → Switch to PosMasr Cloud…; it closes, reopens and asks for the 6-digit code. The local data folder stays on the PC, and switching back to “On this PC” returns to it.

35.10 Online menu, ordering from the table and the online shop

Three public pages on posmasr.com that read the shop's own products and prices. Included in Business and Chain; on Cashier and Shop each is a monthly add-on bought in Billing → Plan (online menu 100, table QR and ordering 100, online shop 300 EGP); Basic has no add-ons.

• Settings → Online: claim the shop's address (posmasr.com/menu/your-shop, posmasr.com/shop/your-shop), switch each page on, write the messages in Arabic and English, add the logo, copy the links and their QR codes. Products shown online hides products from the online pages. “Show in search engines” lists what the menu still needs before search engines may show it.
• Tables and seats: add them one by one or in bulk (rows × seats), in areas, and print the A4 code sheet (2 × 3 or 3 × 4 per page). On Chain, “Request printed QR codes” orders the printed set from us (one set per branch a year, up to 40 codes).
• Table ordering is a nine-step wizard with a recommended answer on each step: tables, how guests pay (at the end — one bill per table; pay first; or when the order reaches them), confirming before the kitchen, the bill (the shop's service charge and an optional minimum per person), what is orderable, where orders go (kitchen stations by category, sound, hours), staff (who confirms, who takes payment, waiters with a 4-digit PIN), safety (a cap on orders that go straight on, an alert for a bill open too long) and Try it now — a test table whose orders never become sales. Skipped steps show on the Today page.
• The waiter view (/waiter, made for the phone) shows every table by urgency — order waiting, bill asked, calling, paying, preparing, seated, free — to confirm orders, seat guests, print the pre-bill and take payment (all at once, by items, evenly or in parts); a bill can move to another table or merge with one; cancelling needs a manager. Payment is taken by your staff; the guest's page takes no card. The Windows till shows an “Online orders” pill with what is waiting.
• The online shop takes orders with cash on delivery: Settings → Online → Shop sets the delivery areas (fee and minimum), pickup, the minimum order and the hours. Orders arrive on the Orders page (accept, reject with a reason, out for delivery, delivered, the delivery slip); an accepted order is completed on the till as a normal sale.

More: Online menu and ordering from the table, explained · Running branches from your phone · When the internet cuts · Is my data safe in the cloud? · Cloud or desktop?

36Books: accounting & invoicing

Books is the accounting inside PosMasr Cloud: a chart of accounts made for Egypt, the till's sales posted by themselves, quotes and invoices for companies, supplier bills, the bank, and the VAT return figures ready for your accountant — in the same account, with no second program.

Plans: Business and Chain, and the 14-day trial. Online only: it is not in the program on your PC.

36.1 Switching it on and the first setup

1. The owner opens Settings → Features and switches Books on. A Books entry appears in the menu.
2. Books → Set up Books: the business details and the header of your documents (three templates, a colour, your logo if you want), the start of the financial year, then create the chart: 60 numbered accounts in Arabic and English, with the system accounts locked. You can add your own accounts and rename them; the setup can be left and picked up again.
3. Opening balances, with your accountant: choose the opening date and type each account's balance once; they become one balanced entry. Closing the first month freezes them.
4. Who sees it: the owner only. A manager sees nothing of Books until you give them one of its rights in Team → Rights.

36.2 What fills itself, and what you write

• The till's sales post themselves every 15 minutes, one entry per day (or per receipt, if you choose): sales, returns, VAT, credit and expenses. A receipt that arrives late from an offline till becomes a correction entry; nothing is posted twice. A posted entry is never edited: a mistake is corrected by a reversal with a reason.
• Selling to companies: quotes the customer accepts from a link, orders, deliveries (the stock goes out first-expiring-first), invoices, credit notes, receipts allocated to invoices, recurring invoices, the customer statement and unpaid invoices by age. Send a document by e-mail, or by a prefilled WhatsApp message you send with one tap.
• Buying: supplier bills (typed, or taken from a receiving or an invoice photo, 41.11), supplier payments, expenses and recurring expenses, with what is due this week.
• Banks and cash: bank accounts, transfers between them, card settlements, cheques, the bank statement imported (CSV, Excel, OFX, MT940), matched and reconciled.
• Reports: trial balance, account ledgers, profit and loss (against the period before and last year), balance sheet, the owner's summary and a 13-week cash forecast; CSV and Excel. Month end: a closing checklist, then lock the month (reopened only with a reason). An approval limit can make a second person approve entries above an amount.

Fixed assets and their monthly depreciation are no longer a Books page: since 10 October they are the Fixed assets module, which posts its journals into Books. The assets Books held came over once with the same book values, and the old Books links open the new pages — see 44.8.

36.3 VAT: prepared, not filed

Books → VAT return: choose monthly or quarterly. The figures come from your documents and from the till's tax-collected report: output tax, input tax, zero-rated and exempt, with every amount traceable to its document. You (or your accountant) file on the Tax Authority's portal, then write the filing reference in Books: it settles the VAT accounts and locks the months it covers. A separate step records the payment.

More: Books, the page · Accounting and invoices inside your POS

37Bookings

Appointments for salons, barbers, clinics, gyms and classes, and table reservations for restaurants: a calendar for the team, a booking page for your customers, reminders, deposits and packages, and the check out on the till.

Plans: Business and Chain, and the 14-day trial. Online and in the PosMasr Cloud till app; not in the program on your PC.

37.1 Switching it on

1. Settings → Features → Bookings, then the setup wizard in Bookings: opening hours (Ramadan hours too), the slot grid (15 minutes by default), the services with their length, price, gap after and add-ons, the team and who does what (with HR on, their roster counts), and the resources: a chair, a room, a table.
2. Rights: the owner has them all; managers and cashiers get them one by one, and a team member can be limited to their own visits. Private notes and intake answers stay with those allowed to manage bookings.
3. The booking page: switch online booking on, then copy its link and QR code for your Instagram, WhatsApp status or counter. Customers pick a service, a day and a time; the time is held while they type their name and phone, and they get a link to move or cancel within your rules (24 hours before, by default).

37.2 The day: calendar, Today and the till

• Bookings → Calendar: day, week or month, per person or per resource; pick a service to see the free times and tap one to book. The same slot is never given twice: the second booking gets other times instead. Recurring visits, classes with seats and a waiting list are there too.
• At the till (the PosMasr Cloud app's Sell page): Bookings lists today's visits. Arrived, then Start, then Check out: the visit's services land in the cart at the booked price, the cashier adds any products and takes the payment as usual, and the visit is marked done when the receipt reaches the server. Walk-in books the next free time and works with the line down too; a clash found later waits under “walk-ins needing review”. Queue ticket prints a number for the waiting area.
• Messages: booked, confirmed, reminder, moved, cancelled, thanks — in your words, never in quiet hours (21:00–09:00 by default). E-mail goes by itself; WhatsApp is a prefilled message your staff send with one tap.
• Deposits and packages: a deposit is taken at the counter as an ordinary deposit (with its tax invoice when VAT on deposits is on, 41.3) and used at the check out; a package such as “5 sessions” is sold as an ordinary product and each visit uses one session. A no-show fee is optional.
• Reports: visits, no-shows, revenue, how busy each person and room was, a busy-hours map; CSV, Excel and print.

More: Bookings, the page · Appointments without the notebook

38HR & attendance

HR sits on top of Staff (41.1): the employee file and documents with expiry reminders, leave, the weekly roster, timesheets, attendance devices, and the monthly payroll with payslips.

Plans: the file, documents, leave, attendance, devices and roster — Shop and up online, Silver and up on your PC. Payroll, payslips, the bank sheet and HR reports — Business and Chain online, Gold and up on your PC.

38.1 Online (PosMasr Cloud)

1. Switch Staff on first (Settings → Staff), then Settings → HR settings → on. Choose who may see HR: the owner only by default; then per person, “see”, “change and approve leave”, and “salaries” — a manager never sees a salary unless you give that one.
2. HR → People: the file (job, department, joining date, probation, contacts, emergency contact) and, for salary readers, the pay (basic, allowances, bank account). Documents: national ID, health certificate, contract, and the shop's own (commercial register, tax card, licence), each with its scan and expiry; the board lists what ends in 90, 60, 30 or 7 days, and reminders arrive through the owner alerts.
3. Leave: the Egyptian defaults (21 days' annual leave, sick, maternity, Hajj, unpaid) and a Friday weekend, all editable, with the public holidays to check each year. Requests, approval, balances and the team calendar.
4. Roster and timesheets: the week's grid with shift templates and conflicts in plain words, publish it, and the timesheets are worked out against your rules (grace minutes, rounding, overtime); approving a period locks it. Staff clock in at the till, or from their own phone through their personal link, where they also see their payslips, ask for leave or an advance.
5. Attendance devices (Settings → Attendance devices): three ways in — the device sends punches over the internet (ZKTeco, Hikvision), the till app reads it on the shop's network (ZKTeco, Hikvision, Anviz), or you upload the file you export from it on a USB stick. You match each device code to a person once. Fingerprints and faces stay on the device; we keep only the punch.
6. HR → Payroll → a new run for the month: the salary for the days worked, overtime, commission, advances paid back, the deductions you switched on, income tax and social insurance from the Egyptian tables. Change any figure with a reason, approve (a second person if you want), finalise — the run locks. Payslips print or save as PDF from the browser, or go by e-mail; the bank sheet and the summary come as Excel or CSV.

38.2 On the program on your PC

Settings → Features → HR (Silver and up), then the Staff screen → HR (the owner and managers). The tabs: People, Documents, Leave, Payroll (Gold), Attendance devices (the device's file, or reading it on the shop's network), Weekly roster, Timesheets, Letters and records, Labour cost, and HR settings. The rules and the Egyptian tables are the same as online.

What the program on your PC does not have: clocking in from a phone and the person's own page, devices sending over the internet, payslips by e-mail, editing leave types and holidays (Egypt's are used), and the timesheet lock. Document scans are encrypted for that Windows user and stay out of backups, so a restore on a new PC brings the documents back without their scans.

More: HR, the page · Attendance and payroll without the notebook

39Connect your AI

Your own AI — ChatGPT, Claude or any assistant that speaks MCP — reads your shop and answers “how were sales this week?”, “what is running low?” or “what was on receipt 1043?”. It only reads: it cannot sell, void, refund, take a payment, change a setting or delete anything. The AI is yours: you pay its maker; we charge nothing per question.

Plans: Business and Chain, and the 14-day trial; the owner only. Not in the program on your PC.

39.1 Switch it on and make a key

1. Settings → AI access → tick Allow AI access to this shop → Save. While it is off, every key is refused.
2. New key: a name you will recognise (“My ChatGPT”), what this AI may see — Reports, Stock, Products and Receipts are ticked; Customers, Bookings and Team are not, because they are personal data — and if you want, one branch only and a last day. Make the key and copy it now: it is shown once.
3. Paste it into your AI. The page shows ready cards with your address and key: the Claude desktop app (install Node.js once, then Settings → Developer → Edit Config), Claude on the web and the phone (Settings → Connectors → Add custom connector), ChatGPT (Settings → Connectors → Advanced → Developer mode → Create). These need the AI's paid plans. Any other MCP client: https://api.posmasr.com/mcp with the key as a Bearer header.
4. Ask: “Using my shop tools, how were sales today?”

39.2 Safety and limits

• Revoke stops a key at once. A key cannot be widened later: make a new one, so the record stays clear.
• Each key: 60 calls a minute and 2,000 a day; lists stop at 50 rows.
• A key that asks 20 times within an hour for something it is not allowed (a web page may have tricked the AI) is paused, and with owner alerts on you are told at once. Check, then Resume or Revoke.
• What the AI did lists the last 50 calls: when, which key, what it read, answered or refused. The questions themselves are not kept.

More: Connect your AI, the page · Ask ChatGPT or Claude about your shop

40Quick search (Ctrl+K) and “What happened?”

Plans: every plan. Quick search is in the online app and the PosMasr Cloud till app; the “What happened?” link is there and in the program on your PC too.

40.1 Quick search

1. Press Ctrl+K (⌘+K on a Mac; it works on an Arabic keyboard too) or the Search button at the top of every page.
2. Type a page or a setting in Arabic or English (“invoice” finds the Arabic pages too), a receipt number (1043, #1043, T2-000123, Arabic digits too), a customer's name or phone, a product's name or barcode, a Books invoice or a booking.
3. ↑ ↓ to move, Enter to open, Esc to close. The results follow the plan and the person's rights: a cashier without the reports right finds no receipts, and a page outside the plan never shows.

40.2 The “What happened?” link

Next to an error message — in the online app, the till app and the program on your PC — a What happened? link (a button in the program's error box) opens the troubleshooting guide at that very error: what it means and what to do. Not every message has one: a problem with no code of its own (a printer, the disk) shows none.

More: The troubleshooting guide · Find anything with Ctrl+K, understand any error

41New in October 2026

Eleven features, each switched off until you switch it on, so a shop that does not need one sees nothing new. Each section says where it is, the plan, and what it does not do yet.

41.1 Staff: clock-in, commission and advances

1. Switch it on: Settings → Features → Staff: attendance, commission, advances (the same in the program on your PC). Online, Settings → Staff holds its settings.
2. Staff → add each person: name, phone, role, the weekly schedule, a PIN (and a card if you use cards). A person needs no login.
3. Clock in / out at the till: tap your name, type the PIN or swipe the card — whoever is signed in. At the online till it works with the line down too and is sent later. Five wrong PINs lock that person for five minutes.
4. Timesheets: late, early and absent against the schedule, overtime after 8 hours a day, corrections only with a reason; print, Excel, CSV.
5. Commission: Staff settings → Commission rules — the shop's %, a % per category or product, monthly target tiers, after discounts or before. Optionally the cashier picks the salesperson on the sale. The commission report adds up to the sales report; “Post to ledger” records it once. Advances come out of the drawer as a cash out (“Advance: name”), so the X / Z report expects them.

Plans: clock-in and timesheets — Shop and up online, Silver on your PC; commission, advances and schedules — Business and Chain online, Gold on your PC. The salary here is a note only: the monthly payroll is HR's (chapter 38).

More: Clock-in, commission and advances

41.2 The stamp card

“Buy 9 coffees, the 10th is free”, on the customer's phone — no app to install, no paper card to lose.

1. Settings → Stamp card (managers): switch it on, then the stamps that fill the card (9 = the 10th is free), what earns a stamp (a visit at or above an amount, or each item in chosen categories or products), a cap per receipt, the reward's text, an expiry if you want, and whether the receipt prints the card. Print the counter sign from the same page.
2. The customer gets a card by scanning the QR on their receipt, or the counter sign and typing their mobile. The card page shows “4 of 9 stamps” and can be added to the home screen.
3. At the till a Stamp card box shows under the customer; type or scan a card code to link it. When the card is full, Give the reward applies it as the till's usual discount — no new payment type.

Plans: Shop and up, online and in the PosMasr Cloud till app; since 7 October also in the program on your PC from Gold, without the card page on the phone (that needs a public address the customer's phone can reach) — see 42.13. A sale made offline earns its stamps when it syncs; giving a reward needs the line. More: A stamp card on the customer's phone

41.3 Instalments and deposits, and VAT on deposits

1. Switch it on: online Settings → Instalment settings; on your PC Settings → Features. Choose the most instalments allowed (1 to 60, 24 by default) and whether a stated mark-up is allowed (off by default). A cashier needs the right to make a plan, or a manager's approval.
2. At the till: pick the customer → Credit → Instalments: the down payment (cash or card), any deposit the customer has, then N instalments every week or month from the first due date. The receipt is the whole sale, with its VAT, on the customer's account; the slip shows the schedule.
3. Paying: any payment on the customer's account counts, the oldest instalment first. Instalments lists what is due and late, the deposits held, and the report.
4. Deposits: take one from the Instalments page or the customer's page, use it on the final sale, or pay it back (with the right). With Charge VAT when a deposit is taken on — new shops start with it on; a shop from before answers a one-time question — the deposit gets its own tax invoice (AV-000001) and its VAT falls in the month it was received; the final receipt deducts “advance already invoiced”, and a refund gets a credit note. On the e-receipt, the deposit goes as a one-line sale and its use as a return that names it, so the Tax Authority's figures match yours month by month.

41.4 Menu boards and the order screen

1. Settings → Features → Restaurant screens, then Settings → Screens → Add a screen: a name and its kind, Menu board or Order screen (and the branch in a chain).
2. On the TV's browser open app.posmasr.com/screen, type the 8-digit code (valid 15 minutes, once) with the remote and press Start, then tap the screen once. The TV keeps the connection from then on.
3. Menu board: the categories it shows, offer slides on the days and hours you choose (“breakfast until 11:00”), other categories at other times of day, one or two languages, dark or light, landscape or portrait. A price or a sold-out item changes on the TV within seconds.
4. Order screen: the receipt number appears under Preparing when the order is paid or reaches the kitchen screen, and moves to Ready (big, with a chime) when the kitchen bumps it or the cashier presses Ready on the till's Order board. Optionally the first name; never a phone number, a total or the items.

41.5 Owner alerts and Ask your shop

1. Settings → Owner alerts (the owner only; a manager cannot switch them off). Pick the events and their limits: a voided receipt, a return, a big discount (20 % by default), a price below the list, a held order deleted, an item taken off after it was rung up, the drawer opened without a sale, the drawer over or short (50 by default), a big sale on credit, stock lowered by hand, a sale outside your hours, many voids by one cashier, failed sign-ins, a new device paired, a till offline while you are open.
2. Where they arrive: the bell and the alerts page always, e-mail, and Telegram (your shop's own bot, from Business). “Smart” sends the serious ones at once and the rest in an hourly digest; quiet hours hold everything until they end. A receipt that syncs late says “happened at 14:05”.
3. Needs a look, every day: each cashier's day against their own last 28 days.
4. Ask your shop — the box on the Today page, its own page, or Telegram: “how much did we sell today?”, “who owes me?”, “what is running low?”, “receipt 1043”, in Egyptian Arabic, English or Arabizi, with buttons for this week, by cashier, compare. It is fixed, explained rules, not AI: a question it does not know gets examples, never a guessed number. Since 7 October such a question can go to your AI instead, where it is switched on (42.12).

Since 10 October, where the modules are on: Projects alerts (a project past its due date, over budget, approved billable time not invoiced for 30 days, retention due after a project is done) and Fixed assets alerts (a warranty ending within 30 days, a month's depreciation waiting, an asset count open over 7 days); Ask your shop answers “how are my projects” and “what is the book value of our assets”. See 44.7 and 44.12.

Plans: alerts, Needs a look and Ask your shop — Shop and up online; Telegram from Business. On your PC (Silver): Settings → Features, then the “Needs a look” screen and a block in the daily summary. No alerts by WhatsApp. More: Know what happens in the shop while you're away

41.6 Bring your data

1. Online: Settings → Bring your data (also on the first-day setup and Products → Import). On your PC: Products → Bring data in → Bring your data.
2. Pick what the file holds — products, customers with what they owe, suppliers with what you owe, opening stock — or let us tell, then the file (Excel .xlsx or CSV). No file yet? Download the empty template in Arabic or English.
3. We find the sheet and the header row and guess every column, saying why; change any guess. Exports from Loyverse, Square, Shopify and QuickBooks are recognised as they are.
4. Choose what happens to what you already have (keep it, update prices and stock only, or update everything), read the findings and the dry run (“will add 1,240 products, update 85, skip 12”), then import. Undo this import works for 30 days.

Plans: products on every plan (Basic up to 300 products), customers from Cashier, suppliers and opening stock from Shop. It does not bring sales history: receipts from another program cannot be re-made faithfully, so you bring the opening balances instead. An old .xls file: save it as .xlsx first. More: Import from anywhere · Moving from another program

41.7 Job orders

1. Settings → Job orders: switch on and pick a template — laundry, tailoring, repairs, or general. Rename the steps if you want.
2. At the till app: put the items in the cart, then Job: the customer, notes per item, the due date, a deposit. It prints the claim ticket and the shop copy, and piece tags on the label printer if you want.
3. Job orders shows a board, a column per step; one tap moves a job on. Tell the customer by e-mail, or with Send on WhatsApp — a prefilled message you send. The customer can follow the job from the QR on the ticket.
4. Collect: find the job by its ticket's QR, its number or the phone; it becomes an ordinary sale with the deposit taken off.

Job orders are for tickets of days collected as one sale at the till. For a long job with a contract, a budget, phases, the team's hours and several invoices (a contractor, a fit-out, an agency), use Projects (44.1); a shop may use both.

Plans: Cashier and up, online and in the PosMasr Cloud till app; since 7 October also in the program on your PC from Silver — see 42.15. Phone passcodes are never stored. More: Job orders for laundries, tailors and repair shops

41.8 Smart reorder and expiry control

Settings → Reorder and expiry: two switches. Expiry control needs lots on (Settings → Features). Both are fixed, explained rules, not AI: every line says why.

• Reorder reads the last 28 days (a day the item was out of stock does not count), the weekday, what is on order, the supplier's delivery days and a safety day, then says: “sells 6 a day, 3 days left, the supplier takes 2 days → order 48 (4 cases)”, within the shelf's max and the shelf life. Make the purchase order, then send it by e-mail, by WhatsApp (a prefilled message) or print it. Dead stock is listed too.
• Expiry control: every lot within 7, 30, 60 or 90 days, with what will be left over at its expiry. Markdowns (30 % at 7 days, 50 % at 2, by default) apply to that lot only, automatically or after your approval, with labels showing the new price. An expired lot is not sold: blocked (default), a manager's approval, or a warning. Return it to the supplier or write it off with the reason “expired”.

Plans: Shop and up online, Gold on your PC. No seasons: a Ramadan rush is not foreseen, so look over the quantities. More: Order the right amount, sell before expiry · Expiry dates

41.9 Weight and volume: blends, tare, batches

1. Online Settings → Weight and volume; on your PC Settings → Features. Pick a template: roastery, spices, sweets, fresh (butcher, fish, vegetables) or perfume.
2. At the till type what the customer asks: “250 g”, “ربع” (a quarter kilo), “3 pcs”, or “50 جنيه” — the line then charges exactly 50 pounds. A container's tare is taken off by itself, and the note shows gross − tare. Scale labels and your own labels with a best-before date are read back exactly.
3. Blends: parts by amount or by % of a size, a mixing fee, the bottle or the customer's own; save a customer's formula (“Ahmed's mix”) and sell it again in one tap. Each part's stock goes down by what went in.
4. Batches (roasting, cleaning, packing a sack into bags): the input goes out, the outputs come in, the loss % and the cost carried to each output. Stock by weight report, and shrinkage or evaporation write-offs.

Plans: Shop and up online, Silver on your PC. The scales and label printers are driven as before; this round was not tried on a real scale. More: Selling by weight: blends, tare and batches · Scale barcode labels

41.10 The credit book and reminders

1. Settings → Credit book: switch on; the days to pay (30 by default), a default limit and whether going over it warns or blocks at the till, the payment details your statement shows, and the reminders (off until you switch them on).
2. Customers → Credit book: everyone who owes, overdue, the age of the debt (0–30, 31–60, 61–90, 90+), the last payment and reminder. A customer's page: a note (“called, will pass by”), a promise to pay on a day, the statement link, Take a payment.
3. Reminders to send: today's WhatsApp list — one tap per customer opens the prefilled message on your phone. E-mails go by themselves to customers who gave an address. Three polite tones (friendly, firm, final), never in quiet hours, stopping after 4 reminders.
4. Collections (Reports): collected by day and cashier, reminders sent and how many paid after one, promises kept and missed.

Plans: Cashier and up, online and in the PosMasr Cloud till app; since 7 October also in the program on your PC from Silver — see 42.16. WhatsApp is never sent by itself, and there are no SMS. More: Collect what you're owed, politely · Selling on credit

41.11 An invoice from a photo

1. Inventory → Invoice from a photo (or From a photo on Receive stock). The first time, a manager agrees that the photos are read by an AI service.
2. Take a photo of the supplier's invoice (Arabic, English or both) or choose a PDF, then Read the invoice.
3. Check it beside the photo: each line green, amber or red; the product matched (or made new), the carton of 12, the cost, the expiry. We recompute every total ourselves: “matches the invoice”, or “differs by 12.00: check line 4”. Then the supplier, the invoice number, the VAT, paid now or on account.
4. Confirm and receive: the stock, the costs and the supplier's invoice in one go. What you matched is remembered for that supplier, so the next invoice is nearly one tap.

42New on 7 October 2026

Sixteen additions. Most are switched off until you switch them on, so a shop that does not need one sees nothing new. Each section says where it is, the plan, and what it does not do yet. A few have not reached your shop yet: the WhatsApp front desk is coming with the next update, the Apple and Google Wallet buttons are coming soon, and your AI's answers in Ask your shop, Your week and the supplier price list from a photo are switching on shop by shop. The Android tablet till is out: the download page.

42.1 The front desk on WhatsApp

Your shop's own WhatsApp Business number, answered by your AI from your catalogue, prices and stock. Coming with the next update.

1. Settings → Front desk (owner or manager): connect the shop's WhatsApp Business number through Meta's official WhatsApp Cloud API, then Check the connection. Orders follow your online shop's areas, fees, hours and cash on delivery; bookings follow Bookings.
2. Pick the mode: off, drafts (staff check and send), pilot (automatic only for the numbers you list) or automatic. Add the assistant's name and tone, and your shop's own questions and answers.
3. Customers write in Egyptian Arabic, English or Franco, or send a voice note of up to 3 minutes (the audio is not kept), a photo of a product, a list or a prescription, or a location. Nothing is placed until the customer says “yes”; then the order reaches the tills like any online order.
4. Front desk inbox: Take over a conversation or Return to the assistant. A hand-off left 15 minutes unanswered alerts the owner.

Plans: an add-on on Business and Chain (and in the trial) at 750 EGP a month. AI replies a day: Business 200, Chain 600, the trial 30; past that a person answers. Messages are kept 90 days (with the update, the days you choose: 30–365 — 43.14); outside WhatsApp's 24-hour window only the order-status message goes, and never marketing. Not in the program on your PC. More: The front desk · Orders on WhatsApp

42.2 The Google review QR on the receipt

1. Online: Settings → Shop → “Review link (Google)”: paste your shop's Google review link (each branch keeps its own). On your PC: Settings → General, the same box. Empty means off.
2. From then on every printed sale receipt ends with “Happy with us? Scan to rate us” and the link's QR under it — on the online till, the program on your PC and the Android till.
3. The receipt you send on WhatsApp, and the customer's receipt page online, carry a “Rate us” link too.

Plans: every plan, and the program on your PC. It prints on sale receipts only — not on a return, a void or a delivery slip — and not on the A4 invoice. The link is your own; nothing goes to Google from us. More: Google reviews from every receipt

42.3 Order the same again

1. It needs your shop's online address (Settings → Online). Send the receipt from the Receipts page with WhatsApp: the message carries “Your receipt: link”, which opens the customer's receipt page.
2. With the online shop on, Order the same again puts the items in the online shop's cart at today's prices and names what is no longer available.
3. Without it, the page shows a “show this at the till” QR. The cashier scans it in the scan box (with the scanner or the camera) and the cart refills with the receipt's items. The program on your PC reads it too, for its receipts of the last 62 days.

Plans: the receipt page and the till QR on every plan; the order into the online shop wherever the online shop is (Business and Chain, or its add-on on Cashier and Shop). Sizes and add-ons are not carried over: the base item goes in. The receipt page's link is not printed on the paper receipt. More: Order the same again

42.4 Returns and questions from the receipt page

1. Settings → Shop → “The customer's receipt page”: the return window (14 days by default, 1 to 365), customers can request a return, customers can ask a question.
2. On the receipt page the customer picks the items, the quantities and a reason, adds a few words, a photo if they like, and a phone number if they want a WhatsApp answer — or asks a question (up to 500 characters). One open return request and one open question per receipt at a time.
3. On the Sell page a Customer requests badge shows the count. Accept and make the return opens the normal return form already filled; or Reply, or Decline with a reason. The customer reads the state on the same page.

Plans: every plan, online; it needs the shop's online address. Requests are kept 180 days. No sound or push for a new request (the badge moves), and we send the customer no e-mail or WhatsApp: the answer is yours. The program on your PC has no such inbox. More: Returns and questions from the receipt

42.5 The cost-rise warning and the margin floor

1. Online: Settings → Selling, beside the stock settings: “warn when a cost rises by” (10 % by default; 0 = never) and the “margin floor” (0 = off). On your PC: Settings → General.
2. When you receive goods at a higher cost (Receive stock, a purchase-order receive, an invoice from a photo), the line says: “Cost was 10.00, now 12.00 (+20 %). Margin now 20 % at 15.00 (was 33.3 %). Suggested price 18.00 keeps 33.3 %.”
3. Apply 18.00 in one tap (the products right or a manager), or Keep the price and nothing changes. A line under the margin floor shows on the margins page, in the “Margin squeezed” owner alert and in the daily summary.

Plans: Shop and up online; Silver and up on your PC. Margins are on the price without VAT (the 14 % is not profit), and the suggested price is rounded up to the nearest 0.25 EGP. Fixed rules, not AI. More: When the supplier raises the price

42.6 Slow and dead stock

1. Stock → Slow stock: every item with stock and no sale for 45 days (change it from 7 to 365, per branch), the money it holds at cost, the last sale and the supplier. On your PC: the inventory screen's Slow stock tab.
2. Each line gets something to do: discount it when the price leaves room, bundle it at three or more, return to supplier when a known supplier delivered it within 90 days, or stop reordering while it is on an open purchase order.
3. A tile on the Today page, Excel and CSV, a weekly list in Saturday's summary (or daily, or off), and a “Slow stock” owner alert once a week. Ask your shop answers “what is not selling?”.

Plans: Shop and up online; Silver and up on your PC. An item that has just arrived gets its chance first. Fixed rules, not AI. More: The money sitting on the shelf

42.7 Move slow stock to the branch that sells it

1. In Slow stock pick the branch: beside each item a Sells at column lists the other branches where it sells — the rate there, what they hold, the days that lasts, and the quantity to move.
2. Create transfer for one item, or Move all suggested to a branch; both land on a numbered transfer note, ready to print and send with the goods.
3. The sending branch keeps what it is still expected to sell. The weekly alert and the summary say “3 products could move to …”, and Ask your shop answers “what should I move to Maadi?”.

Plans: online, for a shop with two or more branches; creating the transfer needs the Chain plan. Not in the program on your PC (one shop, one stock). The transfer arrives in one step — unless the shop has Warehouses on and chose “in transit” between branches (Chain): then it leaves when sent and arrives when the other branch receives it (43.8). More: Move stock to where it sells

42.8 The supplier's price list from a photo

Switching on shop by shop.

1. Suppliers → the supplier → Price list by photo: photograph the supplier's list or choose a PDF. The same invoice reader reads it, and each page is one of the month's readings.
2. The review: each row with its matched product, the pieces per carton, the new piece cost and today's, the change %, the margin before and after, and the price that keeps the margin. Tick the rows, tick “Also set the price to …” where you want, and say whether the printed prices include VAT.
3. Apply writes the costs (never the stock) and the prices you ticked. Purchase orders to that supplier then start from the list, and the cost-rise warning at receiving shows only when a delivery differs from it.

Plans: online, wherever the invoice reader is on (Shop 15 readings a month, Business 20, Chain 40). A list older than 60 days is marked “may be stale”. Not in the program on your PC. More: The supplier's price list from a photo

42.9 Your week: a voice note every Saturday

About a minute in an Egyptian voice, every Saturday morning: last week in your shop. Switching on shop by shop.

1. Settings → Owner alerts → tick Your week (off by default).
2. On Saturday from 08:00, outside your quiet hours: sales and receipts against the week before, the average receipt, the best day, the top three products, cash and card, returns and discounts, what is running low, the slow stock — and one suggested action.
3. Listen on the Your week card at the top of the alerts page (a player, the words written out, Share on WhatsApp), on Telegram as a voice message, or by e-mail. When your AI is set up it writes the note; otherwise a fixed template is filled with the shop's figures, and the card says which.

Plans: online, on the plans with owner alerts (Shop and up); Telegram from Business. When your AI writes it, it counts as one of the day's questions. The audio itself does not go to WhatsApp: Share sends the words and the link. More: Your week, the Saturday voice note

42.10 Top sellers on the menu-board TV

1. Settings → Screens → a menu board → Team slide: switch it on (off by default), choose today, this week or this month, rank by orders or by amount, and whether money shows (hidden by default). Preview the team slide shows it.
2. Who may appear on the team slide (managers): “Not on the board” for anyone, the name shown on the TV, and a photo if you like.
3. The TV shows a podium of the top three, a medal each and first names only, after the menu pages and the offers.

Plans: Business and Chain, online, with the menu boards. It shows only when at least two people sold in the period. Not on the customer display of the program on your PC. More: The team slide on the menu board

42.11 Try with sample data

1. The owner only, in a shop with no real sales yet: the Getting started checklist, Add products, or Settings → Data → Try with sample data.
2. One click fills the shop for its kind (grocery, café, restaurant, pharmacy, clothes): products with stock, customers (a few on credit), suppliers, a cashier or two, and 25 days of receipts in their own series, SAMPLE0 — so the reports, the Today page, the alerts and Ask your shop have something to read.
3. Remove sample data in one click takes out exactly the sample; what you made yourself stays. Your first real receipt is still number 1.

Plans: every plan, online, within your plan's products and accounts. The button goes once the shop makes a real sale. The sample does not switch features on (tables, kitchen, shifts). More: Try the program with sample data

42.12 Ask your shop, answered by your AI

Switching on shop by shop.

1. Ask as before: the box on the Today page, the Ask page, or Telegram. A question the fixed list reads is answered as before, with no AI.
2. Any other question goes to your AI. It reads the shop's own reports with the asker's own rights, answers in Egyptian Arabic, and ends with “Based on: …” naming what it used. Check the figures on the reports before you act on them.
3. Settings → Owner alerts → the Your AI card: whether it is on, and “3 of 50 today”.

Plans: free questions a day — Shop 20, Business 50, Chain 100, the trial 20; Basic and Cashier have no Ask box. It only reads: it changes nothing in the shop. Questions are kept 30 days; answers are not kept. Not in the program on your PC. More: Ask your shop, answered by your AI · Connect your AI

42.13 The stamp card in the phone's wallet, and on your PC

1. Online: under the stamp card on the customer's phone, Add to Apple Wallet and Add to Google Wallet — coming soon. The pass will update itself after every visit: the stamps, the points, the reward and the code the cashier scans; nothing to set in your shop. The card page itself works today, and now shows the points balance too.
2. On your PC (since 7 October): Settings → Loyalty → Stamp card: the switch, the stamps to fill the card, per visit or per item, the minimum amount, the reward, the expiry, the categories that count, and “print on the receipt”.
3. At the till the member button shows “name · Stamps: 4 of 9”; Stamp card opens the card: the stamps, the history, Give the reward, and Correct the card for a manager, with a reason. The receipt prints “Stamps: 5 of 9”.

Plans: Shop and up online; Gold and up on your PC. On your PC there is no card page for the customer and no link on the receipt (the program has no web address), and a second till keeps its own stamps for now. More: The stamp card in the phone's wallet · A stamp card on the customer's phone

42.14 An Android tablet as the till

Out now, as a first version (preview): the download page.

1. Install “PosMasr Till” from our download page (it is not on Google Play yet), on an Android 9 or newer tablet or handheld: Samsung tablets, Sunmi, iMin.
2. Sign in with the shop's e-mail, then Settings → Tills → Connect this device with the code, then Sell. It is the same online till: it sells with the line down and sends the sales later.
3. Receipt printers on USB, Bluetooth or the network, or the built-in printer of Sunmi devices; the camera or a handheld scanner for barcodes. On a 10-inch tablet held sideways the Pay button stays at the bottom of the screen.

Plans: it is the PosMasr Cloud till, so it follows your plan. Not there yet: scales on a serial port and pole displays; the cash drawer opens only through the receipt printer. More: An Android tablet as the till

42.15 Job orders on your PC

1. Settings → Features → Job orders, then “Job order settings…”: the kind of shop (laundry, tailoring, repair, general), usual days, express %, warranty days, the terms on the ticket, piece tags, the steps.
2. Sales screen → New job over the cart: the customer, the due time, a deposit (cash or card), the template's fields. It prints the claim ticket, the shop copy and piece tags on the label printer. Job numbers (J0042) are their own series, apart from receipt numbers.
3. Top bar → Job orders: the board, the list and the report; Next step, Send on WhatsApp, and Collect — an ordinary sale at the job's prices, the deposit first. If a collection is voided, the pieces and the deposit go back to the job.

Plans: Silver and up on your PC (online: Cashier and up). Online only: the “Track my order” page and its QR, and the “ready” e-mail — from your PC, send the ready message on WhatsApp. A second till does not take jobs. More: Job orders for laundries, tailors and repair shops · 41.7 Job orders online

42.16 The credit book on your PC

1. Settings → Features → Credit book and reminders, then “Credit book settings…”: the days to pay, the shop's limit, warn or block, how customers can pay you, the daily list and its rhythm, quiet hours.
2. Top bar → Credit book: who owes and how much, what is overdue, the age of the debt (0–30, 31–60, 61–90, 90+). A customer's page: a note, a promise to pay on a day, their own limit and terms (managers), Take a payment, the printed statement.
3. Reminders to send: the list is built when you open the book (once a day) or by a manager's tap; Send on WhatsApp opens the message ready on this PC. At the till, a sale on credit over the limit warns or is refused.

Plans: Silver and up on your PC (online: Cashier and up). Online only: the e-mail reminders, the customer's statement link, the owner's morning nudge and your own reminder words. Collections by cashier are not recorded on your PC. More: Collect what you're owed, politely · 41.10 The credit book online

43New on 9 October 2026: modules, procurement, warehouses, groups

PosMasr Cloud becomes one account that grows into a suite. Modules, Procurement, Warehouses and Consolidation are available now, each off until a manager switches it on. Connections to Daftra, Zoho Books, Xero, QuickBooks Online and Paymob are coming soon (each switches on once its set-up with the provider is finished), and the Front Desk's new skills come with the Front Desk in the next update. None of this is in the program on your PC. Fixed rules, not AI — except the invoice reader and the Front Desk. The overview: From till to ERP · Connections.

43.1 Modules: switch on only what you need

1. Settings → Modules (managers; the owner for add-ons): one card per module — Sales and Till, Stock and Purchasing, Customers and Loyalty, Jobs and the Credit Book, Books, HR and Payroll, Bookings, Online Shop / Menus / Screens, Front Desk, Connections, AI, Procurement, Warehouses, Consolidation, and since 10 October Projects and Fixed assets. Each card says what it includes and how it is priced.
2. Switch on / Switch off. Off hides the module's pages from the menus and the quick search (Ctrl+K); opening one of its pages takes you to its card. Nothing is deleted. Sales and Till is always on.
3. A card names what must be on first (Procurement and Warehouses need Stock; Jobs and Projects need Customers; Fixed assets needs Books), and a module another one needs cannot be switched off under it. Switches are per branch: on Chain each branch keeps its own.
4. A module outside your plan shows “Included from …” and Upgrade. An add-on shows its monthly price (Procurement 300, Warehouses 300, Projects 300 and Fixed assets 200 EGP for Shop, the Front Desk 750 EGP on Business and Chain) and, for the owner, Buy the add-on: it opens Billing → Plan → “Add-on modules” (44.13). The Today page shows a row of the modules you have on; Billing lists your add-on modules.

Plans: the page is on every plan; each module as its plan allows. Not in the program on your PC. More: One account that grows with you

43.2 Procurement: switching it on and the rules

1. Settings → Procurement (a manager): switch it on. It needs Stock.
2. Per branch (or every branch) two amounts: up to the first a request is approved as it is raised; above the second it needs two approvals by two different people; in between, one.
3. Who approves (the owner only changes this): the first approvers and the second approvers by name — or, with none named, anyone with the approve right and the managers for the first step, the owner and the managers for the second.
4. Monthly budgets per product category, soft (a warning) or firm (passing it needs two approvals); the price tolerance (1 % by default) and the quantity tolerance (0); the payment terms (the shop's, per supplier); after how many hours a waiting request alerts the owner (24) and after how many days an order is late (1).
5. Team → the person → Rights: “raise purchase requests”, “approve requests”, “match supplier invoices”. Managers and the owner have them all.

Plans: Business and Chain, and the trial; an add-on for Shop at 300 EGP a month. On the program on your PC: from 5.7.0, Gold has requests, approvals and the invoice match on one PC (43.15); quotes by link stay online. More: Procurement

43.3 Purchase requests and approvals

1. Procurement → a new request: products and quantities, a reason, the date needed and a preferred supplier per line. Each line is priced at that supplier's latest price list (else the product's cost). Over a budget, the request says so.
2. Approvals: the requests you may approve now, oldest first. Approve, or reject with a note. Never the requester, never the same person twice. The requester (or a manager) can withdraw a waiting request.
3. An approved request becomes one order to one supplier, or split per line's supplier — or ask for quotes first (43.4). The orders are ordinary purchase orders: sending to the supplier and receiving as before.

Requests waiting longer than the shop's hours alert the owner; Ask your shop answers “what is waiting for my approval?”. More: Purchase requests and approvals

43.4 Quotes from several suppliers by link

1. On an approved request, Ask for quotes: up to 8 suppliers, a due date and a note. Each supplier gets its own link: Send on WhatsApp opens your own WhatsApp with the message ready, or copy the link. We do not e-mail it.
2. The supplier's page shows your shop and the lines with the quantities only — never your costs — in the supplier's language. The supplier types a price each and the quantity it can send per line, a delivery date and a message.
3. Your page shows the quotes side by side, the cheapest per line marked and the best quote suggested. Pick makes the order to that supplier at its prices, and they become its next price list. Cancel stops every link.

More: Quotes from several suppliers by link

43.5 The delivery note and the three-way match

1. On the purchase order, Receive with a delivery note: per line what came, what was damaged (refused at the door, never in stock), the batch and expiry. Accepted, over and short are worked out; a partial delivery leaves the order open. The note says how late it came.
2. The supplier invoice: typed (prefilled from the delivery note at the order's prices) or filled from a photo by the invoice reader; its number, date, VAT and payment terms.
3. The match, per product: the order, what the note accepted, what the invoice bills and at what price. Within the tolerances it is posted — with Books, a supplier bill with its VAT code and due date; without Books, the supplier's account takes the difference.
4. Outside them it waits in Invoices to check: Accept as it is (the approve right, a note), Dispute with the supplier (it stays in the queue), Return to the supplier (nothing posted), or Match again when a missing delivery note came.

More: The three-way match

43.6 Supplier ageing, scorecard and alerts

• Supplier ageing: what you owe each supplier by days past due — not due, 1–30, 31–60, 61–90, over 90.
• On the supplier's page, the scorecard: on time, fill rate, price against the orders, damaged, orders late now, invoices with differences.
• Owner alerts for requests waiting too long, invoices that did not match and late orders; a line in the daily summary; Ask your shop: “which supplier is late?”.

43.7 Warehouses: locations, bins, min and max

1. Settings → Warehouses (a manager): switch it on (it needs Stock). Choose how transfers between branches go: instant, as before, or in transit (Chain). The days after which a transfer on the way is late (3), the serial-tracked categories, and blind counts for staff (on).
2. Locations: add one to a branch — a store room, a central warehouse, a van, consignment stock — with a name and the location it is refilled from. Each branch's own location is its shop floor, where the tills sell from. Up to 50 locations.
3. Per product per location: a bin (the shelf code) and a min and a max. Receive into a location from the receiving page or a delivery note.

Plans: Business and Chain, and the trial; an add-on for Shop at 300 EGP a month. A till sells from its branch's shop floor only; consignment settlement with the supplier is not built. Online only.

43.8 Transfers that travel

1. Warehouses → Transfers → a new one: from, to, the lines. Between two locations of one branch it moves at once.
2. Pick on the scan page with a barcode scanner or the phone's camera: a product, a pack, a batch or a serial. Then Dispatch: the numbered transfer note prints with a QR, and the goods are in transit.
3. The other end scans the QR, counts, and confirms the receipt — in parts if needed. Short, damaged or over goes to a manager to settle: written off or kept.

A transfer late on the way, and one received with differences, alert the owner; Ask your shop answers “what is in transit?”. More: Warehouses and transfers

43.9 Batches, serial numbers and recall

• Batches (lots) travel with their expiry, cost and supplier; sales take them first-expiring-first. A location's page lists its batches with the days left.
• Serial numbers are received one by one (lots must be on); a serial already in stock, or typed twice, is refused. The till sells one by picking its lot; a return puts it back.
• Recall: type a batch or a serial (“L-2405”, “l 2405” and “L2405” are one) and see it on hand in every location, on the way, and the receipts it went into. Ask your shop: “where is batch L2405?”.

More: Batches, serials and recall

43.10 Counts, valuation and refills per location

• Counts: one location — everything, a category or a bin. Counted by typing or scanning; blind for staff; a manager sees the difference in units and value and approves it, or sends it back.
• Valuation: every location at the product's cost, plus what is on the way, and the total.
• Replenish: a location at or under its min is brought up to its max from its source location as an internal request; a location with no source is pointed to the smart reorder.

43.11 A group of companies (Consolidation)

1. The owner of a shop on Chain: Reports → Groups → create a group, then invite the owners of the other shops or companies by the e-mail they sign in with (up to 20 shops).
2. Each invited owner sees the invitation on the same page and approves it with what they allow (stock transfers, shared products and prices, customers) — nothing of their shop is read before. Any plan may join; leave any time.
3. Name an accountant or a viewer from the member shops. Group dashboard: per shop and for the group, without the business between them. With Books in each shop: the group P&L and balance sheet, VAT side by side, the closing of each month; CSV, Excel or print. Ask the group: “sales of the group today”.
4. Transfers between the group's shops at an agreed price (a sale in one, a purchase in the other, settled later); products, prices and suppliers pushed after a preview; one credit limit for a customer across the group.

Plans: creating a group is part of Chain (nothing new billed); any plan may join. Group transfers are not posted into each shop's Books by themselves yet. Online only. More: A group of companies

43.12 Connections: Daftra, Zoho Books, Xero, QuickBooks Online

Coming soon: each program switches on once its set-up with the provider is finished.

1. Settings → Connections (the owner or a manager) → Connect on the program: allow it at the program's sign-in page and choose the organisation. Daftra: paste your Daftra address and an API key you make in Daftra.
2. Accept or change the suggested accounts (sales by VAT rate, VAT, cash, card, cost of goods, expenses).
3. From then on, by itself: one journal per branch and closed day; customers on credit, an invoice per credit receipt, credit notes and payments every 15 minutes; Books' bills and expenses if you switch them on. Each document once; a late receipt goes as an adjustment journal. Refusals are listed with the program's words and Send again.

Plans: Business and Chain, and the trial; not an add-on. The programs' own subscriptions are yours with them. More: Connections · The article

43.13 Card payments with Paymob

Coming soon, with your shop's own Paymob merchant account.

1. Settings → Connections → Paymob: paste the keys from your Paymob dashboard (a new Paymob account starts in test mode). Nothing to map.
2. The online shop offers Pay online (card / wallet) beside cash on delivery. The order counts as paid only after Paymob's signed confirmation is checked; it then reaches the tills as a paid order.
3. From the credit book, a pay link for what a customer owes (never more); the customer's statement shows Pay now. A cancelled paid online order: Refund through Paymob, once.
4. Daily settlements are read; download the statement (CSV or OFX) and import it in Books. Payments no order made wait in a “not matched” list.

Plans: Business and Chain, and the trial. Paymob's fees are your contract with Paymob; we charge nothing per payment. More: Paymob · The article

43.14 The Front Desk learns your shop

Coming with the Front Desk in the next update (42.1).

• Settings → Front desk → What customers ask: your notes (returns, parking, allergens…) beside up to 60 questions and answers; the gaps — questions it could not answer — to answer once; Try a question. Prices always come from the live catalogue.
• Customer memory: a short summary per customer, secrets never kept; messages kept 30–365 days (90 by default); Forget per customer (the owner).
• Goals: what it may suggest (order, book, the stamp card, a review, a call back), one at a time. Cases in the inbox: a brief, who has it, reminders, done.
• A day's budget of AI replies; past it messages are taken in for your staff. A reply that breaks the rules after one repair is never sent.

Plans: part of the Front Desk add-on on Business and Chain (750 EGP a month). More: The Front Desk · The article

43.15 Procurement on the program on your PC (5.7.0, Gold)

Added on 10 October 2026 with desktop 5.7.0: the same flow on one PC, offline, for the Gold package (and Platinum). A PC that is the online shop's till opens the online Procurement pages instead.

1. Settings → Features → Procurement (switching it on switches purchase orders on), then Procurement settings: approved at once up to an amount, two approvals above another, who approves the first and the second step, monthly budgets per category or for the whole month (firm: two approvals when passed), the price and quantity tolerances, the payment terms (the shop's and per supplier), and after how many days an order is late.
2. Settings → Users: the rights to raise purchase requests, to approve, and to match supplier invoices. The managers have them all; a decision is always the signed-in person's own.
3. Top bar → Procurement → New request: products from the list (search or scan) or a free-text line, a quantity, an estimated cost each, the date needed, a note and a supplier to suggest; Send. Within the automatic amount it is approved at once; otherwise one or two approvals.
4. The approver sees the lines, the budgets and the history: Approve, Return for changes or Reject, with a note. A returned request is changed by its requester and sent again (Change and send again).
5. Make the purchase order: one order to one supplier, or one per line's supplier, in the usual purchase-order screen (PO-n), ready filled; free-text lines cannot go on an order. Receive it as before.
6. Supplier invoice: pick the order, type the number, date, VAT, lines and the total printed; Match and save. Within the tolerances it is posted (the supplier's account takes the difference). Otherwise it waits in Invoices to check: Accept as it is (with a note), Ask for a credit note (noted here, nothing is sent), Return the goods, or Match again.
7. The Procurement home: open requests, waiting for my approval, orders not received (late ones in red), invoices to check; Supplier ageing: not due, 1–30, 31–60, 61–90, over 90 days. Requests, matches and the ageing print.

Plans: Gold and Platinum, from desktop 5.7.0 (download). Quotes from several suppliers by link, delivery notes with damaged goods, the scorecard, owner alerts and Ask for procurement are online only (43.4–43.6). The backup carries the requests and invoices; on a move online they stay on the PC. More: Procurement on your PC

44New on 10 October 2026: projects and fixed assets

Two more modules in PosMasr Cloud, each off until a manager switches it on: Projects (it needs Customers) and Fixed assets (it needs Books). Both are in Business and Chain and the trial; for Shop they are add-ons the owner buys on Billing → Plan (44.13). Not in the program on your PC. Fixed rules, not AI. The overview: Projects · Fixed assets.

44.1 Projects: switching it on and the settings

1. Settings → Projects (a manager), or Settings → Modules: switch it on. Customers must be on.
2. The defaults of a new project: the retention % (up to 50 %), the markup % and the billing rate per hour; after how many days approved billable time not invoiced alerts the owner (30); how many days after a project is done its retention falls due; the timesheet's first weekday.
3. An hourly cost per person for people without HR's pay or a salary on their staff record. The cost of an hour is HR's pay when HR is on and the person has an HR file, else the salary on the staff record, else this rate; it is kept on each time entry when recorded.
4. Team → the person → Rights: see projects and their money, manage projects, approve time. Managers and the owner have them all. Without the money right a person sees only the projects they work on, their own tasks and time — never contract values, costs or margins.

Plans: Business and Chain, and the trial; an add-on for Shop at 300 EGP a month. Online only. More: Projects for long jobs

44.2 A project and its phases

1. Projects → New project: the customer, a name, the site, the manager, start and due dates, the contract value, the budget, how it is billed (milestones, progress, time and materials), the retention %, the markup % and the billing rate. It starts as a quote or active; it gets a number PRJ-000123.
2. Phases: a name, a budget, dates and a milestone amount each. The project's budget is the sum of the phases' unless you type it. A milestone that was billed keeps its amount and cannot be removed.
3. States: quote → active ⇄ on hold → done (a manager can reopen it); cancelled from quote, active or on hold. Attach pictures or PDFs to the project; a customer's projects open from the Customers list's “Projects” link.

44.3 Tasks and the board

• A task: a title, a phase, an assignee, a due date, an estimate, notes, a checklist and comments.
• Board: four columns — to do, doing, review, done — moved with buttons (there is no drag and drop). A task opens below the board with its checklist to tick and its comments. The assignee moves and ticks their own tasks.
• The tasks suggest a % complete for a progress invoice: done estimated hours over all (a task without an estimate counts an hour).

44.4 Time: the phone page, the clock and the weekly timesheet

1. On the phone, Projects → Time (/projects/time): pick a project or one of its tasks, a day (never ahead of today), the hours (1.5, 1:30 or 90m), billable or not.
2. Or Clock in on a project or a task and Clock out when done: the minutes between are recorded (at least 1, at most 24 hours). One running clock per person.
3. The Timesheet shows the week; with the approve right, everyone's: a person's total, billable hours and what waits. Approve the week or Send back with a note. Approved time is locked; a sent-back entry is corrected by its person and waits again. Nobody approves their own time (the owner may).

44.5 Costs: expenses, materials from stock, bills

• On the Expenses page an expense can name an open project: the expense and the project's cost line are written together, and the expenses list shows the tag.
• Materials from stock: the branch's stock goes down at once, at the product's cost (a movement with the project's number); refused when the stock is short. Sending the same request twice takes nothing twice.
• Typed on the project: a supplier bill, a subcontractor, anything else — a procurement supplier invoice by its number fills the supplier, the reference and its net. Each line: day, amount without VAT, phase, billable or not, markup.

44.6 Invoices, retention and advances

1. On the project, Invoices: choose the kind — a milestone (a phase's amount, once, or a typed amount), progress (the contract × the % complete, less what progress invoices billed), time and materials (approved billable hours × the billing rate, plus billable costs × (1 + markup), not billed yet), an advance, or a retention release.
2. Each work invoice holds the project's retention % and recovers the advances in proportion (advances × the work billed ÷ the contract), never more than what is left. Preview shows the figures before you issue. Milestone and progress invoices together never pass the contract.
3. With Books on: a Books tax invoice numbered by Books, with the standard VAT code when the shop charges VAT; payments are Books receipts and the project reads what is paid. Without Books: a charge on the customer's account with the shop's VAT, and payments are recorded on the project's page (cash, bank, card, cheque). Issuing through Books needs Books' own sales right.

More: Billing a project: retention, advances, margin

44.7 Budget, margin, alerts and Ask your shop

• Per project and per phase: the budget, the costs by kind, labour (time × its cost rate), revenue (the work invoices; an advance is not revenue), invoiced, paid, the margin and margin %, the budget used and “over budget”.
• The Projects list: states, search, the totals, late and over-budget counts; the report downloads as CSV or Excel.
• Owner alerts: past its due date, over budget, approved billable time not invoiced for the shop's days (30), retention due after a project is done. Ask your shop: “how are my projects” — active projects with the budget used and the margin, late and over-budget counts, the retention held.

44.8 Fixed assets: switching it on and the categories

1. Settings → Fixed assets (a manager): switch it on — Books must be on first. Choose whether each month runs by itself after the first run (on by default) and the alert days (warranty 30, count 7).
2. Categories: equipment and machines (5 years, straight line), furniture and fittings (7 years), vehicles (5 years, declining balance at 40 % a year), computers and devices (3 years), shop fit-out (5 years). Each has its accounts — asset, accumulated depreciation, depreciation expense, gain or loss on disposal — which you can change; add your own categories.
3. Team → the person → Rights: see assets, manage assets. If Books had assets before, they came over once, “already in the books”, with the same book values; Books' old asset links open these pages.

Plans: Business and Chain, and the trial (it needs Books); listed as an add-on for Shop at 200 EGP a month, usable once Books is there. Online only. More: Fixed assets and depreciation

44.9 Registering an asset, and its label

1. Fixed assets → New asset, one of three tabs: from a Books bill (a bill line booked to a fixed-asset account — the bill already did the purchase and its VAT; one asset per line), paid now (from cash or the bank: the register posts the purchase), or already in the books (with the depreciation booked before and the last month it covers).
2. Name, category, branch and place (a Warehouses location when that module is on), supplier, purchase and in-service dates, cost, salvage value, life in months, method, serial, warranty, notes, a photo. It gets a tag FA-000123.
3. Print the barcode label from the asset's page, or tick several in the register and Print the ticked labels — the product labels' sizes. The money fields change only until the first depreciation is booked; the state (in use, in store, under repair) any time.

44.10 Monthly depreciation

1. Fixed assets → Depreciation: the preview of an ended month — each asset's charge, and the journals per branch and category. The first time you pick the month to start from; the months before it are caught up in it. After that the months go in order.
2. Run: one Books journal per branch, dated the month's last day, with a line pair per category (depreciation expense / accumulated depreciation). A month is never posted twice; a run stopped half way is finished with Finish the run.
3. Straight line spreads cost − salvage over the life; declining balance charges the value at the month's start × the yearly rate ÷ 12, never below the salvage. The first and last months count their days in service. After the first run each next month runs by itself the day after it ends (if that is on); the owner is alerted when a month waits. The register and the schedule export to Excel or CSV.

44.11 Sale or disposal, transfer, revaluation

• Sell or dispose on a day: the depreciation to that day, the asset out of the books, the gain or loss. The money: cash, the bank, a customer invoice through Books, or nothing (scrapped). VAT on a sale is on by default when the shop charges VAT; the tick decides. The asset stays on the register with its history.
• Move to another branch (Chain, two branches or more): a journal moves its balances; the months not run yet depreciate in the new branch.
• Revalue (up) or impair (down) on a day: from the next month the depreciation follows the new value.

44.12 Asset counts by scanning; alerts and Ask

1. Fixed assets → Asset count → New count: a branch, or one place in it. The live assets there are the expected list.
2. Walk round and scan each tag with the phone's camera or a scanner, or type it (FA-000123, fa000123 or 123): found, counted already, from somewhere else, or an unknown code. The sheet shows found, missing, extra and unknown.
3. Close the count with a note (or cancel it). A count changes no asset: it is the list to act on.

Owner alerts: a warranty ending within 30 days, a month's depreciation waiting, a count open over 7 days. Ask your shop: “what is the book value of our assets” — the assets by state, cost, accumulated depreciation, book value, the month waiting, warranties ending soon.

44.13 Buying a module add-on

1. The owner opens Billing → Plan → Add-on modules (or presses Buy the add-on on a module's card in Settings → Modules). Each card: the module, its monthly price, “Included from the … plan”, what it needs, and Buy or Cancel.
2. During the trial it is on at once and billed from the first renewal; on a paid month it is charged for the days left. A module your plan includes is “in your plan”; one below its plan offers Upgrade; one whose needs are missing says what to switch on first.
3. Cancel switches the module off at once; nothing you entered is deleted. A manager switches modules on and off but does not buy. Or ask us on WhatsApp.

Prices, a month: Procurement 300, Warehouses 300, Projects 300 and Fixed assets 200 EGP for Shop; the Front Desk 750 EGP on Business and Chain. Every plan side by side