Histórico da Página

CONTEÚDO

1. Visão Geral
2. Pré-requisitos
3. Cadastros envolvidos
4. Wizard de Configuração - Home 
   1. Wizard de Configuração - Integração
      
   2. Wizard de Configuração - Parâmetros de Recebíveis
   3. Wizard de Configuração - Parâmetros de Reversão
   4. Wizard de Configuração - Finalizar
5. Processos de Negócio que serão integrados
6. Monitor de Integração TOTVS Antecipa
   1. Monitor de Integração TOTVS Antecipa - Busca Avançada
      
7. 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 14h, o valor das antecipações é recebido ainda no mesmo dia.

02. PRÉ-REQUISITOS

Para a correta execução do processo de antecipação, existem alguns pré-requisitos que devem ser impreterivelmente atendidos:

• Estar na versão OE 11.7.5;
• Ter todos os certificados Progress, TOTVS RAC, Carol, TOTVS Antecipa (Como baixar os certificados de URL para utilização com HTTPs) atualizados no diretório C:\dlc117\certs;

  • Para ambiente de Produção, as URL´s são:

    URL TOTVS RAC:
    https://totvs.rac.totvs.app/

    URL TOTVS ANTECIPA:
    https://fmscash.totvs.app

    URL CAROL:
    https://totvstechfin.carol.ai

     

  • Para ambiente de Homologação, as URL´s são:

    URL TOTVS RAC:
    https://totvs.rac.staging.totvs.app

    URL TOTVS ANTECIPA:
    https://fmscash.staging.totvs.app/

    URL CAROL:
    https://totvstechfinstaging.carol.ai/

• Ter as seguintes bibliotecas no propath:
  • C:\dlc117\gui\OpenEdge.BusinessLogic.pl
  • C:\dlc117\gui\OpenEdge.Core.pl
  • C:\dlc117\gui\OpenEdge.ServerAdmin.pl
  • C:\dlc117\gui\netlib\OpenEdge.Net.pl
• Ter os XML's das notas que serão carregadas no TOTVS Antecipa e utilizadas na antecipação no diretório parametrizado no programa CD0403;
• Ter aplicado os Patches de acordo com a release utilizada;

03. CADASTROS ENVOLVIDOS

a. CONTA CONTÁBIL INTEGRAÇÃO

        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          a despesa financeira dessas operações (finalidade contábil "Despesa TOTVS Antecipa").

b. CARTEIRA BANCÁRIA

        No cadastro de Carteira Bancária, é necessário fazer algumas manutenções para que possam ser utilizadas para o TOTVS Antecipa.

        Deverá ser criada uma Carteira Bancária nova, ou escolhida uma carteira para utilizar na integração. Esta carteira deve ser do tipo "Desconto" e também deverá ser marcada a opção "TOTVS                        Antecipa":

        Para esta carteira, deverão também ser cadastradas algumas contas contábeis com finalidades contábeis que foram criadas para o TOTVS Antecipa. 

        A conta contábil com finalidade "Desconto TOTVS Antecipa" será utilizada para contabilizar o desconto dos títulos via TOTVS Antecipa e também para o estorno do desconto nas situações de                    Recompra, Coobriação ou Divergência Comercial.

        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.

04. WIZARD DE CONFIGURAÇÃO - HOME

Para auxiliar no cadastro das principais configurações do TOTVS Antecipa, foi disponibilizado o WIZARD de Configuração TOTVS Antecipa. Para iniciar a configuração, clicar em "Começar":

a. WIZARD DE CONFIGURAÇÃO - INTEGRAÇÃO - DADOS DE AUTENTICAÇÃO

Neste passo, devem ser inseridos os dados pertinentes a comunicação entre o Datasul, Carol e o TOTVS Antecipa. 

Principais Campos e Parâmetros

Card documentos
Informacao Por tratar-se de informações sensíveis, este cadastro deve ser efetuado exatamente com as informações disponibilizadas na contratação do TOTVS Antecipa. Titulo IMPORTANTE!

Caso ocorra alguma falha na comunicação entre o Datasul e webservice TOTVS Antecipa, será gerado o arquivo log_erros_totvs_antecipa.txt no diretório de spool do usuário RPW cadastrado no programa sec\sec000aa.r.

b. WIZARD DE CONFIGURAÇÃO - INTEGRAÇÃO - AGENDAMENTO 

Ainda no passo de Integração, cadastrar o agendamento de execução do serviço que irá efetuar a Carga de Dados do Datasul para a Carol de forma automática no TOTVS Antecipa. 

Devem ser cadastrados também, os serviços de "Busca Informações TOTVS Antecipa" e "Retorna Status para TOTVS Antecipa". 

