...
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
...
|
Esse documento visa especificar as
...
funcionalidades do Ticket Log no EMSys3.
A recolha de notas fiscais é um serviço automatizado disponibilizado pela Ticket Log de recolhimento e validação das notas fiscais dos abastecimentos. Visando facilitar o processo de emissão de notas fiscais para os clientes optantes pelo serviço, foi implementado uma integração via API do Ticket Log com o EMSys3.
...
Caminho: Gerencial > PDV > Forma de Pagamento > Cadastro Forma de Pagamento
...
Requisitos
- É preciso solicitar a liberação do módulo para seu estabelecimento na licença do EMSys.
Ter o código do estabelecimento, usuário e senha junto a Ticket Log para realizar as configurações no sistema EMSys.
É obrigatório ter a versão atualizada do EMSys. "Versão mínima 3.5.21.940"
Configuração
Para comunicação com o WebService do Ticket Log,
...
é necessário configurar os dados de conexão por empresa nomenu: Sistema
...
→ Parâmetros Empresa → Ticket Log
| Dica |
|---|
Informe os Campos corretamente de acordo com informações encaminhadas pela Ticket Log URL Base, Usuário, Senha, Cód. Estabelecimento Ticket Log e Cód. Estabelecimento Expers. Importante: As informações são fornecidas somente pela Ticket Log. |
Ao selecionar a opção "Consultar e atualizar/cadastrar favorecido no cupom fiscal", irá permitir atualização das transações do Ticket Log, o sistema fará a consulta da transação e atualizar o cliente do cupom fiscal.
Após liberação de uso na licença e configurado os dados de conexão nos parâmetros da empresa, o sistema estará apto a fazer a comunicação com o WebService Ticket Log.
...
Na consulta com o WebService será retornado para o EMSys3 as autorizações da transação apenas de clientes que optaram pelo pacote de serviços ofertados pela Ticket Log, e somente desse serão emitido as notas fiscais.
...
Gerencial > Vendas > Ticket Log
...
Passo a passo:
...
Cadastro
Para localizar corretamente os combustíveis durante o envio de preço, faça as seguintes alterações:
- No cadastro de Forma de Pagamento PDV é necessário habilitar estes dois campos conforme a imagem abaixo;
- No cadastro de item, habilitar a opção Ticket Log e incluir a Forma de pagamento;
Procedimento
Menu: Gerencial → Vendas → Ticket Log
- Selecionar a Forma de pagamento.
- Informe o Período das movimentações.
- Selecione o Modelo Documento Fiscal.
As opções 4,5,6 e 7, serão apresentadas abaixo.
Forma de Pagamento
É necessário selecionar a forma de pagamento, o sistema disponibiliza a opção de buscar todas que estão cadastrada no Emsys.
Para fazer o cadastro ou alterar a forma de pagamento acesse o menu: Gerencial → Gerencial → PDV → Forma de Pagamento → Cadastro Forma de Pagamento
| Aviso |
|---|
| Observação “Forma de Pagamento”: Só será apresentado na tela de comunicação com a API da Ticket Log as formas de pagamento que estiverem com informação de |
...
| Cartão combustível “TicketLog” no cadastro de forma de pagamento PDV. |
Detalhamento
Serão implementadas 2 telas para execução dos processos de upload de Preços base de combustíveis, upload de negociações de clientes e upload das NF-e gerada pelo processo de recolha autônoma no portal Ticket Log e inclusão de controle de status de cupons fiscais consultados via API e transmissão de NF-e:
- Tela para envio do preço base e Negociação por Cliente;
- Tela para Envio das NF-e geradas pelo processo de emissão TicketLog;
Upload do XML de Nota Fiscal Saída
Possibilitar o upload no portal da Ticket Log das notas emitidas através da tela Ticket Log (Gerencial > Vendas > Ticket Log) de acordo com layout “3.Recolha Autônoma - Web API - Manual Técnico (v14092020).pdf”.
Ao selecionar a opção “Gerar Nota(s) de Cupom”, a NF-e será transmitida e o sistema apresentará uma mensagem questionando se será realizado o upload das notas fiscais no portal da Ticket Log:
...
...
Filtros:
- Período;
- Status Upload – Transmitidas, Não Transmitidas e todas – (Criar um controle de data e hora da transmissão);
- Selecionar mais de uma empresa;
...
{
"codigoEstabelecimento": "integer",
"codigoAutorizacao": "number",
"dataAutorizacao": "date",
"arquivo": {"nomeOriginal": "string",
"base64Encode": "string",
"MD5hash": "string"}
}
Upload negociação de preço por cliente
Possibilitar o upload de negociação de preços por cliente no portal da Ticket Log via API de acordo com o layout “2.Preço Negociado - Web API - Manual Técnico (v24112020).pdf”.
Implementar:
...
Período de Venda
Informar a Data conforme a necessidade da busca que o usuário precisa realizar.
| Nota |
|---|
Para continuar com os próximos passo é preciso clicar em Buscar Cupons. |
Modelo Documento Fiscal
O modelo de Documento deve ser informado no momento em que for gerar a nota.
Para Cadastro ou alteração;
Menu: Gerencial → Gerencial → Fiscal → Modelo Documento Fiscal
Upload API Preços
Possibilita o upload do preço base praticado pelo Posto dos itens combustíveis ao portal da Ticket Log via API.
O processo de upload ocorre de forma automática, criando um serviço que verifique se há registro novo na tabela e automaticamente faça o upload no portal;
...
Uma tela para seleção da negociação de preços por cliente (apresentar a última negociação cadastrada para o cliente)
Opções de filtros:
→ Tipo de Upload (Preço base ou Negociação por cliente)
→ Seleção de itens – apenas combustíveis (poderá 1 ou mais)
→ Seleção de cliente (poderá 1 ou mais)
→ Seleção de status do envio (enviados, não enviados, todos)
→ Seleção de empresas
Na tela de negociação de preços por cliente dar opção para chamar o gerenciador de upload de negociação de preços (Cadastro de Pessoa > Cliente > Pagamento > Negociação de Preços);
Quando a tela for requisitada através do cadastro de negociações pelo cliente, já apresentar filtrado pelo código de cliente selecionado no cadastro;
...
{
"cnpjEstabelecimento": "33756255000138",
"redeExpers": true,
"cnpjCliente": "15652040000195",
"consideraRaizCnpjCliente": true,
"tipoCombustivel": 2,
"valorLitroNegociado": 3.000
}
Visualização de negociação de clientes no portal:
Upload preço base
Possibilitar o upload do preço base praticado pelo Posto dos itens combustíveis ao portal da Ticket Log via API de acordo com o layout “1.Preço Base - Web API - Manual Técnico (v24112020).pdf”.
Implementar:
Fazer com que o processo de upload ocorra de forma automática, criando um serviço que verifique se há registro novo na tabela e automaticamente faça o upload no portal;
Tela para seleção de preço (apresentar o preço vigente) :
Opção de filtros:
→ Tipo de Upload (Preço base ou Negociação por cliente)
→ Seleção de itens – apenas combustíveis (poderá 1 ou mais)
→ Seleção de status do envio (enviados, não enviados, todos)
→ Seleção de empresas
...
{
"cnpjEstabelecimento": "33756255000138",
"redeExpers": true,
"tipoCombustivel": 2,
"valorLitro": 3.000
}
Visualização de cadastro de preços base no portal:
...
| Aviso | ||
|---|---|---|
| ||
Importante fazer a conferência. |
| Painel | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
Quando o sistema não buscar nenhum dado no menu envio de preço para ticket Log, verifique o cadastro dos itens combustíveis, nos parâmetros empresa para certificar-se que esteja correto.
Depois é possível fazer o vinculo, Clique na opção abaixo para maiores informações.
|
Enviar Preço BaseÂncora 1 1
| 1 | |
| 1 |
Para atualizar os preços na Base de dados do Ticket Log, status no sistema podendo ser Pendente ou Enviado.
O normal é deixar todos itens com o Status Enviado para não ter nenhum problema durante o processo de gerar as notas.
Selecionar o Item e clicar em Pesquisar.
Depois selecionar todos itens que encontram com o Status Pendente, e clicar em Enviar.
Visualização de cadastro de preços base no portal:
Enviar Preço Negociado
Possibilita o upload de negociação de preços por cliente no portal da Ticket Log via API.
Preciso informar a Data, Forma de Pagamento, Cliente, item e clicar em Pesquisar.
Depois de fazer a seleção basta Enviar as informações.
Visualização de negociação de clientes no portal:
Parâmetros Combustível
Parâmetro que irá conciliar as informações do sistema Emsys com o Ticket Log.
Código → Informações do ticket
Descrição → Informação do item
EMSys → O Código do item na base de dados do sistema Emsys
| Aviso | ||
|---|---|---|
| ||
Muito importante manter as informações atualizada. |
Consultar Venda API
Após realizar a pesquisa de todas as vendas que foram efetuadas no sistema e selecionar, preciso clicar nesta consulta para as vendas retornar com o Núm. Autorização, com isso o cliente consegue gerar as Nota de Cupom.
Quando for consultado autorizações para emissão da NF-e via “Consulta venda API”,
...
na tabela a data e hora de consulta e o status retornado pela consulta na Ticket Log serão gravadas:
...
→ Data e hora da consulta: 17/03/2020 13:20;
→ Status: Código Autorização ou não encontrado;
...
Documentações Ticket Log Disponíveis:
...
1.Preço Base - Web API - Manual Técnico (v24112020).pdf
...
2.Preço Negociado - Web API - Manual Técnico (v24112020).pdf
...
3.Recolha Autônoma - Web API - Manual Técnico (v14092020).pdf
...
4.APIs RAU-Insumos para Testes em Homolog (v05102020).pdf
...
5.APIs PREÇO-Insumos para Testes em Homolog (v24112020).pdf
...
Gerar Nota(s) de Cupom
Depois de realizar a consulta da venda, é preciso clicar nesta opção para o sistema fazer a geração da Nota Fiscal.
Uploade API NF
Possibilitar o upload no portal da Ticket Log das notas emitidas através da tela Ticket Log (Gerencial > Vendas > Ticket Log).
Ao selecionar a opção “Gerar Nota(s) de Cupom”, a NF-e será transmitida e o sistema apresentará uma mensagem questionando se será realizado o upload das notas fiscais no portal da Ticket Log:
|
|---|
| Yes > Direciona para a tela “Upload NF-e”: |
| Não > encerra o processo e grava os dados da NF-e para posterior Upload; |