Páginas filhas
  • DDLEGFIN-1232 - Comunicação com Sistema GATECASH.

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Produto:

Solucoes_totvs
SolucaoTOTVS Distribuição e Varejo

Solucoes_totvs_cross
SolucaoCross

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVS

Linha de Produto:

Linhas_totvs
LinhaLinha Winthor

Segmento:

Segmentos_totvs
SegmentoDistribuição

Módulo:20 - Auto Serviço
Função:
País:Brasil
Ticket:DDLEGFIN-1232
Requisito/Story/Issue:

DDLEGFIN-1232

DDLEGFIN-1272

DDLEGFIN-1233

DDLEGFIN-1273

DDLEGFIN-1234

DDLEGFIN-1235

DDLEGFIN-1236

DDLEGFIN-1238

DDLEGFIN-1274

DDLEGFIN-1275


02. SITUAÇÃO/REQUISITO

Inicializar a comunicação como sistema Gatecash Informando Caminho do Log.

...

Expandir
titleSolicitação: DDLEGFIN-1274

Fechamento de Documento 


1) Na 2075, ao finalizar a emissão de algum documento ou fechar a venda cupom fiscal, caso o parâmetro UTILIZAGATECASH estiver marcado como SIM e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, deve ser implementado a chamada da seguinte função da dll:

  • GATECASH_FechaDocumentoCod_InformPDV(Codigo: Integer): Integer;
  • No parâmetro Codigo, deve ser passado o número do documento ou cupom fiscal;
  • A função GATECASH_ FechaDocumentoCod_InformPDV terá os seguintes retornos:
    • 0: sucesso ao enviar evento;
    • -1: comunicação não iniciada;
    • -999: falha ao executar comando.
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.

03. SOLUÇÃO

Expandir
titleSolicitação: DDLEGFIN-1275

Cancelamento de Cupom

Na 2075, ao cancelar o cupom com a venda aberta antes do seu fechamento (ex.: cliente passou a compra e desistiu), caso o parâmetro UTILIZAGATECASH estiver marcado como SIM e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, deve ser implementado a chamada da seguinte função da dll:

  • GATECASH_CancelaCupomEx_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
  • No parâmetro Codigo, deve ser passado o número do cupom;
  • No parâmetro Pdv, deve ser passado o número do caixa;
  • A função GATECASH_CancelaCupomEx_InformPDV terá os seguintes retornos:
  • 0: sucesso ao enviar evento;
  • -1: comunicação não iniciada;
  • -999: falha ao executar comando.
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.


03. SOLUÇÃO


Totvs custom tabs box
tabsParametrização,2044 - Cadastrar Checkout, 2575 - Frente de Caixa, Registro de Suprimento e Registro de Sangria, Passo 04
idspasso1,passo2,passo3,passo4,
Totvs custom tabs box
tabsParametrização,2044 - Cadastrar Checkout, 2575 - Frente de Caixa, Registro de Suprimento e Registro de Sangria, Passo 04
idspasso1,passo2,passo3,passo4,
totvs-custom-tabs-box-items
defaultyes
referenciapasso1

1. Acesse a rotina 560 - Atualizar Banco de Dados na versão 30.2.0.272 e atualize a Tabela de parâmetros por Filial -  132 (PCPARAMFILIAL):



2. Acesse a rotina 132 - Parâmetros da Presidência e marque Sim no parâmetro 4519 - Utiliza Integração Gatecash:


Quando marcado como Sim, o parâmetro visa a realizar a integração do PDV com o sistema Gatecash.



3. Atualize a rotinas abaixo para as versões indicadas ou versões anteriores:

  • 2044 - Cadastrar CheckOut, versão XX.XX.XX
  • 2075 - Frente de Caixa, versão XX.XX.XX


Totvs custom tabs box items
defaultno
referenciapasso2

1. Acesse a rotina 2044  e clique o botão Pesquisar, selecione o caixa desejado e clique o botão Editar;

Observação: para este exemplo estamos editando o cadastro já existente.


2.  Acesse a aba Configuração Gatecash:

2.1 Informe/preencha conforme necessidade o campo IP Servidor;


Observações: 

- O campo IP Servidor é um campo alfanumérico, Não é obrigatório seu preenchimento;


- A aba Configuração Gatecash só permanece visível para exibição/edição caso parâmetro 4519 - Utiliza Integração Gatecash da rotina 132 esteja marcado como Sim na Filial selecionada.

