Configuración de la Biblioteca
El TPV utiliza esta rutina para configurar CliSiTef para que pueda interactuar tanto con SiTef como con el TPV mismo.
Las funciones que tienen el sufijo "Ex" (es decir, extendido) admiten parámetros adicionales además de los habituales; estos parámetros se explican en la Sección Configuración especial.
Tabla 2: Parámetros de función#
| Parámetro | Tipo | Interfaz Estándar | Descripción |
|---|---|---|---|
| SiTefIP | Entrada, por valor | char * | Configura el nombre o la dirección IP (en notación ".") del servidor de SiTef |
| MerchantID Identificación del comerciante | Entrada, por valor | char * | Identifica el comercio en SiTef |
| TerminalID ID de terminal | Entrada, por valor | char * | Identifica el terminal TPV del comercio. Tiene el formato XXnnnnnn: XX consta de 2 caracteres alfabéticos y nnnnnn consta de 6 dígitos, siempre y cuando el número resultante no superponga el rango de 000900 a 000999 reservado para el uso de SiTef |
| Reservado | Entrada, por valor | short | Debe pasarse con "0" (ceros) |
| AdditionalParam ParamAdicional | Entrada, por valor | char * | Parámetros adicionales para la configuración de CliSiTef en el siguiente formato: [<Parameter_Name_1>=<Parameter_Value_1>;<Parameter_Name_2>=<Parameter_Value_2>] |
¡IMPORTANTE!
Cada terminal debe tener un código único y fijo por comercio de SiTef. De esta forma, el establecimiento comercial debe administrar los códigos utilizados para que nunca haya una repetición de terminales para el mismo comercio.
El servidor SiTef no permite dos o más conexiones simultáneas usando el mismo par (comercio, terminal), eliminando las conexiones anteriores, manteniendo solo la última conexión realizada. Si la transacción que estaba en progreso cuando se cortó la conexión con un TPV duplicado ya estaba en un estado pendiente (una venta, por ejemplo), el SiTef la coloca inmediatamente en el estado de Canc.PDV (cancelado por el TPV), es decir, esta transacción estará cancelada. El terminal que está desconectado recibirá el mensaje “Sin conexión SiTef” con el código de error -5.
Cuando el comerciante usa PinP ad para la lectura de la tarjeta y la entrada de contraseña y si se cambia el par (comercio, terminal), esto implicará la recarga de tablas en el PinPad en cada cambio. Esta es una razón más para que se arregle el código del terminal.
Todas estas rutinas devuelven uno de los siguientes resultados:
Tabla 3: Códigos de retorno de funciones de configuración#
| Valor | Descripción |
|---|---|
| 0 | No se produjo ningún error |
| 1 | Dirección IP no válida no resuelta |
| 2 | ID de comerciante inválido |
| 3 | ID de terminal inválido |
| 6 | Error de inicialización de Tcp/IP |
| 7 | Memoria baja |
| 8 | No se puede encontrar CliSiTef o CliSiTef con problemas |
| 10 | Error de acceso a la carpeta CliSiTef (posible falta de permiso de escritura) |
| 11 | Datos inválidos pasados por el TPV |
| 12 | Posible que el archivo ".cha" no está configurado en SiTef (aplicable solo si se está utilizando el archivo ".cha") |
| 13 | Ruta DLL inválida (la ruta completa de las bibliotecas puede estar demasiado larga) |
Esta rutina debe llamarse al menos una vez para que todos los parámetros en la conexión entre CliSiTef y SiTef sean establecidos.
PD: Después de cargar CliSiTef y realizar la primera llamada a ConfiguraIntSiTefInterativo, a menos que haya algún cambio en los parámetros de la función (por ejemplo, el IP de SiTef), no es necesario volver a llamar a esta función.
Configuración especial#
La rutina ConfiguraIntSiTefInterativoEx es una versión extendida de ConfiguraIntSiTefInterativo, que acepta parámetros adicionales para cambiar, en tiempo de ejecución, cómo se configura CliSiTef. Tenga en cuenta que cuando se utiliza este tipo de configuración, se aplica a todas transacciones realizadas después de esta llamada.
El campo AdditionalParam necesita ser formateado como: [<Param1>;<Param2>;...]
Nota: Para obtener una descripción de los parámetros adicionales disponibles, consulte el documento que describe las funciones disponibles en cada país.