Everything, step by step

19Import from Excel, variants, service & VAT, A4 invoice, cashier rights (new in 2.0)

• Start empty, import from Excel: a fresh install has no products. Settings → Products → Export to file (CSV) gives you the template (even empty); fill it in Excel, save as CSV UTF-8 and Import. Existing products (same code, barcode or name) are updated, new ones added, and a blank cell keeps the current value — so a file with just new prices works.
• Variants (boutiques, shoes, phones): name the attributes yourself (suggested: colour, size, flavour, weight, model, material), type the values and generate all combinations. Every variant has its own stock, barcode, price and cost; on the sales screen the product button opens a picker with the stock, and scanning a variant's barcode adds it straight away.
• Service charge & VAT with Egypt's numbers: a one-tap 14% VAT button (editable), VAT either included in the prices or added on top, and an optional service charge (usual 12%) for restaurants and cafés — VAT is computed on goods + service as the Tax Authority does. Both show next to the total before paying, print as separate lines and add up in reports, the Z report and the daily summary.
• A4 invoice: turn it on, pick the A4 printer, and an A4 invoice button appears under the cart and in the receipts list — logo, shop details and tax number, customer, an items table, service/VAT/total due, payment and signature lines; long invoices span pages. Optionally automatic whenever a client is on the sale.
• Rights per cashier: the manager does everything, a cashier sells — and now you can hand a cashier any single right (reports, inventory, edit products, void, returns, credit, expenses, close another shift, exit…) or take a default one away. Whatever they lack still works when the manager types their password on the spot.

20Stock-take, inventory & management from your phone, e-receipts (2.0)

• Stock-take: Inventory → Stock-take. Scan or pick each product, type what is really on the shelf, see expected vs counted and the differences in colour, then Apply — stock is set, the variance is saved and can be printed with its value at cost. Several people can count at once, from the till and from phones.
• Inventory from your phone: the owner portal has an Inventory page — count the stock-take, add or edit any product, receive stock with cost and supplier, and scan barcodes with the phone camera (Chrome on Android over HTTPS; typing the code always works). The till picks the change up within seconds. No barcode reader needed.
• Manage from your phone: a Manage page with reports over any period (totals, by product, category and cashier, every receipt with its lines), credit accounts (who owes what, statements, record a payment) and — with the suppliers feature — expenses and supplier invoices/payments. Every action is recorded with the manager's name.
• Invoice on the receipt printer: no A4 printer? Choose the detailed tax slip: shop tax number, client and their tax number, net, service, VAT, total and a signature line — on the same thermal printer.
• E-receipts (Egyptian Tax Authority): once the shop is enrolled (the USB electronic seal or the tax office does that part), open the taxpayer profile on the ETA portal, choose Register ERP system, type PosMasr and a validity period, and copy the client id and secret it gives you into Settings → E-receipts. Give every product its GS1 or EGS item code (the program lists the missing ones and fills them from barcodes) and switch it on: receipts go to the ETA automatically, queue offline, and print the ETA QR code. No certified device and no signature are needed for receipts.

21Customer display on a second monitor (2.1)

• What it is: a monitor turned towards the customer, like the ones at big fast-food chains. It shows the order as the cashier rings it up — every line with its quantity, price and total, then subtotal, discount, service and VAT when they apply, and the grand total. After payment it shows the amount paid and the change in huge digits (or “paid by card” / “on account”) with a thank-you, and your logo with a welcome message while nothing is being sold. The customer can correct the cashier before the receipt is printed.
• Setting it up: plug any second monitor into the till PC (HDMI, VGA or a USB display adapter), set Windows display mode to Extend (not Duplicate), then Settings → Features → tick Customer display. It opens with the program and fills the second monitor; “Auto” picks the first monitor that is not the main one. With one monitor it opens as a small window so you can see what the customer would see.
• Details: the welcome message is yours to write; the last item added is highlighted; long orders keep the newest lines visible; the screen never takes the keyboard away from the cashier. Gold package or higher.

22Wholesale & retail prices (2.2)

