Páginas filhas
  • Novo processo de Recebimento antecipado - 2510.37 - DT - Inovação

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Section
Deck of Cards
id001
effectTypeslide
Card
labelBoas-vindas

O Recebimento Antecipado é um novo e importante processo disponibilizado no WinThor para aprimorar a gestão financeira e comercial das empresas que recebem pagamentos de clientes antes da emissão do pedido ou da entrega da mercadoria.

Seu propósito é centralizar, controlar e dar rastreabilidade total aos créditos antecipados, permitindo que sua equipe acompanhe desde a criação do crédito até sua utilização, cancelamento ou consumo em pedidos de venda — tudo de forma integrada e segura dentro do ERP.

Essa funcionalidade foi desenvolvida para atender operações que precisam administrar valores recebidos previamente, garantindo consistência financeira, visibilidade do saldo disponível e maior eficiência no relacionamento com o cliente.

Com o Recebimento Antecipado, o fluxo de trabalho se torna mais organizado, transparente e aderente às rotinas de conciliação e auditoria.

Image Added

Principais Vantagens

  • Controle unificado de créditos antecipados, centralizando todas as operações em um único processo.

  • Redução de inconsistências financeiras, evitando lançamentos paralelos ou divergentes.

  • Rastreabilidade completa, permitindo acompanhar cada movimento do crédito.

  • Integração direta com pedidos de venda e faturamento, garantindo consumo correto do valor antecipado.

  • Transparência para auditorias e conferências internas.

  • Possibilidade de geração de links de pagamento, quando habilitado pelo cliente.

Observação: Esta funcionalidade opera sobre a base de Contas a Receber e respeita as parametrizações de filial (PCFILIAL) e permissões de acesso (Rotina 530).

Column
width80%
Painel
titleSaiba como funciona
Deck of Cards
id001
tabLocationleft
effectTypefade
Card
labelDependências
effectTypefade
Deck of Cards
startHiddenfalse
historyfalse
idMelhorias
Card
label1. Habilitando a Nova Funcionalidade: Recebimento Antecipado

Visão Geral

Para que você possa utilizar a nova funcionalidade de Recebimento Antecipado, seu ambiente WinThor precisa receber uma atualização de estrutura.
Esta atualização adiciona os novos componentes de banco de dados e o parâmetro de ativação necessários.
Esta parte do documento guia você pelo processo de instalação dessas dependências e pela ativação final da funcionalidade.




Expandir
title2. Como Realizar a Atualização (Ação Requerida)

A instalação das dependências necessárias para o funcionamento do Recebimento Antecipado — incluindo novas tabelas, campos e estruturas de apoio — ocorre de forma automática e foi projetada para ser simples.

Ela será disparada de uma das duas formas abaixo:

  • Ao Abrir Rotinas Financeiras: Ao acessar uma das principais rotinas financeiras que utilizam o agrupamento de do módulo financeiro e do Contas a Receber (como a Rotina 1295), ao abrir essa rotina em versões 37 ou superiores, o sistema detectará automaticamente dependências pendentes e solicitará sua confirmação para atualizá-las.
  • Via WTA (WinThor Anywhere): Acesse a Rotina 814 (Atualização Banco de Dados) e pesquise por:
    • PKG_RECEBIMENTOANTECIPADO, ALTERAR-DESCRICAO-ROTINA, PCPRESTANTECIPADA, PCMOVCR, PCCRECLI, PCCOB

O sistema identificará e aplicará automaticamente as estruturas necessárias.

O que você precisa fazer: Basta confirmar a atualização quando o sistema solicitar. O WinThor cuidará da criação dos novos componentes de banco de dados automaticamente.


Expandir
title3. O que será Instalado? (Detalhes da Atualização)

Ao confirmar a atualização, o WinThor aplicará automaticamente todas as estruturas necessárias para o funcionamento do Recebimento Antecipado. Abaixo estão os objetos e suas versões mínimas exigidas:

1. Atualização da Rotina – ALTERAR-DESCRICAO-ROTINA

Atualização responsável por alterar o nome e a descrição da rotina, adequando-a ao novo processo do Recebimento Antecipado.

  • Nome do Objeto: ALTERAR-DESCRICAO-ROTINA

  • Versão Mínima: 07.00.01.000

  • Novo nome: 1295 - Gestão de recebimentos antecipados

2. Atualização da Package PKG_RECEBIMENTOANTECIPADO

Atualização crítica que contém toda a lógica de processamento do Recebimento Antecipado.

  • Nome do Objeto: PKG_RECEBIMENTOANTECIPADO

  • Versão Mínima: 07.00.13.000

3. Atualização da Tabela PCMOVCR

Atualização necessária para registrar os movimentos de crédito vinculados ao novo processo.

  • Nome do Objeto: PCMOVCR

  • Versão Mínima: 07.00.02.000

6. Criação da Tabela PCPRESTANTECIPADA

Nova tabela utilizada para armazenar os registros de recebimentos antecipados.

  • Nome do Objeto: PCPRESTANTECIPADA

  • Versão Mínima: 07.00.02.000

7. Atualização da Tabela PCCRECLI

