Como importar encomendas via CSV ou Excel

Atualizado em 15 Julho 2026

Resumo gerado por AI · A Shopkit permite importar encomendas em massa através de ficheiros CSV ou Excel, funcionalidade disponível nos planos Pro e Enterprise, ideal para migração de encomendas de outras plataformas de e-commerce ou inserção em lote na gestão da loja. O ficheiro pode seguir o modelo de exemplo e inclui mapeamento flexível de colunas, permitindo ignorar campos não reconhecidos. Campos obrigatórios incluem payment_method, shipment_method, client_email, dados de envio e faturação, products e products_quantity; podem ainda ser importados NIF, empresa, opções de produto, cupões, pontos de recompensa, estado da encomenda, observações, notas, pagamento e tags. Para produtos múltiplos, os valores devem ser separados por ponto e vírgula. A importação suporta Shopify, WooCommerce, PrestaShop, Jumpseller e Weasy, convertendo formatos, agrupando produtos, mapeando pagamentos e estados e normalizando países. Também é possível notificar clientes, embora seja recomendado desativar notificações ao migrar encomendas antigas. Clientes existentes são associados pelo e-mail; caso contrário, é criado cliente não registado.

Na Shopkit podes importar encomendas em massa através de ficheiros CSV. Esta funcionalidade é útil para migrar encomendas de outras plataformas ou para inserir encomendas em lote na tua área de gestão.

Esta funcionalidade encontra-se disponível nos planos Enterprise e Pro.

Disponibilizamos-te um ficheiro csv de exemplo para analisares a estrutura necessária para a importação:

Download

Também podes importar produtos e clientes via CSV, ou criar encomendas via API.

Estrutura do ficheiro csv

Para importares encomendas, o ficheiro CSV deve conter as colunas correspondentes aos campos disponíveis na Shopkit. A ordem das colunas não é relevante, uma vez que o mapeamento é feito durante o processo de importação.

Faz download do nosso ficheiro de exemplo (CSV) disponível na janela de importação para veres a estrutura e o formato a usar.

Caso o teu ficheiro tenha colunas que não correspondam a campos da Shopkit, podes ignorá-las durante o mapeamento.
payment_method - Obrigatório

Método de pagamento da encomenda. Deves usar o alias do método de pagamento configurado na tua loja, como por exemplo multibanco, bank_transfer, credit_card, on_delivery, mbway, paypal, payshop ou custom.

shipment_method - Obrigatório

Método de envio da encomenda. Deves usar o título exato do método de envio configurado na tua loja (ex. Transportadora, Levantamento em loja).

client_email - Obrigatório

E-mail do cliente. Se o cliente já existir na loja, a encomenda é associada ao registo existente. Caso contrário, é criado um cliente não registado.

client_fiscal_id

Número de identificação fiscal do cliente (ex. PT999999990).

client_company

Nome da empresa do cliente.

client_delivery_name - Obrigatório

Nome completo da morada de envio.

client_delivery_phone

Telefone da morada de envio.

client_delivery_address - Obrigatório

Morada de envio.

client_delivery_address_extra

Complemento da morada de envio (andar, loja, etc.).

client_delivery_zip_code - Obrigatório

Código postal da morada de envio.

client_delivery_city - Obrigatório

Cidade da morada de envio.

client_delivery_country_code - Obrigatório

Código de país no formato ISO 3166-1 alfa-3 (ex. PRT, ESP, USA).

client_billing_name - Obrigatório

Nome completo da morada de faturação.

client_billing_phone

Telefone da morada de faturação.

client_billing_address - Obrigatório

Morada de faturação.

client_billing_address_extra

Complemento da morada de faturação (andar, loja, etc.).

client_billing_zip_code - Obrigatório

Código postal da morada de faturação.

client_billing_city - Obrigatório

Cidade da morada de faturação.

client_billing_country_code - Obrigatório

Código de país no formato ISO 3166-1 alfa-3 (ex. PRT, ESP, USA).

products - Obrigatório

Identificador do(s) produto(s) da encomenda. Se a encomenda tiver vários produtos, separar os valores com ponto e vírgula (;).
Recomendamos a utilização do id ou handle do produto para evitar ambiguidades.

products_options

Opções de produto, separadas por ponto e vírgula. Podes usar o ID, título, referência ou código de barras da opção, mantendo a mesma ordem da coluna products.

products_quantity - Obrigatório

Quantidade de cada produto. Se a encomenda tiver vários produtos, separa as quantidades com ponto e vírgula (;), mantendo a mesma ordem da coluna products.

coupon_code

Código de cupão de desconto a aplicar na encomenda.

rewards_total_redeemed

Pontos de recompensa a utilizar na encomenda. Apenas aplicável a clientes registados com pontos disponíveis.

status_alias

Estado da encomenda. Os estados disponíveis são:

  • pending — Pendente
  • processing — Em processamento
  • sent — Enviada
  • canceled — Cancelada
  • waiting_confirmation — A aguardar confirmação
  • waiting_payment — A aguardar pagamento
  • waiting_stock — A aguardar stock
  • delivered — Entregue
  • returned — Devolvida
  • pickup_available — Disponível para levantamento
  • waiting_shipment — A aguardar expedição
  • waiting_return — A aguardar devolução
observations

Observações da encomenda.

note

Nota interna da encomenda.

client_note

Nota visível para o cliente.

paid

Coloca true caso a encomenda esteja paga ou false caso ainda tenha o pagamento pendente.

tags

Tags da encomenda, separadas por vírgula ou ponto e vírgula.

Importar a partir de outras plataformas

Se estás a migrar encomendas de outra plataforma de e-commerce, podes selecionar a origem do ficheiro CSV durante a importação. A Shopkit converte automaticamente o formato do ficheiro, agrupando produtos por encomenda, mapeando métodos de pagamento e estados, e normalizando códigos de país.

As plataformas suportadas são: Shopify, WooCommerce, PrestaShop, Jumpseller e Weasy.

Se a tua plataforma de origem não estiver na lista, podes adaptar o teu ficheiro CSV ao formato Shopkit usando o ficheiro de exemplo como referência.

Opções de importação

Notificar clientes

Se ativares a opção Notificar clientes na janela de importação, os clientes vão receber as notificações associadas à criação de encomendas (e-mail, SMS, etc.), conforme configurado na tua loja.

Se estiveres a importar encomendas anteriores ou a migrar dados de outra plataforma, recomendamos que não atives esta opção para evitar o envio de notificações desnecessárias aos clientes.