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.

...

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:      

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


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

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


Processo de Fechamento:


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, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementada chamada da função da dll:

GATECASH_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: comunicação não inicializada.
- 999: falha ao executar comando.
É gerado no arquivo LogCX o registro do retorno da função.



LogGatecash:


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.




Informa Operador:

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

  • GATECASH_InformaOperador_InformPDV(const Funcionario: string; const Codigo: string; 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.
  • No parâmetro Pdv, deve-se passar o número do caixa
  • A função GATECASH_InformaOperador_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.
  • Para esta função, inserida a essa função também em um timeout para ser chamada a cada uma hora.

LOGCX



LogGatecash:



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



Abertura de Cupom

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 a chamada da seguinte função da Dll:

  • GATECASH_AbreCupom_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
  • No parâmetro Codigo, é informado o número do cupom fiscal;
  • No parâmetro Pdv, é informado o número do caixa;
  • A função GATECASH_AbreCupom_InformPDV terá 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:


LogGatecash:



Cupom Fiscal e Relatório Gerencial:




Fechamento de Documento:

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

  • GATECASH_FechaDocumentoCod_InformPDV(Codigo: Integer): Integer;
  • No parâmetro Codigo, é repassado o número do documento ou cupom fiscal;
  • A função GATECASH_ FechaDocumentoCod_InformPDV 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.


Consulta LOGCX:


LogGatecash:



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





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_CancelaCupomEx_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
  • No parâmetro Codigo, é repassado o número do cupom;
  • No parâmetro Pdv,  é repassado 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.


Consulta LOGCX:


LogGatecash:



Anulação de Cupom

Ao efetuar o Cancelamento de um cupom fiscal, após ser fechado, caso o parâmetro 4519 - UTILIZAGATECASH esteja marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementada a chamada da seguinte função da dll:

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


Consulta LOGCX:




LOGGATECASH:




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.




...