Comunicación con SiTef

Direcciones IP adicionales#

Es posible configurar direcciones IP adicionales para comunicarse con SiTef, además de la utilizada en la función de configuración descrita en la Sección Configuración de la Biblioteca. Se permite un máximo de 3 direcciones adicionales.

[SiTef]
EnderecoIP=IP1;IP2;IP3

Además, el número de puerto de cada servidor puede agregarse al archivo de configuración, utilizando el formato IP: PortNumber.

Por ejemplo:

EnderecoIP = 127.0.0.1:4097;192.168.0.2:5096

Número de puerto de SiTef#

En raras ocasiones, puede ser necesario cambiar el número de puerto predeterminado de SiTef, por ejemplo, cuando hay una restricción de seguridad en la red del cliente.

Para cambiar el puerto predeterminado (4096), se deben agregar las siguientes líneas:

[SiTef]
PortaSiTef=<PUERTO>

Requisito de conexión#

Por defecto, CliSiTef intenta avanzar con la transacción, incluso sin conexión, en la medida de lo posible. Para cambiar este comportamiento y hacer que la conexión sea obligatoria para iniciar la transacción, agregue las siguientes líneas al archivo de configuración:

[SiTef]
ConexaoObrigatoria=1

Con este parámetro habilitado, en caso de que no haya conexión, el error -5 será devuelto y la transacción estará terminada.

Manteniendo activa la conexión#

Por defecto, CliSiTef siempre desconectará la conexión activa con SiTef al final de una transacción. Si el TPV necesita mantener la conexión siempre activa, se deben agregar las siguientes líneas al archivo de configuración:

[SiTef]
MantemConexaoAtiva=1

Cambiar el tiempo de espera de conexiones/transacciones#

El tiempo de espera para conexión:#

El tiempo de espera predeterminado para CliSiTef conectarse a SiTef es de 6 segundos. Para aumentar/disminuir este valor, use el siguiente comando:

[SiTef]
TempoEsperaConexao=<tiempo en segundos>

Tiempo adicional de espera de transacción:#

Generalmente CliSiTef recibe parámetros de tiempo de espera de comunicación con el servidor SiTef y agrega más tiempo como margen de seguridad. Sin embargo, cuando el host no está disponible, dependiendo del canal de comunicación entre Clisitef y el servidor SiTef, este margen puede no ser suficiente, y puede aparecer un mensaje "Sin conexión con SiTef", cuando el correcto es "Host no disponible".

Para incluir un tiempo adicional para que se procese la transacción, agregue las siguientes líneas:

[SiTef]
TempoAdicionalEspera=<tiempo adicional al tiempo de expiración predeterminado, en segundos>

Tiempo de expiración para el resultado de una reversión de transacción:#

El tiempo predeterminado que CliSiTef espera hasta que obtenga del SiTef la respuesta de un mensaje de reversión de transacción es de 6 segundos. Para cambiar eso, agregue las siguientes líneas:

[SiTef]
TempoEsperaDesfazimento=<tiempo en segundos>

Tiempo de expiración para el resultado de una confirmación de transacción:#

El tiempo predeterminado que CliSiTef espera hasta que obtenga del SiTef la respuesta de un mensaje de confirmación de una transacción es de 6 segundos. Para cambiar eso, agregue las siguientes líneas:

[SiTef]
TempoEsperaConfirmacao=<tiempo en segundos>