Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicoprgfin/acr/acr540za

 

Considerações Gerais

 

Objetivo

...

A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.

 

Tabelas Temporárias

 

Nos atributos das tabelas temporárias de entrada e saída: 

tt_log_erro

Entrada/Saída

Tabela temporária para retorno de erros na execução da transação TEF

Saída

Atributo

Tipo

Formato

Descrição

Obrigatório

Evolução

ttv_num_cod_erro

integer

">>>>,>>9"

Código do erro

Sim

 

ttv_des_msg_ajuda

character

"x(40)"

Mensagem de ajuda.

Sim

 

ttv_des_msg_erro

character

"x(60)"

Mensagem de erro.

Sim

 

 

Método Básico

 

Quando a API for executada em modo persistente, os seguintes métodos estarão disponíveis para execução: 

pi_envia_req_vda_tef

Requisito

REQ 1376 - Controle de caixa - Integração com leitora de cartão

Sintaxe

run pi_envia_req_vda_tef in h-handle  (input  param p_cod_empresa_tef ,

  input  param p_cod_operac_admdra , 

  input  param p_cod_usuar,          

  input  param p_cdn_tip_parcto,     

  input  param p_idi_forma_pag,     

  input  param p_num_parc_pag,       

  input  param p_val_trans_tef,      

  output param p_cdd_trans_seq,      

  output param p_nom_mensagem_tef,   

  output param p_nom_arquivo_retorno,

  output param table for tt_log_erro).

Descrição

Requisição de venda via leitora de cartão – Tecnologia TEF (Transferência Eletrônica de Fundos)

Parâmetros

Descrição

p_cod_empresa_tef

Código da empresa corrente.

p_cod_operac_admdra 

Tipo de operação, de acordo com manual do Aplicativo. Ex.: (CRT).

p_cod_usuar         

Código do usuário do módulo.

p_cdn_tip_parcto    

Tipo de parcelamento, de acordo com manual do Aplicativo. Ex.: 0 = Estab.

p_idi_forma_pag     

Forma de Pagto TEF. Crédito ou Débito de acordo com a transação.

p_num_parc_pag      

Número de parcelas da transação TEF.

p_val_trans_tef     

Valor da transação TEF.

p_cdd_trans_seq      

Número sequencial gerado para a transação.

p_nom_mensagem_tef  

Mensagem para o Operador.

p_nom_arquivo_retorno

Caminho e nome do arquivo gerado com a imagem do cupom.

table for tt_log_erro

Tabela temporária com retorno de erros da API.

Retorno

A API irá retornar o número da transação, que será  gerado no parâmetro “p_cdd_trans_tef”, o qual será utilizado na chamada do método “pi_envia_cnf_ncn_vda_tef” para confirmação da venda; O campo “p_nom_mensagem_tef” é somente orientativo, para que o Operador possa saber que a transação teve sucesso; Está API gera o recibo de transação em diretório específico, portanto devolve o caminho e o nome do arquivo gerado no parâmetro “p_nom_arquivo_retorno”; Os motivos para a rejeição da solicitação de venda são especificados na temp-table tt_erro_log. As mensagens possíveis para esse método são:

21.368 - Transações TEF não autorizadas.

21.369 - Usuário(a) sem permissão para transações TEF.

21.372 - Diretório de integração não foi localizado.

21.376 - Falta parâmetros para este procedimento.

21.379 - Arquivo de transação não foi gerado.

21.380 - Houve erro no tratamento do arquivo gerado.

21.381 - Sistema não respondeu a solicitação de transação TEF.

21.382 - Arquivo de Confirmação foi gerado com erro.

21.383 - Arquivo de resposta foi gerado com erro.

21.384 - Mensagem TEF: &1 = ex: Cartão não autorizado.

21.396 - Parâmetros do TEF não foi localizado.

21.397 - Usuário do Controle de Caixa não localizado.

21.400 - Registro &1 = (nome da tabela) não foi localizado.

...