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. - 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.
- É
| - 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
Consulta LOGCX: Image Added
Consulta LOGGATECASH: Image Added |
Expandir |
---|
title | Multiplicaçã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 |
---|
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 terá os seguintes retornos:
- 0: sucesso ao enviar evento
| . 1- 1: comunicação não inicializada
| . 999- 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 Removed LogGatecash: Image Removed Fechamento PDV: Na Função de Bloquear a tela do Caixa (atalho F4), ou, Fechar a rotina (botão X ou funções 1000, 1001, 1002 e 1003) é gerado no arquivo LogCX e LOGGATECASH o registro do retorno da função. Image Removed Image Removed Informa Operador: Ao abrir o PDV após efetuar o Login na tela inicial e na tela de Bloqueio do PDV, também ao abrir um Cupom/Venda, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado como Sim e tenha a GCPlug.dll no arquivo de diretório da rotina 2075, é realizada a chamada da seguinte função da 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 Removed Image Removed LogGatecash: Image Removed O Emulador de Serviço Gatecahs irá trazer a mensagem de Informa Operador conforme imagem abaixo: Image Removed Abertura de Cupom Ao realizar abertura do cupom fiscal, caso o parâmetro 4519 - UTILIZAGATECASH estiver marcado 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 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
| iniciada - falha ao executar o 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 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 Cancelamento 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(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;
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
| A função GATECASH_CancelaCupomEx_InformPDV - terá os seguintes retornos:
- 0: sucesso ao enviar evento;
- -1: comunicação não
| iniciada falha - falha ao executar o comando.
| Deve ser - É gerado no arquivo LogCX o registro do retorno da função.
Consulta LOGCX: |
Image Removed LogGatecash: Image Removed Anulação de Cupom Ao efetuar o Cancelamento de um cupom fiscal, após ser fechado, caso Para estes exemplos cancelamos um pagamento em Cartão de Crédito.
Image Added
Consulta LOGGATECASH: Image Added
|
Expandir |
---|
title | 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 | esteja 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: | AnulaCupom(Pdv: Integer Codigo: Integer): Integer; Pdv número caixa- documento impresso;
- No parâmetro
| Codigo, ér repassado - Pdv, deve ser passado o número do
| cupomAnulaCupom- 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 implementada na abertura do documento.
Consulta LOGCX: Image Added
Consulta LOGGATECASH: Image Added |
|