Configurando integração URA com Pagar.me

---

Pré-requisito.

Para utilizar esse recurso é necessário que as aplicações Tactium IP e CRM estejam instaladas e que haja canais de URA disponíveis. Outro pré-requisito importante é que a API do Pagar.me esteja na versão versão 4 – 2019-09-01.

Objetivo

Este documento tem como objetivo o entendimento de como realizar as configurações necessárias para integrar com a Web API do Pagar.me obtendo informações através do Tactium Manager e realizando os pagamentos através da URA do Tactium IP.

Modo privilegiado Tactium CRM

Deverá ser criada uma ficha de atendimento com o nome físico “FCH_COMERCIAL” nesta ficha deverá ser criadas duas abas “DADOS DO PAGAMENTO” para informações relacionadas ao envio e a “DADOS DE COBRANÇA” relacionadas aos dados de Pagamento.

Para habilitar o Campo nome físico é necessário habilitar o modo privilegiado no Manager Desktop. Ao acessar o Menu opções clique em Modo privilegiado, será apresentada uma tela solicitando a senha de acesso ao modo privilegiado: PRV30CB

Modelagem CRM

Deverá ser criada uma ficha de atendimento com o nome físico “FCH_COMERCIAL” nesta ficha deverá ser criadas duas abas “DADOS DO PAGAMENTO” para informações relacionadas ao envio e a “DADOS DE COBRANÇA” relacionadas aos dados de Pagamento.

Dados do pagamento

Detalhamento dos campos da aba dados do pagamento

Forma de Pagamento

• • Nome: Pagamento
    • Nome Físico: PAGAMENTO1
    • Tipo: Opções
    • Lista de opções:
      • Boleto
      • Depósito
      • À Vista
      • Cartão

• Nome: Parcelas
  • Nome Físico: PARCELAS1
  • Tipo: Lista
  • Cadastro: Parcelas
  • Campo do Cadastro: Quantidade de Parcelas

• Nome: Valor da Compra
  • Nome Físico: VALOR_COMPRA1
  • Tipo: Numérico
  • Tamanho: 9
  • Decimais: 2

• Nome: Frete
  • Nome Físico: FRETE
  • Tipo: Numérico
  • Tamanho: 9
  • Decimais: 2

• Nome: Parcelas
  • Nome Físico: PARCELAS1
  • Tipo: Fórmula
  • Decimais: 2
  • Fórmula: (<<FRETE>>+<<Valor_da_Compra>>)/<<PARCELAS>>

• Nome: Total da Compra
  • Nome Físico: TOTAL_COMPRA
  • Tipo: Fórmula
  • Decimais: 2
  • Fórmula: <<Valor_da_Compra>>+<<FRETE>>

Forma de Pagamento 2

• • Nome: Pagamento2
    • Nome Físico: PAGAMENTO2
    • Tipo: Opções
    • Lista de opções:
      • Boleto
      • Depósito
      • À Vista
      • Cartão

• Nome: Parcelas2
  • Nome Físico: PARCELAS2
  • Tipo: Lista
  • Cadastro: Parcelas
  • Campo do Cadastro: Quantidade de Parcelas

• Nome: Valor da Compra2
  • Nome Físico: VALOR_COMPRA_2
  • Tipo: Numérico
  • Tamanho: 9
  • Decimais: 2

• Nome: Parcelas2
  • Nome Físico: PARCELAS2
  • Tipo: Fórmula
  • Decimais: 2
  • Fórmula: <<Valor_da_Compra2>>/<<PARCELAS2>>

Dados da Entrega

• Nome: Endereço de Entrega
  • Nome Físico: SHIPPING_STREET
  • Tipo: Texto Curto
  • Tamanho: 255
  • Somente Leitura: Sim
  • Conteúdo automático: Sim
    • Vínculo: Dados Cadastrais
    • Campo: Endereço

• Nome: Cidade
  • Nome Físico: SHIPPING_CITY
  • Tipo: Texto Curto
  • Tamanho: 200
  • Somente Leitura: Sim
  • Conteúdo automático: Sim
    • Vínculo: Dados Cadastrais
    • Campo: Município

