Help

Getting started

1. Sign up at pynuxapp.com/signup with your business, first outlet, country and a 4-digit till PIN. Confirm your email on the same device.
2. Set up the till. The browser you confirm on becomes till T1. Every extra computer or tablet: open pynuxapp.com/login, sign in with the owner's email, pick the outlet. Each till gets its own secure sign-in, so your password isn't left on shop computers.
3. Add products. Products → New product, or Import CSV with columns name, sku, barcode, category, retail_price, wholesale_price, cost. Moving from another system? Settings → Data → Import brings customers with balances, suppliers and opening stock.
4. Check tax. Settings → Business & tax. Your country sets the rates; tick “registered” only if you charge tax.
5. Make it yours. Settings → Invoices & receipts: logo, colour and the text on invoices, quotations and receipts.
6. Open the register on the Sell screen with your opening cash, and start selling.

Selling at the till

• Scan anywhere on the screen. Type 12* before a barcode to add 12. Search by name if there's no barcode.
• Loyalty: type the customer's mobile number in the box on the bill or the payment screen and press Enter. New numbers become members on the spot.
• Delivery: tap Delivery order on the bill, add the phone and address, then at payment choose On delivery if the driver collects. Track it under Deliveries.
• Promotions apply by themselves. The bill shows the offer name next to the item.
• Wholesale: trade customers get trade prices automatically. Switching a walk-in bill to wholesale needs permission and a reason, and is logged.
• Payments: split between cash, card, transfer, on account, gift card, points and store credit. With BML Connect, choose Transfer to show a QR that confirms by itself.
• Receipts: print, or tap Send to WhatsApp, SMS or email it to the customer.
• Keyboard: F2 search, F4 new bill tab, F9 pay.

Printers, cash drawer, scanners and scales

• Receipt printer: works through the browser print dialog. For one-tap printing and the cash drawer, install the free Pynux Print Agent (Settings → Printing), then enter the printer's IP (for example 192.168.1.50:9100) or pick its name.
• Barcode scanner: any USB or Bluetooth scanner that types like a keyboard. Set it to send Enter after each scan.
• Label printer: Products → Print labels (or Labels in the menu). Choose the label size, then in the print dialog pick the label printer, paper size to match, margins None, scale 100%.
• Weighing scale: Settings → Business → Weighing-scale barcodes on. Choose whether the sticker holds the weight or the price. On each product tick “Sold by weight” and enter the same PLU number as on the scale.

Stock, purchasing and suppliers

• Buying: Purchases → New purchase (or Auto re-order). Approve, then Receive goods. Enter the supplier's bill number, due date and input tax, plus freight and customs to spread into cost.
• What you owe: Purchases → Suppliers & payables shows each supplier's balance and overdue amount. Open a supplier to see the statement and record payments.
• Returns to supplier: from a received purchase tap Return items, or use the Returns tab. Stock comes off and the amount is taken off what you owe.
• Labels for a delivery: on a received purchase tap Labels to print one sticker per unit.
• Counts and transfers: Inventory. Counts post only the differences after approval; transfers go request → approve → send → receive.

Promotions and price changes

Promotions → New promotion. Pick the type (% off, amount off, special price, bundle, buy X get Y), what it applies to, and when (dates, days, happy-hour times). Each item gets the single best offer. Use Pause to stop one early.

Scheduled prices: Promotions → Scheduled prices → Schedule a price. The new price switches on by itself on that date on every till.

Tax

• Maldives: GST 8% and TGST 17% (tourism). Prices usually include GST. Products can be set to TGST or exempt.
• Malaysia: SST is single-stage. Most retailers don't charge it at the till. Turn on “registered” only if you are registered for service tax. Cash bills round to 5 sen.
• Tax return: Reports → Tax return shows output tax by rate, input tax on expenses and on stock (from supplier bills), and the net amount. Always check against your filing form.

Staff, roles and security

• Staff sign in to a till with their own PIN. Settings → Staff to add people; Roles & permissions to decide what each role can do.
• Owner-only actions on a till (paying for the plan, removing a till, payment keys) ask for the owner's password once, and it isn't saved.
• Lost or replaced a computer? Settings → Tills & devices → Remove. It stops syncing straight away.
• Every price, stock and money change is in the Audit log with who and when.

Add-ons

Some modules are paid add-ons so shops that don't need them aren't charged. The first is Repairs & special orders. The owner switches add-ons on in Settings → Plan & billing → Add-ons.

• On the trial: free. When you subscribe, every add-on that's on is included in the payment.
• Mid-month: you pay only for the days left until your plan's renewal date.
• Switching off: nothing is deleted. Existing jobs can still be finished and billed; only new jobs need the add-on.

Accounting export (Xero, QuickBooks)

Reports → Accounting export turns your sales, refunds, account payments, expenses, purchases and supplier payments into a balanced journal: one per day, or every transaction. Download it for Xero (Manual journals → Import), QuickBooks Online (Journal entries import) or as Excel for your accountant. Set your own account codes with Account codes.

API & webhooks

Settings → API & webhooks (owner only). Create a key and send it as Authorization: Bearer pyx_…. Money is in minor units (laari / sen).

• GET /v1/products?updated_since=, GET /v1/stock?store_id=, GET /v1/customers, GET /v1/sales?from=&to= (all take limit up to 500 and offset).
• With a read + write key: PATCH /v1/products/{sku} with retail_price, wholesale_price, cost, name or active; POST /v1/stock/adjust with sku, store_id, qty, note.
• Webhooks post JSON for sales, refunds, new customers and product changes. Verify X-Pynux-Signature: sha256=…, the HMAC-SHA256 of the raw body with your secret.

Troubleshooting

• No internet: keep selling. The sidebar shows how many changes are waiting; they send by themselves when you're back online.
• Something didn't sync: Settings → Data & backup lists items the server refused (for example a plan limit) with the reason.
• Printer prints nothing: check the Print Agent window is open on that computer, then Settings → Printing → Print test page.
• Button greyed out: your role may not have that permission, or a required field is empty. The screen tells you which.
• New version: refresh the page. Tills pick up updates automatically.