Atualização voltada ao controle de créditos por cliente dentro do fluxo financeiro.

  • Nome do Objeto: PCCRECLI

  • Versão Mínima: 07.00.02.000

  • Campos Adicionados: NUMTRANSPAGADIANTADO, COBANTECIPADA, QUITAPCPREST

8. Atualização da Tabela PCCOB

Atualização da tabela responsável pelos códigos de cobrança utilizados no processo.

  • Nome do Objeto: PCCOB

  • Versão Mínima: 07.00.02.000

  • Campos Adicionados: COBANTECIPADA, QUITAPCPREST, CODBCOCOBANTECIPADA, CODMOEDACOBANTECIPADA
Expandir
title4. Instalação das DLLs Necessárias para Geração do Link de Pagamento

Para que a funcionalidade de geração do link de pagamento opere corretamente dentro do processo de Recebimento Antecipado, é obrigatório que dois arquivos DLL estejam corretamente instalados no ambiente Windows do WinThor.

4.1.  DLLs Necessárias

  • libeay32.dll

  • ssleay32.dll

📥Download aqui

4.2 Onde Posicionar as DLLs

Após realizar o download, copie os arquivos para os seguintes diretórios no servidor/estação onde o WinThor é executado:

  1. C:\Winthor\Spool\Executaveis

  2. C:\Winthor\Prod\MOD-012

  3. C:\Windows\System32
  4. C:\Windows\SysWOW64

⚠️ Atenção:
A ausência dessas DLLs impede a comunicação criptografada necessária para geração do link de pagamento, impossibilitando o funcionamento do recurso.

Card
labelPré-Requisitos
effectTypefade

Antes de utilizar o processo de Recebimento Antecipado, é necessário garantir que a filial e os parâmetros financeiros estejam corretamente configurados. A seguir, os pré-requisitos obrigatórios:

Deck of Cards
startHiddenfalse
historyfalse
idMelhorias
Expandir
titleCadastro da Filial

1. Cadastro da Filial (Rotina 535)

A filial utilizada no processo deve estar com os dados cadastrais completos. Verifique se a filial possui:

  • CNPJ/CPF preenchido

  • Endereço completo, incluindo:

    • Rua

    • Número

    • Bairro

    • Cidade / IBGE

    • UF

    • CEP

  • E-mail de contato preenchido

Essas informações são essenciais para envio de dados ao Payment Hub e para a geração correta dos links de pagamento.

2. Integrações Payment Hub (Rotina 535 – Aba Auto-Serviço > Integrações Varejo)

Na aba Auto-Serviço > Integrações Varejo da Rotina 535, é obrigatório configurar corretamente os dados de acesso ao Payment Hub, conforme apresentado no print.

Os seguintes campos devem estar corretamente preenchidos:

  • Utiliza Payment Hub (deve estar marcado ✔️)

  • Access Token URL

  • API URL

  • Usuário

  • Senha

  • Client ID

  • Client Secret

  • Núm. Caixa Padrão

Essas credenciais são necessárias para comunicação com o serviço de pagamento TOTVS (RAAS / RAC / PIX).

⚠️ Sem essa configuração, não será possível gerar links de pagamento através do Processo de Recebimento Antecipado.

Expandir
titleParâmetros da Presidência

1. Parametrização da Rotina 132 – Parâmetros da Previdência

Para habilitar o uso da Cobrança do tipo Carteira Digital PIX (forma de pagamento utilizada no primeiro ciclo da melhoria do Recebimento Antecipado), é necessário parametrizar os itens financeiros conforme o segundo print.

Alguns dos parâmetros relevantes:

  • 9905 – HUTILIZAPAYMENTHUB

  • 9904 – HUBPASSWORD do RAC do PIX

  • 9903 – HUBTOKEN do RAC do PIX

  • 4628 – ID do Cliente TOTVS para acessar o RAC do PIX

  • 4629 – Código secreto RAC da TOTVS para o PIX

  • 4631/4630 – Usuário e senha do RAC PIX

  • 9906 – URLPAYMENTLINK DO PIX

Esses parâmetros garantem o funcionamento da cobrança via PIX Carteira Digital, utilizada para geração do link de pagamento no fluxo do Recebimento Antecipado.

Card
labelConfiguração por Rotinas
effectTypefade

Para que o processo de Recebimento Antecipado funcione corretamente em todo o fluxo comercial e financeiro do WinThor, algumas rotinas do sistema precisam ser configuradas. Essas configurações garantem:

  • Controle adequado de acessos

  • Parametrização correta da cobrança

  • Integração com o processo de pedidos

  • Atualização das procedures utilizadas no fluxo

  • Funcionamento completo da rotina central de Gestão de Recebimentos Antecipados

  • Adequação das regras de liberação, alteração e cancelamento de pedidos vinculados a pagamentos antecipados

