ADQUIRENTE CIELO

Modelos: Cielio Lio (V2) e ON (V3)

APLICATIVOS

APLICATIVOS

SMART TEF

Módulo Pago?

Sim, o módulo SMART TEF é uma funcionalidade contratada.
Este artigo fornece informações detalhadas sobre a implementação da solução SMART TEF da ConnectPlug na POS MÓVEL da Cielo Lio.
Agora é possível utilizar o aplicativo SMART TEF da ConnectPlug nessa máquina, permitindo sua funcionalidade como TEF no PDV 2.0. Para usufruir desse recurso, os clientes devem contratar o serviço SMART TEF diretamente com a ConnectPlug para integração com a máquina Cielo Lio.

 



 

Smart TEF (CPlug Pay a partir da versão 1.11.3)
Pré-requisitos
  1. O contrato de cartões deve estar configurado com o provedor da adquirente.
  2. O PIX deve ser incluído nesse mesmo contrato.

 

Passo a Passo para Vinculação do PDV
  1. Acesse a Área Administrativa do sistema e vá para CPlug Pay para gerar o QR Code de vinculação.
  2. No aplicativo CPlug Pay, clique em Vincular PDV, escaneie o QR Code e aguarde alguns segundos.
  3. Após a vinculação, o sistema estará pronto para iniciar as transações.

Nota: Não é mais necessário criar o aplicativo no ERP para este processo.

Na configuração do CPlug Pay, basta inserir a OTP. Não é necessário fazer login no ERP na próxima tela; basta selecionar a opção para permanecer sem login, pois a configuração do CPlug Pay se resume à inserção da OTP.

 

APLICATIVOS

CPLUG PDV ANDROID

Funcionalidades Disponíveis:

 

Configuração do PDV Android

  1. Criar o Aplicativo PDV Android no ERP

    • Acesse o ERP > Pontos de Venda > Aplicativos e clique em Cadastrar Novo Aplicativo > Novo PDV Android.
    • Insira o nome para o PDV Android que será utilizado na POS Móvel e clique em Salvar.

  2. Cadastrar Nova Frente de Caixa

    • Acesse Pontos de Venda > Cadastro > Novo PDV.
    • Cadastre uma nova frente de caixa a ser utilizada no PDV Android da POS Móvel.

  3. Configuração do Contrato de Cartões (Opcional)
    Se desejar controlar as taxas de cada bandeira, configure um Contrato de Cartões:

    • Acesse Financeiro > Contrato de Cartões e Outros > Novo PDV.
    • Observação: O módulo de Contrato de Cartões não é obrigatório, a menos que o cliente deseje gerenciar as taxas de transação.

  4. Login no PDV Android na POS Móvel

    • Abra o aplicativo PDV Android na POS Móvel.
    • Insira os dados de LOGIN e PIN gerados no ERP > Ponto de Venda > Aplicativos.

PDV Mobile (Integração com o CPlug Pay - Cplug Pay a partir da 1.11.3)
Procedimentos para Clientes Somente com PDV Mobile
  1. No aplicativo CPlug Pay, clique na opção Continuar sem login.
    • Esta opção é necessária para permitir que o cliente tenha acesso a funcionalidades como transações e estornos, se necessário.
  2. Após essa configuração, o sistema estará pronto para transacionar, sem a necessidade de configurar o contrato de cartões.

Limitação Conhecida
APLICATIVOS

CPLUG ATENDIMENTO DE MESAS

Funcionalidades Disponíveis

1. Abertura e Gestão de Comandas

2. Recebimento de Pagamentos

Processo de fechamento e pagamento (parcial e total) de comanda pela POS MÓVEL


 


Processo de autenticação do aplicativo atendimento de mesas

VÍDEO TUTORIAL -> Clique e solicite permissão de acesso.

SOLICITAR LIBERAÇÃO APLICATIVOS

Passo a Passo para Solicitação de Liberação dos aplicativos
Cplug Pay | PDV Android | Atendimento de mesas

✔️ Ao realizar a liberação do EC no portal da Cielo, todos os aplicativos relacionados (CplugPay, PDV Android e Atendimento de Mesas) serão automaticamente liberados.

