ESPECIFICAÇÃO TÉCNICA PARA INTEGRAÇÃO COM SISTEMAS DE AUTOMAÇÃO

Transcrição

1 D-TEF MÓDULO D-POS ESPECIFICAÇÃO TÉCNICA PARA INTEGRAÇÃO COM SISTEMAS DE AUTOMAÇÃO DIREÇÃO PROCESSAMENTO DE DADOS LTDA Criado em 04/07/2002 Última atualização em 27/03/2013 Versão 6.15 Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 1/95

2 SUMÁRIO 1 INTRODUÇÃO CONVENÇÕES UTILIZADAS NESTE MANUAL TEF DEDICADO INTEGRAÇÃO POR BIBLIOTECA DE FUNÇÕES (Windows ou Linux) FLUXO EXEMPLO PARA INTEGRAÇÃO POR FUNÇÕES COMUNICAÇÃO DO SISTEMA D-TEF COM O SISTEMA DE AUTOMAÇÃO TRANSAÇÕES SOLICITAÇÃO CARTÕES DE CRÉDITO/DÉBITO/VOUCHER/CREDIÁRIO FUNÇÕES ESPECÍFICAS (Especificação Redecard/Cielo/Banrisul) FUNÇÕES DE VENDA PBM (Pharmacy Benefit Management) SOLICITAÇÃO CARTÃO DE CRÉDITO COMPLETA SOLICITAÇÃO CARTÃO DE DEBITO COMPLETA SOLICITAÇÃO CARTÃO VOUCHER COMPLETA SOLICITAÇÃO CARTÃO CREDIÁRIO COMPLETA CONFIRMAÇÃO CARTÕES DE CRÉDITO/DÉBITO/VOUCHER SOLICITAÇÃO CHEQUE SOLICITAÇÃO CHEQUE COMPLETA Habilitando a Consulta de Múltiplos Cheques Consultando Cheques Garantidos SOLICITAÇÃO CARTÕES FIDELIDADE SOLICITAÇÃO DÉBITO BENEFICIÁRIO SOLICITAÇÃO TRANSAÇÃO CARTÃO FROTA SOLICITAÇÃO FUNÇÕES FINALIZAÇÃO DE VENDA OU RECEBIMENTO AUTORIZADOR DIREÇÃO INFORMAÇÕES DÉBITO PARCELADO LOG DA ÚLTIMA TRANSAÇÃO LOG DA ÚLTIMA TRANSAÇÃO TELE-MARKETING TRANSAÇÃO DE CARTÃO DE CRÉDITO DIRETA (TELE-MARKETING) TRANSAÇÃO DE CANCELAMENTO DIRETA (TELE-MARKETING) TRANSAÇÃO DE PRÉ-AUTORIZAÇÃO DE CARTÃO DE CRÉDITO DIRETA (TELE-MARKETING) TRANSAÇÃO DE CONFIRMACAO PRE-AUTORIZACAO DIRETA (TELE-MARKETING) TRANSAÇÃO DE CONSULTA AVS (TELE-MARKETING) OUTRAS FUNÇÕES DE TELE-MARKETING FUNÇÕES PARA VALE GÁS FUNÇÕES PARA RECARGA DE CELULAR PAGAMENTO DE CONTAS (CIELO) PAGAMENTO CELULAR RESGATE DE PRÊMIO FUNÇÕES ADMINISTRATIVAS INICIALIZAÇÃO DO SISTEMA D-TEF Módulo D-POS FINALIZAÇÃO DO SISTEMA D-TEF Módulo D-POS CONFIGURAÇÃO DO SISTEMA D-TEF Módulo D-POS TRANSAÇÂO QUITAÇÂO DE CARTA FRETE TRANSAÇÂO QUITAÇÂO DE CARTA FRETE COMPLETA TRANSAÇÂO DE CARGA E RECARGA DE CARTÃO PRÉ-PAGO (OU VALE PRESENTE) TRANSAÇÂO CONSULTA CADASTRO CPF COMPLETA TRANSAÇÂO DEPÓSITO COMPLETA TRANSAÇÂO SAQUE DOMÉSTICO COMPLETA LOG DAS TRANSAÇÕES REGISTRO DE INICIALIZAÇÃO/FINALIZAÇÃO REGISTRO DE REINÍCIO REGISTRO DE TRANSAÇÃO CARTÃO DE CRÉDITO REGISTRO DE TRANSAÇÃO CARTÃO DE DÉBITO REGISTRO DE TRANSAÇÃO CARTÃO CREDIÁRIO REGISTRO DE TRANSAÇÃO CARTÃO PRIVATE LABEL REGISTRO DE TRANSAÇÃO CARTÃO VOUCHER REGISTRO DE TRANSAÇÃO CARTÃO FIDELIDADE...63 Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 2/95

3 2.2.9 REGISTRO DE TRANSAÇÃO CHEQUE REGISTRO DE TRANSAÇÃO DE CANCELAMENTO REGISTRO DE TRANSAÇÕES PBM (Pharmacy Benefit Management) REGISTRO DE TRANSAÇÃO DE RECARGA DE CELULAR REGISTRO DE TRANSAÇÃO DE TRANSAÇÃO FROTA REGISTRO DE TRANSAÇÃO DE CONFIRMAÇÃO DE PRÉ-AUTORIZAÇÃO REGISTRO DE TRANSAÇÃO DE PAGAMENTO DE CONTAS REGISTRO DE TRANSAÇÃO DE VALE GÁS REGISTRO DE LOG ESTENDIDO REGISTRO DA TRANSAÇÃO DE SAQUE REGISTRO DE TRANSAÇÃO QUITAÇÃO DE CARTA FRETE REGISTRO DA TRANSAÇÃO DE ACÚMULO DE PONTOS REGISTRO DA TRANSAÇÃO DE CARGA E RECARGA DE CARTÃO (PRÉ-PAGO) REGISTRO DE ERRO DA TRANSAÇÃO REGISTRO DA TRANSAÇÃO DE DEPÓSITO REGISTRO DA TRANSAÇÃO DE SAQUE DOMÉSTICO OUTRAS TRANSAÇÕES SOLICITAÇÃO PARA COLETA DE CARTÕES SOLICITAÇÃO PARA COLETA DE INFORMAÇÕES DE TRANSAÇÃO MANUAL FUNÇÃO PARA OBTER STATUS DA TRANSAÇÃO (D-TEF) SOLICITAÇÃO CADASTRAMENTO/DESBLOQUEIO SENHA AUTORIZADOR DIREÇÃO SOLICITAÇÃO TABELAS D-TEF TESTE REDE ATIVA INTEGRAÇÃO GERENCIADOR PADRÃO DIREÇÃO Solução utilizando TEF Discado Padrão Solução D-TEF Direção Campos Adicionais Arquivo de Entrada (IntPos.001) Arquivo de Resposta (IntPos.001) Detalhamento Dos Campos Adicionais Configurações DESCRITIVO E TRATAMENTO DE ERROS EXEMPLOS DE INTEGRAÇÃO Exemplo C/C Exemplo Java Exemplo Visual Basic Exemplo Delphi (Pascal) Exemplo C# Exemplo Embarcadero Delphi (2012) Exemplo Kylix/C++ em Linux PROCEDIMENTOS ESPECÍFICOS Plataforma Promocional Cielo TABELAS TABELA 1.0 : TIPOS DE REGISTRO E CÓDIGOS DE TRANSAÇÕES TABELA 2.0 : REDES AUTORIZADORAS TABELA 3.0 : REDES AUTORIZADORAS D-TEF TABELA 4.0 : OPERADORAS TABELA 5.0 : BANDEIRAS IMPLEMENTAÇÕES Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 3/95

