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).
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
Os dados de acesso/configuração do Totvs RAAS devem ser obtidas junto ao departamento responsável da Totvs.
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.
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:
| 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.
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.
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
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" |
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:
| 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).
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas