Saltar al contenido principal
En Brasil la caja cobra con tarjeta y PIX a través del SiTef, y el SiTef reconoce a cada caja por un código de 8 caracteres: su Terminal SiTef. Si dos cajas usan el mismo código, el SiTef las trata como una sola: las transacciones pendientes y las cancelaciones de una caja caen en la otra, y una venta puede quedar cobrada o deshecha sin que nadie lo note. Por eso la configuración tiene dos partes: los datos de la tienda, que se cargan una vez, y un Terminal SiTef propio para cada caja.
Lo mínimo que hay que saber
  • Dos niveles. La tienda guarda lo que comparten todas sus cajas: servidor, código de tienda, CNPJ y senha de supervisor. Cada caja necesita además su propio Terminal SiTef.
  • Una caja, un Terminal; un Terminal, una caja. Fire no deja vincular el mismo Terminal a dos cajas ni dos Terminales a la misma caja.
  • Sin Terminal vinculado, la caja no cobra con tarjeta ni PIX. Tampoco si el SiTef de la tienda está apagado. Los cambios llegan solos al POS: la próxima venta con tarjeta ya los usa.

​
Requisitos previos

  • Una tienda de Brasil. En tiendas de otros países las tarjetas de SiTef no aparecen.
  • La caja registrada en Fire. Consulta Vinculación.
  • Los datos que entrega el SiTef: el código de tienda (“Empresa”), la IP del servidor SiTef y un código de Terminal por caja.

​
1. Carga los datos SiTef de la tienda

En Fire POS → Config por tienda, con la tienda elegida en el encabezado, busca la tarjeta SiTef (Brasil): pago con tarjeta.
Tarjeta SiTef (Brasil): pago con tarjeta, con Habilitado encendido, URL del agente, servidor SiTef, código de tienda, los dos CNPJ y la senha de supervisor configurada
Presiona Guardar SiTef. El botón se activa solo cuando hay cambios; Deshacer los descarta.

​
2. Crea un Terminal SiTef por caja

Debajo está Terminales SiTef por caja. En Agregar Terminal completa:
  • Nombre: cómo reconoces la caja, por ejemplo Caixa 1.
  • Terminal SiTef: el código de 8 caracteres alfanuméricos que asignó el SiTef, por ejemplo FP000001. El rango 000900–000999 está reservado por el SiTef y Fire lo rechaza.
  • Token TLS: solo si Fiserv conecta esa caja por su plataforma TLS. Con el servidor SiTef por IP, como los kioscos, va vacío.
Presiona Agregar Terminal. Aparece en la tabla como Libre, todavía sin caja.
Tabla Terminales SiTef por caja con el Terminal Caja Test 12121212, sin token, vinculado a la caja BR-K000-POS-122, y el formulario Agregar Terminal

​
3. Vincula cada Terminal a su caja

En la columna Caja vinculada, abre el selector del Terminal y elige la caja. Se guarda en el momento: no hay botón de guardar.
Selector de Caja vinculada abierto con la opción Libre y la lista de cajas POS de la tienda
La lista muestra solo cajas POS de esa tienda que todavía no tienen Terminal. Libre desvincula.
Si cada caja de la tienda tiene su Terminal vinculado, terminaste. No hace falta reiniciar el POS: la próxima venta con tarjeta ya usa la configuración nueva.

​
Otras formas de vincular

​
Desde el detalle de la caja

En Fire POS → Terminales, abre el menú ⋮ de una caja y elige Ver detalles. La sección Terminal SiTef muestra con qué Terminal se identifica esa caja ante el SiTef.
Sección Terminal SiTef del detalle de una caja: Vinculado, Caja Test 12121212 y el botón Desvincular
Con un Terminal vinculado se ve Vinculado y el botón Desvincular. Sin Terminal, la sección ofrece los Terminales libres de la tienda; si no queda ninguno, lo avisa:
Sección Terminal SiTef de una caja sin Terminal: No hay Terminales SiTef libres. Créalos en Configuración de tienda.

​
Al crear el slot de una caja nueva

En Fire POS → Terminales → Crear slot, el campo Terminal SiTef (opcional) deja elegir un Terminal libre para la caja que se va a instalar. La caja queda vinculada a ese Terminal cuando el dispositivo se vincula con el código del slot. El campo aparece solo en tiendas de Brasil y solo si hay Terminales libres.

​
Editar o eliminar un Terminal

En la columna Acciones de la tabla:
  • Editar (lápiz) cambia el nombre, el código o el token TLS. El token no se vuelve a mostrar: escríbelo solo para reemplazarlo, o usa Quitar token.
  • Eliminar (papelera) borra el Terminal. La caja vinculada deja de cobrar con tarjeta hasta que le vincules otro.
Diálogo Editar Terminal SiTef con nombre Caja Test, código 12121212 y token TLS sin cargar
Si borras una caja en Terminales, su Terminal SiTef queda libre para otra.

​
Producción y ambiente de pruebas

Los datos de la tarjeta SiTef y de cada Terminal cambian según dónde cobra la caja. Cada ambiente de Fire tiene su propia configuración: lo que cargas en el backoffice de pruebas no pasa a producción.