• Switch it on: Settings → Features → Price levels (off by default). The product editor gets a wholesale price field (empty = same price); the Excel import takes a column named price2 or its Arabic name سعر الجملة.
• On the sale: a Retail / Wholesale button under the cart. Tap it before ringing up and the items are priced at the wholesale level; it goes back to retail after every receipt. Items with add-ons keep their price.
• Wholesale clients: tick wholesale client on a client and the cart switches by itself the moment you pick them. The receipt prints “Wholesale prices”.

23Payment QR: InstaPay / wallet (2.2)

• Settings → Features → Payment QR, then Choose picture: save your account's QR from the InstaPay or wallet app as a picture and pick it. Write the caption under it if you like.
• The code shows on the customer display while the order is being rung up, so the customer scans and pays without asking for a number. Tick print the QR on every receipt to have it at the bottom of receipts too.

24Kitchen ticket printer (2.2)

• Instead of, or next to, the kitchen screen: Settings → General → print a kitchen ticket for every order with items to prepare, and pick the kitchen printer (any second thermal printer; “the receipt printer” if you have one). Needs “send orders to the kitchen screen” on.
• The ticket carries the order number, table, time and cashier, and only the items that need preparing, in a big font. It prints with every sale and every “hold” on a table; orders with nothing to cook print nothing.

25Receipt on WhatsApp (2.2)

• The WhatsApp button under the cart (next to Reprint) sends the last receipt as text to the customer's number: the client's number is filled in when the sale is on a client, otherwise type it (01xxxxxxxxx).
• The message has the items, discount, service, VAT, total, paid and change — and the tax authority link when e-receipts are on. WhatsApp (web or the app) opens with the message ready; you just press send.

26A second till in the shop (2.2)

• A second till is a second license at 40% off, and the two PCs talk over the shop's network: one primary keeps the products, stock, clients and the credit ledger; the secondary follows it. Settings → General → “This till is”.
• On the primary: choose “primary” and switch on remote monitoring (the secondary uses the same port). It needs a manager account with a password. On the secondary: choose “secondary”, type the primary's IP and port, a manager name and password, and press Test. After saving it pulls the products, stock and clients every minute.
• Every receipt, void, return, credit payment and new client on the secondary goes to the primary. If the network drops nothing stops: it queues in the secondary and goes through when the network is back. Receipt numbers come from the primary; while it is unreachable the secondary numbers from its own range (2000001, 2000002…).
• Products, receiving and stock-takes are done on the primary or from the phone inventory page (the secondary tells you so). Tables, shifts and the drawer stay per till. Reports on the primary cover both tills; every receipt carries the name of the till that sold it.

27Move the license, new-version notice (2.2)

• New PC: Settings → Tests → License status → Release the license to move it to another PC. Activation ends on the old machine at once and a release code (RL-XXXX-XXXX-XXXX) appears. Send it to us with the new machine's code and you get the new key right away. If the old PC died and there is no release code, a transfer is done on a written declaration, once a year.
• New version: once a day, when a manager is signed in and “tell me when a newer version exists” is on (Settings → General), the program asks our server for the latest version and shows a one-time notice with what is new and a button to the download page. Nothing is downloaded or installed by itself, and selling never stops if the internet is down.

28Updates & portable ZIP (2.2)

• PosMasr-Setup.exe is the normal way to install (section 1). Updating: run the new Setup over the old one; it closes the till, replaces the files and keeps your data in C:\ProgramData\PosMasr\data. Uninstalling from Windows removes the program only, never the data.
• Portable ZIP (USB stick, no admin rights): extract the PosMasr folder to a permanent folder such as C:\PosMasr — not inside Program Files — run Create Shortcut.cmd once (desktop shortcut, optional auto-start), and open the program; the data folder is created next to it. Never run it from inside the ZIP: Windows opens it from a temporary folder that is deleted on close, and your sales with it — the program warns you if that happens.

29Import from an old copy (2.3)

Installed the new version next to an older PosMasr (or CSG POS) copy where products and prices were added meanwhile? Bring them over instead of typing them again.