Principais Campos e Parâmetros

c. WIZARD DE CONFIGURAÇÃO - PARÂMETROS DE RECEBÍVEIS

Neste passo, informar Portadores e Carteiras de Transferência e Desconto que serão utilizados no processo da antecipação de recebíveis.

Principais Campos e Parâmetros

d. WIZARD DE CONFIGURAÇÃO - PARÂMETROS DE REVERSÃO

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.

Principais Campos e Parâmetros

e. WIZARD DE CONFIGURAÇÃO - FINALIZAR

Na tela de finalização do processo de configuração, ao clicar no botão "Monitor TOTVS Antecipa", o usuário será encaminhado para a tela de monitoramento dos processos de integraçã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 Supplier para pagamento. E esse desconto ocorre mediante uma taxa de despesa financeira.

        O desconto, no TOTVS Antecipa deverá ser solicitado da Nota Fiscal como um todo, ou seja, serão antecipadas todas as parcelas da Nota Fiscal (e os seus respectivos títulos no Contas a Receber).

        Uma vez solicitado o desconto na plataforma e aprovado, será criado um borderô no Contas a Receber com os títulos envolvidos e uma Operação Financeira de Desconto que será atualizada                    automaticamente. O borderô será gerado para o portador parametrizado como portador de Desconto para o TOTVS Antecipa (ver item Wizard de Configuração).

        No momento da atualização é gerado um movimento de "Desconto TOTVS Antecipa", O título, por sua vez, permanece em aberto até a sua liquidação (pagamento por parte do cliente que ocorre            para a Supplier).

        As contas contábeis para contabilizar o Desconto e a Despesa Financeira serão buscadas da Carteira Bancária parametrizada como carteira de Desconto para o TOTVS Antecipa (ver item Wizard de            Configuração).

        A conta contábil de Principal Ativo que será movimentada será buscada do Portador de Desconto. A movimentação desta conta ainda não representa a entrada do dinheiro no caixa da empresa e              sim um crédito que a empresa tem com a Supplier a ser depositado na sequência.

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.

d. COOBRIGAÇÃO

       Quando o cliente não paga o título, a Supplier 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). 

       O estorno do desconto será contabilizado na conta de Desconto TOTVS Antecipa ref. a carteira bancária de Desconto. A carteira de Coobrigação servirá somente para a transferência do título.

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

        O estorno do desconto será contabilizado na conta de Desconto TOTVS Antecipa ref. a carteira bancária de Desconto. A carteira de Divergência Comercial servirá somente para a transferência do              título.

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

        O estorno do desconto será contabilizado na conta de Desconto TOTVS Antecipa ref. a carteira bancária de Desconto. A carteira de Recompra servirá somente para a transferência do título.

        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 Supplier, 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 Supplier. 

       Posteriormente o ERP irá receber do TOTVS Antecipa a conciliação destas informações e essa conciliação irá gerar movimentações na conta bancária parametrizada como Conta de                                       Movimentação Bancária no Wizard de Configuração. Esta conta deve ser a mesma conta informada no contrato com a Supplier para recebimento dos depósitos bancários.

       Quando a movimentação for de Crédito, será gerada uma saída na conta corrente do portador de Desconto e uma entrada na Conta Corrente de movimentação bancária.

       Quando a movimentação for de Débito, será gerada uma entrada na conta corrente do portador de Desconto e uma saída na Conta Corrente de movimentação bancária.

       Essas movimentações deverão ser posteriormente conciliadas com o extrato bancário onde virão os depósitos da Supplier.

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

Principais Campos e Parâmetros

* O status de Sucesso Datasul ocorre quando o documento é atualizado no Datasul, porém por algum problema na comunicação com o Webservice do TOTVS Antecipa, o OK não é enviado. Então, numa próxima execução do serviço de integração (respeitando a configuração da periodicidade de execução cadastrada no Item 4.b referente agendamento), este status será atualizado para Sucesso.

DETALHES DOCUMENTO INTEGRADO

No detalhamento, é possível verificar a chave do título, informações bancárias, tipo da operação e valores da operação efetuada juntamente ao TOTVS Antecipa, permitindo facilitar a localização do documento que apresentou erro interno durante a integração. Assim que um erro é corrigido (Ex.: falta de cadastro), através do serviço configurado no item 03.b, automaticamente o sistema fará uma nova tentativa de integração.

** Na ocorrência de erros relacionados ao Datasul, é gerado um log de erros, acessível pelo botão apresentado no print abaixo, onde é possível visualizar e exportar o arquivo de erros:

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.

07. TABELAS NOVAS UTILIZADAS

• param_integr_techfin

• item_operac_techfin
• techfin_configur
• techfin_process
• techfin_process_event

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>