Pular para o conteúdo
DataEase
Experimente gratuitamente

Produtos

Produtos são o que você vende. Cada produto pode ter muitas variantes (tamanho, cor, tamanho do pacote) e muitos dados extras, como preços, inventário, mídia, SEO e metafields.
Com o DataEase, você pode exportar em massa, atualizar no Excel / Google Sheets e depois importar para o Shopify em minutos.

(Manuais oficiais do Shopify → Produtos • Variantes)

Índice

Section titled “Índice”
  1. Exportar
  2. Importar
  3. Lista de campos
  4. Lista de filtros

1. Exportar

Section titled “1. Exportar ”
  1. Clique em Nova Exportação no DataEase.
  2. Escolha CSV (seguro para descrições longas) ou Excel.
  3. Escolha Produtos.
  4. Use filtros (por tag, fornecedor, status, etc.) se necessário.
  5. Selecione as colunas que deseja (ou Todos os campos).
  6. Execute a tarefa e baixe o arquivo.

Precisa de imagens? Veja o guia completo → export-data

Velocidade da exportação. Para respeitar o limite de custo de consulta do Shopify, o DataEase lê produtos em páginas de 33. Com a coluna variantImage a página é de 20 produtos, e com as colunas collections / smartCollections é de 12 produtos. Exportações grandes com colunas de coleção demoram mais; o conteúdo do arquivo é o mesmo. Veja Limites do Shopify.

2. Importar

Section titled “2. Importar ”

  1. Abra o arquivo de exportação ou duplique a planilha de demonstração.

  2. Edite as linhas ou adicione novas. Use a coluna command:

    ComandoO que faz
    CREATECria uma nova linha de produto / variante / mídia
    UPDATEAltera apenas as células preenchidas
    MERGEAdiciona ou substitui linhas dentro do produto
    DELETERemove o produto (ou linha de variante / mídia)
    IGNOREIgnora esta linha

  3. Regras principais

    • Produtos correspondem por id, ou handle se não houver id.
    • Variantes correspondem por variantId; se em branco, o DataEase procura por sku, depois barcode, depois combinação de opções.
    • Linhas de mídia precisam de URL de media e mediaCommand.
    • Campos de SEO não podem estar vazios.
    • Colunas de inventário começam com location: (use +10 / -5 para ajustar).
    • Se uma tentativa anterior da mesma atualização de inventário nesta importação falhou, o Shopify se recusa a repeti-la (IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED). As linhas de variante afetadas recebem um aviso de que a definição/ajuste de quantidade não foi aplicado — verifique os dados da linha e execute a importação novamente.
    • Limite: o Shopify permite criar 1 000 novos produtos / variantes por dia após a loja ultrapassar 50 000.

  4. Salve o arquivo.

  5. No DataEase, escolha Nova Importação, carregue o arquivo, mapeie as colunas e execute.

Guia completo de importação: import-data

3. Lista de Campos

Section titled “3. Lista de Campos ”

Abaixo está cada coluna que o DataEase pode mostrar para Produtos, Variantes e Mídia.
Campos marcados como “Campo de importação” podem ser enviados de volta para o Shopify. Se não estiverem marcados, são apenas para exportação.

Legenda
• Campo de importação – pode ser enviado de volta para o Shopify.
• Sem bandeira – apenas exportação (somente leitura).

3.1 Colunas auxiliares gerais

Section titled “3.1 Colunas auxiliares gerais”
  • row — Número da linha da exportação original. Apenas exportação
  • topRow — TRUE para a linha de cabeçalho do produto, FALSE para linhas de variante ou mídia. Apenas exportação
  • lineType — Tipo de linha: Product, ProductMedia, Variant. Apenas exportação

3.2 Campos de produto

