Histórico da Página

Informações Gerais

Objetivo

Permitir o recebimento de lançamentos no módulo de caixa com cartão através de um PinPad, sem a emissão de cupom fiscal.

Definição da Regra de Negócio

Será implementada a integração com o software SITEF da empresa Software Express, que será responsável pela comunicação com as operadoras (adquirentes). 

Para possibilitar o funcionamento, será necessário que a empresa possua um contrato com pelo menos um adquirente onde o SITEF seja homologado, como, por exemplo, Cielo, Rede, Stone, GetNet.

Serão tratados os pagamentos de serviços que não exigem a emissão de um cupom fiscal. Ou seja, o sistema não emitirá o cupom fiscal nem trabalhará com uma impressora fiscal. Não deve ser feito o pagamento de produtos para os quais a lei exige a emissão de um cupom fiscal através de cartão pelo módulo de caixa. Para isso, deverá ser usado um sistema de PDV.

Escopo:

Os seguintes parâmetros gerais serão criados para permitir o uso do TEF:

• Usa TEF
• Endereço IP do SITEF
• Código da Empresa (SITEF)

Ao abrir a sessão de caixa, serão acrescentados os seguintes parâmetros, caso o parâmetro "Usa TEF" esteja habilitado.

• Habilita TEF
• Identificador do Terminal

Ao ativar a sessão de caixa, o SITEF será iniciado. Além disso, será verificada a presença do PinPad. 

Durante a baixa de lançamentos pela sessão de caixa ativada, quando o meio de pagamento tiver o tipo primitivo “Cartão”, será iniciada uma transação no SITEF.

Transação do Transação do SITEF:

                        Após iniciada a transação, serão enviadas as informações referentes ao pagamento:

• Meio de pagamento: Cartão de crédito ou cartão de débito
• Valor: Valor informado na tela de baixa

A partir desse envio, serão apresentadas informações enviadas pelo SITEF para o operador e solicitadas informações, se necessário, dependendo da parametrização do SITEF.

Todas as informações retornadas pelo SITEF serão gravadas na base de dados, mesmo que a transação não seja concluída.

Caso o retorno enviado pelo SITEF esteja okOK, será impresso o cupom do TEF (cupom não fiscal – comprovante de pagamento) e o operador deverá informar se o cupom TEF foi impresso corretamente. Se a resposta foi for positiva, o recebimento será concluído e o processo de baixa finalizado. Caso contrário, será cancelado e a baixa não será concluída.

Se a transação for concluída pelo SITEF, mas ocorrer algum erro na baixa, o campo BaixaPendente será alterado para que o lançamento fique travado. Será necessário executar o processo de tratamento de transações pendentes para que a baixa seja realizada corretamente.

Quando a transação e a baixa forem concluídas com sucesso, os dados enviados pelo SITEF como NSU, código da autenticação, código da rede autorizadora serão armazenados no sistema para futura conciliação. 

Tratamento de transações pendentes:

Pode  Pode acontecer algum problema durante a transação e a mesma ficar pendente. Ou pode ocorrer um erro durante a baixa de uma transação que foi concluída corretamente pelo SITEF. Para isso existirá um processo para os ajustes dessas transações (confirmação ou cancelamento).

Cancelamento de transação:

Será  Será implementado um processo para que seja possível enviar para o SITEF o cancelamento de uma transação realizada pelo cartão. Nesse caso, além do cancelamento da transação, será realizado também o cancelamento da baixa.

• Precisamos rever a estrutura dos meios de pagamento junto a equipe do Nucleus. O tipo de transação deve ser obrigatório? Como vamos validar as informações de rede? Precisamos saber se o cartão é de débito ou crédito.

• Implementação:

Ao ativar a sessão de caixa: 

ConfiguraIntSitefInterativo (IP Sitef, Código da Empresa, Id. do Terminal)

VerificaPresencaPinPad

Para cada transação com cartão:

IniciaFuncaoSitefInterativo (Meio de pagamento, Valor, Cupom (Id do boleto, por exemplo), Data do pagamento, Hora do pagamento, Operador de caixa)

Enquanto retorno = 10000

                ContinuaFuncaoSitefInterativo (Comandos e informações)

                               Se Retorno = 0

                                               Imprime o cupom TEF

FinalizaFuncaoSitefInterativo – 0 se impressão correta ou 1 se incorreta

                               Senão

                                               Tratamento do Erro

                                               Encerra transação

Em IniciaFuncaoSitefInterativo – Parâmetros Adicionais – Limitar o tipo do meio de pagamento

Tarefas:

• Estudar comandos e tipos de campo que devem ser tratados
• Definir estrutura de tabelas
• Criar parâmetros
• Criar parâmetros na abertura de caixa
• Ativar SITEF ao ativar a sessão de caixa
• Tratar a transação da baixa com cartão no SITEF antes de chamar o serviço da baixa
• Criar as telas para mensagens e menus que devem ser apresentados ao operador – tratar os comandos e os tipos de campos enviados.
• Gravar os dados da transação enviados pelo SITEF, inclusive status (mesmo que a transação não seja confirmada)
• Impressão do cupom TEF
• Tela para perguntar se imprimiu cupom
• Tratamento de erro retornado pelo SITEF
• Chamada da baixa, passando os dados da transação que deverão ser gravados no extrato para futura conciliação
• Tratamento das transações pendentes
  • Varrer a tabela das transações gravadas na base para verificar se tem alguma que não foi concluída e deverá sofrer um processo específico (exemplo: a máquina foi desligada durante a impressão do cupom)
  • Varrer a tabela de lançamentos para ver se tem algum com baixa pendente com a transação concluída no SITEF.
  • Cancelamento da transação

<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

Tabelas Utilizadas

• SE2 – Cadastro de Contas a Pagar
• FI9 – Controle de Emissão de DARF>.
  

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Programas

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.