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"
- 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.
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
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
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 |
|---|
| tabs | Cadastro de Estação - TOTVS PDV, Cadastro de Estação SIGALOJA |
|---|
| ids | passo1,passo2 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| 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: 
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| 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:
| Chave | Descrição |
|---|
| PD | PAGTO DIGITAL | | PX | PIX |
- Cadastrar as Administradoras Financeiras associadas as Formas de Pagamento para que apareça a opção no momento da venda.

|
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:
ChaveDescriçãoPDPAGTO DIGITALPXPIX
Image RemovedObservaçõ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 |
|---|
| tabs | Venda com Pagamento Digital - TOTVS PDV, Cancelamento de Venda - TOTVS PDV, TEF - Gerenciais - TOTVS PDV, Venda com Pagamento Digital - SIGALOJA, Cancelamento de Venda - SIGALOJA, TEF - Gerenciais - SIGALOJA |
|---|
| ids | passo1,passo2,passo3,passo4,passo5,passo6 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| 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. 


|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| Cancelamento de Venda. 



|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
| TEF - Gerenciais (Pagamentos Digitais) 






|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo4 |
|---|
| Venda AssistidaVenda 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. 

|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo5 |
|---|
| Cancelamento da Venda 


|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo6 |
|---|
| 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 



|
|
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 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â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:
- 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
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>
|