Saltar para o conteúdo
Logótipo Primavera

Faturação

Integração Primavera ERP

Encomendas, clientes, preços e stock trocados entre o Primavera ERP e a loja, o portal B2B ou o CRM, através da Web API.

Visão geral

Primavera

O Primavera ERP, hoje Cegid Primavera, é um dos ERP mais instalados em médias empresas portuguesas: vendas, compras, inventário, tesouraria, contabilidade e recursos humanos, normalmente num servidor da própria empresa ou num alojamento dedicado.

Na versão 10, a integração faz-se pela Web API, uma interface REST que corre em IIS, no servidor do cliente ou numa máquina dedicada com acesso ao ERP. A autenticação é por token, com validade curta (20 minutos por omissão), e cada sessão deve ser terminada no fim para libertar recursos; se não for, podem ficar sessões presas na base de dados do ERP. A Web API pode ainda ser estendida com endpoints próprios, desenvolvidos em .NET.

A Tejobit desenha a ligação à volta destes cuidados: um serviço intermédio que fala com a Web API por um canal seguro, agrupa pedidos, gere tokens e sessões e regista cada operação. O ERP continua a ser a fonte da verdade e o programa certificado que emite e comunica os documentos à AT.

Casos de uso

Para que serve

  • Portal B2B onde clientes profissionais consultam preços próprios e fazem encomendas que entram no Primavera.
  • Loja online que publica stock e preços do ERP e devolve as encomendas para faturação.
  • Equipa comercial em Salesforce que vê a conta corrente e as faturas de cada cliente sem acesso ao ERP.
  • Armazém com software de logística próprio que precisa de receber encomendas e devolver expedições.
IN

O que a ligação escuta

  • Encomenda criada na loja online ou no portal B2B.
  • Oportunidade ganha ou cliente novo no CRM.
  • Sincronização agendada de artigos, preços e stock a partir do ERP.
  • Confirmação de expedição vinda do sistema de armazém.
OUT

O que a ligação faz

  • Cria encomendas de cliente no módulo de vendas, na empresa e série corretas.
  • Cria ou atualiza entidades de cliente com os dados do CRM.
  • Lê artigos, tabelas de preços e stock por armazém para publicar fora do ERP.
  • Expõe dados de conta corrente e documentos ao portal ou ao CRM.
  • Chama endpoints à medida quando a Web API padrão não cobre uma operação.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Primavera ERP v10 com a Web API instalada e configurada em IIS.
  • Confirmação, com o parceiro Primavera da empresa, de que a licença cobre o uso pretendido da Web API.
  • Acesso de rede seguro ao servidor da Web API (VPN ou publicação protegida).
  • Utilizador do ERP para a integração, com permissões só nas empresas e módulos necessários.
  • Mapeamento de séries, armazéns e tabelas de preços para cada canal.

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A Web API corre em infraestrutura do cliente: a disponibilidade da ligação depende desse servidor e da rede.
  • Tokens com validade curta e sessões que têm de ser fechadas obrigam a um serviço intermédio bem feito; ligações diretas de lojas ou plugins simples costumam falhar aqui.
  • Atualizações de versão do ERP podem exigir novos testes, sobretudo quando existem endpoints à medida.
  • Personalizações do ERP (campos de utilizador, extensões) têm de ser conhecidas no arranque para entrarem no mapeamento.

Perguntas frequentes

Antes de começar

É possível integrar um Primavera alojado no escritório com uma loja na cloud?

Sim. O serviço intermédio fala com a Web API por um canal seguro e a loja nunca acede diretamente ao servidor do ERP.

Porque é que esta integração custa mais do que a de um programa de faturação online?

Porque envolve infraestrutura do cliente, mais objetos (encomendas, preços, stock, entidades) e cuidados de sessão e de segurança que exigem mais trabalho de manutenção.

A Tejobit substitui o parceiro Primavera da empresa?

Não. O parceiro continua responsável pelo ERP, pelas licenças e pelas personalizações. A Tejobit trata da ligação entre o ERP e os outros sistemas.

Ativar a integração Primavera?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.