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