PointWare Ekspedient

Document Type
Version
Date
Confidentiality
By

: Technical Interface Specification

: 3.4.02
: 31-07-2012
: NONE
: Udvikling

This Document is the property of Point Transaction Systems A/S. It is transferred under the conditions of Active NonDisclosure.
Use of this document is subject to the terms of this NDA (Non Disclosure Agreement).
This document will be returned under request to Point Transaction Systems A/S.

POINT TRANSACTION SYSTEMS A/S

Knapholm 7, 2730 Herlev, Tlf.: 44 53 16 10 Fax: 44 53 46 20 www.point.dk
Reg.nr. A/S 202086 CVR nr. 15 40 12 81

Content
Content ........................................................................................................................... 2
1. PointWare Ekspedient ................................................................................................ 3
2. PointWare Ekspedient Setup ...................................................................................... 4
3. Printer Control ............................................................................................................. 4
4. Printer Queue Delay ................................................................................................... 5
5. Configuration File used by PWE ................................................................................. 5
6. Installing a New Terminal............................................................................................ 5
7. Manual or Automatic Mode ......................................................................................... 5
8. Disable Virus-Scan on PWE Directories ..................................................................... 6
9. Logging of Data .......................................................................................................... 6
10. Cleanup to Prevent File System Overflow ................................................................ 6
11. Do NOT put PWE in the Windows Start Menu ....................................................... 6
12. Password used to Access Startup ............................................................................ 7
13. TrayDemo PointWare Ekspedient ............................................................................. 7
14. PointWare Ekspedient Tray-Mode Minimum ............................................................. 8
14.1. Default Card Transaction ................................................................................... 8
14.2. Signature Card Transaction ............................................................................... 8
14.3. Refund Card Transaction ................................................................................... 8
14.4. Offline Card Transaction - observe authKode with K in kode ............................. 8
14.5. Afstemning End of Day .................................................................................... 8
14.6. Ls Ingen Kvittering Op Unlock No Receipt .................................................... 8
14.7. Print PCI Eventlog ........................................ Fejl! Bogmrke er ikke defineret.
14.8. Send PCI Eventlog ....................................... Fejl! Bogmrke er ikke defineret.
14.9. Delete PCI Eventlog ..................................... Fejl! Bogmrke er ikke defineret.
1. Hidden Features in PWE Setting Trace ................................................................... 8

1. PointWare Ekspedient
New since version 3.3.01
Added printer control

PointWare Ekspedient can run in too modes:

Manual - as seen above.
Tray mode commando/answer file interface.

In manual mode merchant selects the action to be performed from the dropdown
menus, if a transaction is selected merchant enters amount and press Godkend (OK)
to start transaction.
In tray mode the ECR write the action PointWare Ekspedient (PWE) has to perform to a
file in a specific folder. PWE looks for the file, perform the action and writes a file with
the result of the action. ECR must look for this result file and act on the result.
PWE controls the receipt printer during transaction/admin actions.
Below you will find more information on tray mode and a demo program made by Point,
written in C-sharp called TrayDemo PointWareEkspedient, the demo shows examples
of commands, results and receipt data.

2. PointWare Ekspedient Setup

If you are running PointWare Ekspedient (PWE) in manual mode you only need to set
the terminal connection Terminal Forbindelse and select the printer.
If running in tray mode PWE must be set to work in a specific folder and use specific file
names for the command/answer files. Above image show the setup used by the
TrayDemo PointWareEkspedient.

3. Printer Control
PointWare Ekspedient must have control over the printer as long as the
transaction/admin function is running.
In the OCX documentation appendix A you will find more information on how to:

Init the printer, select the font used, font must be fixed pitch.
Header information to be printed on every receipt.
Footer/ cutting information to be printed/performed at the end of every receipt.
ASCII char translation from ISO-8859-15 terminals char set to the printers char
set.

4. Printer Queue Delay

Some Windows printers are very slow to respond and the terminal will go into no
receipt state. By adjusting the delay you can avoid this. Large office printers sometimes
need 3000-5000 mS. The delay will add to the transaction time so select the lowest
possible value. From terminal SW version 3.4 the state no receipt has been removed
and a slow printer queue response will not have the effect of blocking transactions.