1. Obter o Número do EC (Estabelecimento Comercial)

Solicite ao cliente o número do EC, que pode ser encontrado na máquina CIELO LIO seguindo os passos abaixo:

  1. Na tela inicial da máquina, acesse o menu inferior "Ajuda".
  2. Selecione a opção "Minha LIO".
  3. Clique em "Sobre".
  4. Localize a opção "Número do EC".
    • Este é o número que o cliente deve fornecer à ConnectPlug.

➡️ O processo acima também pode ser visualizado no vídeo: Acesse o tutorial aqui.

2. Validar o Número do EC

Confirme que o número fornecido pelo cliente contém 16 caracteres.

3. Enviar Solicitação de Liberação

Para solicitar a liberação dos aplicativos, siga os passos abaixo:

O setor de PPI será responsável por conduzir o processo junto à CIELO. Após a ativação ser confirmada pela CIELO, uma resposta será enviada Ticket pelo MOVIDESK.

Consulta de solicitações

Para facilitar o acompanhamento, criamos um Painel de Consulta no MOVIDESK, com título: NLÓGICOS (TEF E PIX)

4. Retornar ao Cliente

Após a confirmação, informe ao cliente que a liberação foi realizada com sucesso.
A máquina CIELO LIO irá atualizar automaticamente e baixar os aplicativos.

 


Os aplicativos não foram baixados automaticamente. O que fazer?

Caso a máquina não realize o download dos aplicativos imediatamente, oriente o cliente a seguir os passos abaixo:

  1. Verificar a conexão com a internet:

    • Certifique-se de que a máquina está conectada a uma rede estável.

  2. Conectar a LIO ao carregador:

    • Plugue a máquina na tomada para garantir energia durante o processo.

  3. Forçar a atualização do sistema:

    • Na tela inicial da máquina, vá ao menu inferior "Ajuda".
    • Selecione a opção "Minha LIO".
    • Clique em "Buscar atualizações".

  4. Validar o Número do EC:

    • Caso o problema persista, verifique se o número do EC informado foi preenchido corretamente no pedido de liberação.

       

       

      Informações atualizadas em 11/04/2025

FLUXOS RESOLUTIVOS - POS CIELO

🧩 Não consigo logar ou sincronizar o aplicativo.
Durante o processo de login ou sincronização (atualização de dados) do PDV Android podem ocorrer alguns eventos que acabam impossibilitando a sincronização completa do aplicativo.
Nesses casos, o próprio aplicativo retorna uma mensagem junto de um código de erro para que se possa tentar identificar o problema que ocorreu e resolvê-lo para que o login seja realizado corretamente.

🧩 É normal o processo de sincronização/login demorar muito?
Depende da conta do cliente. Clientes com muitos registros de produtos, clientes, códigos de barras e outros elementos podem fazer com que a sincronização do PDV Android, principalmente durante o login demorem algum tempo, ou também a precariedade da sua conexão com a internet. A conduta nessa situação é esperar até o final do processo, para que o PDV ou realizar o login/sincronização corretamente, ou retorne alguma mensagem indicando o que ocorreu.

🧩 A "bolinha" de carregamento parou, o que fazer?
Em alguns aparelhos com hardwares mais modestos, ou mais antigos, a animação central da tela de sincronização pode travar algumas vezes ou até mesmo parar. Isso não significa que a sincronização parou, apenas que a interface do aplicativo está tendo dificuldade de renderizar a animação, por causa das limitações do hardware.
Nesse caso deve se continuar aguardando o processo normalmente, pois se houver algum problema o aplicativo irá sinalizar o que aconteceu.

🧩 Recebi a mensagem parecida como "O ConnectPlug PDV não está respondendo" ou "O aplicativo está demorando para responder"
Isso ocorre devido a limitação do hardware que está sendo utilizado. Basta selecionar a opção "Aguardar" para que o PDV continue o processo de sincronização/login.

