EyePeak RecursosGuias
RecursosGuias
Guias
Voltar | Lista de artigos

Como integrar dados no Eye Peak via WebServices?

Última alteração a 13/02/2023

Este documento descreve os passos necessários para criar o seu primeiro artigo no Eye Peak via WebServices.

A arquitetura do Eye Peak permite que sejam integrados os dados de sistemas externos, como por exemplo de diferentes ERPs, sendo possível integrar vários tipos de dados: artigos, entidades, documentos, armazéns, unidades e famílias.

A integração de sistemas externos é realizada através de WebServices, conforme explicado no artigo “Como criar um projeto de integração com o Eye Peak via WebServices?”.

Pré-Requisitos

  • PRIMAVERA Eye Peak;
  • Visual Studio 2013 ou superior.

Passo 1 – Garantir que existe proprietário no sistema

Todos os dados mestre do sistema ficam associados a um proprietário no sistema. Depois de definir um código de empresa na consola do serviço, é necessário garantir que existe um proprietário que irá ficar associado aos dados mestre integrados por WebService.

Para criar o proprietário é necessário invocar a classe CompanyRequest, preencher as propriedades obrigatórias e indicar o método SaveCompany:

        public void CriarProprietario()
        {

            // Web Service da entidade a ser alterada 
            Sample.WMSDataImport.WMSDataImportWS.CompanyRequest wsEntity = new CompanyRequest();

            //Campos obrigatórios
            wsEntity.ERPCompany = "DEMOWMS510";
            wsEntity.Name = "Empresa DEMO";

            //Gravação
            object result;
            result = m_WSClient.SaveCompany(wsEntity);
        }

Nota: O campo ERPCompany é obrigatório na criação de todas as entidades, sendo através deste que o sistema obtém a base de dados do Eye Peak a integrar. Este campo também é utilizado para relacionar as entidades com o seu proprietário.

Passo 2 – Criar a entidade pretendida

  1. Utilizar como base o projeto disponibilizado no artigo “Como criar um projeto de integração com o Eye Peak via Webservices?”;
  2. Criar uma nova classe para tratar os dados pretendidos, por exemplo “SKU.cs” que irá servir de aglomerador dos métodos de tratamento dos Artigos;
  3. Criar uma nova instância da classe Request pretendida disponível no namespace WMSDataImportWS;
  4. Preencher as propriedades obrigatórias da classe;
  5. Chamar os métodos correspondentes para gravar/editar ou remover as entidades.

O seguinte exemplo explica a criação de artigos:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Sync.WMS.WMSDataImportWS;

namespace Sync.WMS
{
    public class SKU
    {
        private WMSDataImportClient m_WSClient;
        public SKU()
        {
            m_WSClient = Utils.WS_CLIENT();
        }

        public void Add()
        {

            // Web Service of the Entity to be used
            Sync.WMS.WMSDataImportWS.SKURequest wsEntity = new SKURequest();

            //Required Fields
            wsEntity.ERPCompany = "DEMOWMS510";
            wsEntity.Name = "SKU Teste";
            wsEntity.SKU = "A0001";
            wsEntity.Unit = "UN";
            wsEntity.PurchaseUnit = "UN";
            wsEntity.ExpedUnit = "UN";
            //Saving
            object result;
            result = m_WSClient.SaveSKU(wsEntity);
        }

        public void Change()
        {

            // Web Service of the Entity to be used
            Sync.WMS.WMSDataImportWS.SKURequest wsEntity = new SKURequest();

            //Required Fields
            wsEntity.ERPCompany = "DEMOWMS510";
            wsEntity.Name = "Nova Descrição";
            wsEntity.OldSKU = "0000001";
            wsEntity.SKU = "0000001";
            wsEntity.Unit = "UN";
            wsEntity.PurchaseUnit = "UN";
            wsEntity.ExpedUnit = "UN";

            //Saving
            object result;
            result = m_WSClient.SaveSKU(wsEntity);
        }

        public void Remove()
        {
            // Web Service of the Entity to be used
            Sync.WMS.WMSDataImportWS.SKURequest wsEntity = new SKURequest();

            //Required Fields
            wsEntity.ERPCompany = "DEMOWMS510";
            wsEntity.SKU = "0000001";

            //Saving
            object result;
            result = m_WSClient.DeleteSKU(wsEntity);
        }

    }
}

As entidades passíveis de serem criadas e interagidas por WebService podem ser consultadas na documentação da API dos webservices do Eye Peak.

Também poderá consultar o exemplo Sync.WMS sobre WebServices do EyePeak no GitHub.

Adicionar aos favoritos ou partilhar este artigo
Esta página foi útil?
Obrigado pelo seu voto.

login para deixar a sua opinião.

Obrigado pelo seu feedback. Iremos analisá-lo para continuarmos a melhorar!
Artigos Relacionados
Como criar um projeto de integração com o Eye Peak via WebServices? Como criar artigos no Eye Peak via WebService? Como criar entidades no Eye Peak via WebService? Como criar armazéns no Eye Peak via WebServices com Visual Studio? Como criar tipos de documentos no Eye Peak via WebServices?