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


02. SITUAÇÃO/REQUISITO

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

...

Expandir
titleSolicitação: DDLEGFIN-1236

Registro de Operação Genérica


1) Na rotina 2075, ao executar operações genéricas, isto é, não-fiscais forem executadas no PDV, tais como Redução Z, Leitura X, entre outras (processos detalhados no item 2); 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_Operacao_InformPDV(const Operacao: string; const Complemento: string; Valor: Double; Pdv: Integer): Integer;
  • No parâmetro Operacao, deve ser passado o nome da operação realizada.
  • No parâmetro Complemento, deve ser passado a descrição complementar da operação utilizada. Se não utilizado, informar string vazia;
  • No parâmetro Valor, deve ser passado o valor associado à operação. Se não aplicável, utilizar zero;
  • No parâmetro Pdv, deve ser passo o número do caixa;
  • A função GATECASH_Operacao_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.


2) Processos da rotina 2075 que receberão a função do item 1:

  • Os relatórios contidos dentro do Menu Fiscal (Tela principal > Atalho Ctrl+M);
  • Redução Z:
    • Tela de login > F5 – Manutenção Check Out > F3 – Emissão da Redução Z;
    • Tela principal > Atalho Z;
    • Tela principal > Atalho Alt+F > Função 1010;
    • Tela principal > Atalho Ctrl+M > (13) Envio ao FISCO-REDUÇÃO-Z.
  • Leitura X:
    • Tela de login > F5 – Manutenção Check Out > F1 – Relatórios do ECF > Leitura X;
    • Tela principal > Atalho X;
    • Tela principal > Atalho Ctrl+M > (1) LX.
  • Memória Fiscal:
    • Tela de login > F5 – Manutenção Check Out > Memória Fiscal;
    • Tela principal > Atalho Ctrl+M > (2) LMF.
  • Formas de Pagamento (Tela de login > F5 – Manutenção Check Out > F1 – Relatórios do ECF > Formas de Pagamento).

03. SOLUÇÃO

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


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 Removed

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 Removed

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
    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
    Totvs custom tabs box items
    defaultnoyes
    referenciapasso2passo1

    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 Removed

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

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

    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


    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;

    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


    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.

    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:

             - 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

    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    1: comunicação não inicializada.

               -999: falha ao executar comando.

                  operador efetuou o login.

    Print de tela na consulta ao LOGCX:

    Processo de Inicialização.

    Image Removed

    Ao 

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

    Processo de Fechamento:

    Image Removed


    Image Added


    Image Added


    Informa Operador:

    Ao abrir o PDV após efetuar o Login na tela inicial 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 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
    • 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 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 fiscal

    Image Removed

    Image Removed

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

    Ao realizar abertura do cupom fiscal, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado


    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 como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075,  é

    realizada

    implementado a chamada da seguinte função da

    Dll

    dll:

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

    com o número do documento ou cupom fiscal;


    Image Added


    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.



    ...