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: https://nimitz.atlassian.net/l/c/NDGXWDD6


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

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