Árvore de páginas


CONTEÚDO

  1. Visão Geral
  2. Pré-requisitos
  3. Cadastros envolvidos
  4. Parametrização TOTVS Antecipa 
    1. Parametrização - Configurações Gerais
    2. Parametrização - Antecipa - Agendamento
    3. Parametrização - Antecipa - Recebíveis
    4. Parametrização - Antecipa - Reversão
  5. Processos de Negócio que serão integrados
  6. Contabilizações
  7. Monitor de Integração TOTVS Antecipa
    1. Monitor de Integração TOTVS Antecipa - Busca Avançada
  8. 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.

Se você quiser aderir ao Antecipa, acesse o link abaixo e selecione a opção "ligamos pra você", deixe seus dados para nossa equipe comercial entrar em contato.

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.

Outro pré-requisito importante: 

  • Ter os XMLs das notas fiscais armazenados nos diretórios padrão do produto, para as soluções padrão da TOTVS, que são TSS e Neogrid. Caso seja utilizado alguma outra solução para o envio das notas fiscais a SEFAZ ou caso utilize as soluções padrão com algum tipo de customização, ficará sob responsabilidade do cliente a construção de uma EPC para buscar os XMLs das notas fiscais. Para estes casos a TOTVS irá fornecer um modelo de EPC, caso o cliente queira desenvolver. Haverá ainda a possibilidade de contratação da nossa Fábrica de Software para construção da EPC.


Importante

Esta EPC deverá ser vinculada no programa "nota-fiscal_data" através da rotina "Manutenção de Programa - men\men012aa.r" do Foundation, campo "Programa UPC" conforme mostra a imagem abaixo:


  • Modelo EPC a ser utilizada de forma específica para busca de XML das Notas Fiscais Eletrônicas (clicar em "Expandir Origem")
Exemplo EPC - nota-fiscal_data.p
/*****************************************************************************************************
 ** OBJETIVO..: Retornar o conteúdo do arquivo XML de uma NF-e
 ** 
 ** IMPORTANTE: o conteúdo deste programa não poderá ser alterado para manter
 **             seu correto funcionamento.
 **             O único ponto que deverá ser alterado pelo cliente é no que diz respeito à busca do 
 **             arquivo XML da nota fiscal recebida através do buffer da temp-table tt-nota-fiscal
 ** 
*****************************************************************************************************/
{include/i-epc200.i1}

DEFINE INPUT        PARAMETER p-ind-event AS CHAR NO-UNDO.
DEFINE INPUT-OUTPUT PARAMETER TABLE FOR tt-epc. 

DEFINE TEMP-TABLE tt-nota-fiscal   NO-UNDO
    FIELD nr-nota-fis              AS CHARACTER
    FIELD serie                    AS CHARACTER
    FIELD cod-esp                  AS CHARACTER
    FIELD nr-parcelas              AS INTEGER
    FIELD nr-fatura                AS CHARACTER
    FIELD dt-emis-nota             AS DATE
    FIELD cod-estabel              AS CHARACTER
    FIELD cod-empresa              AS CHARACTER
    FIELD ind-tip-nota             AS CHARACTER
    FIELD cod-chave-aces-nf-eletro AS CHARACTER
    FIELD cod-emitente             AS INTEGER
    FIELD xml-nota-fiscal          AS CLOB
    FIELD dt-atualiza              AS DATE
    FIELD hr-atualiza              AS CHARACTER
    FIELD idi-sit-nf-eletro        AS INTEGER.

DEFINE VARIABLE h-bf-tt-nota-fiscal AS   HANDLE                  NO-UNDO.
DEFINE VARIABLE lXmlNfe             AS   LONGCHAR                NO-UNDO.
DEFINE VARIABLE cArquivoXML         AS   CHARACTER               NO-UNDO.
DEFINE VARIABLE c-cod-estabel       LIKE nota-fiscal.cod-estabel NO-UNDO.
DEFINE VARIABLE c-serie             LIKE nota-fiscal.serie       NO-UNDO.
DEFINE VARIABLE c-nr-nota-fis       LIKE nota-fiscal.nr-nota-fis NO-UNDO.
DEFINE VARIABLE c-cod-dir-histor-xml AS  CHARACTER               NO-UNDO.

