Árvore de páginas

CONTEÚDO

  1. Visão Geral
  2. Informações Importantes
  3. Funcionalidades
  4. Configuração 
  5. Utilização
    1. Autorização de Pagamento Digital
    2. Cancelamento de Venda
    3. TEF - Gerenciais - "Gerencial Pagamento Digital"
  6. Dados utilizados para conciliação
  7. Dicionário de Dados
  8. Tabelas utilizadas


01. VISÃO GERAL

Esta implementação tem como objetivo realizar transações de pagamento com Carteiras Digitais.

Premissa: Este produto deve ser previamente contratado com a equipe do TOTVS Pagamentos Digitais, saiba mais pelo link: https://produtos.totvs.com/ficha-tecnica/totvs-pagamento-instantaneo/

02. INFORMAÇÕES IMPORTANTES

Essa funcionalidade está disponível apenas para o TOTVS PDV, SIGALOJA (Venda Assistida) e SIGAFAT (Venda Direta).

03. FUNCIONALIDADES

04. CONFIGURAÇÃO

Cadastro de Estação:

Através da nova guia Totvs Pagamentos Digitais disponível na tela de configuração do TEF no cadastro de Estação (LOJA121), é possível realizar a configuração para habilitar o uso desta implementação. 

Essa implementação faz uso da solução TOTVS RAC para autenticação e atribuição de autorizações desse serviço.

  • Para mais informações sobre a solução do TOTVS RAC verificar as seguintes documentações:  TOTVS Pagamentos

IMPORTANTE!

Os dados de acesso/configuração do Totvs RAAS devem ser obtidas junto ao departamento responsável da Totvs.

  • Para obter o código identificador do PDV para o TOTVS Pagamentos digitais acesse o cadastro de estação e localize o campo "Estação" (LG_CODIGO) conforme imagem abaixo.

Configuração Cadastro de Estação - TOTVS PDV.

Companhia: <Código da Unidade de negócio cadastrada no RAAS (Identificador externo)>, podendo ser um código a escolha do cliente, de preferência com tamanho de 8 dígitos.

Exemplo: 


Tenant: <Nome contido no link de acesso ao RAAS>

Exemplo: 

Usuário: Id de usuário com acesso ao RAAS.

Senha: Senha do usuário cadastrada no RAAS

Client Id: Preenchimento automático

Cli. Secret: Preenchimento automático.


IMPORTANTE:

No TOTVS PDV, para o funcionamento do TOTVS Pagamentos Digitais é necessário que o TEF esteja ativo no Cadastro da Estação utilizada, caso não trabalhe com nenhum TEF (Pay&Go, Sitef), não é necessário o preenchimento dos demais campos, somente deixar como habilitado, conforme o exemplo abaixo:

Configuração Cadastro de Estação - SIGALOJA.

Companhia: <Código da Unidade de negócio cadastrada no RAAS (Identificador externo)>

Exemplo: 

Tenant: <Nome contido no link de acesso ao RAAS>

Exemplo: 

Usuário: Id de usuário com acesso ao RAAS.

Senha: Senha do usuário cadastrada no RAAS



IMPORTANTE:

É necessário que a opção "Usa TEF" esteja ativa nas Configurações do Usuário "Caixa" para utilização do Totvs Pagamentos Digitais no Venda Assistida.

   

 Forma de Pagamento:

     Após realizar o cadastro na estação, deverá ser criada as novas Formas de Pagamentos para a utilização das Carteiras Digitais, uma para os Pagamentos Digitais (Carteiras) e outra para o PIX.

     Para criação, siga a orientação do documento Cadastro de nova forma de pagamento

  •  As Formas de Pagamento deverão ser criadas na Tabela 24 e 05 da SX5 do Protheus através do Módulo Configurador, obrigatoriamente com as seguintes descrições:
ChaveDescrição
PDPAGTO DIGITAL
PXPIX
  •  Cadastrar as Administradoras Financeiras associadas as Formas de Pagamento para que apareça a opção no momento da venda.



Observações:

A inclusão das Formas de Pagamentos na Tabela 06-TIPOS DE NUMERÁRIOS, da SX5, se faz necessário devido serem usadas nos Detalhes de Crédito(Vendas), das rotinas Resumo de Caixa(LOJC030 e LOJC130).


Após ter os dados de configuração do Totvs RAC, basta informá-los nos campos, conforme demonstrado abaixo, para obtenção do token no momento de uso desta funcionalidade.

Campos