4 1 INTRODUÇÃO Este documento tem por objetivo descrever como o sistema D-TEF interage com os sistemas de automação, de forma a que os responsáveis pelos mesmos possam fazer as adaptações necessárias para viabilizar a execução de transações de transferência eletrônica de fundos (TEF). O sistema D-TEF é um conjunto de utilitários e bibliotecas que capacitam os estabelecimentos comerciais, que possuem equipamentos adequados, a efetuar transações de TEF. Usando a modalidade TEF Dedicado, onde se requer ligação permanente entre o estabelecimento comercial e as instituições financeiras, o sistema D-TEF viabiliza, entre outros serviços, pagamentos de compras através de cartões de crédito e cartões de débito e verificação de idoneidade de clientes através de consulta a instituições de proteção ao crédito (SERASA, Associação Comercial, Teledata, CDL, Banco 24Horas). O módulo principal do sistema D-TEF é executado como serviço do Windows (NT/2000/XP/95/98/Me). Opera em conjunto com o sistema de automação comercial, interagindo com este através de duas formas distintas: através de uma DLL (DPOSDRV.DLL), onde o sistema de automação comercial realiza a comunicação com o D-TEF por meio de chamadas diretas de função; através de troca de arquivos, onde as informações das transações são passadas por meio de arquivos com conteúdo e formatos específicos para cada operação. As duas formas de comunicação são equivalentes em funcionalidade. A escolha por uma ou por outra forma fica a critério do desenvolvedor do software de automação comercial. 1.1 CONVENÇÕES UTILIZADAS NESTE MANUAL A descrição dos parâmetros de funções e campos de registros apresentados neste manual segue a convenção da tabela a seguir. # Descrição Observação A campo alfanumérico completado com espaços à direita e preenchido com espaços, quando não informado H campo hexadecimal campo binário N campo numérico completado com zeros à esquerda e preenchido com zeros, quando não informado I valor inteiro retorno ou parâmetro de função de valor inteiro (integer) P ponteiro para caracter ponteiro para um array de caracteres (PChar) como parâmetro de função Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 4/95

5 2 TEF DEDICADO 2.1 INTEGRAÇÃO POR BIBLIOTECA DE FUNÇÕES (Windows ou Linux) Uma das formas de integração da automação comercial com o D-TEF é por meio de biblioteca de funções (DPOSDRV.DLL para Windows ou libdposdrv.so para Linux). Esta biblioteca oferece funções que a automação utiliza, enviando parâmetros da operação e retornando os resultados na própria chamada dessas funções. As funções disponíveis na versão Linux são equivalentes às da versão Windows. Na seção EXEMPLOS DE INTEGRAÇÃO é apresentada uma forma de integração para algumas ferramentas de desenvolvimento. As funções da biblioteca são exportadas segundo a convenção de chamada de parâmetros standard call (stdcall), o que a torna possível de ser utilizada por sistemas desenvolvidos em qualquer linguagem ou ambiente de programação, como Delphi, Visual Basic e Visual C++, entre outros. Para as funções de telemarketing, se a automação realizar chamadas de múltiplas threads simultâneas, deverá ser utilizada a biblioteca DPOSDRVTM.DLL. Essa DLL possui apenas as funções de telemarketing e elas têm os mesmos nomes exportados pela DLL DPOSDRV.DLL FLUXO EXEMPLO PARA INTEGRAÇÃO POR FUNÇÕES Utilizando-se uma operação de venda como exemplo, a interação entre a automação comercial e o sistema D-TEF acontecerá da seguinte forma: SOFTWARE AUTOMAÇÃO COMERCIAL ATIVO NA TELA DESATIVADO SOFTWARE DIREÇÃO Abre o dia do movimento Inicializa a DLL do sistema D-TEF... Inicia a operação de venda Registra os produtos ou serviços adquiridos Totaliza a operação de venda... Seleciona forma de pagamento com TEF e solicita transação TEF para o sistema D-TEF ATIVO EM BACKGROUND ATIVO NA TELA... Imprimir o comprovante reduzido na mensagem promocional do cupom fiscal (se existir) Encerra a operação de venda Confirma a transação do comprovante reduzido impresso (se for o caso) Imprime os documentos envolvidos Elimina, obrigatoriamente, o(s) arquivo(s) NNNNNN.PDV e o RNNNNNN.PDV. Confirma a(s) transação(ões) com o D-TEF O sistema de automação finaliza a(s) transação(ões) com o D-TEF O sistema de automação reconhece a finalização e prepara o início de outra venda... O sistema de automação finaliza a DLL do sistema D- TEF O sistema de automação fecha o dia de movimento O sistema D-TEF realiza os procedimentos de abertura de dia e confirma a transação com o sistema de automação ATIVO NA TELA Interpreta os parâmetros recebidos Coleta as informações necessárias Submete a transação à instituição financeira Recebe resposta da instituição financeira Cria o arquivo NNNNN.PDV, e opcionalmente o arquivo RNNNNNN.PDV, contendo a imagem do boleto a ser impresso e a imagem reduzida, respectivamente Retorna as informações da resposta da transação para a automação comercial DESATIVADO Confirma com a instituição financeira a(s) transação(ões) confirmadas pela automação e desfaz a(s) restantes O sistema D-TEF finaliza a(s) transação(ões) com o sistema de automação O sistema D-TEF realiza os procedimentos de fechamento de dia e confirma a transação com o sistema de automação Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 5/95