IF  p-ind-event = "Retorna_Conteudo_XML" THEN DO:
    FIND FIRST tt-epc 
         WHERE tt-epc.cod-event     = p-ind-event 
           AND tt-epc.cod-parameter = "tt-nota-fiscal":U NO-LOCK NO-ERROR.

    IF AVAIL tt-epc THEN DO:
        ASSIGN h-bf-tt-nota-fiscal = WIDGET-HANDLE(tt-epc.val-parameter) NO-ERROR.

        IF ERROR-STATUS:ERROR THEN
            RETURN "OK":U.

        IF VALID-HANDLE(h-bf-tt-nota-fiscal) THEN DO:
            ASSIGN c-cod-estabel = h-bf-tt-nota-fiscal:BUFFER-FIELD("cod-estabel"):BUFFER-VALUE
                   c-serie       = h-bf-tt-nota-fiscal:BUFFER-FIELD("serie"):BUFFER-VALUE 
                   c-nr-nota-fis = h-bf-tt-nota-fiscal:BUFFER-FIELD("nr-nota-fis"):BUFFER-VALUE.
    
            FOR FIRST nota-fiscal
                WHERE nota-fiscal.cod-estabel = c-cod-estabel
                  AND nota-fiscal.serie       = c-serie
                  AND nota-fiscal.nr-nota-fis = c-nr-nota-fis NO-LOCK:
                
                /***************************************************************************************************************************
                ** BUSCA DO DIRETÓRIO + ARQUIVO XML REFERENTE À NOTA FISCAL 
                ** ALTERAR SOMENTE NESTE BLOCO ENTRE OS COMENTÁRIOS
                
                ** Colocar aqui a lógica para localizar o XML da nota fiscal posicionada
                ** IMPORTANTE! A variável "cArquivoXML" deverá ser atualizada com o diretório + arquivo XML referente à nota fiscal 
                **
                ** Ex.: ASSIGN cArquivoXML = "\\servidor\diretorio\XML_NFe\311815320201214172138.xml".
                ** 
                ** Exemplo de busca efetuada pelo TSS no produto padrão:
                
                   FOR FIRST param-nf-estab 
                       WHERE param-nf-estab.cod-estabel = nota-fiscal.cod-estabel NO-LOCK:
                        ASSIGN c-cod-dir-histor-xml = param-nf-estab.cod-caminho-xml.
                   END.  
                
                   ASSIGN c-nr-nota-xml = TRIM(nota-fiscal.cod-estabel) +                              
                                          SUBSTR(nota-fiscal.cod-chave-aces-nf-eletro,23,3) + 
                                          TRIM(STRING(INTEGER(SUBSTR(nota-fiscal.cod-chave-aces-nf-eletro,26,9)),">>9999999")) + ".XML"
                       
                          c-chave-xml = TRIM(nota-fiscal.cod-chave-aces-nf-eletro) + ".XML".    
                          
                    IF  SEARCH(c-cod-dir-histor-xml + "/" + c-nr-nota-xml) <> ? THEN
                        ASSIGN cArquivoXML = c-cod-dir-histor-xml + "/" + c-nr-nota-xml.
                  
                    IF  SEARCH(c-cod-dir-histor-xml + "/" + c-chave-xml) <> ? THEN
                        ASSIGN cArquivoXML = c-cod-dir-histor-xml + "/" + c-chave-xml.
                
                **  
                ** NÃO ALTERAR A PARTIR DESTE PONTO PARA BAIXO!        
                ****************************************************************************************************************************/
    
                IF  cArquivoXML <> ""
                AND search(cArquivoXML) <> ? THEN DO:
                    COPY-LOB FROM FILE cArquivoXML TO lXmlNfe.
                END.
    
                IF lXmlNfe <> "" THEN
                   ASSIGN h-bf-tt-nota-fiscal:BUFFER-FIELD("xml-nota-fiscal"):BUFFER-VALUE = lXmlNfe.
            END.
        END.
    END.
END.


CERTIFICADO NO PROGRESS

A conexão realizada com o Totvs Apps utiliza o protocolo seguro HTTPS, por este motivo, para que seja possível realizar a conexão, é necessário que o Progress possua instalado o certificado correspondente.

