Links de Pagamento¶

Financeiro > Links de Pagamento

O que é¶

Links de Pagamento é o módulo que gerencia cobranças remotas via gateway OfficePay. A partir de um Pedido, Ordem de Serviço ou Condicional com forma de pagamento do tipo Link, o sistema cria um registro de link que pode ser enviado ao cliente por WhatsApp ou e-mail. O cliente paga online (PIX, cartão etc.) e o sistema sincroniza automaticamente o pagamento, gerando os lançamentos financeiros correspondentes.

Como acessar¶

No menu principal, clique em Financeiro → Links de Pagamento.

Onde impacta o sistema¶

Tabela LINKS_PGTO — armazena cada link gerado com seus dados, URL e status.
Tabela CTARECEB — ao quitar, o link pode gerar registro em contas a receber (CR_OPERACAOTEF).
Tabela MOVMCAIXA — ao quitar, pode gerar movimentação de caixa (MX_CTRLCTS via OPERACOESTEF).
Tabela OPERACOESTEF — vincula o link ao pagamento processado pelo gateway (OT_LINK).
Pedidos, OS e Condicionais — ao cancelar um link, o sistema desvíncula automaticamente o link dos documentos de origem.
Parâmetros (PARAMETROS.PA_ID = 'OfficePay.Links') — controla quais filiais têm o recurso habilitado.

Como criar um link de pagamento¶

Links não são criados manualmente nesta tela. Para gerar um link:

Acesse o Pedido, Ordem de Serviço ou Condicional desejado.
Na tela de pagamento, selecione um tipo de pagamento configurado como Link.
O sistema registra o link na tabela LINKS_PGTO e exibe-o nesta tela para gerenciamento.

Ao clicar em Novo nesta tela, o sistema exibe: Para criar um link de pagamento você deve efetuar o pagamento de um Pedido, OS ou Condicional com um tipo de pagamento do tipo "Link".

Como gerar a URL do link¶

Após o registro existir na tela:

Localize o link na grade de consulta e acesse o cadastro.
Clique em Gerar Link.
O sistema comunica-se com o gateway OfficePay (exibe a mensagem de espera Aguarde, criando link...) e preenche o campo Link com a URL gerada.
Compartilhe o link com o cliente usando:
Copiar URL — copia a URL para a área de transferência.
Abrir no Navegador — abre a URL no navegador padrão.
WhatsApp — abre o WhatsApp Web com a mensagem: Segue link para pagamento: [URL].

Como verificar pagamentos recebidos¶

Acesse a aba Verificar Pagamentos.
Clique em Verificar Pagamentos.
O sistema consulta o gateway (exibe Aguarde, atualizando links...) e lista os links quitados desde a última sincronização.
Se nenhum link foi quitado, exibe: Nenhum link quitado desde a última sincronização.

A data da última sincronização é armazenada no parâmetro OfficePay.Links.UltimaSincronizacao e atualizada a cada verificação bem-sucedida.

Como cancelar um link¶

Acesse o cadastro do link desejado.
Clique em Cancelar Link (disponível apenas para links com status Aberto e dentro da validade).
Confirme a mensagem: Tem certeza que deseja cancelar este Link? Fazendo isso ele não poderá mais ser pago e será removido de todos locais onde foi utilizado.
Ao confirmar, o sistema cancela o link no gateway e desvincula o link do documento de origem (Pedido, OS ou Condicional).
Mensagem de confirmação: Link cancelado com sucesso.

Campos desta tela¶

Campo	O que é	Observações
Código	Número interno do link	[`LINKS_PGTO.LI_CODIGO`] Gerado automaticamente (generator `GEN_LINKS_PGTO`).
Descrição	Texto descritivo do link	[`LINKS_PGTO.LI_DESCRICAO`] Identificação para o operador.
Valor*	Valor a ser cobrado	[`LINKS_PGTO.LI_VALOR`] Obrigatório; deve ser maior que zero. Validado ao gravar.
Nro Máximo de Parcelas*	Quantidade máxima de parcelas que o cliente pode escolher	[`LINKS_PGTO.LI_NROMAXPARCELAS`] Obrigatório; entre 1 e 12.
Data*	Data de criação do link	[`LINKS_PGTO.LI_DATA`] Preenchida automaticamente.
Link válido até*	Data de expiração do link	[`LINKS_PGTO.LI_VALIDADE`] Obrigatório; deve ser igual ou posterior à data atual e à data de criação.
Origem	Documento de origem (Pedido, OS, Condicional)	[`LINKS_PGTO.LI_ORIGEM`] Preenchido automaticamente pelo sistema.
Cliente*	Código do cliente	[`LINKS_PGTO.LI_CLIENTE` → `CLIENTES.CL_CODIGO`] Obrigatório. Filtrado por clientes ativos (`CL_INATIVO = 'N'`) e não físicos (`CL_TIPO <> 'F'`). Use `F3`.
Link	URL gerada pelo gateway	[`LINKS_PGTO.LI_URL`] Preenchida pelo gateway ao clicar em Gerar Link. Vazio enquanto não gerado.
Filial	Filial proprietária do link	[`LINKS_PGTO.LI_FILIAL`] Preenchida automaticamente. Editável somente quando o usuário tem permissão de troca de filial e há mais de uma filial habilitada.
Status	Situação atual do link	[`LINKS_PGTO.LI_STATUS`] Ver tabela de status abaixo.

