> ## Documentation Index > Fetch the complete documentation index at: https://docs.fire.rest/llms.txt > Use this file to discover all available pages before exploring further. # Asignar SiTef a cada caja > Carga una vez los datos SiTef de la tienda y dale a cada caja de Brasil su propio Terminal SiTef para que cobre con tarjeta. 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. > [!NOTE] > > **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](https://docs.fire.rest/es/manuals/pos/linking.md). * 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](https://mintcdn.com/firepos/6XRqyXVb4Nc8yRXg/images/manuals/pos/payments/brazil/sitef/01-store-sitef-config.png?fit=max\&auto=format\&n=6XRqyXVb4Nc8yRXg\&q=85\&s=aa4c46772d9c43d26b9d67cac74b70ed) | Campo | Qué va | | - | - | | **Habilitado** | Enciende el cobro con tarjeta en las cajas de la tienda que tengan Terminal vinculado. | | **URL del agente** | La dirección del AgenteCliSiTef instalado en cada caja. Casi siempre `https://127.0.0.1/agente`. | | **Servidor SiTef (IP o host)** | El servidor SiTef al que se conecta el agente. | | **Código de tienda SiTef** | 8 dígitos: la "Empresa" registrada en el SiTef. | | **CNPJ de la tienda** | 14 dígitos, sin puntos ni guiones. | | **CNPJ de la automatización** | 14 dígitos. Si lo dejas vacío, el POS usa el suyo por defecto. | | **Senha de supervisor** | La que pide el SiTef para cancelar. Se guarda cifrada y no se vuelve a mostrar: **Configurada** indica que ya hay una. | 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](https://mintcdn.com/firepos/6XRqyXVb4Nc8yRXg/images/manuals/pos/payments/brazil/sitef/02-sitef-terminals.png?fit=max\&auto=format\&n=6XRqyXVb4Nc8yRXg\&q=85\&s=0bb966cc30a5f5b42464f9eafd9dd814) ## 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](https://mintcdn.com/firepos/6XRqyXVb4Nc8yRXg/images/manuals/pos/payments/brazil/sitef/03-sitef-terminal-link.png?fit=max\&auto=format\&n=6XRqyXVb4Nc8yRXg\&q=85\&s=312f362771376b8b5d8d77122fd31cc5) La lista muestra solo cajas POS de esa tienda que todavía no tienen Terminal. **Libre** desvincula. > [!TIP] > > 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](https://mintcdn.com/firepos/6XRqyXVb4Nc8yRXg/images/manuals/pos/payments/brazil/sitef/05-terminal-detail-sitef.png?fit=max\&auto=format\&n=6XRqyXVb4Nc8yRXg\&q=85\&s=4de20d24d5d4973364cb2fffb6717f1a) 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.](https://mintcdn.com/firepos/6XRqyXVb4Nc8yRXg/images/manuals/pos/payments/brazil/sitef/06-terminal-detail-sitef-none.png?fit=max\&auto=format\&n=6XRqyXVb4Nc8yRXg\&q=85\&s=dae3d6fb0498576ffd5145c4ec97576f) ### 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](https://mintcdn.com/firepos/6XRqyXVb4Nc8yRXg/images/manuals/pos/payments/brazil/sitef/04-sitef-terminal-edit.png?fit=max\&auto=format\&n=6XRqyXVb4Nc8yRXg\&q=85\&s=ea0e3e21ed4724ffdd74f8f14cb5ee60) 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. > [!NOTE] > > **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\\`. ### 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 | Dato | Pruebas | Producción | | - | - | - | | Agente | AgenteCliSiTef del simulador | Paquete `…-Producao-Win64` de Fiserv | | Servidor SiTef | IP del SiTdemo | IP del servidor SiTef que da Fiserv | | Código de tienda | `00000000` | El que asigna Fiserv | | Terminal por caja | Código de prueba | El número que asigna Fiserv a cada caja | | Token TLS | Vacío | Vacío, salvo conexión por la plataforma TLS | | Red de la tienda | Local | Acceso al servidor SiTef (igual que los kioscos) | ## Cuándo una caja cobra con tarjeta | Situación | ¿Cobra con tarjeta y PIX? | | - | - | | La tienda no es de Brasil | No | | La tienda no tiene datos SiTef guardados | No | | **Habilitado** apagado | No, en ninguna caja de la tienda | | SiTef encendido, pero la caja no tiene Terminal vinculado | No | | SiTef encendido y la caja con su Terminal | Sí | ## Ejemplo En Laboratorio Brasil hay 7 cajas registradas y un solo Terminal SiTef: | Terminal | Código | Caja vinculada | Resultado | | - | - | - | - | | Caja Test | `12121212` | BR-K000-POS-122 | Cobra con tarjeta y PIX | | — | — | BR-K000-POS-121 y las otras 5 | No cobran con tarjeta ni PIX | 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 > [!WARNING] > > **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. > [!WARNING] > > **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. > [!WARNING] > > **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. > [!WARNING] > > **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. > [!WARNING] > > **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 | Término | Qué es | | - | - | | **Terminal SiTef** | El código de 8 caracteres con el que el SiTef identifica a una caja. | | **Código de tienda SiTef** | La "Empresa" de la tienda registrada en el SiTef. | | **AgenteCliSiTef** | El programa instalado en la caja que conecta el POS con el SiTef y el pinpad. | | **Senha de supervisor** | La contraseña que pide el SiTef para cancelar transacciones. | | **Token TLS** | El registro de Fiserv que habilita la conexión segura de un terminal en producción. | | **Caja vinculada** | La caja POS que usa un Terminal SiTef. | | **Plataforma TLS de Fiserv** | La entrada por internet al SiTef cuando la tienda no se conecta por IP; registra y valida cada caja. | | **Portal Administrativo del SiTef** | El sitio de Fiserv donde se generan los tokens TLS y se aprueban las cajas. | ## Preguntas frecuentes > **¿Hay que reiniciar el POS después de cambiar la configuración?** > > No. Fire avisa a las cajas de la tienda y la próxima venta con tarjeta ya usa los datos nuevos. > **¿El token TLS se usa una sola vez?** > > 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. > **¿Puedo usar el mismo Terminal en dos cajas?** > > 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. > **Al cobrar con tarjeta la caja muestra «Processador de pagamento indisponível»** > > 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. > **No veo las tarjetas de SiTef en Config por tienda** > > La tienda elegida en el encabezado no es de Brasil. Las tarjetas de SiTef solo aparecen en tiendas de Brasil. > **En Crear slot no aparece el campo Terminal SiTef** > > No hay Terminales libres en la tienda. Crea uno en **Config por tienda** y vuelve a abrir **Crear slot**. > **¿Qué pasa con el Terminal si borro la caja?** > > Queda libre y lo puedes vincular a otra caja. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.