A seguir, serão detalhadas as rotinas que precisam ser ajustadas:

  • Rotina 530 – Gerenciar Acessos
    • Responsável por liberar permissões e controlar quais usuários poderão acessar e operar os recursos do Recebimento Antecipado.
  • Rotina 522 – Cadastro de Cobrança
    • Utilizada para configurar os tipos de cobrança, incluindo parametrizações específicas para o uso de Carteira Digital PIX e outras formas de pagamento antecipado.
  • Rotina 316 – Digitar Pedido de Venda
    • Rotina impactada no fluxo comercial, permitindo vinculação de créditos, utilização de recebimentos antecipados e integração com o Payment Hub no momento da venda.
  • Rotina 336 – Alterar Pedido de Venda
    • Responsável pela liberação do pedido após a confirmação do pagamento via link de Recebimento Antecipado.
  • Rotina 329 – Cancelar Pedido de Venda
    • Rotina utilizada para cancelamento de pedidos, seguindo todas as regras comerciais e agora também as regras de pagamento antecipado.
  • Rotina 1400 – Atualizar Procedures
    • Responsável pela atualização das procedures envolvidas no fluxo financeiro, garantindo que o ambiente esteja com os componentes corretos e atualizados.
  • Rotina 1295 – Gestão de Recebimentos Antecipados
    • Rotina principal do processo. É nela que os recebimentos antecipados são criados, conciliados, atualizados e integrados ao restante do sistema.

Nos próximos tópicos, cada uma dessas rotinas será apresentada com suas respectivas configurações recomendadas e passos detalhados.

Card
id530
labelRotina 530
effectTypefade

Configuração da Rotina 530 – Gerenciar Acessos

Para que o usuário utilize corretamente o processo de Recebimento Antecipado na Rotina 1295, é necessário habilitar as permissões a seguir dentro da Rotina 530 – Gerenciar Acessos.

⚠️ Importante:
Habilite apenas as permissões que o usuário realmente irá utilizar, conforme o papel dele no processo.
Não é obrigatório liberar todas as permissões para todos os perfis.

Permissões da Rotina 1295 – Gestão de Recebimentos Antecipados

PermissãoStatus
1 – Permitir efetuar estorno do pagamento digital✔️ Habilitar (se o usuário for realizar estornos)
2 – Permitir visualizar somente pedidos de venda do RCA do usuário✔️ Habilitar (se aplicável ao perfil/RCA)
3 – Permite geração de pagamento antecipado✔️ Habilitar
4 – Permite cancelamento de pagamento antecipado✔️ Habilitar (para perfis que fazem cancelamento)
5 – Permite utilizar créditos pendentes e liberados para abater o pagamento✔️ Habilitar
6 – Permite gerar link de pagamento (PIX)✔️ Habilitar (necessário para usar link PIX / Payment Hub)

Permissões de Acesso a Dados referente a Cobrança

Para liberar:

  1. Acesse a Rotina 530 – Gerenciar Acessos

  2. Clique em Tipo de Acesso → Acesso a Dados

  3. Pesquise pela cobrança ou vá no menu COBRANÇAS

  4. Habilite a permissão nas duas cobranças referentes ao Recebimento Antecipado e Carteira Digital

  5. Salve a configuração

Acesso a DadosStatus
RANT – RECEBIMENTO ANTECIPADO (ou outra cobrança criada para recebimento antecipado)✔️ Habilitar
CPIX – CARTEIRA DIGITAL PIX (ou outra cobrança criada para PIX/Carteira Digital)✔️ Habilitar

Image Modified

Card
id001
labelRotina 522
effectTypefade

Configuração da Rotina 522 – Cadastrar Tipo de Cobrança

Para que o processo de Recebimento Antecipado funcione corretamente, é obrigatório que a empresa tenha cadastrados dois tipos de cobrança:

  1. Cobrança de Recebimento Antecipado (ex: RANT) 

  2. Cobrança para Carteira Digital / PIX (ex: CPIX) 

A seguir detalharemos os dois tipos de cobrança nos submenus abaixo:


Deck of Cards
id001

Cobrança de Recebimento Antecipado (ex: RANT) 


Expandir
startHiddenfalse
historyfalse
labelCadastro Cobrança de Recebimento Antecipado
titleCampos de configuração geral
effectTypehorizontal

Caso a empresa não possua uma cobrança específica para o processo, será necessário cadastrar um novo tipo de cobrança na Rotina 522 – Cadastro de Cobrança.

Abaixo há um print com exemplo de como a cobrança deverá ser configurada, podendo servir como referência para preenchimento dos campos.

Campos de configuração geral

Image Modified

Os campos podem variar conforme a política financeira da empresa, porém existe uma configuração obrigatória:

🔵 Flag obrigatória

FlagStatus
Pagamento antecipado✔️ Obrigatoriamente habilitar

Essa flag habilita o tipo de cobrança para operação dentro do fluxo da Rotina 1295 – Gestão de Recebimentos Antecipados.

Expandir
startHiddenfalse
historyfalse
labelAba Pagamento Antecipado
titleAba Pagamento Antecipado
effectTypehorizontal

Após cadastrar a cobrança, abra a aba: Pagamento Antecipado

Image Modified

Nesta aba, as seguintes configurações são obrigatórias:

🔵 Configurações obrigatórias

ConfiguraçãoStatus
Quita prestação ao faturar✔️ Obrigatoriamente habilitar
Banco para baixa✔️ Informar um banco válido
Moeda para baixa✔️ Informar a moeda correspondente

Essas configurações são essenciais para:

  • Realizar baixa automática ao faturar

  • Liberar o crédito corretamente para uso

  • Integrar o fluxo com o processo de recebimento via Payment Hub



