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 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. 
Principais VantagensControle 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).
|
Visão GeralPara 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. 
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 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.
|
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-ROTINAAtualização responsável por alterar o nome e a descrição da rotina, adequando-a ao novo processo do Recebimento Antecipado. 2. Atualização da Package PKG_RECEBIMENTOANTECIPADOAtualização crítica que contém toda a lógica de processamento do Recebimento Antecipado. 3. Atualização da Tabela PCMOVCRAtualização necessária para registrar os movimentos de crédito vinculados ao novo processo. 6. Criação da Tabela PCPRESTANTECIPADANova tabela utilizada para armazenar os registros de recebimentos antecipados. 7. Atualização da Tabela PCCRECLIAtualização voltada ao controle de créditos por cliente dentro do fluxo financeiro. 8. Atualização da Tabela PCCOBAtualização da tabela responsável pelos códigos de cobrança utilizados no processo. |
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 📥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: C:\Winthor\Spool\Executaveis C:\Winthor\Prod\MOD-012 - C:\Windows\System32
- 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.
|
|
|
|
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: 1. Cadastro da Filial (Rotina 535)A filial utilizada no processo deve estar com os dados cadastrais completos. Verifique se a filial possui: 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: 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.
|
1. Parametrização da Rotina 132 – Parâmetros da PrevidênciaPara 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.
|
|
|
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. |
Configuração da Rotina 530 – Gerenciar AcessosPara 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ão | Status |
|---|
| 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çaPara liberar: Acesse a Rotina 530 – Gerenciar Acessos Clique em Tipo de Acesso → Acesso a Dados Pesquise pela cobrança ou vá no menu COBRANÇAS Habilite a permissão nas duas cobranças referentes ao Recebimento Antecipado e Carteira Digital Salve a configuração
| Acesso a Dados | Status |
|---|
| 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 |

|
Configuração da Rotina 522 – Cadastrar Tipo de CobrançaPara que o processo de Recebimento Antecipado funcione corretamente, é obrigatório que a empresa tenha cadastrados dois tipos de cobrança: Cobrança de Recebimento Antecipado (ex: RANT) Cobrança para Carteira Digital / PIX (ex: CPIX)
A seguir detalharemos os dois tipos de cobrança nos submenus abaixo:
Cobrança de Recebimento Antecipado (ex: RANT)
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
Os campos podem variar conforme a política financeira da empresa, porém existe uma configuração obrigatória: 🔵 Flag obrigatória | Flag | Status |
|---|
| 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. |
Após cadastrar a cobrança, abra a aba: Pagamento Antecipado
Nesta aba, as seguintes configurações são obrigatórias: 🔵 Configurações obrigatórias | Configuração | Status |
|---|
| 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
|
Cobrança para Carteira Digital / PIX (ex: CPIX)
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
Os campos podem variar conforme a política financeira da empresa, porém existe uma configuração obrigatória: 🔵 Flag obrigatória | Flag | Status |
|---|
| 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. |
Após cadastrar a cobrança, abra a aba: Pagamento AntecipadoSe a cobrança digital PIX já estiver cadastrada no sistema, é obrigatório completar a configuração na aba. 
Nesta aba, as seguintes configurações são obrigatórias: 🔵 Configurações obrigatórias | Configuração | Status |
|---|
| 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. |
|
|
|
Configuração da Rotina 316 – Digitar Pedido de VendaPara 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. A rotina deve estar na versão: Essa atualização habilita o novo comportamento integrado ao fluxo de Recebimento Antecipado. |
Comportamento do Pedido com Cobrança de Recebimento AntecipadoApó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. 
|
Configuração da Rotina 336 – Alteração de Pedido de VendaPara 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. A rotina deve estar na versão: 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 AntecipadoApó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. |
Configuração da Rotina 329 – Cancelar Pedido de VendaPara 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. A rotina deve estar na versão: 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 AntecipadoApó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. |
Configuração da Rotina 1400 – Atualizar ProceduresPara 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. A rotina deve estar na versão: 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 ProceduresApós acessar a Rotina 1400, é necessário marcar e atualizar as seguintes procedures:
 Opção recomendada| Configuração | Status |
|---|
| 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.
|
Atualização da Rotina 1203 – Extrato do ClientePara visualizar corretamente os pagamentos antecipados no Extrato do Cliente, é necessário que a rotina esteja atualizada para a versão: A rotina deve estar na versão: 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ãoA 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íciosFacilita 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

|
Usabilidade da Rotina 1295 – Gestão de Recebimentos AntecipadosApó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. 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.

|
Abaixo está a representação completa do fluxo, desde a criação do pedido até o faturamento: Cliente gera um pedido com cobrança antecipada (316, 4116, 2316, integradora ou integradora_med). Pedido entra automaticamente como BLOQUEADO aguardando pagamento. Usuário acessa a Rotina 1295 e gera o link de pagamento para aquele pedido. Sistema registra a cobrança na tabela de controle (PCPRESTANTECIPADA). Com a baixa confirmada, o sistema: No faturamento, o crédito é: Caso ocorra cancelamento, estorno ou alteração, o processo volta para a Rotina 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

|
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
⚠️ 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
|
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 ANã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 existenteCré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.

|
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: 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 PagamentoQuando 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 PedidoO 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

|
Se houver necessidade de alterar o pedido: 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

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