Status dos links¶

Valor	Exibição	Cor na grade
`0` + validade futura	Aberto	Branco / preto
`1` com movimentação	Pago	Azul petróleo (fundo) + branco (texto)
`1` sem movimentação	Pago (sem venda gerada)	Verde claro (fundo) + preto (texto)
`2`	Cancelado	Cinza
`0` + validade passada	Expirado	Vermelho

"Pago (sem venda gerada)" indica que o gateway confirmou o pagamento, mas nenhum lançamento em CTARECEB ou MOVMCAIXA foi gerado ainda. Use o filtro correspondente na consulta para identificar esses casos.

Validações ao gravar¶

O sistema bloqueia a gravação nas seguintes situações e exibe a mensagem correspondente:

Situação	Mensagem
Data de validade anterior à data atual	`A data de validade deve ser igual ou posterior à data atual`
Data de validade anterior à data de criação	`A data de validade deve ser igual ou posterior à data de criação do link`
Valor igual ou menor que zero	`O valor deve ser maior que zero`
Parcelas fora do intervalo 1–12	`O número máximo de parcelas deve ser entre 1 e 12`

Regras e comportamentos do sistema¶

Não é possível excluir links — ao tentar, o sistema informa o motivo com uma das mensagens:
Não é possível excluir links de pagamento. Este link já está expirado e não pode mais ser pago
Não é possível excluir links de pagamento. Este link já está cancelado e não pode mais ser pago
Não é possível excluir links de pagamento. Este link já foi pago
Não é possível excluir links de pagamento. O que você pode fazer é cancelá-lo
O botão Gerar Link só fica habilitado quando o link ainda não tem URL gerada e não está em modo de edição.
O botão Cancelar Link só fica habilitado para links Abertos com URL já gerada e dentro do prazo de validade.
O botão Cancelar Link bloqueia links que não estejam abertos com a mensagem: Você só pode cancelar Links em aberto.
Se o ambiente OfficePay estiver configurado como homologação/teste, o título da janela exibe - AMBIENTE DE TESTES.
A filial só pode ser alterada quando o usuário tem a permissão mmAlterarFilial e há mais de uma filial com OfficePay.Links habilitado.
Ao cancelar um link de tipo Pedido, os pedidos vinculados são desvinculados (DesvinculaLinkDosPedidos); da mesma forma para OS e Condicional.

Filtros da tela de consulta¶

Opção	Critério
Todos	Sem filtro
Pagos	`LI_STATUS = 1`
Abertos	`LI_STATUS = 0` e validade igual ou posterior a hoje
Expirados	`LI_STATUS = 0` e validade anterior a hoje
Cancelados	`LI_STATUS = 2`
Pagos (sem venda gerada)	`LI_STATUS = 1` sem registro em `CTARECEB` nem `MOVMCAIXA`

Dúvidas frequentes¶

Por que não consigo criar um link pelo botão Novo? Links só são criados durante o fechamento de Pedidos, OS ou Condicionais com tipo de pagamento Link. O botão Novo nesta tela está desabilitado para criação manual.

O cliente pagou, mas o link ainda aparece como "Aberto". O que fazer? Acesse a aba Verificar Pagamentos e clique em Verificar Pagamentos. O sistema consultará o gateway e atualizará o status dos links quitados.

O que significa "Pago (sem venda gerada)"? O gateway confirmou o pagamento, mas o sistema ainda não gerou os lançamentos financeiros correspondentes. Verifique se o processo de sincronização foi concluído corretamente.

Posso reenviar o link para o cliente? Sim. Acesse o registro do link, copie a URL com Copiar URL ou envie diretamente pelo botão WhatsApp.

Como sei se o link foi pago? O status muda para Pago (exibido em azul na grade). Use também a aba Verificar Pagamentos para sincronizar com o gateway.