Deck of Cards
id001

Cobrança para Carteira Digital / PIX (ex: CPIX) 


Expandir
startHiddenfalse
historyfalse
labelCadastro Cobrança de Recebimento Antecipado
titleCampos de configuração geral
effectTypehorizontal

Caso a empresa não possua uma cobrança específica para o processo de Carteira Digital / PIX, será necessário cadastrar um novo tipo de cobrança na Rotina 522 – Cadastro de Cobrança.

Abaixo há um print com exemplo de como a cobrança digital PIX deve ser configurada, podendo servir como referência.

Observação:
Se a empresa já possuir uma cobrança digital PIX cadastrada, não é necessário criar uma nova.
Basta complementar as informações obrigatórias na aba "Pagamento Antecipado".

Campos de configuração geral

Image Modified

Os campos podem variar conforme a política financeira da empresa, porém existe uma configuração obrigatória:

🔵 Flag obrigatória

FlagStatus
Carteira Digital✔️ Obrigatoriamente habilitar

Essa flag habilita o tipo de cobrança para operar como Cobrança Digital / PIX, permitindo geração e controle de pagamentos via Payment Hub.

Expandir
startHiddenfalse
historyfalse
labelAba Pagamento Antecipado
titleAba Pagamento Antecipado
effectTypehorizontal

Após cadastrar a cobrança, abra a aba: Pagamento Antecipado

Se a cobrança digital PIX já estiver cadastrada no sistema, é obrigatório completar a configuração na aba.

Image Modified

Nesta aba, as seguintes configurações são obrigatórias:

🔵 Configurações obrigatórias

ConfiguraçãoStatus
Quita prestação ao faturar✔️ Obrigatoriamente habilitar
Banco para baixa✔️ Informar um banco válido
Moeda para baixa✔️ Informar a moeda correspondente

Esses dados garantem que o crédito seja liberado e integrado ao fluxo de Recebimento Antecipado.




Card
labelRotina 316
effectTypefade

Configuração da Rotina 316 – Digitar Pedido de Venda

Para que o processo de Recebimento Antecipado funcione corretamente durante a criação do pedido de venda, é necessário garantir que a Rotina 316 – Digitar Pedido de Venda esteja atualizada.

Informações
titleRequisito de Versão

A rotina deve estar na versão:

  • 37.0.11.387 ou superior

Essa atualização habilita o novo comportamento integrado ao fluxo de Recebimento Antecipado.

Comportamento do Pedido com Cobrança de Recebimento Antecipado

Após atualizar a rotina, sempre que um pedido for criado utilizando um tipo de cobrança configurado como Recebimento Antecipado, ocorrerá o seguinte:

  • O pedido entrará automaticamente como BLOQUEADO.

  • Após a confirmação do pagamento antecipado, o pedido poderá ser desbloqueado pela Rotina 336 – Liberação de Pedidos.

  • Esse bloqueio impede faturamento, preparação ou expedição antes do pagamento antecipado.

Este mecanismo garante que o fluxo comercial respeite a regra de negócio do pagamento antecipado obrigatório, evitando faturamento sem a devida confirmação financeira.

Image Added

Card
labelRotina 336
effectTypefade

Configuração da Rotina 336 – Alteração de Pedido de Venda

Para que o processo de Recebimento Antecipado funcione corretamente durante a liberação do pedido após o pagamento, é necessário garantir que a Rotina 336 – Alteração de Pedido de Venda esteja atualizada.

Informações
titleRequisito de Versão

A rotina deve estar na versão:

  • 37.0.05.242 ou superior

Essa atualização habilita o comportamento integrado ao fluxo de Recebimento Antecipado, permitindo que o pedido seja liberado conforme as regras financeiras vinculadas ao pagamento antecipado.

Comportamento da Liberação do Pedido com Recebimento Antecipado

Após atualizar a rotina, sempre que um pedido for criado utilizando um tipo de cobrança configurado como Recebimento Antecipado, ocorrerá o seguinte:

  • O pedido permanecerá BLOQUEADO até a confirmação do pagamento.

  • Não será possível desbloquear o pedido enquanto o pagamento antecipado não for efetuado.

  • Após o cliente realizar o pagamento do link gerado na Rotina 1295, o pedido poderá então ser liberado pela Rotina 336.

  • A rotina permitirá a liberação do pedido somente após a confirmação financeira, garantindo que apenas pedidos devidamente quitados possam seguir para faturamento.

Esse controle impede que o pedido avance no fluxo comercial (faturamento, preparação ou expedição) antes que o pagamento antecipado seja confirmado, assegurando aderência às regras financeiras do processo.

Card
labelRotina 329
effectTypefade

Configuração da Rotina 329 – Cancelar Pedido de Venda

Para que o processo de Recebimento Antecipado funcione corretamente durante o cancelamento do pedido de venda, é necessário garantir que a Rotina 329 – Cancelar Pedido de Venda esteja atualizada.

Informações
titleRequisito de Versão

A rotina deve estar na versão:

  • 38.0.2.1 ou superior

Essa atualização habilita as novas regras de validação financeira relacionadas ao cancelamento de pedidos vinculados a pagamentos antecipados.

