MCP - (Configuração Geral – Nota Direta)
Descrição
Este documento visa demonstrar os passos necessários para a configuração de documento quando utilizado o método de Nota direta, nos parâmetros necessários para o envio de Nota para o JetPDV
Índice
Pré-Requisitos
Licença do JetPDV liberada
Passo a passo
1 – Configurações do Servidor XE
O sistema usa como ponte para montar as informações que serão encaminhadas para o JetPDV o servidor XE, por isso é de suma importância que o mesmo esteja correta e devidamente configurado.
A primeira coisa que deve ser verificado, são os arquivos de conexão do Servidor XE, que se encontram na pasta Viasoft/Server/Construshow/ViasoftServerMCP_XE.conexões Informe o caminho do banco de dados no campo “database”:
Execute o servidor XE que está na mesma pasta do arquivo de conexões:
Selecione no menu a opção Configuração>>Conexões:
Nesta opção selecione a conexão configurada anteriormente e teste a conexão com o banco de dados para verificar se o XE está de fato conectando com o banco do cliente:
Se estiver tudo certo, apresentará uma mensagem de conexão bem-sucedida:
Caso de uma mensagem de erro, verifique novamente as configurações de conexão.
2 – Configuração do Sincronizador do JetPDV
O sincronizar ou como é denominado o executável, “SyncJetPDV”, é o agente responsável por transportar as informações entre servidor do Jet e Servidor XE. Ele transporta as informações tanto de notas, clientes e produtos e sua configuração é de suma importância.
O SyncJet pode ser encontrado na pasta Viasoft/Server/Construshow, onde serão dois arquivos o SyncJetPDV.exe e o SyncJetPDV.conf. Caso esses arquivos não estejam na pasta mencionada, faça o download dos mesmos no seguinte link:
https://drive.google.com/drive/folders/1O2886B7UH8L8rauCqKwntyEzb7V5W7wM?usp=sharing
ServerNameAlias -> Nome da conexão do XE
NomeConexaoAlias -> Nome da conexão do XE
IdConfSync -> Empresa do estabelecimento
Estabitem -> Estabelecimento padrão para Itens
Empresacliforn -> Empresa do Estabelecimento
Após essas informações preenchidas inicie o ServerMCP_XE e depois inicie o SyncJetPDV e verifique se na parte inferior da tela do SyncJet não aparece nenhum tipo de erro de conexão, caso não apresente a conexão foi concluída. Também realize o teste para verificar se o Server_XE está online para trabalhar, isso pode ser verificado através do link:
http://192.168.1.102:9091/viasoftserver/rest/TdmServerModuleInvocationMCP/Status
Substitua o IP e a porta do link pelo IP apresentado no servidor XE:
Ao realizar a consulta do link, deve retornar um resultado positivo no navegador:
Após realizar esse teste, é importante também realizar o teste para verificar se o servidor do JetPDV também está online, através do link:
http://192.168.1.142:80/cgi-bin/sactus.fcgi?web_option=list_stores
Da mesma forma que o link anterior substitua o IP pelo IP da máquina virtual, a porta 80 é padrão então não precisa ser alterado. Caso não tenha o IP da máquina virtual pode realizar o login no console utilizando o Putty e dar o comando “ifconfig”, assim terá a informação do IP da máquina virtual:
Ao acessar o link deverá retornar as informações da empresa, se isso ocorrer o servidor do JetPDV já está online.
Esses processos de verificação poderão ser confirmados novamente no item 3 a seguir, diretamente de dentro do construshow, então caso queira pular essa etapa fica a cargo do usuário.
3 – Configurações Gerais de Integração do JetPDV
A primeira tratativa que deve ser realizada dentro do construshow é a configuração geral das informações, no menu Configurações>>Configurar Integração com JetPDV. Essa configuração é por empresa, ou seja, todas as empresas que utilizarem o JetPDV deverão conter configuração:
No frame “Configuração Servido XE” informar o IP e a porta REST do servidor XE, para testar o servidor deve estar iniciado e depois clique no botão “Testar” se o retorno for conectado com sucesso isso significa que o servidor XE já está online.
No frame “Configuração Servidor do JetPDV” informe o IP configurado no JetPDV e a parta sempre será a 80, que a porta padrão do protocolo HTTP:
A próxima configuração é referente às finalizadoras, que são códigos que refletem no JetPDV a forma de pagamento informada na transação, e nisso temos duas visões as finalizadoras do construshow e as finalizadoras do JetPDV, ambas deve ser ligadas, por isso basta configurar o frame finalizadoras utilizando códigos condizentes com as finalizadoras do JetPDV:
Cadastre as seguintes informações, para que o processo fique no padrão de implantação:
No frame “Sincronização com o Servidor do JetPDV” informe os segundos de sincronização de cupons, produtos e clientes. Todos devem ser maiores que zero, principalmente a configuração de sincronização de cupons:
E por último na tela de configurações do JetPDV temos os diretórios de histórico e Log dos eventos, informe o mesmo IP informado no frame “Configuração Servidor do JetPDV”, isso é uma boa prática, mas esses diretórios nada mais são do que os locais onde armazenará os xmls transmitidos e também os logs de verificação:
4 – Configuração de Documento
No método de nota direta, o usuário deve prestar atenção em algumas questões da configuração de documento. Na configuração de documento que o usuário for utilizar para as vendas em NFC-e utilizando o autorizador do JetPDV as seguintes configurações devem estar corretas:
Operação: DV
Espécie: NFC
Série: Mesmo número informado no cadastro do PDV (Lembre que a série e o número do PDV configurado na loja devem ser o mesmo)
Movimenta Financeiro: Sim
Movimenta Estoque: Verificar qual movimentação o cliente faz nas vendas e se movimentar estoque deixar Sim
Acerto no Caixa: Sim
Finaliza no Caixa: Não
Tipo de Emissão: Própria
Consumidor Final: Sim
Emite NF-e: Sim
Finalidade: 1 – NF-e Normal
Gera Nota de Transporte: Não
Exporta NFCe JetPDV: Sim
Após as configurações finalizadas, deve ser liberado as informações para os grupos pertinentes em Configurações>>Usuários>>Configurações de Grupos e Usuários >>Configuração de Documentos X Usuários. Também liberado a configuração para aparecer no carrinho em Configurações>>Gerais>>Carrinho(Doctos):
O funcionamento da tributação nas operações com o JetPDV é um pouco diferente e deve ser tomado alguns cuidados para compreender o seu funcionamento. Em nenhum momento, ao gerar uma nota de venda, o construshow manda informações de tributação para o JetPDV, ou seja, mesmo que seja alterada alguma informação diretamente na tabela de tributação ou no próprio pedido, isso não significa que a alteração será aplicada para a nota em questão. Caso esse problema ocorra pode ser verificado o tópico 6.1 a resolução do mesmo.
Mas como o JetPDV sabe qual configuração de tributação aplicar no momento de gerar o XML? O Jet tem o poder de realizar essa informação da forma correta, justamente pelas cargas enviadas com as informações do produtos todos os dias, ou a todo momento do intervalo configurado, se
assim for estabelecido. O ponto principal é a base que os servidores usam para montar essas informações.
Dentro da tabela FILALCONFDOC existe a possibilidade de informar uma configuração de documento específica que seja a padrão de montagem de tributação para o envio do Jet. Essa tributação será por estabelecimento e irá levar em consideração o documento informado na coluna IDNOTACONF e que na coluna PADRAOENV esteja “S”.
Tendo essa informação o sistema saberá quais dados tributários carregar para enviar ao JetPDV
6 – Produtos
Algumas informações nos cadastros de produtos podem impactar diretamente no processo de venda pelo JetPDV, neste tópico, buscamos aborda-los
.1 Unidade de Medida
Para que a integração funcione da maneira esperada, é importante verificar no cadastro de unidades do Construshow se a quantidade de casas decimais está configurada corretamente. Para isso acesse o menu: “Mercadorias » Cadastros Específicos » Unidade dos Produtos” e veja nas unidades de medida cadastradas se o campo “Qtde de Decimais” está com a quantidade correta, conforme a imagem:
Ou seja, unidades inteiras não podem ter casa decimais
7 – Processo de Venda
Acesse o carrinho, informe o produto e cliente caso seja cliente identificado. Após isso realize a simulação de pagamento e após confirmado os produtos e a forma de pagamento com cliente, finalize o carrinho.
Ao finalizar o carrinho selecione o documento de emissão de NFC-e configurado:
Após isso só realizar as demais confirmações padrão e o documento já será direcionado para o caixa.
Já com o documento no acerto de caixa, o mesmo deve usar a opção “Exec. Ação Rápida” para finalizar um documento NFC-e. Esse comando vai gerar a requisição para o JetPDV do qual montará o xml e autorizará junto à SEFAZ, depois dessa autorização retornará a nota como emitida com sucesso:
Caso essa opção não esteja apresentando, deve ser verificado as liberações de processo do usuário, o processo 148 deve estar marcado como “Executa”:
8 – Cancelamento
O cancelamento será feito pela rotina “Processos » Acerto de Caixa/Balcão » Consulta Notas Fiscais”. No Grid, localize a nota desejada e clique em “Cancelar”.
Para realizar o cancelamento, será necessário informar o motivo do cancelamento da nota fiscal.
9 – Inutilização de Faixa Numérica
Quando a inutilização for do tipo 65 e a opção supracitada estiver marcada, o processo será feito pelo Construshow, porém, a inutilização será feita pelo JetPDV.
Por este motivo, será necessário marcar a opção "Utilizar Pelo Server XE” no menu “Configurações » Gerais » Integrações”.
Controle de Alterações:
Data | Alteração | Usuário | Versão Ant. |
26/04/2022 | Criação do Manual | Cleber Veiga |
|
Dicionário de Dados
Dicionário do Banco de Dados
Caso tenha interesse em saber os campos do banco de dados que se relacionam a cada campo do sistema, sugerimos a leitura do artigo a seguir: Dicionário do Banco de Dados - Documentação para Usuários - Confluence
Erros Comuns
Situações que podem ocorrer durante o uso da rotina
Versão
Versão do Sistema | Versão do Banco de Dados | Versão da Documentação | Autor/Revisor |
---|---|---|---|
23.010 | 23.010 | 1.0 | Fátima Zahraa |
|
|
|
|