🧩 Códigos de erros do PDV Android:
O erro mais comum de ocorrer é a falta/falha de rede. Para esse tipo de problema o código apresentado pode variar, porém ele terminara com a sigla WN (Without Network). Para resolver basta verificar se a conexão do aparelho existe e se a mesma não apresenta instabilidade, e tentar novamente o processo de login/sincronização.

🧩 Códigos de erros 902, 904, 906, 908, 910, 912, 914, 916, 918, 921, 920 e 923:
O retorno da API não foi o esperado pelo aplicativo. Verifique se o tipo do aplicativo que está sendo utilizado para login é PDV ANDROID. Se sim, verifique o log de erro para mais informações e haja de acordo com elas.

🧩 Código de erro 401:
API retornou que o aplicativo não está autorizado a realizar a chamada.
Isso pode ocorrer quando:
O aplicativo é excluído no ERP: Nesse caso crie um aplicativo novo do tipo PDV Android e logue no aparelho.
O aparelho foi resetado para configurações de fábrica: Nesse caso exclua o aplicativo atual no ERP e crie um aplicativo novo do tipo PDV Android e logue no aparelho.
Muito raro porém possível: O aparelho por algum motivo perdeu seu Google ID (ID único
utilizado para identificar o aparelho no ERP): Nesse caso exclua o aplicativo atual no ERP e crie um aplicativo novo do tipo PDV Android e logue no aparelho.

🧩 Código de erro 429:
API retornou que esse cliente está fazendo muitas requisições.
Isso pode ocorrer quando o cliente possui muitos registros de produtos, clientes, códigos de barra e etc.
A conduta nessa situação é esperar 3 minutos, tentar o processo de login/sincronização novamente e verificar se o mesmo ocorre novamente.
Se ocorrer, o desenvolvimento deve ser contatado com o maior número de informações possíveis (Schema, código de login da empresa, aplicativo que está sendo utilizado, etc).

🧩 Código de erro 4xx:
Outros códigos de erros que se iniciem com 4 são retornados pela API em situações específicas. Nesse caso deve se recorrer a norma HTTP de códigos e analisar o log do PDV Android, para então agir em cima das informações neles presentes. No último caso de nenhuma solução ser possível, entrar em contato com o desenvolvimento.

🧩 Nenhuma das soluções acima me ajudou:
Se o erro que você está presenciando não está listado acima, verifique o log do PDV Android para ter mais informações do que pode está ocorrendo. Se ele não ajudar, informe o supervisor do setor para que ele possa analisar se o problema pode ser resolvido de alguma outra forma, ou entrar em contato com o setor de desenvolvimento. Não é recomendado o contato direto com o setor de desenvolvimento, com exceção dos casos explicitamente listados acima.

🧩 PDV ANDROID não está realizando impressões.

Existem várias impressões no PDV Android.
Todas elas devem ser realizadas através de impressoras de REDE.

🧩 O que eu devo observar para garantir que as impressoras estão configuradas corretamente:

- Verifique se as impressoras estão configuradas no ERP com o IP e FABRICANTE correto.
- Verifique se o aparelho em que o PDV Android está instalado está na mesma rede da impressora.

(Isso pode ser feito verificando se as três primeiras casas do IP do aparelho em que o PDV Android está instalado são iguais as três primeiras casas do IP da impressora. Se sim, eles provavelmente estão na mesma rede.)

- Para validar com certeza, basta acessar o IP da IMPRESSORA no navegador (chrome ou equivalente) do aparelho em que o PDV Android está instalado. Se você chegar a uma página de configuração da impressora, os dois aparelhos estão se comunicando.

- Na tela de configurações administrativas do PDV Android existe uma opção chamada "Testar impressoras". Ao utilizar ela será impresso um comprovante de teste na impressora, que se realmente for impresso confirmará que as configurações estão corretas e os aparelhos estão em um ambiente compartilhado.

🧩 Verifiquei os passos acima e ainda assim não ocorre a impressão:
Nesse caso é preciso analisar a impressão em questão. 