​
En producción

En producción la caja se conecta al servidor SiTef de la operación por su IP, igual que los kioscos de la tienda. Fiserv entrega tres datos: la IP del SiTef, el código de tienda y un número de terminal por caja.
1

Pide los datos a Fiserv

La IP del servidor SiTef, el código de tienda (“Empresa”) y un número de terminal por caja. El número de cada caja tiene que ser distinto del de las otras cajas y del de los kioscos de la tienda.
2

Instala el agente de producción en cada caja

El paquete agenteCliSiTef-…-Producao-Win64 que entrega Fiserv, en lugar del agente del simulador. Se instala como servicio de Windows con los scripts de la carpeta helper.
3

Carga los datos en Fire

En el paso 1, la IP en Servidor SiTef, el Código de tienda SiTef, los CNPJ y la senha de supervisor reales. En el paso 2, un Terminal por caja con su número en Terminal SiTef; el Token TLS va vacío. Después vincula cada Terminal a su caja (paso 3).
4

Haz una venta de prueba en cada caja

Una venta chica con tarjeta, y su cancelación desde Estornar transação com cartão, confirman que la caja llega al SiTef con su número de terminal.
No hace falta tocar la configuración del agente en la caja: el POS le manda la IP, el código de tienda y el número de terminal en cada operación, con los datos que guardaste en Fire.
Si Fiserv conecta la tienda por su plataforma TLS en lugar de una IP, cada caja necesita además un token TLS, que se genera en el Portal Administrativo del SiTef y se carga en el Terminal de esa caja. La caja se registra sola en la primera operación y después hay que aprobarla en el Portal. La red tiene que permitir el puerto 443 hacia tls-prod.fiservapp.com y postls-prod.fiservapp.com, y el registro queda guardado en la PC de la caja, en C:\CliSiTef\NaoExcluirControleCliSiTef\<Empresa>\<Terminal>.

​
En pruebas (homologación con el simulador)

En pruebas la caja habla directo con el SiTdemo, el simulador de SiTef, sin TLS:
  • El agente es el del simulador y el SiTdemo corre en la misma red, o en la misma PC.
  • En Servidor SiTef va la IP del SiTdemo: 127.0.0.1 si corre en la misma PC.
  • Código de tienda 00000000 y un código de Terminal de prueba por caja.
  • Token TLS vacío: el SiTdemo no usa TLS.
  • Habilitado encendido solo en la tienda de pruebas.

​
Qué cambia entre pruebas y producción

​
Cuándo una caja cobra con tarjeta

​
Ejemplo

En Laboratorio Brasil hay 7 cajas registradas y un solo Terminal SiTef: Para que BR-K000-POS-121 cobre con tarjeta hay que crear un segundo Terminal con su propio código y vincularlo a esa caja. Reusar 12121212 no se puede.

​
Errores que salen caros

Apagar Habilitado o eliminar un Terminal en horario de venta. La caja deja de ofrecer tarjeta en la próxima venta. Si el cliente solo puede pagar con tarjeta, la venta se pierde.
Quitar la senha de supervisor. El POS la usa para devolver solo el cobro con tarjeta cuando el pedido no se puede registrar. Sin senha esa devolución no arranca: el cliente queda cobrado y hay que estornar a mano desde la caja.
Cargar el código de Terminal equivocado. El SiTef identifica a la caja por ese código. Con el de otra tienda o uno mal escrito, las ventas, las pendientes y las cancelaciones quedan a nombre de otro Terminal en el SiTef.
Cargar un token TLS cuando la tienda se conecta por IP. Con token, la caja intenta conectarse a la plataforma TLS de Fiserv en lugar de su servidor SiTef y no cobra. En pruebas, y en producción por IP, el Token TLS va vacío.
Con conexión TLS: borrar la carpeta de registro o reinstalar la PC de una caja. La caja pierde su registro TLS y no cobra con tarjeta hasta que se registre otra vez con un token nuevo de Fiserv.

​
Glosario

​
Preguntas frecuentes

No. Fire avisa a las cajas de la tienda y la próxima venta con tarjeta ya usa los datos nuevos.
Sí, y solo si la tienda se conecta por la plataforma TLS de Fiserv. La caja se registra con él la primera vez y queda registrada en esa PC. Si cambias la PC o la reinstalas, pide a Fiserv un token nuevo y cárgalo en el Terminal de esa caja.
No. Fire lo rechaza, porque el SiTef mezclaría las pendientes y las cancelaciones de las dos cajas. Cada caja necesita su propio código.
A esa caja le falta la configuración SiTef: no tiene Terminal vinculado, o el SiTef de la tienda está apagado o sin guardar. El aviso menciona el agente, pero en este caso la causa está en Fire: revisa los pasos 1 a 3.
La tienda elegida en el encabezado no es de Brasil. Las tarjetas de SiTef solo aparecen en tiendas de Brasil.
No hay Terminales libres en la tienda. Crea uno en Config por tienda y vuelve a abrir Crear slot.
Queda libre y lo puedes vincular a otra caja.