Comportamento do Cancelamento com Recebimento Antecipado

Após atualizar a rotina, o cancelamento de pedidos passa a respeitar novas regras quando existir Recebimento Antecipado vinculado, garantindo segurança financeira e consistência no processo. O comportamento passa a ser o seguinte:

  • Caso o pedido possua um pagamento antecipado gerado, o sistema não permitirá o cancelamento.

  • Caso o pedido possua um pagamento antecipado já pago, o cancelamento também não será permitido.

  • Enquanto houver qualquer pagamento antecipado gerado ou quitado, o pedido permanecerá impedido de ser cancelado.

  • Somente após o estorno ou remoção do vínculo financeiro na Rotina 1295 – Gestão de Recebimentos Antecipados, o pedido poderá ser cancelado normalmente na Rotina 329.

Esse mecanismo evita inconsistências financeiras e garante que nenhum pedido seja cancelado sem que o fluxo de Recebimento Antecipado seja devidamente tratado.

Card
labelRotina 1400
effectTypefade

Configuração da Rotina 1400 – Atualizar Procedures

Para que o fluxo de Recebimento Antecipado funcione corretamente durante o faturamento, é necessário garantir que a Rotina 1400 – Atualizar Procedures esteja atualizada e que todas as procedures relacionadas ao processo sejam recriadas.

Informações
titleRequisito de Versão

A rotina deve estar na versão:

  • 37.0.17.238 ou superior

A partir desta versão, o sistema garante que as procedures responsáveis pela integração entre faturamento, cancelamento e corte de mercadoria estejam compatíveis com o fluxo de Recebimento Antecipado.

Atualização das Procedures

Após acessar a Rotina 1400, é necessário marcar e atualizar as seguintes procedures:


Image Modified

Opção recomendada

ConfiguraçãoStatus
Dropar Objetos Antes de Criar✔️ Habilitar

Essa opção garante que os objetos antigos sejam removidos antes de recriação, evitando conflitos com versões anteriores.

⚠️ Importante:

A atualização dessas procedures é essencial para garantir que o faturamento, cancelamento e corte de mercadorias funcionem corretamente dentro do fluxo de Recebimento Antecipado, evitando inconsistências entre os módulos financeiro e de faturamento.

Card
labelRotina 12951203
effectTypefade

  

Deck of Cards
startHiddenfalse
historyfalse
idMelhorias
Card
labelNovas funcionalidades e melhorias

Painel "Central de Tributação" onde irá trazer os valores dos impostos atuais e os valores dos impostos da reforma tributária.

    • Se Tributos atuais: ICMS, ICMS ST, PIS/COFINS, IPI
    • Se Reforma Tributária: IBS, CBS e IS
Card
labelSaiba Mais
  • Foi implementado a validação do parâmetro 1092 - Usar tributação por estado (UF), onde caso esteja definido como N, o vínculo dos produtos com as figuras tributárias será com base na tributação por região realizada na rotina 271.
Composition Setup

...

Atualização da Rotina 1203 – Extrato do Cliente

Para visualizar corretamente os pagamentos antecipados no Extrato do Cliente, é necessário que a rotina esteja atualizada para a versão:

Informações
titleRequisito de Versão

A rotina deve estar na versão:

  • 37.0.6.54 ou superior

Essa atualização habilita a nova visualização financeira do cliente, permitindo consultar, filtrar e analisar pagamentos antecipados diretamente pela rotina, trazendo mais transparência e rastreabilidade ao processo.

Novidade da Versão

A nova aba Pagamentos Antecipados permite:

  • Consultar todos os pagamentos antecipados vinculados ao cliente

  • Filtrar por período, status do pedido e status do pagamento

  • Visualizar transações de adiantamento, valores, créditos abatidos e demais informações financeiras

Benefícios

  • Facilita o acompanhamento dos adiantamentos utilizados no faturamento

  • Permite rápida identificação de pagamentos gerados, quitados ou cancelados

  • Melhora a análise do histórico financeiro do cliente

Image Added

Card
defaulttrue
idMelhorias
labelRotina 1295
effectTypefade

Usabilidade da Rotina 1295 – Gestão de Recebimentos Antecipados

Após configurarmos as rotinas que suportam o Recebimento Antecipado, podemos avançar para a rotina que centraliza todo o processo: a 1295 – Gestão de Recebimentos Antecipados.

Essa rotina é responsável por gerar a cobrança, acompanhar o pagamento e controlar todas as etapas do fluxo financeiro ligado ao pedido.

A 1295 também integra informações com outras rotinas, aplica validações, registra atualizações e garante que o processo ocorra com segurança e rastreabilidade.

Ela é o ponto central do Recebimento Antecipado e coordena todas as ações necessárias até a liberação do pedido.

Nos tópicos seguintes, serão apresentados os passos do processo, as regras de negócio, os comportamentos esperados e todas as interações que compõem o novo fluxo de Recebimento Antecipado no WinThor.

Deck of Cards
startHiddenfalse
historyfalse
idMelhorias
Card
labelFiltros Avançados
Expandir
title1. Objetivo da Rotina 1295

