Library Configuration

This must be the first call to the CliSiTef library. She has
The objective is to configure the connection parameters with the server
SiTef
, and with Commercial Automation itself.

int ConfiguraIntSiTefInterativo (IPSiTef, IdStore, IdTerminal, Reserved)
int ConfiguraIntSiTefInterativoEx (IPSiTef, IdStore, IdTerminal, Reserved, AdditionalParameters)

ASCII Interface

ConfiguraIntSiTefInterativoA (Result, IPSiTef, IdLoja, IdTerminal, Reserved)
ConfiguraIntSiTefInterativoExA (Result, IPSiTef, StoreId, TerminalId, Reserved, AdditionalParameters)

ParameterTypeStandard InterfaceASCII InterfaceDescription
ResultOutput, by valueNot usedFixed 6Contains the result of the response to the routine call.
IPSiTefEntry, by valuechar *VariableConfigures the name or IP address (in "." notation) of the SiTef server.
IDStoreEntry, by valuechar *Fixed 8Identifies the store number within the network of commercial establishments.
IdTerminalEntry, by valuechar *Fixed 8Identifies the POS in front of the store. It has the format XXnnnnnn where XX corresponds to 2 alphabetic characters and nnnnnn to any 6 digits as long as the resulting number does not overlap the range 000900 to 000999 which is reserved for use by SiTef.
ReservedEntry, by valuechar *Fixed 6Must be passed with 0
Additional ParametersEntry, by valuechar *VariableAdditional CliSiTef configuration parameters in the following format: [<Parameter_Name_1>=<Parameter_Value_1>;<Parameter_Name_2>=<Parameter_Value_2>]

Important!

Each terminal must have a unique and fixed code per SiTef store.
In this way, the commercial establishment must manage the codes
used in such a way that there is never a repetition of terminals for a
same store.

SiTef server does not allow two or more simultaneous connections
using the same pair (store, terminal), dropping the connections
previous ones, keeping only the last connection made
; if perhaps the
transaction that was in progress when the POS connection dropped
duplicate was already in pending status (a sale for example), the
SiTef immediately places it in Canc.POS status (Cancelled by the POS), or
In other words, this will be cancelled; the terminal that is disconnected will receive the
message "Sem conexao SiTef" with error code -5.

When the commercial establishment uses Pinpad to read
cards and password entry and if the pair (store, terminal) is
changed, this will result in new tables being loaded onto the pinpad every
change. This is yet another reason for the terminal code to be
fixed.

The configuration routines return one of the following values:

Table 2 - Return codes from configuration functions

ValueDescription
0No error occurred
1Invalid or unresolved IP address
2Invalid store code
3Invalid terminal code
6Tcp/Ip initialization error
7Lack of memory
8Didn't find CliSiTef or it has problems
9SiTef server configuration has been exceeded.
10Access error in the CliSiTef folder (possible lack of writing permission)
11Invalid data passed through automation.
12Safe mode not active (possible lack of configuration on the SiTef server of the .cha file).
13Invalid DLL path (the full library path is too long).

Note: during the automation lifecycle, if there is no
change in the function's input parameters, then there is no need to
call her again.