Árvore de páginas

CONTEÚDO

01. VISÃO GERAL

Para a importação das parcelas no módulo do ERP TOTVS de folha de pagamento, utilizamos um recurso implementado pelo TOTVS Consignado, que permite a conferência do movimento a ser integrado, dando autonomia para o usuário responsável da folha de pagamento, analisar os dados a serem importados para a folha mensal da competência vigente. 

Também utilizaremos neste processo de integração, o cadastro de grupo de eventos, que a partir do movimento importado como temporário, possibilita realizar o lançamento deste movimento em folha de pagamento no ERP TOTVS para a linha RM,  conforme processo de rotina padrão de lançamentos mensais.


Os valores usados para o preenchimento dos campos são específicos para cada cliente e serão disponibilizados para que sejam realizadas as validações. Os dados usados na validação dos campos das imagens são apenas exemplos, para demonstração do funcionamento do assistente.


02. PRÉ-CONDIÇÕES

Ativação do TOTVS Consignado

Parametrização do TOTVS Consignado no ERP


03. CARGA DE DADOS INTEGRADA

O processo de integração dos dados do TOTVS Consignado com o ERP é simples e precisa como interação do usuário, apenas a confirmação da realização de execução do processo interno neste momento.  Lembrando que todos os cadastrados e parametrizações precisam ter sido previamente realizados coforme as informações no item 02. PRÉ-CONDIÇÕES.

O processo irá considerar os dados enviados pela instituição financeira de crédito conveniada e apurados pelo TOTVS Consignado para a competência vigente em questão.

As telas são auto explicativas para conclusão deste processo.

.

Figura 1 - Tela de acesso ao Wizard.


Figura 2 - Tela de confirmação do processo de integração.


Figura 3 - Tela de acompanhamento do Progresso de execução do processo.


Figura 4 - Tela esperada após conclusão do processo de integração.



IMPORTANTE: Caso o processo integração não tenha sido concluído com sucesso, verifique a exceção apresentada conforme Log de Exceções apresentados neste documento.

Após a finalização do processo de integração, você poderá acompanhar os movimentos que formam importados para a base do ERP (tabela PFMOVTEMP) , bem como possíveis causas de insucesso na conclusão do processo, conforme detalhamento a seguir:


  • Exceções consideradas e tratadas com as seguintes mensagens:

              - Na obtenção dos dados plataforma Consignado:

                            - Algum dos dados da integração com o TOTVS Consignado não está preenchido.


              - Na obtenção de seções centralizadoras:

                            - Nenhuma seção centralizadora encontrada.


              - Na obtenção do token do rac:

                            - O token de acesso não pode ser obtido.

                                           - Código 404 (not found) na obtenção do token de acesso, possivelmente existe uma parametrização errada na sua URL da plataforma do RAC.

                                           - Código 400 (bad request) na obtenção do token de acesso, possivelmente existe uma parametrização errada nos dados de cliend_id e client_secret.

                                           - Código 500 (internal server error) ocorreu um erro inesperado do lado do servidor do RAC.


              - Na obtenção das parcelas do consignado:

                            - Nenhum evento de folha cadastrado.

                            - Nenhuma parcela a ser consumida do TOTVS Consignado na competência {0}/{1}.      

                           

  • Eventos descritos no Log resultante do processo de integração:

              - Integração TOTVS Consignado

                            - Foram encontradas {0} parcelas para serem importadas na competência {1}/{2}.

                            - Uma parcela de valor {0} na competência {1}/{2}, para a matrícula de funcionário {3}, não foi inserida.


Figura 5 - Exemplo da Tela de Logs



04. CONSULTA MOVIMENTO INTEGRADO

Para acompanhar os movimentos integrados pela plataforma TOTVS Consignado (tabela PFMOVTEMP) , utilize a ferramenta abaixo que permitirá ao usuário responsável pela movimentação deste benefício, realizar acompanhamento do que irá ser gravado na tabela financeira de seus funcionários para a competência em questão. 

Figura 6 - Tela de acesso ao Wizard.


    

Figura 7 - Tela de acesso a consulta


Para facilitar a busca, você poderá criar um filtro aplicando apenas a seguinte regra Origem do Evento = TOTVS Consignado ou Tipo Lançamento = Parcela do empréstimo consignado que permitirá a visibilidade dos dados conforme o exemplo abaixo :

Figura 8 - Exemplo da Consulta de Movimento Integração (tabela PFMOVTEMP), carregada pela integração a ser consumida no Grupo de Eventos



05. LANÇAMENTO DA INTEGRAÇÃO

Para que seja realizada a integração no movimento mensal de folha de pagamento das parcelas enviadas pela instituição de crédito integras ao ERP pelo TOTVS Consignado, realizando assim, a carga para descontos no envelope do mês,  é necessário que o usuário realize o lançamento de grupo de eventos que já é rotina da folha de pagamento RM.

Você poderá ptar por realizar este lançamento junto com o grupo da folha mensal ou em separado mas é importante ressaltar que somente irá para a ficha financeira da competência, após a reaalização deste procedimentto.

Exemplo de um grupo de eventos com destaque para as informações necessárias para este lançamento:

Figura 9 – Tela de Grupo de Eventos - Lançar eventos de integração com outros aplicativos.


Figura 10– Tela de Grupo de Eventos - TOTVS Consignado


Figura 11- Para envio do Evento de Margem como base de cálculo no moviemnto atual.


Para verificar o lançamento da verba de empréstimo na folha do funcionário, basta acessar o Envelope de Pagamento: Anexos > Movimento > Envelope de Pagamento.

Figura 12 Verba de Empréstimo importada pela integração para a folha do funcionário.


 

IMPORTANTE: Você poderá acompanhar o andamento das concessões e conciliações da folha, através do  Portal - Empréstimos



06. TABELAS UTILIZADAS

As seguintes tabelas do RM são utilizadas nesse projeto:

    • PPESSOA 
    • PFUNC 
    • PFPERFF 
    • PFFINANC 
    • PSECAO 
    • PFEMPRT 
    • PFHSTAFT
    • PPARAM 
    • PPARAMADICIONAIS
    • PFCONSIGNADODISTMARGEM
    • PCONSOPERADORAS
    • PFMOVTEMP
    • PGRPLANC
    • PTIPOLANCEVT
    • PCONSIGNADOEVENTOSOPERADORA


07. LINKS ÚTEIS