Show TOC

Background documentationPrinting-Related Parameters

 

Parameters for gift receipts

The options in this section customize the information printed on gift receipts.

GIFTRCTENCRYPT

Function

Defines the encryption code used to hide prices that are printed on gift receipts. The number 0 in the price is changed to the first character in the code, the number 1 is changed to the second character, the number 2 is changed to the third character, and so forth.

For example, the price 15.99 is printed on the gift receipt as 2600 if you keep the option’s default value. The code can also be an alphabetic string, so the price is converted into letters.

Possible values

Enabled: enter an alphanumeric string using up to 9 characters.

Disabled: enter comment marks to prevent encryption of the price before it is printed.

Default value

1234567890

INVALIDCARDAUTHRECPRTAFTERTOTAL

Function

Determines if all declined authorization records are printed after a transaction TOTAL.

Possible values

Y - yes, all declined authorization records are printed after TOTAL.

N - no, all declined authorization records are not printed after TOTAL.

Default value

Y

MASKCARDNUMINJRN

Function

This option, if enabled, will mask Credit Card Numbers printed to the Journal.

Possible values

Y- yes, mask the credit card number printed to the Journal.

N- no, do not mask the credit card number printed to the Journal.

Default value

N

NETPRICE4GIFTRCT

Function

Prints only the net price of an item on a gift receipt instead of printing the full price and discounts that are applied to the item.

Possible values

Y - yes, print the net price on a gift receipt.

N - no, print the full price and any discounts that are applied.

Default value

Y

ONEGIFTRECEIPT

Function

When multiple items are selected for a gift receipt, this option allows all the selected items to be printed onto a single Gift Receipt.

Possible values

Y- yes, print all selected items onto a single gift receipt.

N - no, print each selected item onto its own gift receipt.

Default value

N

PRINTTENDERDOCONLYWHENREISSUED

Function

This option allows the selection of tenders that will print a tender document for reissues.

Possible values

Tender IDs from 1...40 (for example, PRINTTENDERDOCONLYWHENREISSUED= 1,3,7 will set tender IDs 1,3, and 7 to print a Tender Document when these tenders are used as Reissues).

Default value

0 (no tenders selected).

PRTREFUNDAUTHMSG

Function

If a refund is declined or overridden, setting this option to “Y” will cause the POS to print a status message to the store receipt copy. These messages are dictated by the literals, REFUND DECLINED and REFUND APPROVED WITH OVERRIDE.

Possible values

Y- yes, to configure the POS to print Refund Authorization status message to the Store Copy of the receipt.

N - no, to not have the POS print any Refund Authorization status message to the Store Copy of the receipt.

Default value

N

PRTTENDERCURRENCY

Function

If enabled, this option will print a tender’s Currency Code (found in the Configurator) when printing the tender amount.

Possible values

Y- yes, print the tender currency description

N - no, do not print the tender currency description

Default value

N

TENDONGIFTRCT

Function

Prints the total and tender information in addition to the price on a gift receipt.

Possible values

Y - yes, print the total and tender information on a gift receipt.

N - no, do not print the total and tender information on a gift receipt.

Default value

N

Full detail printing on tender receipt parameters

These settings are required to enable the Full Detailed Tender Copy option and make the Point-of-Sale application print item details on the tender receipt.

You can find the Full Detailed Tender Copy option at the following menu path in the Configurator application: Start of the navigation path Transaction Functions Next navigation step Tender Next navigation step Tender Setup Next navigation step Tender Search (look for an existing tender configuration or create a new one) Next navigation step Tender Maintenance — Print Options. End of the navigation path

MEXTDRRCT

Function

Print the Mexico Fixed Format Tender Receipt (an old option developed for the company called Gigante). This receipt is to be used only for Credit card transactions with authorization records.

Possible values

Y - yes, enabled

N - no, disabled

Default value

N

MEXTDRRCTCOPIES

Function

Used with conjunction with MEXTDRRCT, it specifies how many copies of the Mexico Fixed Format Tender Receipt to print.

Possible value

A number greater than zero.

Default value

1

Remote printing-specific parameters

The options in this section define remote line printers and when they are used. These options are only applicable to DOS servers. If you are not using a DOS server, disable these options with comment marks.

DEPTREMPRN

Function

Sets up departments so that transactions involving items from these departments are printed on a remote printer. You can either print the entire transaction when the cashier enters an item from the department you specify, or you can print just that item’s line. You must set up the department in the Department/Class Maintenance window in the Configurator. You must set up remote printers using the REMPRN option before you can use this option. Add a copy of this option for each department you want to set up.

Possible values

Format: DEPTNUM,PRNNUM,PRNTXN

Enabled:

DEPTNUM - enter the department ID number.

PRNNUM - enter the remote printer’s number (a number between 1-99).

PRNTXN - enter Y to print the complete transaction on the remote printer. Enter N to print only the item that belongs to the department specified in the DEPTNUM entry on the remote printer.

Disabled: enter comment marks.

Default value

Disabled

REMPRN

Function