6 2.1.2 COMUNICAÇÃO DO SISTEMA D-TEF COM O SISTEMA DE AUTOMAÇÃO A comunicação entre o sistema D-TEF e o sistema de automação é feita através de chamadas a funções da DLL (DPOSDRV.DLL), com a passagem de parâmetros e posterior retorno de status. As solicitações de transações com as instituições financeiras são realizadas através de transações financeiras (TF) ou transações de serviços (TS) e as solicitações de procedimentos operacionais são realizadas através de transações operacionais (TO). Para transações financeiras, as funções atualmente disponíveis são: TransacaoCartaoCredito TransacaoCartaoCreditoCompleta ConfirmaCartaoCredito TransacaoCartaoDebito TransacaoCartaoDebitoCompleta ConfirmaCartaoDebito TransacaoCartaoVoucher TransacaoCartaoVoucherCompleta ConfirmaCartaoVoucher FinalizaTransacao TransacaoCartaoFidelidade ConfirmaCartaoFidelidade TransacaoCheque TransacaoChequeCompleta TransacaoCartaoCrediario TransacaoCartaoCrediarioCompleta Para transações de serviços, as funções atualmente disponíveis são: TransacaoPreAutorizacaoCartaoCredito TransacaoCancelamentoPagamento TransacaoResumoVendas TransacaoConsultaParcelas TransacaoReimpressaoCupom TransacaoEstatistica TransacaoTrocoSurpresa TransacaoInjecaoChaves Para transações operacionais, as funções disponíveis são: ObtemLogUltimaTransacao InicializaDPOS FinalizaDPOS ConfiguraDPOS. As funções TransacaoCartaoCredito, TransacaoCartaoDebito, TransacaoCartaoVoucher, TransacaoCartaoCrediario e TransacaoCheque são utilizadas pelo sistema de automação para solicitar ao sistema D-TEF a realização de transação de pagamento com cartão de crédito, pagamento com cartão de débito, pagamento com cartão Voucher, pagamento em crediário e consulta de cheque, respectivamente. O sistema D- TEF devolverá ao sistema de automação o resultado da transação com a instituição financeira e disponibilizará, se for o caso, o cupom de TEF no diretório parametrizado, com nome no formato NNNNNN.PPP (onde NNNNNN é o NSU da operação e PPP é o número do terminal). Se houver também um comprovante reduzido, ele será liberado num arquivo com o formato RNNNNNN.PPP. Estas funções devem ser executadas após a totalização da operação de venda ou de recebimento, durante os procedimentos de recebimento de valores, com o cupom (fiscal ou não fiscal) aberto. As funções TransacaoCartaoCreditoCompleta, TransacaoCartaoDebitoCompleta, TransacaoCartaoVoucherCompleta, TransacaoChequeCompleta, TransacaoCartaoCrediarioCompleta possuem a mesma funcionalidade das funções correspondentes não completas, mas oferecem parâmetros adicionais para maior controle das operações e informações de retorno mais detalhadas. As funções ConfirmaCartaoCredito, ConfirmaCartaoDebito e ConfirmaCartãoVoucher são utilizadas pelo sistema de automação para indicar ao sistema D-TEF quais transações financeiras foram efetivadas na operação de venda ou de recebimento. Estas funções devem ser executadas após a impressão do comprovante de TEF disponibilizado no retorno da solicitação da transação. O sistema D-TEF devolverá ao sistema de automação o resultado da transação de confirmação. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 6/95

7 A função FinalizaTransacao, executada após as funções de confirmação, é utilizada pelo sistema de automação para indicar ao sistema D-TEF o término da transação de venda ou recebimento. O sistema D-TEF realizará a confirmação das transações com cartões, efetivadas na operação de venda ou recebimento, junto às instituições financeiras e retornará ao sistema de automação o resultado da transação de finalização. A função TransacaoReimpressaoCupom não necessita de confirmação. As funções TransacaoCheque, TransacaoChequeCompleta não necessitam de confirmação quando não houver cupom para impressão. A função ObtemLogUltimaTransacao retorna o registro de log referente à última transação efetuada com sucesso. Nesta função, caso seja necessário, poderá ser passado como parâmetro o valor LOGESTENDIDO e serão retornadas informações adicionais da transação. O formato do registro é o LOG ESTENDIDO. A função InicializaDPOS deve ser executada em cada abertura de dia de movimento (dia fiscal), servindo para indicar à DLL do sistema D-TEF que os processos de inicialização de dia devem ser realizados. Caso a DLL do sistema D-TEF venha a ser REINICIADA, por qualquer motivo, serão executados processos internos de recuperação de falhas. A função FinalizaDPOS deve ser executada em cada fechamento de dia de movimento (dia fiscal), servindo para indicar à DLL do sistema D-TEF que os processos de finalização de dia devem ser realizados TRANSAÇÕES A seguir estão descritas as transações e as funções de chamada, atualmente disponibilizadas para a integração por DLL com o TEF Dedicado, com a indicação de seus parâmetros e sua caracterização. Todos os campos numéricos informados devem ser completados com zeros à esquerda e, quando não informados, preenchidos com zeros. Os campos alfanuméricos devem ser completados com espaços à direita e, quando não informados, preenchidos com espaços SOLICITAÇÃO CARTÕES DE CRÉDITO/DÉBITO/VOUCHER/CREDIÁRIO TransacaoCartaoCredito (pvalortransacao, pnumerocupom, p: PChar): Integer; TransacaoCartaoDebito (pvalortransacao, pnumerocupom, p: PChar): Integer; TransacaoCartaoVoucher (pvalortransacao, pnumerocupom, p: PChar): Integer; TransacaoCartaoCrediario (pvalortransacao, pnumerocupom, p: PChar): Integer; A solicitação de transação com cartão de crédito, cartão de débito ou cartão Voucher é realizada através da chamada às funções TransacaoCartaoCredito, TransacaoCartaoDebito, TransacaoCartaoVoucher ou TransacaoCartaoCrediario, respectivamente, com a passagem dos seguintes parâmetros: ValorTransacao NumeroCupom Na resposta da chamada à função será preenchido o campo e será devolvido o Status, indicando o resultado da transação. O, incluído na resposta, deverá ser armazenado pelo sistema de automação, pois na função de confirmação este número será, obrigatoriamente, utilizado. Caso a transação seja autorizada, será disponibilizado no diretório parametrizado para os cupons um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Se a rede autorizadora permitir e se estiver configurada no D-TEF a impressão de cupom reduzido, além do arquivo acima será liberado um arquivo com o comprovante reduzido no formato RNNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Assim, o comprovante reduzido deverá ser impresso no espaço destinado à mensagem promocional do cupom fiscal e o comprovante normal continuará a ser impresso no cupom vinculado. O PDV deverá verificar a existência do arquivo com o comprovante reduzido após a aprovação da transação. Se o arquivo com o comprovante reduzido estiver disponível, o PDV deverá imprimir no cupom fiscal e em seguida realizar a confirmação do mesmo, antes da impressão do comprovante normal. Se o comprovante reduzido não estiver disponível, a confirmação deverá ser realizada após a impressão do comprovante normal. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 7/95

