Preferências de pedidos

Cada item de um pedido pode incluir uma ou mais entradas de metadados: um key e um value. Sua plataforma envia essas informações ao Zonos quando um pedido é criado. Por padrão, o Zonos armazena esses metadados, mas não os exibe no detalhamento do pedido.

Quando você adiciona uma chave na página de preferências, o Zonos procura essa chave em cada item do pedido e exibe o valor correspondente como uma linha adicional abaixo do item.

• Vários valores para a mesma chave são unidos por vírgula; por exemplo, red, large.
• Itens que não têm a chave simplesmente não mostram a linha, de modo que os detalhes do pedido permanecem limpos.
• As chaves são configuradas no nível da organização. Todos os usuários da sua organização veem as mesmas linhas de metadados.

Casos de uso comuns:

• Gravação ou personalização — exiba uma chave engraving-text para que o armazém saiba que o pedido exige trabalho personalizado antes do envio.
• Pedidos de presente — exiba uma chave gift-message ou gift-wrap para que os embaladores incluam o insert correto.
• Assinaturas ou fidelidade — exiba uma chave subscription-id ou loyalty-tier para contexto de suporte e fulfillment.
• Campos personalizados da plataforma — qualquer campo no nível do item que sua plataforma transmita e que sua equipe precise ver no pedido.

1. Vá para Dashboard -> Settings -> Orders -> Preferences.
2. No campo Metadata keys, digite o nome exato da chave que sua plataforma envia (por exemplo, engraving-text).
3. Clique em Add.

A chave será aplicada imediatamente a todas as páginas de detalhes do pedido. Abra qualquer detalhamento de pedido para confirmar que a nova linha aparece abaixo de cada item que inclui esses metadados.

Os nomes das chaves diferenciam maiúsculas de minúsculas e devem corresponder exatamente ao que sua plataforma envia. Se você não tiver certeza da chave exata, revise os metadados brutos de um pedido recente ou consulte seu desenvolvedor.

1. Vá para Dashboard -> Settings -> Orders -> Preferences.
2. Encontre a chave que deseja remover na lista.
3. Clique no ícone da lixeira no lado direito da linha.

A linha deixará de aparecer no detalhamento do pedido para pedidos novos e existentes.

A linha não aparece na página de detalhes do pedido.

• Confirme que o nome da chave corresponde exatamente, incluindo maiúsculas/minúsculas e qualquer hífen ou underscore (engraving-text não é o mesmo que Engraving_Text).
• Confirme que o item do pedido realmente tem esses metadados. Pedidos antigos criados antes de sua plataforma começar a enviar a chave não a terão.

A linha aparece, mas está vazia.

• A plataforma enviou a chave com um valor vazio. Revise a integração no lado da plataforma para garantir que o valor esteja sendo preenchido.

Uma chave é exibida em alguns itens, mas não em outros.

• Isso é normal: metadados são por item, não por pedido. Somente os itens para os quais a plataforma enviou a chave mostrarão a linha.