Cómo funcionan las claves de metadatos
Cada artículo de un pedido puede incluir una o más entradas de metadatos: un key y un value. Su plataforma los envía a Zonos cuando se crea un pedido. De forma predeterminada, Zonos almacena estos metadatos pero no los muestra en el desglose del pedido.
Cuando agrega una clave en la página de preferencias, Zonos busca esa clave en cada artículo del pedido y muestra el valor coincidente como una fila adicional debajo del artículo.
- Varios valores para la misma clave se unen con una coma; por ejemplo,
red, large. - Los artículos que no tienen la clave simplemente no muestran la fila, de modo que los detalles del pedido permanecen limpios.
- Las claves se configuran a nivel de organización. Todos los usuarios de su organización ven las mismas filas de metadatos.
Cuándo usar esto
Casos de uso comunes:
- Grabado o personalización — muestre una clave
engraving-textpara que el almacén sepa que el pedido requiere trabajo personalizado antes del envío. - Pedidos de regalo — muestre una clave
gift-messageogift-wrappara que los empaquetadores incluyan el insert correcto. - Suscripciones o fidelización — muestre una clave
subscription-idoloyalty-tierpara contexto de soporte y cumplimiento. - Campos personalizados de la plataforma — cualquier campo a nivel de artículo que su plataforma transmita y que su equipo necesite ver en el pedido.
Agregar una clave de metadatos
- Vaya a Dashboard -> Settings -> Orders -> Preferences.
- En el campo Metadata keys, escriba el nombre exacto de la clave que envía su plataforma (por ejemplo,
engraving-text). - Haga clic en Add.
La clave se aplicará de inmediato a todas las páginas de detalles del pedido. Abra cualquier desglose de pedido para confirmar que la nueva fila aparece debajo de cada artículo que incluya esos metadatos.

Los nombres de las claves distinguen entre mayúsculas y minúsculas y deben coincidir exactamente con lo que envía su plataforma. Si no está seguro de la clave exacta, revise los metadatos sin procesar de un pedido reciente o consulte a su desarrollador.
Eliminar una clave de metadatos
- Vaya a Dashboard -> Settings -> Orders -> Preferences.
- Busque la clave que desea eliminar en la lista.
- Haga clic en el icono de la papelera en el lado derecho de la fila.
La fila dejará de aparecer en el desglose del pedido para pedidos nuevos y existentes.
Solución de problemas
La fila no aparece en la página de detalles del pedido.
- Confirme que el nombre de la clave coincide exactamente, incluidas mayúsculas y minúsculas y cualquier guion o guion bajo (
engraving-textno es lo mismo queEngraving_Text). - Confirme que el artículo del pedido realmente tiene esos metadatos. Los pedidos antiguos creados antes de que su plataforma comenzara a enviar la clave no la tendrán.
La fila aparece pero está vacía.
- La plataforma envió la clave con un valor vacío. Revise la integración en el lado de la plataforma para asegurarse de que el valor se esté completando.
Una clave se muestra en algunos artículos pero no en otros.
- Esto es normal: los metadatos son por artículo, no por pedido. Solo los artículos para los que la plataforma envió la clave mostrarán la fila.
Preferencias de pedidos
Muestre metadatos de la plataforma en cada artículo del pedido.
Cuando su plataforma de comercio electrónico envía información adicional con cada pedido —como una nota de grabado, un mensaje de regalo o un ID de suscripción— Zonos la recibe como metadatos. La página de preferencias de pedidos le permite elegir qué claves de metadatos deben mostrarse en cada artículo del pedido en el desglose del pedido, para que su equipo de cumplimiento pueda ver lo necesario de un vistazo sin abrir la plataforma original.