Histórico da Página

Informações Gerais

Objetivo

Implementar a integração com TEF da solução SiTef da Software Express, no recebimento de lançamentos a receber com cartão de crédito ou débito no módulo de caixa 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 , e GetNet.

Serão tratados os pagamentos de serviços que não exigem a emissão de um cupom fiscal. Ou , 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:

1 - Parametrização:

1.1 - Os seguintes parâmetros gerais serão criados deverão ser criados, na etapa 02.02.05.01 - Módulo de Caixa, para permitir o uso do TEF:

• Usa TEF
• Endereço IP do SITEFSiTef - define o endereço IP do servidor SiTef
• Código da Empresa (SITEF)SiTef) - define o código da empresa no SiTef
• Porta Default PinPad - define a porta default de comunicação do PinPad
• Mensagem Padrão PinPad - define uma mensagem padrão no visor do PinPad
• Liberar o estorno com senha do supervisor - define se o estorno de uma baixa que foi realizada no SiTef será liberado com a senha do supervisor ou usuário autorizado.

1.2 - Os seguintes parâmetros deverão ser criados, na etapa 02.02.02.01 - Manutenção de Baixas - Baixa a Receber, para pagamento com cartão de crédito:

• Valor mínimo por parcela - define o valor mínimo por parcela ao informar um meio de pagamento com cartão de crédito
• Número máximo de parcelas - define o número máximo de parcelas ao informar um meio de pagamento com cartão de crédito

1.3 - 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

• - define se a sessão de caixa habilita o pagamento de cartão de crédito ou débito via SiTef,

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 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 OK, 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 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 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á 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

 Image Removed

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

(Obrigatório)

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

(Obrigatório)

Objetivo

<Nesta etapa informar o objetivo da especificação do requisito, ou seja, o que a funcionalidade deve fazer. Exemplo: Permitir que o usuário defina o percentual mínimo em espécie (dinheiro), a referência mínima para calculo dos débitos do aluno e o período de validade do parâmetro de negociação>.

(Obrigatório)

Definição da Regra de Negócio

<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

 Image Removed

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

• caso o parâmetro Usa TEF estiver marcado.
• Porta PinPad - define a porta onde o PinPad está configurado. Campo será habilitado caso o Habita TEF estiver marcado.
• Porta Impressora - define a porta onde a impressora está configurada para impressão dos comprovantes do SiTef. Campo será habilitado caso o parâmetro Saída de Impressão seja "Porta LPT1".
  
  

2 - Processos

2.1 - Ativar Sessão de Caixa

Ao ativar a sessão de caixa o SiTef deverá ser configurado, se o parâmetro "Habilita TEF" foi marcado na abertura do caixa. Além disso, será verificada a presença do PinPad e escrito a mensagem padrão caso seja definida.

Funções a serem utilizadas:

• • ConfiguraIntSitefInterativoEx - configura o Sitef. Deverá ser chamado com os seguintes parâmetros: endereço ip, código da empresa, id do terminal e porta pinpad. O id do terminal deverá ter o formato XXNNNNNN, onde XX corresponder a dois caracteres alfabéticos que no caso deverá ser CX e NNNNNN seis números que no caso deverá ser o número sequencial IDTERMINALSITEF controlado pela GAUTOINC. Se o retorno da função for 0 significa que foi configurado com sucesso, caso contrário deverá ser apresentado para o usuário a mensagem de erro de acordo com a tabela abaixo e a sessão não deverá ser ativada.
    
    

    Valor	Descrição
    0	Não ocorreu erro
    1	Endereço IP inválido ou não resolvido
    2	Código da loja inválido
    3	Código de terminal inválido
    6	Erro na inicialização do Tcp/Ip
    7	Falta de memória
    8	Não encontrou a CliSiTef ou ela está com problemas
    9	Configuração de servidores SiTef foi excedida
    10	Erro de acesso na pasta CliSiTef (possível falta de permissão para escrita)
    11	Dados inválidos passados pela automação
    12	Modo seguro não ativo (possível falta de configuração no servidor SiTef do arquivo.cha).
    13	Caminho DLL inválido (o caminho completo das bibliotecas está muito grande).

• VerificaPresencaPinPad - verifica se existe um PinPad conectado. Caso não exista um PinPad conectado a sessão não deverá ser ativada.
  
  
• EscreveMensagemPermanentePinPad - escreve a mensagem padrão definida no visor do PinPad.

2.2 - Baixa de Lançamentos 

Na tela de meio de pagamento quando o usuário informar um meio de pagamento com o tipo primitivo "Cartão" e o tipo de transação "Crédito" deverá ser apresentado ao usuário uma opção de parcelamento com o parâmetro de número máximo de parcelas e valor mínimo por parcela.

Durante a baixa de lançamentos pela sessão de caixa ativada e habilitado o TEF, quando o meio de pagamento tiver o tipo primitivo “Cartão” ou "Cartão de Débito", deverá ser iniciada uma transação no SiTef.

