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:Possibilitar comunicação com GATECASH
País:Brasil
Ticket:DDLEGFIN-1232
Requisito/Story/Issue:
Expandir
titleDemais solicitações envolvidas neste processo

DDLEGFIN-1232

DDLEGFIN-1272

DDLEGFIN-1233

DDLEGFIN-1273

DDLEGFIN-1234

DDLEGFIN-1235

DDLEGFIN-1236

DDLEGFIN-1238

DDLEGFIN-1274

DDLEGFIN-1275

DDLEGFIN-1276

DDLEGFIN-1277

DDLEGFIN-1240

DDLEGFIN-1243

DDLEGFIN-1245

DDLEGFIN-1246

DDLEGFIN-1281

DDLEGFIN-1249

DDLEGFIN-1284

DDLEGFIN-1239


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

Finalizar Comunicação com sistema GATECASH.


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

Fechamento de PDV


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

03. SOLUÇÃ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.

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

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.

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.
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
Totvs custom tabs box
tabsParametrização, Saiba como funciona, Passo 03, Passo 04
idspasso1,passo2
Totvs custom tabs box items
defaultyes
referenciapasso1
Totvs custom tabs box items
defaultno
referenciapasso2
Expandir
titleRotina 2044 - Cadastrar CheckOut
Expandir
titleRotina 2075 - Frente de Caixa
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.
Expandir
titleSolicitação: DDLEGFIN-1275

Cancelamento de Cupom

Na 2075, ao cancelar o cupom com a venda aberta antes do seu fechamento (ex.: cliente passou a compra e desistiu), 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_CancelaCupomEx_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
  • No parâmetro Codigo, deve ser passado o número do cupom;
  • No parâmetro Pdv, deve ser passado 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.
Expandir
titleSolicitação: DDLEGFIN-1242

Anulação de Cupom 

1) Na 2075, ao efetuar o cancelamento de um cupom fiscal, após ser fechado; 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_AnulaCupom_InformPDV(Pdv: Integer; Codigo: Integer): Integer;
  • No parâmetro Pdv, deve ser passado o número do caixa;
  • No parâmetro Codigo, deve ser passado 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.
Expandir
titleSolicitação: DDLEGFIN-1276

Informações do Cliente com Código

Protótipo da Função: int GATECASH_InformaClienteEx(const char *Cliente, const char *Codigo);

Descrição: associa informação de cliente ao cupom. Deve ser executado enquanto o cupom está aberto e informa o cliente que realiza a compra. Geralmente executado logo após a abertura do cupom ou pouco tempo antes do seu fechamento.

Parâmetros:

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

Expandir
titleSolicitação: DDLEGFIN-1277

Informações de Supervisor/Fiscal

1) Na rotina 2075, ao solicitar a senha do supervisor/fiscal de caixa, 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_InformaSupervisor_InformPDV(const Supervisor: PAnsiChar; const Codigo: PAnsiChar; Pdv: Integer): Integer;
  • No parâmetro Supervisor, deve ser informado o nome do supervisor/fiscal de caixa.
  • No parâmetro Codigo, deve ser informado o código do supervisor/fiscal de caixa (tabela: PCEMPR, campo: MATRICULA).
  • No parâmetro Pdv, deve ser 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;
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.
Expandir
titleSolicitação: DDLEGFIN-1240

Diferença de Cupom - Descontos ou Acréscimos

1) Na 2075, deve ser implementado a seguinte função de integração com a Gatecash: GATECASH_DiferencaCupom_InformPDV(Diferenca: Double; Pdv: Integer): Integer.

  • No parâmetro Diferenca, deve ser passado o acréscimo (positivo) ou desconto (negativo) no valor total do cupom;
  • No parâmetro Pdv, deve ser passado o número do caixa;
  • Deve validar se o parâmetro UTILIZAGATECASH estiver marcado como “SIM”, 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. Caso a validação esteja correto, a função deve ser acionada dentro dos seguintes eventos abaixo:
    • No momento que abrir a tela de fechamento de venda e houver valores de desconto ou acréscimo aplicados.
    • Quando for aplicado desconto (atalho “D”) ou acréscimo (atalho “A”) na tela de fechamento de venda.
  • 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.
Expandir
titleSolicitação: DDLEGFIN-1243

