Point of sale (POS)

Mosce ERP's POS is designed to sell fast: one screen with the catalog on the left, cart on the right, an always-active barcode scanner, and collection in one or several methods in seconds.

Reading time: ~7 min

When to use this

Use the POS for counter sales where the client pays instantly: store, pharmacy, hardware store, restaurant. The POS:

• Creates an order and invoice in a single action.
• Deducts stock automatically.
• Assigns the e-CF number.
• Lets you split the payment across cash, card, transfer, etc.
• Works on an open register session: each sale is recorded in the active session.

For credit sales or sales with a prior approval flow, use Operations → Orders.

Before you start

• You need at least one cash register created (see Cash register).
• There must be an open register session, or you have permission to open it when entering the POS.
• Products loaded with price, ITBIS, and stock per warehouse.
• Permissions: pos:operate, cash_sessions:open (if you are going to open a session).
• Complete tax configuration with active e-CF sequences for the types you are going to issue (at least E32 for the final consumer).

Step by step

1. Open the POS

1. Press Point of sale in the sidebar.
2. If there is no open session for your user, you will see the Select a register dialog:
   • Choose the register where you are going to work.
   • Enter the opening amount (cash in the drawer).
   • Press Open session.
3. If there is already an open session, you go directly into the POS.

2. Add products

Three ways, all working at the same time:

• Barcode scanner: scan the code. The product is added to the cart and adds quantity if it was already there.
• Manual search: type in the search bar. Filters by name or SKU as you type.
• Click on a card: tap the product card in the grid. Filter by category with the chips at the top.

If a product is out of stock you will see the Out of stock badge on the card. The system blocks adding more quantity than is available.

3. Adjust the cart

In the right-hand Cart panel:

• Press + or − to change the quantity per line.
• Tap the trash icon to remove the line.
• The subtotal, ITBIS, and total recalculate live.

4. Link a client (optional)

Press Client in the cart panel:

• Search client: type name, ID, or RNC. Select an existing one.
• Counter client: enter a free-text name that will appear on the voucher (without saving it in the client base).
• Remove client: return to a sale with no assigned client.

If you are going to issue a Fiscal Credit (E31) you must link a client with an RNC.

Special Regime (E44) client: when linking a client whose default voucher is Special Regime (E44), the cart adjusts automatically: all lines become ITBIS-exempt (total ITBIS at RD$0) and the unit price is recalculated from cost with the client's alternative margin (price = cost × (1 + margin/100); without a cost the normal sale price is used, never RD$0). If you change or remove the client, the lines return to their normal sale price with their ITBIS. See Special Regime (E44).

5. Collect

Press Collect. The payment modal opens:

1. Voucher type: choose the e-CF type (default E32 - Consumer). If the linked client has a default voucher configured (of any type, including E44), the selector appears fixed and non-editable, with the note "Set by the client". To issue another type, remove the client or edit their default voucher from Operations → Clients.
2. Payment methods: one or several rows. The first brings the total in Cash.
   • Change the method (Cash, Card, Transfer, Check, Credit Note, Other).
   • Adjust the amount. The bottom bar shows Paid and Remaining.
   • Press Add method to split the payment.
3. Cash received (optional): on Cash rows, enter what the client handed over. The system calculates the change automatically.
4. Collect: enabled when Remaining = 0. If you were paid more in cash, the rest is considered change.

On confirmation:

• The order and the invoice are created.
• The e-CF number is assigned.
• Stock is deducted (processed in a queue; you will see a toast with the status).
• The cart is cleared and you return to sale mode.

6. Collect pending orders

If a salesperson sent an order to the POS from the Orders screen, it will appear in the Pending tab of the POS. Tap the pending order, review the items in the cart (they come pre-loaded, not editable), and press Collect. The payment flow is the same, without a voucher type selector (it already comes from the order).

7. Print/send receipt

After collecting, in the detail of the just-created order (accessible from Operations → Orders) you can press Print receipt to open it in a new tab. From there you print it with Ctrl/Cmd + P or save it as a PDF to send to the client.

8. Close the POS

Press Close POS in the header to return to the main panel. The register session stays open and you keep all the context: when you come back you will keep selling in the same session until you explicitly close it from Cash register.

How taxes are calculated

The POS calculates ITBIS (and ISC if applicable) in real time for each cart line, using the rate configured on the product. The subtotal, ITBIS, and total you see in the cart panel reflect that live calculation.

To understand which rate applies to each product, how to declare exemptions, or how to configure ISC products, see ITBIS and other taxes.

Shortcuts and tips

• The barcode scanner works even if the focus is not on the search bar - Mosce ERP captures the fast input automatically.
• Out-of-stock products are shown in gray and cannot be added.
• In the header bar you always see the active register and a link to View session to go to the details without losing the cart.
• Pending orders appear in real time (without reloading) thanks to the POS event channel.

Expected result

• Each POS sale generates a Paid order, an invoice with its e-CF, and a register movement on the correct side (cash / card / etc. inflow).
• Stock is decremented according to the warehouse configured on the product.
• If you have the Accounting module, the sale entry is generated automatically.
• In Cash register → Active session you see the sale reflected instantly in automatic payments.

Common errors

Related

• Cash register
• Orders
• Invoices
• Products
• Fiscal configuration
• ITBIS and other taxes