PDV Android não imprime o RELATÓRIO GERENCIAL:
Realize as seguintes verificações:
No ERP, verifique se o PDV (PONTO DE VENDA > CADASTRO > Selecione o PDV aberto) está com o ponto de impressão correto configurado.
Se o que você deseja é a impressão automática ao finalizar uma venda, no ERP verifique nas configurações do PDV a opção em (ENGRENAGEM > CONFIGURAÇÕES DO PDV > CONFIGURAÇÕES DO PDV > Impressão de Relatório Gerencial)

🧩 Onde eu encontro os logs do PDV Android?
Os logs do PDV Android estão localizados nos arquivos do aparelho onde o app está instalado.
Para encontrar esses logs, basta entrar no app gerenciador de arquivos do aparelho (Geralmente chamado de gerenciador de arquivos, meus arquivos ou alguma variação parecida), e a partir da raiz dos diretórios (diretório inicial), ir até a pasta "PDVMobile".
Nela você encontrará a pasta "LOGS", e dentro dela, os logs do aplicativo.
Os arquivos de logs são nomeados a partir do dia em que eles são gerados e utilizados, sendo assim irá existir um log para cada um dos dias que o app foi utilizado, limitando-se sempre ao registro de logs de até 15 dias atrás.

🧩 O que eu vejo nos logs do PDV Android?
Os arquivos de logs do PDV Android são salvos no formato HTML, com uma formatação com o intuito de ajudar o analista que está lendo ele a identificar possíveis informações importantes.
Geralmente, em casos de erros, basta ir até o final do log e buscar por:
Mensagens na cor vermelha, que indicam eventos de prioridade alta.
Mensagens na cor laranja, indicam eventos de prioridade média.
Mensagens na cor azul, indicam eventos de prioridade baixa.
Mensagens na cor cinza: apenas logs de eventos rotineiros.

Os logs também contém, em cada linha de evento, a data e hora exata do evento para auxiliar na busca e compreensão dos acontecimentos ao decorrer do tempo

🧩 Como eu visualizo os logs do PDV Android?
Os logs podem ser visualizados diretamente no aparelho do cliente, utilizando o aplicativo "Leitor de HTML" do aparelho.
Você também pode capturar os arquivos e trazer até sua máquina e abrí-los em qualquer navegador de internet como Chrome ou Mozilla.

🧩 Como eu exporto e envio para análise o banco de dados do PDV Android?

- Quando eu devo exportar o banco de dados do PDV Android?
Só exporte o banco de dados se for solicitado pelo desenvolvimento para análise. Essa ação pode afetar o bom funcionamento do PDV Android e não deve ser realizada sem a expressa requisição do desenvolvimento.

🧩 Como eu exporto o banco de dados do PDV Android?
Para exportar o banco de dados do PDV Android, siga os seguintes passos:
1. No PDV Android, entre na tela de configurações administrativas.
2. Na tela de configurações administrativas, selecione a opção "Exportar base de dados". Ao fazer isso, o aplicativo irá exportar um arquivo com toda a base de dados do aplicativo para os arquivos do aparelho.
3. Agora, você deverá pegar o arquivo exportado da base de dados. Para encontrar esse arquivo, basta entrar no app gerenciador de arquivos do aparelho (Geralmente chamado de gerenciador de arquivos, meus arquivos ou alguma variação parecida).
4. Na raiz dos arquivos do aparelho (diretório padrão) você encontrará um arquivo chamado "cp_pdv.realm".
5. Extraia esse arquivo do aparelho do cliente (Via e-mail ou transferência de arquivos do TeamViewer).
6. Envie para o desenvolvedor que solicitou a exportação por e-mail seguindo o padrão: Assunto:
BASE DE DADOS EXPORTADA - PDV ANDROID - SCHEMA DO CLIENTE Conteúdo:
Descrição: Descrição detalhada do problema, com o MÁXIMO DE DETALHES POSSÍVEIS. Link: LINK DO TICKET OU CHAMADO NO SISTEMA DO SUPORTE
Schema: SCHEMA DO CLIENTE
Cod. Login: CÓDIGO DE LOGIN DO CLIENTE.
7. Pronto!

 

 

LIMPEZA DE DADOS

Para limpar os dados de aplicativos, realize a seguinte operação:

