> ## 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. # Atribuir SiTef a cada caixa > Cadastre uma vez os dados SiTef da loja e dê a cada caixa do Brasil o seu próprio Terminal SiTef para que ele cobre com cartão. No Brasil o caixa cobra com cartão e PIX pelo SiTef, e o SiTef reconhece cada caixa por um código de 8 caracteres: o seu **Terminal SiTef**. Se dois caixas usam o mesmo código, o SiTef trata os dois como um só: as transações pendentes e os cancelamentos de um caixa caem no outro, e uma venda pode ficar cobrada ou desfeita sem ninguém perceber. Por isso a configuração tem duas partes: os dados da loja, cadastrados uma vez, e um Terminal SiTef próprio para cada caixa. > [!NOTE] > > **O mínimo que você precisa saber** > > * **Dois níveis.** A loja guarda o que todos os seus caixas compartilham: servidor, código da loja, CNPJ e senha de supervisor. Cada caixa precisa também do seu próprio Terminal SiTef. > * **Um caixa, um Terminal; um Terminal, um caixa.** O Fire não deixa vincular o mesmo Terminal a dois caixas nem dois Terminais ao mesmo caixa. > * **Sem Terminal vinculado, o caixa não cobra com cartão nem PIX.** Também não cobra se o SiTef da loja estiver desligado. As mudanças chegam sozinhas ao POS: a próxima venda com cartão já as usa. ## Pré-requisitos * Uma loja do **Brasil**. Em lojas de outros países os cartões do SiTef não aparecem. * O caixa registrado no Fire. Consulte [Vinculação](https://docs.fire.rest/pt/manuals/pos/linking.md). * Os dados que o SiTef fornece: o código da loja ("Empresa"), o IP do servidor SiTef e um código de Terminal por caixa. ## 1. Cadastre os dados SiTef da loja Em **Fire POS → Config por loja**, com a loja escolhida no cabeçalho, procure o cartão **SiTef (Brasil): pagamento com cartão**. ![Cartão SiTef (Brasil): pagamento com cartão, com Habilitado ligado, URL do agente, servidor SiTef, código da loja, os dois CNPJ e a 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 | O que vai | | - | - | | **Habilitado** | Liga a cobrança com cartão nos caixas da loja que tenham Terminal vinculado. | | **URL do agente** | O endereço do AgenteCliSiTef instalado em cada caixa. Quase sempre `https://127.0.0.1/agente`. | | **Servidor SiTef (IP ou host)** | O servidor SiTef ao qual o agente se conecta. | | **Código da loja SiTef** | 8 dígitos: a "Empresa" registrada no SiTef. | | **CNPJ da loja** | 14 dígitos, sem pontos nem traços. | | **CNPJ da automação** | 14 dígitos. Se você deixar vazio, o POS usa o padrão dele. | | **Senha de supervisor** | A que o SiTef pede para cancelar. Fica guardada criptografada e não é mostrada de novo: **Configurada** indica que já existe uma. | Pressione **Salvar SiTef**. O botão só se ativa quando há mudanças; **Desfazer** as descarta. ## 2. Crie um Terminal SiTef por caixa Logo abaixo fica **Terminais SiTef por caixa**. Em **Adicionar Terminal** preencha: * **Nome**: como você reconhece o caixa, por exemplo `Caixa 1`. * **Terminal SiTef**: o código de 8 caracteres alfanuméricos que o SiTef atribuiu, por exemplo `FP000001`. A faixa `000900`–`000999` é reservada pelo SiTef e o Fire a rejeita. * **Token TLS**: só se a Fiserv conectar esse caixa pela plataforma TLS. Com o servidor SiTef por IP, como os quiosques, fica vazio. Pressione **Adicionar Terminal**. Ele aparece na tabela como **Livre**, ainda sem caixa. ![Tabela Terminais SiTef por caixa com o Terminal Caja Test 12121212, sem token, vinculado ao caixa BR-K000-POS-122, e o formulário Adicionar 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. Vincule cada Terminal ao seu caixa Na coluna **Caixa vinculado**, abra o seletor do Terminal e escolha o caixa. Salva na hora: não há botão de salvar. ![Seletor de Caixa vinculado aberto com a opção Livre e a lista de caixas POS da loja](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) A lista mostra só os caixas POS daquela loja que ainda não têm Terminal. **Livre** desvincula. > [!TIP] > > Se cada caixa da loja tem o seu Terminal vinculado, você terminou. Não é preciso reiniciar o POS: a próxima venda com cartão já usa a configuração nova. *** ## Outras formas de vincular ### Pelo detalhe do caixa Em **Fire POS → Terminais**, abra o menu **⋮** de um caixa e escolha **Ver detalhes**. A seção **Terminal SiTef** mostra com qual Terminal esse caixa se identifica perante o SiTef. ![Seção Terminal SiTef do detalhe de um caixa: Vinculado, Caja Test 12121212 e o botão 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) Com um Terminal vinculado aparece **Vinculado** e o botão **Desvincular**. Sem Terminal, a seção oferece os Terminais livres da loja; se não restar nenhum, ela avisa: ![Seção Terminal SiTef de um caixa sem Terminal: não há Terminais SiTef livres, crie-os na configuração da loja](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) ### Ao criar o slot de um caixa novo Em **Fire POS → Terminais → Criar slot**, o campo **Terminal SiTef (opcional)** permite escolher um Terminal livre para o caixa que vai ser instalado. O caixa fica vinculado a esse Terminal quando o dispositivo se vincula com o código do slot. O campo só aparece em lojas do Brasil e só se houver Terminais livres. ## Editar ou excluir um Terminal Na coluna **Ações** da tabela: * **Editar** (lápis) muda o nome, o código ou o token TLS. O token não é mostrado de novo: digite-o só para substituí-lo, ou use **Remover token**. * **Excluir** (lixeira) apaga o Terminal. O caixa vinculado deixa de cobrar com cartão até você vincular outro. ![Diálogo de edição do Terminal SiTef com o nome Caja Test, código 12121212 e token TLS sem carregar](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) Se você apagar um caixa em **Terminais**, o Terminal SiTef dele fica livre para outro. ## Produção e ambiente de testes Os dados do cartão SiTef e de cada Terminal mudam conforme onde o caixa cobra. Cada ambiente do Fire tem a sua própria configuração: o que você cadastra no backoffice de testes não passa para a produção. ### Em produção Em produção o caixa se conecta ao **servidor SiTef** da operação pelo IP, igual aos quiosques da loja. A Fiserv entrega três dados: o **IP do SiTef**, o **código da loja** e um **número de terminal** por caixa. **1. Peça os dados à Fiserv** O IP do servidor SiTef, o código da loja ("Empresa") e um número de terminal por caixa. O número de cada caixa precisa ser diferente do dos outros caixas e do dos quiosques da loja. **2. Instale o agente de produção em cada caixa** O pacote `agenteCliSiTef-…-Producao-Win64` que a Fiserv entrega, no lugar do agente do simulador. Ele é instalado como serviço do Windows com os scripts da pasta `helper`. **3. Cadastre os dados no Fire** No passo 1, o IP em **Servidor SiTef**, o **Código da loja SiTef**, os CNPJ e a senha de supervisor reais. No passo 2, um Terminal por caixa com o seu número em **Terminal SiTef**; o **Token TLS** fica vazio. Depois vincule cada Terminal ao seu caixa (passo 3). **4. Faça uma venda de teste em cada caixa** Uma venda pequena com cartão, e o seu cancelamento em **Estornar transação com cartão**, confirmam que o caixa chega ao SiTef com o seu número de terminal. Não é preciso mexer na configuração do agente no caixa: o POS envia a ele o IP, o código da loja e o número de terminal em cada operação, com os dados que você salvou no Fire. > [!NOTE] > > **Se a Fiserv conectar a loja pela plataforma TLS** em vez de um IP, cada caixa precisa também de um **token TLS**, gerado no Portal Administrativo do SiTef e cadastrado no Terminal desse caixa. O caixa se registra sozinho na primeira operação e depois é preciso aprová-lo no Portal. A rede precisa liberar a porta 443 para `tls-prod.fiservapp.com` e `postls-prod.fiservapp.com`, e o registro fica guardado no PC do caixa, em `C:\CliSiTef\NaoExcluirControleCliSiTef\\`. ### Em testes (homologação com o simulador) Em testes o caixa fala direto com o **SiTdemo**, o simulador do SiTef, sem TLS: * O agente é o do simulador, e o SiTdemo roda na mesma rede ou no mesmo PC. * Em **Servidor SiTef** vai o IP do SiTdemo: `127.0.0.1` se ele roda no mesmo PC. * **Código da loja** `00000000` e um código de Terminal de teste por caixa. * **Token TLS vazio**: o SiTdemo não usa TLS. * **Habilitado** ligado só na loja de testes. ### O que muda entre testes e produção | Dado | Testes | Produção | | - | - | - | | Agente | AgenteCliSiTef do simulador | Pacote `…-Producao-Win64` da Fiserv | | Servidor SiTef | IP do SiTdemo | IP do servidor SiTef que a Fiserv fornece | | Código da loja | `00000000` | O que a Fiserv atribui | | Terminal por caixa | Código de teste | O número que a Fiserv atribui a cada caixa | | Token TLS | Vazio | Vazio, salvo conexão pela plataforma TLS | | Rede da loja | Local | Acesso ao servidor SiTef (igual aos quiosques) | ## Quando um caixa cobra com cartão | Situação | Cobra com cartão e PIX? | | - | - | | A loja não é do Brasil | Não | | A loja não tem dados SiTef salvos | Não | | **Habilitado** desligado | Não, em nenhum caixa da loja | | SiTef ligado, mas o caixa sem Terminal vinculado | Não | | SiTef ligado e o caixa com o seu Terminal | Sim | ## Exemplo No Laboratorio Brasil há 7 caixas registrados e um único Terminal SiTef: | Terminal | Código | Caixa vinculado | Resultado | | - | - | - | - | | Caja Test | `12121212` | BR-K000-POS-122 | Cobra com cartão e PIX | | — | — | BR-K000-POS-121 e os outros 5 | Não cobram com cartão nem PIX | Para o BR-K000-POS-121 cobrar com cartão é preciso criar um segundo Terminal com o seu próprio código e vinculá-lo a esse caixa. Reusar `12121212` não é permitido. ## Erros que saem caros > [!WARNING] > > **Desligar Habilitado ou excluir um Terminal em horário de venda.** O caixa deixa de oferecer cartão na próxima venda. Se o cliente só pode pagar com cartão, a venda se perde. > [!WARNING] > > **Remover a senha de supervisor.** O POS a usa para devolver só a cobrança com cartão quando o pedido não pode ser registrado. Sem senha essa devolução não começa: o cliente fica cobrado e é preciso estornar à mão pelo caixa. > [!WARNING] > > **Cadastrar o código de Terminal errado.** O SiTef identifica o caixa por esse código. Com o de outra loja ou um digitado errado, as vendas, as pendências e os cancelamentos ficam em nome de outro Terminal no SiTef. > [!WARNING] > > **Cadastrar um token TLS quando a loja se conecta por IP.** Com token, o caixa tenta se conectar à plataforma TLS da Fiserv em vez do seu servidor SiTef e não cobra. Em testes, e em produção por IP, o **Token TLS** fica vazio. > [!WARNING] > > **Com conexão TLS: apagar a pasta de registro ou reinstalar o PC de um caixa.** O caixa perde o registro TLS e não cobra com cartão até se registrar de novo com um token novo da Fiserv. ## Glossário | Termo | O que é | | - | - | | **Terminal SiTef** | O código de 8 caracteres com o qual o SiTef identifica um caixa. | | **Código da loja SiTef** | A "Empresa" da loja registrada no SiTef. | | **AgenteCliSiTef** | O programa instalado no caixa que conecta o POS com o SiTef e o pinpad. | | **Senha de supervisor** | A senha que o SiTef pede para cancelar transações. | | **Token TLS** | O registro da Fiserv que habilita a conexão segura de um terminal em produção. | | **Caixa vinculado** | O caixa POS que usa um Terminal SiTef. | | **Plataforma TLS da Fiserv** | A entrada pela internet ao SiTef quando a loja não se conecta por IP; registra e valida cada caixa. | | **Portal Administrativo do SiTef** | O site da Fiserv onde se geram os tokens TLS e se aprovam os caixas. | ## Perguntas frequentes > **É preciso reiniciar o POS depois de mudar a configuração?** > > Não. O Fire avisa os caixas da loja e a próxima venda com cartão já usa os dados novos. > **O token TLS é usado uma única vez?** > > Sim, e só se a loja se conecta pela plataforma TLS da Fiserv. O caixa se registra com ele na primeira vez e fica registrado naquele PC. Se você trocar ou reinstalar o PC, peça à Fiserv um token novo e cadastre-o no Terminal desse caixa. > **Posso usar o mesmo Terminal em dois caixas?** > > Não. O Fire rejeita, porque o SiTef misturaria as pendências e os cancelamentos dos dois caixas. Cada caixa precisa do seu próprio código. > **Ao cobrar com cartão o caixa mostra «Processador de pagamento indisponível»** > > Falta a configuração SiTef nesse caixa: ele não tem Terminal vinculado, ou o SiTef da loja está desligado ou sem salvar. O aviso menciona o agente, mas neste caso a causa está no Fire: revise os passos 1 a 3. > **Não vejo os cartões do SiTef em Config por loja** > > A loja escolhida no cabeçalho não é do Brasil. Os cartões do SiTef só aparecem em lojas do Brasil. > **Em Criar slot não aparece o campo Terminal SiTef** > > Não há Terminais livres na loja. Crie um em **Config por loja** e abra **Criar slot** de novo. > **O que acontece com o Terminal se eu apagar o caixa?** > > Ele fica livre e você pode vinculá-lo a outro caixa. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.