Como importar encomendas via CSV

Atualizado em 14 Outubro 2026

Resumo gerado por AI · Na Shopkit, os planos Pro e Enterprise permitem importar encomendas em massa através de ficheiros CSV, úteis para migrações ou inserções em lote. Os ficheiros Excel devem ser guardados como CSV UTF-8. Durante a importação, as colunas são mapeadas independentemente da ordem, podendo ignorar-se campos sem correspondência. São obrigatórios o método de pagamento, método de envio, e-mail do cliente, nomes e dados principais das moradas de entrega e faturação, códigos de país ISO, produtos e quantidades. Vários produtos, opções e quantidades devem ser separados por ponto e vírgula, mantendo a ordem; recomenda-se identificar produtos por ID ou handle. Também podem indicar-se cupões, pontos, estado, observações, notas, pagamento, tags e canal de venda. A Shopkit reconhece CSV de Shopify, WooCommerce, PrestaShop, Jumpseller e Weasy, convertendo formatos, agrupando produtos e normalizando dados. As encomendas surgem com origem Importação. A opção Notificar clientes envia comunicações configuradas, devendo ficar desativada ao importar encomendas históricas.

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. As encomendas importadas ficam com a origem Importação na listagem, para as distinguires das vendas da loja. O ficheiro tem de estar em formato CSV. Se tens os dados no Excel, guarda-os primeiro como CSV (Ficheiro › Guardar como › CSV UTF-8).

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.

sales_channel

Canal de venda da encomenda, opcional, até 64 caracteres. Nos canais das apps (google_shopping, facebook_store, instagram_store, whatsapp_bot) a coluna Origem mostra o canal pelo nome. Com qualquer outro nome, como Amazon Marketplace, a coluna mostra Outros canais e o nome aparece na dica. A encomenda regista na mesma que foi importada.

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.