CampoDescrição
Companhia (MDG_PHCOMP)Código da companhia. Esse código é responsável por vincular o PDV ao Totvs Pagamento Digital.
Tenant (MDG_PHTENA)Código de Tenant. Este código é o identificador da sua empresa no Totvs RAC.
Usuário (MDG_PHUSER)

Código do usuário do TOTVS RAC que solicitará o token de acesso para utilização do Totvs Pagamento Digital .

Senha (MDG_PHPSWD)Senha para acesso ao ambiente do Totvs RAC.
Client ID (MDG_PHCLID)Código do produto disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital.
Cli. Secret (MDG_PHCLSR)Senha do produto disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital.
Pagamento Digital (MDG_PHPAGD)Habilita ou desabilita operações de transação com Pagamento Digital.


05. UTILIZAÇÃO

Abaixo, em cada aba está disponível através de ilustrações como são realizadas as operações utilizando esta implementação.


A seguir temos as ilustrações demonstrando o processo de uma venda, onde o pagamento foi realizado com PIX.


Informe o produto:

No painel de pagamentos selecione a Forma PIX:

Efetue o pagamento utilizando o aplicativo do banco.



Exemplo de venda com pagamento realizado com Pagamentos Digitais:

Informe o produto:


No painel de pagamentos selecione a Forma Pagto Digital:


Serão apresentadas as carteiras disponíveis para uso, selecione a desejada e efetue o pagamento.






Cancelamento de Venda.

TEF - Gerenciais (Pagamentos Digitais)



Venda Assistida

Venda com pagamento em PIX:


Na tela de Pagamentos, selecione a Forma PIX.

Na finalização da venda será apresentado o QR-Code para o pagamento.


Venda com pagamento em Pagamento Digital:


Na tela de Pagamentos, selecione a Forma Pagto. Digital.


Escolha a carteira desejada.

Na finalização da venda será apresentado o QR-Code para o pagamento.









Cancelamento da Venda




TEF - Gerenciais (Pagamentos Digitais)

Em Consultas>TEF>Rotinas TEF


O estorno pode ser feito indicando o numero de documento e série ou o código de referência da transação.

Exemplo de código de referência:

Informar somente a parte destacada em vermelho.




Reimpressão





Dica

Além da exibição do QR-Code na tela do sistema, existe a possibilidade de exibição do QR-Code no equipamento PinPad. Veja mais nos links abaixo:

Totvs PDV: DT Exibir Qr-Code do PIX no PinPad do Totvs Pdv quando utiliza o Totvs Pagamentos Digitais

Venda Assistida: DT Exibir Qr-Code do PIX no PinPad pelo Venda Assistida quando utiliza o Totvs Pagamentos Digitais


06.  DADOS UTILIZADOS PARA CONCILIAÇÃO

Observação:

Os títulos referente a PIX (PX) e Pagamento Digital (PD) são gerados em aberto, sendo necessário realizar a conciliação para que a baixa seja efetivada.

Os campos citados a baixo são utilizados no processo de conciliação dos títulos:

TabelaCampoInformação
SL4L4_DOCTEFexternalTransactionId
SL4L4_AUTORIZprocessorTransactionId
SE1E1_DOCTEFexternalTransactionId
SE1E1_CARTAUTprocessorTransactionId


OBS: As informações de externalTransactionIdprocessorTransactionId são retornados pela processadora da transação.


Mais sobre a Rotina de Conciliação:

 Conciliador Pagamentos e Vendas - Financeiro (Contas a Receber) - P12


07. DICIONÁRIO DE DADOS

  • Parâmetros (SX6)

Parâmetro novo:

Nome do Parâmetro

MV_NATPGDG
TipoCaractere
DescriçãoDetermina qual a natureza será utilizada na geração de titulo referente a venda c/ Pagamento Digital
Valor padrão"PAGDIGITAL"

Nome do Parâmetro

MV_NATPGPX
TipoCaractere
DescriçãoDetermina qual a natureza será utilizada na geração de titulo referente a venda c/ Pagamento via PIX
Valor padrão"PIX"

Atenção

As naturezas "PAGDIGITAL" e "PAGTOPIX" são criadas automaticamente ao acessar o sistema Controle de Lojas (SIGALOJA), caso o sistema esteja atualizado com o pacote desta funcionalidade. Se preferir, podem ser criadas as naturezas de sua preferência e associá-la aos parâmetros MV_NATPGDG e MV_NATPGPX.

Essa configuração de natureza é necessária apenas no ambiente da Retaguarda (incluindo ambiente onde é executado o Job LjGrvBatch) ou em ambiente onde são utilizadas as rotinas Venda Assistida ou Venda Direta.

