.. /* * This file is part of the SavaPage project . * Copyright (c) 2026 Datraverse B.V. * Author: Rijk Ravestein. * * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. * SPDX-License-Identifier: CC-BY-SA-4.0 * * For more information, please contact Datraverse B.V. at this * address: info@datraverse.com */ .. _ch-webapp-pos-config-props: Configuration Properties ------------------------ .. list-table:: Point-of-Sale Configuration Properties :width: 100% :widths: 45 55 :header-rows: 1 * - Configuration property - Description * - financial.pos.sales.enable - Set to ``N`` (default) or ``Y``, to disable/enable the :ref:`Sales ` tab. * - financial.pos.sales.credit-limit.enable - Set to ``Y`` (default) or ``N``, to enable/disable the "financial.pos.sales.credit-limit" amount. * - financial.pos.sales.credit-limit - Credit limit amount applied for all users. Default: ``0.00``. This overrules any individual user credit limit. See :ref:`Financial `. * - financial.pos.sales.card-as-password - Determines if the Swipe Card area is enhanced with a password entry field where the RFID is captured: ``OFF`` (default) \| ``ON`` \| ``AUTO``. The ``AUTO`` value will turn the entry field ``ON`` for mobile devices. |br| |br| Note: This value can be overruled for a POS with a special URL parameter. See :ref:`URL Cheat Sheet `. * - financial.pos.deposit.enable - Set to ``Y`` (default) or ``N``, to enable/disable the :ref:`Deposit ` and :ref:`Receipts ` tab. * - webapp.pos.sound.success - Path to a sound file (mp3, wav, ...) relative to ``/opt/savapage/server/custom/web/`` that is played after a POS transaction finished successfully. * - webapp.pos.sound.failure - Path to a sound file (mp3, wav, ...) relative to ``/opt/savapage/server/custom/web/`` that is played after a POS transaction failed. * - **Sales labels** |br| |br| - * - financial.pos.sales.label.locations - A comma separated list of POS Sales Locations to be applied as sales label prefix. Each location on the list is formatted as ``LOC/location``, where ``LOC`` is a unique N-letter upper-case mnemonic, ``/`` is a fixed separator, ``location`` is a case-sensitive single word used in UI context. |br| |br| For example: ``A/LocationA,B/LocationB,C/LocationC``. If a :ref:`Web Cashier ` selects location ``B``, the sales prefix is ``B``. |br| |br| Note: A POS can be fixed to a Location with a special URL parameter. See :ref:`URL Cheat Sheet `. * - financial.pos.sales.label.locations.enable - Set to ``Y`` or ``N`` (default) to enable/disable "financial.pos.sales.label.locations". * - financial.pos.sales.label.shops - A comma separated list of POS Sales Shops in a Location, to be applied as sales label *after* the location label. Each shop on the list is formatted as ``SHOP/shop``, where ``SHOP`` is a unique N-letter upper-case mnemonic, ``/`` is a fixed separator, and ``shop`` is a case-sensitive single word used in UI context. |br| |br| For example: ``F/Frontdesk,L/Library`` If a :ref:`Web Cashier ` selects shop ``L`` in location ``B``, the sales label is ``B/L``. |br| |br| A shop can be restricted to one or more locations by appending the location mnemonics. For example ``F/Frontdesk/A/C`` restricts the ``F/Frontdesk`` shop to ``A`` and ``C`` locations. |br| |br| Note: A POS can be fixed to a Shop with a special URL parameter. See :ref:`URL Cheat Sheet `. * - financial.pos.sales.label.shops.enable - Set to ``Y`` or ``N`` (default) to enable/disable "financial.pos.sales.label.shops". * - financial.pos.sales.label.items - A comma separated list of POS Sales Items in a Shop to be applied as sales label *after* the shop label. Each item on the list is formatted as ``ITEM/item``, where ``ITEM`` is a unique N-letter upper-case mnemonic, ``/`` is a fixed separator, and ``item`` is a case-sensitive single word used in UI context. |br| |br| For example, ``BK/Book,CA/Cafetaria,HW/Hardware``. If a :ref:`Web Cashier ` selects item ``CA`` in shop ``L`` of location ``B``, the sales label is ``B/L/CA``. |br| |br| An item can be restricted for use with one or more shops by appending the shop mnemonics. E.g. ``BK/Book/F/L`` restricts the ``BK/Book`` item to ``F`` and ``L`` shops. * - financial.pos.sales.label.items.enable - Set to ``Y`` or ``N`` (default) to enable/disable "financial.pos.sales.label.items". * - financial.pos.sales.label.prices - A comma separated list of POS Sales Prices for Items. Each price on the list is formatted as ``PRICE/price``, where ``PRICE`` is a unique N-digit amount in cents, ``/`` is a fixed separator, and ``price`` is the case-sensitive single word price in UI context. Prices are shown as preset choices. |br| |br| For example, ``50/0.50,100/1.00,150/1.50,850/8.50``. |br| |br| A price can be restricted for use with one or more items by appending the item mnemonics. For example, ``850/8.50/BK/HW`` restricts the ``850/8.50`` price to ``BK`` and ``HW`` items. * - financial.pos.sales.label.prices.enable - Set to ``Y`` or ``N`` (default) to enable/disable "financial.pos.sales.label.prices". * - webapp.pos.sales.label.items.button-max - The maximum number of "financial.pos.sales.label.items" that make items show as buttons before a select list is shown. Default: ``7``. * - webapp.pos.sales.label.prices.button-max - The maximum number of "financial.pos.sales.label.prices" that make prices show as buttons before a select list is shown. Default: ``10``. See |RST_LINK_CONFIG_EDITOR| on how to change configuration properties.