Histórico da Página
CONTEÚDO
- Visão Geral
- Pré-requisitos
- Cadastros envolvidos
- Parametrização TOTVS Antecipa
- Parametrização - Configurações Gerais
- Parametrização - Antecipa - Agendamento
- Parametrização - Antecipa - Recebíveis
- Parametrização - Antecipa - Reversão
- Parametrização - Configurações Gerais
- Processos de Negócio que serão integrados
- Contabilizações
- Monitor de Integração TOTVS Antecipa
- Monitor de Integração TOTVS Antecipa - Busca Avançada
- Monitor de Integração TOTVS Antecipa - Busca Avançada
- Tabelas novas utilizadas
01. VISÃO GERAL
O TOTVS Antecipa é a solução de antecipação de recebíveis da TOTVS e agora é possível integrá-la ao ERP Datasul. Através desta integração, é possível visualizar as notas fiscais da carteira que estão em aberto, selecionar quais deseja antecipar e enviar a solicitação para o TOTVS Antecipa. Assim que a antecipação é aprovada, a contabilização também será automática no Datasul. Para antecipações aprovadas até às 15h, o valor das antecipações é recebido ainda no mesmo dia. Para utilizar este produto é necessário passar por um processo de adesão.
...
https://www.totvs.com/techfin/credito/
02. PRÉ-REQUISITOS
Para a correta execução do processo de antecipação, existem alguns pré-requisitos que devem ser impreterivelmente atendidos. Para isso, é necessário realizar as etapas descritas no Assistente de configuração para integração com Totvs Apps (ConfigAppsWizard). Na etapa de "05. TELA - Sincronização", será necessário o cadastro dos bancos: emsuni, movfin, movdis e movind.
...
Card documentos | ||||
---|---|---|---|---|
|
03. CADASTROS ENVOLVIDOS
a. CONTA CONTÁBIL INTEGRAÇÃO (UTB033AA)
No cadastro de Conta Contábil Integração, será necessário incluir as contas que serão utilizadas para contabilizar o desconto via TOTVS Antecipa (finalidade contábil "Desconto TOTVS Antecipa") e a despesa financeira dessas operações (finalidade contábil "Despesa TOTVS Antecipa"), amarradas ao módulo "ACR". Também será necessário cadastrar para o módulo "CMG" as contas com finalidade "Débito Padrão" e "Crédito Padrão" que serão amarradas ao tipo de transação de caixa "ACR" e também ao tipo de transação de caixa que for informado no Wizard para "Transação Caixa Despesa".
b. CARTEIRA BANCÁRIA (UFN012AA)
No cadastro de Carteira Bancária, é necessário fazer algumas manutenções para que possam ser utilizadas para o TOTVS Antecipa.
...
A conta contábil com finalidade "Despesa TOTVS Antecipa" será utilizada para contabilizar a despesa cobrada no desconto de título via TOTVS Antecipa. Da mesma forma será utilizada para estornar a despesa, quando a operação em questão envolver estorno de despesa.
c. TIPO DE TRANSAÇÃO DE CAIXA (CMG003AA)
No cadastro de Tipo de Transação de Caixa, será necessário criar um tipo com código "ACR" e indicar as contas contábeis para as finalidades contábeis "Débito Padrão" e "Crédito Padrão".
...
Também será necessário cadastrar o Tipo de Transação de Caixa informado como "Transação Caixa Despesa" no Wizard, na aba de Reversão. Esse tipo de transação será utilizado, quando houver reembolso de uma parte ou de toda a taxa, em função de um cancelamento por divergência comercial. Para este tipo de transação de caixa, também será necessário informar as contas de Débito Padrão e Crédito Padrão.
d. TIPO DE TRANSAÇÃO DE CAIXA DO CONTAS A RECEBER (CMG008AA)
No cadastro de Tipo de Transação de Caixa do Contas a Receber, será necessário vincular a carteira que será utilizada como carteira de Desconto para o TOTVS Antecipa, no tipo de transação de caixa "ACR'.
e. CONTA CORRENTE (UTB099AA)
No cadastro de Conta Corrente deve ser cadastrada a Conta Corrente que será amarrada ao Portador e Carteira de Desconto, informando a conta contábil de Principal Ativo relacionada. Também será necessário informar a parte de segurança de acesso a conta, onde o usuário que for programar os agendamentos dos processamentos das operações no ERP vai precisar de acesso à conta corrente. Esta conta corrente normalmente será do tipo Caixa. Ela vai receber uma entrada no momento em que a operação de desconto for processada no ERP e em seguida, uma saída quando ocorrer o depósito em conta corrente bancária do valor antecipado. Desta maneira o saldo dessa conta ficaria zerado após finalizar este fluxo.
Da mesma forma, para a conta bancária que for informada no Wizard, é necessário revisar a parte de segurança, pra garantir que o usuário dos agendamentos também tenha acesso a essa conta.
f. FINALIDADE ECONÔMICA PORTADOR (UFN103AA)
Neste cadastro deve ser amarrado, por estabelecimento, o Portador e Carteira de desconto, a conta corrente que for criada para receber as movimentações.
g. PORTADOR BANCO (UFN013AA)
Deve ser criar um registro no cadastro Portador Banco, para o portador e carteira de Desconto.
04. PARAMETRIZAÇÃO TOTVS ANTECIPA
Para auxiliar no cadastro das principais configurações do TOTVS Antecipa, foi disponibilizado o programa Wizard TOTVS Antecipa (html.wizardTechfin). Para acessá-lo, busque por Wizard TOTVS Antecipa.
a. PARAMETRIZAÇÃO - CONFIGURAÇÕES GERAIS
Ao entrar no programa, será aberto a tela de Configurações Gerais da opção "Config" do menu lateral. Clique em Editar para informar os campos:
...
Campo | Descrição |
---|---|
Empresa | Empresa logada, informada automaticamente. |
Utiliza Totvs Mais Negócios | Neste campo deverá ser marcado se é utilizado o produto Totvs Mais Negócios. |
Utiliza Totvs Antecipa | Neste campo deverá ser marcado se é utilizado o produto Totvs Antecipa. Para ambiente de produção: fmscash.totvs.app. |
Utiliza Painel Financeiro | Neste campo deverá ser marcado se é utilizado o produto Painel Financeiro. |
URL TOTVS Mais Negócios (RISK) | Quando o parâmetro "Utiliza Totvs Mais Negócios" está igual a Sim, deverá ser informada a URL para comunicação com o produto Totvs Mais Negócios. Para ambiente de produção: risk.totvs.app. |
URL - TOTVS Antecipa | Quando o parâmetro "Utiliza Totvs Antecipa" está igual a Sim, deverá ser informada a URL para comunicação com o produto Totvs Antecipa. Para ambiente de produção: fmscash.totvs.app. Obs: Quando é marcado o parâmetro "Utiliza Totvs Mais Negócios" ou "Utiliza Painel Financeiro", o label do campo muda de acordo com os produtos. |
URL TOTVS RAC | Neste campo deverá ser informada a URL do TOTVS RAC para autenticação. Para ambiente de produção: totvs.rac.totvs.app. |
Client ID | Neste campo deverá ser informado o Client Id disponibilizado na contratação do TOTVS Antecipa. |
Client Secret | Neste campo deverá ser informado o Client Secret disponibilizado na contratação do TOTVS Antecipa. |
b. PARAMETRIZAÇÃO - ANTECIPA - AGENDAMENTO
No menu lateral, acessando a opção Antecipa → Agendamento Antecipa, é possível parametrizar o agendamento de execução dos serviços que irão efetuar a comunicação de forma automática com o TOTVS Antecipa. São os serviços de "Busca Informações TOTVS Antecipa" e "Retorna Status TOTVS Antecipa". Clique em Editar para informar os campos:
...
Campo | Descrição |
---|---|
Data de Execução | Informar o início da execução, se será iniciado assim que executado ou será agendado o início da execução. |
Servidor de Execução | Selecionar o servidor de execução RPW cadastrado. |
Repetir Ocorrência? | Este agendamento deverá ser repetido? SIM/NÃO. |
Abas Diária/Semanal/Mensal | Definir se a execução será Diária, Semanal ou Mensal. |
Frequência | Selecionar se será executado 1x ao dia ou várias vezes. Exemplo: Várias vezes ao dia a cada 5 minutos (recomendado) para os serviços de Busca e Retorno de status ao TOTVS Antecipa, das 08:00 às 18:00. |
Hora Início/ Hora Fim | Faixa de horário em que o agendamento deverá ser executado. |
A cada | A cada hora(s) ou minuto(s). |
Gerar Agendamento RPW | Este botão deve ser acionado a cada agendamento criado (não é necessário clicar em Salvar para este processo). |
Card documentos | ||||
---|---|---|---|---|
|
c. PARAMETRIZAÇÃO - ANTECIPA - RECEBÍVEIS
No menu lateral, acessando a opção Antecipa → Parâmetros de Recebíveis, é possível informar os Portadores e Carteiras de Transferência e Desconto que serão utilizados no processo da antecipação de recebíveis. Clique em Editar para informar os campos:
...
Campo | Descrição |
---|---|
Empresa | Empresa logada, informada automaticamente. |
Portador/Carteira de Transferência | Este portador pode ser do tipo caixa e será utilizado para os títulos que estão em cobrança e que serão transferidos para este portador caixa para serem utilizados no borderô desconto. Este processo de troca de portador/carteira gera uma ocorrência bancária de Pedido de Baixa de forma automática. |
Portador/Carteira de Desconto | Serão utilizados quando o TOTVS Antecipa enviar a informação de que os títulos foram descontados. Este portador e carteira serão utilizados para criar o borderô de desconto. |
Conta Corrente de Movimentação Bancária | Conta Corrente utilizada para movimentação bancária. |
d. PARAMETRIZAÇÃO - ANTECIPA - REVERSÃO
No menu lateral, acessando a opção Antecipa → Parâmetros de Reversão, é possível informar os portadores e carteiras de reversão serão utilizados nas transações encaminhadas pelo TOTVS Antecipa que configuram o processo de cancelamento do processo de antecipação de recebíveis. Este processo pode ser por Coobrigação, Cancelamento por Divergência Comercial ou Recompra. Clique em Editar para informar os campos:
...
Campo | Descrição |
---|---|
Empresa | Empresa logada, informada automaticamente. |
Valida Movimento Contabilizado? | Parâmetro para indicar se será validado ou não os movimentos contabilizados no momento de efetuar o Estorno de Liquidação de Títulos antecipados. |
Portador/Carteira de Coobrigação | Portador e Carteira que serão utilizados posteriormente pelo processo de estorno que será chamado quando o TOTVS Antecipa enviar as informações para realizar o estorno da operação financeira de desconto. |
Portador/Carteira de Cancelamento por Divergência | Portador e Carteira que serão utilizados posteriormente pelo processo de estorno que será chamado quando o TOTVS Antecipa enviar as informações para realizar o estorno da operação financeira de desconto. |
Portador/Carteira de Recompra | Portador e Carteira que serão utilizados posteriormente pelo processo de estorno que será chamado quando o TOTVS Antecipa enviar as informações para realizar o estorno da operação financeira de desconto. |
Tipo Transação Caixa Despesa | O Tipo de Transação Caixa Despesa será utilizado para gerar movimento de despesa adicional no Caixa e Bancos quando a TOTVS cobrar taxa pelo cancelamento da Antecipação. |
05. PROCESSOS DE NEGÓCIO
A seguir, estão descritos os processos de negócio que irão ocorrer na integração com o TOTVS Antecipa e o seu reflexo no ERP.
a. ANTECIPAÇÃO DE TÍTULOS A RECEBER
A partir do TOTVS Antecipa, será possível solicitar a antecipação das Notas Fiscais que forem elegíveis para desconto. O desconto será semelhante ao desconto bancário, ou seja, a empresa recebe os valores de forma antecipada, Por sua vez, o cliente recebe um novo boleto, emitido pela TOTVS para pagamento. E esse desconto ocorre mediante uma taxa de despesa financeira.
...
Existe um tratamento para impedir o estorno dos movimento de Desconto de Títulos Antecipados pela TOTVS, quando estes estiverem contabilizados e o Parâmetro "Valida Movimento Contabilizado" marcado na tela de Reversão Wizard TOTVS Antecipa.
b. LIQUIDAÇÃO - PAGAMENTO PARCIAL/TOTAL PELO CLIENTE
Quando o cliente faz o pagamento do boleto, é disparado pelo TOTVS Antecipa o processo de Liquidação do título no Contas a Receber. Esta liquidação, da mesma forma que ocorre com títulos descontados via banco, irá contabilizar Saldo de Cliente contra Desconto TOTVS Antecipa.
c. ESTORNO DE LIQUIDAÇÃO
Caso haja algum problema ou alteração no pagamento deste boleto por parte do cliente, será disparado um estorno da liquidação efetuada anteriormente e o saldo do título volta a ficar em aberto. O estorno gera a a contabilização invertida da liquidação.
Quando o Parâmetro "Valida Movimento Contabilizado" estiver marcado, é impedido o estorno dos movimentos de Liquidação de Títulos Antecipados pela TOTVS, se estes estiverem contabilizados.
d. COOBRIGAÇÃO
Quando o cliente não paga o título, a TOTVS pode executar a coobrigação. Neste caso é feito um estorno do desconto TOTVS Antecipa. O título será transferido para o Portador e Carteira parametrizados como Portador e Carteira de Coobrigação (ver item Wizard de Configuração).
...
A conta de Principal Ativo que será movimentada será do portador de Desconto. Da mesma forma o portador de Coobrigação servirá somente para a transferência do título. Esta movimentação de conta de Principal Ativo não representa ainda a saída de dinheiro do caixa da empresa, mas sim, um débito que a empresa tem com a TOTVS, a ser acertado posteriormente.
e. DIVERGÊNCIA COMERCIAL
Quando houver algum tipo de divergência ou questionamento por parte do cliente referente àquela cobrança, é disparado o processo de Divergência Comercial. Neste caso é feito um estorno do desconto TOTVS Antecipa. O título será transferido para o Portador e Carteira parametrizados como Portador e Carteira de Divergência Comercial (ver item Wizard de Configuração).
...
A conta de Principal Ativo que será movimentada será do portador de Desconto. Da mesma forma o portador de Divergência Comercial servirá somente para a transferência do título. Esta movimentação de conta de Principal Ativo não representa ainda a saída de dinheiro do caixa da empresa, mas sim, um débito que a empresa tem com a TOTVS, a ser acertado posteriormente.
f. RECOMPRA
Após a Nota Fiscal ser antecipada, a empresa pode solicitar a Recompra da Nota Fiscal, devolvendo os valores recebidos. Neste caso é feito um estorno do desconto TOTVS Antecipa. O título será transferido para o Portador e Carteira parametrizados como Portador e Carteira de Recompra (ver item Wizard de Configuração).
...
A conta de Principal Ativo que será movimentada será do portador de Desconto. Da mesma forma o portador de Recompra servirá somente para a transferência do título. Esta movimentação de conta de Principal Ativo não representa ainda a saída de dinheiro do caixa da empresa, mas sim, um débito que a empresa tem com a TOTVS, a ser acertado posteriormente.
g. MOVIMENTAÇÃO BANCÁRIA
As operações descritas anteriormente, geram movimentações de entrada e saída na conta corrente do portador parametrizado como portador de Desconto. Estas movimentações representam débitos e créditos que a empresa tem com a TOTVS.
...
Essas movimentações deverão ser posteriormente conciliadas com o extrato bancário onde virão os depósitos da TOTVS.
06. CONTABILIZAÇÕES
A seguir detalhamos um exemplo de uma operação de antecipação de recebíveis via TOTVS Antecipa, demonstrando as Contabilizações que serão geradas no sistema.
...
CR R$ 50,00 na Conta de Crédito Padrão relacionada ao Tipo de Transação de Caixa que você informar no Wizard, na aba de reversão.
07. MONITOR DE INTEGRAÇÃO TOTVS ANTECIPA
O Monitor de Integração do TOTVS Antecipa apresenta todas as informações relacionadas a fila de processamento de documentos em integração ou integrados com o TOTVS Antecipa. Conforme demonstrado abaixo, é possível verificar os detalhes do documento.
...
Arquivo exportado (salvo em diretório definido pelo usuário):
a. MONITOR DE INTEGRAÇÃO TOTVS ANTECIPA - BUSCA AVANÇADA
O monitor de integração possui a opção de efetuar uma busca avançada, filtrando as principais informações na faixa desejada.
08. TABELAS NOVAS UTILIZADAS
param_integr_techfin
item_operac_techfin
...