Observações / Validações: - No proc3. Realizado registro conforme necessidade clique o botão Gravar.esso de inicialização da rotina 2075, caso o parâmetro 4519 - UTILIZAGATECASH da rotina 132 estiver marcado como Sim e no cadastro do caixa contém o IP do servidor Gatecash informado, é implementada a chamada da seguinte função da dll GCPlug.dll:
- GATECASH_InicializaEx2(const CaminhoBase: string; const Servidor: string; Pdv: Integer; const CaminhoLog: string); - No parâmetro CaminhoBase, é repassado valor “.”.; - No parâmetro Servidor, é repassado o IP configurado na rotina 2044; - No parâmetro Pdv, é repassado o número do caixa; - No parâmetro CaminhoLog, é repassado o diretório da pasta que será salvo os logs. São gravados registros de log em arquivos gcecho#.log, onde # indica o dia do mês. Esses arquivos de logs serão gerados pela DLL e não pela rotina 2075, na qual só terá o trabalho em passar o diretório que a DLL irá gravar esses arquivos. Será usado o diretório “C:\winthor\prod\MOD-020\LOGGATECASH” mais as pastas do ano e mês corrente. Exemplo: “C:\winthor\prod\MOD-020\LOGGATECASH\2021\janeiro”. - A função GATECASH_InicializaEx2 terá os seguintes retornos:
- 0: sucesso ao inicializar comunicação. - 999: falha ao executar comando. - Deve ser gerado no arquivo LogCX o registro do retorno da função. - Caso a dll não exista dentro do diretório “C:\winthor\prod\MOD-020", deverá registrar no arquivo LogCX a seguinte descrição "O arquivo GCPlug.dll é inexistente. Cód. Operador: XX", onde XX é o código do operador efetuou o login. Print de tela na consulta ao LOGCX: Processo de Inicialização.  Image Removed
- Ao ao fechar o sistema, caso o parâmetro 4519 - UTILIZAGATECASH da rotina 132 estiver 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. - | Expandir |
|---|
| 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  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
|
| Expandir |
|---|
| Ao realizar abertura do cupom fiscal |
Processo de Fechamento:  Image Removed
Ao efetuar o login de acesso ao Caixa, na opção F6 da tela de Login do caixa e na tela de Bloqueio do caixa do atalho F4, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é |
implementada realizada a chamada da seguinte função da |
dllAbrePdvExconst Funcionario: string; const string.
No parâmetro Funcionario, é informado o nome do operador de caixa.- : Integer;
- No parâmetro Codigo, é informado o
|
código do operador de caixa.- número do cupom fiscal;
- No parâmetro Pdv, é informado o número do caixa
|
.AbrePdvEx- AbreCupom_InformPDV terá os seguintes retornos:
- 0: sucesso ao enviar evento
|
. 1 inicializada. 999- 999: falha ao executar comando
|
. no arquivo LogCX o registro do retorno da função. Image Removed
LogGatecash:  Image Removed
| Expandir |
|---|
| 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 - 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.  Image Removed
Consulta LOGCX:  Image Added
LogGatecash:  Image Added
Cupom Fiscal e Relatório Gerencial:  Image Added
 Image Added Image Removed
|
| Expandir |
|---|
| title | Informa Operador | Fechamento de Documento |
|---|
| Ao Finalizar a emissão de algum documento ou Fechar a Venda Cupom Fiscal, estando oparâmetro 4519 - UTILIZAGATECASH marcado 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 implementado a chamada da seguinte função da dll: - GATECASH_InformaOperadorFechaDocumentoCod_InformPDV(const Funcionario: string; const Codigo: string; Pdv: Integer): Integer;
- No parâmetro Funcionario, deve-se passar o nome do operador do caixa.
- No parâmetro Codigo, deve-se passar o código do operador do caixa.
- No parâmetro Pdv, deve-se passar o número do caixa
- Codigo, é repassado o número do documento ou cupom fiscal;
- A função GATECASH_ FechaDocumentoCod_InformPDV tem os A função GATECASH_InformaOperador_InformPDV terá os seguintes retornos:
- 0: sucesso ao enviar evento
. 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
Consulta LOGCX:  Image Added
LogGatecash: Image Removed O Emulador de Serviço Gatecahs irá trazer a mensagem de Informa Operador conforme imagem abaixo:
 Image Added