8 Ao final da venda, tanto no caso do comprovante reduzido como no comprovante normal, para encerrar a operação deve ser chamada a função FinalizaTransacao (ver ítem ). Os campos estão abaixo caracterizados. ValorTransacao NumeroCupom Status Status [00] Status [11] 12 N 10 inteiros, 2 decimais 06 N Número do cupom (fiscal ou não fiscal) 06 N NSU (número seqüencial único) 02 I [00] Transação autorizada [11] Transação não efetuada indica que não existiram restrições para a efetivação da transação. indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento FUNÇÕES ESPECÍFICAS (Especificação Redecard/Cielo/Banrisul) TransacaoCartaoCreditoIATA (pvalortransacao, pnumerocupom, p: PChar): Integer; TransacaoCartaoPrivateLabel (pvalortransacao, pnumerocupom, p: PChar): Integer; TransacaoSaqueRedecard (pvalortransacao, pnumerocupom, p: PChar): Integer; EstornoPreAutorizacaoRedecard (pvalortransacao, p: PChar): Integer; 1 TransacaoSimulacaoPrivateLabel(pValorTransacao,pNumeroCupom, p: PChar): Integer; 1 TransacaoPagamentoPrivateLabel(pValorTransacao,pNumeroCupom, p: PChar): Integer; 1 TransacaoCartaoCompraSaque (pvalorcompra, pvalorsaque, pnumerocupom, p: PChar): Integer; 1 TransacaoCartaoCompraSaqueCompleta (pvalorcompra, pvalorsaque, pnumerocupom, p, ppermitealteracao: PChar): Integer; 1 TransacaoCDC1MIN(pValorTransacao, pnumerocupom, p: PChar): Integer; 1 TransacaoSIMparcelado(pValorTransacao,pNumeroCupom, p: PChar): Integer; 1 IdentificacaoAutomacaoComercial(pNomeAutomacao, pversaoautomacao, p: PChar): Integer; 1 TransacaoInjecaoChaves (p: PChar): Integer; 1 Disponível somente no DPOS8 As solicitações de transação de Estorno de Pré-Autorização de pagamento com Cartão de Crédito, de Saque, de Pagamento com Cartão de Crédito IATA e Cartão Private Label são realizadas através das chamadas às funções EstornoPreAutorizacaoRedecard, TransacaoSaqueRedecard, TransacaoCartaoCreditoIATA, TransacaoCartaoPrivateLabel, TransacaoCartaoCompraSaque, TransacaoCDC1MIN e TransacaoSIMparcelado com a passagem dos seguintes parâmetros: ValorTransacao NumeroCupom Na resposta da chamada à função será preenchido o campo e será devolvido o Status, indicando o resultado da transação. O, incluído na resposta, deverá ser armazenado pelo sistema de automação, pois na função de confirmação este número será, obrigatoriamente, utilizado, tanto nas funções de pagamento como na de Saque e Estorno. Caso a transação seja autorizada, será disponibilizado no diretório parametrizado para os cupons um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Se a rede autorizadora permitir e se estiver configurada no D-TEF a impressão de cupom reduzido, além do arquivo acima será liberado um arquivo com o comprovante reduzido no formato RNNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Assim, o comprovante reduzido deverá ser Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 8/95

9 impresso no espaço destinado à mensagem promocional do cupom fiscal e o comprovante normal continuará a ser impresso no cupom vinculado. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 9/95

10 O PDV deverá verificar a existência do arquivo com o comprovante reduzido após a aprovação da transação. Se o arquivo com o comprovante reduzido estiver disponível, o PDV deverá imprimir no cupom fiscal e em seguida realizar a confirmação do mesmo, antes da impressão do comprovante normal. Se o comprovante reduzido não estiver disponível, a confirmação deverá ser realizada após a impressão do comprovante normal. Ao final da venda, tanto no caso do comprovante reduzido como no comprovante normal, para encerrar a operação deve ser chamada a função FinalizaTransacao (ver ítem ). As funções de Estorno e Saque devem ser disponibilizadas via "menu", ou seja, o PDV não pode estar efetuando uma venda (assim como as funções de cancelamento de pagamento e reimpressão). Já as funções de pagamento (Cartão Crédito IATA e Private Label) devem estar disponibilizadas como formas de pagamento do PDV. As funções TransacaoCDC1MIN e TransacaoSIMparcelado são específicas da rede Banrisul. O PDV deverá realizar, respectivamente, chamada às funções TransacaoEstatistica toda a vez que for inicializado. IdentificacaoAutomacaoComercial e A função TransacaoPagamentoPrivateLabel é a transação disponível para efetuar o pagamento de fatura de cartões private. A função de Injeção de Chaves poder ser chamada ou executada automaticamente (no caso de executar uma transação com a Redecard e existir chave DUKPT na tabela de criptografia da Redecard e o pinpad não possuir esta chave carregada). A definição ds campos das funções estão abaixo caracterizados. ValorTransacao NumeroCupom NomeAutomacao VersaoAutomacao Status Status [00] Status [11] 12 N 10 inteiros, 2 decimais 06 N Número do cupom (fiscal ou não fiscal) 06 N NSU (número seqüencial único) 20 A Identificação da automação comercial 20 A Versão da automação comercial 256 A Capacidades da automação comercial: [1..1] Tratamento plataforma promocional Cielo [0]: automação não está preparada para tratar a plataforma promocional Cielo [1]: automação está preparada para tratar plataforma promocional Cielo 02 I [00] Transação autorizada [11] Transação não efetuada indica que não existiram restrições para a efetivação da transação. indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento. Quanto à estrutura dos logs de retorno, cada transação possui estrutura diferente: EstornoPreAutorizacaoRedecard: idêntica ao layout de cancelamento de pagamento. TransacaoSaqueRedecard: não gera log de transação. TransacaoCartaoCreditoIATA: idêntica ao layout de pagamento com cartão de crédito. TransacaoCartaoPrivateLabel: layout do log do Cartão Private Label. TransacaoCartaoCompraSaque: não gera log de transação. TransacaoCartaoCompraSaqueCompleta: não gera log de transação. Os layouts dos logs estão na seção 2.3 deste manual. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 10/95

11 FUNÇÕES DE VENDA PBM (Pharmacy Benefit Management) ConsultaParametrosPBM (pnumerocupom, pquantidaderedes, pdadosredes, pmensagemoperador: PChar): Integer; ConsultaProdutosPBM (pnumerocupom, predepbm, ptrilha1, ptrilha2, pdigitado, pautorizacao, pdadoscrm, ptipovenda, pvalortotalmedicamentos, pvalorvista, pvalorcartao, pcodigocredenciado, pquantidademedicamentos, pmedicamentos, p, p, pmensagemoperador: PChar): Integer; TransacaoVendaPBM (pvalortotalmedicamentos, pnumerocupom, predepbm, ptrilha1, ptrilha2, pdigitado, pautorizacao, pnsuconsulta, pdadoscrm, ptipovenda, pvalorvista, pvalorcartao, pcodigocredenciado, pregranegocio, pquantidademedicamentos, pmedicamentos, p, p, prede, pmensagemoperador: PChar): Integer; ConfirmaVendaPBM (p: PChar): Integer; TransacaoReimpressaoVendaPBM: Integer; TransacaoCancelamentoVendaPBM (p: PChar): Integer; 1 TransacaoElegibilidadePBM(pNumeroCupom, predepbm, pmatricula, pdadoselegibilidade, p, prede, pnomecliente, pnomemedico, pinformadependente, plistadependentes, p, pmensagemoperador: PChar); 1 TransacaoPreAutorizacaoPBM(pNumeroCupom, predepbm, pautorizacaoelegibilidade, pdadosfarmaceutico, pquantidademedicamentos, pmedicamentos, p, prede, p, pmensagemoperador: PChar); 1 TransacaoCancelamentoPreAutorizacaoPBM(p: PChar); ConsultaParametrosPBM_TeleMarketing(pNumeroEmpresa, pmultiloja, pnumeroloja, pnumeropdv, pnumerocupom, pquantidaderedes, pdadosredes, pmensagemoperador: PChar): Integer; ConsultaProdutosPBM_TeleMarketing (pnumeroempresa, pmultiloja, pnumeroloja, pnumeropdv, pnumerocupom, predepbm, ptrilha1, ptrilha2, pdigitado, pautorizacao, pdadoscrm, ptipovenda, pvalortotalmedicamentos, pvalorvista, pvalorcartao, pcodigocredenciado, pquantidademedicamentos, pmedicamentos, p, p, pmensagemoperador: PChar): Integer; TransacaoVendaPBM_TeleMarketing (pnumeroempresa, pmultiloja, pnumeroloja, pnumeropdv, pvalortotalmedicamentos, pnumerocupom, predepbm, ptrilha1, ptrilha2, pdigitado, pautorizacao, pnsuconsulta, pdadoscrm, ptipovenda, pvalorvista, pvalorcartao, pcodigocredenciado, pregranegocio, pquantidademedicamentos, pmedicamentos, p, p, prede, pmensagemoperador: PChar): Integer; TransacaoCancelamentoVendaPBM_TeleMarketing(pNumeroEmpresa, pmultiloja, pnumeroloja, pnumeropdv, ptrilha1, ptrilha2, pdigitado, p, p, pmensagemoperador: PChar): Integer; 2 TransacaoAberturaVendaPBM_TeleMarketing(pNumeroEmpresa, pmultiloja, pnumeroloja, pnumeropdv, predepbm, ptrilha1, ptrilha2, pdigitado, p, ppedirdadoscomplementares, pdadoscomplementares, pinfodadoscomplementares, pmensagemoperador: PChar): Integer; 2 TransacaoVendaProdutoPBM_TeleMarketing(pNumeroEmpresa, pmultiloja, pnumeroloja, pnumeropdv, predepbm, ptrilha1, ptrilha2, pdigitado, pmedicamento, p, ppedirdadoscomplementares, pdadoscomplementares, pinfodadoscomplementares, pmensagemoperador: PChar): Integer; 2 TransacaoFechamentoVendaPBM_TeleMarketing(pNumeroEmpresa, pmultiloja, pnumeroloja, pnumeropdv, predepbm, ptrilha1, ptrilha2, pdigitado, pconfirmacao, p, pautorizacao, p, pmensagemoperador: PChar): Integer; 1 TransacaoElegibilidadePBM_TeleMarketing(pNumeroEmpresa, pmultiloja, pnumeroloja, pnumeropdv, pnumerocupom, predepbm, pmatricula, pdadoselegibilidade, p, prede, Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 11/95

12 pnomecliente, pnomemedico, pinformadependente, plistadependentes, p, pmensagemoperador: PChar); 1 TransacaoPreAutorizacaoPBM_TeleMarketing(pNumeroEmpresa, pmultiloja, pnumeroloja, pnumeropdv, pnumerocupom, predepbm, pautorizacaoelegibilidade, pdadosfarmaceutico, pquantidademedicamentos, pmedicamentos, p, prede, p, pmensagemoperador: PChar); 1 TransacaoCancelamentoPreAutorizacaoPBM_TeleMarketing(pNumeroEmpresa, pmultiloja, pnumeroloja, pnumeropdv, pmatricula, p, p, pmensagemoperador: PChar): Integer; 1 válido somente para a rede PrevSaude 2 válido somente para a rede SevenPDV As solicitações de transação de Consulta das Redes Parametrizadas, de Consulta de Produtos, Transação de Venda PBM, Confirmação de Venda PBM, Reimpressão de Venda PBM e Cancelamento de Venda PBM são realizadas através das chamadas às funções ConsultaParametrosPBM, ConsultaProdutosPBM, TransacaoVendaPBM, ConfirmaVendaPBM, TransacaoReimpressaoVendaPBM e TransacaoCancelamentoVendaPBM com a passagem dos seguintes parâmetros: pvalormedicamentos pnumerocupom pquantidaderedes pdadosredes predepbm ptrilha1 ptrilha2 pdigitado pautorizacao pnsuconsulta pdadoscrm ptipovenda pvalorvista pvalorcartao pcodigocredenciado pregranegocio pquantidademedicamentos pmedicamentos p p prede pmensagemoperador Para as funções de tele-marketing é necessário a passagem dos parâmetros a seguir, além dos já citados anteriormente: pnumeroempresa pmultiloja pnumeroloja pnumeropdv Na resposta da chamada à função será preenchido o campo e será devolvido o Status, indicando o resultado da transação. O, incluído na resposta da função de consulta de produtos, deverá ser armazenado pelo sistema de automação, pois na função de venda este número deverá obrigatoriamente, ser utilizado, para informar o número da consulta em que os produtos foram obtidos. No caso do obtido no retorno da função de venda, deverá ser armazenado pelo sistema de automação para efetivar a confirmação da venda. Caso a transação seja autorizada, será disponibilizado no diretório parametrizado para os cupons um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Após a impressão do comprovante pela automação comercial, sendo esta com sucesso, deve-se realizar a confirmação da transação através da função ConfirmaVendaPBM informando o número do NSU da transação que deseja confirmar. Em seguida, para encerrar a operação deve ser chamada a função FinalizaTransacao (ver item ). Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 12/95

13 Através da função TransacaoReimpressaoVendaPBM poderá ser reimpresso o comprovante da última venda PBM emitida com sucesso. Caso a função seja executada com sucesso, o arquivo ULTIMOPBM.PRN será disponibilizado no diretório parametrizado para os cupons. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 13/95

