Recebimento Antecipado - Linha Winthor
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 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).
Saiba como funciona
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.
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:
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 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ã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ça
Para 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ça
Para 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 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çã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 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.
Requisito 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.
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.
Requisito 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.
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.
Requisito 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.
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.
Requisito 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çã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 Cliente
Para visualizar corretamente os pagamentos antecipados no Extrato do Cliente, é necessário que a rotina esteja atualizada para a versão:
Requisito 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
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.
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.
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
Para PIX:
Gera link/QR Code via Payment Hub
Status atualizado automaticamente
Baixa automática gera:
Crédito do tipo A
PCMOVCR
⚠️ 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 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.
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
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
FAQ - Duvidas
O que é o Recebimento Antecipado?
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.
Onde faço a gestão dos créditos antecipados?
Na rotina 1295, onde é possível visualizar, administrar, utilizar e vincular créditos ao cliente.
O que preciso para começar a usar o processo?
Ter a rotina 1295 atualizada, permissões configuradas, parametrizações de cobrança e as procedures indicadas atualizadas conforme a documentação.
Como registro um pagamento antecipado?
Na geração do pedido informar cobrança do tipo Pagamento Antecipado
Onde visualizo os créditos gerados?
Após pago os créditos aparecem na própria rotina 1295, já vinculados ao cliente e pedido.
Os créditos são utilizados automaticamente no faturamento?
Sim. Durante o faturamento, os créditos são consumidos automaticamente para liquidar o título, independentemente da rotina de faturamento utilizada pela empresa.
O cliente pode ter mais de um crédito ativo?
Sim. A rotina permite múltiplos créditos vinculados ao mesmo cliente.
O crédito pode ser estornado ou cancelado?
Sim, desde que respeitadas as permissões e regras de cancelamento configuradas na rotina e parâmetros do sistema.
O crédito antecipado expira?
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.
O que acontece se o valor do crédito for maior do que o valor da nota?
O sistema usa apenas o valor necessário para quitar o pedido; o saldo restante permanece disponível para futuras utilizações.
O que devo conferir se o crédito não aparecer no faturamento?
Verifique: versão da rotina 1400, se as procedures foram atualizadas, se o crédito está ativo e vinculado ao cliente.
Há relatórios para acompanhar os recebimentos antecipados?
Sim. A Rotina 1203 disponibiliza a visualização dos pagamentos antecipados vinculados ao cliente, permitindo acompanhar esses recebimentos diretamente pela nova aba Pagamentos Antecipados
Relação técnica das histórias do novo processo de Recebimento Antecipado
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas