Documentación API
Web API
Desarrollo
Trabajo Solicitudes Activos Piezas e Inventario Talleres y Trabajadores Requisiciones Transversal
Integraciones
General Plugin v10 Valuekeep Integrator
Valuekeep IntegracionesPlugin v10
IntegracionesPlugin v10
Plugin v10
Años | Lista de Artículos

¿Cómo configurar la integración de consumos desde ERP v10 a Valuekeep?

Última modificación el 26/12/2024

Valuekeep está totalmente integrado con ERP v10 para que pueda aprovechar las funcionalidades de ambos productos. Esta integración es bidireccional, es decir, comparten datos y mantienen comunicación entre sí.

Para ayudarle en la operación, tiene a su disposición algunos ejemplos básicos de integración.

A continuación, se explica la configuración de la integración de los documentos de consumo de material desde ERP v10 a Valuekeep.

Requisitos previos para la instalación

  1. Disponer de una licencia Valuekeep para el complemento Valuekeep Integrator y ERP v10;
  2. Añadir el módulo VK.Int a la licencia ERP v10.

Configuraciones en Cegid ERP v10

Para configurar los datos a integrar desde ERP v10 en Valuekeep, es necesario crear las listas en ERP v10. Si desea integrar los documentos creados en ERP v10 en Valuekeep, debe crear una lista de los documentos y sus campos correspondientes que desea integrar.

En este escenario, en la carpeta del integrador  VKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3 hay dos consultas disponibles para crear las dos listas necesarias. Antes de copiar las listas, debe crear los campos de usuario (CDU) en ERP v10 y los atributos personalizados en Cegid Valuekeep.

Crear listas en ERP v10 V10_VK3_CONSUMPTIONS_1

  1. Esta lista proporciona todos los campos necesarios para crear un consumo en Valuekeep y está disponible en la carpeta VKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_1.sql. 
  2. Todos los campos se mapean en el archivo Mapper representado en la configuración por: MappingFile  =  KPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_1.json

V10_VK3_CONSUMPTIONS_3

  1. Esta lista proporciona los campos del tipo Dinero para actualizar en Valuekeep y está disponible en la carpeta VKPlugin\SAMPLES\V10LISTS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_3.sql
  2. Todos los campos se mapean en el archivo Mapper representado en la configuración por: MappingFile = VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP3\V10_VK3_CONSUMPTIONS_3.json

Crear Campos de Usuario

En las tablas cabecInternos y linhasInternos (tablas donde está registrada la información de los documentos a integrar) debe crear los siguientes campos de usuario:

CabecInternos

  1. CDU_SourceHash: configurado con el tipo Varchar (100) y visible la false;
  2. CDU_TargetHash: configurado con el tipo Varchar (100) y visible la false;
  3. CDU_IsSync: configurado con el tipo Bit (valor por defecto la false) y visible la false;
  4. CDU_Funcionario: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10;
  5. CDU_OrdemTrabalho: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10.

LinhasInternos

  • CDU_IdLinhaVK: configurado con el tipo Varchar (100) y visible la false;
  • CDU_Localizacao: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10;
  • CDU_Equipamento:  configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10;
  • CDU_Ferramenta: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10;
  • CDU_Rota: configurado con el tipo Varchar (100) y visible la true para el relleno manual en ERP v10. Es necesario especificar la Ruta y el activo de la ruta en el documento interno;
  • CDU_SourceHash: configurado con el tipo Varchar (100) y visible la false;
  • CDU_TargetHash: configurado con el tipo Varchar (100) y visible la false;
  • CDU_IsSync: configurado con el tipo Bit (valor por defecto la false) y visible la flase.

Configuraciones en Valuekeep

Una vez creados los documentos de consumos, puede modificarlos en ERP v10, puesto que el integrador detecta la modificación de la información a través de los campos que se describen a continuación.

Para añadir los campos, siga estos pasos:

  1. Asegúrese de que los siguientes campos están configurados en la lista de consumos de la orden de trabajo;
  2. Acceda a Trabajo | Explorar Costes | Consumos;
  3. Haga clic en el botón Gestionar Atributos Personalizados;
  4. Añada los atributos relativos al Consumo de la Orden de Trabajo:
    1. SourceHash: configurado con el tipo Texto y visible la false;
    2. TargetHash: configurado con el tipo  Texto y visible la false;
    3. IsSync: configurado con el tipo Booleano y visible la false;
  5. Añada los atributos relativos a la línea del Consumo de la Orden de Trabajo:
    1. ERPIdCabec: corresponde al ID del documento interno de ERP v10, que debe estar configurado con el tipo Texto y visible la false;
    2. ERPIdLinha: corresponde al ID de la línea del consumo del documento interno de ERP v10, que debe estar configurado con el tipo Texto y visible la false;
  6. Acceda a Talleres y Trabajadores | Trabajadores | Mapear Trabajador;
  7. Cree un trabajador (por ejemplo, IMPORTER_0004) y en el nombre de usuario (correo electrónico del usuario) introduzca el siguiente texto: application-user::valuekeep-importer.
  8. Haga clic en Guardar y Nuevo.

