¿Qué es un Meta Field?
Un Meta Field consiste en una Meta Key, que define la propiedad que estás especificando, y un Meta Value, que es el valor de esa propiedad.
Por ejemplo, la Meta Key "gs1_template" puede tener un Meta Value de "Default".
Por qué usamos Meta Values
Puedes usar Meta Values para guardar datos arbitrarios que RyderShip no necesita para enviar pedidos, pero que tú necesitas en el Packing Slip u otro recurso. También se pueden usar en los Filtros de búsqueda, que se pueden aplicar a Reglas, Acciones en lote o Reportes.
Acceso
Ahora permitimos Meta Keys arbitrarias, eliminando la necesidad de validarlas y crearlas previamente antes de usarlas.
Nota: Debes usar el importador Línea por SKU para cargar un pedido.
Tipos de valores de Meta Field
Al establecer valores de meta field, asegúrate de que el formato coincida con el tipo esperado. Formatos incorrectos pueden causar errores, mala interpretación de datos o validaciones fallidas.
| Tipo | Formato esperado | Valores aceptables | Información adicional |
| DateTime |
Fecha: Hora:
|
|
| Date |
Ejemplo: 2025/08/25 se interpretará como |
No se permite componente de hora |
| Boolean |
Acepta:
Los valores no distinguen entre mayúsculas y minúsculas |
|
| String |
|
Se convierte a un objeto String de Ruby |
| Integer |
|
Cadenas no numéricas generarán errores |
| Float |
|
Se analiza usando el método Float de Ruby |
Si un valor no coincide con el tipo esperado, la solicitud puede ser rechazada o el campo puede ser ignorado, dependiendo de cómo esté implementada tu integración.
Cómo usar Meta Values
En búsquedas
Los Filtros de búsqueda son muy potentes. Puedes encontrar pedidos que contengan Meta Fields (por ejemplo, "Agrupa todos los pedidos tipo: VIP") o usarlos en Reglas (por ejemplo, "si packaging-type: eco, usa sobres de papel").
Cuando uses un booleano (Verdadero/Falso) en los filtros de búsqueda de meta fields, usa el valor 1 para verdadero y 0 para falso. Para mejores resultados, combina los Meta Fields con otro filtro de búsqueda. Un ejemplo sería incluir un filtro como Estado o un rango de fechas.
Lo siguiente equivale a "is_gift: true":
Durante Recepción
Los Meta Fields de Shipnotice.item y Shipnotice se pueden buscar en la página de Detalles de Ship Notice. Estos se usan principalmente para localizar un artículo entrante por una Meta Key, como "vendor_sku" o "color_code". Así, las Meta Keys son una herramienta para que los equipos de recepción identifiquen artículos.
En plantillas
Consulta nuestra documentación sobre plantillas aquí.
Agregar Meta Values por carga de CSV
Los Meta Values se pueden agregar mediante la carga de pedidos por CSV o por la API.
Nota: Debes usar el importador Línea por SKU para cargar un pedido.
Formato del encabezado CSV:
object_meta_{tunombredemetakey}
Pedidos
order_meta
orderitem_meta
Ship Notices
shipnotice_meta
shipnoticeitem_meta
Devoluciones
consumerreturn_meta
shipnoticeitem_meta
Artículos
item_meta
Nota: Adjunto a este artículo encontrarás un ejemplo del formato estándar de importación de Ship Notice donde se incluyen meta keys.
¿Los Meta Fields aparecen en la interfaz?
¡No! Pero esto es intencional. Se pueden cometer errores cuando dependemos de que las personas tomen la decisión correcta siguiendo instrucciones escritas para miles de paquetes al día. Nosotros apostamos por la automatización.
Por ejemplo, podríamos usar el filtro Meta Field packaging_type: eco-friendly para aplicar una Regla.
O podríamos usar user_status: VIP para crear Batches.
Esto significa que el personal del almacén recibe instrucciones de la manera en que están acostumbrados—de forma contextual, a través de los flujos de empaque y agrupamiento—y no necesitan cambiar su proceso para enviar los pedidos como tú lo deseas.
Una excepción: Los Meta Fields a nivel de artículo sí son visibles en la página de Detalles del artículo, en la pestaña Detalles del artículo y desplazándote hacia abajo a la sección de Meta Fields. Esto es para dar al equipo de recepción la mayor información posible sobre los artículos y que tengan la mejor oportunidad de identificar correctamente cada cosa durante la recepción.
Ejemplo del formato estándar de importación de Ship Notice
- ship notice meta key example.csv191 bytes