A Rotina 1295 foi desenvolvida para:

  • Gerar cobranças antecipadas (PIX, cartão, dinheiro, boleto digital).

  • Acompanhar status de pagamento em tempo real.

  • Registrar e atualizar pagamentos.

  • Gerar crédito financeiro automaticamente.

  • Integrar com o fluxo comercial (pedidos, faturamento, crédito do cliente).

  • Garantir segurança financeira no uso de cobrança antecipada.

Image Added

Expandir
title2. Fluxo Geral do Recebimento Antecipado no WinThor

Abaixo está a representação completa do fluxo, desde a criação do pedido até o faturamento:

  1. Cliente gera um pedido com cobrança antecipada (316, 4116, 2316, integradora ou integradora_med).

  2. Pedido entra automaticamente como BLOQUEADO aguardando pagamento.

  3. Usuário acessa a Rotina 1295 e gera o link de pagamento para aquele pedido.

  4. Sistema registra a cobrança na tabela de controle (PCPRESTANTECIPADA).

    • PIX → API atualiza status automaticamente (Pagamento Hub).

  5. Com a baixa confirmada, o sistema:

    • Atualiza tabela de controle

    • Gera crédito do tipo A vinculado ao pedido

    • Permite pedido ser desbloqueado na Rotina 336
  6. No faturamento, o crédito é:

    • Consumido automaticamente quando faturado

    • Gerada PCPREST quitada com a cobrança original

  7. Caso ocorra cancelamento, estorno ou alteração, o processo volta para a Rotina 1295.

Expandir
title3. Geração de Link de Pagamento na 1295

Ao acessar a rotina, o usuário poderá:

  • Buscar pelo pedido

  • Verificar dados como Status, Posição, Numero do pedido, Cliente, entre outros na grid da rotina.

  • Gerar o link no menu LINK

  • Gerar pagamento 
  • Escolher cobrança para geração do link
  • Apresentar QRCode

  • Monitorar o status em tempo real

Image Added

Expandir
title4. Comportamento por Tipo de Cobrança

A Rotina 1295 permite a geração e acompanhamento de cobranças antecipadas conforme o tipo de pagamento selecionado. Cada modalidade segue regras específicas de baixa e atualização de status.

PIX/ Carteira Digital

  • Para PIX:

    • Gera link/QR Code via Payment Hub

    • Status atualizado automaticamente

    • Baixa automática gera:

      • Crédito do tipo A

      • PCMOVCR 

Image Added

⚠️ Observação Importante:

Atualmente, o link de pagamento está disponível apenas para cobrança do tipo PIX.
No futuro, serão adicionadas outras integrações como:

  • PIX Cobrança

  • BolePIX / Boleto Híbrido

  • Cartão
Expandir
title5. Geração/Utilização do Crédito

Após o pagamento e a baixa:

  • Sistema gera crédito tipo A (antecipado)

  • Crédito fica travado até o faturamento, onde será automaticamente consumido

Créditos do tipo A

  • Não aparecem em relatórios

  • Não podem ser utilizados em outros pedidos

  • Só são consumidos no faturamento do pedido original

Pedidos e Créditos existente

  • Créditos já vinculados ao cliente ou ao pedido podem ser utilizados antes da geração do link de pagamento.

  • Quando houver abatimento, o valor correspondente será descontado do total que será gerado no link.

  • Durante esse processo, a situação do crédito é alterada de tipo P para NULL, permitindo que ele seja devidamente consumido no faturamento.

  • Caso o cliente já possua crédito normal (tipos P ou L), o sistema também permite sua utilização no momento da geração do link de pagamento.

Image Added

Expandir
title6. Regras de Cancelamento e Estorno

O processo de cancelamento segue controles rigorosos para garantir a integridade financeira das informações. Antes de qualquer ação, a rotina verifica a existência de vínculos com pagamentos antecipados.

Cancelamento do Pedido (Rotina 339)

O pedido não poderá ser cancelado se existir:

  • Pagamento antecipado gerado (link ativo)

  • Pagamento antecipado pago

Para cancelar o pedido, primeiro é obrigatório:

  • Cancelar o link (se ainda não pago)

  • Estornar pagamento (caso pago)

  • Estornar PCPREST, quando houver geração

Cancelamento do Link de Pagamento

Quando um pagamento antecipado é gerado, o sistema cria um link de pagamento que permanece ativo até que o cliente realize o pagamento ou até que seja cancelado manualmente.
Caso o cliente ainda não tenha efetuado o pagamento, é permitido cancelar o link diretamente na rotina, removendo o vínculo financeiro e liberando o pedido para novos ajustes ou cancelamento.
O cancelamento do link deve ser realizado antes de qualquer tentativa de cancelamento do pedido, evitando inconsistências e garantindo que nenhuma cobrança fique pendente no fluxo financeiro.

Estorno do Pedido

O estorno não é permitido caso o pedido já tenha sido Liberado ou Faturado, garantindo que não haja quebra do fluxo financeiro e operacional do processo.

Durante o estorno, o sistema atualiza automaticamente:

  • PCPRESTANTECIPADA: cria contrapartida negativa e altera o status para ESTORNADO

  • PCCRECLI: gera contrapartida negativa do crédito tipo A

  • PCMOVCR: registra contrapartida negativa do lançamento vinculado ao pagamento antecipado

Image Added