14 As funções de Consulta de Parâmetros e Consulta de Produtos devem ser acionadas antes de iniciar-se uma venda, pois ao efetuar a venda o operador deverá optar por utilizar um produto da rede selecionada ou por um produto da própria loja. Esta seleção é importante para determinar se o automação comercial deverá chamar a função de venda PBM ou não. No caso de efetuar uma venda PBM, todos os parâmetros obtidos através da função de consulta PBM deverão ser passados na função de venda, de acordo com a quantidade vendida. Estes dados deverão estar coerentes com os dados da consulta, caso contrário, a venda corre o risco de não ser aprovada pela rede PBM selecionada. Através da função TransacaoCancelamentoVendaPBM pode-se efetuar o cancelamento de uma venda PBM. O da venda a ser cancelada deve ser informado. Além disso, se a rede PBM exigir, poderá ser necessário a leitura do cartão do beneficiário para efetuar o cancelamento. Os campos estão abaixo caracterizados. MultiLoja 01 P 01 Caracter [ S, N ] NumeroEmpresa 04 P 04 inteiros NumeroLoja 04 P 04 inteiros NumeroPDV 03 P 03 inteiros [ ] InfoDadosComplementares 64 A Informação de coleta de campos opcionais da tela de abertura de venda PBM. Os parâmetros dos 2 campos têm o seguinte formato: TAAMMXX...XXTAAMMXX...XX T: tipo do campo - N (numérico), A (alfanumérico) ou F (opção sim ou não - Y/N) AA: tamanho mínimo do campo (1 até 50) MM: tamanho máximo do campo (1 até 50) X: nome do campo para apresentação na tela (até 20 bytes) Os dois campos são opcionais. Se nenhum campo estiver preenchido, não haverá a coleta. Exemplo: N0808CEP N1111CPF DO PORTADOR Neste exemplo, haverá a captura de 2 campos, sendo que o primeiro é o CEP com 8 dígitos (N=numérico) e o segundo o CPF com 11 dígitos. DadosComplementares 128 A Dados complementares coletados conforme os campos da estrutura InfoDadosComplementares. No exemplo acima, os dados poderiam ficar: , isto é, CEP com 8 dígitos e CPF com 11 dígitos. PedirDadosComplementares 01 A Se a função retornar erro, analisar este campo para verificar se é necessário coletar os dados complementares e chamar novamente a função. [S] Coletar dados complementares [N] Não coletar dados complementares ValorTotalMedicamentos 12 N Valor total dos medicamentos do cupom na venda ou valor total dos medicamentos retornados na consulta NumeroCupom 06 N Número do cupom (fiscal ou não fiscal) QuantidadeRedes 02 N Quantidade de redes cadastradas DadosRedes Formato: Numero [05] Nome [20] ColetaCartao [01] ColetaAutorizacao [01] Filler [13] 560 P Parâmetro que retorna os dados das redes cadastradas. Os campos ColetaCartao e ColetaAutorizacao indicam qual informação deve ser coletada pelo automação comercial. Podem ser retornados até 14 redes no formato especificado Especificação de alguns campos: Campo ColetaCartao = [S] Coletar cartão [N] Não coletar cartão Campo ColetaAutorizacao = [S] Coletar número de autorização [N] Não coletar número de autorização RedePBM 05 N Código da rede PBM selecionada Trilha1 76 A Trilha1 do cartão Trilha2 37 A Trilha2 do cartão Digitado 01 N [0] Indica que a trilha2 do cartão foi obtido através de leitura em pinpad criptografado [1] Indica que a trilha2 do cartão foi digitado Autorização 12 N Número da autorização coletado pelo automação NSUConsulta 06 N Número de controle obtido na consulta de produtos DadosCRM Formato: CRM [12] UF_CRM [02] 14 P Dados de identificação do CRM consultado Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 14/95

15 DadosElegibilidade Formato: CodigoOperadorVita [09] PlanoSaude [06] NumeroDependente[02] TipoProfissional [01] UF_CRM_CRO [02] NumeroCRM_CRO [09] DataReceita [06] DescontoEmFolha [01] 30 P Deve ser coletado pelo automação os dados da estrutura. Especificação de alguns campos: Campo CodigoOperadorVita = Campo PlanoSaude = Código do plano de saúde Campo TipoProfissional = [0] CRM [1] CRO Campo DescontoEmFolha = [S] Sim [N] Não NomeCliente 40 P Retornado pela função TransacaoElegibilidadePBM NomeMedico 40 P Retornado pela função TransacaoElegibilidadePBM InformaDependente 01 P [S]Sim [N]Não Importante: se a função retornar status 11, verificar se foi retornado S neste parâmetro. Neste caso, chamar a função novamente informando o número do dependente na estrutura do parâmetro DadosElegibilidade ListaDependentes Formato: Número do dependente [02] Nome do dependente [40] 504 P Lista de até 12 registros AutorizacaoElegibilidade 12 P Deve ser informado a Autorização retornada na transação de elegibilidade DadosFarmaceutico Formato: UF_CRF[02] NumeroCRF[12] 14 P TipoVenda 01 N [0]Vista [1] Cartão ValorVista 12 N Valor a pagar à vista para consulta e valor pago à vista para a função de venda ValorCartão 12 N Valor a pagar com cartão para consulta e valor pago com cartão para a função de venda CodigoCredenciado 15 N Código do credenciado RegraNegocio 08 N Código da regra de negócio (epharma) QuantidadeMedicamentos 02 N Quantidade de medicamentos retornados no campo Medicamentos para a função de consulta e quantidade de medicamentos vendidos para a função de venda Medicamentos Formato: DataReceita [08] IDCRM_CRO [01] CRM [12] UF_CRM [02] TipoMedicamento [02] Código [13] Descrição [15] CondicaoVenda [01] PrecoMaxConsumidor [08] PrecoFabricaUnitario [08] PrecoUnitarioVendaCons [08] PrecoAquisicaoUnitario [08] PrecoRepasseVarejo [08] MotivoRejeicao [02] QtdReceitada [04] QtdAutorizadaSolicitada [04] Referencia [02] IndicadorVenda [01] TipoEmbalagem [01] Desconto [05] Controle [10] Reembolso [08] Comissão [05] UsoContinuo [01] Filler [05] * P Dados dos medicamentos fornecidos para o automação na função de consulta e dados dos medicamentos vendidos da rede selecionada para a função de venda. Podem ser retornados (pela função de consulta) ou informados (para a função de venda) até o número de medicamentos informado no campo QuantidadeMedicamentos. * o tamanho deste buffer deve ser calculado da seguinte forma: QuantidadeMedicamentos * = tamanho da estrutura de dados para um medicamento Especificação de alguns campos: Campo IDCRM_CRO = [0] CRM [1] CRO Campo TipoMedicamento = [01] Medicamento [02] Manipulação [03] Manip. Especial [04] Perfumaria Campo CondicaoVenda = [0] obrigatório utilizar preço fábrica [1] permite vender com preço inferior Campo IndicadorVenda = [0] produto venda cartão [1] produto venda vista Campo TipoEmbalagem = unitário ou parcial Campo Controle = campo para uso restrito Campo UsoContinuo = [S, N] Observações: [1] os campos Reembolso e Comissão foram incluídos pois são retornados pela VidaLink [2] o campo UsoContinuo é utilizado pela PreSaude [3] no campo QtdAutorizadaSolicitada deve ser informado a quantidade solicitada para a PrevSaude ou quantidade autorizada para as demais PBMs. 128 P Campo reservado TransacaoAberturaVendaPBM_TeleMarketing: esta função retornará neste Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 15/95

