Histórico da Página

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

Image Added

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.

Image Added

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

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;

Image Added

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

Image Added

Observações / Validações:

• No proc3. Realizado registro conforme necessidade clique o botão Gravar.esso de inicialização da rotina 2075

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.

Image Removed

• Ao ao fechar o sistema, caso o parâmetro 4519 - UTILIZAGATECASH da rotina 132 estiver  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 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)InicializaEx2(const CaminhoBase: string; const Servidor: string; Pdv: Integer; const CaminhoLog: string);

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

         - A função GATECASH_Finaliza terá os seguintes retornos:

            0: sucesso ao enviar evento.

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

           -1: comunicação não inicializada.- No parâmetro Pdv, é repassado o número do caixa;

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

Processo de Fechamento:

Image Removed

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.

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

Image Removed

LogGatecash:

Image Removed

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

• GATECASH_FechaDocumentoCodInformaOperador_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 Codigo, é repassado o número do documento ou cupom fiscal;
• A função   GATECASH_ FechaDocumentoCodInformaOperador_InformPDV  tem os terá os seguintes retornos:
• 0: sucesso ao enviar evento;.
• -1: comunicação não iniciada;inicializada.
• -999:   falha ao executar comando.
• É gerado no arquivo LogCX o registro do retorno da função.

Consulta LOGCX:

• 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 AddedImage Removed

LogGatecash:

Image Removed

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

Image Removed

Image Added

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

Image AddedImage Removed

Anulação de Cupom 

Ao efetuar o Cancelamento de um cupom fiscal, após ser fechado

Informações de Supervisor/Fiscal

Ao solicitar a senha do Supervisor/Fiscal de Caixa, caso o parâmetro 4519 - UTILIZAGATECASH esteja marcado como Sim e tenha a  GCPlug.dll  no arquivo de diretório da rotina 2075, é implementado implementada a chamada da seguinte função da dll:

• GATECASH_InformaSupervisorAnulaCupom_InformPDV(const Supervisor: PAnsiChar; const Codigo: PAnsiChar; Pdv: Pdv: Integer; Codigo: Integer):   Integer;
• No parâmetro  Supervisor Pdv, é informado repassado o Nome número do Supervisor/Fiscal de caixa.;
• No parâmetro   Codigo, é informado repassado o código do sSupervisor/Fiscal de caixa (conforme a tabela: PCEMPR, campo: MATRICULA).
• No parâmetro Pdv, é informado o número do caixa.
• número do cupom;
• A função GATECASH_AnulaCupom_InformPDV A função GATECASH_InformaSupervisor_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.

Observação: para este exemplo solicitou Funções Especiais. Funcao: 1025.

Consulta LOGCX:

Image RemovedImage Added

Consulta LOGGATECASH:

Image Added

Cupom cancelado

Image RemovedImage Added

Informações de Supervisor/Fiscal

Ao solicitar a senha do Supervisor/Fiscal de Caixa, caso o parâmetro 4519 - UTILIZAGATECASH esteja 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_InformaSupervisor_InformPDV(const Supervisor: PAnsiChar; const Codigo: PAnsiChar; Pdv: Integer): Integer;
• No parâmetro Supervisor, é informado o Nome do Supervisor/Fiscal de caixa.
• No parâmetro Codigo, é informado o código do sSupervisor/Fiscal de caixa (conforme a tabela: PCEMPR, campo: MATRICULA).
• No parâmetro Pdv, é informado o número do caixa.
• A função GATECASH_InformaSupervisor_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.

Observação: para este exemplo solicitou Funções Especiais. Funcao: 1025.

Consulta LOGCX:

Image Added

Consulta LOGGATECASH:

Image Added

Diferença de Cupom - Acréscimos ou Descontos

Para este processo o parâmetro 1186 - Permite desconto no rodapé no checkout, da rotina 132 deverá estar marcado como Sim.

Realizar venda na rotina 2075 e no momento do fechamento da venda aplicar Desconto (atalho “D”).

Realizar venda na rotina 2075 e no momento do fechamento da venda aplicar Acréscimo (atalho “A”).

No parâmetro Diferença está sendo passado o Acréscimo (positivo) e Desconto (negativo) no valor total do cupom. GATECASH_DiferencaCupom_InformPDV(Diferenca: Double; Pdv: Integer): Integer.

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

Validado parâmetro 4519 - UTILIZAGATECASH marcado como Sim na rotina 132, com o IP do servidor Gatecash informado no cadastro do caixa (rotina 2044) e com o arquivo GCPlug.dll dentro do diretório da rotina 2075. (Ver tela anexa). A função tem os seguintes retornos:

• 0: sucesso ao enviar evento;
• -1: comunicação não inicializada;
• -999: falha ao executar o comando.

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

Consulta LOGCX:

Acréscimo

Image Added

Desconto

Image Added

Consulta LOGGATECASH:

Acréscimo

Image Added

Desconto

Image Added

Venda Item:

Observação: para este exemplo realizada Venda de Item com Tipo Embalagem = Peso (cadastrado na rotina 2014), permitindo informar quantidade com valor decimal na rotina 2075. 