1º Desabilite qualquer rede online da maquina 3g/4g/wifi.
2º Desabilite o horário da maquina automaticamente.
3º Mude para a data 2/dez/2020.
4º Insira senha: 254824 para poder acessar apps e limpar os dados do PDV Android.

CHANGELOGS

CHANGELOGS

CPLUG PAY

CPlug Pay 1.11.3 - Cielo
Features:
Novo modo de autenticação por QRcode (Implementado na 1.10.135)
Compatibilidade com Totem V2 (Vinculação via QRcode)
Limitação:
Não envia bandeira de cartão no ERP, Já está em correção na parte do ERP.
Correções:
Correção de problemas para recebimento em PIX
Correção de Estorno
CHANGELOGS

PDV ANDROID

Cplug PDV 1.4.22 - Cielo
- Corrigido transação via PIX
- Removida integração de pagamento com a Cielo (Substituida pelo cplug pay)
- Impressões ajustadas para o novo gerenciador de impressão (Cplug pay)

CHANGELOGS

ATENDIMENTO DE MESAS

📝 Changelog Versão 1.1.60 – CPlug Atendimento
📅 Data: 26/03/2025

✨ Novas Funcionalidades
🛒 Geração de Venda pela POS
Agora é possível realizar vendas diretamente na POS.

🖨️ Impressões Nativas da POS
Suporte para impressão parcial, nota fiscal e DAV diretamente no dispositivo.

🔄 Transferência de Comandas, Pedidos e Produtos
Nova funcionalidade permite transferir comandas, pedidos e produtos entre mesas.

💰 Aplicação de Descontos
Agora é possível aplicar descontos diretamente nas comandas e produtos.

⚙️ Compatibilidade com Flags de Configuração do ERP
✔️ Solicitação de usuário/senha de gerente para cancelamento (flg_check_passwd_cancel).
✔️ Senha obrigatória para alteração da taxa de serviço (flg_password_service_tax, cancel_key).
✔️ Solicitação de usuário/senha de gerente para descontos (flg_discount_pass).
✔️ Configuração do valor máximo permitido de desconto (flg_max_discount, max_discount_percentage, max_discount_percentage_on_product).
✔️ Código obrigatório do garçom (flg_attendance_seller_pass).
✔️ Modo de seleção do garçom via teclado (flg_attendance_seller_keyboard).

🧾 Emissão de Nota Fiscal em SC
Nova funcionalidade disponível para geração de nota fiscal no estado de Santa Catarina.

📤 Exportação de Logs
Agora é possível exportar logs diretamente pelo aplicativo.

🚀 Melhorias
🔗 Conexão Aprimorada com o CPServer
Fluxo de conexão mais estável e eficiente.

📌 Filtros Otimizados
🔹 Melhorias no filtro por categoria de produtos.
🔹 Otimização do filtro de mesas para maior praticidade.

📡 Gerenciamento de Conexão
Melhoria no fluxo para lidar com perda de conexão com o CPServer, garantindo maior estabilidade.

🐞 Correções de Bugs
✅ Formulário de Comandas
Corrigido o problema em que a seleção da mesa anterior não era limpa ao criar uma nova comanda.

✅ Exibição de Categorias de Produtos
Correção na exibição da lista de categorias de produtos.

ℹ️ Notas Adicionais
💳 Suporte Atualizado para Adquirentes:
As atualizações são compatíveis com Cielo e Stone.

CPlug atendimento 1.1.23 - Cielo

*Correções Realizadas*

- Pagamento parcial agora subtrai corretamente o valor da comanda.
- Resolvida a falta de responsividade do aplicativo.
- Ajustado o tamanho do layout para melhorar a usabilidade.
- Botão de cancelamento de pedido agora funciona corretamente.
- Corrigido erro visual ao cancelar uma comanda.
- Botões de ação (transferência, configurações, etc.) que não executavam ações foram *removidos*.
- Botões "informações" e "modo escuro" que não executavam ações foram *removidos*.
- Registro de pagamento parcial agora envia corretamente o método de pagamento para o PDV.
- Resolvido o crash ao cancelar um recebimento.