Ajuda Infurnia

“Translated trade words” is not ready for these pages yet, so they are shown with “Common trade words in English”.

Catalogue

Entenda as dimensões, o número de modelo e as regras de propriedades adicionais do SKU

Saiba como um SKU armazena suas dimensões padrão, quais limites se aplicam ao número de modelo e como as propriedades adicionais são validadas.

  1. Cada SKU armazena suas dimensões padrão como três campos numéricos separados - altura, largura e profundidade - todos opcionais; esses são os padrões no nível do catálogo a partir dos quais a ferramenta de design começa quando o item é posicionado. O número de modelo (model_no) é limitado a 100 caracteres; atualizações acima desse limite são rejeitadas com SKU_MODEL_NUMBER_TOO_LONG, o que vale verificar quando uma edição em massa ou uma sincronização com o ERP falha em linhas específicas. As propriedades adicionais são pares chave/valor de formato livre armazenados por SKU (enviados como um array JSON de objetos {key, value}); a única regra do lado do servidor é que uma chave de propriedade não pode estar vazia - essas linhas falham com KEY_FOR_ADDITIONAL_PROPERTIES_CONNOT_BE_EMPTY (observe o 'CONNOT' com erro de grafia na string de erro real, então pesquise nos logs por esse texto exato). Não há validação de unicidade ou de tipo nas chaves ou valores das propriedades, portanto chaves duplicadas ou formatos de valor inconsistentes entre SKUs são possíveis e são uma questão de higiene de dados para o cliente, não um erro da plataforma. Name is mandatory; descrição e ordem de exibição são opcionais. Renomear um SKU ou alterar seu número de modelo também atualiza o índice de busca do catálogo em segundo plano, então a busca pode ficar um pouco atrasada em relação a uma renomeação.

  2. As novas dimensões passam a ser os padrões do SKU no nível do catálogo.

  3. As propriedades adicionais são propriedades de chave/valor de formato livre no SKU.

    ✓ Verificado no produto em 10 de outubro de 2026
  4. As propriedades adicionais podem ser editadas sem restrições de tipo ou de unicidade.

    ✓ Verificado no produto em 10 de outubro de 2026
  5. Uma simples alteração de tamanho não exige o editor de estrutura do SKU: altura, largura e profundidade são editadas como propriedades do próprio SKU, e o editor de estrutura é reservado para alterações na própria estrutura.