Section titled “3.2 Campos de produto”
  • id — ID do produto. Chave primária para atualizações. Campo de importação
  • command — Ação para esta linha de produto. Campo de importação
  • title — Nome do produto mostrado aos clientes. Campo de importação
  • handle — Handle de URL (único, máx. 256 caracteres). Campo de importação
  • descriptionHtml — Descrição em rich-text (HTML). Campo de importação
  • Description — Descrição em texto simples. Apenas exportação
  • vendor — Marca / fornecedor. Padrão para o nome da loja se em branco. Campo de importação
  • status — ACTIVE, DRAFT ou ARCHIVED. Campo de importação
  • productType — Texto de tipo de produto personalizado. Campo de importação
  • tags — Tags separadas por vírgula (substitui as existentes). Campo de importação
  • tagsCommand — Auxiliar de tag (ADD, REMOVE, REPLACE). Campo de importação
  • productCategory — Nome completo da taxonomia. Campo de importação
  • ProductCategoryId — ID da taxonomia. Campo de importação
  • productMetafields — Colunas dinâmicas de metafield (veja /metafields). Campo de importação
  • collections — Coleções manuais contendo este produto (o produto foi selecionado manualmente na coleção). Campo de importação
  • smartCollections — Coleções que incluem este produto através de condições, subcoleções, fontes de variante ou de aplicativo. Apenas exportação
  • seoTitle — Tag de título SEO. Campo de importação
  • seoDescription — Meta descrição SEO. Campo de importação
  • CreatedAt — Hora de criação do produto. Apenas exportação
  • UpdatedAt — Hora da última modificação. Apenas exportação
  • PublishedAt — Hora da primeira publicação. Apenas exportação
  • TotalInventory — Estoque total de todas as variantes. Apenas exportação
  • OnlineStoreUrl — URL da loja ao vivo para o produto. Apenas exportação
  • media — URL de mídia (uma por linha de mídia, ou separadas por ; se agrupadas). Campo de importação
  • mediaCommand — Ação da linha de mídia. Campo de importação
  • mediaAlt — Texto alternativo para a mídia. Campo de importação
  • mediaPosition — Ordem de classificação da mídia (1-n). Campo de importação
  • mediaStatus — READY, PROCESSING, FAILED, UPLOADED. Apenas exportação
  • Options — Colunas dinâmicas de opção (Nome / Valor da Opção 1, etc.). Campo de importação
  • isGiftCard — true para transformar o produto em um cartão-presente. Campo de importação
  • giftCardTemplateSuffix — Sufixo do arquivo de modelo de cartão-presente. Campo de importação
  • templateSuffix — Modelo Liquid alternativo para a página do produto. Campo de importação
  • MaxVariantPrice — Maior preço de variante. Apenas exportação
  • MaxVariantPriceCurrency — Moeda do maior preço. Apenas exportação
  • MinVariantPrice — Menor preço de variante. Apenas exportação
  • MinVariantPriceCurrency — Moeda do menor preço. Apenas exportação
  • FeaturedMedia — ID da mídia em destaque. Campo de importação
  • variantGenerateFromOptions — true para criar automaticamente variantes a partir de conjuntos de opções. Campo de importação (somente importação)
  • publicationScope — [IsPublished] & [PublishedAt] por canal de vendas / mercado. Campo de importação

3.3 Campos de variante

Section titled “3.3 Campos de variante”
  • variantId — ID da variante (chave para atualizações). Campo de importação
  • itemCommand — Ação para esta variante. Campo de importação
  • sku — Unidade de manutenção de estoque. Campo de importação
  • barcode — Valor do UPC / EAN / código de barras. Campo de importação
  • variantUpdatedAt — Hora da última atualização da variante. Apenas exportação
  • variantCreatedAt — Hora de criação da variante. Apenas exportação
  • displayName — Título do produto + título da variante. Apenas exportação
  • inventoryQuantity — Estoque total disponível. Campo de importação
  • sellableOnlineQuantity — Estoque disponível para loja online. Campo de importação
  • availableForSale — true se disponível para compra. Campo de importação
  • variantImage — URL da imagem em destaque para a variante. Campo de importação
  • position — Ordem da variante (1-n). Campo de importação
  • price — Preço de venda (moeda da loja). Campo de importação
  • compareAtPrice — Preço de comparação. Campo de importação
  • taxable — Cobrar imposto? (true/false). Campo de importação
  • taxCode — Código de imposto (baseado nos EUA, Avalara AvaTax). O Shopify não suporta mais códigos de imposto Avalara: a coluna ainda é aceita, mas o valor é ignorado na importação e a linha recebe o aviso “Tax code ignored”. O código de imposto da variante não é alterado. Campo de importação
  • inventoryPolicy — CONTINUE ou DENY quando fora de estoque. Campo de importação
  • variantMetafields — Metafields dinâmicos de variante. Campo de importação
  • weight — Valor numérico do peso. Campo de importação
  • weightUnit — GRAMS, KILOGRAMS, OUNCES, POUNDS. Campo de importação
  • requiresShipping — true se for necessário envio físico. Campo de importação
  • requiresComponents — true se a variante for apenas um pacote pai. Campo de importação
  • cost — Custo unitário (requer permissão). Campo de importação
  • countryCodeOfOrigin — Código ISO-2 do país de origem. Campo de importação
  • harmonizedSystemCode — Código HS (tarifa) (6-13 dígitos). Campo de importação
  • provinceCodeOfOrigin — Código ISO-2 da província (se necessário). Campo de importação
  • tracked — Rastrear inventário? (true/false). Campo de importação
  • quantities — Colunas dinâmicas location: Nome da Localização – definir ou ajustar estoque. Campo de importação
  • fixedPrices — Colunas dinâmicas price / Market, compare at price / Market. Campo de importação

