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"
- 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. Card documentos |
Informacao
Essa funcionalidade está disponível apenas para o TOTVS PDV
e , SIGALOJA (Venda Assistida) e SIGAFAT (Venda Direta).
Titulo | IMPORTANTE! |
0203. FUNCIONALIDADES
- Venda com Pagamento Digital.
- Cancelamento de Venda.
- TEF - Gerenciais - (Pagamentos Digitais).
0304. 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.
Image Added
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: Image Added
Tenant: <Nome contido no link de acesso ao RAAS> Exemplo: Image Added 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. Image Added
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: Image Added
|
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: Image Added
Tenant: <Nome contido no link de acesso ao RAAS> Exemplo: Image Added Usuário: Id de usuário com acesso ao RAAS. Senha: Senha do usuário cadastrada no RAAS
Image Added
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. Image Added
|
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.
Image Added
|
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 |
Hub de Pagamentos ao adquirentePDV 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 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 |
que será validado no Totvs RACdisponível no TOTVS RAC vinculado à funcionalidade do Totvs Pagamento Digital. |
Cli. Secret (MDG_PHCLSR) | Senha do |
produto que será validado no Totvs RACproduto 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 |
---|
tabs | Venda com Pagamento Digital - TOTVS PDV, Cancelamento de Venda - TOTVS PDV, TEF - Gerenciais - Pagamentos Digitais- 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 Pagamento Digital. Image Removed
Image Removed
Image Removed
Image Removed
Image Removed
Image Removed
Image Removed
Image Removed
PIX.
Informe o produto: Image Added
No painel de pagamentos selecione a Forma PIX: Image Added
Efetue o pagamento utilizando o aplicativo do banco. Image Added
Image Added
Exemplo de venda com pagamento realizado com Pagamentos Digitais: Informe o produto: Image Added
No painel de pagamentos selecione a Forma Pagto Digital: Image Added
Serão apresentadas as carteiras disponíveis para uso, selecione a desejada e efetue o pagamento. Image Added
Image Added
Image Added Image Removed
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Cancelamento de Venda. Image Removed Image Added
Image Removed Image Added
Image Removed
Image Removed
Image Removed
Image Removed
Image Removed
Image Removed
Image Removed
Image Added
Image Added Image Removed
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| TEF - Gerenciais (Pagamentos Digitais) Image Modified
Image Modified
Image Modified
Image Modified
Image Modified
Image Modified
Image Modified
Image Removed
|
|
05. DICIONÁRIO DE DADOS Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| Venda AssistidaVenda com pagamento em PIX:
Na tela de Pagamentos, selecione a Forma PIX. Image Added
Na finalização da venda será apresentado o QR-Code para o pagamento. Image Added
Image Added
Venda com pagamento em Pagamento Digital:
Na tela de Pagamentos, selecione a Forma Pagto. Digital. Image Added
Escolha a carteira desejada. Image Added
Na finalização da venda será apresentado o QR-Code para o pagamento. Image Added
Image Added
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo5 |
---|
| Cancelamento da Venda Image Added
Image Added
Image Added
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo6 |
---|
| TEF - Gerenciais (Pagamentos Digitais) Em Consultas>TEF>Rotinas TEF Image Added
Image Added
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. Image Added
Image Added
Image Added
Image Added
Reimpressão Image Added
Image Added
Image Added
Image Added
|
|
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â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. |
Campos alterados:
- Campos (SX3) - Tabela MDE
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 |
0806. 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>
|