MCP - Configuração Geral – (Nota de Transporte)

Descrição

Este documento visa demonstrar os passos necessários para a configuração de documento quando utilizado o método de Nota de Transporte, nos parâmetros necessários para o envio de Nota para o JetPDV

 


Índice


Pré-Requisitos

  • Licença do JetPDV liberado


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.

Para enfatizar melhor o funcionamento da estrutura de comunicação, observe na imagem a seguir:

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

Baixe os dois arquivos e cole no caminho Viasoft/Server/Construshow. Após certificar-se dos dois arquivos estarem em seu devido diretório, abra o arquivo SincJetPDV.conf com o editor de texto. Edite as informações conforme descrito a seguir:

  • 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 de transporte existem alguns pontos a serem considerados pelo usuário que está configurando. O usuário deve cadastrar duas configurações de documento, uma que atuará como Pedido e outra que atuará como a nota em si.

Na configuração de documento do pedido deve estar informado da seguinte maneira:

 

  • Operação: DV

  • Espécie: NF

  • 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: Sim

  • Tipo de Emissão: Própria

  • Consumidor Final: Sim

  • Emite NF-e: Não

  • Finalidade: 1 – NF-e Normal

  • Gera Nota de Transporte: Sim

  • Exporta NFCe JetPDV: Não

Já na configuração da Nota em si, deve-se configurar da seguinte maneira:

  • Operação: OS

  • Espécie: NFCE

  • 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: Não

  • Movimenta Estoque: Verificar qual movimentação o cliente faz nas vendas e se movimentar estoque deixar Sim

  • Acerto no Caixa: Não

  • 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

Também é necessário no documento da nota informar a partir de qual documento o mesmo será gerado, e nessa configuração deve ser informado a partir do pedido:

5 – Local de Retirada

 

Acesse o menu “Mercadorias » Estoques » Locais de Retirada”, para configurar o local de retirada utilizado no carrinho. Na opção “Gerar Nota Transp em...” informe a opção “Caixa”:

6 – Tributação

 

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á qual dados tributários carregar para enviar ao JetPDV

7 – Produtos

 

Algumas informações nos cadastros de produtos podem impactar diretamente no processo de venda pelo JetPDV, neste tópico, buscamos aborda-los

7.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

8 – Processo de Venda

 

Acesse o carrinho no menu “Processos » Carrinho” e informe o item do pedido, depois informe o cliente e o método de pagamento, e finalize com a configuração de documento “Pedido de Venda” vinculado ao “A partir de” do documento de emissão de NFC-e, caso esteja definido para que a configuração seja selecionada ao finalizar o carrinho. Veja no exemplo a seguir:

Acesse o menu “Processos » Acerto de Caixa/Balcão” e clique na opção “Finalizar”. Em alguns casos, pode ser configurado para exibir novamente a tela de seleção da configuração do documento referente ao pedido de venda. Neste caso, selecione a configuração, conforme imagem abaixo:

Será exibida a tela de “Gera Nota de Transporte”, para que a nota seja enviada para a SEFAZ, então selecione o documento para emissão de NFC-e e aguarde o envio e a geração dos cupons configurados.

Ao selecionar o documento que irá gerar a NFC-e, será realizado a comunicação e então o Jet irá transmitir a nota fiscal.

 

9 – 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.

10 – 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