The OSERP Android app

The OSERP app runs your whole OSERP on an Android device: POS terminals, tablets and phones. The POS is the first screen it is built around. What the app adds over a web browser is printing:

• receipts go straight to the receipt printer, with no print dialog and no "Save as PDF";
• the cash drawer opens on a cash sale;
• barcode labels print on a label printer;
• invoices and reports go to an office printer.

What is available today

Android devices (Android 7 and later). The app is installed from a download link, not yet from the Play Store. Receipt, label and office printers connect by USB, network, Bluetooth or a serial COM port.

1. What the app is

1. It opens your own OSERP. The screens, your data and your settings are exactly those of OSERP in a browser. Nothing is stored in the app except the OSERP address and the printer setup of this device.
2. OSERP updates reach the app by themselves. When your OSERP is updated, the app shows the new version the next time a screen opens. There is nothing to reinstall.
3. The app itself updates rarely. A new app is needed only when printing or device support improves. The app checks once a day and offers Update, Later or Skip this version. Your sales and settings are kept.

2. Install the app

1. On the device, open the download link your OSERP administrator or OSERP support gave you. The file is named OSERP-<version>.apk.
2. When Android asks, allow your browser or file manager to install unknown apps. This is needed because the app is not installed from the Play Store.
3. Open the downloaded file and select Install.
4. Open OSERP.

3. Connect to your OSERP

1. On first launch the app shows Connect to your OSERP.
2. Enter your OSERP address, the address you use in a browser without https:// (for example oserp.yourshop.com).
3. The app checks that the address is an OSERP and saves it on this device.
4. Sign in as you do in a browser.

To connect this device to a different OSERP later, open printer setup (section 4) and select Change OSERP address.

4. Set up printers

Each device keeps one printer per job:

Job	What prints there	Usual printer
Receipt	POS receipts; opens the cash drawer	Thermal receipt printer, 58 or 80 mm
Label	Barcode and shelf labels	Label printer (TSC, TVS, Zebra and compatibles)
Document	Invoices, statements, reports	Office printer, through Android printing

A job with no printer set up still prints, through the Android print dialog.

Open printer setup

In the POS, open Exit and find App printer. It shows the receipt printer this device uses, or Not set up. Select Printer setup. Then choose the job at the top: Receipt, Label or Document.

Choose how the printer is connected

Connection	What to do
USB cable	Plug the printer in and switch it on, then choose it from the list. Android asks once to let OSERP use it: allow it.
Network (LAN / Wi-Fi)	Enter the printer's IP address. It is usually printed on the printer's self-test page.
Bluetooth	First pair the printer in Android Settings > Bluetooth, then choose it from the list.
Serial COM port	Choose the port and set Port speed to the printer's speed, commonly 9600 or 115200. A port marked not writable by apps cannot be used; connect the printer by USB or network instead.
Android printing	For office printers. Android's own printing service, or the printer maker's print plugin from the Play Store, must be installed.

Paper and printer settings

• Receipt: the paper width (58 or 80 mm) and Resolution (203 dpi for nearly all receipt printers). Tick Cut the paper after each receipt if the printer has a cutter. Tick A cash drawer is plugged into this printer if it has a drawer; the drawer then opens on sales paid in cash.
• Label:
  • the Printer language: TSPL for TSC and TVS label printers, ZPL for Zebra;
  • the label Width and Label height in mm;
  • the Gap between labels. The label size must match the labels loaded in the printer.
• Name shown in OSERP is optional, for example Counter 1 receipts.

Select Save, then Test print. The test page prints a black bar and a line of Arabic. If both are sharp and the full width of the paper, the printer is set up. If the page is pale, choose Dark or Darkest in the density list beside the printer in the POS Exit menu.

5. Example: a TVS TP 415CA POS terminal

The TP 415CA is a 15.6-inch Android POS terminal with no printer of its own. The receipt printer is connected to one of its ports.

1. Install the app and connect it to your OSERP (sections 2 and 3).
2. In Printer setup > Receipt, choose the connection that matches the printer's cable:
   • USB cable: the most reliable choice. Choose the printer from the list and allow OSERP when Android asks.
   • Network: if the printer is on the shop's LAN, enter its IP address.
   • Serial COM port: if the printer uses the terminal's COM port, try the listed ports with the printer's port speed, then use Test print to find the right one.
3. Set the paper width (usually 80 mm), tick the cutter and the cash drawer if present, Save, and Test print.
4. Make a small cash sale in the POS. The receipt prints with no dialog and the drawer opens.

6. When something does not print

What you see	What to check
The Android print dialog opens instead of printing	No printer is set up for that job on this device. Open Printer setup and set one.
Printer did not answer on USB	The cable, the printer's power, and that the printer is chosen again after it was unplugged.
A network printer does not answer	The device and the printer are on the same network; the IP address has not changed.
A Bluetooth printer is not listed	Pair it first in Android Settings > Bluetooth.
Garbled characters instead of a receipt	The COM port speed does not match the printer; try the other common speed.
Labels print across two labels	The label height or gap does not match the labels in the printer.
The receipt is pale	Choose Dark or Darkest in the density list beside the printer in the POS Exit menu.

Printer setup belongs to the device, not to the user. Every cashier who signs in on the same device uses the same printers.