• Where: Settings → Products → Import from an old copy. The window lists every old copy it finds on the PC by itself (the usual folders on every drive, both program names under ProgramData, the desktop, documents, downloads, and their backups) with the number of products and the last change. Not listed? Browse… and pick the old copy's products.txt (inside its data folder).
• What comes over: any version since 1.0. A product that already exists (same barcode, or the same name; a variant by its master and label) gets its prices updated (sell, cost, sale, wholesale) and any blank field filled (barcode, description, add-ons, unit, tax code, picture). A product you don't have is added with its category. Two more options, off by default: bring stock and expiry dates, and include hidden products.
• Before you press Import the line at the bottom tells you exactly what will happen: how many new, how many price updates, how many unchanged — and nothing else is touched: your categories, cashiers, settings and sales history stay as they are. The old copy is only read, never modified.

30Keyboard shortcuts (3.0)

Most tills have no mouse — so the whole program works from the keyboard. On any screen press F1 (or the ? button) for the list of that screen's keys, and every button shows its key in small muted text in its corner. The barcode scanner keeps working as before: it types the code and sends Enter.

Sales screen:

• F2 jump to the search / barcode box · F3 pay cash · F4 card · F5 on credit.
• F6 hold the cart on a table (with an empty cart: the tables list) · F7 discount · F8 returns (opens the receipts list in Reports) — each when its feature is on.
• F9 reports · F10 settings · F11 reprint last · F12 open the drawer · Ctrl+L switch cashier · Ctrl+K kitchen screen.
• In the cart: ↑ ↓ move between the lines, + / − quantity ±1, * then a number = type the quantity, Delete removes the line, Esc clears the whole cart (it asks first).
• Enter with the search box empty = pay cash (with a code typed: add the item) · PgUp / PgDn (or Ctrl+← / Ctrl+→) previous / next category.

The other screens:

• Login: ↑ ↓ pick the cashier, Enter goes to the password then signs in. Number pad and messages: digits, Backspace, Enter = OK / yes, Esc = cancel / no.
• Reports: Ctrl+1…6 the tabs, Ctrl+P print the selected receipt, Ctrl+E export CSV, F8 return. Inventory: Ctrl+F the scan box, Enter opens the row, Ctrl+R receive stock, Ctrl+1…3 the tabs.
• Credit accounts: Enter statement, Ctrl+M record a payment, Ctrl+P print the balances, Ctrl+N new customer. Suppliers & clients: Ctrl+N add, Enter opens the row, Ctrl+1 / Ctrl+2 the tabs. Stock-take: Ctrl+F the scan box, Enter count the selected item, Ctrl+P print.
• Kitchen screen: 1…9 or ↑ ↓ pick an order (← → jump between the columns), Enter moves it on: start → ready → picked up. Esc closes any screen.

31Managing products: categories, filter, bulk actions (3.0)

A few hundred products? The Products tab (Settings → Products) now has a search box and a filter above the list, a categories dialog, multi-select with bulk actions, and it refuses a second product with the same barcode or name.

• Search & filter: type in the box and the list narrows as you type (name, barcode, category, description). The drop-down next to it filters: no barcode, no price, no cost, hidden / visible, tracked stock, low stock, expiring, no picture, variants only, duplicate barcode / duplicate name — and a second drop-down picks one category. The header shows N of M. Esc clears everything.
• Categories button: every category with its product count. Rename (every product in it follows; a built-in name like Beverages keeps its translation, or type any name of your own), Merge into… another category (the old one disappears), Delete (its products move to General or a category you pick) and ▲ / ▼ to order them the way the sales screen shows them.
• Bulk actions: select several rows (Ctrl or Shift with the click, Ctrl+A for all) and press Bulk actions: move to a category, show / hide, needs cooking on / off, change the price by ± % or ± amount rounded to 0.25 / 0.5 / 1 (an example line shows the result before you apply), wholesale price = retail ± % (when price levels are on), and delete. Every action asks with the count and saves once. Variants follow their master.
• No duplicates: saving a product whose barcode is already on another product, or whose name matches another one (ignoring case, spaces and diacritics), is refused — the message names the other product and offers to open it. Excel import and the old-copy importer skip such rows and list them instead of silently creating a second product. Use the duplicate barcode / duplicate name filter once to clean older data with the bulk delete.
• Keyboard: Ctrl+F search box, Esc clear, Enter open the selected product, Delete delete, Ctrl+A select all, Ctrl+N new product. The ? button next to the search box lists them.