5. Configuration File used by PWE

In the users local settings Application data Point Transaction System - you will find a
file user.config in a directory generated by PWE.
In case of problems changing PWE setting you might try to change data in this XML file.
No documentation exists for this file. Changes are on your own risk.
Ex. For the user yyy:
C:\Documents and Settings\yyy\Lokale indstillinger\Application
Data\Point_Transaction_Systems\PointWare_Expedient.exe_Url_dxi2b0m2x54yggm03
mqrfrd5ktbt5gh3\3.0.0.2

6. Installing a New Terminal

Make sure you use the Udskift terminal in the Terminal drop down menu, if you
change the terminal to a new or use a standard configuration for your application setup,
and not the PointWare Ekspedient install script (setup.exe).
This ensures that the user.config file mentioned above contain the correct terminal
number etc.

7. Manual or Automatic Mode

By right clicking the PointWare Ekspedient icon in the tray bar you will see a menu like
this:

Clik Manuel to get the PWE dialog on screen:

Click Automatisk to close the PWE dialog and go back to Tray-mode.
Click Afslut to close PWE.

8. Disable Virus-Scan on PWE Directories

To prevent blocking of the PointWare Ekspedient the directories used must not be
searched by virus scanner software.
Otherwise you might experience communication problems, due to scanner blocking files
for some time-period.

9. Logging of Data
The terminal must be configured to enable logging of data. The default setting enables
this logging of transaction data:
Ex. For the test terminal 990369 this file is generated:
Bon_00990369.csv

10. Cleanup to Prevent File System Overflow

PointWare Ekspedient saves a copy of each receipt in the directory specified. We
advice you to make a daily - weekly - monthly cleanup, depending on the number of
transactions made by PWE.
The cleanup may involve packing the Bon_XXXXXX*.txt to a zip to save space.
Keep the zip file to fulfil legal requirement (skat revision pbs).

11. Do NOT put PWE in the Windows Start Menu

PointWare Ekspedient expects a fully running Window system and will many times not
start correctly if put in the Windows start program menu.
We suspect some environment needed by PWE is missing at this point. Examples are
network/printers etc. If started by your merchant application, make sure PWE has full
access to network/printer/configuration files/working directory etc.

12. Password used to Access Startup

PontWare Ekspedient Terminal dropdown menu Opstning requires a password, use
746578 to gain access.

13. TrayDemo PointWare Ekspedient

To run TrayDemo, PointWare Ekspedient must be setup as shown on the image below.
The TrayDemo makes the folder \tmp\PWEtrayTest on start and after starting
PointWare Ekspedient you should be ready to go.

Select the type of transaction to perform, currency, amount, password, and press button
Start Transaction. Now the command written to the file kommondo.txt is shown in
CmdBox, the receipt in the ReceiptBox and the svar.txt in the AnswerBox
Buttons on the left is some predefined transactions used for testing.

14. PointWare Ekspedient Tray-Mode Minimum

The ECR using the PWE must as a minimum implement the following
transactions/admin functions.

14.1. Default Card Transaction

- type Card -amount 18000 -currency DKK
14.2. Signature Card Transaction
- type ForcedSignature -currency DKK -amount 2300

14.3. Refund Card Transaction

- type Refund -currency DKK -amount 2400 -password 2730
14.4. Offline Card Transaction - observe authKode with K in kode
- type Offline -currency DKK -amount 2500 -authKode a1234b

14.5. Afstemning End of Day

- endofday -password 2730
This command has to be run once every day.
14.6. Ls Ingen Kvittering Op Unlock No Receipt
- unlockreceipt -password 2730
This command is not needed from terminal sw version 3.4 as the terminal can no longer
be locked in no receipt

1. Hidden Features in PWE Setting Trace

Trace can be enabled/disabled in PWE by selecting Kommando Program hold CTRL

and click left mouse button as the mouse pointer hovers over Svar exe.
After enable/disable trace deselect Kommando Program again.
Normal operation should be without trace.
In case of problems trace files:
flxComTrace.txt
PtFxDrTrXXXX.txt
PointOcxTraceXXXX.txt
This can be send to udvikling@point.dk, with information about the problem and the
time it was encountered.