---
title: "Shopify e Primavera: o mapeamento completo | Vokzar"
description: "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."
url: "https://vokzar.com/blog/shopify-primavera-integracao/"
folder: "/blog/"
lang: "pt-PT"
dateModified: "2026-11-07"
timestamp: 1794009600
---

[← Voltar ao blog](https://vokzar.com/blog/) 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.

Primavera Shopify ERP Integração Mapeamento de dados

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.

- ### Integração com ERP e armazém

Shopify ligado ao Primavera, PHC ou Sage com mapeamento completo.
- ### Cupões de desconto e IVA

O caso mais difícil do mapeamento, explicado com números.
- ### Sincronização de stock

Um único stock entre o ERP, a loja física e a loja online.

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.

- Shopify

### Shopify Admin API: objeto Order
- Shopify

### Shopify: boas práticas de webhooks
- Portal das Finanças

### Código do IVA, artigo 36.º

Perguntas frequentes

## Dúvidas comuns sobre este tema.

[Ligar o meu Shopify ao Primavera](https://vokzar.com/automacoes-integracoes/integracao-erp-armazem/#pedir) [Ler em inglês](https://vokzar.com/en/blog/shopify-primavera-erp-integration/)

## Queres aplicar isto no teu site?

Próximo passo Auditoria técnica

[Ligar o meu Shopify ao Primavera](https://vokzar.com/automacoes-integracoes/integracao-erp-armazem/#pedir)

## Perguntas frequentes

**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.