16 parâmetro o número da autorização para esta transação. Tamanho de 12 bytes. Confirmacao 01 A Indica se a transação de venda de produtos PBM deve ser confirmada ou não. [S] Confirmar a operação [N] Não confirmar a operação 06 N NSU (número seqüencial único) Rede 12 N NSU da Rede Autorizadora (número seqüencial único retornado pela rede que aprovou a venda) MensagemOperador 64 P Mensagem retornada pelo D-TEF indicando o motivo da recusa da transação. Deve ser apresentada ao operador quando a transação for rejeitada Status 02 I [00] Transação autorizada [11] Transação não efetuada Obs.: todos campos que contém diversos parâmetros devem ser passados conforme seus respectivos tamanhos. Os campos numéricos devem vir com zeros à esquerda (sem ponto ou vírgula), enquanto que os alfanuméricos devem vir com espaços à direita. Status [00] Status [11] indica que não existiram restrições para a efetivação da transação. indica que existiram restrições para a efetivação da transação. Apresentar ao usuário o conteúdo do campo MotivoRejeicao (retornado pela operadora). No campo MensagemOperador contém a mensagem retornada pelo D-TEF. Observação: Para cada conjunto de chamadas as funções de TeleMarketing (ConsultaParametrosPBM_TeleMarketing, ConsultaProdutosPBM_TeleMarketing, TransacaoVendaPBM_TeleMarketing, TransacaoAberturaVendaPBM_Telemarketing, TransacaoVendaProdutoPBM_TeleMarketing, TransacaoFechamentoVendaPBM_TeleMarketing) deve ser informado um número de PDV diferente (obedecendo a faixa de PDVs definida na especificação dos parâmetros). Isto é necessário para que o D-TEF possa diferenciar as transações que estão ocorrendo simultaneamente. Um exemplo de ocorrência desta situação é na utilização desta função através de um servidor Web, que pode ter vários usuários realizando acesso simultâneo. Observação para transações de pré-venda SevenPDV: a autorização das redes tratadas pela PBM SevenPDV deve seguir o seguinte fluxo de chamadas de funções: TransacaoAberturaVendaPBM_TeleMarketing: função para abrir a venda. Se no retorno a função indicar que devem ser pedidos dados complementares, deverá ser analisado o campo de retorno pinfodadoscomplementares para buscar a definição dos campos a serem coletados. A seguir, a função TransacaoAberturaVendaPBM_TeleMarketing deverá ser chamada novamente com a informação dos dados complementares. Caso a tela de coleta dos dados complementares do portador for exibida mas o operador não entrou com os dados, a palavra VAZIO deverá ser informada no campo pdadoscomplementares. TransacaoVendaProdutoPBM_TeleMarketing: transação para incluir o produto na autorização que está sendo feita simultaneamente à venda. Na estrutura do medicamento, deverão ser informados os campos Codigo, PrecoMaxConsumidor, PrecoUnitarioVendaCons, QuantidadeAutorizada e TipoEmbalagem. Os campos retornados na estrutura de medicamento são retornados os campos QuantidadeAutorizada, PrecoMaxConsumidor, PrecoUnitarioVendaCons, PrecoRepasseVarejo, Desconto e MotivoRejeicao. TransacaoFechamentoVendaPBM_TeleMarketing: função para finalizar a venda PBM. Se a venda foi finalizada com sucesso, deverá passar o parâmetro pconfirmaçao com o valor "S". Neste caso, ao final da execução da função será disponibilizado o comprovante da operação para ser impresso. Se a venda não deve ser finalizada, passar no parâmetro o valor "N". Observação: para transações de telemarketing em ambientes com múltiplas threads simultâneas, deverá ser utilizada a DLL DPOSDRVTM.DLL. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 16/95

17 SOLICITAÇÃO CARTÃO DE CRÉDITO COMPLETA TransacaoCartaoCreditoCompleta(pValorTransacao, pnumerocupom, p, ptipooperacao, pnumeroparcelas, pvalorparcela, pvalortaxaservico, ppermitealteracao, p: PChar): Integer; 1 TransacaoCartaoPrivateLabelCompleta(pValorTransacao, pnumerocupom, p, ptipooperacao, pnumeroparcelas, pvalorentrada, pvalortaxaservico, ppermitealteracao, p: PChar): Integer; 1 Disponível somente no DPOS8 Quando a automação comercial necessitar de detalhes mais precisos da transação, de cartão de crédito ou private label, pode ser usada a solicitação de transação com cartão de crédito completa e transação com cartão private label completa, através da(s) chamada(s) à(s) função(ões) TransacaoCartaoCreditoCompleta e TransacaoCartaoPrivateLabelCompleta. Os parâmetros destas funções são os seguintes: ValorTransacao NumeroCupom TipoOperacao (*) NumeroParcelas (*) ValorParcela (*) ValorEntrada (*) ValorTaxaServico (*) PermiteAlteracao (*) (*) O preenchimento dos parâmetros indicados com (*) é opcional. Caso o sistema de automação não possua estas informações, devem ser preenchidos com zeros ou espaços, conforme o tipo do campo. Na resposta da chamada à função será preenchido o campo e será devolvido o Status, indicando o resultado da transação. O, incluído na resposta, deverá ser armazenado pelo sistema de automação, pois na função de confirmação este número será, obrigatoriamente, utilizado. Caso a transação seja autorizada, será disponibilizado no diretório parametrizado para os cupons um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Se a rede autorizadora permitir e se estiver configurada no D-TEF a impressão de cupom reduzido, além do arquivo acima será liberado um arquivo com o comprovante reduzido no formato RNNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Assim, o comprovante reduzido deverá ser impresso no espaço destinado à mensagem promocional do cupom fiscal e o comprovante normal continuará a ser impresso no cupom vinculado. O PDV deverá verificar a existência do arquivo com o comprovante reduzido após a aprovação da transação. Se o arquivo com o comprovante reduzido estiver disponível, o PDV deverá imprimir no cupom fiscal e em seguida realizar a confirmação do mesmo, antes da impressão do comprovante normal. Se o comprovante reduzido não estiver disponível, a confirmação deverá ser realizada após a impressão do comprovante normal. Ao final da venda, tanto no caso do comprovante reduzido como no comprovante normal, para encerrar a operação deve ser chamada a função FinalizaTransacao (ver ítem ). Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 17/95