Venda do item

1) Na rotina 2075, deve ser implementado 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”, deve ser informado o número/índice da sequência do produto;
  • No parâmetro “Codigo”, deve ser informado o código de barras do produto;
  • No parâmetro “Descricao”, deve ser informado a descrição do produto;
  • No parâmetro “Quantidade”, deve ser informado a quantidade do produto;
  • No parâmetro “ValorUnitario”, deve ser informado o valor unitário do produto;
  • No parâmetro “Unitario”, deve ser informado Verdadeiro se o produto é unitário ou Falso se o produto é pesado;
  • No parâmetro “Escaneado”, deve ser Verdadeiro se o produto foi escaneado ou Falso se o produto foi digitado pelo usuário;
  • No parâmetro “Pdv”, deve ser informado o número do caixa;
  • Deve validar se o parâmetro UTILIZAGATECASH estiver 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.
Expandir
titleSolicitação: DDLEGFIN-1245

Consulta Valor do Produto

1) Na 2075, deve ser implementado a seguinte 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”, deve ser passado o código do produto consultado;
  • No parâmetro “Descricao”, deve ser passado a descrição do produto consultado;
  • No parâmetro “ValorUnitario”, deve ser passado o valor unitário do produto consultado;
  • No parâmetro “Pdv”, deve ser passado o número do caixa;
  • Deve validar se o parâmetro UTILIZAGATECASH estiver marcado como “SIM”, 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. Caso a validação esteja correto, a função deve ser 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.
  • Deve ser gerado no arquivo LogCX o registro do retorno da função.
Expandir
titleSolicitação: DDLEGFIN-1246

Cancelamento de Item

1) Na 2075, deve ser implementação a seguinte função de integração com a Gatecash: GATECASH_CancelaItem_InformPDV(Sequencia: Integer; Pdv: Integer): Integer.

  • No parâmetro “Sequencia”, deve ser passado o número da sequência do produto cancelado;
  • No parâmetro “Pdv”, deve ser passado o número do caixa;
  • Deve validar se o parâmetro UTILIZAGATECASH estiver marcado como “SIM”, 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. Caso a validação esteja correto, a função deve ser acionada dentro dos seguintes eventos abaixo:
    • Quando o produto for cancelado na venda (“F2”).
  • 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.
Expandir
titleSolicitação: DDLEGFIN-1281

Multiplicação de Item

1) Na rotina 2075, deve ser implementado a seguinte função de integração com a Gatecash: GATECASH_Multiplica(): Integer.

  • Deve validar se o parâmetro UTILIZAGATECASH estiver marcado como “SIM”, 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. Caso a validação esteja correto, a função deve ser acionada dentro dos seguintes eventos abaixo:
    • Quando houver multiplicação na quantidade do produto realizado pelo usuário.
  • 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.
Expandir
titleSolicitação: DDLEGFIN-1247

Diferença de Item - Desconto/Acréscimo

1) Na 2075, deve ser implementado a seguinte função de integração com a Gatecash: GATECASH_DiferencaItem_InformPDV(Sequencia: Integer; Diferenca: Double; Pdv: Integer): Integer.

  • No parâmetro “Sequencia”, deve ser passado o número da sequência do produto;
  • No parâmetro “Diferenca”, deve ser passado o valor absoluto de acréscimo (positivo) ou desconto (negativo) no valor da venda do item;
  • No parâmetro “Pdv”, deve ser passado o número do caixa;
  • Deve validar se o parâmetro UTILIZAGATECASH estiver marcado como “SIM”, com o IP do servidor Gate-cash informado no cadastro do caixa (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:
    • Quando for aplicado desconto no produto na tela “Desconto no Item” (“D”);
    • Quando for aplicado acréscimo no produto na tela “Acréscimo no Item” (“P”);
    • Quando o produto tiver desconto “Qtde. Mínimo Atacado” ou “Qtde. Múltipla”.
  • 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.
Expandir
titleSolicitação: DDLEGFIN-1249

Forma de Pagamento

1) Na 2075, deve ser implementado a seguinte função de integração com a Gatecash: GATECASH_FormaPagamento_InformPDV(const FormaPagamento: PAnsiChar; const Complemento: PAnsiChar; Valor: Double; Pdv: Integer) : Integer.

  • No parâmetro “FormaPagamento”, deve ser passado a descrição da forma de pagamento inserida;
  • No parâmetro “Complemento”, deve ser passado o número do cartão se a forma de pagamento for SoftCred ou GiftCard. Caso seja diferente, deve ser passado uma string vazia (“”).
  • No parâmetro “Valor”, deve ser passado o valor da forma de pagamento inserida;
  • No parâmetro “Pdv”, deve ser passado o número do caixa;
  • Deve validar se o parâmetro UTILIZAGATECASH estiver marcado como “SIM”, 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. Caso a validação esteja correto, a função deve ser acionada dentro dos seguintes eventos abaixo:
    • Quando uma forma de pagamento for registrada.
  • 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.