El trabajador definido en el paso 7 se encargará de la integración. Así, cada vez que se cree el documento interno en ERP v10, es necesario especificar ese trabajador en los campos de usuario del encabezado. Como alternativa, el nombre del trabajador puede fijarse en el archivo de configuración V10_VK3_CONSUMPTIONS_1.json, por ejemplo: { "Field": "employee", "Handlers": { "Mapping": [  {  "Field": "Default" } ], "DefaultValue": "IMPORTER_0004", "IgnoreOnUpdate": true } } .

Configuraciones en Valuekeep Integrador

Una vez realizadas las configuraciones necesarias en ERP v10 y Valuekeep, debe realizar las siguientes configuraciones en el integrador:

Paso 1: Configurar Pipelines

  1. Acceda a la carpeta donde está instalado el integrador y, a continuación, a la carpeta VKPlugin\SAMPLES\CONFIGS;
  2. Abra el archivo VK3_V10_Integration.config;
  3. Copie las pipelines V10_VK3_CONSUMPTIONS_1, V10_VK3_CONSUMPTIONS_2 y V10_VK3_CONSUMPTIONS_3 en el archivo Integration.config en el siguiente orden:
    1. V10_VK3_CONSUMPTIONS_1: contiene la información del encabezado;
    2. VK3_V10_CONSUMPTIONS_2: contiene la información de los detalles;
    3. V10_VK3_CONSUMPTIONS_3: contiene la información información para actualizar los precios.

Las tres pipelines de este ejemplo deben ejecutarse en la secuencia mostrada:

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

...

Y a continuación, los demás pipelines de los documentos internos.

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

Si existen más pipelines relativas a documentos internos, deben ejecutarse todas en el mismo Handler por secuencia, por ejemplo:

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

Paso 2: Configurar Mappers

Debe copiar los archivos sample distribuidos en las siguientes carpetas:

  1.  VKPlugin\SAMPLES\MAPPERS\PRIMAVERA10_VALUEKEEP3 
    1. Copie los archivos V10_VK3_CONSUMPTIONS_1.json yV10_VK3_CONSUMPTIONS_3.json;
    2. Pegue los archivos en la  carpeta VKPlugin\MAPPERS\PRIMAVERA10_VALUEKEEP;
    3. Modifique el tipo de documento al utilizado en el ERP.
  2. VKPlugin\SAMPLES\MAPPERS\VALUEKEEP3_PRIMAVERA10
    1. Copie el archivo V10_VK3_CONSUMPTIONS_2.json;
    2. Pegue el archivo en la carpeta VKPlugin\SAMPLES\MAPPERS\VALUEKEEP3_PRIMAVERA10.

Paso 3: Configurar Hashsets

Debe copiar los archivos sample distribuidos en las siguientes carpetas:

  1.  VKPlugin\SAMPLES\HASHSETS\PRIMAVERA10_VALUEKEEP3 
    1. Copie los archivos V10_VK3_CONSUMPTIONS_1.json y V10_VK3_CONSUMPTIONS_3.json;
    2. Pegue los archivos en la  carpeta VKPlugin\HASHSETS\PRIMAVERA10_VALUEKEEP
  2. VKPlugin\SAMPLES\HASHSETS\VALUEKEEP3_PRIMAVERA10
    1. Copie el archivo V10_VK3_CONSUMPTIONS_2.json;
    2. Pegue el archivo en la carpeta VKPlugin\SAMPLES\HASHSETS\VALUEKEEP3_PRIMAVERA10.

Los campos que se muestran pueden derivar del tipo de necesidades que se vayan a sincronizar.

      <Handler Id="h1"  Order="1" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_1"/>

Sincroniza el documento interno con Valuekeep.

<Handler Id="h2"  Order="2" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_2"/>

Actualiza el campo Mapper con ERP v10(CDU_IdLinhaVK)

<Handler Id="h3"  Order="3" Type="Valuekeep.Integrator.Handlers.PipelineHandler"   ConfigStr="PipelineId=V10_VK3_CONSUMPTIONS_3"/>

Actualiza los costes relativos al documento previamente sincronizado.

Bookmark or share this article
Esta página foi útil?
Obrigado pelo seu voto.
Artículos Relacionados
¿Cómo descargar el plugin de ERP Primavera V10? Visión general del plugin V10 (Pipelines) Readers del plugin v10 (Pipelines) Mappers del plugin V10 (Pipelines) Writers del plugin V10 (Pipelines)