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:




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




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

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


Expandir
titleFechamento 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;



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

Expandir
titleAnulaçã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:


Cupom cancelado

Expandir
titleInformações do Cliente com Código

Informações do Cliente com Código


Executado enquanto o cupom está aberto  e informado o cliente que realiza a compra, utilizada tecla de atalho Ctrl = C. 

• Cliente: string com nome do cliente ou com número que o identifica (RG, CPF, etc).

• Código: código do cliente. Pode ser um identificador genérico (RG ou CPF, caso já possua um nome sendo passado no campo Cliente) ou um identificador específico do negócio (número de matrícula, por exemplo).

Se não disponível, informar string vazia (“”).

Retorno:

0: sucesso ao enviar evento.

-1: comunicação não inicializada.

-999: falha ao executar comando.


Consulta LOGCX:


LOGGATECASH:


Cupom Com Informações do Cliente:

Expandir
titleInformações de Supervisor/Fiscal

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:


Consulta LOGGATECASH:

Expandir
titleDiferença de Cupom - Acréscimos ou Descontos

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


Desconto



Consulta LOGGATECASH:

Acréscimo


Desconto


Expandir
titleConsultar Valor do Produto

Consulta Valor do Produto


Na rotina 2075, foi implementado a  função de integração com a Gatecash: GATECASH_ConsultaProduto_InformPDV(const Codigo: PAnsiChar; const Descricao: PAnsiChar; ValorUnitario: Double; Pdv: Integer) : Integer.

  • 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”, deve ser passado o número do caixa,  validando se o parâmetro 4519 - UTILIZAGATECASH 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 é acionada dentro dos seguintes eventos abaixo:
  • Quando for realizado a consulta na tela Consulta de Produtos (“R”) ou na tela Consulta Preço (“Ctrl+R”);
  • A função terá 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:

Consultar Produto.

Image Added


Consultar Preço.



Consulta LOGGATECASH:

Consultar Produto.

Image Added


Consultar Preço.



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.




...