No ambiente do Totvs PDV não é necessário fazer essa configuração.


  • Campos (SX3) - Tabela MDG

Campos novos:

CampoMDG_PHCOMP
TipoCaractere
Tamanho8
Decimal0
TítuloCompanhia
DescriçãoCódigo da Companhia
Help

Código da companhia. Esse código é responsável por vincular o Totvs Pagamento Digital ao adquirente.

CampoMDG_PHTENA
TipoCaractere
Tamanho250
Decimal0
TítuloTenant
DescriçãoTenant
Help

Código de Tenant. Este código é o identificador da sua empresa no TOTVS RAC.

CampoMDG_PHUSER
TipoCaractere
Tamanho100
Decimal0
TítuloUsuário
DescriçãoUsuário
Help

Código do usuário do TOTVS RAC que solicitará o token de acesso para utilização do Totvs Pagamento Digital .

CampoMDG_PHPSWD
TipoCaractere
Tamanho100
Decimal0
TítuloSenha
DescriçãoSenha
Help

Senha para acesso ao ambiente do TOTVS RAC.

CampoMDG_PHCLID
TipoCaractere
Tamanho250
Decimal0
TítuloClient ID
DescriçãoClient ID
Help

Código do produto disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital.

CampoMDG_PHCLSR
TipoCaractere
Tamanho250
Decimal0
TítuloCli. Secret
DescriçãoClient Secret
Help

Senha do produto disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital.

CampoMDG_PHPAGD
TipoCaractere
Tamanho1
Decimal0
TítuloPgto.Digital
DescriçãoHabilita Pagto. Digital
Opções1=Sim;2=Não
Help

Habilita/desabilita transações de Pagamentos Digitais pelo Totvs Pagamento Digital do Varejo.


  • Campos (SX3) - Tabela SL1

Campo novo:

Campo

L1_VLRPGDG

TipoNumérico
Tamanho15
Decimal2
TítuloVlr.Pag.Dig.
DescriçãoTotal em Pagto. Digital
Help

Valor pago em Pagamento Digital.


  • Campos (SX3) - Tabela SLV

Campos novos:

Campo

LV_TRNID

TipoCaractere
Tamanho100
Decimal0
TítuloID Transação
DescriçãoID da Transação
Help

Id da transação do Totvs Pagamento Digital.

Campo

LV_TRNPCID

TipoCaractere
Tamanho100
Decimal0
TítuloID Trn. Proc
DescriçãoID Transação Processador
Help

Id da transação do processador do Totvs Pagamento Digital.

Campo

LV_TRNEXID

TipoCaractere
Tamanho100
Decimal0
TítuloID Trn. Ext.
DescriçãoID da Transação Externa
Help

Id externa da transação do Totvs Pagamento Digital.


  • Campos (SX3) - Tabela SL4

Campos novos:

Campo

L4_TRNID

TipoCaractere
Tamanho100
Decimal0
TítuloID Transação
DescriçãoID da Transação
Help

Id da transação do Totvs Pagamento Digital.

Campo

L4_TRNPCID

TipoCaractere
Tamanho100
Decimal0
TítuloID Trn. Proc
DescriçãoID Transação Processador
Help

Id da transação do processador do Totvs Pagamento Digital.

Campo

L4_TRNEXID

TipoCaractere
Tamanho100
Decimal0
TítuloID Trn. Ext.
DescriçãoID da Transação Externa
Help

Id externa da transação do Totvs Pagamento Digital.


Campos alterados:

Campo

L4_BANDEIR

Tamanho40

Campo

L4_REDEAUT

Tamanho40


  • Campos (SX3) - Tabela SAE

Campo alterado:

Campo

AE_ADMCART

TítuloBandeira
DescriçãoCod. Retorno da Bandeira


  • Campos (SX3) - Tabela MDE

Campos alterados:

Campo

MDE_CODSIT

Tamanho40
TítuloCód. Retorno
DescriçãoCódigo de Retorno

Campo

MDE_DESC

Tamanho60
TítuloDescrição
DescriçãoDescr. como especificado

Campo

MDE_TIPO

TítuloTipo Retorno
DescriçãoTipo de Retorno
OpçõesCC=Crédito;CD=Débito;RD=Rede;PD=Pagamento Digital


08. TABELAS UTILIZADAS

  • MDE - Códigos de Retorno TEF

  • MDG - Configurador TEF

  • SAE - Administração Financeira

  • SL4 - Condição Negociada

  • SLG - Estações

IMPORTANTEA tabela MDG deve obedecer o modo de compartilhamento da tabela SLG (Cadastro de estações).