Features

• Instant SGR line in the cart — an OWL override of addLineToCurrentOrder appends the SGR child line as soon as the cashier adds a beverage with an sgr_product_id, before any sync. Quantity changes on the parent propagate to the child.
• Server-side safety net — pos.order.line._sync_sgr_lines runs the same logic on order persistence, so orders synced from offline mode still get the SGR companion and any orphan sibling is adopted via sgr_parent_line_id.
• SGR Return cashier button — a new entry in the more actions popup of the product screen opens a dedicated SGR return modal listing all five categories with live total refund calculation.
• Refund method tracking — the popup forces the cashier to pick Cash / Voucher / Bank Transfer; the choice is persisted on pos.order.sgr_refund_method for audit and exposed to the POS UI via _load_pos_data_fields.
• Stock routing to SGR Returns — _create_picking_from_pos_order_lines splits negative SGR lines into their own picking from the Customers location to the warehouse's sgr_return_location_id, leaving regular POS stock untouched.
• Per-POS opt-out — pos.config.sgr_auto_lines lets you disable auto-add on a specific terminal (e.g. a non-beverage POS); the SGR Return button stays available either way because it is an explicit cashier action.
• Invoice propagation — is_sgr_line is carried through _get_invoice_lines_values so that invoicing a POS order does not duplicate the SGR line when nexterp_sgr_account is also installed.

Configuration

1. Warehouse SGR Return Location

The base module's SGR Return Location on the warehouse used by the POS must be configured. Open the warehouse under Inventory → Configuration → Warehouses and either pick an existing internal sub-location for empties or let the base module create the default SGR Returns location for you on save.

Without this location, the negative-SGR stock routing falls back to the regular POS stock destination — empties get mixed with sales stock, which breaks the SGR Position and Stock & Movements reports.

2. Warehouse SGR Collection Type

On the same warehouse form, set SGR Collection Type to:

• RVM (Automated) — automatic reverse vending machine.
• Manual — most common for a till-counter return point.
• HoReCa — restaurants, bars, cafés.

The collection type drives which handling-fee tariff (TG) RetuRO will pay you back for the empties collected at this site.

3. Per-POS opt-out

Open each Point of Sale under Point of Sale → Configuration → Point of Sale, switch to the Configuration tab and find the SGR group. The Auto-add SGR Lines toggle defaults from the company setting.

• Keep it on for terminals that sell beverages subject to SGR.
• Turn it off for terminals that don't sell SGR-bearing products (e.g. a service desk POS) — the SGR Return button stays available so consumers can still drop off empties there.

4. Permissions

POS users get read-only access to nexterp.sgr.category so that the SGR Return popup can list the five categories. No further configuration is required.

5. Receipt template

The SGR child line is rendered as a regular cart line, so it appears on the receipt with no extra template work. If you customize the receipt, make sure your override forwards lines flagged is_sgr_line through to the print.

How it works

Cashier flow: selling a beverage

1. The cashier scans or taps a beverage product with an sgr_product_id configured.
2. The cart immediately shows two lines: the beverage at its sale price and the SGR companion (e.g. SGR Glass Small) at the deposit rate effective today.
3. Adjusting the beverage quantity propagates to the SGR line in real time. Removing the beverage removes the SGR line.
4. Payment proceeds normally; the receipt shows both lines.

Cashier flow: accepting empty packaging

1. A consumer arrives with empty bottles or cans.
2. The cashier opens the more actions menu on the product screen and taps SGR Return.
3. A popup lists the five SGR categories — Plastic Small/Large, Metal, Glass Small/Large — each with a quantity input.
4. The cashier enters the quantities; Total Refund updates live.
5. The cashier picks the refund method:
   • Cash — subtracted from the next payment.
   • Voucher — recorded on the order for later voucher issuance.
   • Bank Transfer — recorded for off-line settlement.
6. Confirm. Negative SGR lines are appended to the cart and the order total drops by the refund amount.

What happens on order close

• Positive SGR lines (the deposit on sold beverages) follow the regular POS picking out to the Customers location.
• Negative SGR lines (empties received) are split into a dedicated picking from Customers to the warehouse's SGR Returns location, validated automatically.
• The refund method is persisted on pos.order.sgr_refund_method so the accounting team can reconcile cash drawer counts and vouchers issued at the end of the shift.

After a few POS days, check Inventory → Reports → SGR:

• SGR Stock & Movements should show the in_customer direction populated for the returns at the configured collection type.
• SGR Position — Qty In Returns reflects what's collected but not yet handed over to RetuRO.

Versions

19.0.1.0.0 (2026-05-25)

• Changelog tracking starts at this release.