Suporte

Instalação do pdv

Este guia detalhado irá te auxiliar na instalação e configuração do software PDV Illimitar, passo a passo, para que você possa começar a vender com praticidade e eficiência.

 

1. Download do Arquivo PDV:

 


2. Instalação do PDV Illimitar:

Captura de Tela 2023-09-01 às 16.45.18.png

Captura de Tela 2023-09-01 às 16.47.01.png

Captura de Tela 2023-09-01 às 16.46.17.png

Captura de Tela 2023-09-01 às 16.48.06.png

Captura de Tela 2023-09-01 às 16.52.05.png


3. Configuração Inicial do PDV Illimitar:

Captura de Tela 2023-09-01 às 16.53.42.png

Captura de Tela 2023-09-01 às 16.55.55.png


 

4. Configuração da Impressora Térmica:

Para que o PDV imprima cupons fiscais em uma impressora térmica, siga estas etapas:

Captura de Tela 2023-09-01 às 17.41.06.png

Captura de Tela 2023-09-01 às 17.42.12.png

Captura de Tela 2023-09-01 às 17.43.29.png

Após as configurações informadas é só clicar no botão de salvar que o PDV vai reiniciar e abrir já com as configurações inseridas anteriormente.

Captura de Tela 2023-09-01 às 17.44.01.png

Configuração do Recebimento Cartão nos Servidores

1- Para iniciar a configuração, é necessária a instalação do JAVA nos servidores.

1.1 - Para instalação do JAVA em Servidores CentOS, execute o comando abaixo:

$ sudo yum install java-11-openjdk-devel

1.2 - Para instalação do JAVA em Servidores UBUNTU, execute o comando abaixo:

$ sudo apt-get install java-11-openjdk-devel

1.3 – Após instalação do JAVA, verifique se a instalação foi realizada com sucesso através do comando abaixo:

$ java --version

Lembrando: Caso já esteja com o usuário root, você pode retirar dos comandos o $ e o sudo.


2 – Drive:

image.png

2.1 – Feito o download, acesse o DW do servidor a ser configurado e importe os arquivos na pasta root, conforme imagens abaixo:

image 3.png

image 3.png

image 3.png

image 3.png

image 3.png


image.png


2.2 – Após importar os arquivos, dê as permissões abaixo nos arquivos:

image 3.png


$ chmod 777 /root/credsystem.sh
$ chmod 777 /root/credsystemInfo_2.zip


3 – Abra o cron (agendador de tarefas) do servidor:
$ crontab -e

3.1 – Insira a seguinte linha no cron:

0 0 * * * /root/credsystem.sh >> /var/log/credsystem.log

Caso queira conferir se de fato o comando foi salvo basta colocar o comando crontab -e novamente.

3.2 – Reinicie o serviço do cron:

$ service cron restart
$ systemctl restart crond.service


4 – Illistore:
Captura de Tela 2023-09-15 às 09.38.16.png


5 – Biblioteca:

image 3.png


image 3.png


Captura de Tela 2023-09-15 às 09.40.48.png


6 – Servidor local:
$ cd /root
$ ./credsystem.sh

image.png


7 – Configuração:

Captura de Tela 2023-09-15 às 09.43.19.png

Parâmetros do preenchimento da URL da Função "Outras Opções".

http://192.168.122.171:8088/bibliotecas/79b21795-b7a7-4f40-ada2-419525b5b5f0/credsystem?idEntidade=68

8 – Credsystem:

image.png


image 3.png


Parâmetros da configuração da API:

Exemplo da configuração aplicada:

image 3.png


OBS.: Aplicada a configuração, clique em Salvar Configuração para finalizar.

9 – Banco de dados:
CREATE DATABASE IF NOT EXISTS `illi_integrador` DEFAULT
CHARACTER SET = `utf8`;

9.1 – Crie as tabelas desse banco de dados com a consulta abaixo:

CREATE TABLE IF NOT EXISTS illi_integrador.`cred_cliente` (`id` int(11) unsigned NOT NULL AUTO_INCREMENT,
`valor` json DEFAULT NULL,
`situacao` varchar(800) DEFAULT 'ATIVO',
`data` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON
UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

10 – Configuração:

Captura de Tela 2023-09-15 às 10.08.22.png

Instalação e configuração do Sat

1 – Esse é o Equipamento Sat.

 image.png

1.1 – O equipamento SAT possui duas interfaces ETHERNET disponíveis, a primeira identificada como “ETHERNET 1” e a segunda como “ETHERNET 2”, constituindo um SWITCH, ou seja, o cabo de rede da infraestrutura local pode ser ligada em qualquer uma das portas Ethernet disponíveis no equipamento, e na outra porta ETHERNET conecte o cabo de conexão com o computador. Faça também a conexão via cabo USB com o computador.

 image.png




2 – Instalação:

image.png

2.1 – Acesse o Gerenciador de dispositivo do computador.

image.png

2.2 - Depois disso clique com o botão direito sobre o item “Gadget Serial V2.4” e selecione “Atualizar Driver”. 

image.png

2.3 - Selecione o botão “Procurar Software de Driver no Computador”. 

image.png

2.4 – Clique no Botão “Permitir que eu escolha em uma lista de drivers de dispositivos no computador 

image.png

2.5 – Depois selecione a opção “Com Disco”, o local onde está o driver Tanca e aponte para o arquivo SAT TANCA e Avançar.

image.png

Ao iniciar o processo de instalação irá aparecer a janela abaixo, selecione “Instalar este software de driver mesmo assim” 

image.png

Ao Final da Instalação irá aparecer a Janela abaixo indicando a conclusão da instalação do Driver USB do SAT. Clique no botão fechar para finalizar a operação.

2.6 – No Windows 10 pode alertar um erro onde não irar conseguir passar do passo 2.5. Neste caso será necessário realizar o procedimento a seguir. Clique no ícone do Windows e selecione “Configurações”.

image.png

 2.7 – Clique em “Atualização e Segurança”.

image.png


2.8 – Clique em “Recuperação” e em “Inicialização avançada” clique em “Reiniciar agora”. O Computador será reiniciado, fique atento as opções que irá mostrar.

 image.png


2.9 – Quando Reiniciar o computador irá solicitar que escolha uma opção. Escolha a opção “Solução de Problemas”. 

image.png

2.10 – Selecione “Opções avançadas”.

image.png

2.11 – Selecione “Configurações de inicialização”.

image.png

2.12 – Selecione “Reiniciar”. O computador irá reiniciar novamente e apresentar as Configurações de Inicialização.

 image.png


2.13 - Na tela de configurações de inicialização pressione 7 ou F7 para desativar a imposição de assinatura de drivers.
Seu computador será reiniciado e você poderá repetir o passo 2.5 .

image.png


3 – Sat:

https://satsp.fazenda.sp.gov.br/COMSAT/Account/LoginSSL.aspx?ReturnUrl=%2fCOMSAT%2f

3.1 – Selecione a opção contribuinte e escolha a opção de  “Acesso via Certificado Digital”, agora o certificado já deve está instalado no seu computador.

image.png

 3.2 – Selecione “Equipamento” depois “Ações” e “Vincular Equipamento SAT”.

image.png

Agora irá aparecer as informações do cliente conforme o certificado. Certifique que esteja tudo certo.

3.3 – Adicione a série do Equipamento SAT e clique no botão.

Note que após isso o botão ficará disponível para adicionar outros equipamentos SAT de uma só vez.

image.png


Feito isso, adicione o e-mail do cliente e Selecione a opção que Aceita como válido o Certificado Digital fornecido pela Secretaria de Fazenda de SP, e clique em Enviar. Feito isso irá abrir uma página para confirmação das informações, valide e clique em “Continuar”.



4 – Ativação:

image.png


4.1 – Coloque o código de ativação, por padrão é definido por 8 vezes o número zero, 00000000. Abaixo coloque o CNPJ do cliente em questão e clique em “Ativar”.

O processo de ativação pode demorar um pouco.

image.png

4.2 – Selecione a opção de “Associar  Aplicação Comercial”. Digite o código de ativação, coloque o CNPJ do cliente, coloque o CNPJ Software House e coloque a Assinatura do Aplicativo Comercial no campo TEXTO. Feito isso clique em Associar.

Geralmente o código da Assinatura é enviado para a pessoa que está realizando essa configuração pelo responsável do setor.

image.png

OBS: Na opção de “Status” podemos identificar a versão do Layout e o Status do Equipamento. Caso a versão seja menor que a 0.08 clique em Atualizar SW Básico para atualização do Equipamento.


5 – S@t Fiscal:

Selecione a versão do layout, coloque o número do caixa, o CNPJ do Software House e a Assinatura do Aplicativo Comercial.

image.png

 5.1 – Selecione a opção “Avançado” e em “MODO” selecione a opção “S@T Fiscal” e clique em Salvar.

image.png


6 – Sistema

 image.png


7 – Operação:

image.png

7.1 – Em modelo Seleciona o modelo CF-e (S@t).

image.png

7.2 – Selecione a opção S@T Fiscal nos submenu que fica na parte de baixo. E configure conforme o Regime de tributação da Empresa em questão.

image.png

Feito isso, clique em salvar, abra o PDV e realize uma venda TESTE.

7.3 – Selecione a opção S@T Fiscal nos submenu que fica na parte de baixo. E configure de acordo com o Regime de tributação da Empresa em questão.

image.png

Configuração SAT compartilhado

1 - Download
satCompartilhado - 1.jpg


2 - Modelo sat

satCompartilhado - 2.jpg


3 - Instalador

image.png

Obs: Após instalado, observe que irá aparecer um pop-up indicando que será necessária uma configuração prévia

image.png


4 – Biblioteca

image.png

image.png


5 - Configuração pdv

image.png


6 -  Preencha os campos:

image.png

Configuração para ambiente de homologação:

Emitente :

CNPJ - 534852150000106

I.E. - 111072115110

Software house : 

CNPJ - 10615281000140


 

Após a configuração do PDV servidor, configuramos o SAT compartilhado

1 - Integração:

image.png

Sat sweda

1 – Registro Sat

https://satsp.fazenda.sp.gov.br/COMSAT/Account/LoginSSL.aspx?ReturnUrl=%2fCOMSAT%2f

1.1 – Selecione a opção contribuinte e escolha a opção de  “Acesso via Certificado Digital”, agora o certificado já deve está instalado no seu computador.

93ADDE3C1BD4181F0E9E9E94988A5A6E 

1.2 – Selecione “Equipamento” depois “Ações” e “Vincular Equipamento SAT”.

 F939800A74FC607FDB96BC6CE3160D4D
Agora irá aparecer as informações do cliente conforme o certificado. Certifique que esteja tudo certo.
1.3 – Adicione a série do Equipamento SAT e clique no botão.

Note que após isso o botão ficará disponível para adicionar outros equipamentos SAT de uma só vez.

 064CB0A389BB4E45931CAEE35073ED38
Feito isso, adicione o e-mail do cliente e Selecione a opção que Aceita como válido o Certificado Digital fornecido pela Secretaria de Fazenda de SP, e clique em Enviar. Feito isso irá abrir uma página para confirmação das informações, valide e clique em “Continuar”.


 

2 - Download pdv
satCompartilhado - 1.jpg


 
3 - Biblioteca sap

satCompartilhado - 2.jpg


 

4 - Instalador pdv

image.png

Obs: Após instalado, observe que irá aparecer um pop-up indicando que será necessária uma configuração prévia

image.png


 

4 – Mova os arquivos

image.png

image.png


 

5 – Instalação do driver no Windows 7.

 image.png

5.1 - Selecione o botão “Procurar Software de Driver no Computador”.

 image (1).png

5.2 – Clique no Botão “Permitir que eu escolha em uma lista de drivers de dispositivos no computador”

 image (2).png

5.3 – Depois selecione a opção “Adaptadores de rede", e clique em avançar.

 image (3).png
5.4 - Selecione "com disco"

image (4).png

5.5 - Clique em procurar 

image (5).png

5.6 - Navegue até a pasta “InfSAT” onde descompactou o driver do SAT, selecione o arquivo satsweda e clique em Abrir.

image (6).png

5.7 – Clique Ok para confirmar a pasta selecionada 

image (7).png

 5.8 - Selecione o adaptador de rede: SAT Sweda e clique em Avançar.

image (8).png

5.9 - Marque a opção Sempre confiar em software da “SWEDA INFORMATICA LTDA” e clique em Instalar

image (9).png

5.10 - Aguarde a instalação e clique no botão fechar

image (10).png


 

6 – Configuração

Captura de Tela 2024-04-25 às 10.41.58.png

6.1 - Clicar em Atualização e Segurança 

 9743D69C110DC0A43035AC34F827E290
6.2 – Clique em “Recuperação” e em “Inicialização avançada” clique em “Reiniciar agora”. O Computador será reiniciado, fique atento as opções que irá mostrar.

 36DBD833E0643BC0D30B73DAE3EE1101
6.3 – Quando Reiniciar o computador irá solicitar que escolha uma opção. Escolha a opção “Solução de Problemas”.

 56C887ED7E5650414C892433F6A0F664
6.4 – Selecione “Opções avançadas”.

4C7C0589D2993F028F3D10BC1C0A6513 
6.5 – Selecione “Configurações de inicialização”.

 7728D09569F66D44B6D6BE4AA668A923
6.6 – Selecione “Reiniciar”. O computador irá reiniciar novamente e apresentar as Configurações de Inicialização.

 A91CD11DA40708039FC867A91D69ED2F
6.7 - Na tela de configurações de inicialização pressione 7 ou F7 para desativar a imposição de assinatura de drivers.

 9E7B547D19D4F7A1048C55903B6B4467


 

7 - Ativação:

Captura de Tela 2024-04-25 às 10.54.02.png

7.1 - Instalar Software de Ativação: Agora que o SAT está configurado vá até a pasta “Downloads”, execute o instalador do programa de ativação e clique em Avançar

image.png

7.2 - Não é necessário alterar a pasta de instalação, clique em Avançar

image (1).png

7.3 - Clique em avançar

image (2).png

7.4 - Clique em instalar

image (3).png

7.5 - Selecione Executar Ativação SAT Sweda e clique em Concluir

image (4).png


 

8 - Ativação:

Captura de Tela 2024-04-25 às 11.03.21.png

8.1 - Na aba associar, marque a opção "produção" preencha os campos Cod. Ativação, CNPJ Software house, Cnpj contribuinte e Assinatura digital (procurar o responsável pelo Suporte para obter) 

Captura de Tela 2024-04-25 às 11.07.07 (2).png


 

9 -Configuração PDV:

image.png


 

10 - Modo sat:

Captura de Tela 2024-04-25 às 11.25.43.png


 

11 - Tela de configuração:

image.png


 
12 -  Preencha o emitente:

image.png

Configuração para ambiente de homologação:

Emitente :

CNPJ - 534852150000106

I.E. - 111072115110

Software house : 

CNPJ - 10615281000140

Integração ECM

O módulo ECM tem objetivo de integrar o ILLI ao sistema de venda online, simplificando a gestão de estoque e manutenção de produtos,
geração de documentos fiscais, clientes e pedidos. De forma transparente e automatizada.

Saiba mais em ECM

 


 

Como funciona

A integração é feita através de API ("Application Programming Interface") , os dados coletados de ambos sistemas são salvos em tabelas de integração

Tabelas NoSql para Sincronismo ECM

     

tipo

tabela

descricao

configuracao

stgConfig

Configuração da Integração illi x loja

enviar

stgCor

Cor auxiliar para o produto

enviar

stgImage

Imagens tabela auxiliar da grade

enviar

stgMarca

Marcas tabela auxiliar para o produto

enviar

stgProduto

Lista de produtos que atenda os filtros das configurações para envio para loja

enviar

stgTamanho

Tamanho tabela auxiliar para cadastro de Produto, antes de enviar aos atributos envia o grupo para cadastro na loja

enviar/receber

stgProdutoGrade

Grade tabela auxiliar para cadastro de produto e recebimento de pedido

receber

stgCliente

Clientes tabela auxiliar para o pedido, caso o CPF já tenha cadastrado no illi, será atualizado somente o endereço.

receber

stgPagamento

Lista de Pedidos importados da loja, precisa configurar na loja o id do illi, o illi não aceita a parcela, será importado o valor total

receber

stgPedido

Lista de Pedidos Importados da loja

     


Módulo ECM

O módulo ECM tem objetivo de gerir essa integração de forma simples, segue o descritivo de cada configuração:

AE2E1C51079706251EE4ABAC9AD53E9A


 

Sincronismo

A consumição entre os sistemas pode ser feita através do modulo ECM ou agendadas no CRON de acordo com a necessidade de cada cliente, exemplo da chamada pelo terminal:

php index.php bibliotecas/76f4d97d-2ded-443b-82d6-6f8313fe2ef5/api_dooca/enviar true

php index.php bibliotecas/76f4d97d-2ded-443b-82d6-6f8313fe2ef5/api_dooca/receber true


 

Comunicação feita pelo ECM:

61CB04B8FACE81333F79C7A5DE1A2081

DB811F78173400BC17B91BB19C2D2582 

Obs: Ao enviar a informação para a loja o agente salva a hora do envio, para que na próxima chamada pegar somente o que foi alterado daquele ponto em diante, então para cada evento será salvo, a última requisição, abaixo como verificar a última execução:

3FA54972C78ECDB87EBEFCDEDCB5B970

É muito importante entender que ao sincronizar as informações os dois sistemas mantem um id (Identificação única) de cada informação, isso mantem o sincronismo funcionando, então é muito importante não fazer alterações manuais ou apagar registros em ambos os sistemas.

Execução linhas de comando illi

As execuções em linha de comando (terminal/shell) do ILLI, sempre será:
sudo -u <usuario_http> <binario_do_php> <index_do_illi> <rota_a_ser_executada> [<parametros>]

<usuario_http> : Substituir pelo usuário atribuído ao serviço do PHP-FPM, normalmente: apache (centos/almalinux) ou www-data (ubuntu/derivados)

<binário do php> : Substituir pelo executável do PHP, normalmente: /usr/bin/php

<index do illi> : Substituir pelo index do ILLI, sendo: /var/www/illi/index.php (cliente único, standalone) ou /var/www/cliente/illi/index.php (multisserviços, nuvem)

<rota a ser executada> : Substituir pela rota da rotina a ser executada, é aceitável a separação por espaço ou por "/" (recomendável), exemplo: illi/phpinfo ou illi phpinfo

[<parametros>] : Os parâmetros neste caso é opcional e é aceitável a separação por espaço ou "/", exemplo:  bibliotecas/d5750023-c2ca-48c5-8897-b050501a9d93/alinhamentoEstoque/alinhar/1 ou bibliotecas d5750023-c2ca-48c5-8897-b050501a9d93 alinhamentoEstoque alinhar 1

Em caso de problemas de execução, deve ser corrigido com:

Considerando cliente único (standalone), baseado em CentOS/AlmaLinux:

 cd /var/www && chown -Rf apache:apache . && find . -type f -exec chmod 644 {} \; && find . -type d -exec chmod 755 {} \; && chmod +x /var/www/illi/*.sh

Considerando cliente único (standalone), baseado em Ubuntu/Derivados:

cd /var/www && chown -Rf www-data:www-data . && find . -type f -exec chmod 644 {} \; && find . -type d -exec chmod 755 {} \; && chmod +x /var/www/illi/*.sh

Considerando nuvem multisserviços, baseado em CentOS/AlmaLinux:

cd /var/www && chown -Rf apache:apache . && find . -type f -exec chmod 644 {} \; && find . -type d -exec chmod 755 {} \; && chmod +x /var/www/*/illi/*.sh


Alteração na composição do CO

O gerador de CO (Código de Operação ou Código de Impressão), vigente desde novembro/2019, chegou a um denominador que está criando conflito.

Hoje, o CO é gerado através dos seguintes fatores:

Prefixo (2 dígitos, completados com zero a esquerda): 

Miolo (10 dígitos):

Sufixo (1 dígito):

Exemplo, considerando o seguinte registro:

Foi aplicado a seguinte alteração de formato:

Miolo (11 dígitos):

Sufixo (2 dígitos, completados com zero a esquerda):

Exemplo, considerando o seguinte registro:

Treinamento Básico de Operações illimitar

Objetivo: 

Capacitar o colaborador para instalar, configurar e operar um sistema PDV completo em Linux e Windows, abrangendo desde a formatação do computador até a criação de usuários, operações de caixa, montagem de ambiente de loja, instalação de VPN e configuração de servidor dedicado ou servidor caixa.

Conteúdo:

1. Formatação e Configuração Básica:

2. Instalação e Configuração do Bartender:

3. Criação de Usuário de caixa:

4. Operações Básicas de Operador de Caixa:

5. Montagem do Ambiente da Loja:

6. Montagem de Máquina:

7. Instalação e Configuração de VPN:

8. Servidor Dedicado (AlmaLinux 8.9):

9. Servidor/Caixa (illi Server);

10. Configurar Sincronismo:

11. Glossário:

Configurando pix como moeda de pagamento

1. Baixar e Importar a Biblioteca

sdadr.png

3saa.png

sase.png


2. Configurar a Forma de Pagamento

sadsakskiie.png

sasdas.png

asdasdas.png


3. Configurar a Biblioteca para a Forma de Pagamento

sdawdew.png


4. Habilitar Pagamento Digital no Menu Rápido

wqwdeqweq.png

sasdasadaw2dq.png

Utilitários suporte

Download práticos: 

 

Instalação vpn Linux

Este passo a passo tem como finalidade, a demonstração de como identificar a antiga chave VPN e instalação em um PDV recém formatado.

:blue_book: Instruções
cat /etc/wnbtlscli/registry

Será retornado um arquivo onde, estará listada o registro (key), da VPN já instalada.

image.png

Caso seja uma máquina nunca instalada uma VPN, é possível solicitar ao SKYTEF apenas a licença (key) do PDV que deseja instalar a VPN, informando apenas o CNPJ do solicitante, através do chat ou do telefone.

CHAT SKYTEF :telephone_receiver: (011) 2175-9500

Após a formatação da máquina, será feito o download do arquivo "wnbinstall.sh”, que se encontra disponível no CLOUD ILLIMITAR, ou clicando ao lado; WNBINSTALL

chmod -Rf 777 wnbinstall.sh
./wnbinstall.sh -i

image.png

wnbmonitor -k XXXXXXXX

Forneça o registro (key) adquirido com o passo 1.

# wnbmonitor -r

Esse comando faz com que o serviço da VPN seja iniciado automaticamente ao reiniciar o computador.

# service wnbmonitor start
# service wnbtlscli start

Reinicie o computador e solicite ao operador(a), que teste a operação de venda utilizando a forma de pagamento TEF.



Instalação do Argox e Bartender

Passos para Instalação do Driver da Impressora Argox e do Software Bartender

1. Preparação dos Arquivos

8.jpg


2. Instalação do Driver da Argox

7.jpg

image.png


3. Instalação do Software Bartender

9.jpg

image.png


4. Ativação do Bartender

5. Resolução de Problemas


6. Tutorial

Instruções Oficiais para Procedimentos em Caso de Erros no Log

Passos para Depuração

A depuração deve ser realizada em dois locais:


 

Responsabilidade na Análise

A análise e apuração dos erros são responsabilidades do analista desenvolvedor. A equipe de suporte técnico deve seguir os seguintes procedimentos:


 

Comunicação com o Desenvolvedor:

A comunicação com o desenvolvedor deve ser mediada pela equipe de homologação (QA). Todo problema identificado pelo suporte deve ser encaminhado à homologação. O procedimento é o seguinte:

Nota: O suporte técnico não deve comunicar-se diretamente com a equipe de desenvolvimento. Todo problema deve passar primeiro pela homologação.


 

Considerações Adicionais

Configuração de E-mail no illi

1. Acessando o Illi

image.png


 
2. Obtendo Configurações do E-mail

image.png

2.1 Acessando a Configuração Geral

image.png

2.2 Exemplo de Configurações para Hotmail/Outlook

image.png

2.3 Exemplo de Configurações para Hotmail/Outlook

 


 

3. Configurando o E-mail na Entidade

DImageEditor_2024-08-16.jpg

image.png

3.1 Exemplo de Configurações para Hotmail/Outlook

 

 
 Importante

Certifique-se de estar logado na entidade correta. Se não estiver, a configuração aplicada não funcionará corretamente.

Configuração o SiTef (TLS) no PDV

Este guia explica passo a passo como configurar o módulo de pagamento SiTef no seu Ponto de Venda (PDV), tanto para conexões VPN quanto TLS.

1. Localizando a pasta de arquivos (DLLs)

Antes de tudo, precisamos encontrar a pasta lib do PDV. É lá que ficam os arquivos de configuração que vamos ajustar.

Nota: Os nossos PDVs mais novos (Navegador PDV 5.3.1) já vêm com os arquivos (DLLs) mais recentes, na versão clisitef-7.0.117.109.r1-Producao (data: 07/17/2025). Você pode confirmar a versão olhando o arquivo RELEASE.txt nessa mesma pasta.


2. Configuração Inicial (Primeiro Acesso)

Ao abrir o Navegador PDV pela primeira vez, ele pedirá algumas informações de configuração.

37.png

39.png

40.png


3. Ajustando o arquivo CliSiTef.ini

Agora, vamos editar um arquivo de configuração. Volte para a pasta lib (que vimos no Passo 1) e abra o arquivo CliSiTef.ini com um editor de textos.

Precisamos habilitar os traces (registros de log) e definir onde o sistema salvará as chaves de segurança.

Nota: O arquivo é dividido por seções, como [CliSiTef], [Geral], etc. Se a seção ou a linha não existir, você pode adicioná-la.

3.1. Para Windows

O arquivo deve ficar parecido com este exemplo. As linhas mais importantes para esta configuração são HabilitaTrace, DiretorioTrace e toda a seção [SalvaEstado]:

Importante: Para evitar falhas de comunicação ou a necessidade de solicitar um novo token, é essencial manter o padrão estabelecido nos exemplos.

[CliSiTef]
HabilitaTrace=1
DiretorioTrace=C:/CliSiTef

[Geral]
TransacoesAdicionaisHabilitadas=7;8;29;42;

[PinPad]
Tipo Compartilhado
MensagemPadrao=ILLIMITAR|INFORMATICA
  
[SalvaEstado]
DiretorioBase=C:/CliSiTef/chaves

[PinPadCompartilhado]
Porta=AUTO_USB

image.png

3.2. Para Linux

No Linux, os caminhos são um pouco diferentes. Você deve adicionar ou ajustar as seguintes linhas:

*//Na seção [CliSiTef]:

HabilitaTrace=1 
DiretorioTrace=/home/user/CliSiTef 


*//E adicione esta nova seção (ou edite se ela já existir):

[SalvaEstado] 
DiretorioBase=/home/user/chaves

image.png


4. Inserindo o Token no CONFITLS.INI (Apenas TLS)

Se você está configurando a conexão TLS (aquela que usa o endereço https), temos mais um passo!

100.png


5. Ativação e Teste Final

Estamos quase lá! Depois de salvar os arquivos .ini que editamos:

image.png

image.png

image.png

Se tudo deu certo, você verá a mensagem "Servidor Ativo".
Isso significa que o TLS está funcionando perfeitamente!

iMidia

iMidia

Guia de Instalação e Configuração - iMidia

Siga este passo a passo para configurar o ambiente, instalar o software e automatizar a inicialização do sistema.

Pré-requisitos do Sistema:

Antes de iniciar, certifique-se de estar logado como um usuário com privilégios (sudo) e que os drivers de áudio do sistema operacional estejam instalados corretamente.

1. Atualizar o sistema e instalar dependências básicas:

Abra o terminal e execute os seguintes comandos:

sudo apt update
sudo apt -y install curl dirmngr apt-transport-https lsb-release ca-certificates git


2. Instalar Node.js (Versão 12.x):

O iMidia requer o Node.js. Execute os comandos abaixo para configurar o repositório e instalar:

curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt -y install nodejs

Verifique a instalação:

node -v
npm -v


Passo 1: Instalação do iMidia

Agora vamos baixar o código fonte e instalar as dependências do projeto.

1. Preparar o diretório:
sudo mkdir -p /var/www/
cd /var/www/

2. Clonar o repositório:

Baixe a versão correta (branch imidia) do Git:

sudo git clone -b imidia https://git.pdv.moda/publico/biblioteca.git imidia


3. Definir permissões e instalar pacotes:
sudo chmod -Rf 777 /var/www/imidia
cd /var/www/imidia
npm install

4. Testar a aplicação e instalar o gerenciador de processos (PM2):

Primeiro, instale o PM2 globalmente:

npm install pm2 -g

Inicie a aplicação para garantir que tudo está funcionando:
pm2 start /var/www/imidia/main.js


Passo 2: Configuração no Servidor Local:

Nesta etapa, você deve acessar a interface do servidor para apontar o iMidia corretamente.

  1. Acesse o servidor local.

  2. Vá até Configurações Gerais > Raiz do Servidor Local.

  3. Localize a Biblioteca iMidia.

  4. IMPORTANTE: Altere o IP registrado para o IP do Servidor de Mídia atual.

Configuração da "Ação Rápida"

Ainda nas configurações, preencha os dados da função "Ação Rápida":

http://192.168.124.171:8088/bibliotecas/64fed735-a675-4279-bf15-36eb5fd8d2e7/apiMidia/fila

Fechar Ação Rápida após execução: Selecione SIM.


Passo 3: Automação e Inicialização (Boot):

Esta etapa garante que o iMidia inicie sozinho caso o computador seja reiniciado e que o navegador abra em tela cheia.

1. Criar o script de inicialização

Este script deve ficar na pasta do usuário para garantir acesso ao áudio.

Abra o terminal na pasta do usuário (substitua usuário pelo nome real do usuário):

cd /home/usuario
sudo nano imidia.sh

Cole o seguinte conteúdo dentro do editor (Nano):

#!/bin/bash
cd /var/www/imidia
pm2 start main.js

Nota: Certifique-se de que a primeira linha é #!/bin/bash (com a exclamação), caso contrário o script não executará.

Salve o arquivo (Ctrl + O, Enter) e saia (Ctrl + X).

2. Dar permissão de execução ao script:
sudo chmod -Rf 777 imidia.sh

3. Configurar o Cron (Agendador de Tarefas):

Edite o crontab do usuário atual (não use root se quiser garantir o áudio):

crontab -e

Adicione a seguinte linha ao final do arquivo: (Lembre-se de alterar /home/user/ para o caminho correto caso o usuário não seja user).

@reboot /home/user/imidia.sh

Salve e feche o arquivo. Em seguida, reinicie o serviço do cron:

sudo service cron restart

 

4. Configurar o Navegador (Chrome) no arranque:

Para que o Chrome abra automaticamente em tela cheia ao iniciar o sistema, adicione o comando abaixo nos "Aplicativos de Inicialização" (Startup Applications) do Linux:

/opt/google/chrome/google-chrome --profile-directory=Default --start-fullscreen --app-id=127.0.0.1:8080

iMidia

Troca de Vídeo no iMidia

Este procedimento tem como objetivo auxiliar o funcionário a realizar a troca de vídeo em exibição no iMidia de forma fácil e rápida, especificamente para casos onde se utiliza 01 CPU como servidor de mídia.

1. Identificação do Cliente:

O primeiro passo é localizar a máquina correta através do sistema de acesso remoto.

image.png


2. Substituição do Arquivo de Vídeo:

Nesta etapa, você fará a gestão dos arquivos dentro da pasta do sistema.

image.png


3. Reinicialização do Sistema:

Para que as alterações entrem em vigor, é necessário reiniciar o serviço.

image.png

reboot

image.png


Conclusão: Após o reinício, o novo vídeo nomeado como vd1.mp4 passará a ser exibido automaticamente.

Configuração do CTFClient Portable e Auttar no PDV

Esta seção descreve o processo técnico para preparar o ambiente e configurar a integração de TEF (Transferência Eletrônica de Fundos) utilizando a biblioteca Auttar no sistema PDV.

1. Preparação dos Arquivos no Windows

O primeiro passo é garantir que os arquivos estejam no local correto para que o sistema consiga encontrá-los.

image.png


2. Ajuste dos Parâmetros de Integração

Agora, vamos "ensinar" o comunicador como ele deve trabalhar.

image 24.png 

image 25.png



3. Configuração das Variáveis de Ambiente

Para que o Windows reconheça o CTFClient em qualquer lugar, precisamos cadastrá-lo nas variáveis do sistema.

image.png

image 26.png

image.png

image.png


4. Configuração Final no PDV

Com o ambiente pronto, vamos ativar o módulo dentro do sistema de vendas.

image.png

image.png

image.png


1. Instalação no Linux

A instalação do CTFClient no Linux pode ser realizada através do pacote ctfclient--linux-portable-x86_64.tar.

Descompactar o pacote de instalação do CTFClient e garantir que seja instalado em uma pasta no mesmo nível da pasta da aplicação da AC.
Exemplo:
/opt/PDV
/opt/CTFClient

2. O pacote de instalação do CTFClient instala as seguintes pastas:

/opt/CTFClient/bin
/opt/CTFClient/lib
/opt/CTFClient/JRE
/opt/CTFClient/include


3. Após descompactação dar permissão na pasta através do comando:
chow -Rf user:user /opt/CTFClient/

4. Para iniciar o CTFClient na integração do tipo dll:

5. Configuração do tipo de integração

A configuração do tipo de integração do CTFClient é feita através do parâmetro tipo integracao do arquivo configCTFClient.xml.

Por padrão, a instalação do CTFClient é pré-configurada para o tipo de integração dll:

image.png

Para habilitar a comunicação do tipo https:

image.png

Após realizar estas configurações é obrigatório instalar o navegador pdv(5.3.5ou superior)
Após instalação realizar a configuração do modulo TEF no pdv.(Registrar Terminal).