• Nome: Bairro
  • Nome Físico: BAIRRO_ENTREGA
  • Tipo: Texto Curto
  • Tamanho: 200
  • Somente Leitura: Sim
  • Conteúdo automático: Sim
    • Vínculo: Dados Cadastrais
    • Campo: Bairro

• Nome: CEP
  • Nome Físico: SHIPPING_ZIPCODE
  • Tipo: Texto Curto
  • Tamanho: 20
  • Somente Leitura: Sim
  • Conteúdo automático: Sim
    • Vínculo: Dados Cadastrais
    • Campo: Cep

• Nome: Estado
  • Nome Físico: SHIPPING_STATE
  • Tipo: Texto Curto
  • Tamanho: 2
  • Somente Leitura: Sim
  • Conteúdo automático: Sim
    • Vínculo: Dados Cadastrais
    • Campo: UF

• Nome: Entrega Express
  • Nome Físico: SHIPPING_EXPEDITED
  • Tipo: Lógico

• Nome: Número
  • Nome Físico: SHIPPING_STREETNUMBER
  • Tipo: Texto Curto
  • Tamanho: 20

• Nome: País
  • Nome Físico: SHIPPING_COUNTRY
  • Tipo: Texto Curto
  • Tamanho: 20

• Nome: Referência
  • Nome Físico: SHIPPING_NEIGHBORHOOD
  • Tipo: Texto Curto
  • Tamanho: 200
  • Somente Leitura: Sim
  • Conteúdo automático: Sim
    • Vínculo: Dados Cadastrais
    • Campo: Ponto de Referência

• Nome: Nome
  • Nome Físico: SHIPPING_NAME
  • Tipo: Texto Curto
  • Tamanho: 200
  • Somente Leitura: Sim
  • Conteúdo automático: Sim
    • Vínculo: Dados Cadastrais
    • Campo: Nome / Denominação Social

• Nome: Data Envio
  • Nome Físico: SHIPPING_DATE
  • Tipo: Data

• Nome: Valor Envio
  • Nome Físico: SHIPPING_FREE
  • Tipo: Fórmula
  • Fórmula: <<FRETE>>*100

• Nome: Consultar Frete
  • Tipo: Informação externa
  • Salvar Ocorrência: Sim
  • Refresh no retorno: Sim
  • Localização: http://logistica.editorasantuario.com.br/api/v1/produtos/calcularfretetactium?
  • Parâmetos:
    • Ord: 0
    • Vínculo: Número Ocorrência
    • Nome: IS_ITA
    • Valor:

Ativar Integração de Pagamento URA

• • Nome: Ativar Integração de Pagamento
    • Tipo: Informação externa
    • Salvar Ocorrência: Sim
    • Refresh no retorno: Sim
    • Stored Procedure: Sim
    • Localização: PR_EDTSANT_ATIVAR_PAGARME
    • Parâmetros:
      • Ord: 0
      • Vínculo: Código da Ocorrência
      • Nome: @IdOcorrencia
      • Valor: 

• Nome: Ocorrência PAGAR.ME
  • Nome Físico: TP_ATIVA_PAGARME
  • Tipo: Lógico
  • Somente Leitura: Sim

Dados de cobrança

Detalhamento dos campos da aba dados do cobrança

Dados para cobrança

• Nome: Valor do Cartão
  • Nome Físico: CARD_AMOUNT
  • Tipo: Fórmula
  • Formúla: <<Total_da_Compra>>*100

• Nome: Parcelas
  • Nome Físico: QTD_PARCELAS
  • Tipo: Lista

FALTA TERMINAR

• Nome: Nome
  • Nome Físico: name
  • Tipo: Texto Curto
  • Tamanho: 200

• Nome: Nome do Titular
  • Nome Físico: CARD_HOLDER_NAME
  • Tipo: Texto Curto
  • Tamanho: 200

• Nome: País
  • Nome Físico: COUNTRY
  • Tipo: Texto Curto
  • Tamanho: 200

• Nome: UF
  • Nome Físico: STATE
  • Tipo: Texto Curto
  • Tamanho: 2

• Nome: Cidade
  • Nome Físico: CITY
  • Tipo: Texto Curto
  • Tamanho: 200

• Nome: Bairro
  • Nome Físico: NEIGHBORHOOD
  • Tipo: Texto Curto
  • Tamanho: 200

