Order preferences

주문의 각 품목은 하나 이상의 metadata 항목(key와 value)을 가질 수 있습니다. 플랫폼은 주문 생성 시 이를 Zonos로 보냅니다. 기본적으로 Zonos는 metadata를 저장하지만 주문 breakdown에 표시하지 않습니다.

preferences 페이지에 key를 추가하면 Zonos는 각 주문 품목에서 해당 key를 찾아 일치하는 value를 품목 아래 추가 행으로 표시합니다.

• 동일 key의 여러 value는 쉼표로 연결됩니다 — 예: red, large.
• key가 없는 품목은 행을 표시하지 않으므로 주문 세부 정보가 깔끔합니다.
• key는 org 전체에 구성됩니다. 조직의 모든 사용자가 동일한 metadata 행을 봅니다.

일반적인 사용 사례:

• Engraving 또는 personalization — engraving-text key를 표시하여 warehouse가 배송 전 custom 작업이 필요함을 알 수 있습니다.
• Gift 주문 — gift-message 또는 gift-wrap key를 표시하여 packer가 올바른 insert를 포함할 수 있습니다.
• Subscription 또는 loyalty — support 및 fulfillment 맥락을 위해 subscription-id 또는 loyalty-tier key를 표시합니다.
• 사용자 지정 플랫폼 필드 — 팀이 주문에서 봐야 하는 플랫폼이 전달하는 모든 품목 수준 필드

1. Dashboard -> Settings -> Orders -> Preferences로 이동합니다.
2. Metadata keys 필드에 플랫폼이 보내는 정확한 key 이름을 입력합니다(예: engraving-text).
3. Add를 클릭합니다.

key는 즉시 모든 주문 세부 정보 페이지에 적용됩니다. 주문 breakdown을 열어 해당 metadata를 가진 각 품목 아래에 새 행이 나타나는지 확인하세요.

Key 이름은 대소문자를 구분하며 플랫폼이 보내는 것과 정확히 일치해야 합니다. 정확한 key를 모르면 최근 주문의 raw metadata를 확인하거나 developer에게 문의하세요.

1. Dashboard -> Settings -> Orders -> Preferences로 이동합니다.
2. 목록에서 제거할 key를 찾습니다.
3. 행 오른쪽의 휴지통 아이콘을 클릭합니다.

행은 새 주문과 기존 주문의 주문 breakdown에 더 이상 표시되지 않습니다.

행이 주문 세부 정보 페이지에 표시되지 않습니다.

• key 이름이 대소문자, dash, underscore를 포함하여 정확히 일치하는지 확인하세요(engraving-text는 Engraving_Text와 다릅니다).
• 주문 품목에 실제로 해당 metadata가 있는지 확인하세요. 플랫폼이 key 전송을 시작하기 전에 생성된 이전 주문에는 없습니다.

행은 표시되지만 비어 있습니다.

• 플랫폼이 빈 value로 key를 보냈습니다. 플랫폼 측 통합에서 value가 채워지는지 확인하세요.

일부 품목에만 key가 표시됩니다.

• 예상된 동작입니다 — metadata는 주문별이 아니라 품목별입니다. 플랫폼이 key를 보낸 품목에만 행이 표시됩니다.