Consulta a Cupom Fiscal e Relatório Gerencial com o número do documento ou cupom fiscal;
 Image Added
 Image AddedImage Removed
|
| Expandir |
|---|
| title | Abertura Cancelamento de Cupom |
|---|
| Ao realizar abertura do cupom fiscal, caso Cancelar o Cupom com a venda aberta ,estando o parâmetro 4519 - UTILIZAGATECASH estiver marcado marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é realizada deve ser implementado a chamada da seguinte função da Dlldll: - GATECASH_AbreCupomCancelaCupomEx_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
- No parâmetro Codigo, é informado repassado o número do cupom fiscal;
- No parâmetro Pdv, é informado repassado o número do caixa;
- A função GATECASH_AbreCupomCancelaCupomEx_InformPDV terá os seguintes retornos:
- 0: sucesso ao enviar evento;
- -1: comunicação não iniciada;
- -999: falha falha ao executar comando;.
- É Deve ser 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 Removed Image Added
LogGatecash: Image Removed Cupom Fiscal e Relatório Gerencial: Image Removed Image Removed  Image Added
|
| Expandir |
|---|
| title | Anulação de CupomFechamento |
|---|
| Anulação de | DocumentoCupom
Ao Finalizar a emissão de algum documento ou Fechar a Venda Cupom Fiscal, estando oparâmetro efetuar o Cancelamento de um cupom fiscal, após ser fechado, caso o parâmetro 4519 - UTILIZAGATECASH marcado esteja marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementado implementada a chamada da seguinte função da dll: - GATECASH_FechaDocumentoCodAnulaCupom_InformPDV(Pdv: Integer; Codigo: Integer): Integer Integer;
- No parâmetro Pdv, é repassado o número do caixa;
- No parâmetro Codigo, é repassado o número do documento ou cupom fiscal;
- A função GATECASH_ FechaDocumentoCodAnulaCupom_InformPDV tem os 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 Removed LogGatecash: Image Removed Consulta a Cupom Fiscal e Relatório Gerencial com o número do documento ou cupom fiscal; Image Removed  Image Added
LOGGATECASH:  Image Added
Cupom cancelado  Image AddedImage Removed
|
| Expandir |
|---|
| title | Cancelamento de Cupom | Informações do Cliente com Código |
|---|
| Informações do Cliente com Código
Executado enquanto o cupom está aberto e informado o cliente que realiza a compra, utilizada tecla de atalho Ctrl = C. • Cliente: string com nome do cliente ou com número que o identifica (RG, CPF, etc). • Código: código do cliente. Pode ser um identificador genérico (RG ou CPF, caso já possua um nome sendo passado no campo Cliente) ou um identificador específico do negócio (número de matrícula, por exemplo). Se não disponível, informar string vazia (“”). Retorno: Ao Cancelar o Cupom com a venda aberta ,estando o parâmetro 4519 - UTILIZAGATECASH marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, deve ser implementado a chamada da seguinte função da dll: - GATECASH_CancelaCupomEx_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
- No parâmetro Codigo, é repassado o número do cupom;
- No parâmetro Pdv, é repassado o número do caixa;
- A função GATECASH_CancelaCupomEx_InformPDV terá os seguintes retornos:
• 0: sucesso ao enviar evento ;. • -1: comunicação não iniciada;inicializada. • -999: falha falha ao executar comando .Deve ser gerado no arquivo LogCX o registro do retorno da função.
Consulta LOGCX: Image Removed  Image Added
LOGGATECASH:  Image Added
Cupom Com Informações do ClienteLogGatecash: Image Removed Image Added |
| Expandir |
|---|
| title | Anulação de Cupom | Informações de Supervisor/Fiscal |
|---|
| Informações de Supervisor/Fiscal
Ao solicitar a senha do Supervisor/Fiscal de Caixa, Ao efetuar o Cancelamento de um cupom fiscal, após ser fechado, caso o parâmetro 4519 - UTILIZAGATECASH esteja marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementada implementado a chamada da seguinte função da dll: - GATECASH_AnulaCupomInformaSupervisor_InformPDV(Pdv: Integer; Codigo: const Supervisor: PAnsiChar; const Codigo: PAnsiChar; Pdv: Integer): Integer;
- No parâmetro Pdv Supervisor, é informado o Nome do Supervisor/Fiscal de caixa.
- No parâmetro Codigo, é repassado informado o número código do caixa;sSupervisor/Fiscal de caixa (conforme a tabela: PCEMPR, campo: MATRICULA).
- No parâmetro Codigo, ér repassado Pdv, é informado o número do cupom;caixa.
- A função GATECASH_AnulaCupomInformaSupervisor_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 Removed LOGGATECASH: Image Removed Cupom cancelado Image Removed | | Expandir |
|---|
| title | Informações do Cliente com Código |
|---|
| Observação: para este exemplo solicitou Funções Especiais. Funcao: 1025.
Consulta LOGCX:  Image Added
Consulta LOGGATECASH:  Image Added
|
| Expandir |
|---|
| title | Diferença de Cupom - Acréscimos ou Descontos |
|---|
| Diferença de Cupom - Acréscimos ou Descontos
Para este processo o parâmetro 1186 - Permite desconto no rodapé no checkout, da rotina 132 deverá estar marcado como Sim. Realizar venda na rotina 2075 e no momento do fechamento da venda aplicar Desconto (atalho “D”). Realizar venda na rotina 2075 e no momento do fechamento da venda aplicar Acréscimo (atalho “A”). No parâmetro Diferença está sendo passado o Acréscimo (positivo) e Desconto (negativo) no valor total do cupom. GATECASH_DiferencaCupom_InformPDV(Diferenca: Double; Pdv: Integer): Integer. No parâmetro Pdv, é repassado o número do caixa. Validado parâmetro 4519 - UTILIZAGATECASH marcado como Sim na rotina 132, com o IP do servidor Gatecash informado no cadastro do caixa (rotina 2044) e com o arquivo GCPlug.dll dentro do diretório da rotina 2075. (Ver tela anexa). A função tem os seguintes retornos: - 0: sucesso ao enviar evento;
- -1: comunicação não inicializada;
- -999: falha ao executar o comando.
- É gerado no arquivo LogCX o registro do retorno da função.
Consulta LOGCX: Acréscimo  Image Added
Desconto  Image Added
Consulta LOGGATECASH: Acréscimo  Image Added
Desconto  Image Added
|
| Expandir |
|---|
| Venda Item:
Na rotina 2075, foi implementada a seguinte função de integração com a Gatecash: GATECASH_VendeItemEx_InformPDV(Sequencia: Integer; const Codigo: PAnsiChar; const Descricao: PAnsiChar; Quantidade: Double; ValorUnitario: Double; Unitario: Boolean; Escaneado: Boolean; Pdv: Integer): Integer. - No parâmetro Sequencia, é informado o número/índice da sequência do produto;
- No parâmetro Codigo, é informado o código de barras do produto;
- No parâmetro Descricao, é informada a descrição do produto;
- No parâmetro Quantidade, é informada a quantidade do produto;
- No parâmetro ValorUnitario, é informado o valor unitário do produto;
- No parâmetro Unitario, é informado Verdadeiro (Zero) se o produto é unitário ou Falso (Um) se o produto é pesado;
- No parâmetro Escaneado, é Verdadeiro (Zero) se o produto foi escaneado ou Falso (Um) se o produto foi digitado pelo usuário;
- No parâmetro Pdv, é informado o número do caixa;
- Deve validar se o parâmetro 4519 - UTILIZAGATECASH se está marcado como Sim
| Informações do Cliente com Código Executado enquanto o cupom está aberto e informado o cliente que realiza a compra, utilizada tecla de atalho Ctrl = C. • Cliente: string com nome do cliente ou com número que o identifica (RG, CPF, etc). • Código: código do cliente. Pode ser um identificador genérico (RG ou CPF, caso já possua um nome sendo passado no campo Cliente) ou um identificador específico do negócio (número de matrícula, por exemplo). Se não disponível, informar string vazia (“”). Retorno: • 0: sucesso ao enviar evento. • -1: comunicação não inicializada. • -999: falha ao executar comando. Consulta LOGCX: Image Removed LOGGATECASH: Image Removed Cupom Com Informações do Cliente: Image Removed | Expandir |
|---|
| title | Informações de Supervisor/Fiscal |
|---|
| Informações de Supervisor/Fiscal Ao solicitar a senha do Supervisor/Fiscal de Caixa, caso o parâmetro 4519 - UTILIZAGATECASH esteja marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementado a chamada da seguinte função da dll: - GATECASH_InformaSupervisor_InformPDV(const Supervisor: PAnsiChar; const Codigo: PAnsiChar; Pdv: Integer): Integer;
- No parâmetro Supervisor, é informado o Nome do Supervisor/Fiscal de caixa.
- No parâmetro Codigo, é informado o código do sSupervisor/Fiscal de caixa (conforme a tabela: PCEMPR, campo: MATRICULA).
- No parâmetro Pdv, é informado o número do caixa.
- A função GATECASH_InformaSupervisor_InformPDV terá os seguintes retornos:
- 0: sucesso ao enviar evento;
- -1: comunicação não iniciada;
- -999: falha ao executar comando;
- É gerado no arquivo LogCX o registro do retorno da função.
Observação: para este exemplo solicitou Funções Especiais. Funcao: 1025. Consulta LOGCX: Image Removed Consulta LOGGATECASH: Image Removed | Expandir |
|---|
| title | Diferença de Cupom - Acréscimos ou Descontos |
|---|
| Diferença de Cupom - Acréscimos ou Descontos Para este processo o parâmetro 1186 - Permite desconto no rodapé no checkout, da rotina 132 deverá estar marcado como Sim. Realizar venda na rotina 2075 e no momento do fechamento da venda aplicar Desconto (atalho “D”). Realizar venda na rotina 2075 e no momento do fechamento da venda aplicar Acréscimo (atalho “A”). No parâmetro Diferença está sendo passado o Acréscimo (positivo) e Desconto (negativo) no valor total do cupom. GATECASH_DiferencaCupom_InformPDV(Diferenca: Double; Pdv: Integer): Integer. No parâmetro Pdv, é repassado o número do caixa. Validado parâmetro 4519 - UTILIZAGATECASH marcado como Sim na rotina 132- , com o IP do servidor Gatecash informado no cadastro do caixa (rotina 2044) e com o arquivo
GCPlug.- dll dentro do diretório da rotina 2075.
(Ver tela anexa). A função tem - 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: Acréscimo Image Removed Desconto Image Removed Consulta LOGGATECASH: Acréscimo Image Removed Desconto Image Removed
|
| Expandir |
|---|
| title | Consultar Valor do Produto |
|---|
| Consulta Valor do Produto
Na rotina 2075, foi implementado a função de integração com a Gatecash: GATECASH_ConsultaProduto_InformPDV(const Codigo: PAnsiChar; const Descricao: PAnsiChar; ValorUnitario: Double; Pdv: Integer) : Integer. - No parâmetro “Codigo”, é repassado o código do produto consultado;
- No parâmetro “Descricao”, é repassado a descrição do produto consultado;
- No parâmetro “ValorUnitario”, é repassado o valor unitário do produto consultado;
- No parâmetro “Pdv”, deve ser passado o número do caixa, validando se o parâmetro 4519 - UTILIZAGATECASH está marcado como Sim, com o IP do servidor Gatecash informado no cadastro do caixa (na rotina 2044) e com o arquivo GCPlug.dll dentro do diretório da rotina 2075. Caso a validação esteja correto, a função é acionada dentro dos seguintes eventos abaixo:
- Quando for realizado a consulta na tela Consulta de Produtos (“R”) ou na tela Consulta Preço (“Ctrl+R”);
- A função terá os seguintes retornos:
- 0: sucesso ao enviar evento;
- -1: comunicação não inicializada;
- -999: falha ao executar o comando.
- É gerado no arquivo LogCX o registro do retorno da função.
Consulta LOGCX: Consultar Produto (R) 
Consultar Preço (Ctrl+R) 
Consulta LOGGATECASH: Consultar Produto (R) 
Consultar Preço (Ctrl+R) 
|
|
