Histórico da Página
...
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | prgfin/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. |
...