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.

PrimaveraShopifyERPIntegraçãoMapeamento 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.

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.

Queres aplicar isto no teu site?

Próximo passo Auditoria técnica