Transação do SiTef:

Deverá ser criado uma tela para visualização do operador de caixa, onde serão mostradas as mensagens de comunicação com SiTef . 

Para iniciar a transação no Sitef deverá ser utilizada a função IniciaFuncaoSitefInterativo, passando os seguintes parâmetros:

• Função - seleciona a forma de pagamento, de acordo com o meio de pagamento informado no momento da baixa. Com as opções de 2 para débito e 3 para crédito.
• Valor - valor a ser pago contendo o separador decimal (","). Deve sempre ser passado com duas casas decimais após a virgula.
• Operador - identificação do operador de caixa
• ParamAdic - parâmetros adicionais. Permite que o aplicativo limite o tipo de meio de pagamento. Caso seja uma transação de cartão de débito deverá ser passado os códigos [17;18;19;3031;], para crédito a vista os códigos [24;27;28;29;36;] e para crédito parcelado os códigos [24;26;28;29;36;].

Após iniciada a transação deverá ser utilizada a função ContinuaFuncaoSitefInterativo, onde serão enviadas as informações referentes ao pagamento. 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.

Caso ocorra algum problema na transação do SiTef será exibida uma mensagem para o operador do caixa se deseja continuar com o processo de baixa normalmente.

Caso a transação com SiTef seja concluída com sucesso, o processo de baixa será chamado e se for também realizado com sucesso a transação com SiTef será finalizada confirmando as transações realizadas. Caso no processo de baixa ocorra algum erro, a transação SiTef será finalizada não confirmando as transações realizadas.

Para finalizar a transação pelo SiTef deverá ser utilizada a função FinalizaFuncaoSitefInterativo.

Os comprovantes do SiTef serão impressos após o processo de baixa, e após a autenticação mecânica caso esteja parametrizado. Caso o parâmetro Saída de Impressão seja "Impressora Windows", no momento da impressão dos comprovantes o operador de caixa deverá selecionar a impressora, caso contrário serão impressos na impressora configurada na Porta Impressora definida na sessão de caixa.

Quando a transação e a baixa forem concluídas com sucesso, os dados das transações SiTef serão armazenados no sistema para futura conciliação, nas seguintes tabelas:

FINTEGRACAOCARTAO - dados da transação

• • IDPROCESSO: NSU do autorizador (tipocampo 134)
  • BANDEIRA: bandeira do cartão (tipocampo 131 e 132)
  • DATAHORA: data e hora da transação (tipocampo 105)
  • IDSTATUS: status da transação
  • CODAFILIACAO: código do estabelecimento (tipocampo 157)
  • MEIOPAGTO: meio de pagamento (cartão de credito ou débito)
  • NUMPARCELAS: número de parcelas do pagamento
  • CODCOLIGADA: código da coligada
  • IDMODELO: 3 (SiTef)
  • NSUSITEF: NSU do SiTef (tipocampo 133)

FINTEGRACAOXCX - extratos de caixa referente a cada transação

• CODCOLIGADA - código da coligada
• IDTRANSACAO - identificador da transação
• CODCOLXCX - coligada do extrato
• IDXCX - ref. do extrato

Obs: No processo de baixa quando tiver alguma transação com SiTef e o parâmetro "Não interromper o processo de baixa, caso algum lançamento apresente inconsistência na baixa" estiver marcado o mesmo deverá ser desconsiderado.

2.3 - Cancelamento de transações

Ao estornar a baixa de lançamentos realizadas pelo SiTef, caso o parâmetro "Liberar estorno com senha do supervisor" estiver marcado deverá ser solicitado a senha do usuário supervisor ou usuário com permissão.

Será criado um item de segurança "Liberar estorno transação SiTef" no Cadastro de Perfil, em Serviços Globais | Perfis | Acesso a Menus | Gestão Financeira / [4] Caixa / [04.01] Sessão de Caixa / [04.01.05] Perfis / [04.01.05.03] Liberar estorno transação SiTef, para permitir usuários a liberar o estorno de transações SiTef.

Para realizar a transação de cancelamento no SiTef deverá ser chamada a função IniciaFuncaoSitefInterativo passando o código da função 210 para cancelamento de cartão de crédito e 211 para cancelamento de cartão de débito. O SiTef solicitará os seguintes dados que estarão gravados na tabela FINTECRACAOCARTAO e que deverão ser enviados ao SiTef: data da transação, número do documento (NSU do autorizador ou NSU SiTef) e o valor da transação.

Para o cancelamento é solicitado a inserção do cartão no PinPad. 

Caso a transação seja realizada com sucesso pelo SiTef e processo de baixa ocorra algum erro, o estorno da baixa deverá ser feito normalmente novamente.

Fluxo do Processo

 Image Added

Dicionário de Dados

Arquivo ou Código do Script: FS.2016.06_02

(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>.