Cartões Recebimento com Cartão no sistema Diferença entre POS x TEF Atualmente, aceitar pagamentos por cartões tem se tornado indispensável para os estabelecimentos comerciais, e para que isso seja possível, o estabelecimento precisa optar pela tecnologia que irá utilizar. Os mais comuns são o POS (Point of Sale - ponto de venda) e o TEF (Transferência Eletrônica de Fundos). O que é o POS? O POS é a famosa "maquininha de cartão", que o garçom pode levar até a sua mesa, para que você não precise ir até o caixa para pagar a sua conta. Basta inserir o cartão, digitar o valor e a senha, e o comprovante será impresso. Estas maquininhas, são fornecidas por agências bancárias ou redes adquirentes. Sua principal vantagem é a mobilidade, pois poderá leva-lá de um lugar a outro, e também utilizá-la nas entregas de delivery, caso possua este serviço. A desvantagem, é que o POS é mono-adquirente, ou seja, possui apenas uma rede adquirente. Neste caso, talvez seja necessário possuir outros aparelhos POS de outras administradoras, para aceitar as diversas bandeiras de cartão. Outro ponto é a conferência das vendas do estabelecimento, pois precisará guardar os recibos dos comprovantes e somá-los ao final do dia. Nos casos de volume de vendas muito altos, o processo de conferência pode ser bem trabalhoso, além de que deve se ter muito cuidado ao digitar o valor no momento da venda, para não cobrar um valor incorreto. O que é o TEF? O TEF é um software integrado ao sistema de gestão, que fica instalado no computador do caixa. Este software recebe as informações da venda do sistema de gestão, captura os dados do cartão através do PIN PAD, e se comunica com a rede adquirente via internet. Após realizada a transação, o comprovante é impresso por uma impressora térmica. É muito comum em supermercados, farmácias e varejos com grande volume de vendas, devido a praticidade e agilidade nos recebimentos, evitando filas. O TEF é multi-adquirente, ou seja, está integrado com diversas administradoras, aceitando diversas bandeiras de cartões, o que é uma vantagem e que torna o processo muito mais rápido e pratico. Sua principal desvantagem é a mobilidade, pois o PIN PAD fica conectado ao computador, onde será necessário que o cliente vá até o caixa para efetuar o pagamento da sua conta. Alguns estados não permitem o uso do POS para realizar os recebimentos em cartão, sendo necessário o uso do TEF. Cada gestor, deverá avaliar os prós e contras de cada tecnologia, e escolher a melhor opção para a sua empresa. Lembrando ainda, que se necessário, é possível utilizar as duas tecnologias em sua empresa. Enquanto o POS possui maior mobilidade, ainda assim exige do operador o registro das informações da venda no sistema de gestão. Já no TEF, ocorre a comunicação com o sistema de gestão, que já possui todas as informações necessárias facilitando o controle e diminuindo o risco de erros por digitação. POS - Point of Sale (Ponto de Venda) TEF - SiTef  Atualmente o Sistema tryideas está integrado com a SiTef. Neste artigo, iremos detalhar as configurações necessárias no sistema tryideas, bem como o funcionamento na realização de recebimentos em cartão ou carteiras digitais, utilizando o TEF. 1. Contratação do TEF (SkyTEF) (Incluir os passos necessários - Contratação - Assinatura de Contrato - Instalação do módulo SiTef, etc). Solicitar ao cliente interessado um número de Contato;Enviar os dados do Contato (Nome e Telefone) e o Nome da Empresa para o Diego (programação), que irá repassar o contato para a Claudia, que é do Comercial da Skytef. Ela irá entrar em contato com o cliente para alinhar os detalhes e enviar o contrato. Preenchimento do Formulário;Após todos os tramites do contrato serem concluídos, o cliente irá receber um formulário para preencher algumas informações relacionadas a software house, técnico responsável pelo acompanhamento da instalação (que deverá ser alguém da tryideas, e que fará as configurações necessárias), bandeiras utilizadas, dentre outros detalhes dos cartões. Recebimento de e-mail para agendamento da Instalação do TEF;Alguns dias depois, o cliente irá receber um e-mail, que possuíra um link para o agendamento do dia e horário da instalação e configuração do TEF. É importante o cliente confirmar com o atendente da tryideas que está como responsável pelo acompanhamento, a disponibilidade de dia e horário a serem agendados. Instalação, configuração e testes do SiTef;No dia da instalação, a Skytef irá realizar a configuração do SiTef em uma máquina virtual, e irá repassar os dados para serem configurados no sistema tryideas, como IP de comunicação entre outros. Os passos para a configuração estão descritos logo abaixo, basta seguir os processos e ao final realizar os testes necessários. 2. Configurações tryideas Antes de tudo, precisamos realizar algumas configurações para possibilitar o uso dos recebimentos em cartão, via TEF. Acesse o menu: Configurações > Configurações Adicionais > SiTef.-> Filial - Selecione a Filial que será configurada para o uso do TEF;-> Endereço SiTef - Informe o endereço (ou IP) onde está configurado o SiTef; (127.0.0.1)-> Número da Loja - Informe o Número da Loja (com 8 caracteres);Clique em Salvar, para aplicar as configurações realizadas. Após isso, iremos configurar uma sessão para o Operador de Caixa. Podemos considerar como uma numeração de PDV, ou seja, considere como os Caixas de um Supermercado, onde cada Operador possui o seu Caixa, e estes possuem uma numeração distinta. Desta forma, caso a empresa possua mais de um Caixa, para cada Operador será necessário realizar esta configuração, utilizando números de terminais diferentes. Neste passo iremos acessar o menu: Configurações > Configurar Sessão.-> Descrição - Insira uma descrição para a Sessão, como por exemplo "TEF";-> Operador - Selecione o Operador de Caixa, para o qual está sendo realizado a configuração da Sessão;-> Impressora Térmica - Na coluna "Impressora Térmica", defina a impressora que fará a impressão dos comprovantes das transações do TEF;-> Térm. Auto? - Selecione esta opção para habilitar a impressão automática-> Nº Terminal SiTef - Localize a coluna "Nº Terminal SiTef", e informe o número do terminal do caixa (Ex: SW000001, SW000002....). Cadastro da Administradora Menu: Cadastros > Financeiro > Cadastrar Administradoras (ou Consultar Administradoras). Administradora - Informe uma descrição para identificar a credenciadora SiTef;Conta Depósito* - Selecione uma Conta Bancária a qual irá receber pelas movimentações em cartão ou carteiras digitais;Despesa Taxas* - Selecione uma Despesa para o lançamento das taxas;Receita* - Selecione uma Receita, para o lançamento dos valores recebidos em cartão ou carteiras digitais;CNPJ Credenciadora - Informe o CNPJ que será destacado nos Dados de Pagamento da NFCe. * Os campos destacados, serão considerados na geração de Lote dos Recebimentos em Cartão, após o vencimento que será configurado logo abaixo para os Produtos/Serviços. Cadastro de Produtos/Serviços Menu: Cadastros > Financeiro > Cadastrar Produtos/Serviços (ou Consultar Produtos/Serviços). Descrição - Informe uma descrição para identificar o Produto/Serviço;Filial - Selecione a Filial relacionada ao cadastro;Administradora - Selecione a Administradora cadastrada no passo acima;Limite de Parcelas - Informe o Limite de Parcelas caso necessário. A quantidade de Parcelas deverá será definida durante a transação, caso selecionado a opção "parcelamento". Não existe opção do sistema enviar esta informação conforme o parcelamento definido na tela de recebimento.Tipo de Cartão - Esta opção permite agilizar o processo de recebimento, evitando precisar selecionar se é Crédito, Débito, Carteira Digital, etc durante a comunicação com o SiTef. Basicamente uma tela a menos será necessária caso configure o Tipo de Cartão previamente, sendo possível já deixar configurado um registro de cada opção (Crédito, Débito e PIX). Para o Controle de Geração de Lotes dos recebimentos em Cartão no sistema tryideas, onde os valores são creditados na Conta bancária configurada no dia do vencimento da parcela, existem duas opções: 1) Definir o número de Parcelas na tela de recebimento, e também durante a transação com o TEF.2) Desabilitar a geração de lotes automática, e realizar o controle dos recebimentos e das taxas manualmente; Recomendamos criar um numerário rápido para os Produtos/Serviços do TEF, afim de agilizar nos recebimentos. 3. Guia de uso Iremos apresentar abaixo o fluxo de um recebimento em cartão ou carteiras digitais pelo TEF, após realizar a venda de Produtos, Serviços, ou algum outro recebimento avulso. A tela de recebimentos, conforme a imagem abaixo será exibida, onde possuímos o valor a ser recebido, e também podemos visualizar os numerários criados a partir do cadastro de Produtos/Serviços realizados no passo acima. Vamos simular diferentes situações que ocorrem no dia-a-dia, para entendermos como iremos proceder nos diferentes processos de recebimento, em situações de utilizar um cartão ou vários para o recebimento de uma conta. 1. Recebimento do Valor integral em apenas UM Cartão ou no PIX Nesta situação, podemos clicar sobre o numerário (ou utilizar o atalho, ex: (Control + 5) ou o número desejado), onde o valor total será atribuído ao numerário e clicamos em Gravar (F5) para confirmar o recebimento. 2. Recebimento parcial em Cartão e restante em Dinheiro Neste caso iremos informar o Valor que iremos receber no Cartão diretamente na coluna "Valor" do numerário desejado (Crédito ou Débito), e o valor restante será recalculado para o numerário Dinheiro. 3. Recebimento parcial no Cartão de Crédito, parcial no Débito e restante em Dinheiro Semelhante a situação acima, iremos definir o Valor recebido no Crédito, o Valor em Débito e o restante ficará aplicado para o numerário Dinheiro. 4. Recebimento em DOIS Cartões de Crédito e o restante no Cartão de Débito Neste caso, iremos utilizar o numerário CARTÃO que nos permite selecionar o Produto/Serviço desejado e informar o Valor. Esta opção permite a inclusão de vários Cartões do mesmo tipo, ou seja, podemos incluir mais de um recebimento com o mesmo Produto/Serviço. Após a inclusão dos valores dos dois cartões de Crédito, atribuímos o valor restante ao numerário rápido "Débito". É possível também realizar o cadastro de mais de um Produto/Serviço "Crédito", como por exemplo, "Crédito 1", "Crédito 2" e "Crédito 3", caso tenha situações de recebimentos em até TRÊS Cartões de crédito diferentes.Esta opção agilizaria o recebimento, visto que podemos inserir o valor desejado diretamente no numerário rápido. É uma opção a ser analisada para cada tipo de uso. Agora que vimos algumas situações que podem ocorrer no dia-a-dia, vamos para o fluxo de comunicação com o SiTef. Comunicação com o SiTef Após definirmos o valor dos numerários que o cliente irá utilizar para pagar, iremos clicar em "Gravar", na tela de Recebimento, e se algum Numerário utilizado esteja configurado para utilizar o TEF, uma nova tela será exibida. Esta tela requer a interação e atenção do Operador de Caixa para o correto registro e confirmação das transações. Vamos aos exemplos de uso das opções, conforme ilustrações abaixo. Recebimento à Vista no Cartão de Crédito - Na tela de seleção de Formas de Pagamento, selecione a opção "A Vista". Recebimento Parcelado no Cartão de Crédito - Na tela de seleção da Forma de Pagamento, selecione a opção "Parcelado" e a seguir informe o número de Parcelas. Recebimento em DOIS Cartões (Crédito e Débito) - Nesta situação, as transações são realizadas uma logo após a outra. O Cliente deverá observar no PINPAD o Valor que está sendo exibido, para identificar qual Cartão deverá inserir ou aproximar no pinpad para a transação. Cancelamento da Transação em andamento - Caso deseje cancelar uma transação em andamento, basta utilizar a tecla ESC do teclado, ou clicar em Cancelar Solicitação no botão do rodapé da tela, quando este estiver sendo exibido. Cancelamento de Transação já confirmada (Transação Gerencial) - Caso necessite cancelar uma transação já finalizada, ou seja, após a impressão dos comprovantes e finalização do recebimento, é possível realizar uma Transação Gerencial. Para isso acesse o menu: Caixa > Consultar Transações TEF. Para este processo, o cliente deverá estar presente de posse do Cartão utilizado na transação, e possuir o comprovante do pagamento. (É possível também visualizar os dados da transação necessários na tela de consulta que acabamos de abrir). Na ilustração abaixo, observe que pesquisamos a transação que desejamos cancelar, para facilitar na visualização dos dados. Ao clicar na Transação Gerencial será iniciado a comunicação com o SiTef, sendo exibida uma tela com as opções disponíveis. Selecione a opção de Cancelamento de Transação; Após isso informe a Senha do Supervisor (obtenha esta senha com o suporte da tryideas, caso não a possua); Selecione o tipo de cancelamento conforme a transação original, Cancelamento de cartão de Débito ou Crédito; Informe o Valor da Transação que deseja cancelar; Informe a Data da Transação; Após isso será solicitado para inserir o número do documento a ser cancelado. Informe o NSU Host neste passo, que pode ser visualizado na tela de consulta de transações, ou no comprovante impresso. E por fim, será solicitado para inserir o Cartão no pinpad, para confirmar o cancelamento da transação. Se todas informações inseridas estiverem corretas, e nenhuma divergência ocorrer, ou alguma mensagem de erro aparecer, a transação estará cancelada. Recebimento em PIX O processo para recebimento em PIX é simples, após iniciar a comunicação com o SiTef, o QRCode será exibido no pinpad caso este possua suporte, ou então será exibido na tela, para que o cliente faça a leitura pelo seu aplicativo do banco instalado em seu celular. Após a confirmação da transação, a tela será fechada e o recebimento finalizado. Dúvidas gerais 1) Em um recebimento em 2 cartões, o cliente passou o primeiro cartão, informou a senha tudo ok, e no segundo cartão ocorreu um erro, ou não possuía limite suficiente no cartão, como fica a transação?R: Caso alguma transação não seja finalizada corretamente, todas as anteriores são canceladas automaticamente. 2) No meio da Transação de um recebimento em cartão, houve uma queda de energia, a transação será cancelada? R. Sim. Caso ocorra uma queda de energia, uma reinicialização da aplicação ou do computador, etc, assim que a próxima transação for iniciada, as transações pendentes serão canceladas automaticamente. 3) Quais as instituições integrados com a SiTef para o recebimento em PIX? R. Certificações concluídas até 08/11/2022: Ailos Banco Senff AS Banco do Brasil Banco Original Bradesco Cielo Gerencianet Itaú Mercado Pago PagSeguro PagBank Quero Quero Pag (VerdeCard) Realize CFI Santander Sicoob Sicredi Tribanco 4) O que fazer em caso de erros ou problemas durante a transação TEF, como por exemplo 31 - Erro PINPAD ? R. O ideal é solicitar suporte através do Assistência Segura, onde o técnico irá analisar o problema ocorrido, e dependendo da situação, deverá ser solicitado o suporte da SkyTef, pelo telefone 0800 9797 625 ou (11) 2175-9501, ou pelo chat no seguinte link. Para o Erro 31, tente executar os seguintes passos. Abra o Gerenciador de Dispositivos, e nos Controladores USB e Portas (COM e LPT), verifique se existem portas do PINPAD (PPC930 por exemplo, no caso da Gertec) com a descrição esmaecida, como se estivessem desabilitados. Caso possua, faça uma limpeza removendo essas portas. Para o erro 31, pode acontecer de o pinpad não estar instalado corretamente no computador,  nesta caso, entrei em contato com o suporte da Skytef, que fizeram a instalação do drive do pinpad, depois da instalação, desconectamos e conectamos ele novamente no computador, e funcionou corretamente. Após isso reabra o sistema e faça um novo teste de transação em Cartão, para verificar se o PINPAD responde. Outra dica é desconectar o PINPAD e reconectar, pois em alguns casos pode ficar travado, desta forma será reiniciado. 5) Quando aparecer a mensagem Sem conexao Servidor, o que fazer? R. Esta mensagem será exibida quando não for possível uma comunicação do computador local, com o servidor do Sitef, seja por algum bloqueio, ou por outros motivos. Opção 1: reiniciar o serviço da VPN, para isso abra o services.msc e localize o serviço WNB Monitor, e reinicie o serviço. Após isso, tente realizar a transação novamente. 6) Quando aparecer a mensagem Retorno não catalogado - [Código 99], o que fazer? R. Geralmente, o problema ocorre após a Skytef atualizar a dll do sistema. Ocorre que eles verificam o nome do arquivo CliSiTef32l.dll e transferem a dll 32 bits, porém utilizamos a versão x64, onde apenas renomeamos a dll. Para corrigir o problema, é necessário solicitar a dll 64 bits, e renomear o arquivo para 32, e reabrir o sistema para carregar a dll correta. Contato do suporte da Skytef Telefones: 0800 9797 625 ou (11) 2175-9501 E-mail: suporte.tef@skytef.com.br Se nenhuma das opções acima resolver o problema, entre em contato com o suporte da SkyTef, onde eles irão realizar uma conexão remota via TeamViewer (o executável geralmente está na area de trabalho, é o mesmo utilizado na instalação. Segue link para instalação). TEF Cloud 1. O que é o TEF Cloud? O TEF Cloud é a solução do TryERP para realizar pagamentos eletrônicos diretamente pelo sistema, principalmente no uso de VM (sistema em nuvem). Atualmente integra com o provedor ControlPay/PayGo, permitindo realizar cobranças em cartão de crédito, débito, voucher, PIX e carteira digital diretamente pelo sistema, sem necessidade de software TEF dedicado instalado na máquina. A comunicação é feita via API REST com o servidor do ControlPay, que por sua vez se comunica com o aplicativo PayGo Windows instalado no computador do caixa (que controla o PIN Pad). Com ele, você pode receber pagamentos por: Cartão de crédito Cartão de débito PIX Vale alimentação/refeição (voucher) Carteiras digitais Tudo isso integrado ao seu caixa, utilizando o PIN Pad, sem necessidade de sistemas adicionais complexos. 2. Como funciona? De forma simples: O operador inicia a cobrança no sistema O TryERP envia a solicitação para o sistema de pagamento O PIN Pad é ativado automaticamente O cliente realiza o pagamento (cartão ou PIX) O sistema recebe o retorno A venda é finalizada automaticamente ✔️ Tudo acontece em poucos segundos✔️ Sem digitação manual de valores no PIN Pad 3. O que é necessário para usar? Antes de utilizar o TEF Cloud, é necessário: Ter uma conta ativa no sistema de pagamentos (ControlPay / PayGo) Ter o PayGo Windows instalado no computador do caixa Ter um PIN Pad conectado Estar com acesso à internet 4. Configuração do TEF Cloud A configuração é feita no sistema: Caminho:👉 Configurações Adicionais → Aba TEF Cloud 4.1 O que precisa ser preenchido? Os principais campos são: Filial: selecione a empresa que será configurada URL da API: normalmente já vem preenchido automaticamente Senha ControlPay: senha do seu acesso ao sistema de pagamentos (opcional, apenas para obter a chave de integração) Chave de Integração: obtida automaticamente pelo botão Terminal Padrão: identificação do seu PIN Pad Produção: marque quando for utilizar em ambiente real Ativo: habilita o uso do TEF Cloud 4.2 Botões disponíveis Login / Obter Chave→ Busca automaticamente a chave de integração Testar Conexão→ Verifica se está tudo funcionando corretamente Salvar→ Grava as configurações 5. Configuração por Operador (Terminal TEF Cloud) Além da configuração da filial, é obrigatório configurar o terminal por operador (caixa/PDV). Onde configurar Caminho:👉 Configurações → Configurar Sessão Campo obrigatório Terminal TEF CloudCódigo identificador do terminal de pagamento vinculado ao operador. Como funciona Cada operador (caixa) deve possuir um terminal próprio Esse código define qual PIN Pad será utilizado A configuração é individual por estação Exemplo Caixa 1 → Terminal 5453 Caixa 2 → Terminal 5454 Caixa 3 → Terminal 5455 Importante Configuração obrigatória para funcionamento Sem esse campo preenchido, pagamentos não serão iniciados Não compartilhar o mesmo terminal entre caixas simultaneamente 6. Como realizar um pagamento Durante uma venda: Escolha a forma de pagamento (cartão, PIX, etc.) O sistema abrirá a tela de processamento O PIN Pad será ativado O cliente realiza o pagamento Aguarde a confirmação 7. Status do pagamento Durante o processo, você poderá visualizar o status: Aguardando → iniciando operação Em processamento → cliente está pagando Aprovado → pagamento concluído com sucesso Negado → pagamento recusado Cancelado → operação cancelada Erro → falha na comunicação 8. Cancelar um pagamento O cancelamento (estorno) de uma transação TEF Cloud pode ser realizado de duas formas: 1. Pela tela de Transações TEF Acesse a tela de consulta de transações (Caixa > Consultar Transações TEF) Selecione a venda desejada Clique em Cancelar TEF Cloud Confirme a operação 2. Pelo cancelamento da venda (NFe/NFCe ou Movimento) Quando a transação estiver vinculada a uma venda, o processo pode ser ainda mais simples: Acesse a consulta de NFe/NFCe ou o Movimento Solicite o cancelamento da venda O sistema exibirá uma mensagem de confirmação Ao confirmar, o estorno TEF será realizado automaticamente ⚠️ Importante Não é necessário realizar o cancelamento em duas telas O estorno é feito automaticamente junto com o cancelamento da venda O processo garante mais agilidade e evita erros operacionais ⚠️ Importante:O cancelamento irá solicitar o Cartão utilizado na transação e a confirmação no PIN Pad. 9. Consulta de transações Na tela de consulta, você pode: Visualizar todas as vendas realizadas Filtrar por período Conferir status Ver dados como: Valor Autorização NSU Forma de pagamento 10. Reimpressão de comprovante Caso necessário: Selecione a transação Clique em Reimprimir Via 11. Dicas importantes ✔️ Sempre teste a conexão após configurar✔️ Verifique se o PIN Pad está conectado corretamente✔️ Não feche a tela durante uma transação em andamento 12. Possíveis problemas e soluções PIN Pad não abre Verifique se o PayGo está instalado e rodando Erro de conexão Verifique a internet Teste a conexão nas configurações Transação não finaliza Aguarde alguns segundos (tempo de processamento) Caso necessário, consulte a transação depois 13. Suporte Em caso de dúvidas ou problemas: Entre em contato com o suporte do sistema Tenha em mãos: Data da transação Valor Número da autorização (se houver) ✅ Conclusão O TEF Cloud traz mais praticidade, segurança e agilidade para o seu caixa, integrando os pagamentos diretamente ao sistema e evitando erros manuais. TEF Cloud - Instalação/Configuração 1. Visão Geral O TEF Cloud no TryERP utiliza o ControlPay (PayGo) como intermediador de pagamentos, com comunicação via API REST e execução local através do PayGo Windows. Essa documentação tem como objetivo orientar o time de suporte na configuração correta e resolução de problemas. 2. Instalação do PayGo Windows Para o funcionamento do TEF Cloud, é obrigatório instalar o PayGo Windows em cada estação (caixa/PDV) que receberá pagamentos. 📥 Download 👉 https://paygodev.readme.io/docs/kit-de-integração-1 Acessar a página do link acima Localizar Kit de Integração Clicar em “Clique aqui” para baixar 💻 Instalação Executar o instalador baixado Informar o CPF ou CNPJ da empresa Inserir o ID de instalação recebido Inserir a Senha recebida Clicar em Ativar Quando solicitar a Porta USB do PIN PAD, digite 0 (zero) e tecle ENTER ▶️ Execução O PayGo será executado e ficará disponível ao lado do relógio do Windows (bandeja do sistema) ⚙️ Configuração inicial Após a instalação: Abrir o PayGo (ícone na bandeja) Acessar Configurações Validar: Comunicação com PIN Pad Configuração de impressão (se aplicável) ⚠️ Importante O PayGo deve estar em execução para que o TEF funcione Deve ser instalado em todas as máquinas de caixa O PIN Pad deve estar corretamente conectado e reconhecido Sem o PayGo, nenhuma transação será iniciada 🧪 Teste recomendado Após instalar: Acessar a opção Testar conexão com PIN Pad dentro do PayGo Garantir que o dispositivo responde corretamente 3. Configuração no Painel ControlPay O ControlPay possui configurações essenciais que impactam diretamente o funcionamento do ERP. 3.1 Geração da Chave de Integração ⚠️ IMPORTANTE O botão “Login / Obter Chave” do ERP NÃO deve ser utilizado, pois gera uma chave com validade (expira). ✅ Procedimento correto: Acessar o painel ControlPay Ir em:Integrações / Config → Aba Chaves de Integração Clicar em Nova chave Preencher: Nome: tryerp (ou outro identificador) Não informar data de expiração Salvar Copiar a chave gerada para o ERP 3.2 Configuração de Terminais 📍 Menu: Terminais Regras: Cada PDV = 1 terminal Código será usado no ERP Não compartilhar entre caixas 4. Configuração do TEF Cloud no ERP (Por Filial) 📍 Configurações → Configurações Adicionais → Aba TEF Cloud Campos Filial Configuração independente por empresa Provedor ControlPay URL da API Ambiente URL Sandbox https://sandbox.controlpay.com.br/webapi Produção https://api.controlpay.com.br Senha ControlPay ❌ Não utilizar Chave de Integração Deve ser gerada no ControlPay ❗ Sem expiração Terminal Padrão Terminal fallback (informar o número do terminal padrão a ser utilizado, caso não seja definido na sessão, ou logado com sessão incorreta). Atenção a essa configuração, o terminal do Operador precisa ser utilizado no mesmo Caixa para onde foi configurado, pois existe um "vínculo" da instalação do ControlPay na máquina com o terminal configurado para o Operador. Em resumo, imagine o sistema executando na nuvem, ao iniciar a transação envia um comando para a api do PayGo onde é enviado o terminal, e a api vai se localizar e se comunicar com o app instalado na máquina. Se possuir 2 caixas e inverter os Operadores, o PayGo será exibido no PDV incorreto. Senha Técnica Usada para cancelamento Deve coincidir com ControlPay Timeout Padrão: 120s Polling Padrão: 3s Produção Marca ambiente real Ativo Habilita TEF Botões ❌ Login / Obter Chave → não usar ✔️ Testar Conexão → validar integração ✔️ Salvar ⚠️ Erros comuns Chave expirada URL incorreta Integração inativa 5. Configuração por Operador (Sessão) 📍 Configurações → Configurar Sessão Campo obrigatório Terminal TEF Cloud Regras Cada operador = 1 terminal Deve existir no ControlPay Define o PIN Pad utilizado 6. Senha Técnica (Cancelamento) A senha técnica é utilizada para realizar estornos. 📍 Onde obter: ControlPay → Integrações / Config → Aba Opções da Venda 📌 Configuração: Copiar a senha técnica Informar no ERP em: Configuração TEF Cloud (por filial) ⚠️ Regra importante: O cancelamento só pode ser feito pelo mesmo terminal que realizou a venda 7. Cancelamento de Transações Regras: Cancelamento depende da senha técnica correta Deve ser feito pelo mesmo terminal Pode ser feito: Pela tela de transações TEF Pelo cancelamento da venda (NFe/NFCe/Movimento) 8. Configuração do PayGo Windows (Impressão) O PayGo pode ser responsável pela impressão dos comprovantes. 📍 Caminho: Abrir o PayGo (ícone ao lado do relógio) Acessar Configurações ⚙️ Configurar: Habilitar: Serviço de impressão automático Tipo: Windows Selecionar impressora desejada ⚠️ Integração com ERP: Se a impressão for feita pelo PayGo: 👉 No ERP (Configurar Sessão): Marcar opção: Não imprimir TEF Cloud 🔁 Regra: Situação Configuração Impressão via PayGo ERP NÃO imprime Impressão via ERP PayGo NÃO imprime 9. Cadastro de Administradoras Foram adicionados novos campos para otimizar o fluxo de pagamento. Novos campos: Adquirente Cartão Adquirente PIX Funcionamento: Se preenchido: O PayGo não solicita seleção Fluxo direto para pagamento Se não preenchido: Operador precisa escolher a adquirente 📌 Quando usar: Cliente possui múltiplas adquirentes Deseja automatizar o fluxo 10. Cadastro de Produtos / Serviços Para melhorar a automação no pagamento: Configuração obrigatória: Definir o Tipo de Cartão: Crédito Débito PIX Benefício: PayGo já recebe a informação Não exibe opções para o operador Processo mais rápido e sem erros 11. Logs do Sistema Os logs são essenciais para análise de problemas. 📁 Local: {diretório do sistema}\logs 📄 Nome do arquivo: TEFCloud_Terminal{codigo}_{ddMMyyyy}.log 📌 Exemplo: TEFCloud_Terminal5453_18032026.log 📊 Conteúdo: Envio de transações Retornos da API Status de processamento Erros 🕒 Retenção: Mantidos por 7 dias Após isso, são removidos automaticamente 12. Log Detalhado (Debug) Para análise avançada: 📍 Caminho: 👉 Configurações → Configurações Globais→ Financeiro → Configurações do Caixa Opção: Habilitar log detalhado do TEF Cloud 🔍 O que muda: Salva JSON completo: Requisição Resposta da API ⚠️ Uso recomendado: Apenas para suporte / diagnóstico Pode gerar arquivos maiores 13. Boas Práticas de Suporte Sempre validar: Chave de integração (sem expiração) Terminal configurado corretamente Senha técnica válida Conferir se o PayGo está aberto Validar conexão com internet Verificar logs antes de acionar terceiros Desativar economia de energia USB No gerenciador de dispositivos, em cada USB Root Hub, abra as propriedades e na aba Gerenciamento de Energia, desmaque a opção "O computador pode desligar...", após isso clique em OK para salvar. 14. Problemas Comuns ❌ Transação não inicia Terminal não configurado Chave inválida PayGo não aberto ❌ Erro ao cancelar Senha técnica incorreta Tentativa em terminal diferente ❌ PIN Pad não responde PayGo não está rodando Problema de driver/conexão ❌ Impressão duplicada PayGo e ERP imprimindo juntos 15. Checklist Rápido (Suporte) Antes de escalar: ✔️ PayGo aberto ✔️ PIN Pad funcionando ✔️ Terminal configurado ✔️ Chave válida ✔️ Senha técnica correta ✔️ URL correta ✔️ Integração ativa 16. Considerações Finais A maioria dos problemas está relacionada a: Configuração incorreta de terminal Uso de chave expirada Falha na instalação/configuração do PayGo 17. Dados para Integração com PayGo (ACBr) Para ativação do TEF Cloud junto ao PayGo, é necessário realizar um cadastro junto ao integrador (ACBr), que fará a validação dos dados com a adquirente. 📌 Dados obrigatórios Devem ser informados os seguintes dados: Estabelecimento Lógico TEF (nem sempre irá existir essa informação) Esses dados são utilizados para: Identificar o cliente junto à adquirente Validar o credenciamento Liberar o uso do TEF Cloud no ambiente 🔄 Processo O cliente fornece os dados ao suporte O suporte envia para o ACBr O ACBr realiza validação com a adquirente Após validação, o ambiente é liberado para uso 🔍 Onde obter esses dados 🔹 1. Comprovante de venda (POS) Se o cliente já possui uma maquininha (POS), os dados podem ser encontrados no comprovante impresso. Exemplo: ESTAB / EC → número do estabelecimento Lógico TEF → número do terminal lógico 📌 Normalmente aparecem como: ESTAB=XXXXXXXXXXXX TERM=XXXXXXXX ou similar 🔹 2. E-mail da adquirente Caso o cliente não possua POS: Os dados são enviados por e-mail pela adquirente no momento do credenciamento 📌 O cliente deve: Localizar o e-mail de credenciamento Ou solicitar novamente junto à adquirente 💡 Orientação para suporte Ao solicitar os dados ao cliente: Pedir foto de um comprovante recente (se tiver POS)ou Solicitar o e-mail de credenciamento da adquirente Isso evita erro de digitação e acelera a liberação. Pagamento Integrado na NFC-e para o Rio Grande do Sul Calendário de Obrigatoriedade Ebook da AFRAC sobre Pagamento Integrado Cartilha AFRAC Site da SEFAZ RS com as dúvidas geraisCadastro das Administradoras Para cadastrar uma administradora de cartões (a maquininha) no sistema tryideas siga os seguintes passos: Obs: Verifique se já possui uma conta de banco cadastrada no sistema antes de cadastrar a administradora. Para cadastrar clique aqui. 1 - Abra o menu Cadastros > Financeiro > Gerencias Cadastros; 2 - Procure pelo submenu Cartão de Crédito e selecione a opção Cadastrar Administradoras; 3 - No primeiro campo informe o nome da Administradora ou uma descrição para a mesma; 4 - Em Conta Depósito selecione sua conta bancária previamente cadastrada; 5 - No campo Despesa Taxa informe uma despesa para registro das taxas, normalmente utilizado Juros Pagos; 6 - No campo da Receita preencha a receita para registo dos valores recebidos, o padrão é Recebimentos. 7 - O CNPJ Credenciadora é opcional, sendo obrigatório informar em alguns estados para constar na forma de pagamento da NFe e NFCe. 8 - O checkbox Utiliza TEF e Índice de Rede estão melhor explicados neste manual, caso tenha interesse na modalidade sem utilização da maquininha confira o mesmo. O cadastro seguindo o manual fica desta forma: Para configurar os produtos (débito, crédito à vista) e as taxas de juros da administradora siga este manual: Cadastro dos Produtos/Serviços.   Cadastro de Produtos/Serviços de Cartão Após configurar sua administradora de cartões, é necessário também configurar suas taxas de juros. Vamos ao passo a passo: 1 - Ainda no menu financeiro (Cadastros > Financeiro > Gerenciar Cadastros) procure por Cadastrar Produtos/Serviços; 2 - Normalmente as administradoras tem um taxa para vendas em débito, uma taxa de crédito de 3 ou 6 vezes e outra para vendas com mais parcelas, até 12. Antes de cadastra-las consulte sua administradora para verificar quais são elas e as condições; 3 - Com as taxas em mãos, abra a tela de cadastro e na Descrição preencha com uma informação que ficará fácil de localizar depois. Se você tem mais de uma administradora coloque uma identificação também, exemplo: ELO DÉBITO, GETNET CRÉDITO ATÉ 3X, REDE CRÉDITO À VISTA; 4 - Selecione a Filial e a Administradora que serão relacionadas a este cadastros; 5 - Nos campos numéricos é necessário um pouco mais de atenção, vamos à eles: Dias Prazo: prazo de dias que o valor da venda irá levar para cair na sua conta, débito preencha com 1 e crédito com 30. Limite de Parcelas: quantas parcelas será o máximo para a venda. Débito sempre 1 e crédito de acordo com a sua necessidade. Se este cadastro é de uma taxa até 3 vezes por exemplo, o valor neste campo deve ser 3. % Taxa: porcentagem de juros para este produto. Valor Tarifa: caso além de juros a administradora cobre tarifa, informa neste campo. % Taxa na Antecipação: caso sua administradora ofereça o serviço de antecipação dos valores das suas vendas e cobrem juros sobre isso, preencha aqui o valor do juros. Tipo de Cartão: opcional e utilizada para o TEF, caso queira saber mais clique aqui. Bandeira: também é opcionais mas pode ser obrigatório em alguns estados, irá aparecer nas informações de pagamento da NFe e NFCe. Exemplos de cadastros (valores ilustrativos) Débito: Crédito à vista: Crédito com limite de parcela de 6 vezes: Consulta de Produtos/Serviços Para adicionar essas condições de pagamento na tela de faturamento, para facilitar as vendas que não foram parceladas basta Consultar os Produtos/Serviços, selecionar 1 por vez e clicar na opção Incluir/Excluir Numerário na parte superior da tela: Faça isso somente com os serviços que são em 1 vez!! Débito e crédito à vista! Desta forma quando você for liquidar alguma fatura a tela de liquidação ficará assim: Nas suas vendas parceladas clique sobre Cartão, selecione a Administradora, o Produto e no campo Parcelas informa em quantas vezes foi a venda. Gerar Lote de Recebimento de cartão A tela de Geração de Lote permite ao usuário consolidar manualmente lançamentos de vendas feitas com cartão de crédito/débito em um lote, informando receitas e despesas associadas, para facilitar a conciliação financeira. Obs.: Caso seu sistema esteja configurado para fazer a geração de lotes automaticamente, o sistema exibirá uma mensagem de que a Geração de Lotes esta configurada para ser realizada automaticamente e não permitirá abrir essa tela. Caso queira fazer esse procedimento manualmente será necessário desabilitar essa configuração. Para fazer a geração do lote, irá acessar o menu Cadastros, depois irá na opção Financeiro e ainda na opção Gerenciar Cadastros, no campo de pesquisa, poderá pesquisar por Gerar Lotes, e o sistema irá exibir as opções Gerar Lote de Recebimentos. Clicando na operação de Gerar Lote de Recebimento, o sistema irá exibir a tela com os campos que deverá preencher poder pesquisar os valores que ainda tem a receber, os campos são eles: Produto: Refere-se ao nome do produto ou serviço vinculado à venda no cartão Período: Define o intervalo de tempo para buscar os lançamentos (Ex: Últimos 30 dias, Este mês, etc). Após preencher os campos pode clicar em pesquisar e o sistema irá exibir os lançamentos com as seguintes colunas: Parcela: Número da parcela da venda. Data Vencimento: Data prevista para recebimento Valor Bruto: Valor da venda antes das taxas. Valor Tarifa/Taxa: Valores cobrados pela administradora (tarifas e taxas). Valor Líquido: Valor final a ser recebido. Administradora: Nome da operadora de cartão (ex: Cielo, Rede, etc). Após consultar as valores que tem a receber, poderá marcar cada uma que deseja fazer a geração do lote, e clicar no botão Gerar Lote (F5), o sistema irá fazer a geração e consolidação do valor na sua conta bancaria. Consulta de Vencimentos de Cartões Esta tela tem como finalidade consultar os valores a receber de vendas feitas por meio de cartões, exibindo detalhes como parcelas, taxas, valor líquido, se já foi lançado no financeiro e o número do lote. Para fazer a consulta, você irá acessar a tela pelo menu Cadastros, depois irá na opção Financeiro e ainda na opção Gerenciar Cadastros, no campo de pesquisa, poderá pesquisar por Vencimentos, e o sistema irá exibir a opção Consultar Vencimentos. Clicando na opção de consultar vencimentos o sistema irá exibir a tela com os campos que deverá preencher para fazer a consulta. Filial: Irá selecionar a filial no sistema a qual deseja fazer a consulta Produto: Refere-se ao nome do produto ou serviço vendido via cartão. Pressione Enter para escolher. (Ex: Crédito ou Débito). Período: Filtra os vencimentos por período: "Este Mês", "Mês Anterior", "Personalizado", etc. Filtro: Define o tipo de lançamento a visualizar: Todos, Lançados (já registrados no financeiro) ou Não Lançados (pendentes de lançamento). Após preencher os campos pode clicar em Pesquisar (F3), para exibir os registros Na parte de baixo da tela tem as opções de Imprimir que gera uma versão para impressão do relatório exibidos na tela, e ainda Lançar Adiantamento  que permite adiantar o valor de algum desses lançamentos.Consultar Transações TEF Neste manual estaremos apresentando como fazer a Consulta de Transações TEF no seu sistema. Essas transações são feitas através da sua máquina de cartão de crédito, no qual esta configurada junto ao sistema para efetuar as liquidações. Para fazer a consulta, você pode acessar a tela pelo menu Caixa, depois irá na opção Consultar Transações TEF, exibindo uma tela conforme imagem abaixo: Clicando na opção de consulta das transações o sistema irá exibir a tela com os campos que deverá preencher para fazer a consulta. Período: Pode estar informando datas específicas ou intervalos conforme desejar a consulta. Cód. Autorização: Campo opcional, mas caso tiver e precisar preencher para puxar resultados específicos, pode utilizar. Valor: Pode estar definindo valor para busca do resultado. Nessa tela ainda existem algumas opções a mais para serem feitas, como por exemplo reimprimir uma via, consultar transação gerencial, ou operação ADM.