Essa implementação e as demais referente a este processo de integração, deverá ocorrer nos caixas:

• ECF, NFCE, SAT, MFE 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.

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.

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.

Fechamento de PDV

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.

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.

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.

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 arquivo LogCX o registro do retorno da função.

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.

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.

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.

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.

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.

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.

Importante!

As versões estarão disponíveis para download no CCW. 

https://centraldecontrole.pcinformatica.com.br/

Mantenha suas rotinas sempre atualizadas!

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>