• Nome: Rua
  • Nome Físico: STREET
  • Tipo: Texto Curto
  • Tamanho: 200

• Nome: Número
  • Nome Físico: STREET_NUMBER
  • Tipo: Texto Curto
  • Tamanho: 20

• Nome: CEP
  • Nome Físico: ZIPCODE
  • Tipo: Numérico
  • Tamanho: 8
  • CEP: Sim

Retorno cobrança

• Nome: Status Pagamento
  • Nome Físico: STATUS_PAGAMENTO
  • Tipo: Texto Curto
  • Tamanho: 200
  • Somente Leitura: Sim

• Nome: Informação do Pagamento
  • Nome Físico: INF_PAGAMENTO
  • Tipo: Texto Longo
  • Somente Leitura: Sim

Configurando as Procedures

Deveram ser criada duas procedures no banco de dados do CRM “PR_EDTSANT_GERA_PRM_PAGARME” para consumir o WebService do pagar.me (será chamada na URA a partir do Web API do Tactium CRM) e a “PR_EDTSANT_ATIVAR_PAGARME” para definir qual a ocorrência será utilizada para realizar o pagamento (será chamada no botão do NewManager antes de realizar a transferência do cliente para a URA).

Estas procedures estão disponibilizadas no link abaixo:

Link procedures Pagar.me

Criando a Árvore de URA

Deverá ser criada uma arvore de URA que chame método “AcionarIntegracaoPagarMe” para receber os dados do cartão de crédito e efetivar o pagamento via cartão de crédito.

Detalhamento das variáveis solicitadas na URA

• Nome: CPF
  • Tipo de vocalização: Número pausado
  • Quantidade de cifras: 11

• Nome: numeroCartao
  • Tipo de vocalização: Número pausado
  • Quantidade de cifras: 16

• Nome: validadeCartao
  • Tipo de vocalização: Número pausado
  • Quantidade de cifras: 4

• Nome: codCVV
  • Tipo de vocalização: Número pausado
  • Quantidade de cifras: 3

• Nome: RetornoRequisicao
  • Tipo de vocalização: Texto
  • Retorno possíveis: TrOk, TrError e TrWarning

• Nome: MensagenRetorno
  • Tipo de vocalização: Texto

Cadastrando a Configuração e Ação Externa do WebService na URA

Deverá ser cadastrada a URL de acesso ao WSDL do WebService. Segue abaixo o nome padrão da URL, porém pode mudar de acordo como endereço da Web API do Tactium CRM que foi instalado.

Geralmente chamamos de ManagerWS ou CentralIntegracao.

Por exemplo: http://IP_SERVIDOR_DO_CLIENTE/ManagerWS/wsTactiumIntegracao.asmx?WSDL (Se o Tactium IP estiver no mesmo servidor da Web API do Tactium CRM, pode-se usar localhost).

Parâmetros de entrada

• Nome: Command
  • Tipo: Valor Fixo
  • Valor: AcionarIntegracaoPagarMe

• Nome: Servico
  • Tipo: Valor Fixo
  • Valor: wsTactiumIntegracao

• Nome: numeroCartao
  • Tipo: Variável
  • Valor: numeroCartao

• Nome: codCVV
  • Tipo: Variável
  • Valor: codCVV

• Nome: validaCartao
  • Tipo: Variável
  • Valor: validaCartao
• Nome: CPF
  • Tipo: Variável
  • Valor: CPF

Parâmetros de saída

• Nome: RetornoRequisicao
  • Tipo: Variável
  • Valor: RetornoRquisicao

• Nome: MensagemRetorno
  • Tipo: Variável
  • Valor: MensagemRetorno

Configurando a chamada do WebService na URA

Conforme podemos ver abaixo a chamada do We Service na URA deverá ser cadastrada logo após a solicitação dos dados do cliente, para que o Web service posso efetivar a transação:

Operacionalizando com a Toolbar

Para encaminhar uma ligação para efetivar pagamento na URA o operador deverá clicar no botão “ATIVAR INTEGRAÇÃO DE PAGAMENTO” a página do NewManager será recarregada e o checkbox “OCORRÊNCIA PAGARME” será ativo.

Na sequência o operador deverá realizar uma transferência com espera para o URA assim que a transação for efetivada a URA irá desligar a chamada e a mesma retornará para o mesmo operador.