Assistente de configuração para integração com Totvs Apps (ConfigAppsWizard) irá realizar a instalação automática dos certificados, mas somente para o servidor que for configurado no assistente.

Em alguns processos de negócio do Produto, a integração irá correr em um local diferente do configurado no assistente, podendo ser um outro servidor RPW, AppServer ou mesmo a máquina do usuário. Na documentação destes processos de negócio, haverá uma indicação de onde o certificado deve ser instalado.

Para realizar a instalação do certificado, basta seguir os passos descritos no endereço abaixo:
https://centraldeatendimento.totvs.com/hc/pt-br/articles/360025880814-DS-TEC-Aplica%C3%A7%C3%A3o-de-certificados-no-Progress

Importante:
- Os certificados necessários estão disponíveis na mídia do Datasul, no caminho: "\univdata\certs" correspondente ao "foundation";
- Devem ser instalados os certificados: "apps_prod.cer" e "apps_staging.cer";
- Apesar de ter o extensão ".cer" eles já estão no formato ".pem" solicitado no documento de instalação.


IMPORTANTE!

O TOTVS Antecipa foi liberado a partir da release 12.1.27, via Console.

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. 

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.

       

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

Na conta de "Crédito Padrão" será contabilizado a entrada do dinheiro quando a Supplier fizer o depósito na Conta Corrente bancária;

Na conta de "Débito Padrão" será contabilizada a saída do dinheiro da conta corrente associada ao portador de Desconto. Sempre que ocorre o depósito em conta corrente, ocorre essa transferência da conta corrente do portador de desconto para a conta corrente bancária.

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:


Principais Campos e Parâmetros

CampoDescrição
EmpresaEmpresa logada, informada automaticamente.
Utiliza Totvs Mais NegóciosNeste campo deverá ser marcado se é utilizado o produto Totvs Mais Negócios.
Utiliza Totvs AntecipaNeste campo deverá ser marcado se é utilizado o produto Totvs Antecipa. Para ambiente de produção: fmscash.totvs.app.
Utiliza Painel FinanceiroNeste 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 RACNeste campo deverá ser informada a URL do TOTVS RAC para autenticação. Para ambiente de produção: totvs.rac.totvs.app.
Client IDNeste campo deverá ser informado o Client Id disponibilizado na contratação do TOTVS Antecipa.
Client SecretNeste 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:


Caso o Servidor de Execução não seja o mesmo parametrizado no Assistente de configuração para integração com Totvs Apps (ConfigAppsWizard), os certificados devem ser instalados conforme descrito no tópico 02. PRÉ-REQUISITOS.


Principais Campos e Parâmetros

CampoDescrição
Data de ExecuçãoInformar o início da execução, se será iniciado assim que executado ou será agendado o início da execução.
Servidor de ExecuçãoSelecionar o servidor de execução RPW cadastrado.
Repetir Ocorrência?Este agendamento deverá ser repetido? SIM/NÃO.
Abas Diária/Semanal/MensalDefinir se a execução será Diária, Semanal ou Mensal.
FrequênciaSelecionar 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 FimFaixa de horário em que o agendamento deverá ser executado.
A cadaA cada hora(s) ou minuto(s).
Gerar Agendamento RPWEste botão deve ser acionado a cada agendamento criado (não é necessário clicar em Salvar para este processo).

IMPORTANTE!

Por se tratar de comunicação entre o ERP Datasul e o produto TOTVS Antecipa, para o funcionamento correto destes serviços, é necessário que os pré-requisitos sejam atendidos.


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:


Principais Campos e Parâmetros

CampoDescrição
EmpresaEmpresa logada, informada automaticamente.
Portador/Carteira de TransferênciaEste 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 DescontoSerã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áriaConta 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:


Principais Campos e Parâmetros

CampoDescrição
EmpresaEmpresa 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çãoPortador 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ênciaPortador 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 RecompraPortador 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 DespesaO 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.

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 TOTVS).

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 TOTVS a ser depositado na sequência.

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

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

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

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

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

O valor de todas as movimentações são totalizados e gera apenas um movimento em cada conta corrente (Débito ou Crédito).

No histórico no movimento gerado indica que o movimento é proveniente do TOTVS Antecipa.

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.

Exemplo:

Tenho um título de R$ 1.000,00 e vou solicitar a Antecipação. A taxa cobrada será de R$ 50,00 e vou receber efetivamente R$ 950,00.