- Caso parâmetro 4519 esteja marcado como Não ou seja informada uma Filial não configurada, ao Incluir e/ou  Editar um CheckOut a aba Configuração Gatecash não é exibida. Veja neste exemplo abaixo:



3. Realizado registro conforme necessidade clique o botão Gravar.


Totvs custom tabs box items
defaultyes
referenciapasso3

Observações / Validações:


  • No proc3. Realizado registro conforme necessidade clique o botão Gravar.esso de inicialização da rotina 2075, caso o parâmetro 4519 - UTILIZAGATECASH da rotina 132 estiver marcado como Sim e no cadastro do caixa contém o IP do servidor Gatecash informado, é implementada a chamada da seguinte função da dll GCPlug.dll:

        - GATECASH_InicializaEx2(const CaminhoBase: string; const Servidor: string; Pdv: Integer; const CaminhoLog: string);

        - No parâmetro CaminhoBase, é repassado valor “.”.;

        - No parâmetro Servidor, é repassado o IP configurado na rotina 2044;

        - No parâmetro Pdv, é repassado o número do caixa;

        - No parâmetro CaminhoLog, é repassado o diretório da pasta que será salvo os logs. São gravados registros de log em arquivos gcecho#.log, onde # indica o dia do mês. Esses arquivos de logs serão gerados              pela DLL e não pela rotina 2075, na qual só terá o trabalho em passar o diretório que a DLL irá gravar esses arquivos. Será usado o diretório “C:\winthor\prod\MOD-020\LOGGATECASH” mais as pastas do ano e            mês corrente. Exemplo: “C:\winthor\prod\MOD-020\LOGGATECASH\2021\janeiro”.

  •  A função GATECASH_InicializaEx2 terá os seguintes retornos:      

janeiro”.

  •  A função GATECASH_InicializaEx2 terá os seguintes retornos:      

           - 0: sucesso ao inicializar comunicação.

           - 999: falha ao executar comando.

           - Deve ser gerado no arquivo LogCX o registro do retorno da função.

           - Caso a dll não exista dentro do diretório “C:\winthor\prod\MOD-020", deverá registrar no arquivo LogCX a seguinte descrição "O arquivo GCPlug.dll é inexistente. Cód. Operador: XX", onde XX é o código do                  operador efetuou o login.


Print de tela na consulta ao LOGCX:

Processo de Inicialização.

Image Added


  • Ao ao fechar o sistema, caso o parâmetro 4519 - UTILIZAGATECASH da rotina 132 estiver marcado como Sim e no cadastro do caixa contém o IP do servidor Gatecash informado, é implementada a chamada da seguinte função da dll GCPlug.dll:

           - 0: sucesso ao inicializar comunicação.GATECASH_Finaliza(). (Obs: Essa informação não é exibida, ela só exibida no Log quando fecho a rotina 2075 deve apresentar a função GATECASH_Finaliza);

           - 999: falha ao executar comando.- A função GATECASH_Finaliza terá os seguintes retornos:

           - Deve ser gerado no arquivo LogCX o registro do retorno da função  0: sucesso ao enviar evento.

           - Caso a dll não exista dentro do diretório “C:\winthor\prod\MOD-020", deverá registrar no arquivo LogCX a seguinte descrição "O arquivo GCPlug.dll é inexistente. Cód. Operador: XX", onde XX é o código do  1: comunicação não inicializada.

                operador efetuou o login.

Print de tela na consulta ao LOGCX:

Processo de Inicialização.

Image Removed

Ao 

-999: falha ao executar comando.

           - É gerado no arquivo LogCX o registro do retorno da função. 


Processo de Fechamento:

Image Added


Ao efetuar o login de acesso ao Caixa, na opção F6 da tela de Login do caixa e na tela de Bloqueio do caixa do atalho F4

ao fechar o sistema

, caso o parâmetro 4519 - UTILIZAGATECASH

da rotina 132

estiver marcado como Sim e

no cadastro do caixa contém o IP do servidor Gatecash informado

tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementada

a

chamada da

seguinte

função da dll

 GCPlug.dll

:         - 

GATECASH_Finaliza(). (Obs: Essa informação não é exibida, ela só exibida no Log quando fecho a rotina 2075 deve apresentar a função GATECASH_Finaliza);         - A função GATECASH_Finaliza AbrePdvEx_InformPDV(const Funcionario: string; const Codigo: string; Pdv: Integer).
No parâmetro Funcionario, é informado o nome do operador de caixa.
No parâmetro Codigo, é informado o código do operador de caixa.
No parâmetro Pdv, é informado o número do caixa.
A função GATECASH_AbrePdvEx_InformPDV terá os seguintes retornos:
            0: sucesso ao enviar evento.

           -1- 1: comunicação não inicializada.
           -999- 999: falha ao executar comando.
           - É gerado no arquivo LogCX É gerado no arquivo LogCX o registro do retorno da função.