Expandir
titleSolicitação: DDLEGFIN-1284

Cancelamento de Pagamento - Estorno

1) Na 2075, deve ser implementado a seguinte função de integração com a Gatecash: GATECASH_CancelaPagamento_InformPDV(const FormaPagamento: PAnsiChar; const Complemento: PAnsiChar; Valor: Double; Pdv: Integer) : Integer.

  • No parâmetro “FormaPagamento”, deve ser passado a seguinte descrição “Todas As Formas De Pagamento”;
  • No parâmetro “Complemento”, deve ser passado uma string vazia (“”).
  • No parâmetro “Valor”, deve ser passado o valor pago;
  • No parâmetro “Pdv”, deve ser passado o número do caixa;
  • Deve validar se o parâmetro UTILIZAGATECASH estiver marcado como “SIM”, 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. Caso a validação esteja correto, a função deve ser acionada dentro dos seguintes eventos abaixo:
    • Quando sair da tela de fechamento da venda sem finalizar a venda (tecla “C” ou tecla “ESC”).
  • 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.
Expandir
titleSolicitação: DDLEGFIN-1239

Abertura de Documento

1) Na 2075, ao iniciar a emissão de algum documento, como relatório gerencial ou cupom não fiscal (giftcard, recarga, boleto, venda TEF e tricard); 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_AbreDocumento_InformPDV(const Nome: PAnsiChar; Pdv: Integer): Integer;
  • No parâmetro Nome, deve ser passado o nome do documento impresso;
  • No parâmetro Pdv, deve ser passado o número do caixa;
  • A função GATECASH_AbreDocumento_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.
  • A função deve ser implementação na abertura do documento. 


03. SOLUÇÃO

Criado parâmetro 4519 - Utiliza a Integração Gatecash que visa realizar a integração do PDV com o sistema GATECASH permitindo maior confiança nas informações passadas pelo caixa. 

Importante:

  • A pasta LogGatecash é criada automaticamente pela rotina 2075 - Frente de Caixa, uma vez que a rotina identifica que o parâmetro 4519 está marcado como Sim e o IP Servidor esteja cadastrado/configurado na rotina 2044 - Cadastrar CheckOut;
  • Dentro da pasta repositório, MOD-20 deverá existir o arquivo GCPlug.dll (processo a ser realizado pelo próprio cliente/usuário);


Totvs custom tabs box
tabsParametrização,2044 - Cadastrar Checkout, 2075 - 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):


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
Expandir
titleInicializar Comunicação Com GATECASH

Iniciar Comunicação com GATECASH:

Observações:


  • No processo de inicialização 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;

        - 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. É  utilizado o diretório “C:\winthor\prod\MOD-020\LOGGATECASH” mais as pastas do ano             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.

           - É 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 e o código do                  operador efetuou o login.


Consulta ao LOGCX:

Processo de Inicialização.


Image Added


Consulta LOGGATECASH:

Image Added


