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 - "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.
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) a partir do Release 12.1.23, mediante a atualização do pacote acumulado do Varejo e dicionário com data maior que 02/06/2021. É imprescindível que o Ambiente esteja com a última atualização disponível de RPO e Binário.
Para o correto funcionamento do Conciliador Protheus (SITEF) aplicar os seguintes Pacotes:
- Release 12.1.23
Pacote acumulado: https://suporte.totvs.com/portal/p/10098/download#detail/749845
Pacote fontes conciliador: https://suporte.totvs.com/portal/p/10098/download?e=1025307
- Release 12.1.25
Pacote acumulado: https://suporte.totvs.com/portal/p/10098/download#detail/817562
Pacote fontes conciliador: https://suporte.totvs.com/portal/p/10098/download?e=1025308
- Release 12.1.27
Pacote acumulado: https://suporte.totvs.com/portal/p/10098/download#detail/954746
Pacote fontes conciliador: https://suporte.totvs.com/portal/p/10098/download?e=1025309
Obs: Necessário atualização de dicionário de dados, presente no pacote acumulado. Caso utilize TOTVS PDV, a atualização deve ser feita em ambos os ambientes, Retaguarda e PDV.
03. FUNCIONALIDADES
- Venda com Pagamento Digital.
- Cancelamento de Venda.
- TEF - Gerenciais - "Gerencial Pagamento Digital". - (SIGALOJA e 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 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 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
|
IMPORTANTE:
- As Formas de Pagamento deverão ser criadas na Tabela 06-TIPOS DE NUMERÁRIOS da SX5 do Protheus através do Módulo Configurador, obrigatoriamente com as seguintes descrições:
Chave | Descrição |
---|---|
PD | PAGTO DIGITAL |
PX | PIX |
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. |
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.
Totvs custom tabs box | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||
|
06. DADOS UTILIZADOS PARA CONCILIAÇÃO
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 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 Totvs 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 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 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 | 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 |
08. 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> |