Histórico da Página
CONTEÚDO
- Visão Geral
- Pré-Requisitos
- Parametrização de Utilização
- Parâmetros TOTVS Antecipa
- Parâmetros Recebíveis
- Parâmetros Reversão
- Parâmetros Pós-Faturamento
- Agendamento Antecipa
34. Monitor Integração TOTVS Techfin
- Monitor Pós-Faturamento Antecipa
- Monitor Antecipação e Conciliação
- Erros
- Monitor Pós-Faturamento Antecipa
45. Processo de Pós-Faturamento
a. Prorrogação
56. Liberação e Expedição
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.Foi disponibilizada a versão inicial conforme o seguinte Material:
Tutorial - Integração Datasul x TOTVS Antecipa Versão Inicial
A Nova Versão da Integração do TOTVS Antecipa, contempla algumas das melhorias que serão detalhadas neste Tutorial bem como a Integração da operação de Pós-Faturamento, Prorrogação.
02.
...
PRÉ-REQUISITOS
Para a correta execução
...
do processo de
...
a. Parâmetros TOTVS Techfin
Em Parâmetros TOTVS Techfin serão realizadas todas as configurações para utilização das integrações dos produtos Techfin ao ERP da Linha Datasul, como também as novas funcionalidades liberadas para eventos de Pós-Faturamento do TOTVS Antecipa.
Principais Campos Configurações Gerais
...
Campo
...
Descrição
...
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: A URL TOTVS Antecipa será utilizada para o Pós-Faturamentos dos produtos Totvs Mais Negócios e Totvs Antecipa.
No Menu Lateral, em Antecipa são apresentações as ações relacionadas ao TOTVS Antecipa
Outras Ações / Ações relacionadas Antecipa
...
Possibilita realizar Agendamento da tarefa de integração de dados do TOTVS Antecipa com o ERP Datasul.
Informar a data início da execução, selecionar um servidor de execução RPW cadastrado, definir recorrência e frequência da execução.
O sistema permite agendar a execução dos serviços de integração com o TOTVS Antecipa várias vezes ao dia em intervalos de tempo definidos conforme a necessidade da empresa.
...
b. Parâmetros Recebíveis
Na página de Parâmetros Recebíveis foi inserido um novo Campo, Conciliação - Tipo Transação de Caixa.
Na versão anterior era obrigatório o cadastro do tipo de transação Caixa com nome "ACR", a partir da Nova Versão será permitido realizar criar o Tipo de Transação Caixa com o nome desejado e relacioná-lo ao campo indicado nos Parâmetros Recebíveis do TOTVS Antecipa.
Principais Campos e Parâmetros de Pós-Faturamento
...
Campo
...
Descrição
...
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ô e operação de desconto.
...
Novo campo - Tipo de Transação de Caixa para geração dos valores da Conciliação no módulo de Caixa e Bancos.
Em Manutenção Tipo Transação Caixa (CMG003aa) informar a Conta Corrente com a finalidade Débito Padrão.
...
Em Manutenção Carteira Bancária (UFN012AA) informar uma carteira do tipo Desconto e marcar o parâmetro TOTVS Antecipa.
Para que as informações fiquem consistentes, as finalidades contábeis da carteira bancária de Desconto devem ser do tipo 'Desconto TOTVS Antecipa' e 'Despesa TOTVS Antecipa'.
c. Parâmetros Reversão
Principais Campos e Parâmetros
...
Campo
...
Descrição
...
d. Parâmetros Pós-Faturamento
Neste Cadastro serão informados os Tipos de Transação Caixa para cada operação de Pós-Faturamento.
A nova versão disponibiliza os cadastros para as operações de Bonificação e Devolução, porém a integração dessas operações estão em desenvolvimento, neste momento é necessário parametrizar o Tipo de Transação de Caixa Taxa para a Prorrogação.
Parâmetros de Pós-Faturamento Liberado
...
d. Agendamento Antecipa
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 que farão a Busca de Informações e Retorno de Status do TOTVS Antecipa.
Este processo foi modificado para permitir realizar o processo de integração com a plataforma TOTVS Antecipa de forma unificada, ou seja, ao executar o processo de agendamento, o sistema fará a Busca de Informações, Processamento no ERP e Retorno de Status do TOTVS Antecipa.
No Agendamento Antecipa, serão integradas todas as operações do TOTVS Antecipa:
- Antecipação
- Conciliação
- Pós-Faturamento
A rotina de Agendamento fará o processamento das informações no ERP para os lotes que apresentaram Pendentes de processamento ou que estão com algum erro.
Neste processo poderão ocorrer erros de retorno na plataforma TOTVS Antecipa como erros de Negócio no ERP Datasul.
Os erros de negócio poderão ser corrigidos no ERP os erros de integração deverão ser avaliados diretamente na plataforma. No próximo Agendamento os lotes que apresentaram erros serão processados novamente.
A visualização dos erros será disponibilizada no Monitor Antecipação/Conciliação ou Monitor Pós-Faturamento.
Pré-Requisitos:
- 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 do Tutorial - Integração Datasul x TOTVS Antecipa Versão Inicial.
- Para executar o Agendamento da integração é necessário realizar a atualização de Menu, conforme documentação Importação Menu Datasul (MEN706AA).
Principais Campos e Parâmetros
...
Campo
...
Descrição
...
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
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.
O 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.
02. PARAMETRIZAÇÃO DE UTILIZAÇÃO
Os Parâmetros de utilização foram adequados para a utilização do processo de Pós-Faturamento e ganharam algumas melhorias de usabilidade.
a. Parâmetros TOTVS Techfin
Em Parâmetros TOTVS Techfin serão realizadas todas as configurações para utilização das integrações dos produtos Techfin ao ERP da Linha Datasul, como também as novas funcionalidades liberadas para eventos de Pós-Faturamento do TOTVS Antecipa.
Principais Campos Configurações Gerais
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: A URL TOTVS Antecipa será utilizada para o Pós-Faturamentos dos produtos Totvs Mais Negócios e Totvs Antecipa. |
No Menu Lateral, em Antecipa são apresentações as ações relacionadas ao TOTVS Antecipa
Outras Ações / Ações relacionadas Antecipa
Ação | Descrição |
---|---|
Agendamento Antecipa | Possibilita realizar Agendamento da tarefa de integração de dados do TOTVS Antecipa com o ERP Datasul. Informar a data início da execução, selecionar um servidor de execução RPW cadastrado, definir recorrência e frequência da execução. |
Parâmetros Recebíveis | Nos Parâmetros de Recebíveis, é possível informar os Portadores e Carteiras de Transferência e Desconto, Conta Corrente Bancária, que serão utilizados no processo da antecipação de recebíveis. |
Parâmetros Reversão | Nos 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. |
Pós-Faturamento | Nos Parâmetros de Pós-Faturamento TOTVS Antecipa serão informados quais os tipos de transação Caixa para cada evento de Pós-Faturamento do TOTVS Antecipa. |
b. Parâmetros Recebíveis
Na página de Parâmetros Recebíveis foi inserido um novo Campo, Conciliação - Tipo Transação de Caixa.
Na versão anterior era obrigatório o cadastro do tipo de transação Caixa com nome "ACR", a partir da Nova Versão será permitido realizar criar o Tipo de Transação Caixa com o nome desejado e relacioná-lo ao campo indicado nos Parâmetros Recebíveis do TOTVS Antecipa.
Principais Campos e Parâmetros de Pós-Faturamento
Campo | Descrição |
---|---|
Empresa | Empresa corrente, 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ô e operação de desconto. |
Conta Corrente | Conta Corrente utilizada para movimentação bancária. |
Tipo Transação de Caixa de Conciliação | Novo campo - Tipo de Transação de Caixa para geração dos valores da Conciliação no módulo de Caixa e Bancos. Em Manutenção Tipo Transação Caixa (CMG003aa) informar a Conta Corrente com a finalidade Débito Padrão. |
Importante! | Em Manutenção Carteira Bancária (UFN012AA) informar uma carteira do tipo Desconto e marcar o parâmetro TOTVS Antecipa. Para que as informações fiquem consistentes, as finalidades contábeis da carteira bancária de Desconto devem ser do tipo 'Desconto TOTVS Antecipa' e 'Despesa TOTVS Antecipa'. |
c. Parâmetros Reversão
Principais Campos e Parâmetros
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. |
d. Parâmetros Pós-Faturamento
Neste Cadastro serão informados os Tipos de Transação Caixa para cada operação de Pós-Faturamento.
A nova versão disponibiliza os cadastros para as operações de Bonificação e Devolução, porém a integração dessas operações estão em desenvolvimento, neste momento é necessário parametrizar o Tipo de Transação de Caixa Taxa para a Prorrogação.
Parâmetros de Pós-Faturamento Liberado
Campo | Descrição |
---|---|
Prorrogação - Tipo Transação de Caixa Taxa | Para geração dos valores da Taxa de Prorrogação no módulo de Caixa e Bancos. |
Bonificação - Tipo Transação de Caixa Desconto | Para geração dos valores da desconto da Bonificação no módulo de Caixa e Bancos. |
Devolução - Tipo Transação de Caixa Taxa | Para devolução dos valores da Taxa de Devolução no módulo de Caixa e Bancos. |
Devolução - Tipo Transação de Caixa Estorno Taxa Original | Para geração dos valores de Estorno da Taxa Original no módulo de Caixa e Bancos. |
Devolução - Tipo Transação de Caixa Valor | Para geração dos valores de devolução no módulo de Caixa e Bancos. |
Obrigatoriedade | Informar o Tipo de Transação caixa para todos os Eventos de Pós-Faturamento. |
d. Agendamento Antecipa
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 que farão a Busca de Informações e Retorno de Status do TOTVS Antecipa.
Este processo foi modificado para permitir realizar o processo de integração com a plataforma TOTVS Antecipa de forma unificada, ou seja, ao executar o processo de agendamento, o sistema fará a Busca de Informações, Processamento no ERP e Retorno de Status do TOTVS Antecipa.
No Agendamento Antecipa, serão integradas todas as operações do TOTVS Antecipa:
- Antecipação
- Conciliação
- Pós-Faturamento
A rotina de Agendamento fará o processamento das informações no ERP para os lotes que apresentaram Pendentes de processamento ou que estão com algum erro.
Neste processo poderão ocorrer erros de retorno na plataforma TOTVS Antecipa como erros de Negócio no ERP Datasul.
Os erros de negócio poderão ser corrigidos no ERP os erros de integração deverão ser avaliados diretamente na plataforma. No próximo Agendamento os lotes que apresentaram erros serão processados novamente.
A visualização dos erros será disponibilizada no Monitor Antecipação/Conciliação ou Monitor Pós-Faturamento.
Pré-Requisitos:
- 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 do Tutorial - Integração Datasul x TOTVS Antecipa Versão Inicial.
- Para executar o Agendamento da integração é necessário realizar a atualização de Menu, conforme documentação Importação Menu Datasul (MEN706AA).
Principais Campos e Parâmetros
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). |
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.
...
03. MONITOR INTEGRAÇÃO TOTVS TECHFIN
...