Histórico da Página

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
Projeto¹		^IRM/EPIC1
^{Requisito/Story/Issue1}	http://jiraproducao.totvs.com.br/browse/FINANCEIRO01-4595	Subtarefa¹
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 maxiPago 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.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
  - mensagemretorno - Preenchido 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
  - 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)
  - 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
- Deverá ser montado o JSON de acordo com o manual de integração API RESTFul e-Rede
- Captura deverá ser automática
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

Projeto¹

^IRM/EPIC1

^{Requisito/Story/Issue1}

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

Subtarefa¹

País

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

( ) USA ( ) Colombia ( ) Outro _____________.

OutrosManual

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

- - 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
  - Deverá ser montado o XML do serviço "Venda Direta" de acordo com o Manual de integração e-commerce 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

Deverá ser montado o JSON de acordo com o manual de integração API RESTFul e-Rede
Captura deverá ser automática

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
  - Caso código do Pedido do Estabelecimento preenchido chamar GET: https://api.userede.com.br/erede/v1/transactions?reference=[código_pedido]
  - Caso TID preenchido chamar GET: https://api.userede.com.br/erede/v1/transactions?reference=[TID]
  - Detalhes no manual de integração API RESTFul e-Rede
- Chamada serviço getnet
  - Chamar serviço consultarDocumento conforme descrito no Manual de integração e-commerce getnet
- Chamada serviço maxiPago
  - chamar servico consulta "https://testapi.maxipago.net/ReportsAPI/servlet/ReportsAPI"
- 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
  - Deverá ser montado o JSON de acordo com o manual de integração API RESTFul e-Rede
- Chamada serviço getnet
  - chamar o serviço efetuarCancelamento conforme descrito no Manual de integração e-commerce getnet
- Chamada serviço maxiPago
  - Se data de cancelamento igual mesmo dia da transação
    - Chamar serviço Cancelamento (Void) de acordo com o Manual de integração e-commerce maxiPago
  - Se data de cancelamento diferente dia da transação
    - Chamar serviço Estorno (Refund) de acordo com o Manual de integração e-commerce 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.

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 11

Nova versão 103

Chave

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