Expandir
title7. Alteração de Pedido (Rotina 336)

Se houver necessidade de alterar o pedido:

  • O link de pagamento precisa ser estornada primeiro

  • O sistema impede alteração também se o pagamento estiver:

    • Gerado

    • Pago

Pedido somente será liberado quando:

  • A cobrança antecipada for baixada (API) quando paga

  • Não houver pendências financeiras

  • Crédito tiver sido gerado corretamente

Image Added

Expandir
title8. Faturamento e Impactos

Deve realizar o faturamento utilizando a rotina já adotada pela empresa, uma vez que existem múltiplas rotinas disponíveis no sistema para esse processo. Cada empresa deve seguir o fluxo padrão que já utiliza internamente.

Durante o faturamento:

  • O crédito é automaticamente consumido para liquidar o título.

  • É gerada uma PCPREST quitada, respeitando a cobrança original.

Em caso de divergência por peso:

  • Se o valor faturado for maior que o valor pago: é gerado um título referente à diferença.

  • Se o valor faturado for menor que o valor pago: é gerado um crédito adicional.

Informações
titleFAQ - Duvidas
HTML
<style>
/* Estilo dos summaries e do conteúdo */
summary {
    font-size: 17px;
    background-color: #fff;
    padding: 1.1rem 0rem;
    font-weight: 300;
    outline: none;
    border-radius: 0.25rem;
    text-align: left;
    cursor: pointer;
    position: relative;
    padding-left: 8px;
    border-color: #f7f7f7;
    border-bottom-style: solid;
}

details[open] summary ~ * {
    animation: sweep .5s ease-in-out;
}

@keyframes sweep {
    0%    {opacity: 0; margin-top: -10px}
    100%  {opacity: 1; margin-top: 0px}
}

details > summary::after {
    position: absolute;
    content: "+";
    right: 20px;
    color: #0a97e8;
    background: transparent;
    font-size: 29px;
    margin-top: -10px;
    font-weight: 100;
}

details[open] > summary::after {
    content: "-";
    right: 20px;
    color: #0a97e8;
}

details > summary::-webkit-details-marker {
    display: none;
}

summary:hover {
    color: #0a97e8 !important;
    border-color: #c6c6c6 !important;
    transition: 0.3s;
}

.conteudo {
    margin-bottom: 24px !important;
    padding: 16px 16px !important;
    border-style: solid !important;
    border-radius: 1px 1px 8px 8px !important;
    border-color: #f7f7f7 !important;
    border-top-width: 0px !important;
    text-align: left;
    background: #ffffff;
}
</style>

<main>
    <!-- FAQ – Gestão de Recebimentos Antecipados (Rotina 1295) -->
    <details>
        <summary>O que é o Recebimento Antecipado?</summary>
        <div class="conteudo">
            <p>Processo para registrar pagamentos realizados pelo cliente antes da emissão da nota fiscal, gerando créditos que poderão ser utilizados posteriormente no faturamento.</p>
        </div>
    </details>

    <details>
        <summary>Onde faço a gestão dos créditos antecipados?</summary>
        <div class="conteudo">
            <p>Na rotina <strong>1295</strong>, onde é possível visualizar, administrar, utilizar e vincular créditos ao cliente.</p>
        </div>
    </details>

    <details>
        <summary>O que preciso para começar a usar o processo?</summary>
        <div class="conteudo">
            <p>Ter a rotina <strong>1295 atualizada</strong>, permissões configuradas, parametrizações de cobrança e as procedures indicadas atualizadas conforme a documentação.</p>
        </div>
    </details>

    <details>
        <summary>Como registro um pagamento antecipado?</summary>
        <div class="conteudo">
            <p>Na geração do pedido informar cobrança do tipo <strong>Pagamento Antecipado</strong></p>
        </div>
    </details>

    <details>
        <summary>Onde visualizo os créditos gerados?</summary>
        <div class="conteudo">
            <p>Após pago os créditos aparecem na própria rotina <strong>1295</strong>, já vinculados ao cliente e pedido.</p>
        </div>
    </details>

    <details>
        <summary>Os créditos são utilizados automaticamente no faturamento?</summary>
        <div class="conteudo">
            <p>Sim. Durante o faturamento, os créditos são consumidos automaticamente para liquidar o título, <strong>independentemente</strong> da rotina de faturamento utilizada pela empresa.</p>
        </div>
    </details>

    <details>
        <summary>O cliente pode ter mais de um crédito ativo?</summary>
        <div class="conteudo">
            <p>Sim. A rotina permite múltiplos créditos vinculados ao mesmo cliente.</p>
        </div>
    </details>

    <details>
        <summary>O crédito pode ser estornado ou cancelado?</summary>
        <div class="conteudo">
            <p>Sim, desde que respeitadas as permissões e regras de cancelamento configuradas na rotina e parâmetros do sistema.</p>
        </div>
    </details>

    <details>
        <summary>O crédito antecipado expira?</summary>
        <div class="conteudo">
            <p>O sistema não define validade automática; validade ou política de expiração deve ser gerida pela empresa na rotina 1295 ou em processos internos.</p>
        </div>
    </details>

    <details>
        <summary>O que acontece se o valor do crédito for maior do que o valor da nota?</summary>
        <div class="conteudo">
            <p>O sistema usa apenas o valor necessário para quitar o pedido; o saldo restante permanece disponível para futuras utilizações.</p>
        </div>
    </details>

    <details>
        <summary>O que devo conferir se o crédito não aparecer no faturamento?</summary>
        <div class="conteudo">
            <p>Verifique: versão da rotina <strong>1400</strong>, se as procedures foram atualizadas, se o crédito está ativo e vinculado ao cliente.</p>
        </div>
    </details>

    <details>
        <summary>Há relatórios para acompanhar os recebimentos antecipados?</summary>
        <div class="conteudo">
            <p>Sim. A Rotina 1203 disponibiliza a visualização dos pagamentos antecipados vinculados ao cliente, permitindo acompanhar esses recebimentos diretamente pela nova aba Pagamentos Antecipados</p>
        </div>
    </details>
