Como criar um projeto de integração com Visual Studio?

Este documento descreve os passos necessários para se criar uma aplicação que integra com o ERP PRIMAVERA.

Pré-Requisitos

• PRIMAVERA ERP 10.
• Framework .NET 4.7.

Passo 1 - Referências base

1. Para aceder aos serviços sobre as entidades publicados pelos vários módulos, adicionar referência à assembly ErpBSxxx.DLL.

2. Para aceder aos serviços publicados pela plataforma, adicionar referências à assembly StdBSxxx.DLL.

3. Para aceder enumerados, coleções, etc. adicionar referência à assembly StdBExxx.DLL.

Passso 2 - Referências módulos

1. Para aceder às entidades e serviços base do sistema (clientes, artigos, unidade etc.), adicionar referência à assembly BasBExxx.DLL.

2. Para aceder, por exemplo às entidades e serviços publicados pelo módulo de vendas, deve adicionar referências às assemblies VndBExxx.DLL e IVndBSxxx.DLL

Passo 3 - Abertura da empresa

1. A abertura da empresa é o primeiro passo a realizar antes da utilização API. É, através deste método, realizada a autenticação do utilizador e a validação de permissões de acesso à empresa (base de dados), garantindo assim o acesso aos serviços publicados pelos módulos.

Passo 4 - Abertura da plataforma

1. Este passo apenas é necessário se existir necessidade de aceder a serviços tecnológicos, tais como utilização do serviço de listas, reporting, segurança, diálogos, etc.

2. De seguida é apresentado um fluxo completo de inicialização da API do ERP:

public static PriEngine CreatContext(string Company, string User, string Password)
{
  StdBSConfApl objAplConf = new StdBSConfApl();
  StdPlatBS Plataforma = new StdPlatBS();
  ErpBS MotorLE = new ErpBS();

  EnumTipoPlataforma objTipoPlataforma;
  objTipoPlataforma = EnumTipoPlataforma.tpEmpresarial;

  objAplConf.Instancia = "Default";
  objAplConf.AbvtApl = "ERP";
  objAplConf.PwdUtilizador = Password;
  objAplConf.Utilizador = User;
  objAplConf.LicVersaoMinima = "10.00";

  StdBETransaccao objStdTransac = new StdBETransaccao();

  try
  {
    Plataforma.AbrePlataformaEmpresa(Company, objStdTransac, objAplConf, objTipoPlataforma);
  }
  catch (Exception ex)
  {
    throw (ex);
  }

  if (Plataforma.Inicializada)
  {
    MotorLE.AbreEmpresaTrabalho(objTipoPlataforma, Company, User, Password, objStdTransac, "Default");

    Platform = Plataforma;
    Engine = MotorLE;

    EngineStatus = true;
  }

  return engineInstance;
}

Veja os exemplos de código disponíveis no GitHub que auxiliarão as suas integrações.