Documentação API
Web API
Desenvolvimento
Trabalho Pedidos Ativos Peças e Inventário Oficinas e Funcionários Requisições
Transversal
Integrações
Plugin v10 Valuekeep Integrator
Geral
Valuekeep IntegraçõesPlugin v10
IntegraçõesPlugin v10
Plugin v10
Voltar | Lista de artigos

Como configurar a integração de consumos do ERP v10 para o Valuekeep?

Última alteração a 22/08/2024
O Valuekeep está totalmente integrado com o ERP v10 para que possa usufruir das funcionalidades dos dois produtos. Esta integração é bidirecional, ou seja, partilham dados e mantém a comunicação entre si. 
Para auxiliar na operação, estão disponíveis de base alguns exemplos de integração. 
De seguida, é explicada a configuração da integração dos documentos de consumo de material do ERP v10 para o Valuekeep. 

Pré-Requisitos da Instalação

  1. Possuir a licença do Valuekeep para o add on Valuekeep Integrador e ERP v10;
  2. Adicionar o modulo VK.Int à licença do ERP v10.

Configurações no ERP v10

Para configurar os dados a integrar do ERP v10 para o Valuekeep, é necessário criar as listas no ERP v10. Se pretender integrar os documentos criados no ERP v10 para o Valuekeep, deve criar uma lista com os documentos e respetivos campos que pretende que sejam integrados.
 
Neste cenário, na pasta do integrador VKPluginSAMPLESV10LISTSPRIMAVERA10_VALUEKEEP3 estão disponíveis duas queries para criar as duas listas necessárias. Antes de copiar as listas, deve criar os campos de utilizador (CDU) no ERP v10 e os atributos personalizados no Cegid Valuekeep.
Criar listas no ERP v10
V10_VK3_CONSUMPTIONS_1
  1. Esta lista permite obter todos os campos necessários para a criação de um consumo no Valuekeep e está disponível na pasta VKPluginSAMPLESV10LISTSPRIMAVERA10_VALUEKEEP3V10_VK3_CONSUMPTIONS_1.sql. 
  2. Todos os campos são mapeados no ficheiro Mapper representado na configuração por: MappingFile  = VKPluginMAPPERSPRIMAVERA10_VALUEKEEP3V10_VK3_CONSUMPTIONS_1.json
V10_VK3_CONSUMPTIONS_3
  1. Esta lista permite obter os campos do tipo Dinheiro para atualizar no Valuekeep e está disponível na pasta VKPluginSAMPLESV10LISTSPRIMAVERA10_VALUEKEEP3V10_VK3_CONSUMPTIONS_3.sql
  2. Todos os campos são mapeados no ficheiro Mapper representado na configuração por: MappingFile = VKPluginMAPPERSPRIMAVERA10_VALUEKEEP3V10_VK3_CONSUMPTIONS_3.json
Criar Campos de Utilizador
Nas tabelas cabecInternos e linhasInternos (tabelas onde está registada a informação dos documentos a integrar) deve criar os seguintes campos de utilizador:
CabecInternos
  1. CDU_SourceHash: configurado com o tipo Varchar (100) e visível a false;
  2. CDU_TargetHash: configurado com o tipo Varchar (100) e visível a false;
  3. CDU_IsSync: configurado com o tipo Bit (valor por defeito a false) e visível a false;
  4. CDU_Funcionario: configurado com o tipo Varchar (100) e visível a true para o preenchimento manual no ERP v10;
  5. CDU_OrdemTrabalho: configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10.
LinhasInternos
  • CDU_IdLinhaVK: configurado com o tipo Varchar (100) e visível a false;
  • CDU_Localizacao: configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10;
  • CDU_Equipamento:  configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10;
  • CDU_Ferramenta: configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10;
  • CDU_Rota: configurado com o tipo Varchar (100) e visível a true para preenchimento manual no ERP v10. É necessário indicar a Rota e o ativo da rota no documento interno;
  • CDU_SourceHash: configurado com o tipo Varchar (100) e visível a false;
  • CDU_TargetHash: configurado com o tipo Varchar (100) e visível a false;
  • CDU_IsSync: configurado com o tipo Bit (valor por defeito a false) e visível a false.

Configurações no Valuekeep

Após criar documentos de consumos, poderá alterá-los no ERP v10, dado que o integrador deteta a alteração da informação através dos campos descritos abaixo.
Para adicionar os campos, siga os seguintes passos:
  1. Garanta que os seguintes campos estão configurados na lista consumos da ordem de trabalho;
  2. Aceda a Trabalho | Explorar Custos | Consumos;
  3. Clique no botão Gerir Atributos Personalizados;
  4. Adicione os atributos relativos ao Consumo da Ordem de Trabalho:
    1. SourceHash: configurado com o tipo Texto e visível a false;
    2. TargetHash: configurado com o tipo Texto e visível a false;
    3. IsSync: configurado com o tipo Booleano e visível a false;
  5. Adicione os atributos relativo à linha do Consumo da Ordem de Trabalho:
    1. ERPIdCabec: corresponde ao ID do documento interno do ERP v10, que deve estar configurado com o tipo Texto e visível a false;
    2. ERPIdLinha: corresponde ao ID da linha do consumo do documento interno do ERP v10, que deve estar configurado com o tipo Texto e visível a false;
  6. Aceda a Oficinas e Funcionários | Funcionários | Mapear Funcionário;
  7. Crie um funcionário (por exemplo IMPORTER_0004) e no nome de utilizador (email do utilizador) insira o seguinte texto: application-user::valuekeep-importer.
  8. Clique em Guardar e Novo.
