Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

 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

Rede : Manual de integração API RESTFul e-Rede

getnet: Manual de integração e-commerce getnet

maxiPago: Manual de integração e-commerce maxiPagohttps://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.online disponíveis no mercado. (e-Rede, getnet, maxiPago)

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-Redecommerce" 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-Rededa adquirente

A solução TOTVS e-Rede commerce 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:
    • Adquirente (e-Rede ou GetNet ou maxiPago)
    • Numero de Filiação (PV) -  criptografados no formato base64Token -  criptografados no formato base64   
    • Token/Chave Acesso  
    • 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
  • Validações
    • Deverá ser feita a validação, através de javascript de qual bandeira o cartão pertence
  • Ação
    • Ao finalizar o pagamento será chamado do webservice o serviço de criação de transaçã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&numparcelas=3)
      • 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)
      • numparcelas - Numero de Parcela da Transação
      • bandeira (Vide tópico abaixo "Identificação da Bandeira do cartão")
    • Caso parâmetro de entrada "URL de retorno a pagina do estabelecimento" não esteja preenchida, será chamada a web-page padrão de transação concluída ou não concluída conforme especificado mais abaixo
  • Chamada serviço e-Rede
  • Chamada serviço getnet

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-redeadquirente:

  • Serviço de Criação da Transação
    • Dados de Entrada
      • URL Adquirente (e-Rede ou GetNet ou maxiPago)
      • Numero de Filiação (PV)
      • Token / Chave Acesso
      • URL (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 Removed

 

 Protótipo tela de pagamento concluído

Image Removed

 Protótipo tela pagamento não concluído

Image Removed

 

    • Chamada serviço e-Rede
      • Deverá ser montado o JSON de acordo com o manual

Fluxo do Processo

 Image Removed

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

OutrosManual

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.

      • Captura deverá ser automática
    • Chamada serviço getnet
      • Deverá ser montado o XML de acordo com o Manual de integração e-commerce getnet
      • Se tipo de transação igual a crédito
        • Para crédito chamar o serviço efetuarcredito
      • Se tipo de transação igual a débito
        • Verificar se o emissor do cartão suporta autenticação. Chamar o serviço verificarInscricacaoMPI
        • Se bandeira\emissor do cartão suporta autenticação:
          • Direcionar usuário para url de retorno do banco emissor do cartão
          • Se autenticação ocorrer com sucesso
            • chamar o serviço efetuarDebito (Vide abaixo diagrama de sequencia "Efetuar pagamento cartão débito getnet")
        • Se bandeira\emissor não suporta autenticação
          • Avisar usuário
          • Retornar para pagina de digitação de dados do cartão
    • Chamada serviço maxiPago

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
        • Adquirente (e-Rede/GetNet)
        • Numero de Filiação (PV)
        • Token / Chave Acesso
        • Código do Pedido do Estabelecimento ou;
        • TID - Numero identificador único da transação

      • Chamada serviço e-Rede
      • Chamada serviço getnet
      • Chamada serviço maxiPago
      • 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)
      • Chamada serviço e-Rede
      • Chamada serviço getnet
      • Chamada serviço maxiPago
      • Dados de Retorno
        • Código de retorno da transação de 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
     

    Identificação da Bandeira do cartão

    • ELO
      • Começa com: 636368, 438935, 504175, 451416, 509048, 509067, 509049, 509069, 509050, 509074, 509068, 509040, 509045, 509051, 509046, 509066, 509047, 509042, 509052, 509043, 509064, 509040, 36297, 5067 ,4576 ,4011   
    • Discover
      • Começa com: 6011, 622, 64, 65
    • Diners
      • Começa com: 301, 305, 36, 38
    • AMEX
      • Começa com: 34, 37
    • AURA
      • Começa com: 50
    • JCB
      • Começa com: 35
    • Hypercard
      • Começa com: 38, 60
    • Visa
      • Começa com: 4
    • MasterCard
      • Começa com 5





    Protótipo de Tela

    *Solicitar ajuda do Design Lucas para criação das telas

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

     Image RemovedImage Added

     

     Protótipo tela padrão de pagamento concluído

    Image AddedImage Removed

     Protótipo tela padrão de pagamento não concluído

    Image AddedImage Removed

     

    Fluxo do Processo

     Image RemovedImage Added


    Image Added

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