Serão geradas as seguintes contabilizações:

1. Quando for confirmada a operação de desconto, a contabilização será:

DB R$ 950,00 na conta de Principal Ativo do portador de desconto (conta contábil amarrada à conta corrente do portador de desconto com a finalidade contábil Principal Ativo)

DB R$ 50,00 na conta de Despesa TOTVS Antecipa (conta de despesa amarrada à carteira bancária de desconto, com a finalidade Despesa TOTVS Antecipa).

CR R$ 1.000,00 na conta de Desconto TOTVS Antecipa (conta amarrada à carteira bancária de desconto, com a finalidade Desconto TOTVS Antecipa)
  

2. Quando a TOTVS depositar o dinheiro para sua empresa:

DB R$ 950,00 na conta de Principal Ativo da sua conta corrente bancária (conta contábil que representa sua conta no banco onde você recebeu o depósito, amarrada no cadastro da conta corrente bancária com a finalidade contábil Principal Ativo)

CR R$ 950,00 na conta contábil amarrada ao tipo de transação de caixa "ACR" e à conta corrente bancária, com a finalidade contábil "Crédito Padrão"

DB R$ 950,00 na conta contábil amarrada ao tipo de transação de caixa "ACR" e à conta corrente do portador de desconto, com a finalidade contábil "Débito Padrão"

CR R$ 950,00 na conta de Principal Ativo do portador de desconto (mesma conta descrita no item 1 pra contabilização dos R$ 950,00, de forma que o "saldo" desta conta ref. a esta operação zera)


3. Quando o cliente efetivamente pagar o boleto à TOTVS:

DB R$ 1.000,00 na conta de Desconto TOTVS Antecipa (mesma conta utilizada no item 1, que neste momento também "zera" o saldo ref. a essa operação de desconto)

CR R$ 1.000,00 na conta de saldo do Cliente (o cliente não deverá mais pra sua empresa)


4. Caso haja alguma reversão (neste caso não há o item 3 descrito anteriormente):

DB R$ 1.000,00 na  conta de Desconto TOTVS Antecipa (mesma conta utilizada no item 1, que neste momento também "zera" o saldo ref. a essa operação de desconto)

CR R$ 1.000,00 na conta de Principal Ativo do portador de desconto (conta amarrada à conta corrente do portador de desconto. Neste caso esta conta ficará com "saldo" devedor que representará um débito que você tem com a TOTVS e só irá zerar quando você fizer uma nova Antecipação e a TOTVS descontar esse valor)

4a. Para o caso de haver ainda algum estorno da Taxa de Despesa (vamos imaginar um estorno total dos R$ 50,00 cobrados lá no início) irá gerar ainda:

DB R$ 50,00 na Conta de Principal Ativo do portador de desconto (representará um crédito que você tem com a TOTVS e será considerado no próximo depósito)

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. 


Principais Campos e Parâmetros

CampoDescrição
IdIdentificador único do documento em processamento/processado.
Data ConsultaData em que ocorreu a consulta no TOTVS Antecipa.
Data Início ProcessamentoData e hora do início de processamento da fila de documentos a serem integrados.
Data Fim ProcessamentoData e hora final do processamento da fila de documentos integrados.
EmpresaEmpresa que está executando o processamento.
EstabEstabelecimento a que o documento pertence.
StatusStatus de processamento. Status possíveis: Sucesso, Sucesso Datasul*PendenteProcessandoErro**.
LogSerá apresentado quando houverem erros no Datasul durante a integração.

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.

O Monitor de Integração TOTVS Antecipa também possui um botão Reprocessar, na qual permite ao usuário buscar manualmente as informações do TOTVS Antecipa e atualizar no ERP. Esse botão funciona da mesma forma que o serviço configurado no Item 4.b, entretanto, nesse momento não é executado um pedido via RPW. Para tal funcionalidade, a execução ocorre no AppServer, sendo assim necessário a instalação dos certificados no AppServer configurado para a empresa conforme descrito no tópico 02. PRÉ-REQUISITOS.


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 Item 4.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.

08. TABELAS NOVAS UTILIZADAS

param_integr_techfin

item_operac_techfin

techfin_configur

techfin_process

techfin_process_event