Funções de Pinpad

Estas funções são destinadas para que a automação obtenha dados sobre o dispositivo que está sendo utilizado, se o mesmo está conectado e funcionando corretamente.

Verificar Status do Pinpad#

Esta função retorna 0 se o pinpad estiver conectado e funcional e retorna 1 se ocorrer algum erro no processo de comunicação ou exista algum defeito. Um efeito adicional desta função é a limpeza da tela, após sua execução será exibida a mensagem configurada no CliMC.ini.

Uma forma alternativa para verificar o status é através da função IniciaFuncaoMCInterativo utilizando o código de operação 806; o comportamento será semelhante ao fluxo normal de transação, e não sendo necessário chamar a função FinalizaFuncaoMCInterativo. Os parâmetros cupom, e nsu podem ser fictícios.

Este modo retorna uma string para indicar o status do Pinpad, a seguir estão os possíveis retornos:

Observação: A utilização da função direta VerificarPinpad requer que o PDV esteja previamente inicializado e configurado. Caso contrário, recomenda-se iniciar a partir da operação 806, que realiza automaticamente o processo de configuração. Ressalta-se que há uma diferença no tempo de execução entre as duas abordagens (podendo variar em alguns segundos). Recomenda-se avaliar qual opção é mais adequada ao fluxo e desempenho esperado pela sua automação.

  int VerificarPinPad()

Obter Informações do Pinpad#

Esta função retorna as informações sobre o pinpad que está em utilização. O retorno ocorre no seguinte formato:

  int InformacoesPinPad()

  [RETORNO]#FABRICANTE=GERTEC|VHARDWARE=PPC-930;192MB|
  VFIRMWARE=1400.11808.VR1015@|VESPEC=2.12|VAPLIC=002.14 00921|NUMSERIE=7200000000001234

Caso ocorra algum erro durante a execução, ou falha de comunicação será retornada uma string contendo a tag [ERROABORTAR] junto com o erro ocorrido.

Uma forma alternativa para obter as informações do Pin Pad é através da função IniciaFuncaoMCInterativo utilizando o código de operação 807; o comportamento será semelhante ao fluxo normal de transação, e não sendo necessário chamar a função FinalizaFuncaoMCInterativo. Os parâmetros cupom, e nsu podem ser fictícios. O retorno desta forma é o mesmo da função direta.

Observação: Ao utilizar a função direta InformacoesPinPad é necessário que o PDV tenha sido inicializado/configurado, utilizando a partir da operação 807, a função realizará este processo de configuração. Existe diferença no tempo de execução das duas formas (alguns segundos), verifique qual melhor será a mais adequada para sua automação.

Atualizar Tabelas do Pinpad#

Durante o uso diário do TEF, a atualização das tabelas do Pinpad ocorre automaticamente na primeira transação do dia, sendo um processo essencial para o funcionamento adequado do sistema. A quantidade de tabelas a serem atualizadas depende do número de bandeiras aceitas pelo estabelecimento, e o tempo necessário para essa atualização no Pinpad está diretamente relacionado a essa quantidade.

Para realizar a atualização das tabelas fora do fluxo de transação, existe a função “Atualizar Tabelas”. Os possíveis retornos desta função são: [RETORNO]#SUCESSO ou [RETORNO]#FALHA.

Esta função possui duas opções de execução que são escolhidas através do parâmetro iLimpaTb. Com o valor 0, é realizada a limpeza de tabelas e em seguida a atualização; com o valor 1 é realizada apenas a atualização das tabelas. No caso de utilizar outros valores será retornado o erro código 51.

  BSTR AtualizarTabelas (string sCnpjCliente, string sCodigoLoja, string sNumeroPDV, int iLimpaTb)

Limpar Tabelas do Pinpad#

Uma alternativa para realizar a limpeza de tabelas fora do processo iterativo, é através função direta “LimparTabelas”. Os retornos são os mesmos da operação existente [RETORNO]#SUCESSO ou [RETORNO]#FALHA.

  BSTR LimparTabelas (string sCnpjCliente, string sCodigoLoja, string sNumeroPDV)