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.
HTML
<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>
Section
bordertrue
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.

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

⚠️ 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 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.
    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 – 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

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

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

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

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.

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.


Card
labelRotina 1400336
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:


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

Image Removed Image Removed Image Removed  

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

...