| Deck of Cards |
|---|
| | Card |
|---|
| 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 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).
|
| Column |
|---|
| | Painel |
|---|
| | Deck of Cards |
|---|
| id | 001 |
|---|
| tabLocation | left |
|---|
| effectType | fade |
|---|
| | Card |
|---|
| label | Dependências |
|---|
| effectType | fade |
|---|
| | Deck of Cards |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| id | Melhorias |
|---|
| | Card |
|---|
| label | 1. Habilitando a Nova Funcionalidade: Recebimento Antecipado |
|---|
| 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. 
| Expandir |
|---|
| title | 2. 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 |
|---|
| title | 3. 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-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. |
| Expandir |
|---|
| title | 4. 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 📥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
⚠️ 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 |
|---|
| label | Pré-Requisitos |
|---|
| effectType | fade |
|---|
| 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 |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| id | Melhorias |
|---|
| | Expandir |
|---|
| 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.
|
| Expandir |
|---|
| title | Parâmetros da Presidência |
|---|
| 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.
|
|
|
| Card |
|---|
| label | Configuração por Rotinas |
|---|
| effectType | fade |
|---|
| 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. |
| Card |
|---|
| id | 530 |
|---|
| label | Rotina 530 |
|---|
| effectType | fade |
|---|
| 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 |
|
| Card |
|---|
| id | 001 |
|---|
| label | Rotina 522 |
|---|
| effectType | fade |
|---|
| 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:
| Deck of Cards |
|---|
| id | 001 |
|---|
| tabLocation | left |
|---|
| effectType | fade |
|---|
| Cobrança de Recebimento Antecipado (ex: RANT)
| Expandir |
|---|
| Card |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| label | Cadastro Cobrança de Recebimento Antecipado |
|---|
| title | Campos de configuração geral |
|---|
| effectType | horizontal |
|---|
| 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. |
| Cardexpand |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| label | Aba Pagamento Antecipado |
|---|
| title | Aba Pagamento Antecipado |
|---|
| effectType | horizontal |
|---|
| 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
|
|
| card | label | Rotina 750 | | effectType | fade |
|---|
| Cobrança para Carteira Digital / PIX (ex: CPIX)
| Expandir |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| label | Cadastro Cobrança de Recebimento Antecipado |
|---|
| title | Campos de configuração geral |
|---|
| effectType | horizontal |
|---|
| 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 Added
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. |
| Expandir |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| label | Aba Pagamento Antecipado |
|---|
| title | Aba Pagamento Antecipado |
|---|
| effectType | horizontal |
|---|
| 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. Image Added 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. |
|
|
|
| Card |
|---|
| label | Rotina 750 |
|---|
| effectType | fade |
|---|
|  Image Removed  Image Removed  Image Removed | Deck of Cards |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| id | Melhorias |
|---|
| | Card |
|---|
| label | Novas 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 |
|---|
| - 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.
|
|
|
| Card |
|---|
| label | Rotina 770 |
|---|
| effectType | fade |
|---|
| | Deck of Cards |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| id | Melhorias |
|---|
| | Card |
|---|
| label | Novas 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 |
|---|
| - 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.
|
|
|
| Card |
|---|
| label | Rotina 775 |
|---|
| effectType | fade |
|---|
| | Deck of Cards |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| id | Melhorias |
|---|
| | Card |
|---|
| label | Novas 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 |
|---|
| - 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.
|
|
|
|
|
|
|
|
