Services User Exit Print Extra Receipts (New)

Technical Data

Product Version	SAP Point-of-Sale (POS) 2.3
Area	IS-R-TGM
Country Relevance	Valid for all countries

As of SP07, two functions have been added to allow a service to trigger the printing of additional sales receipts in transactions.

This release provides two functions that allow a developer to print additional store receipts when writing a Services User Exit Instance. One function allows Services to obtain the current number of service receipts from the POS, and the other allows for Services to set the number of service receipts for the POS to print. The POS will only keep one number of service receipts variable.

These extra receipts will be called service receipts to distinguish them from other store receipts.

The POS can print several different types of store copies with varying formats. The service receipt copy has the same format as the POS’s dual receipt. Currently a dual receipt can be configured using the Dual Receipt option in Non-Merchandise, Discount, and Manager POS Functions configuration. During the printing process, the POS will print the number of service receipts specified by Services. Any POS-configured dual receipt that is triggered in a transaction will continue to print and is not counted as a service receipt copy.

New Callback Function:

The Service Extension uses this command to indicate how many service receipts are to be printed at the end of the transaction. The POS literal Service Copy can be used to change the title on the service receipt. The POS.INI option SERVICEMAXRECEIPTS=# can be used to set the maximum number of service receipts to print. This value cannot be greater than 10.

Request Details
Tag	Attributes	Description
<NumOfCopies>		Specifies the number of receipt copies to print .
<Action> (optional)		Specifies the action. If this node is missing then the command behaves as if the Action element is OVERRIDE. Allowed values are: Value: ADD Description: Adds the number of copies to the POS’s number of service receipts to print. Value: SUBTRACT Description: Subtracts the number of copies from the POS’s number of service receipts to print. If an attempt is made to subtract below zero, the POS’s number of service receipts is set to zero and the response status will be set to FAIL. Value: OVERRIDE Description: Indicates the number of service copies to print. The POS’s number of service receipts will be set to this value.

Example Example

<ServiceExitMessage>

<Request>

<CommandName>PrintServiceReceipts</CommandName>

<NumOfCopies>2</NumOfCopies>

<Action>ADD</Action>

</Request>

</ServiceExitMessage>

End of the example.

New Attribute for Existing InputCapture Callback:

There is a new attribute to the existing InputCapture Callback: NumServiceReceipts. When using this attribute, the POS will return the current number of service receipts. This is the POS‘s number of service receipts currently set by the use of the PrintServiceReceipts Service Command. For more information about the Services User Exit, see the SAP POS 2.3 Services User Exit Technical Reference Guide.