Contexto de negócio (Introdução)

Adapter responsável pela integração de Projetos do Totvs Obras e Projetos, estes projetos são cadastrados no TOP e enviados ao Back Office estes projetos são utilizados por exemplo para realização de rateio de projeto/tarefa em Movimentações no Back Office, rateio este que é utilizado para apropriação destas movimentações.

Identificador da Mensagem: PROJECT

Versão: 2.000

Módulo RM: Construção e Projetos

Tipo de Envio: <Síncrona>

Tipo de Adapter: Saída

CompanyId

BranchId

CompanyInternalId

CODCOLIGADA|CODFILIAL

ShortCode

IDPRJ

Code

CODPRJ

InternalId

CODCOLIGADA|IDPRJ

Description

DESCRICAO

CostCenterCode

CODCCUSTO

CostCenterInternalId

CODCOLIGADA|CODCCUSTO

RegisterDate

MPRJSTATUSLOG

BeginDate

MPERIODO

FinalDate

Notas:

1 - Exclusão de Projeto

Ao excluir um projeto, o mesmo será verificado se existem tarefas, caso exista, cada produto (RM e Protheus) ficará responsável por excluir os seus registros relacionados (Tarefas e Contratos) da base de dados e do De-Para. 

3 - Revisões

Ao realizar revisões simples o IDPRJ é mantido para evitar a necessidade de atualização de relacionamento pelo De/Para, mas na utilização de Revisões Multiplas o IDPRJ é alterado, com isto a integração realizara o envio de mensagem de InternalID para o Protheus para que o mesmo atualize o De/Para de projeto, também sera enviado mensagens de InternalID para alteração do De/Para das tarefas do Projeto.

Ao realizar uma revisão de venda o código de projeto recebe o sufixo “_V” e é dispara a mensagem de integração de um novo projeto com todas as tarefas, de forma que o Protheus terá dois projetos o principal e o de venda, sendo sempre atualizado o De/Para com o ultimo IDPRJ das revisões verticais. As revisões horizontais não serão sincronizadas e as apropriações são registradas na ultima revisão vertical do projeto.

Observações:

Revisão de Projetos: Esta não será necessário sincronizar com o Protheus, pois a revisão irá manter o Projeto atual (já sincronizado) e criar uma cópia do mesmo para histórico.

Revisão Múltipla de Projetos: São sincronizados a revisão principal do projeto de revisão múltipla e a revisão de venda.

Parâmetros:

Os parâmetros abaixo definem os status de projetos que devem ser sincronizados.

Parâmetro abaixo define se ao salvar a planilha de atividades, o projeto e o contrato se serão enviados os dados de forma síncrona ao Protheus. O valor default é true, caso o parâmetro seja cadastrado com false, o projeto passa a trabalhar de forma assíncrona, sendo necessário a execução do processo "Sincronismo de projeto Protheus" da visão de projeto ou o agendamento do mesmo.

Premissas de instalação:

Protheus:

1 - Grupo de Campos

É necessário alterar o grupo de campo 097-Projeto do Protheus para o tamanho 24 para que haja compatibilidade com o tamanho do campo código de Projeto do TOTVS Obras e Projetos.

2 - Configuração Protheus

O módulo PMS não estará disponível quando o Protheus estiver integrado com o TOTVS Obras e Projetos.

Para que seja possível cadastrar o projeto no Protheus é necessário que se tenha um calendário padrão cadastrado. O calendário padrão deve ser informado no parâmetro MV_INTCAL. Caso este parâmetro não exista ou esteja vazio, o adapter irá considerar a utilização do calendário 001. Caso o parâmetro contenha um calendário inválido o sistema retornará um erro.

Antes de sincronizar o contrato é preciso rodar o update U_UPDPMS.

Por padrão todos os projetos do Protheus são cadastrados com a fase 01 e esta não permite que o projeto seja utilizado no financeiro, em compras, faturamento e outros módulos. Como o módulo PMS ficará desabilitado com a integração não será permitido alterar a fase do projeto no Protheus.

Nota: Para conseguir cadastrar a fase do projeto os parâmetros MV_PMSITMU e MV_RMCOLIG devem conter o valor 0(zero).  Após retornar o conteúdo correto para o parâmetro MV_PMSITMU.

Deste modo será necessário cadastrar uma nova fase de projeto para a utilização com o Solum. Esta nova fase pode ser cadastrada em SIGAPMS (Gestão de Projetos | Cadastros | Fases do Projeto). Ele deve conter:

Após o cadastro da fase 06 será necessário alterar o parâmetro MV_PRJINIC para 06.

Caso já exista uma fase com o código 06 ela pode ser criada com outro código. Lembrando apenas de alterar o parâmetro MV_PRJINIC com o código criado.

Ao trocar o código do projeto no TOP será enviada uma mensagem Project para que o Protheus execute a troca do código internamente e, em função do campo ser chave no Protheus, será retornada uma mensagem de InternalID para o TOP com todos os de/para que forem atualizados no Protheus.

Como o módulo PMS fica desabilitado quando há integração com o TOTVS Obras e Projetos o projeto ficará disponível para visualização apenas nos processos onde há integração com projetos.

Exemplo: Rateio de projeto da nota fiscal de entrada, solicitação de armazém, solicitação de compra, pedido de compra, título a pagar, etc.

Gatilhos:

Projetos/Tarefas/Contratos serão sincronizados no momento da sua inclusão ou alteração. Em caso de projetos já existentes poderá ser sincronizado pelo processo Sincronizar Projeto Protheus que é disparado pelos processos da visão de projeto ou poderá ser pesquisado pela aba de execução, onde o mesmo também poderá ser agendado. Nos processos de restauração de backup de projeto, importação de tarefas Excel e importação de tarefas project sera disparado automaticamente o Sincronismo de Projeto Protheus.