View
0
Download
0
Category
Preview:
Citation preview
DOCUMENTO TÉCNICO RQ-130
DT nº: 2/5-14
Referente OE nº: 001-14
Página:1 / 36
GERTEC Revisão: 03 – 28/10/2016
Objetivo: Descrever o funcionamento das funções existentes na DLL do REP-G1, G2 e G3.
HISTÓRICO DE REVISÕES
Release Escrito por Data Aprovado por Descrição
0 Augusto Serrão 05/09/2016 Versão inicial do documento.
1 Augusto Serrão 27/09/2016 Alteração referentes a DLL 01_005_0004.
2 Augusto Serrão 20/10/2016 Alteração referentes a DLL 01_005_0005.
3 Augusto Serrão 28/10/2016 Alteração referentes a DLL 01_005_0006.
4 Ricardo Oliveira 01/11/2016 Alteração geral na documentação e inclusão da função “REP_Mensagem_Erro”
Funções 3.1. REP_Conexao_Simples ............................................................................... 3 3.2. REP_Conexao_Direta_G3 ........................................................................... 4
3.3. REP_ConexaoComPorta ............................................................................. 5 3.4. REP_InfoTerminal ......................................................................................... 6
3.5. REP_Tempo .................................................................................................... 7 3.6. REP_LeTemperatura .................................................................................... 8
3.7. REP_Rede_Simples ...................................................................................... 8 3.8. REP_LeCadastro ........................................................................................... 9
3.9. REP_LeIntervaloNSR ................................................................................. 10
3.10. REP_LeTipoReg ....................................................................................... 11
3.11. REP_LeRegEmpregador ........................................................................ 11
3.12. REP_LeRegPonto .................................................................................... 12 3.13. REP_LeRegFuncionario ........................................................................ 13
3.14. REP_GravaCadastroEmpregador ....................................................... 14 3.15. REP_GravaCadastroFuncionario ........................................................ 15 3.16. REP_ExcluiCadastroFuncionario ....................................................... 16
3.17. REP_LeEspacoMemoria ........................................................................ 16
3.18. REP_LeNSR .............................................................................................. 17
3.19. REP_StatusImpressora .......................................................................... 18 3.20. REP_LeFinger .......................................................................................... 18
3.21. REP_GravaFinger .................................................................................... 19 3.22. REP_GravaFinger_Bytes ....................................................................... 20
3.23. REP_FormataFinger ............................................................................... 20
3.24. REP_RemoverFingerID .......................................................................... 21
3.25. REP_LeFingerID ...................................................................................... 22
3.26. REP_LeFingerID_Bytes ......................................................................... 22 3.27. REP_LeFingerIDEspecifico_Bytes ..................................................... 23
3.28. REP_LeFingersIdsPis ............................................................................ 24 3.29. REP_Versao .............................................................................................. 25 3.30. REP_StatusBateria .................................................................................. 26
3.31. REP_ConfigRede ..................................................................................... 26 3.32. REP_WifiConfig ....................................................................................... 27
3.33. REP_InterfaceRede ................................................................................. 28 3.34. REP_GravaNovaSenha .......................................................................... 29
3.35. REP_LeFuncionario ................................................................................ 30
DOCUMENTO TÉCNICO
RQ-130 Página: 2 / 36
GERTEC Revisão: 03 – 28/10/2016
3.36. REP_LeStatusMemoriaTrabalho ......................................................... 31 3.37. REP_GravaFuncionariosPorArquivo ................................................. 32
3.38. REP_AtualizaFirmware .......................................................................... 32 3.39. REP_EnviaAssinaturaFirmware .......................................................... 33
3.40. REP_MensagemErro .............................................................................. 34
1. Funcionamento da DLL Este documento possui todos os protótipos de função, de modo a tornar possível o uso da biblioteca. A partir desta, todo programa pode comunicar com os aparelhos R.E.P. REP_FUNCAO está definida como VOID (sem retorno), que será o padrão. Para observar erros na execução, o parâmetro pdwResult deve ser conferido
após a chamada da função. Ao final do documento pode ser encontrada uma lista dos possíveis valores de erro e seus significados. Tenha o cuidado de reservar memória suficiente para o uso de parâmetros de saída. Caso contrário, a biblioteca poderá escrever em regiões de memória indesejadas. Para mandar mensagem / conectar / desconectar de um terminal, deverá ser passado o valor de seu endereço IP via parâmetro sIP. Exemplo: "192.168.0.123", sempre terminando com um caracter nulo.
Para os comandos que utilizam ‘x’, sendo x qualquer valor ou caracter sempre mandar no formato ASCII. Exemplo: ‘2’ ou 0x32 Exemplo: ‘a’ ou 0x61
2. Arquivo de configuração para REP-G3 Diferentemente do REP-G1 e G2, o REP-G3 precisa do CPF do usuário, Masterkey e senha do equipamento para se comunicar. Sem essas informações, não é possível realizar a maior parte das funções de gravação disponíveis. Assim, caso o ambiente tenha um ou mais REP-G3 (até 32), é necessário criar um arquivo chamado “RepConfig.ini” que conterá as informações de cada REP e será lido pela DLL. O layout deste arquivo funciona da seguinte forma:
A primeira linha deve ser preenchida com o CPF do usuário, contendo 11 dígitos, ou com a string “G3”. Esta string serve como uma “Flag” para que em sistemas legados que não tenham mais REPs antigos (G1 e G2), possa ser possível conectar-se com REP-G3 sem ter que esperar 8 segundos devido a tentativa de conexão com os outros REPs.
DOCUMENTO TÉCNICO
RQ-130 Página: 3 / 36
GERTEC Revisão: 03 – 28/10/2016
Caso a primeira linha tenha sido preenchida com a “Flag”, a segunda deve conter o CPF.
A linha seguinte ao CPF deve conter a seguinte sequência de dados: NFR[17 caracteres],Mastekey[64 caracteres],Senha[máx 8, mín 4];
Caso exista mais de um REP-G3 a ser conectado, basta adicionar uma nova linha com as configurações do respectivo equipamento.
Abaixo, encontra-se um exemplo de arquivo de configuração para dois REPs: G3 12345678909 12345678901234567,F026079DBE237E23F2D0B9744CF2B00B35DC6E646EE3F08CC85CD361EABC05C7,12345; 00000000000000071,B23F1379EBCA6B4A68BFE8EECFD6B648080002AACB2702787E6584537879DB65,123456;
Assim que a DLL tentar abrir conexão com algum REP pela primeira vez, ela lerá este arquivo, guardará suas informações em RAM e criará um novo arquivo chamado “RepConfig.enc”. Este novo arquivo contém a “Flag” de REP-G3, caso o primeiro documento tiver, o CPF e um dado criptografado. Este dado corresponde às informações dos REPs do primeiro arquivo. Neste momento, não é mais necessário ter o arquivo “RepConfig.ini”, que contém as informações em aberto, no diretório da aplicação. Sempre, na primeira vez em que a DLL for abrir conexão com um REP e ela não encontrar o primeiro arquivo, ela buscará o arquivo criptografado para encontrar as configurações. Caso seja necessário adicionar um novo REP-G3 na rede, o arquivo .ini deverá ser modificado e posto no diretório da aplicação novamente. Sempre, a DLL enviará um comando de “GetNFR” para o IP correspondente, na primeira conexão com o mesmo, para associar seu NFR às configurações lidas do arquivo.
3. Funções
3.1. REP_Conexao_Simples
Estabelece / cancela conexão com determinado terminal. Possibilita a autenticação como administrador ou usuário de rede. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_Conexao_Simples ( BYTE * sIP, BYTE bAcao, DWORD * dwResult );
DOCUMENTO TÉCNICO
RQ-130 Página: 4 / 36
GERTEC Revisão: 03 – 28/10/2016
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bAcao – (BYTE [IN]) – Operação a ser realizada: o 0 – Finaliza conexão (se sIP = NULL, terminará todas as
conexões). o 1 – Pedido de entrada como usuário de rede o 2 – Finaliza sessão de administrador o 3 – Inicia modo administrador
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_Conexao_Simples("192.168.0.123", . 1, // Entrar como usuário de rede
. &dwResult); Observações: Para REP-G3, esta função demora mais de 8 segundos para ser executada, pois se, por acaso, tentar conectar diretamente com o REP-G3 e na verdade existir um REP-G2 ou G1 este endereço IP, este REP irá travar e deverá ser reiniciado. Portanto, a DLL tentará abrir conexão primeiramente com um REP-G1 ou G2 com 8 segundos para receber uma resposta dos mesmos. Caso a resposta não chegue, ela tentará conexão com um G3. Para casos de conexão com REP-G3, não interessa o valor de entrada do parâmetro “bAcao”, pois o REP não possui tipos de entrada.
3.2. REP_Conexao_Direta_G3 Estabelece conexão com determinado terminal de REP-G3. Utilizando esta função, a DLL não tentará abrir conexão com um REP-G1 ou G2 antes. Utilizado apenas para REP-G3.
Sintaxe C: REP_FUNCAO REP_Conexao_Direta_G3 ( BYTE * sIP, DWORD * dwResult );
Parâmetros:
DOCUMENTO TÉCNICO
RQ-130 Página: 5 / 36
GERTEC Revisão: 03 – 28/10/2016
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_Conexao_Direta_G3("192.168.0.123", . &dwResult); Observações: Não é aconselhável utilizar esta função em ambientes com diferentes versões de REP.
3.3. REP_ConexaoComPorta
Estabelece / cancela conexão com determinado terminal. Possibilita a autenticação como administrador ou usuário de rede. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_ConexaoComPorta ( BYTE * sIP, USHORT usPorta, BYTE bAcao, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
usPorta – (BYTE [IN]) – Porta de conexão do terminal
bAcao – (BYTE [IN]) – Operação a ser realizada: o 0 – Finaliza conexão (se sIP = NULL, terminará todas as
conexões). o 1 – Pedido de entrada como usuário de rede o 2 – Finaliza sessão de administrador o 3 – Inicia modo administrador
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
DOCUMENTO TÉCNICO
RQ-130 Página: 6 / 36
GERTEC Revisão: 03 – 28/10/2016
Exemplo:
REP_ConexaoComPorta("192.168.0.123", . 5220, // Porta . 1, // Entrar como usuário de rede . &dwResult);
Observações: Para REP-G3, esta função demora mais de 8 segundos para ser executada, pois se, por acaso, tentar conectar diretamente com o REP-G3 e na verdade existir um REP-G2 ou G1 com este endereço IP, este REP irá travar e deverá ser reiniciado. Portanto, a DLL tentará abrir conexão primeiramente com um REP-G1 ou G2 com 8 segundos para receber uma resposta dos mesmos. Caso a resposta não chegue, ela tentará conexão com um G3. Para casos de conexão com REP-G3, não interessa o valor de entrada do parâmetro “bAcao”, pois o REP não possui tipos de entrada.
3.4. REP_InfoTerminal
Leitura da informação de identificação geral do aparelho. Utilizado para REP-G1, G2 e G3. Esta função retorna o NFR do equipamento.
Sintaxe C: REP_FUNCAO REP_InfoTerminal ( BYTE * sIP, BYTE * sNome, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sNome – (BYTE * [OUT]) – Nome do terminal em formato ‘string’
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_InfoTerminal("192.168.0.123",
. sNome, // Leitura do nome do terminal
. &dwResult);
DOCUMENTO TÉCNICO
RQ-130 Página: 7 / 36
GERTEC Revisão: 03 – 28/10/2016
3.5. REP_Tempo
Lê ou grava data e horário no aparelho, de acordo com a operação pretendida. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_Tempo ( BYTE * sIP, BYTE bLeGrava, BYTE * bAno, BYTE * bMes, BYTE * bDia, BYTE * bHora, BYTE * bMinuto, BYTE * bSegundo, BYTE * bDiaSemana, DWORD * dwResult )
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bLeGrava – (BYTE [IN]) – Operação a ser realizada: o 0 – Leitura o 1 – Gravação
bAno – (BYTE * [IN/OUT]) – Valor do ano entre 0 (2000) e 255 (2255)
bMes – (BYTE * [IN/OUT]) – Valor do mês entre 1 (Janeiro) e 12 (Dezembro)
bDia – (BYTE * [IN/OUT]) – Valor do dia entre 1 e 31 dependendo do mês
bHora – (BYTE * [IN/OUT]) – Valor da hora entre 0 e 23
bMinuto – (BYTE * [IN/OUT]) – Valor do minuto entre 0 e 59
bSegundo – (BYTE * [IN/OUT]) – Valor do segundo entre 0 e 59
bDiaSemana – (BYTE * [IN/OUT]) – Dia da semana entre 1 e 7
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_Tempo("192.168.0.123",
.
0, // Leitura do nome do terminal &bAno &bMes &bDia &bHora &bMinuto &bSegundo &bDiaSemana
. &dwResult);
DOCUMENTO TÉCNICO
RQ-130 Página: 8 / 36
GERTEC Revisão: 03 – 28/10/2016
3.6. REP_LeTemperatura Lê a temperatura interna do aparelho. Utilizado apenas para REP-G1 e G2.
Sintaxe C:
REP_FUNCAO REP_LeTemperatura ( BYTE * sIP, BYTE * bTemperatura, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bTemperatura – (BYTE * [OUT]) – ‘string’ da temperatura atual do aparelho
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeTemperatura("192.168.0.123",
. &bTemperatura
. &dwResult);
Observações:
O REP-G3 não possui dispositivo para leitura de temperatura. Portanto, caso recebe esse comando, o retorno será comando obsoleto.
3.7. REP_Rede_Simples
Lê ou grava as opções de rede. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_Rede_Simples ( BYTE * sIP, BYTE bLeGrava, BYTE * sIPTerminal, BYTE * sIPMascara, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bLeGrava – (BYTE [IN]) – Operação a ser realizada:
DOCUMENTO TÉCNICO
RQ-130 Página: 9 / 36
GERTEC Revisão: 03 – 28/10/2016
o 0 – Leitura o 1 – Gravação
bIPTerminal – (BYTE * [IN/OUT]) – ‘string’ do endereço IP
bIPMascara – (BYTE * [IN/OUT]) – ‘string’ da máscara de rede
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_Rede_Simples("192.168.0.123", . 0, // Leitura dos dados . sIPTerminal, // Leitura do IP do terminal . sIPMascara, // Leitura da máscara de rede . &dwResult);
Observações:
Os endereços IP e a máscara devem estar no padrão "192.168.0.123". Para REP-G3 existe a função REP_ConfigRede que lê o IP, máscara, gateway e MAC, e grava todas elas menos o MAC. Esta função não funciona para REP-G1 ou G2.
3.8. REP_LeCadastro
Leitura de informações cadastradas no aparelho de acordo com filtro e parâmetro. As informações são salvas no arquivo com nome passado por parâmetro. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_LeCadastro ( BYTE * sIP, BYTE bFiltro, BYTE * sParametro, BYTE * sArquivoDados, DWORD * dwEncontrados, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bFiltro – (BYTE [IN]) – Operação a ser realizada: o 0 – Registro do empregador. Não possui parâmetro (NULL) o 1 – Todos os registros. Não possui parâmetro (NULL) o 4 – Todos os funcionários cadastrados. Não possui parâmetro
(NULL) o 5 – Todos os registros a partir de uma NSR. Com parâmetro
DOCUMENTO TÉCNICO
RQ-130 Página: 10 / 36
GERTEC Revisão: 03 – 28/10/2016
sParâmetro – (BYTE * [IN]) – ‘string’ da NSR. Exemplo: “512”
sArquivoDados – (BYTE * [IN]) – ‘string’ do nome do arquivo no qual as informações serão salvas (relativo ou absoluto)
dwEncontrados – (DWORD * [OUT]) – número de registros encontrados e salvos
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeCadastro("192.168.0.123", . 5, // A partir de uma NSR . "12345", //NSR . "C:\\Fabricante.txt", . &dwEncontrados, . &dwResult);
3.9. REP_LeIntervaloNSR
Leitura de informações cadastradas no aparelho através de um intervalo de NSR. As informações são salvas no arquivo com nome passado por parâmetro. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_LeIntervaloNSR ( BYTE * sIP, BYTE * sNSRInicial, BYTE * sNSRFinal, BYTE * sArquivoDados, DWORD * dwEncontrados, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sNSRInicial – (BYTE * [IN]) – ‘string’ da NSR inicial para busca
sNSRFinal – (BYTE * [IN]) – ‘string’ da NSR final para busca
sArquivoDados – (BYTE * [IN]) – ‘string’ do nome do arquivo no qual as informações serão salvas (relativo ou absoluto)
dwEncontrados – (DWORD * [OUT]) – número de registros encontrados e salvos
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
DOCUMENTO TÉCNICO
RQ-130 Página: 11 / 36
GERTEC Revisão: 03 – 28/10/2016
Others – Confira códigos de erro
Exemplo:
REP_LeIntervaloNSR("192.168.0.123", . "333", //NSR inicial . "10000", //NSR Final . "C:\\Fabricante.txt", . &dwEncontrados, . &dwResult);
3.10. REP_LeTipoReg Leitura do tipo de registro através de sua NSR. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_LeTipoReg ( BYTE * sIP, BYTE * sNSR, INT * iRecordType, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sNSR – (BYTE * [IN]) – ‘string’ da NSR para busca
iRecordType – (INT * [OUT]) – tipo de registro de ponto
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeTipoReg("192.168.0.123", . "123456", //NSR . iRecordType, . &dwResult);
3.11. REP_LeRegEmpregador
Leitura do cadastro de empregador. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
DOCUMENTO TÉCNICO
RQ-130 Página: 12 / 36
GERTEC Revisão: 03 – 28/10/2016
REP_FUNCAO REP_LeRegEmpregador ( BYTE * sIP, BYTE * sCNPJ_CPF, BYTE * sCEI, BYTE * sRazaoSocial, BYTE * sLocal, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sCNPJ_CPF – (BYTE * [OUT]) – CPF ou CNPJ do Empregador
sCEI – (BYTE * [OUT]) – CEI do Empregador
sRazaoSocial – (BYTE * [OUT]) – Razão social do Empregador
sLocal – (BYTE * [OUT]) – Endereço do Empregador
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeRegEmpregador("192.168.0.123", . sCNPJ_CPF, . sCEI, . sRazaoSocial, . sLocal, . &dwResult);
3.12. REP_LeRegPonto
Leitura dos dados de ponto através de uma NSR, retornando os dados do ponto. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_LeRegPonto ( BYTE * sIP, BYTE * sNSR, BYTE * sData, BYTE * sHora, BYTE * sMatricula, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sNSR – (BYTE * [IN]) – NSR para busca
sData – (BYTE * [OUT]) – Data do registro de ponto
sHora – (BYTE * [OUT]) – Hora do registro de ponto no formato HHMM
sMatricula – (BYTE * [OUT]) – Matrícula do funcionário que bateu o ponto
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
DOCUMENTO TÉCNICO
RQ-130 Página: 13 / 36
GERTEC Revisão: 03 – 28/10/2016
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeRegPonto("192.168.0.123", . "123456", //NSR . sData, . sHora, . sMatricula, . &dwResult);
3.13. REP_LeRegFuncionario
Leitura dos dados de cadastro de funcionário através de uma NSR, retornando os dados do registro. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_LeRegFuncionario ( BYTE * sIP, BYTE * sNSR, BYTE * sData, BYTE * sHora, BYTE * bOperacao, BYTE * sMatricula, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sNSR – (BYTE * [IN]) – NSR para busca
sData – (BYTE * [OUT]) – Data do registro de ponto
sHora – (BYTE * [OUT]) – Hora do registro de ponto no formato HHMM
bOperacao – (BYTE * [OUT]) – Operação realizada: inclusão “I”, alteração “A” e remoção “R”
sMatricula – (BYTE * [OUT]) – Matrícula do funcionário que bateu o ponto
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeRegFuncionario("192.168.0.123", . "123456", //NSR . sData, . sHora,
DOCUMENTO TÉCNICO
RQ-130 Página: 14 / 36
GERTEC Revisão: 03 – 28/10/2016
. bOperacao,
. sMatricula,
. &dwResult);
Observações:
Para o REP-G3, os registros de remoção de funcionários possuem a letra “E” (Exclusão) ao invés de “R” (Remoção).
3.14. REP_GravaCadastroEmpregador
Gravação das informações de cadastro do empregador no aparelho. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_GravaCadastroEmpregador ( BYTE * sIP, BYTE bAcao, BYTE bTipo, BYTE * sCPFCNPJ, BYTE * sCEI, BYTE * sRazaoNome, BYTE * sLocal, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bAcao – (BYTE [IN]) – Ação a ser feita: o ‘0’ – Grava cadastro o ‘1’ – Altera cadastro
bTipo – (BYTE [IN]) – Tipo de cadastro: o ‘1’ – CNPJ o ‘2’ – CPF
sCPFCNPJ – (BYTE * [IN]) – ‘string’ do CNPJ ou CPF da empresa em até 16 caracteres
sCEI – (BYTE * [IN]) – CEI da empresa com 12 caracteres
sRazaoNome – (BYTE * [IN]) – Nome da empresa de até 152 caracteres
sLocal – (BYTE * [IN]) – Endereço da empresa de até 100 caracteres
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_GravaCadastroEmpregador("192.168.0.123", . ‘0´, //Adiciona cadastro . ‘1´, //CNPJ . "44833604000194", . "123456789128",
DOCUMENTO TÉCNICO
RQ-130 Página: 15 / 36
GERTEC Revisão: 03 – 28/10/2016
. "Gertec",
. "Rua Guaicurus, 145",
. &dwResult);
3.15. REP_GravaCadastroFuncionario
Gravação das informações de cadastro de funcionário no aparelho. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_GravaCadastroFuncionario ( BYTE * sIP, BYTE bAcao, BYTE * sNome, BYTE * sMatricula, BYTE * vbContactless, BYTE * vbCodBarras, BYTE * vbTeclado, BYTE * vbBiometria, BYTE bGrupo, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bAcao – (BYTE [IN]) – Ação a ser feita: o ‘0’ – Adiciona cadastro o ‘1’ – Altera cadastro
sNome – (BYTE * [IN]) – Nome do funcionário
sMatricula – (BYTE * [IN]) – ‘string’ do PIS do funcionário
vbContactless – (BYTE * [IN]) – número do cartão RFID ou Mifare do funcionário em ‘string’ hexadecimal.
vbCodBarras – (BYTE * [IN]) – número do código de barras do funcionário no REP-G1 ou G2. Como o REP-G3 não possui leitor de código de barras, este campo é utilizado para envio do ID do funcionário.
vbTeclado – (BYTE * [IN]) – número de teclado do funcionário sendo apenas números com tamanho mínimo de 4 caracteres e máximo de 8.
vbBiometria – (BYTE * [IN]) – número da digital do funcionário em formato ‘string’ de até 8 bytes. Este parâmetro só é utilizado para REP-G1 ou G2. Para o REP-G3 é necessário utilizar a função “REP_GravaFinger”.
bGrupo – (BYTE [IN]) – Filtro por grupo de funcionários (1 byte). Este parâmetro é somente utilizado para REP-G1 ou G2.
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_GravaCadastroFuncionario("192.168.0.123", . ‘0´, // Adiciona cadastro
DOCUMENTO TÉCNICO
RQ-130 Página: 16 / 36
GERTEC Revisão: 03 – 28/10/2016
. "Jose dos Santos", //Nome
. "98765432103", //sMatricula
. "1111111111111111", //RFID
. "2222222222222222", //Código de Barras
. "33333333", //Teclado
. "44444444", // Biometria
. 255, //Grupo
. &dwResult);
Observações:
O REP-G3 não possui leitor de código de barras, não tem opção de pesquisa por grupo de funcionário e não cadastra biometria no momento de cadastro de funcionário. Assim, neste caso, o campo de código de barras é utilizado para o número de ID do funcionário, e os campos biometria e grupo podem ser completados como nulos para a função.
3.16. REP_ExcluiCadastroFuncionario
Exclusão de cadastro de funcionário no aparelho. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_ExcluiCadastroFuncionario ( BYTE * sIP, BYTE * sMatricula, DWORD dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sMatricula – (BYTE * [IN]) – ‘string’ do PIS do funcionário
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_ExcluiCadastroFuncionario("192.168.0.123",
. "98765432103", //sMatricula
. &dwResult);
3.17. REP_LeEspacoMemoria
DOCUMENTO TÉCNICO
RQ-130 Página: 17 / 36
GERTEC Revisão: 03 – 28/10/2016
Obtenção da memória utilizada e memória livre do terminal. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_LeEspacoMemoria ( BYTE * sIP, DWORD * dwMemUsada, DWORD * dwMemLivre, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
dwMemUsada – (BYTE * [OUT]) – Quantidade de memória utilizada em bytes
dwMemLivre – (BYTE * [OUT]) – Quantidade de memória disponível em bytes
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeEspacoMemoria("192.168.0.123", . &dwMemUsada, . &dwMemLivre, . &dwResult);
3.18. REP_LeNSR
Obtenção do Número Sequencial de Registro do terminal. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_LeNSR ( BYTE * sIP, BYTE * sNSR, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sNSR - (BYTE * [OUT]) – Atual número sequencial de registros em format ‘string’
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
DOCUMENTO TÉCNICO
RQ-130 Página: 18 / 36
GERTEC Revisão: 03 – 28/10/2016
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeNSR("192.168.0.123", . &sNSR, . &dwResult);
3.19. REP_StatusImpressora
Lê status da impressora do terminal. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_StatusImpressora ( BYTE * sIP, BYTE * sStatus, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sStatusImpressora - (BYTE * [OUT]) – ‘string’ do status atual da impressora
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_StatusImpressora("192.168.0.123", . sStatusImpressora, . &dwResult);
3.20. REP_LeFinger
Leitura de Fingers cadastrados no REP. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_LeFinger ( BYTE * sIP, DWORD * dwEncontrados, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
DOCUMENTO TÉCNICO
RQ-130 Página: 19 / 36
GERTEC Revisão: 03 – 28/10/2016
dwEncontrados - (BYTE * [OUT]) – número total de templates encontrados e salvos em arquivos
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeFinger("192.168.0.123", . &dwEncontrados, . &dwResult
3.21. REP_GravaFinger
Gravação de arquivo contendo o Finger do funcionário no REP. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_GravaFinger ( BYTE * sIP, BYTE * sArquivoDados, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sArquivoDados - (BYTE * [IN]) – nome do arquivo no qual os dados do finger serão lidos (relativo ou absoluto).
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_GravaFinger("192.168.0.123", . sArquivoDados, . &dwResult
Observações:
Para gravação de finger no REP-G1 ou G2, o nome do arquivo deve ser o PIS
DOCUMENTO TÉCNICO
RQ-130 Página: 20 / 36
GERTEC Revisão: 03 – 28/10/2016
do respectivo funcionário, como mostra o exemplo: “98765432103.rec”. Para o REP-G3, como cada funcionário pode ter até 10 templates, o nome do arquivo deve ser o PIS do funcionário e o número do seu finger, como mostra o exemplo: “98765432103_2.rec”.
3.22. REP_GravaFinger_Bytes
Gravação de vetor contendo o Finger do funcionário no REP. Utilizado para REP-G1, G2 e G3.
Sintaxe C: REP_FUNCAO REP_GravaFinger_Bytes ( BYTE * sIP, BYTE * sMatricula, BYTE * pbFPTemplate, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sMatricula - (BYTE * [IN]) – PIS do funcionário
pbFPTemplate - (BYTE * [IN]) – Dados do template padrão Nitgen (404 bytes)
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_GravaFinger_Bytes("192.168.0.123", . "98765432103", . pbFPTemplate, . &dwResult
Observações:
Esta função funciona apenas para o padrão Nitgen com vetor de 404 bytes. Como o REP-G3 pode ter o modelo Nitgen ou Fingerprints, esta função não funciona nele.
3.23. REP_FormataFinger
Formata toda a memória finger. Utilizado apenas para REP-G1, G2.
Sintaxe C:
DOCUMENTO TÉCNICO
RQ-130 Página: 21 / 36
GERTEC Revisão: 03 – 28/10/2016
REP_FUNCAO REP_FormataFinger ( BYTE * sIP, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_FormataFinger("192.168.0.123", . &dwResult);
Observações:
Esta função funciona apenas para REP-G1 ou G2.
3.24. REP_RemoverFingerID
Remove o Finger cadastrado no REP de um funcionário, através de seu PIS. Utilizado apenas para REP-G1, G2.
Sintaxe C:
REP_FUNCAO REP_RemoverFingerID ( BYTE * sIP, BYTE * sMatricula, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sMatricula - (BYTE * [IN]) – PIS do funcionário
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_RemoverFingerID("192.168.0.123", . "98765432103",
DOCUMENTO TÉCNICO
RQ-130 Página: 22 / 36
GERTEC Revisão: 03 – 28/10/2016
. &dwResult
Observações:
Esta função funciona apenas para REP-G1 ou G2.
3.25. REP_LeFingerID
Lê o Finger cadastrado no REP de um funcionário, através da Matrícula e grava em um arquivo. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_LeFingerID ( BYTE * sIP, BYTE * sMatricula, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sMatricula - (BYTE * [IN]) – PIS do funcionário
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeFingerID("192.168.0.123", . "98765432103", . &dwResult);
3.26. REP_LeFingerID_Bytes
Lê o Finger cadastrado no REP de um funcionário, através da Matrícula e retorna os dados em um vetor. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_LeFingerID_Bytes ( BYTE * sIP, BYTE * sMatricula, BYTE * pbFPTemplate, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sMatricula - (BYTE * [IN]) – PIS do funcionário
pbFP - (BYTE * [OUT]) – Bytes do template
DOCUMENTO TÉCNICO
RQ-130 Página: 23 / 36
GERTEC Revisão: 03 – 28/10/2016
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeFingerID_Bytes("192.168.0.123", . "98765432103", . pbFPTemplate, . &dwResult);
Observações:
Para o REP-G1 e G2, esta função sempre retorna o vetor de biometria do funcionário com os 404 bytes de um template da Nitgen. Para o REP-G3, esta função retornará a última biometria cadastrada para funcionário. O template possui 404 bytes para biometria Nitgen (ótico) e 938 bytes para biometria Fingerprints (capacitivo).
3.27. REP_LeFingerIDEspecifico_Bytes Lê o Finger cadastrado no REP através do seu ID. Utilizado apenas para REP-G3.
Sintaxe C:
REP_FUNCAO REP_LeFingerIDEspecifico_Bytes ( BYTE * sIP, BYTE * sID, BYTE * pbFPTemplate, DWORD * dwTamanhoTemplate, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sID - (BYTE * [IN]) – ID do template em formato ‘string’
pbFPTemplate - (BYTE * [OUT]) – Bytes do template. 404 bytes para Nitgen (ótico) e 938 bytes para Fingerprints (capacitivo)
dwTamanhoTemplate – (DWORD * [OUT]) – Tamanho do template retornado. 404 bytes para Nitgen (ótico) e 938 bytes para Fingerprints (capacitivo)
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
DOCUMENTO TÉCNICO
RQ-130 Página: 24 / 36
GERTEC Revisão: 03 – 28/10/2016
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeFingerIDEspecifico_Bytes("192.168.0.123", . "105", . pbFPTemplate, dwTamanhoTemplate . &dwResult);
Observações:
Não implementado para REP-G1 e G2. Caso seja enviado o retorno será “1021” (erro operação sem sucesso). Este comando foi criado devido à integração com a Senior.
3.28. REP_LeFingersIdsPis Lê os IDs dos templates do funcionário através do seu PIS. Utilizado apenas para REP-G3.
Sintaxe C:
REP_FUNCAO REP_LeFingersIdsPis ( BYTE * sIP, BYTE * sPIS, BYTE * sTemplatedId, DWORD * dwQuantidade, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sPIS - (BYTE * [IN]) – PIS do funcionário
sTemplatesId - (BYTE * [OUT]) – string contendo os números dos templates do funcionário. O número de cada template estará separado por “/”. Exemplo de funcionário com 3 templates: sTemplateId = “125/168/201”
dwQuantidade – (DWORD * [OUT]) – Quantidade de IDs encontrados
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeFingersIdsPis ("192.168.0.123",
DOCUMENTO TÉCNICO
RQ-130 Página: 25 / 36
GERTEC Revisão: 03 – 28/10/2016
. "98765432103",
. sTemplatesId, &dwQuantidade, . &dwResult);
Observações:
Não implementado para REP-G1 e G2. Caso seja enviado o retorno será “1021” (erro operação sem sucesso). Este comando foi criado devido à integração com a Senior.
3.29. REP_Versao
Lê as versões de Finger Print, MB e MM do equipamento. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_Versao ( BYTE * sIP, BYTE * sVersionMB, BYTE * sVersionMM, BYTE * sModuleFP, BYTE * sVersionFP, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sVersaoMB - (BYTE * [OUT]) – Versão da MB em formato ‘string’
sVersaoMM - (BYTE * [OUT]) – Versão da MM em formato ‘string’
sModuloFP - (BYTE * [OUT]) – Módulo da Nitgen em formato ‘string’
sVersaoFP - (BYTE * [OUT]) – Versão da Nitgen em formato ‘string’
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_Versao("192.168.0.123", . sVersaoMB, . sVersaoMM, . sModuloFP, . sVersaoFP, . &dwResult);
Observações:
DOCUMENTO TÉCNICO
RQ-130 Página: 26 / 36
GERTEC Revisão: 03 – 28/10/2016
Para o REP-G3, a única versão que será retornada é a versão da MM, os outros parâmetros retornarão zerados.
3.30. REP_StatusBateria
Lê status da bateria do terminal. Utilizado somente para REP-G3.
Sintaxe C: REP_FUNCAO REP_StatusBateria ( BYTE * sIP, BYTE * sStatusBateria, DWORD * pdwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sStatusBateria - (BYTE * [OUT]) – ‘string’ do status atual da bateria
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_StatusBateria("192.168.0.123", . sStatusBateria,
. &dwResult);
Observações:
Como REP-G1 e G2 não possuem bateria, esta função não funciona para eles.
3.31. REP_ConfigRede
Lê ou grava as configurações de rede. Utilizado somente para REP-G3.
Sintaxe C:
REP_FUNCAO REP_ConfigRede ( BYTE * sIP, BYTE bLeGrava, BYTE * sIPTerminal, BYTE * sIPMascara, BYTE * sIPGateway, BYTE * sMAC, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bLeGrava – (BYTE [IN]) – Operação a ser realizada:
DOCUMENTO TÉCNICO
RQ-130 Página: 27 / 36
GERTEC Revisão: 03 – 28/10/2016
o 0 – Leitura o 1 – Gravação
sIPTerminal – (BYTE * [IN/OUT]) – ‘string’ do endereço IP
sIPMascara – (BYTE * [IN/OUT]) – ‘string’ da máscara de rede
sIPGateway – (BYTE * [IN/OUT]) – ‘string’ do gateway de rede
sMAC – (BYTE * [OUT]) – ‘string’ do MAC do equipamento
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_ConfigRede("192.168.0.123", . 0, // Leitura dos dados . sIPTerminal, // Leitura do IP do terminal . sIPMascara, // Leitura da máscara de rede . sIPGateway, // Leitura do gateway . sMAC, // Leitura do mac . &dwResult);
Observações:
Esta função funciona apenas para REP-G3. O parâmetro do número MAC só pode ser lido, nunca gravado.
3.32. REP_WifiConfig
Lê ou grava as configurações de rede Wi-Fi. Utilizado somente para REP-G3.
Sintaxe C:
REP_FUNCAO REP_WifiConfig ( BYTE * sIP, BYTE bLeGrava, BYTE * sSSID, BYTE * bSecurity, BYTE * sKey, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bLeGrava – (BYTE [IN]) – Operação a ser realizada: o 0 – Leitura o 1 – Gravação
sSSID – (BYTE * [IN/OUT]) – ‘string’ do SSID da rede Wi-Fi
bSecurity – (BYTE * [IN/OUT]) –tipo de segurança da rede Wi-Fi podendo ser:
DOCUMENTO TÉCNICO
RQ-130 Página: 28 / 36
GERTEC Revisão: 03 – 28/10/2016
o 0 - “NONE”, nenhuma o 1 - “WEP64” o 2 - “WEP128” o 3 - “WPA” o 4 - “WPA2” o 5 - “MIXED”
sKey – (BYTE * [IN/OUT]) – ‘string’ da chave da rede Wi-Fi
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_WifiConfig("192.168.0.123", . 0, // Leitura dos dados . sSSID, // Leitura do SSID de rede . bSecurity, // Leitura do tipo de segurança . sKey, // Leitura da chave . &dwResult);
Observações:
Esta função funciona apenas para REP-G3 pois não existe modelo de REP-G1 ou G2 com Wi-Fi.
3.33. REP_InterfaceRede
Lê ou altera a interface de rede do terminal. Utilizado somente para REP-G3.
Sintaxe C:
REP_FUNCAO REP_InterfaceRede ( BYTE * sIP, BYTE bLeGrava, BYTE * bInterface, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bLeGrava – (BYTE [IN]) – Operação a ser realizada: o 0 – Leitura o 1 – Gravação
bInterface – (BYTE * [IN/OUT]) – Interface de rede do terminal, sendo: o 0 – Ethernet o 1 – Wi-Fi
DOCUMENTO TÉCNICO
RQ-130 Página: 29 / 36
GERTEC Revisão: 03 – 28/10/2016
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_InterfaceRede("192.168.0.123", . 0, // Leitura dos dados . &bInterface, // Interface de rede . &dwResult);
Observações:
Esta função funciona apenas para REP-G3 pois não existe modelo de REP-G1 ou G2 com Wi-Fi.
3.34. REP_GravaNovaSenha
Grava nova senha no terminal. Utilizado somente para REP-G3.
Sintaxe C:
REP_FUNCAO REP_GravaNovaSenha ( BYTE * sIP, BYTE * sNewPassword, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
sNewPassword – (BYTE * [IN]) – ‘string’ da nova senha do menu do REP-G3 com no máximo 8 caracteres de tamanho
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro Exemplo:
REP_GravaNovaSenha("192.168.0.123", . “1234”, // nova senha . &dwResult);
DOCUMENTO TÉCNICO
RQ-130 Página: 30 / 36
GERTEC Revisão: 03 – 28/10/2016
Observações:
Esta função funciona apenas para REP-G3.
3.35. REP_LeFuncionario
Lê funcionário pelo PIS, ID, teclado, contactless ou biometria. Utilizado somente para REP-G3.
Sintaxe C:
REP_FUNCAO REP_LeFuncionario ( BYTE * sIP, BYTE bSearchType, BYTE * bDataToSearch, BYTE * sName, BYTE * sPis, BYTE * sContactless, BYTE * sKeyboard, BYTE * sId, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bSearchType – (BYTE [IN]) – Tipo de busca: o 0 – PIS o 1 – ID o 2 – Teclado o 3 – Contactless o 4 – Biometria
sDataToSearch – (BYTE * [IN]) – informação de acordo com o tipo de busca
sName – (BYTE * [OUT]) – nome do funcionário
sPis – (BYTE * [OUT]) – PIS do funcionário
sContactless – (BYTE * [OUT]) – número do cartão contactless do funcionário
sKeyboard – (BYTE * [OUT]) – número do teclado do funcionário
sId – (BYTE * [OUT]) – número do ID do funcionário
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeFuncionario("192.168.0.123", . 2, // Leitura por teclado . “111”, // Dado de teclado . &sName, // Nome . &sPis, // PIS . &sContactless, // Número do cartão contactless . &sKeyboard, // Número do teclado
DOCUMENTO TÉCNICO
RQ-130 Página: 31 / 36
GERTEC Revisão: 03 – 28/10/2016
. &sId, // ID
. &dwResult);
Observações:
Esta função funciona apenas para REP-G3.
3.36. REP_LeStatusMemoriaTrabalho
Lê status da memória de trabalho do equipamento. Utilizado somente para REP-G3.
Sintaxe C:
REP_FUNCAO REP_LeStatusMemoriaTrabalho ( BYTE * sIP, DWORD * dwEnrolledEmployees, DWORD * dwFreeEmployees, DWORD * dwAvailableMemory, BOOL * boEnrolledEmployer, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
dwEnrolledEmployees – (DWORD * [OUT]) – número de funcionários cadastrados
dwFreeEmployees – (DWORD * [OUT]) – número de funcionários disponíveis para cadastro
dwAvailableMemory – (DWORD * [OUT]) – tamanho de memória disponível
boEnrolledEmployer – (BOOL * [OUT]) – indicação de empregador cadastrado ou não
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_LeStatusMemoriaTrabalho("192.168.0.123", &dwEnrolledEmployees, // funcionários cadastrados
. &dwFreeEmployees, // funcionários disponíveis
. &dwAvailableMemory, // memória disponível
. &boEnrolledEmployer, // empregador cadastrado
. &dwResult);
Observações:
DOCUMENTO TÉCNICO
RQ-130 Página: 32 / 36
GERTEC Revisão: 03 – 28/10/2016
Esta função funciona apenas para REP-G3.
3.37. REP_GravaFuncionariosPorArquivo
Grava funcionários no terminal utilizando arquivo. Utilizado somente para REP-G3.
Sintaxe C:
REP_FUNCAO REP_GravaFuncionariosPorArquivo ( BYTE * sIP, , BYTE * bpFileName, DWORD * dwEmployeesCounter, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bpFileName – (BYTE * [IN]) – nome do arquivo que contêm os funcionários a serem cadastrados (absoluto ou relativo)
dwEmployeesCounter – (DWORD * [OUT]) – número de funcionários lidos do arquivo e efetivamente cadastrados
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_GravaFuncionariosPorArquivo("192.168.0.123", &bpFileName, // nome do arquivo
. &dwEmployeesCounter, // funcionários cadastrados
. &dwResult);
Observações:
Esta função funciona apenas para REP-G3. Caso não seja possível cadastrar algum dos funcionários, por exemplo, por causa que já existe um funcionário cadastrado com o mesmo número de teclado, a gravação não será interrompida.
3.38. REP_AtualizaFirmware
Atualiza firmware do equipamento enviando dados de um arquivo. Utilizado somente para REP-G3.
Sintaxe C:
DOCUMENTO TÉCNICO
RQ-130 Página: 33 / 36
GERTEC Revisão: 03 – 28/10/2016
REP_FUNCAO REP_AtualizaFirmware ( BYTE * sIP, , BYTE * bpFileName, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bpFileName – (BYTE * [IN]) – nome do arquivo que contêm o novo firmware (absoluto ou relativo)
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_AtualizaFirmware("192.168.0.123", &bpFileName, // nome do arquivo
. &dwResult);
Observações:
Esta função funciona apenas para REP-G3.
Para a atualização ocorrer efetivamente, é necessário enviar a assinatura do firmware utilizando a função “REP_EnviaAssinaturaFirmware” e, caso a assinatura esteja correta, desligar e ligar o REP.
3.39. REP_EnviaAssinaturaFirmware
Envia assinatura de firmware de atualização do equipamento utilizando dados de um arquivo. Utilizado somente para REP-G3.
Sintaxe C:
REP_FUNCAO REP_EnviaAssinaturaFirmware ( BYTE * sIP, , BYTE * bpFileName, DWORD * dwResult );
Parâmetros:
sIP – (BYTE * [IN]) – IP do terminal em formato ‘string’
bpFileName – (BYTE * [IN]) – nome do arquivo que contêm a assinatura (absoluto ou relativo)
dwResult – (DWORD * [OUT]) – Resultado da operação. Ver ‘Valor de Retorno’
DOCUMENTO TÉCNICO
RQ-130 Página: 34 / 36
GERTEC Revisão: 03 – 28/10/2016
Valor de Retorno:
OK – Sucesso na operação
Others – Confira códigos de erro
Exemplo:
REP_EnviaAssinaturaFirmware("192.168.0.123", &bpFileName, // nome do arquivo
. &dwResult);
Observações:
Esta função funciona apenas para REP-G3.
Para a atualização ocorrer efetivamente, é necessário desligar e ligar o REP.
3.40. REP_MensagemErro Obtenção da mensagem de erro referente ao valor de retorno pdwResult. Utilizado para REP-G1, G2 e G3.
Sintaxe C:
REP_FUNCAO REP_MensagemErro ( DWORD dwResult, BYTE * sMensagemErro );
Parâmetros:
dwResult – (DWORD [IN]) – Código de erro
sMensagemErro – (BYTE * [OUT]) – mensagem de erro referente ao código
Exemplo:
REP_MensagemErro(1,sMsgErro);
4. Retorno das funções
Código Símbolo Descrição
0 REP_OK Realizada com sucesso
1021 ERRO_OPERACAO_SEM_SUCESSO Realizada sem sucesso
1022 ERRO_RESPOSTA_DESCONHECIDA Resposta do REP desconhecida
1023 MRP_EM_USO MRP alocada em outro processo
1030 ERRO_MANIPULAR_ARQUIVO Erro na estrutura de dados do arquivo ou arquivo não encontrado
DOCUMENTO TÉCNICO
RQ-130 Página: 35 / 36
GERTEC Revisão: 03 – 28/10/2016
1031 ERRO_FILTRO_NAO_EXECUTADO Mensagem de filtro não executada
1032 NÃO_MARCACAO_PONTO O registro não é um ponto
2000 ERRO_NOME_EMPREGADOR_INVALIDO Empregador com caracteres incorretos
2001 ERRO_LOCAL_EMPREGADOR_INVALIDO Local com caracteres incorretos
2002 ERRO_CNPJ_INVALIDO CNPJ com caracter inválido
2003 ERRO_CEI_INVALIDO CEI com caracter inválido
2004 ERRO_FINGER_INVALIDO Finger com caracter inválido
2010 ERRO_TAM_NOME_EMPREGADOR_INVALIDO Tamanho do nome do empregador incorreto
2011 ERRO_TAM_LOCAL_EMPREGADOR_INVALIDO Tamanho do nome do local incorreto
2012 ERRO_TAM_CNPJ_INVALIDO CNPJ com tamanho incorreto
2013 ERRO_TAM_CEI_INVALIDO CEI com tamanho incorreto
2014 ERRO_TAM_FINGER_INVALIDO Finger com tamanho incorreto
2020 ERRO_EMPREGADOR_JA_CADASTRADO Empregador já cadastrado
2021 ERRO_EMPREGADOR_NAO_CADASTRADO Empregador não cadastrado
3000 ERRO_NOME_FUNCIONARIO_INVALIDO Nome do funcionário com caracter inválido
3001 ERRO_PIS_INVALIDO PIS com caracter inválido
3002 ERRO_CONTACTLESS_INVALIDO Contactless com caracter inválido
3003 ERRO_CODIGO_BARRAS_INVALIDO Código de barras com caracter inválido
3004 ERRO_TECLADO_INVALIDO Teclado com caracter inválido
3005 ERRO_BIOMETRIA_INVALIDO Biometria com caracter inválido
3006 ERRO_ID_INVALIDO ID com caracter inválido
3010 ERRO_TAM_NOME_FUNCIONARIO_INVALIDO Nome do funcionário com tamanho inválido
3011 ERRO_TAM_PIS_INVALIDO PIS com tamanho inválido
3012 ERRO_TAM_CONTACTLESS_INVALIDO Contactless com tamanho inválido
3013 ERRO_TAM_CODIGO_BARRAS_INVALIDO Código de barras com tamanho inválido
3014 ERRO_TAM_TECLADO_INVALIDO Teclado com tamanho inválido
3015 ERRO_TAM_BIOMETRIA_INVALIDO Biometria com tamanho inválido
3016 ERRO_TAM_ID_INVALIDO ID com tamanho inválido
3021 ERRO_PIS_JA_CADASTRADO PIS já cadastrado
3022 ERRO_CONTACTLESS_JA_CADASTRADO Contactless já cadastrado
3023 ERRO_CODIGO_BARRAS_JA_CADASTRADO Código de barras já cadastrado
3024 ERRO_TECLADO_JA_CADASTRADO Teclado já cadastrado
3025 ERRO_BIOMETRIA_JA_CADASTRADO Biometria já cadastrada
3030 ERRO_FUNCIONARIO_NAO_CADASTRADO Funcionário não cadastrado
3031 ERRO_PIS_NAO_ENCONTRADO PIS não encontrado
3101 ERRO_FINGER_HEADER_INVALIDO Cabeçalho do finger inválido
DOCUMENTO TÉCNICO
RQ-130 Página: 36 / 36
GERTEC Revisão: 03 – 28/10/2016
3102 ERRO_FINGER_RESERVADO_INVALIDO Byte inválido
3103 ERRO_FINGER_FPID_INVALIDO FPID inválido
3104 ERRO_FINGER_RESERVED_INVALIDO Byte reserved inválido
3105 ERRO_FINGER_SIZE_MSB_INVALIDO Tamanho do byte mais significativo inválido
3106 ERRO_FINGER_SIZE_LSB_INVALIDO Tamanho do byte menos significativo inválido
3107 ERRO_FINGER_RESERVED3_INVALIDO Reserved3 inválido
3108 ERRO_FINGER_TEMPLATE_INVALIDO Template inválido
3200 ERRO_AFD_TAM_DADOS_INCORRETO Tamanho dos dados da AFD incorreto
3201 ERRO_AFD_TIPO_REGISTRO_INCORRETO Registro de AFD incorreto
3300 ERRO_CPF_INVALIDO CPF com caracter inválido
3301 ERRO_TAM_CPF_INVALIDO CPF com tamanho inválido
3400 ERRO_NFR_INVALIDO NFR com caracter inválido
3401 ERRO_TAM_NFR_INVALIDO NFR com tamanho inválido
3500 ERRO_MASTERKEY_INVALIDO Masterkey com caracter inválido
3501 ERRO_TAM_MASTERKEY_INVALIDO Masterkey com tamanho inválido
3600 ERRO_TAM_SSID_INVALIDO SSID com tamanho inválido
3601 ERRO_TAM_KEY_INVALIDO Chave Wi-fi com tamanho inválido
3602 ERRO_SEGURANCA_INVALIDO Parâmetro de segurança inválido
4000 ERRO_DIA_INVALIDO Dia incorreto
4001 ERRO_MES_INVALIDO Mês incorreto
4002 ERRO_ANO_INVALIDO Ano incorreto
4010 ERRO_HORA_INVALIDA Hora incorreto
4011 ERRO_MINUTO_INVALIDO Minuto incorreto
4012 ERRO_SEGUNDO_INVALIDO Segundo incorreto
4020 ERRO_DIA_SEMANA_INVALIDO Dia da semana incorreto
4050 ERRO_SENHA_INVALIDA Senha com caracter inválido
4051 ERRO_TAM_SENHA_INVALIDA Senha com tamanho inválido
4090 ERRO_TIPO_ACAO_FILTRO_INVALIDO Tipo de filtro inválido
4095 ERRO_TAM_NSR_INVALIDO Tamanho do NSR inválido
4096 ERRO_NSR_INVALIDO NSR com caracter inválido
4100 ERRO_FINGER_NAO_CADASTRADO Finger não cadastrado
4101 ERRO_FINGER_EM_USO Módulo finger em uso
5000 ERRO_MEMORIA_CHEIA Memória cheia
5001 ERRO_GRAVACAO_REGISTRO Erro ao gravar registro
10005 ERRO_IP_JA_CONECTADO IP já conectado
10031 ERRO_INVALID_IP IP inválido
10032 ERRO_INVALID_IP_MASK Máscara IP inválida
10033 ERRO_INVALID_PORT Porta inválida
10034 ERRO_INVALID_GATEWAY Gateway inválido
Recommended