Histórico da Página
CONTEÚDO
- Visão Geral
- Informações Importantes
- Funcionalidades
- Configuração
- Utilização
- Autorização de Pagamento Digital
- Cancelamento de Venda
- TEF - Gerenciais - Pagamentos Digitais"Gerencial Pagamento Digital"
- Autorização de Pagamento Digital
- Dados utilizados para conciliação
- Dicionário de Dados
- Tabelas utilizadas
01. VISÃO GERAL
Esta implementação tem como objetivo realizar transações de pagamento com Carteiras Digitais. Informacao Card documentos
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
e, SIGALOJA (Venda Assistida) e SIGAFAT (Venda Direta).
03. FUNCIONALIDADES
- Venda com Pagamento Digital.
- Cancelamento de Venda.
- TEF - Gerenciais - (Pagamentos Digitais).
- "Gerencial Pagamento Digital". - (SIGALOJA e TOTVS PDV)
- Qr-Code do PIX no PinPad pelo Venda Assistida
- Qr-Cod d PIX no PinPad do Totvs Pdv
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 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
Card documentos Informacao Os dados de acesso/configuração do Totvs RAC RAAS devem ser obtidas junto ao departamento responsável da Totvs. Titulo IMPORTANTE!
- 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.
Totvs custom tabs box | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
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
|
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
Campo | Descriçã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. |
0405. 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.
Totvs custom tabs box | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
|
|
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
Nota | ||
---|---|---|
| ||
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:
Tabela | Campo | Informação |
---|---|---|
SL4 | L4_DOCTEF | externalTransactionId |
SL4 | L4_AUTORIZ | processorTransactionId |
SE1 | E1_DOCTEF | externalTransactionId |
SE1 | E1_CARTAUT | processorTransactionId |
OBS: As informações de externalTransactionId e processorTransactionId 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 |
---|---|
Tipo | Caractere |
Descrição | Determina 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 |
---|---|
Tipo | Caractere |
Descrição | Determina qual a natureza será utilizada na geração de titulo referente a venda c/ Pagamento via PIX |
Valor padrão | "PIX" |
Nota | ||
---|---|---|
| ||
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:
Campo | MDG_PHCOMP |
---|---|
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Título | Companhia |
Descrição | Código da Companhia |
Help | Código da companhia. Esse código é responsável por vincular o Hub de Pagamentos Totvs Pagamento Digital ao adquirente. |
Campo | MDG_PHTENA |
---|---|
Tipo | Caractere |
Tamanho | 250 |
Decimal | 0 |
Título | Tenant |
Descrição | Tenant |
Help | Código de Tenant. Este código é o identificador da sua empresa no TOTVS RAC. |
Campo | MDG_PHUSER |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Título | Usuário |
Descrição | Usuário |
Help | Código do usuário do TOTVS RAC que solicitará o token de acesso para utilização do Hub de PagamentosTotvs Pagamento Digital . |
Campo | MDG_PHPSWD |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Título | Senha |
Descrição | Senha |
Help | Senha para acesso ao ambiente do TOTVS RAC. |
Campo | MDG_PHCLID |
---|---|
Tipo | Caractere |
Tamanho | 250 |
Decimal | 0 |
Título | Client ID |
Descrição | Client ID |
Help | Código do produto que será validado disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital. |
Campo | MDG_PHCLSR |
---|---|
Tipo | Caractere |
Tamanho | 250 |
Decimal | 0 |
Título | Cli. Secret |
Descrição | Client Secret |
Help | Senha do produto que será validado produto disponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital. |
Campo | MDG_PHPAGD |
---|---|
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Pgto.Digital |
Descrição | Habilita Pagto. Digital |
Opções | 1=Sim;2=Não |
Help | Indica se habilita Transação para Pagamentos Digitais. |
Habilita/desabilita transações de Pagamentos Digitais pelo Totvs Pagamento Digital do Varejo. |
- Campos (SX3) - Tabela SL1
Campo novo:
Campo | L1_VLRPGDG |
---|---|
Tipo | Numérico |
Tamanho | 15 |
Decimal | 2 |
Título | Vlr.Pag.Dig. |
Descrição | Total em Pagto. Digital |
Help | Valor pago em Pagamento Digital. |
- Campos (SX3) - Tabela SLV
Campos novos:
Campo | LV_TRNID |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Título | ID Transação |
Descrição | ID da Transação |
Help | Id da transação do Totvs Pagamento Digital. |
Campo | LV_TRNPCID |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Título | ID Trn. Proc |
Descrição | ID Transação Processador |
Help | Id da transação do processador do Totvs Pagamento Digital. |
Campo | LV_TRNEXID |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Título | ID Trn. Ext. |
Descrição | ID da Transação Externa |
Help | Id externa da transação do Totvs Pagamento Digital. |
- Campos (SX3) - Tabela SL4
Campos novos:
Campo | L4_TRNID |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Título | ID Transação |
Descrição | ID da Transação |
Help | Id da transação do Totvs Pagamento Digital. |
Campo | L4_TRNPCID |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Título | ID Trn. Proc |
Descrição | ID Transação Processador |
Help | Id da transação do processador do Totvs Pagamento Digital. |
Campo | L4_TRNEXID |
---|---|
Tipo | Caractere |
Tamanho | 100 |
Decimal | 0 |
Título | ID Trn. Ext. |
Descrição | ID da Transação Externa |
Help | Id externa da transação do Totvs Pagamento Digital. |
Campos alterados:
Campo | L4_BANDEIR |
---|---|
Tamanho | 40 |
Campo | L4_REDEAUT |
---|---|
Tamanho | 40 |
- Campos (SX3) - Tabela SAE
Campo alterado:
Campo | AE_ADMCART |
---|---|
Título | Bandeira |
Descrição | Cod. Retorno da Bandeira |
- Campos (SX3) - Tabela MDE
Campos alterados:
Campo | MDE |
---|
_CODSIT | |
---|---|
Tamanho | 40 |
Título | Cód. Retorno |
Descrição | Código de Retorno |
Campo | MDE_DESC |
---|---|
Tamanho | 60 |
Título | Descrição |
Descrição | Descr. como especificado |
Campo | MDE_TIPO |
---|---|
Título | Tipo Retorno |
Descrição | Tipo de Retorno |
Opções | CC=Crédito;CD=Débito;RD=Rede;PD=Pagamento Digital |
0806. TABELAS UTILIZADAS
MDE - Códigos de Retorno TEF
MDG - Configurador TEF
SAE - Administração Financeira
SL4 - Condição Negociada
SLG - Estações
IMPORTANTE: A tabela MDG deve obedecer o modo de compartilhamento da tabela SLG (Cadastro de estações).
HTML |
---|
<!-- esconder o menu --> <style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style> |