<style>
h1#title-text {display: none!important;} 
	#breadcrumb-section :not(.aui-button,.aui-dialog2-header-close) {
    color: #0897E9 !important;
}
h1#title-overlay {
    position: absolute;
    top: 38%;
    left: 50%;
    transform: translate(-50%, -50%);
    font-size: 32px;
    font-weight: bold;
    color: #67DFEB; /* Cor do texto */
    z-index: 999; 
    text-align: center;
</style>
<div style="position: relative;">
  <img src="https://tdn.totvs.com/download/attachments/831836705/capa-final.png?version=1&modificationDate=1710524198425&api=v2" width="100%" alt="Título H1">
  <h1 id="title-overlay">Recebimento Antecipado - Linha Winthor</h1>
</div>

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.

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).

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.



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

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

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

  • 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.

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.

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

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

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:


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

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.

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çã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











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
  • 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.

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
  • 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.

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
  • 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.