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. - É 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 parâmetro 4519 - UTILIZAGATECASH estiver marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementada chamada da função da dll: GATECASH_AbrePdvEx_InformPDV(const Funcionario: string; const Codigo: string; Pdv: Integer). No parâmetro Funcionario, é informado o nome do operador de caixa. No parâmetro Codigo, é informado o código do operador de caixa. No parâmetro Pdv, é informado o número do caixa. A função GATECASH_AbrePdvEx_InformPDV - terá os seguintes retornos:
- 0: sucesso ao enviar evento
| . 1- 1: comunicação não inicializada
| . 999- 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. |
É gerado no arquivo LogCX o registro do retorno da função.Image Removed LogGatecash: Image RemovedImage Added
No Emulador do GATECASH o produto com quantidade em valor decimal este virá preenchido no campo Mensagens com Multiplicação. Image Added
|
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 o registro do retorno da função. Image Removed Image Removed Expandir |
---|
| Consultar 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
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 o 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:
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 AddedImage Removed |
Expandir |
---|
title | Abertura Cancelamento de CupomItem |
---|
| 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
Ao realizar abertura do cupom fiscal, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é realizada a chamada da seguinte função da Dll: - GATECASH_AbreCupom_InformPDV(Codigo: Integer; Pdv: Integer): Integer;
- No parâmetro Codigo, é informado o número do cupom fiscal;
- No parâmetro Pdv, é informado o número do caixa;
- A função GATECASH_AbreCupom_InformPDV terá os seguintes retornos:
- 0: sucesso ao enviar evento;
- -1: comunicação não
iniciada- 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 |
---|
title | Multiplicação de Item |
---|
| Multiplicação de Item
Observação: 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 Removed LogGatecash: Image Removed Cupom Fiscal e Relatório Gerencial: Image Removed Image Removed | Expandir |
---|
title | 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, é implementado a chamada da seguinte função da dll: - GATECASH_FechaDocumentoCod_InformPDV(Codigo: Integer): Integer;
- No parâmetro Codigo, é repassado o número do documento ou cupom fiscal;
- A função GATECASH_ FechaDocumentoCod_InformPDV tem os seguintes retornos:
- 0: sucesso ao enviar evento;
- -1: comunicação não iniciada;
- -999: falha ao executar comando.
- É gerado no arquivo LogCX o registro do retorno da função.
Consulta LOGCX: 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 Removed Expandir |
---|
title | Cancelamento de Cupom |
---|
| 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 |
---|
title | Diferenç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
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 falha comando.
- Deve ser gerado no arquivo LogCX o registro do retorno da função.
Consulta LOGCX: Image Removed LogGatecash: Image Removed | Expandir |
---|
| Ao efetuar o Cancelamento de um cupom fiscal, após ser fechado, caso o parâmetro 4519 - UTILIZAGATECASH esteja marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é implementada a chamada da seguinte função da dll: - GATECASH_AnulaCupom_InformPDV(Pdv: Integer; Codigo: Integer): Integer;
- No parâmetro Pdv, é repassado o número do caixa;
- No parâmetro Codigo, ér repassado o número do cupom;
- A função GATECASH_AnulaCupom_InformPDV terá os seguintes retornos:
- 0: sucesso ao enviar evento;
- -1: comunicação não iniciada.
- Deve ser gerado no arquivo LogCX o registro do retorno da função.
Consulta LOGCX: Image Removed LOGGATECASH: Image Removed Cupom cancelado Image Removed - É 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 |
---|
| 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 |
---|
title | Cancelamento 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
| Expandir |
---|
title | 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: • 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 iniciadainicializada;
- -999: falha ao executar o 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: Para estes exemplos cancelamos um pagamento em Cartão de Crédito.
Image AddedImage Removed
Consulta LOGGATECASH: Image RemovedImage Added
|
Expandir |
---|
title | Diferença de Cupom - Acréscimos ou Descontos | Abertura 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á
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- iniciada;
- -999: falha ao executar
o
É 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 |
|