Na rotina 2075, foi implementada a seguinte função de integração com a Gatecash: GATECASH_VendeItemEx_InformPDV(Sequencia: Integer; const Codigo: PAnsiChar; const Descricao: PAnsiChar; Quantidade: Double; ValorUnitario: Double; Unitario: Boolean; Escaneado: Boolean; Pdv: Integer): Integer.

• No parâmetro Sequencia, é informado o número/índice da sequência do produto;
• No parâmetro Codigo, é informado o código de barras do produto;
• No parâmetro Descricao, é informada a descrição do produto;
• No parâmetro Quantidade, é informada a quantidade do produto;
• No parâmetro ValorUnitario, é informado o valor unitário do produto;
• No parâmetro Unitario, é informado Verdadeiro (Zero) se o produto é unitário ou Falso (Um) se o produto é pesado;
• No parâmetro Escaneado, é Verdadeiro (Zero) se o produto foi escaneado ou Falso (Um) se o produto foi digitado pelo usuário;
• No parâmetro Pdv, é informado o número do caixa;
• Deve validar se o parâmetro 4519 - UTILIZAGATECASH se está marcado como Sim, com o IP do servidor Gatecash informado no cadastro do caixa (rotina 2044) e com o arquivo dll dentro do diretório da rotina 2075. Caso a validação esteja correto, a função deve ser acionada dentro dos seguintes eventos abaixo:
  • Quando o produto for escaneado pelo leitor de código de barras;
  • Quando o produto for digitado pelo usuário através da rotina.
• A função terá os seguintes retornos:
  • 0: sucesso ao enviar evento;
  • -1: comunicação não inicializada;
  • -999: falha ao executar o comando.
• Deve ser gerado no arquivo LogCX o registro do retorno da função.

Consulta LOGCX:

Image Added

Consulta LOGGATECASH:

Image Added

Neste exemplo 2, com dois produtos, um que aceita venda com valor de quantidade decimal e outro não.

Image Added

No Emulador do GATECASH o produto com quantidade em valor decimal este virá preenchido no campo Mensagens com Multiplicação.

Image Added

Consulta Valor do Produto

Implementado na rotina 2075 a  função de integração com a Gatecash: GATECASH_ConsultaProduto_InformPDV.

• No parâmetro Codigo, é repassado o código do produto consultado;
• No parâmetro Descricao, é repassado a descrição do produto consultado;
• No parâmetro ValorUnitario, é repassado o valor unitário do produto consultado;
• No parâmetro Pdv, é repassado o número do caixa,  validando se o parâmetro 4519 - UTILIZAGATECASH

Venda Item:

Observação: para este exemplo realizada Venda de Item com Tipo Embalagem = Peso (cadastrado na rotina 2014), permitindo informar quantidade com valor decimal na rotina 2075. 

Na rotina 2075, foi implementada a seguinte função de integração com a Gatecash: GATECASH_VendeItemEx_InformPDV(Sequencia: Integer; const Codigo: PAnsiChar; const Descricao: PAnsiChar; Quantidade: Double; ValorUnitario: Double; Unitario: Boolean; Escaneado: Boolean; Pdv: Integer): Integer.

• No parâmetro Sequencia, é informado o número/índice da sequência do produto;
• No parâmetro Codigo, é informado o código de barras do produto;
• No parâmetro Descricao, é informada a descrição do produto;
• No parâmetro Quantidade, é informada a quantidade do produto;
• No parâmetro ValorUnitario, é informado o valor unitário do produto;
• No parâmetro Unitario, é informado Verdadeiro (Zero) se o produto é unitário ou Falso (Um) se o produto é pesado;
• No parâmetro Escaneado, é Verdadeiro (Zero) se o produto foi escaneado ou Falso (Um) se o produto foi digitado pelo usuário;
• No parâmetro Pdv, é informado o número do caixa;
• Deve validar se o parâmetro 4519 - UTILIZAGATECASH se  está marcado como Sim, com o IP do servidor Gatecash informado no cadastro do caixa (na rotina 2044) e com o arquivo GCPlug.dll dentro do diretório da rotina 2075. Caso a validação esteja correto, a função deve ser é acionada dentro dos seguintes eventos abaixo:eventos abaixo:
• Quando for realizado a consulta na tela Consulta de Produtos (“R”) ou na tela Consulta Preço (“Ctrl+R”);
• Quando o produto for escaneado pelo leitor de código de barras;
Quando o produto for digitado pelo usuário através da rotina.
• A função terá os seguintes retornos:
  • 0: sucesso ao enviar evento;
  • -1: comunicação não inicializada;
  • -999: falha ao executar o comando.
• Deve ser É gerado no arquivo LogCX o registro do retorno da função.

Consulta LOGCX:

Consultar Produto (R)

Image Added

Consultar Preço (Ctrl+R)

Image AddedImage Removed

Consulta LOGGATECASH:

Image Removed

Neste exemplo 2, com dois produtos, um que aceita venda com valor de quantidade decimal e outro não.

Image Removed

Consultar Produto (R)

Image Added

Consultar Preço (Ctrl+R)

Image AddedNo Emulador do GATECASH o produto com quantidade em valor decimal este virá Image Removed