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.


01. DADOS GERAIS

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


02. SITUAÇÃO/REQUISITO

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


Expandir
titleSolicitação: DDLEGFIN-1232

Essa implementação e as demais referente a este processo de integração, deverá ocorrer nos caixas:

  • ECF, NFCE, SAT, MFE e faturamento de nova via PDV.


1) Deve ser criado o seguinte parâmetro na rotina 132:

  • Nome: UTILIZAGATECASH
  • Descrição: Utiliza a integração Gatecash
  • Texto de Ajuda: O parâmetro visa a realizar a integração do PDV com o sistema Gatecash.
  • Será por filial, dentro do assunto Autosserviço.
  • Ter as opções SIM e NÃO (sendo a opção NÃO o valor padrão)


2) Na rotina 2044, deverá ser realizado os ajustes:

  • Deve ser criado uma aba com a descrição “Configurações Gatecash”.
  • Esta nova aba só deve ser disponibilizada para o usuário quando o parâmetro UTILIZAGATECASH, na filial selecionada, estiver marcado como SIM.
  • Dentro da nova aba, deve ser criado o campo “IP Servidor”, sendo um campo alfanumérico, sem obrigatoriedade de preenchimento e com a seguinte dica: “Endereço IP do servidor Gatecash”.


3) Na rotina 2075, no processo de inicialização, caso o parâmetro UTILIZAGATECASH estiver marcado como SIM e no cadastro do caixa contém o IP do servidor Gatecash informado, deve ser implementação 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, deve ser passado valor “.”.
  • No parâmetro Servidor, deve ser passado o IP configurado na rotina 2044.
  • No parâmetro Pdv, deve ser passado o número do caixa.
  • No parâmetro CaminhoLog, deverá passar o diretório da pasta que será salvo os logs. Serã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.
Expandir
titleSolicitação: DDLEGFIN-1272

1) Na rotina 2075, ao fechar o sistema, caso o parâmetro UTILIZAGATECASH estiver marcado como SIM e no cadastro do caixa contém o IP do servidor Gatecash informado, deve ser implementação 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.
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.
Expandir
titleSolicitação: DDLEGFIN-1233

Abertura de PDV com Código de Operador

1) Na rotina 2075, 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 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_AbrePdvEx_InformPDV(const Funcionario: string; const Codigo: string; Pdv: Integer).
  • No parâmetro Funcionario, deve ser informado o nome do operador de caixa.
  • No parâmetro Codigo, deve ser informado o código do operador de caixa.
  • No parâmetro Pdv, deve ser 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.
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.
Expandir
titleSolicitação: DDLEGFIN-1273

Na rotina 2075, ao bloquear a tela do caixa (atalho F4) ou fechar a rotina (botão X ou funções 1000, 1001, 1002 e 1003), caso o parâmetro UTILIZAGATECASH estiver marcado como SIM, no cadastro do caixa contém o IP do servidor Gatecash informado e existir o arquivo GCPlug.dll no diretório da rotina 2075, deve ser implementado a chamada da função da GCPlug.dll:

  • GATECASH_FechaPdv_InformPDV(Pdv: Integer)
  • No parâmetro Pdv, deve ser passado o número do caixa.
  • A função GATECASH_FechaPdv_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.
Expandir
titleSolicitação: DDLEGFIN-1235

Registro de Suprimento e Sangria.

1) Na 2075, na emissão do suprimento, 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_Suprimento_InformPDV(const FormaPagamento: string; const Complemento: string; Valor: Double; Pdv: Integer) : Integer
  • No parâmetro FormaPagamento, deve-se passar a descrição da cobrança do suprimento gerado.
  • No parâmetro Complemento, deve-se passar o banco do suprimento gerado.
  • No parâmetro Valor, deve-se passar o valor do suprimento gerado.
  • No parâmetro Pdv, deve-se passar 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.


2) Na 2075, na emissão de Sangria, 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_Sangria_InformPDV(const Complemento: string; Valor: Double; Pdv: Integer): Integer
  • No parâmetro Complemento, deve-se passar a descrição da cobrança da sangria gerada.
  • No parâmetro Valor, deve-se passar o valor da sangria gerada.
  • No parâmetro Pdv, deve-se passar 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.
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.


Expandir
titleSolicitação: DDLEGFIN-1234

Informa Operador

1) Na rotina 2075, 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 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_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.
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.
  • Para esta função, deve-se inserir essa função também em um timeout para ser chamada a cada uma hora.
Expandir
titleSolicitação: DDLEGFIN-1238

Abertura de Cupom 

1) Na rotina 2075, ao realizar abertura do 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_AbreCupom_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
  • No parâmetro Codigo, deve ser passado o número do cupom fiscal;
  • No parâmetro Pdv, deve ser passado 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;
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.


03. SOLUÇÃO


Totvs custom tabs box
tabsParametrização, Saiba como funciona, Registro de Suprimento e Registro de Sangria, Passo 04
idspasso1,passo2,passo3,
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
Expandir
titleRotina 2044 - Cadastrar CheckOut

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.

Expandir
titleRotina 2075 - Frente de Caixa

Observações / Validações:


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




Totvs custom tabs box items
defaultyes
referenciapasso3

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.




04. DEMAIS INFORMAÇÕES


Aviso

Importante!

As versões estarão disponíveis para download no CCW. 

https://centraldecontrole.pcinformatica.com.br/


Mantenha suas rotinas sempre atualizadas!



05. ASSUNTOS RELACIONADOS



Templatedocumentos


HTML
<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>