ERP e integrações · 10 min · 2026-11-07
Shopify e Primavera: como mapear encomendas, clientes, IVA e portes sem erros
Não há app para ligar o Shopify ao Primavera. As decisões antes de ligar: quem manda em cada dado, que documento criar, clientes, IVA, portes e descontos.
Resumo
O essencial antes de avançar.
- Não encontrámos nenhuma app para o Primavera na Shopify App Store. As integrações existentes são feitas à medida, por parceiros ou por equipas internas.
- A primeira decisão não é técnica: para cada dado, produto, preço, stock, cliente e encomenda, qual dos dois sistemas manda.
- A segunda decisão é fiscal: a encomenda entra no Primavera como encomenda de cliente ou como fatura? Se o Primavera fatura, mais nenhuma app pode faturar a mesma venda.
- Clientes sem NIF, preços com IVA incluído, portes e cupões são os quatro pontos onde as integrações costumam partir. Os cupões foram, na nossa experiência, o mais difícil.
- Uma integração fiável tem de saber falhar: cada encomenda que não entra fica numa lista com o motivo, em vez de desaparecer.
Não há botão para ligar
Ao contrário de outros ERP internacionais, o Primavera não tem uma app na Shopify App Store que se instale em minutos. Quem quer ligar os dois sistemas recorre a parceiros com conectores próprios ou a desenvolvimento à medida sobre as APIs do Shopify e do Primavera.
Isto não é necessariamente mau. Cada empresa usa o Primavera de forma diferente: séries, armazéns, tipos de documento, artigos de serviço, centros de custo. Um conector genérico teria de ser configurado da mesma forma. O que muda é que as decisões de mapeamento têm de ser tomadas por alguém que conheça os dois lados.
O que se segue é a lista dessas decisões, tal como as tomámos numa integração Shopify e Primavera para uma empresa de grande dimensão.
Decisão 1: quem manda em cada dado
Produtos e preços. Na maioria das empresas com Primavera, o artigo nasce no ERP, com referência, taxa de IVA e preço. O Shopify recebe-os e acrescenta o que é de loja: fotografias, descrições, coleções. A referência do Primavera deve ser o SKU no Shopify, porque é a chave que liga tudo.
Stock. Se há loja física, armazém ou outros canais, o stock real está no Primavera e o Shopify mostra uma cópia. A frequência de atualização define o risco de vender o que não existe.
Encomendas e clientes. Nascem no Shopify e seguem para o Primavera. Aqui a pergunta é se o cliente é criado no ERP para cada compra ou se as vendas a particulares vão para um cliente genérico.
Escrever esta tabela antes de começar evita a pior situação: dois sistemas a alterar o mesmo dado e cada um a desfazer o trabalho do outro.
Decisão 2: que documento cria a encomenda
A encomenda pode entrar no Primavera como encomenda de cliente, que depois é faturada no ERP, ou diretamente como fatura. A escolha depende de quem trata a expedição e de quando a fatura deve ser emitida.
Esta decisão tem uma consequência que muitas lojas descobrem tarde: se o Primavera emite a fatura, nenhuma app de faturação no Shopify pode emitir outra para a mesma venda. Duas fontes de faturas é a causa mais comum de duplicados.
Lembre-se também do prazo legal. Quando o cliente paga no checkout, antes da entrega, a fatura deve ser emitida na data do recebimento, nos termos do artigo 36.º do CIVA. A integração tem de respeitar isso, mesmo que a expedição aconteça dias depois.
Decisão 3: clientes e NIF
O Shopify não tem campo de NIF. O mais comum é o NIF vir da Morada 2, de um campo no carrinho ou, no Shopify Plus, de um campo no checkout. A integração tem de limpar e validar esse valor antes de criar ou procurar o cliente no Primavera.
Para clientes sem NIF, a decisão é entre criar um cliente por pessoa ou usar consumidor final. Para clientes com NIF, a chave de procura deve ser o NIF e não o email, porque a mesma empresa compra muitas vezes com emails diferentes.
Defina também o que acontece quando a morada de faturação e a de envio são diferentes, e qual delas vai para o documento.
Decisão 4: valores, IVA, portes e descontos
O Shopify vende com IVA incluído e arredonda o IVA por linha. O Primavera precisa de saber se recebe preços com ou sem IVA. A regra que funciona é fixar o total pago de cada linha e calcular a base a partir dele, para que o documento no Primavera some exatamente o que o cliente pagou.
Os portes são uma linha própria, normalmente um artigo de serviço no Primavera, e seguem a taxa de IVA dos bens enviados.
Os cupões foram o ponto mais difícil. Enviar o desconto como uma única linha negativa deixa o IVA errado em encomendas com taxas mistas. O desconto tem de ser lido do Shopify linha a linha, já repartido, e passado com cada artigo.
Decisão 5: o que fazer quando falha
Uma encomenda com um SKU que não existe no Primavera, um NIF inválido ou uma taxa de IVA não mapeada vai falhar. A pergunta é o que acontece a seguir.
A resposta certa é uma lista de exceções, visível para quem gere a loja, com o número da encomenda, o motivo e a forma de corrigir. Depois de corrigido o dado, a encomenda volta a entrar sem duplicar.
Complemente com uma reconciliação diária: encomendas pagas no Shopify contra documentos no Primavera. É o que garante que nada se perde quando um aviso do Shopify não chega, o que a documentação do Shopify admite poder acontecer.
Como a Vokzar faz a integração com o Primavera
Começamos por um workshop curto com a sua equipa e o contabilista para fechar as cinco decisões acima e escrever o mapa de campos.
Construímos a integração sobre as APIs do Shopify e do Primavera, com SKU como chave, valores calculados por linha, descontos repartidos, NIF validado, lista de exceções e reconciliação diária.
Entregamos com um conjunto de encomendas de teste que inclui os casos difíceis, para que qualquer alteração futura seja validada antes de chegar à faturação.
Próximos passos
Próximos passos.
Prova e validação
- A ausência de app Primavera na Shopify App Store foi verificada em novembro de 2026. Existem parceiros que oferecem conectores próprios.
- A experiência descrita resulta de um mapeamento Shopify e Primavera feito numa empresa de grande dimensão.
- As regras de faturação resumem o artigo 36.º e o artigo 16.º do CIVA e devem ser confirmadas com o seu contabilista.
Documentação oficial
Fontes validadas.
A estratégia técnica deve ser auditável. Estas fontes ligam diretamente à documentação oficial que suporta as recomendações deste guia.
Perguntas frequentes
Dúvidas comuns sobre este tema.
Existe uma app para ligar o Shopify ao Primavera?
Não encontrámos nenhuma na Shopify App Store. A ligação faz-se com conectores de parceiros ou com integração à medida sobre as APIs dos dois sistemas.
A encomenda deve entrar no Primavera como encomenda ou como fatura?
Depende de quem expede e de quando a fatura deve ser emitida. Se o Primavera emite a fatura, nenhuma app no Shopify pode faturar a mesma venda.
Que dado deve ligar os produtos entre os dois sistemas?
A referência do artigo no Primavera, usada como SKU no Shopify. É a chave que liga produtos, stock e linhas de encomenda.
O que acontece a uma encomenda que falha na integração?
Deve ficar numa lista de exceções com o motivo e voltar a entrar depois de corrigida, sem duplicar. Uma reconciliação diária garante que nenhuma encomenda paga fica de fora.

