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.
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.
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
- 01
Pedido
O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.
- 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.
- 03
Configuração e testes
A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.
- 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.
Integrações relacionadas
Ver todas as integrações- Faturação
PHC
Clientes, encomendas e faturas sincronizados entre o PHC e a loja, o CRM ou um portal, pela via que a versão do PHC permite.
Desde 60 € /mês + IVA
Ver integração - Faturação
Jasmin
Encomendas, faturas e recebimentos entram no Jasmin a partir da loja, do Stripe ou de um portal, sem lançamentos manuais.
Desde 5 € /mês + IVA
Ver integração - CRM
Salesforce
Oportunidades do Salesforce sincronizadas com o ERP, os pagamentos e o Slack, para vendas e financeiro verem os mesmos números.
Desde 60 € /mês + IVA
Ver integração
Ativar a integração Primavera?
Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.