</main>

Informações
titleRelação técnica das histórias do novo processo de Recebimento Antecipado
HTML
<!-- PAGE TREE: Relação técnica das histórias do novo processo de Recebimento Antecipado  -->
<style>
    .pagetree {
        font-family: Arial, "Helvetica Neue", Helvetica, sans-serif;
        max-width: 820px;
        margin: 0;
        padding: 0;
    }

    .pagetree .node {
        list-style: none;
        margin: 0;
        padding: 0;
    }

    .pagetree .node>li {
        margin: 6px 0;
        padding-left: 12px;
        position: relative;
    }

    .pagetree .node>li::before {
        content: "•";
        color: #0a97e8;
        position: absolute;
        left: 0;
        top: 0;
        font-size: 18px;
    }

    .pagetree a {
        color: #0a4f7a;
        text-decoration: none;
        font-size: 14px;
    }

    .pagetree a:hover {
        text-decoration: underline;
        color: #0a97e8;
    }

    /* Colapsável (summary simples, sem ícone) */
    .pagetree details {
        margin-bottom: 8px;
        border-left: 3px solid transparent;
        padding-left: 8px;
    }

    .pagetree details[open] {
        border-left-color: #0a97e8;
    }

    .pagetree summary {
        cursor: pointer;
        list-style: none;
        margin: 0 0 6px 0;
        font-weight: 600;
        color: #000000;
        padding: 6px 0;
        outline: none;
        position: relative;
        padding-right: 24px;
    }

    .pagetree summary::-webkit-details-marker {
        display: none;
    }

    /* chevron à direita que rotaciona ao abrir */
    .pagetree summary::after {
        content: "▸";
        position: absolute;
        right: 0;
        top: 6px;
        transition: transform .18s ease;
        color: #0a97e8;
        font-size: 14px;
    }

    .pagetree details[open] summary::after {
        transform: rotate(90deg);
    }
</style>
<nav class="pagetree">
    <details>
        <summary>Documentos Técnicos</summary>
        <ul class="node">
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=952380010" target="_blank" rel="noopener">
                    DDFINAN-29590 - DT - Criação de campos na PCCOB, PCORCAVENDAPREST e PCCRECLI </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=952993520" target="_blank" rel="noopener">
                    DDFINAN-29590 - DT - Criação de tabela pcprestantecipada </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=955485677" target="_blank" rel="noopener">
                    DDFINAN-29591 - DT - 522 - Criação de flag "pagamento antecipado" e "quita prestação no faturamento"
                </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=963543330" target="_blank" rel="noopener">
                    DDFINAN-29595 - DT - 603 - Restrições na visualização de créditos do tipo "A" e "C" na rotina 603
                </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=964569421" target="_blank" rel="noopener">
                    DDFINAN-32408 - DT - 1295 - Implementação da Rotina para Gestão de Pagamentos Antecipados </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=979013104" target="_blank" rel="noopener">
                    DDFINAN-32409 - DT - 1295 - Geração de Link para Pagamentos Antecipados </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=991869161" target="_blank" rel="noopener">
                    DDFINAN-32410 - DT - 1295 - Cancelamento de Pagamentos Antecipados </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=966220492" target="_blank" rel="noopener">
                    DDFINAN-32411 - DT - 1295 - Utilização de Créditos na Rotina </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=995205043" target="_blank" rel="noopener">
                    DDFINAN-32412 - DT - 1295 - Administração e Quitação de Pagamentos Antecipados </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=954599514" target="_blank" rel="noopener">
                    DDFINAN-32413 - DT - Criação de tabela pcprestantecipada </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=963546402" target="_blank" rel="noopener">
                    DDFINAN-32414 - DT - 619 - Restrições na visualização de créditos do tipo "A" e "C" na rotina 619
                </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=963549498" target="_blank" rel="noopener">
                    DDFINAN-32415 - DT - 628 - Restrições na visualização de créditos do tipo "A" e "C" na rotina 628
                </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=964585035" target="_blank" rel="noopener">
                    DDFINAN-32416 - DT - 1286 - Restrições na visualização de créditos do tipo "A" e "C" na rotina 1286
                </a> </li>
            <li> <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=969116782" target="_blank" rel="noopener">
                    DDFINAN-33021 - DT - Consumo de Crédito com Situação 'A' </a> </li>
        </ul>
    </details>
</nav>

...