Sets up remote line printers that are connected to the server. Add a copy of this option for each printer you want to set up.

Possible values

Format: PRNNUM,PRNDESC,DEV,PORTTYPE,PROTNUM,BAUDRATE,PARITY

Enabled:

PRNNUM - enter the remote printer’s number (1-99) from the printer’s settings.

PRNDESC - enter the description of the printer as it appears in the Back Office printer configuration file (printer.def).

DEV - enter 0 (this is the only possible entry).

PORTTYPE - enter 1 for a serial port, or 2 for a parallel port.

PORTNUM - enter the serial or parallel port number.

BAUDRATE - enter the printer’s baud rate.

PARITY - enter one of the following numbers:

0 - no parity and 8 data bits

1 - odd parity and 7 data bits

2 - even parity and 7 data bits

Disabled: enter comment marks.

Default value

Disabled

EFT User Exit printing parameters

PRINTWITHNONMERCHAUTH

Function

Allows the non-merchandise authorization details, received from the EFT User Exit, to be printed inside the Store or on the Customer receipt if it is activated.

Possible values

Y - yes, the non-merchandise authorization information from the EFT User Exit will be printed inside the Store or on the Customer receipt if it is activated.

N - no, the non-merchandise authorization information from the EFT User Exit will be printed on a different receipt.

Default value

N

Printing parameters

You can configure the POS to print a document such as an invoice or an order pick-up summary on a remote, network, or laser printer using 8 1/2 x 11 paper. Once defined, this function can be launched at the POS through Manager Code 429. To configure the POS to handle remote printing, do the following:

  • In the POS.ini configure the THRESHOLDPROFILE parameter according to specifications provided below

  • Using one of the defined layout files (layout1 or layout2), create a layout file to specify the information to be printed and how it should be printed

  • In the Configurator, configure an auto-reference definition to produce a 10-digit reference number for each printed document.

THRESHOLDPROFILE

This parameter supports the transportation permit printing function but is also used to configure any type of POS-triggered document printing such as an invoice on a network or remote printer. To activate the remote printing function, the THRESHOLDPROFILE parameter must be defined in the POS.ini as follows. A description of each field is provided in the table below:

THRESHOLDPROFILE= 11,2,1,3000.45,1,0,0,1,20,1,2,190

You can also define more than one instance of the THRESHOLDPROFILE for varying scenarios. In the following example, the parameter shows a different value for field 2, which defines the Inclusion/Exclusion definition. Remote printing is therefore defined for two distinct Inclusion/Exclusion scenarios.

THRESHOLDPROFILE= 11,2,1,1000.34,0,2,1, 1,20,1,2,598,599

THRESHOLDPROFILE= 11,3,1,1000.34,0,2,1, 1,20,1,2,598,599

The following table provides a definition of each field in the THRESHOLDPROFILE parameter.

Field

Field Description and Function

Possible Values

field 1

Profile ID

0 - No Profile ID

1 - Profile ID value

field 2

Inclusion/Exclusion rules ID

0 - No Inclusion/Exclusion rule

1 - Value assigned to rule definition

field 3

Accumulation Mode

1 - Calculate total size

2 - Calculate total items

3 - Calculate total Sale value

field 4

Threshold Amount

0 - No Threshold Amount

1 - Value of Threshold Amount

field 5

Profile prompt printing location

0 - Do not print

1 - Print on POS receipt printer

2 - Print on remote network printer

field 6

Number of layout1 documents to print on the remote or network printer. For information on the structure of the layout1 file, see THRESHOLDPROFILE layoutx.txt file tags.

0 - Do not print

1 - Print one copy

2 - Print two copies

x - Print x copies

field 7

Number of layout2 documents to print on the remote or network printer.

0 - Do not print

1 - Print one copy

2 - Print two copies

x - Print x copies

field 8

Auto-reference number ID. Used for the generation of a reference number.

Value assigned to auto reference definition.

field 9

Refund % of total sale value (maximum 2 decimals).

Percentage Refund.

field 10

Font ID.

The ID for the font to use.

field 11

Item Grouping Method.

The item grouping method to use.

field 12

Manager Code ID.

You can define more than one manager code. Use a comma between the manager code values.

0 - The default. Indicates that no page number is to be printed on the permit.

PRINTPAGENUMONPERMIT

This option determines whether or not to print page numbers on Permits.

1 - indicates that the page number is to be printed at the bottom of the form.

Thresholdprofile layout files

Two layout files are referenced in fields 6 and 7 to specify the information to be printed. You can specify variable names to identify the required layout file as follows: layout#.txt where # is 0,1 or 2. The following is a list of the parameters required to specify the output for either layout file. A sample configuration and illustration of the output of a layoutx.txt file follow.