Expandir
titleFinalizar Comunicação com GATECASH
  • 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 (Observação: 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. 


Consulta LOGCX:

Image Added


Consulta LOGGATECASH:

Image Added


Expandir
titleAbrir PDV Com Código de Operador:

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


Consulta LOGCX:

Image Added


LogGATECASH:

Image Added


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.


Consulta LOGGATECASH:

Image Added


Consulta LOGCX:

Image Added


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
  • No parâmetro Funcionario, é repassado o nome do operador do caixa.
  • No parâmetro Codigo, é repassado o código do operador do caixa.
  • No parâmetro Pdv, é repassado 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.


Consulta LOGCX:

Image Added


Image Added



Consulta LogGatecash:

Image Added


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

Image Added

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

Image Added


Conbsulta LOGGATECASH:

Image Added


Cupom Fiscal e Relatório Gerencial:

Image Added


Image Added

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

Image Added


Consulta LOGGATECASH:

Image Added


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


Image Added


Image Added

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

Image Added


Consulta LOGGATECASH:

Image Added

Expandir
titleAnulação de Cupom

Anulação de Cupom 


Ao efetuar o Cancelamento de um cupom fiscal, após ser fechado, caso o parâmetro 4519 - UTILIZAGATECASH da rotina 132 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;
  • No parâmetro Pdv, é repassado o número do caixa;
  • No parâmetro Codigo, é 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:

Image Added


LOGGATECASH:

Image Added


Cupom cancelado

Image Added

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

Image Added


LOGGATECASH:

Image Added


Cupom Com Informações do Cliente:

Image Added

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

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.

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


Expandir
titleVenda Item

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.

  • 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;
  • Valida se o parâmetro 4519 - UTILIZAGATECASH se está marcado como Sim na rotina 132, 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


Expandir
titleConsultar Valor do Produto

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 está marcado como Sim na rotina 132, 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 (R)

Image Added


Consultar Preço (Ctrl+R)

Image Added


Consulta LOGGATECASH:

Consultar Produto (R)

Image Added


Consultar Preço (Ctrl+R)

Image Added

Expandir
titleCancelamento de Item

Cancelamento de Item


Na rotina 2075, implementada a função de integração com a Gatecash: GATECASH_CancelaItem_InformPDV.

  • No parâmetro Sequencia, é repassado o número da sequência do produto cancelado;
  • No parâmetro Pdv, é repassado o número do caixa;
  • Valida se o parâmetro 4519 - UTILIZAGATECASH está marcado como Sim, 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. Estado correta a validação, a função é acionada dentro dos seguintes eventos abaixo:
    • Quando o produto for cancelado na venda (“F2”).
  • 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:

Image Added


Consulta LOGGATECASH:

Image Added

Expandir
titleMultiplicação de Item

Multiplicação de Item


Observação: para este processo o usuário deverá ter a permissão de acesso 57 -  Permitir Multiplicação no Checkout da rotina 530 - Pemitir Acesso a Rotina.


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

A rotina valida 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 2075.  Estando a validação correta, a função é acionada dentro dos seguintes eventos abaixo:

  • Quando houver multiplicação na quantidade do produto realizado pelo usuário. 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:

Image Added


Consulta LOGGATECASH:

Image Added


No Emulador GATECASH o item/produto multiplicado é identificado no campo mensagem com Multiplicação conforme imagem abaixo:


Image Added

Expandir
titleDiferença de Item - Desconto/Acréscimo

Diferença Item - Desconto Acréscimo

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


Observação: para verificar aplicação dos descontos Qtde. Mínimo Atacado ou Qtde. Múltipla na rotina 2075 o parâmetro 3879 - Utiliza Gatilho de atacado por Embalagem da rotina 132 deve estar marcado como Sim


  • No parâmetro Sequencia, é repassado o número da sequência do produto;
  • No parâmetro Diferenca, é repassado o valor absoluto de acréscimo (positivo) ou desconto (negativo) no valor da venda do item;
  • No parâmetro Pdv, é repassado o número do caixa;
  • É validado se o parâmetro 4519 - UTILIZAGATECASH está marcado como Sim, com o IP do servidor Gate-cash 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 correta, a função é acionada dentro dos seguintes eventos abaixo:
    • Quando for aplicado desconto no produto na tela Desconto no Item (“D”);
    • Quando for aplicado acréscimo no produto na tela Acréscimo no Item (“P”);
    • Quando o produto tiver desconto Qtde. Mínimo Atacado ou Qtde. Múltipla.
  • 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:

Image Added


Consulta LOGGATECASH:

Desconto Item.

Image Added


Acréscimo Item.

Image Added


Produto com desconto  Qt. Mínima Atacado parametrizada na rotina 2014 - Cadastrar Embalagem, caixa Preço Atacado. Note que no LogGatecash para este tipo de desconto parametrizado trará a informação de  Motivo: Desconto aplicado aos produtos anteriores conforme destacado na imagem abaixo.


Image Added


Image Added


Produto com desconto Qtde. Múltipla parametrizada na rotina 2014 - Cadastrar Embalagem, caixa Preço Atacado. Note que no LogGatecash para este tipo de desconto parametrizado trará a informação de  Motivo: Desconto aplicado aos produtos  anteriores.


Image Added


Image Added



No Emulador do GATECASH os produtos com desconto por Qtde. Mínimo Atacado ou Qtde. Múltipla são identificados no campo Mensagens como: Diferença EX do item. 


Image Added

Expandir
titleForma de Pagamento

Forma de Pagamento


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

  • No parâmetro FormaPagamento, é repassado a descrição da forma de pagamento inserida;
  • No parâmetro Complemento, é repassado o número do cartão se a forma de pagamento GiftCard. Caso seja diferente, deve ser passado um fragmento vazio (“”).
  • No parâmetro Valor, é repassado o valor da forma de pagamento inserida;
  • No parâmetro Pdv, é repassado o número do caixa;
  • É validado o parâmetro 4519 - UTILIZAGATECASH da rotina 132. Estando parâmetromarcado 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. Estando a validação correta, a função é acionada dentro dos seguintes eventos abaixo:
    • Quando uma forma de pagamento for registrada.
  • 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:

Forma de pagamento Dinheiro.

Image Added


Forma de pagamento GIFTCARD.

Image Added



Consulta LOGGATECASH:

Forma de Pagamento Dinheiro.

Image Added


Forma de pagamento GIFTCARD.

Image Added


Expandir
titleCancelamento de Pagamento - Estorno

Cancelamento de Pagamento - Estorno


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

  • No parâmetro FormaPagamento, é repassado a descrição “Todas A Formas De Pagamento”;
  • No parâmetro Complemento, é repassado a descrição: ´´Saiu da tela sem fechar a venda``. Ao sair da tela de pagamento sem finalizar a venda;.
  • No parâmetro Valor, deve ser passado o valor pago;
  • No parâmetro Pdv, é repassado o número do caixa;
  • É validado o parâmetro 4519 - UTILIZAGATECASH se 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. Estando a validação correta, a função deve ser acionada dentro dos seguintes eventos abaixo:
    • Quando sair da tela de fechamento da venda sem finalizar a venda (tecla “C” ou tecla “ESC”).
  • 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: 

Para estes exemplos cancelamos um pagamento em Cartão de Crédito. 


Image Added



Consulta LOGGATECASH:

Image Added


Expandir
titleAbertura de Documento

Abertura de Documento.


Exemplo com Recarga de Celular.

Ao iniciar a emissão de algum documento na rotina 2075, como relatório gerencial ou cupom não fiscal (giftcard, recarga, boleto, venda TEF e tricard). Caso o parâmetro 4519 - UTILIZAGATECASH estiver 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_AbreDocumento_InformPDV;
  • No parâmetro Nome, é repassado o nome do documento impresso;
  • No parâmetro Pdv, deve ser passado o número do caixa;
  • A função GATECASH_AbreDocumento_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.

A função implementada na abertura do documento. 


Consulta LOGCX:

Image Added


Consulta LOGGATECASH:

Image Added

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;


Image Added


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

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

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


Image Added


Image Added



Registro de Sangria:

Na rotina 2075, quando da Emissão de Sangria, estando parâmetro 4519 - UTILIZAGATECASH

estiver marcado

 marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é

implementada

implementa a chamada da seguinte função da dll:

  • GATECASH_
AbrePdvEx
  • Sangria_InformPDV(const
Funcionario
  •  Complemento: string;
const Codigo: string;
  •  Valor: Double; Pdv: Integer)
.
  • : Integer
  • No parâmetro
Funcionario, é informado o nome do operador de caixa
  •  Complemento, é repassada a descrição da cobrança da sangria gerada.
  • No parâmetro
Codigo, é informado o código do operador de caixa
  •  Valor, é repassado o valor da sangria gerada.
  • No parâmetro Pdv,
é informado
  • informa o número do caixa.
  • A função GATECASH_
AbrePdvEx
  • Sangria_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)

Função 1000

Image Removed

Image Removed


Image Added


Image Added



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!

...