Versões comparadas

Chave

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

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais

Especificação

Produto

RM

Módulo

TOTVS Gestão Financeira

Segmento Executor

Construção e Projetos

Projeto1


IRM/EPIC1


Requisito/Story/Issue1

http://jiraproducao.totvs.com.br/browse/FINANCEIRO01-4595

Subtarefa1


País

(x) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

Manual de integração API RESTFul e-Rede

https://www.userede.com.br/desenvolvedores/images/uploads/manual_integracao_api_rest.pdf

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

Objetivo

Integrar as soluções TOTVS com a solução de pagamentos on-line e-Rede. A solução e-rede realiza a captura e processamento de transações financeiras diretamente pela Rede, ou seja, sem necessidade de um intermediador, oferecendo pagamentos com cartões de crédito e débito das principais bandeiras do mercado.

Para que a integração seja independente do produto, e seja utilizada por qualquer solução da TOTVS, será criada uma nova solução, denominada "TOTVS e-Rede" no qual irá ter a web-page para digitação dos dados sensíveis do cartão e um web-service para fazer a comunicação com os serviços e-Rede. 

A solução TOTVS e-Rede deverá ter um instalador próprio.

Definição da Regra de Negócio

Criação da web-page para digitação dos dados do cartão:

  •  Dados de entrada:
    • Numero de Filiação (PV) -  criptografados no formato base64
    • Token -  criptografados no formato base64
    • URL e-Rede (Homologação ou Produção)
    • URL de retorno a pagina do estabelecimento
    • Código do Pedido do Estabelecimento
    • Valor (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
    • Numero máximo de parcelas
    • Descrição do Serviço
  • Dados para digitação:
    • Numero do Cartão
    • Nome do portador impresso no cartão
    • Mês vencimento do cartão
    • Ano vencimento do cartão
    • Código de Segurança do cartão
  • Dados de Retorno:
    • Após chamada do serviço de criação de transação, caso parâmetro de entrada "URL de retorno a pagina do estabelecimento esteja preenchido" será feita chamada dessa URL, passando os seguintes parâmetros na linha de comando: (ex: http://totvs.com.br/corporerm/URLRetorno?sucesso=false?codigoretorno=101?mensagemretorno?=Não Autorizado?codigopedidoestabelecimento=0000135?TID=834500036348405380?NSU=66320641?numautorizacao=186376?valor=10289)
      • Sucesso - true/false
      • codigoretorno - Preenchido caso tenha ocorrido erro - sucesso = false
      • mensagemretornoPreenchido caso tenha ocorrido erro - sucesso = false
      • codigopedidoestabelecimento - Código do Pedido do Estabelecimento
      • TID - Numero identificar único da transação
      • NSU - Numero sequencial retornado pela Rede
      • numautorizacaoNumero de autorização da transação retornado pelo emissor do cartão
      • valor - Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
  • Chamada serviço e-Rede

Criação da web-page padrão de transação concluída ou não concluída:

  • Dados de entrada
    • Código do Retorno (00 = Sucesso)
    • Mensagem de Retorno da Transação
    • Descrição do Serviço
    • TID - Numero identificador único da transação
    • NSU - Numero sequencial retornado pela Rede
    • Numero de autorização da transação retornado pelo emissor do cartão
    • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)

Criação do webservice para integração com e-rede:

  • Serviço de Criação da Transação
    • Dados de Entrada
      • URL e-Rede (Homologação ou Produção)
      • Tipo de Transação (Crédito/Débito)
      • Código do Pedido do Estabelecimento
      • Valor (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
      • Numero de Parcelas
      • Nome do portador impresso no cartão
      • Numero do Cartão
      • Mês vencimento do cartão
      • Ano vencimento do cartão
      • Código de Segurança do cartão
      • Numero de Filiação (PV) -  criptografados no formato base64
    • Dados de Retorno
      • Código do Retorno
      • Mensagem de Retorno da Transação
      • Código do Pedido do Estabelecimento
      • TID - Numero identificar único da transação
      • NSU - Numero sequencial retornado pela Rede
      • Numero de autorização da transação retornado pelo emissor do cartão
      • Data da transação no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
  • Serviço de consulta transação
    • Dados de entrada
      • Código do Pedido do Estabelecimento ou;
      • TID - Numero identificador único da transação
    • Dados de Saida
      • Código do retorno da transação
      • Mensagem de retorno da transação
      • Numero de filiação (PV)
      • Status (Approved, Denied, Canceled, Pending
      • Numero do Pedido gerado pelo estabelcimento
      • TID - Numero identificador único da transação
      • NSU - numero sequencial retornado pela Rede
      • Código de Autorização  da transação retornado pelo emissor do cartão
      • Método de pagamento utilizado na transação (Credit/Debit)
      • Valor total transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
      • Numero de Parcelas
      • Data da transação de cancelamento no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Código de Retorno da solicitação de cancelamento gerado pela Rede
      • Status da solicitação de cancelamento (Done, Denied, Processing)
      • Valor do cancelamento
  • Serviço de solicitação de cancelamento de transação
    • Dados de Entrada
      • TID - Numero identificador único da transação
      • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
    • Dados de Retorno
      • Código de retorno da transação de cancelamento
      • Mensagem de retorno da transação de cancelamento
      • Código de retorno da solicitação de cancelamento gerado pela rede
      • TID - Número identificado único de transação
      • NSU - Numero sequencial retornado pela rede
      • Data da transação de cancelamento no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Código identificador da transação de solicitação de cancelamento





 


Protótipo de Tela

Protótipo tela para informar dados de pagamento de cartão de crédito/débito

 Image Added

 

 Protótipo tela de pagamento concluído

Image Added

 Protótipo tela pagamento não concluído

Image Added

 

Fluxo do Processo

 Image Added



 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais

Especificação

Produto

RM

Módulo

TOTVS Gestão Financeira

Segmento Executor

Construção e Projetos

Projeto1


IRM/EPIC1


Requisito/Story/Issue1

http://jiraproducao.totvs.com.br/browse/FINANCEIRO01-4595

Subtarefa1


País

(x) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

Manual de integração API RESTFul e-Rede

https://www.userede.com.br/desenvolvedores/images/uploads/manual_integracao_api_rest.pdf

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

Objetivo

Integrar as soluções TOTVS com a solução de pagamentos on-line e-Rede. A solução e-rede realiza a captura e processamento de transações financeiras diretamente pela Rede, ou seja, sem necessidade de um intermediador, oferecendo pagamentos com cartões de crédito e débito das principais bandeiras do mercado.

Para que a integração seja independente do produto, e seja utilizada por qualquer solução da TOTVS, será criada uma nova solução, denominada "TOTVS e-Rede" no qual irá ter a web-page para digitação dos dados sensíveis do cartão e um web-service para fazer a comunicação com os serviços e-Rede. 

A solução TOTVS e-Rede deverá ter um instalador próprio.

Definição da Regra de Negócio

Criação da web-page para digitação dos dados do cartão:

  •  Dados de entrada:
    • Numero de Filiação (PV) -  criptografados no formato base64
    • Token -  criptografados no formato base64
    • URL e-Rede (Homologação ou Produção)
    • URL de retorno a pagina do estabelecimento
    • Código do Pedido do Estabelecimento
    • Valor (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
    • Numero máximo de parcelas
    • Descrição do Serviço
  • Dados para digitação:
    • Numero do Cartão
    • Nome do portador impresso no cartão
    • Mês vencimento do cartão
    • Ano vencimento do cartão
    • Código de Segurança do cartão
  • Dados de Retorno:
    • Após chamada do serviço de criação de transação, caso parâmetro de entrada "URL de retorno a pagina do estabelecimento esteja preenchido" será feita chamada dessa URL, passando os seguintes parâmetros na linha de comando: (ex: http://totvs.com.br/corporerm/URLRetorno?sucesso=false?codigoretorno=01?
      • mensagemretorno
      • Sucesso - true/false
      • codigoretorno
      • mensagemretorno
      • codigopedidoestabelecimento
      • TID - Numero identificar único da transação
      • NSU - Numero sequencial retornado pela Rede
      • numautorizacao - Numero de autorização da transação retornado pelo emissor do cartão
      • valor - Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
  • Chamada serviço e-Rede

Criação da web-page padrão de transação concluída ou não concluída:

  • Dados de entrada
    • Código do Retorno (00 = Sucesso)
    • Mensagem de Retorno da Transação
    • Descrição do Serviço
    • TID - Numero identificador único da transação
    • NSU - Numero sequencial retornado pela Rede
    • Numero de autorização da transação retornado pelo emissor do cartão
    • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)

Criação do webservice para integração com e-rede:

  • Serviço de Criação da Transação
    • Dados de Entrada
      • URL e-Rede (Homologação ou Produção)
      • Tipo de Transação (Crédito/Débito)
      • Código do Pedido do Estabelecimento
      • Valor (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
      • Numero de Parcelas
      • Nome do portador impresso no cartão
      • Numero do Cartão
      • Mês vencimento do cartão
      • Ano vencimento do cartão
      • Código de Segurança do cartão
      • Numero de Filiação (PV) -  criptografados no formato base64
    • Dados de Retorno
      • Código do Retorno
      • Mensagem de Retorno da Transação
      • Código do Pedido do Estabelecimento
      • TID - Numero identificar único da transação
      • NSU - Numero sequencial retornado pela Rede
      • Numero de autorização da transação retornado pelo emissor do cartão
      • Data da transação no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
  • Serviço de consulta transação
    • Dados de entrada
      • Código do Pedido do Estabelecimento ou;
      • TID - Numero identificador único da transação
    • Dados de Saida
      • Código do retorno da transação
      • Mensagem de retorno da transação
      • Numero de filiação (PV)
      • Status (Approved, Denied, Canceled, Pending
      • Numero do Pedido gerado pelo estabelcimento
      • TID - Numero identificador único da transação
      • NSU - numero sequencial retornado pela Rede
      • Código de Autorização  da transação retornado pelo emissor do cartão
      • Método de pagamento utilizado na transação (Credit/Debit)
      • Valor total transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
      • Numero de Parcelas
      • Data da transação de cancelamento no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Código de Retorno da solicitação de cancelamento gerado pela Rede
      • Status da solicitação de cancelamento (Done, Denied, Processing)
      • Valor do cancelamento
  • Serviço de solicitação de cancelamento de transação
    • Dados de Entrada
      • TID - Numero identificador único da transação
      • Valor total da transação (Exemplo R$ 10,00 = 1000 | R$ 0,50 = 50)
    • Dados de Retorno
      • Código de retorno da transação de cancelamento
      • Mensagem de retorno da transação de cancelamento
      • Código de retorno da solicitação de cancelamento gerado pela rede
      • TID - Número identificado único de transação
      • NSU - Numero sequencial retornado pela rede
      • Data da transação de cancelamento no formato YYYY-MM-DDthh:mm:ss.sTZD
      • Código identificador da transação de solicitação de cancelamento





 


Protótipo de Tela

Protótipo tela para informar dados de pagamento de cartão de crédito/débito

 

 

 Protótipo tela de pagamento concluído


 Protótipo tela pagamento não concluído


 

Fluxo do Processo

 



 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.