Notes regarding invoice printing using these parameters
  • When configured to print in Spanish, the total of the invoice will be printed at the bottom left corner of the invoice

  • If the sales data does not fit on one page, it will be printed on multiple pages. The overflow pages will repeat the header information. Page numbers will not be printed. Totals will only be printed on the last page

  • The number of invoice copies to print is configured in the THRESHOLDPROFILE POS.ini option. Copies are produced by printing the form multiple times. The invoice copies are not named (Customer copy, Store copy, Accountant copy.)

  • The invoice number will be written to the Tlog. It will appear in the reference number field of the UDT

  • If an invoice is required for a return transaction, another UDT should be created for returns. It is assumed that the format of both the sale and return invoice forms is the same

  • No additional accumulation or reporting will be performed on Sale With Invoice type transactions. The UA record within the Tlog should be used to identify all such transactions

  • The printing of the invoice form is done using Windows drivers for the printer.

THRESHOLDPROFILE layoutx.txt file tags

Tag name

Description

<autoReferenceNum>

This will display the auto-generated reference number defined by the THRESHOLDPROFILE options in the POS.INI.

<cutomer.address>

address

<customer.addr2>

additional address

<customer.city>

city name

<customer.country>

country

<customer.firstname>

customer’s first name

<customer.lastname>

customer's last name

<customer.num>

customer number from Customer Information database

<customer.phone1>

1st phone number

<customer.phone2>

2nd phone number

<customer.refNum2>

additional customer reference field

<customer.refNum3>

additional customer reference field

<customer.state>

state name

<customer.title(22)>

customer’s title – the number in brackets is the title choice list ID

<customer.zip>

zip code

<date>

current date

<deptTotal.desc>

department description

<deptTotal.discount>

department total discount amount

<deptTotal.number>

department number

<deptTotal.quantity>

department total quantity

<deptTotal.total>

department total sale amount

<footer>

This line appears on each page as a footer line.

<header>

This line appears on each page as a header line.

<itemList.desc>

item description

<itemList.discount>

dollar discount applied to this item

<itemList.extPrice>

extended price

<itemList.maxOnPage>

maximum number of items on one page

<itemList.perDisc>

percent discount to apply to this item

<itemList.quantity>

count of same item

<itemList.sku>

SKU number

<itemList.unitPrice>

unit price for item

<itemList.unitSize>

volume size of one item

<itemList.sizeType>

unit measurement

<linePosition=##>

fixed line that the data must appear on

<profilePrompt.response[x]>

data captured in the profile prompt. X is the prompt line number

<refundAmount>

total amount to refund. This is the value of <totalSale> times the refund percent defined by the THRESHOLDPROFILE options in the POS.INI.

<tab=n>

Space holder for variables defined after this tag. Used for formatting and alignment. N is a numeric value that specifies how many characters the next variable value should display. It will append spaces if the number of characters of the variable value is less than n, or will truncate to n characters if it is greater than n. You can redefine the tab value, n, as many times as you want.

<store.account>

account number of store

<store.address>

address of store

<store.contact>

contact of store

<store.city>

city of store

<store.district>

district of store

<store.email>

e-mail of store

<store.fax>

fax number of store

<store.name>

name of store

<store.phone>

phone number of store

<store.stateprov>

state/province of store

<store.web>

web site of store

<store.zippostal>

zip/postal code of store

<time>

current time

<totalCount>

total item count

<totalSale>

total sale (price) value

<txn.date>

date of transaction record

<txn.day>

transaction day

<txn.discount>

total transaction discount

<txn.month>

transaction month (maximum three characters)

<txn.pendingNum>

pending number used as order number

<txn.storeNum>

store number from transaction record

<txn.subtotal>

transaction total before taxes

<txn.year>

transaction year

<vatAmount>

total amount of vat taxes

Example Example

Sample configuration and output of a layout1.txt file

The following is an example of a layout1.txt file configuration.

End of the example.

Syntax Syntax

  1. 107732 CALVIN KLEIN
  2. 53 AVENUE MONTAIGNE A<autoReferenceNum>
  3. 75008 PARIS
  4. TEL : 01 56 88 12 12
  5. 43918793000024
  6. <tab=20><itemList.sku> <itemList.desc> <tab=9><itemList.quantity>
  7. <itemList.extPrice>
  8. <linePosition=40> <txn.date> <vatAmount> <refundAmount>  <totalSale>
  9. <tab=0><customer.firstname>  <customer.lastname>
  10. <tab=40><customer.address>
  11. <tab=40><customer.addr2>
  12. <tab=13><customer.city>
  13. <tab=40><customer.state>
  14. <tab=40><customer.country>
  15. <tab=40><customer.refNum2>
  16. <tab=40><customer.refNum3>
    
End of the code.

Disallow printer disable

During startup the POS attempts to connect to the printer. If this initialization fails, the cashier is given the option to disable the printer and continue without the printer. This feature allows the retailer to specify whether the cashier has the ability to disable the printer during initialization failures. If the POS.INI setting ALLOWPRINTERDISABLE=<Y>, the feature is turned on (this is the default setting), the POS allows the cashier to disable the printer. If ALLOWPRINTERDISABLE=<N>, the feature is turned off, the POS only allows the cashier to continue once it is able to successfully communicate with the printer.

The following messages may display on the POS:

Remove any Jammed Paper

Close the Cover

Press any Key to Re-Initialize Printer