Image Added


LogGatecash:

Image Added


Fechamento PDV:

Na Função de Bloquear a tela do Caixa (atalho F4), ou, Fechar a rotina (botão X ou funções 1000, 1001, 1002 e 1003) é gerado no arquivo LogCX  e LOGGATECASH o registro do retorno da função. 


Image Added


Image Added


Informa OperadorProcesso de Fechamento:

Image Removed

Ao abrir o PDV após efetuar o login de acesso ao Caixa, na opção F6 da tela de Login do caixa Login na tela inicial e na tela de Bloqueio do caixa do atalho F4PDV, também ao abrir um Cupom/Venda, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementada realizada a chamada da seguinte função da dll:

  • GATECASH_
AbrePdvEx
  • InformaOperador_InformPDV(const Funcionario: string; const Codigo: string; Pdv: Integer)
.
  • : Integer;
  • No parâmetro Funcionario,
é informado
  • deve-se passar o nome do operador
de
  • do caixa.
  • No parâmetro Codigo,
é informado
  • deve-se passar o código do operador
de
  • do caixa.
  • No parâmetro Pdv,
é informado
  • deve-se passar o número do caixa
.
  • A função GATECASH_
AbrePdvEx
  • InformaOperador_InformPDV terá os seguintes retornos:
  • 0: sucesso ao enviar evento.
  • -
 1
  • 1: comunicação não inicializada.
  • -
 999
  • 999: falha ao executar comando.
  • É
gerado no arquivo LogCX o registro do retorno da função.

Image Removed

LogGatecash:

Image Removed

Fechamento PDV:

Na Função de Bloquear a tela do Caixa (atalho F4), ou, Fechar a rotina (botão X ou funções 1000, 1001, 1002 e 1003) é gerado no arquivo LogCX  e LOGGATECASH
  • gerado no arquivo LogCX o registro do retorno da função.

Image Removed

Image Removed

Informa Operador:

  • Para esta função, inserida a essa função também em um timeout para ser chamada a cada uma hora.

LOGCX

Image Added


Image Added


LogGatecash:


Image Added


O Emulador de Serviço Gatecahs irá trazer a mensagem de Informa Operador conforme imagem abaixo:

Image Added



Abertura de Cupom

Ao realizar abertura do cupom fiscalAo abrir o PDV após efetuar o Login na tela inicial e na tela de Bloqueio do PDV, também ao abrir um Cupom/Venda, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é realizada a chamada da seguinte função da dllDll:

  • GATECASH_InformaOperadorAbreCupom_InformPDV(const Funcionario: string; const Codigo: string Integer; Pdv: Integer): Integer;
  • No parâmetro Funcionario, deve-se passar o nome do operador do caixa.No parâmetro Codigo, deve-se passar o código do operador do caixa. Codigo, é informado o número do cupom fiscal;
  • No parâmetro Pdv, deve-se passar é informado o número do caixa;
  • A função GATECASH_InformaOperadorAbreCupom_InformPDV terá os seguintes retornos:
  • 0: sucesso ao enviar evento.;
  • -1: comunicação não inicializada.iniciada;
  • -999: falha ao executar comando.;
  • É gerado no arquivo LogCX o registro do retorno da função.
  • Para esta função, inserida a essa função também em um timeout para ser chamada a cada uma hora.

LOGCX

Image Removed

Image Removed

LogGatecash:

Image Removed

O Emulador de Serviço Gatecahs irá trazer a mensagem de Informa Operador conforme imagem abaixo:

Image Removed

Abertura de Cupom


Nas imagens abaixo conferimos a informação do Cupom Fiscal no arquivo LOGCX validado no a geração do mesmo no Cupom Fiscal e Relatório Gerencial. 


Consulta LOGCX:

Image Added


LogGatecash:

Image Added



Cupom Fiscal e Relatório Gerencial:

Image Added


Image Added



Fechamento de Documento:

Ao Finalizar a emissão de algum documento ou Fechar a Venda Cupom Fiscal, estando oparâmetro 4519 - UTILIZAGATECASH marcado Ao realizar abertura do cupom fiscal, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075,  é realizada implementado a chamada da seguinte função da Dlldll:

  • GATECASH_AbreCupomFechaDocumentoCod_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
  • No parâmetro Codigo, é informado repassado o número do documento ou cupom fiscal;No parâmetro Pdv, é informado o número do caixa;
  • A função GATECASH_ AbreCupomFechaDocumentoCod_InformPDV terá os  tem os seguintes retornos:
    • 0: sucesso ao enviar evento;
    • -1: comunicação não iniciada;
    • -999: falha ao executar comando
    ;
    • .
  • É gerado no arquivo LogCX o registro do retorno da função.

Nas imagens abaixo conferimos a informação do Cupom Fiscal no arquivo LOGCX validado no a geração do mesmo no Cupom Fiscal e Relatório Gerencial. 


Consulta LOGCX:

Image RemovedImage Added


LogGatecash:


Image RemovedImage Added


Consulta a Cupom Fiscal e Relatório Gerencial :

Image Removed

Image Removed

Fechamento de Documento:

Ao Finalizar a emissão de algum documento ou Fechar a Venda Cupom Fiscal, estando oparâmetro

com o número do documento ou cupom fiscal;


Image Added


Image Added



Cancelamento de Cupom:

Ao Cancelar o Cupom com a venda aberta ,estando o parâmetro 4519 - UTILIZAGATECASH marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075,

  é

deve ser implementado a chamada da seguinte função da dll:

  • GATECASH_
FechaDocumentoCod
  • CancelaCupomEx_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
  • No parâmetro Codigo, é repassado o número do
documento ou cupom fiscal
  • cupom;
  • No parâmetro Pdv,  é repassado o número do caixa;
  • A função GATECASH_
FechaDocumentoCod
  • CancelaCupomEx_InformPDV
 tem os
  •  terá os seguintes retornos:
  • 0: sucesso ao enviar evento;
  • -1: comunicação não iniciada;
  • -999:
 falha
  •  falha ao executar comando.
É
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.


Consulta LOGCX:

Image RemovedImage Added


LogGatecash:

Image RemovedImage Added


Consulta a Cupom Fiscal e Relatório Gerencial com o número do documento ou cupom fiscal;

Image Removed

Cupom cancelado.

Image AddedImage Removed

Totvs custom tabs box items
defaultyes
referenciapasso4

Registro de Suprimento


1. Acesse a rotina 2075 informe os dados do operador, pressione tecla Enter e efetue uma carga total de tabelas, pressionando a tecla F2;

2. Na tela de venda, pressione a tecla F12 para a exibição do menu suspenso, clique Relatórios e, em seguida, clique Sangria ou Suprimento;



3. Selecione o Banco, o tipo de Cobrança, o Valor e pressione a tecla Enter;

4. Na tela Sangria e/ou Suprimento clique o botão (F5) Confirmar.


 Na rotina 2075, quando da Emissão do Suprimento, estando parâmetro 4519 - UTILIZAGATECASH marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementada chamada da seguinte função da dll:

  • GATECASH_Suprimento_InformPDV(const FormaPagamento: string; const Complemento: string; Valor: Double; Pdv: Integer) : Integer
  • No parâmetro FormaPagamento, informa a Descrição da Cobrança do Suprimento gerado.
  • No parâmetro Complemento, informa o Banco do Suprimento gerado.
  • No parâmetro Valor, informa o Valor do Suprimento gerado.
  • No parâmetro Pdv, informa o Número do caixa.
  • A função GATECASH_Suprimento_InformPDV terá os seguintes retornos:
  • 0: sucesso ao enviar evento.
  • -1: comunicação não inicializada.
  • -999: falha ao executar comando.
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.





Registro de Sangria:

Na rotina 2075, quando da Emissão de Sangria, estando parâmetro 4519 - UTILIZAGATECASH marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementa a chamada da seguinte função da dll:

  • GATECASH_Sangria_InformPDV(const Complemento: string; Valor: Double; Pdv: Integer): Integer
  • No parâmetro Complemento, é repassada a descrição da cobrança da sangria gerada.
  • No parâmetro Valor, é repassado o valor da sangria gerada.
  • No parâmetro Pdv, informa o número do caixa.
  • A função GATECASH_Sangria_InformPDV terá os seguintes retornos:
  • 0: sucesso ao enviar evento.
  • -1: comunicação não inicializada.
  • -999: falha ao executar comando.
  • É gerado no arquivo LogCX o registro do retorno da função.



...