Fieldpine Logo Documentation Home  

POS Symbols

Symbols are used to display text on screens, receipts and other areas. When the POS detects a symbol it dynamically replaces the symbol with the current value. This permits you to define receipt formats etc that vary dynamically from moment to moment.

The following list includes version information of when a symbol was added or changed. These lines appear like (P1797) This symbol .... The P1797 indentifies the version number. If no version number is supplied, then the symbol has been present for a long period and should be in all current versions.

Jump to: Receipt Symbols

Generally Available Symbols

Inserts the relevant Teller name. There are several names present for a teller/staff member and you can control which name is used. For security and privacy reasons we recommend making the printed name unique and friendly, but do not use full names that could allow staff to be located outside the store.

The name is selected using the following rules:

  1. (P1797) If the field "nameprinted" exists in the staff definition AND this value is not blank, this value is used.
  2. (P1800) The setting TellerPrintSearch can be defined to a comma seperated list of field names. The system will scan each of these fields in order and use the first non blank value found. This permits you to define a list of preferred fields, but not enforce data capture in every field. For example:


    Current Tellers values:

    The value printed will be "Louise", as the first search field, nickname, is blank but the second search field, firstname, has a value.

  3. The name is taken from the "name" field in the staff definition.
(P1812) Insert text describing the current phase of the sale, ie whether is is complete, in progress etc. This symbol can be useful for receipts that are printed as job dockets, or layby slips, that are later upgraded to normal sales. This symbol correctly decodes for reprinted historic sales.
(July 2014, P1811)The total amount of payments that have been directly allocated to this particular saleline. Some systems can be configured to allocate payments to specific items over others, and this symbol returns that amount for each item. Payment allocation is an advanced feature and not present in all configurations.
The current system date. This value should not normally be used on receipts, as this will result in the current time being used for the sale, rather than the original time the sale was made.
The current system time
Returns the current computer name, taken from the setting HostName, gethostname() or GetComputerName() processed in that order until a valid response is found.
The time of the sale
The date of the sale
Draws a single pixel high horizontal line. Only used on receipt printers to generate ruled lines.
The total amount of change owing.
Total amount outstanding on the sale, after rounding. This is typically the cash payment amount still due.
The total value of the sale
Total amount tendered for this sale from all sources.
The active teller for this sale.
Displays the next action that will be undone for this sale, if the sale(undo) command is given.
Inserts the GST number on this sale. Use of this symbol is not recommended
The total amount of GST in this sale for countries that have a single rate of product taxation.
Not documented at this time
When a line length is known, this symbol inserts as many spaces as required to completely fill the line to the width. If the line length is unknown, or the line is already longer than the length, this symbol does nothing.
If the line contains only static text and totals that evaluate to zero, this symbol causes the complete line to be blanked, and where possible, not output.
Blank this line, if the current sale being processed does not have any discounts (line or sale discounts) present. This option is commonly used on receipts to provide different total formats for discounted and non discounted sales.(Implemented: V2.4.4.29)
The reverse of BLANKNODISCOUNT described above. Blank this line if the current sale has discounts present.

%BLANKNODISCOUNT%Gross Sale Total%%salevalue(0,9)%

The above example shows how a different line can be printed depending on whether the current sale has discounts present or not. Only one of the two lines above will actually cause output on the customer receipt.

Inserts the single ASCII character given by nnn. This must be exactly three decimal digits.
The total value of the Nth completed sale in history. N must range from 0 (last sale completed) to 4 (being the 5th oldest sale completed). This symbol is used for display on operator screen as a reminder of the value of the last sale.
The current name of the store location being used. Useful for printing on End of Day sheets and when using a Head Office Server.
The current screen name. If the screen is a variant screen, then the variant name is used. This symbol is most useful when creating programmable buttons on variant menu screens.
The current RID value on the system.
The filename of the database in use
The requested working directory
The working directory in use
Virus detected code
The first licence code registered, which is typically the active licence
Current SystemId code
The allocated unique identification number
The CPU serial number. This setting is deprecated and may be removed in a future release
Reserved to Fieldpine
Reserved to Fieldpine
The database id that uniquely identifies the database being used. Warning, may not be the true dbid. Use this symbol with caution
The short version of the POS. This value is less useful now as Fieldpine version has moved to using a single "Patch Level" called PLevel, and the version reported by this symbol rarely changes.
The extended version string, including the P level as the last part of the string
Licence expiry date, if present
Date/Time the POS was started
Version of the UI in use
A site specific version. This value is reserved for customer sites.
The HTTP port this port is listening on
Server protocol in use
Comma seperated list of all HTTP ports in use
Full IP and Port of the POS
Return the environment variable xyz. For example pos.environment.SystemRoot returns the environment variable SystemRoot
Access System physical attributes. eg pos.cpu.pctype for type of computer and pos.cpu.uuid for BIOS id. This setting is intended for support purposes rather than general use.
Inserts the value of the message given by G.M from the message file. The message is fetched from the language file for the current teller. This means the message can be language/teller dependant.
Total value of sale
Total amount of sale still to be paid
Total amount of sale still to be paid, if paying in cash. That is, the amount is rounded according to current rounding rules.
Total value of sale when rounded for cash
Total value of sale, excluding any items not eligible for discounts
Total value of sale, excluding items not eligible for discounts, and less any discounts currently applied
Total discounts on the sale, both line and sale discounts
Total raw price from salelines, ie excluding all discounts
The difference between rawprice and totalprice
Total amount of item discounts
Total amount of sale discounts
Total amount of sale, less line and sale discounts. Since sale discounts are treated as payments, this figure will be after sale discounts have been applied, and will not equal the total amount of physical payments (such as cash).
Total price exclusive of tax, 0 on systems that are tax inclusive.
Sub total, like 0.0 but without tax on tax systems which are tax exclusive
Total effect of store wide markdowns
Total of reward gaining products
(Dec 2011, P1680) Total of lines where price is still the original listed retail price
(June 2014, P1804) Total lines ex tax, where possible to calculate. This value cannot be calculated in every environment, especially those with conditional tax rules.
Total discounts on lines
- total sale, but adjusted to show any surcharge still pending
- total amount to pay by fee types (typically credit card)
Total of Tax Amount #0

Receipt Symbols

These symbols can be used in receipt formats

(P1836) Individual Item Price. There are several prices maintained internally and the following table outlines which symbols can be used to extract the individual price components.
Ticket PriceUnit/Base PriceTotal Price
In Delta Out In Delta Out In Delta Out
Including all taxes price.360 price.330 price.325 price.350 price.320 price.365 price.355 price.335 or price.205
Tax #1 only price.361 price.331 price.326 price.351 price.321 price.366 price.356 price.336
Tax #2 only price.362 price.332 price.327 price.352 price.322 price.367 price.357 price.337
Tax #3 only price.363 price.333 price.328 price.353 price.323 price.368 price.358 price.338
Excluding taxes price.364 price.334 price.329 price.354 price.324 price.369 price.359 price.339

For example, to retrieve the value of Tax#1 which is the primary tax in most areas, use symbol sl(price.321)

Ruled Lines
Inserts a ruled line. With version P1857 you can extend this rule line to specify width, style and color. The syntax for specifying a complex ruled line is %RULEwidth,style,color% where width is a number, style is "solid", "dot" or "dash". Color is defined using 3 RGB triples or simple color names