O funcionário definido no passo 7 será responsável pela integração. Assim, sempre for criado o documento interno no ERP v10, é necessário indicar esse funcionário no campos de utilizador do cabeçalho. Alternativamente, o nome do funcionário pode estar fixo no ficheiro de configuração V10_VK3_CONSUMPTIONS_1.json, como por exemplo: { "Field": "employee", "Handlers": { "Mapping": [  {  "Field": "Default" } ], "DefaultValue": "IMPORTER_0004", "IgnoreOnUpdate": true } } .

Configurações no Valuekeep Integrador

Após efetuar as configurações necessárias no ERP v10 e no Valuekeep, deve efetuar as seguintes configurações no integrador:
Passo 1: Configurar Pipelines
  1. Aceda à pasta onde está instalado o integrador e, de seguida, à pasta VKPlugin\SAMPLES\CONFIGS;
  2. Abra o ficheiro VK3_V10_Integration.config;
  3. Copie as pipelines V10_VK3_CONSUMPTIONS_1, V10_VK3_CONSUMPTIONS_2 e V10_VK3_CONSUMPTIONS_3 para o ficheiro Integration.config pela seguinte ordem:
    1. V10_VK3_CONSUMPTIONS_1: contém a informação do cabeçalho;
    2. VK3_V10_CONSUMPTIONS_2: contém a informação dos detalhes;
    3. V10_VK3_CONSUMPTIONS_3: contém a informação para atualização dos preços.
As três pipelines neste exemplo devem ser executadas na sequência apresentado:
<Handler Id="h1"  Order="1" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_1"/>
       <Handler Id="h2"  Order="2" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_2"/>
       <Handler Id="h3"  Order="3" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_3"/>
 
E, de seguida, as restantes pipelines referentes aos documentos internos.
Se existirem mais pipelines referentes aos documentos internos, devem ser todas executadas no mesmo Handler por sequência, por exemplo: 
<Pipeline Id="VK3_V10_REPORTS" Scheduler="Default" Active="false" >
      <Handlers>
        <Handler Id="h1"  Order="1" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=VK3_V10_LABORS"/>
        <Handler Id="h2"  Order="2" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_SYNC_MO_INFO"/>
        
        <Handler Id="h3"  Order="3" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=VK3_V10_MISC_COSTS"/>
        <Handler Id="h4"  Order="4" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_SYNC_OC_INFO"/>
        
        <Handler Id="h5"  Order="5" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_1"/>
        <Handler Id="h6"  Order="6" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_2"/>
        <Handler Id="h7"  Order="7" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_3"/>        
        
        <Handler Id="h8"  Order="8" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=VK3_V10_REQUISITIONS"/>
      </Handlers>
    </Pipeline>
 
Passo 2: Configurar Mappers
Deve copiar os ficheiros sample distribuídos nas seguintes pastas:
  1.  VKPlugin\SAMPLES\MAPPERS\PRIMAVERA10_VALUEKEEP3 
    1. Copie os ficheiros V10_VK3_CONSUMPTIONS_1.json e V10_VK3_CONSUMPTIONS_3.json;
    2. Cole os ficheiros na pasta VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP;
    3. Altere o tipo de documento para o utilizado no ERP.
  2. VKPlugin\SAMPLES\MAPPERS\VALUEKEEP3_PRIMAVERA10
    1. Copie o ficheiro V10_VK3_CONSUMPTIONS_2.json;
    2. Cole o ficheiro na pasta VKPlugin\SAMPLES\MAPPERS\VALUEKEEP3_PRIMAVERA10.
Passo 3: Configurar Hashsets
Deve copiar os ficheiros sample distribuídos nas seguintes pastas:
  1.  VKPlugin\SAMPLES\HASHSETS\PRIMAVERA10_VALUEKEEP3 
    1. Copie os ficheiros V10_VK3_CONSUMPTIONS_1.json e V10_VK3_CONSUMPTIONS_3.json;
    2. Cole os ficheiros na pasta VKPlugin\HASHSETS\PRIMAVERA10_VALUEKEEP
  2. VKPlugin\SAMPLES\HASHSETS\VALUEKEEP3_PRIMAVERA10
    1. Copie o ficheiro V10_VK3_CONSUMPTIONS_2.json;
    2. Cole o ficheiro na pasta VKPlugin\SAMPLES\HASHSETS\VALUEKEEP3_PRIMAVERA10.
Os campos apresentados podem derivar do tipo de necessidades a sincronizar.
<Handler Id="h1"  Order="1" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_1"/>
Sincroniza o documento interno para o Valuekeep.
<Handler Id="h2"  Order="2" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_2"/>
Atualiza o campo Mapper para o ERP v10(CDU_IdLinhaVK)
<Handler Id="h3"  Order="3" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_3"/>
Atualiza os custos referentes ao documento anteriormente sincronizado.
Adicionar aos favoritos ou partilhar este artigo
Esta página foi útil?
Obrigado pelo seu voto.
Artigos Relacionados
Como efetuar download do plugin ERP V10? Overview do plugin V10 (Pipelines) Readers do plugin v10 (Pipelines) Mappers do plugin V10 (Pipelines) Writers do plugin V10 (Pipelines)