18 Os campos estão abaixo caracterizados. ValorTransacao 12 N 10 inteiros, 2 decimais NumeroCupom 06 N Número do cupom (fiscal ou não fiscal) 06 N NSU (número seqüencial único) TipoOperacao 02 A [AV] À vista [FL] Financiamento Lojista [FA] Financiamento Administradora NumeroParcelas 02 N Número de parcelas (00 99) ValorParcela 12 N 10 inteiros, 2 decimais ValorEntrada 12 N 10 inteiros, 2 decimais ValorTaxaServico 12 N 10 inteiros, 2 decimais PermiteAlteracao 01 A [S] Permite alterar valores informados (exceto ValorTransacao) [N] Não permite alterar valores informados 158 A [Especificação] [1..1] Uso restrito. Fixo 0 [2..4] Uso restrito. Fixo 000 [5..7] Plano de pagamento utilizado no PDV [8..8] Valor [0] indica pagamento com Cartão de Crédito; [1] indica pagamento com Crachá. [3] indica pagamento com cartão Qualidade [9..9] Flag indicando se há dados de cartão (Crachá) [0]Não [1]Sim [10..46] Uso restrito. [47..50] Uso restrito. [ ] Uso restrito. [ ] Valor da taxa de embarque. [Especificação do Retorno] 2 bytes 2 bytes Tamanho... Código Tamanho Dados... Código possíveis: [01] Dados Correspondente Bancário [02] Dados Correspondente Bancário [03] Dados Correspondente Bancário [04] Dados Correspondente Bancário [05] Dados Venda Crachá [Especificação dos Dados Venda Crachá] [01..09] CodigoAutorizacao [10..59] NomeFuncionario [60..71] ValorDesconto [72..76] PercentualDesconto Status 02 I [00] Transação autorizada [11] Transação não efetuada Status [00] Status [11] indica que não existiram restrições para a efetivação da transação. indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 18/95

19 SOLICITAÇÃO CARTÃO DE DEBITO COMPLETA TransacaoCartaoDebitoCompleta(pValorTransacao, pnumerocupom, p, ptipooperacao, pnumeroparcelas, psequenciaparcela, pdatadebito, pvalorparcela, pvalortaxaservico, ppermitealteracao, p: PChar): Integer; Quando a automação comercial necessitar de detalhes mais precisos da transação, de cartão de débito, pode ser usada a solicitação de transação com cartão de débito completa, através da chamada à função TransacaoCartaoDebitoCompleta. Os parâmetros dessa função são os seguintes: ValorTransacao NumeroCupom TipoOperacao (*) NumeroParcelas (*) SequenciaParcela (*) DataDebito (*) ValorParcela (*) ValorTaxaServico (*) PermiteAlteracao (*) (*) O preenchimento dos parâmetros indicados com (*) é opcional. Caso o sistema de automação não possua estas informações, devem ser preenchidos com zeros ou espaços, conforme o tipo do campo. Na resposta da chamada à função será preenchido o campo e será devolvido o Status, indicando o resultado da transação. O, incluído na resposta, deverá ser armazenado pelo sistema de automação, pois na função de confirmação este número será, obrigatoriamente, utilizado. Caso a transação seja autorizada, será disponibilizado no diretório parametrizado para os cupons um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Se a rede autorizadora permitir e se estiver configurada no D-TEF a impressão de cupom reduzido, além do arquivo acima será liberado um arquivo com o comprovante reduzido no formato RNNNNNN.PPP, onde NNNNNN é o e PPP é o número do terminal configurado. Assim, o comprovante reduzido deverá ser impresso no espaço destinado à mensagem promocional do cupom fiscal e o comprovante normal continuará a ser impresso no cupom vinculado. O PDV deverá verificar a existência do arquivo com o comprovante reduzido após a aprovação da transação. Se o arquivo com o comprovante reduzido estiver disponível, o PDV deverá imprimir no cupom fiscal e em seguida realizar a confirmação do mesmo, antes da impressão do comprovante normal. Se o comprovante reduzido não estiver disponível, a confirmação deverá ser realizada após a impressão do comprovante normal. Ao final da venda, tanto no caso do comprovante reduzido como no comprovante normal, para encerrar a operação deve ser chamada a função FinalizaTransacao (ver ítem ). Nas transações de débito parcelado, é possível se especificar o valor e a data de cada parcela. Neste caso, a função deve ser chamada tantas vezes quantas for o número de parcelas. Em cada uma dessas chamadas, o parâmetro SequenciaParcela deverá indicar o número da parcela em questão. Numa outra situação, se os valores das parcelas não forem especificados, deverá ser passado o valor 00 no parâmetro SequenciaParcela, indicando que os valores e as datas das parcelas serão calculados automaticamente pela rede autorizadora. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 19/95

20 Os campos estão abaixo caracterizados. ValorTransacao 12 N 10 inteiros, 2 decimais NumeroCupom 06 N Número do cupom (fiscal ou não fiscal) 06 N NSU (número seqüencial único) TipoOperacao 02 A [AV] À Vista [PS] Parcelada (sem juros) [PC] Parcelada (com juros) [PD] Pré-datada [PE] Parcelado com entrada [PM] Parcelado sem entrada NumeroParcelas 02 N Número de parcelas (00 99) SequenciaParcela 02 N Número da parcela DataDebito 08 N <ddmmaaaa> Data da parcela (transação parcelada) ou Data de débito (transação pré-datada) ValorParcela 12 N 10 inteiros, 2 decimais. Se o campo TipoOperação for [PE] e o campo SequenciaParcela for igual a 1, este valor corresponderá ao valor de entrada. ValorTaxaServico 12 N 10 inteiros, 2 decimais PermiteAlteracao 01 A [S] Permite alterar valores informados (exceto ValorTransacao) [N] Não Permite alterar valores informados 148 A [Especificação] [1..1] Uso restrito. Fixo 0 [2..4] Uso restrito. Fixo 000 [5..5] [0] Sem Garantia [1] Com Garantia [6..17] Valor da taxa de embarque [18..29] Valor do saque [30..30] [3] indica pagamento com cartão Qualidade [Especificação do Retorno] 2 bytes 2 bytes Tamanho... Código Tamanho Dados... Status Código possíveis: [01] Uso restrito [02] Uso restrito [03] Uso restrito [04] Uso restrito 02 I [00] Transação autorizada [11] Transação não efetuada Status [00] Status [11] indica que não existiram restrições para a efetivação da transação. indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento. Manual D-POS - Integração D-TEF 6.16.doc 03/04/ :35 20/95