3.4 Enum de status de mídia (apenas exportação)

Section titled “3.4 Enum de status de mídia (apenas exportação)”
  • mediaStatus — READY, PROCESSING, FAILED, ou UPLOADED.

3.5 Enum de status de produto (importação)

Section titled “3.5 Enum de status de produto (importação)”
  • status — ACTIVE, DRAFT, ou ARCHIVED decidem a visibilidade do produto.

4. Lista de Filtros

Section titled “4. Lista de Filtros ”

Todos os filtros que você pode usar antes de exportar Produtos:

  • Barcode — Filtrar por código de barras da variante.
  • Bundles — Mostrar apenas produtos em pacotes (true / false).
  • CategoryId — ID da categoria de taxonomia do Shopify.
  • CollectionId — Produtos que pertencem a uma coleção específica.
  • CombinedListingRoles — Filtrar por função de listagem combinada.
  • CreatedAt — Intervalo de datas de criação.
  • DeliveryProfileId — Produtos vinculados a um perfil de entrega.
  • ErrorFeedback — Produtos com mensagens de erro do Shopify.
  • GiftCard — Apenas produtos de cartão-presente.
  • Handle — Handle contém / é igual ao texto.
  • HasOnlyComposites — Produtos cujas variantes são todos pacotes.
  • HasOnlyDefaultVariant — Produtos com uma única variante padrão.
  • HasVariantWithComponents — Produtos que incluem pelo menos um pacote de variante.
  • Id — Lista exata de IDs de produto.
  • InventoryTotal — Nível de estoque maior / menor que um número.
  • IsPriceReduced — Produtos com pelo menos uma variante onde price < compareAtPrice.
  • OutOfStockSomewhere — Produtos que estão fora de estoque em qualquer localização.
  • Price — Intervalo de preço da variante.
  • ProductConfigurationOwner — ID do aplicativo ou canal proprietário.
  • ProductPublicationStatus — PUBLISHED, UNPUBLISHED, etc.
  • ProductType — Filtro de tipo de produto personalizado.
  • PublicationIds — Produtos publicados em canais específicos.
  • PublishableStatus — Pronto / não pronto para publicação.
  • PublishedAt — Intervalo de datas da primeira publicação.
  • PublishedStatus — PUBLISHED ou UNPUBLISHED.
  • Sku — SKU da variante corresponde.
  • Status — Status do produto (ACTIVE, DRAFT, ARCHIVED).
  • Tag — Contém tag.
  • Title — Título contém / é igual ao texto.
  • UpdatedAt — Intervalo de datas da última atualização.
  • VariantId — Pesquisa por ID da variante.
  • VariantTitle — Título da variante contém texto.
  • Vendor — Fornecedor é igual ao texto.

Precisa de mais ajuda? Nossa equipe de suporte responde em até 24 horas.

Campos adicionais

Section titled “Campos adicionais”

Mais colunas que o DataEase suporta para esta entidade:

  • productOptions — Opções disponíveis para o produto, como tamanho ou cor. Campo de importação