Pular para o conteúdo

Pesquise os guias de Multistore Inventory Sync.

    Transferir MarkdownGuardar uma cópia deste guia

    Sincronizar metacampos

    Resumo de IA

    Saiba como sincronizar metacampos de produto e de variante de uma loja de origem para uma loja de destino no Tipo Sync. Ativa a partilha de metacampos na loja de origem e a sincronização de metacampos na loja de destino e depois escolhe os metacampos a sincronizar usando namespace.key. Os tipos de dados têm de ser exatamente iguais nas duas lojas.

    Ver maisVer menos
    • Os tipos de referência e os MetaObjects não são suportados; os tipos de dados dos metacampos têm de ser iguais em ambas as lojas.
    • Na loja de origem, abra Settings, ative Share Metafields, escolha o recurso Product ou Variant e adicione definições como namespace.key.
    • Na loja de destino, abra Stores, abra o detalhe da ligação, ative Metafields sync e selecione os recursos.
    • Clique em Save; as definições em falta são criadas automaticamente na loja de destino.
    • Um valor vazio na origem nunca substitui um valor existente no destino.

    Resumo gerado por IA. Pode conter erros, por isso consulte o guia completo abaixo.

    Este guia explica como sincronizar metacampos da sua loja de origem para a sua loja de destino na aplicação Tipo.

    • Metacampos de produto
    • Metacampos de variante (se os ativar)

    A aplicação Tipo pode sincronizar metacampos para:

    • material, tabela de tamanhos, especificações
    • distintivos personalizados (por exemplo, “best_seller”)
    • detalhes adicionais do produto utilizados por temas/aplicações

    Os metacampos são campos personalizados do Shopify utilizados para armazenar dados adicionais do produto, tais como:


    • Texto de várias linhas
    • Texto formatado
    • Número inteiro
    • Decimal
    • Data e hora
    • Data
    • Dimensão
    • Volume
    • Peso
    • Verdadeiro ou falso
    • Classificação
    • URL
    • Dinheiro
    • Hiperligação
    • JSON

    🚫 Ainda não suportado:
    Os tipos de referência (por exemplo, referência de produto, referência de coleção) não são suportados de momento.


    🛠️ Passo 1: configurar os metacampos na loja de origem

    Seção intitulada “🛠️ Passo 1: configurar os metacampos na loja de origem”
    1. Abra a aplicação > clique em Definições (Settings) > ative Partilhar metacampos (Share Metafields)
    2. Escolha o recurso que pretende partilhar:
      • Recurso de produto (Product resource) – partilha os metacampos de produto.
      • Recurso de variante (Variant resource) – partilha os metacampos de variante.
    3. Adicione definições de metacampo específicas para limitar os metacampos que são partilhados.
      • Clique no ícone Procurar metacampos (Browse metafields), ou

      • Introduza a definição do metacampo no formato:

        namespace.key

        Por exemplo:

        custom.materialseo.titlespecifications.weight
    4. Click Save to update the changes

    🛠️ Passo 2: configurar os metacampos na loja de destino

    Seção intitulada “🛠️ Passo 2: configurar os metacampos na loja de destino”
    1. Abra a aplicação > clique em Lojas (Stores) > clique no URL da loja de origem para abrir os detalhes da ligação
    1. Ative a Sincronização de metacampos (Metafields sync)

    2. Escolha o que sincronizar

      Em Permitir dados (Allow data), selecione uma ou ambas as opções:

      • Recurso de produto (Product Resource) → sincroniza os metacampos de produto
      • Recurso de variante (Variant Resource) → sincroniza os metacampos de variante
    3. Clique no ícone de pesquisa à direita para ver todos os metacampos suportados > clique no botão Selecionar metacampo válido para sincronizar (Select valid metafield to sync)

    1. Clique em Guardar para atualizar as alterações

    1) Se a loja de destino não tiver a definição do metacampo

    Seção intitulada “1) Se a loja de destino não tiver a definição do metacampo”

    A aplicação cria automaticamente a definição do metacampo na loja de destino (quando necessário).

    Depois de criada, os valores dos metacampos sincronizados aparecem no produto/variante na loja de destino.

    2) Se os metacampos existirem mas não estiverem “estruturados” (metacampos não estruturados)

    Seção intitulada “2) Se os metacampos existirem mas não estiverem “estruturados” (metacampos não estruturados)”

    Em alguns casos, os metacampos podem ser sincronizados mesmo que não tenham sido totalmente definidos/estruturados na loja de destino.

    Para os consultar no Shopify Admin:

    • abra as Definições da loja → Metacampos e metaobjetos
    • Escolha Produto (ou Variante)
    • Abra Ver metacampos não estruturados

    💡 Sugestão: pode definir/estruturar manualmente estes metacampos mais tarde para manter os dados da sua loja limpos e consistentes.

    3) Se a loja de origem não tiver valor, o destino não é substituído

    Seção intitulada “3) Se a loja de origem não tiver valor, o destino não é substituído”

    Se um metacampo existir no destino mas o valor na origem estiver vazio, o Tipo Sync não substitui o valor do destino.

    4) Os tipos de dados têm de corresponder (muito importante)

    Seção intitulada “4) Os tipos de dados têm de corresponder (muito importante)”

    Os tipos de dados dos metacampos têm de corresponder exatamente entre a origem e o destino.

    Exemplos de incompatibilidade de tipos de dados:

    • single_line_text_field vs multi_line_text_field
    • number_integer vs number_decimal
    • product_reference vs text

    ⚠️ Se os tipos de dados não corresponderem, a sincronização pode falhar ou ignorar esse metacampo.


    📌 Exemplo: sincronizar um metacampo de produto – “Material”

    Seção intitulada “📌 Exemplo: sincronizar um metacampo de produto – “Material””

    Pretende sincronizar um metacampo de produto personalizado chamado Material (por exemplo, “Cotton”, “Leather”, “Wool”) da sua loja de origem para a sua loja de destino através da nossa aplicação.

    Na sua loja de origem:

    1. Aceda ao Shopify Admin > abra as Definições da loja > Metacampos e metaobjetos > escolha Produto (ou Variante)
    2. Clique em Adicionar definição (se ainda não estiver criada) > preencha a definição do metacampo:
      • Nome: Material
      • Namespace: custom
      • Chave: material
      • Tipo: texto de linha única

    => Isto dá-lhe a chave completa do metacampo: custom.material

    Repita este passo na sua loja de destino (a chave e o tipo têm de ser iguais).

    Passo 2: adicionar dados de metacampo aos produtos

    Seção intitulada “Passo 2: adicionar dados de metacampo aos produtos”

    Na sua loja de origem, aceda a um produto e desloque-se para baixo até Metacampos > Em Material, introduza: Cotton

    Este produto passa a ter o metacampo custom.material = "Cotton".

    Passo 3: configurar a sincronização na aplicação Tipo

    Seção intitulada “Passo 3: configurar a sincronização na aplicação Tipo ”
    • Abra a nossa aplicação na loja de destino > aceda a Configuração da ligação > Sincronização de metacampos
    • Escolha Metacampos específicos > introduza exatamente a chave do metacampo: custom.material

    Resultado

    • A nossa aplicação encontra custom.material na loja de origem
    • Se não existir no produto de destino, a aplicação cria-o
      => Resultado: custom.material = "Cotton" nas duas lojas
    • Se existir no destino mas a origem estiver vazia, não substituímos o valor

    Para sincronizar um metacampo específico, tem de introduzir a chave de definição do metacampo neste formato: namespace.key (por exemplo: custom.color).

    Veja como a encontrar no seu Shopify Admin:

    1. Aceda ao seu Shopify Admin > navegue até Definições > Dados personalizados > Produtos
    2. Clique no metacampo que pretende sincronizar
      → Vai ver os valores de Namespace e Chave
    3. Combine-os neste formato: namespace.key
      → Exemplo: custom.description

    P2: porque é que os meus metacampos não estão a ser sincronizados?

    Seção intitulada “P2: porque é que os meus metacampos não estão a ser sincronizados?”

    Se os seus metacampos não estão a ser sincronizados corretamente, pode dever-se a uma das seguintes razões:

    1. A sincronização de metacampos não está ativada
      Certifique-se de que a sincronização de metacampos está ativada nas duas lojas:
      • Ative Partilhar metacampos na loja de origem.
      • Ative Receber metacampos (Receive Metafields) na loja de destino.
    1. A chave de definição do metacampo não foi adicionada

    Além de ativar a sincronização de metacampos, tem também de adicionar a chave de definição do metacampo (namespace.key) que pretende sincronizar.

    • Aceda a Definições → Partilhar metacampos
    • Certifique-se de que a opção Ativar (Enable) está selecionada
    • Em Permitir dados, adicione a definição do metacampo neste formato:
      namespace.key
      Exemplo: custom.material
    1. Tipos de metacampo não suportados
      Alguns tipos de dados de metacampo não são suportados, como os tipos de referência ou os metaobjetos.

    Vermelho: metacampos não suportados que não podem ser sincronizados pela aplicação

    1. Tipos de metacampo incompatíveis entre lojas
      O metacampo na origem e no destino tem de ter o mesmo tipo de dados e a mesma estrutura.
      As incompatibilidades mais comuns incluem:
    • Um metacampo é de texto de linha única, enquanto o outro é de texto de várias linhas.
    • Um metacampo utiliza valor único, enquanto o outro utiliza lista de valores.

    Para resolver estes problemas, confirme que os metacampos nas duas lojas têm o mesmo namespace, a mesma chave e o mesmo tipo de dados, e tente sincronizar novamente.


    🙋 Ainda precisa de ajuda?

    Se ainda precisar de ajuda, não hesite em contactar-nos através de hi@tipo.io. Teremos todo o gosto em ajudá-lo(a).