Accede a datos detallados en el panel de control de Shopify con JSON

JSON, abreviatura de JavaScript Object Notation, es un formato para almacenar y transportar datos que se usa con frecuencia cuando se envían datos desde servidores a páginas web. En la mayoría de las páginas de recursos del panel de control de Shopify, como las páginas de Orders, Products o Customers, puedes acceder a datos más detallados usando JSON.

Aunque no es necesario realizar tareas de desarrollo avanzadas con JSON, poder acceder al archivo JSON de un recurso específico en el panel de control de Shopify puede ayudarte a obtener información más detallada, o a diagnosticar e investigar problemas por tu cuenta. Por ejemplo, puedes review the JSON file for a product to find its variant ID, lo que puede ser necesario para ciertas tareas de migración de datos o personalizaciones del código del tema. Otro ejemplo: puedes refer to an order's JSON file to confirm the data variable que quieres usar al crear un flujo de trabajo automatizado en Shopify Flow.

JSON lo usan principalmente quienes desarrollan software, pero incluso con conocimientos limitados de programación puedes aprender a encontrar e interpretar información JSON común en el panel de control de Shopify.

En esta página

Reformatear un archivo JSON

Los datos JSON sin formato se muestran como una larga secuencia de variables y corchetes anidados, lo que resulta difícil de leer para una persona.

Para que el formato JSON sea más legible, considera cualquiera de estas opciones:

Instala una JSON viewer extension en el navegador.
Usa la función Pretty-print que la mayoría de los navegadores modernos incluye de forma predeterminada:

Captura de pantalla de un archivo JSON de producto con información de ejemplo. La configuración Pretty-print está activa y resaltada en la esquina superior izquierda de la página.

Acceder a archivos JSON en el panel de control de Shopify

El panel de control de Shopify es el centro para administrar todos los aspectos del negocio y está diseñado para mostrar por defecto solo la información más útil y relevante. La información adicional que se recopila cada vez que se realizan acciones en el panel se almacena en los archivos .json de distintas páginas de recursos. Estos detalles adicionales no se muestran de forma predeterminada porque esa cantidad de información sería abrumadora y poco útil, y dificultaría el uso del panel.

Para la mayoría de las tareas del negocio, puedes usar las herramientas existentes de Shopify para acceder e interpretar la información de la tienda. Sin embargo, a veces conviene revisar la información específica de recursos particulares, como productos o pedidos, cuando necesitas investigar por qué o cuándo ocurrió algo.

Ejemplo: acceder al archivo JSON de un pedido

En este ejemplo, accederás al archivo JSON de un pedido en el panel de control de Shopify.

Pasos:

En el panel de control de Shopify, ve a Orders.
Haz clic en cualquier pedido de la lista de Pedidos.
En la barra de direcciones del navegador, agrega .json al final de la dirección URL. Será similar a este ejemplo:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json

Presiona Enter para recargar la página con formato JSON.
Opcional: si no tienes instalada una extensión para visualizar JSON en el navegador, activa la configuración Pretty-print en el navegador para que el archivo JSON sea más fácil de leer. Más información sobre reformatting a JSON file.

Notarás que se muestra mucha información esperada del pedido, como "currency" y "line_items" asociados al pedido, pero también se incluyen otros datos detallados, como "client_details" de la sesión del navegador del cliente cuando realizó el pedido. Este tipo de información es útil para el seguimiento general de sesiones y los informes y estadísticas de plataformas de marketing, pero no es necesaria para procesar y preparar el pedido.

Mostrar campos específicos en un archivo JSON

Puedes forzar que los archivos JSON muestren solo campos específicos, lo que puede facilitar la interpretación de la información cuando ya conoces las propiedades que quieres incluir. Al final de la URL de cualquier archivo JSON en la barra de direcciones del navegador, agrega ?fields= y luego incluye los nombres de las propiedades que quieres mostrar, en cualquier orden, separados por comas.

Por ejemplo, para mostrar el ID del pedido, la información del cliente, el precio total y las etiquetas, agrega ?fields=id,customer,total_price,tags al final de la URL del archivo JSON, como en el siguiente ejemplo:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

Usar otros recursos JSON

Puedes usar los siguientes recursos JSON para mostrar información específica en el panel de control de Shopify:

Cantidad de productos: agrega /count.json al final de la Products list URL para mostrar el número total de productos. La URL completa debe ser:

https://admin.shopify.com/store/{example-shop-name}/products/count.json

Transacciones: agrega /transactions.json al final de la URL de la página de un pedido para mostrar solo la información de las transacciones del pedido. Más información sobre el Transactions resource.
Preparaciones de pedidos: agrega /fulfillments.json al final de la URL de la página de un pedido para mostrar solo la información de preparación del pedido. Más información sobre el Fulfillment resource.
Pedidos abandonados: agrega .json al final de la URL de un pedido abandonado para mostrar información detallada sobre el pedido abandonado. Más información sobre el Abandoned checkout resource.

Propiedades JSON comunes para la resolución de problemas

La siguiente tabla enumera las propiedades JSON a las que podrías recurrir para obtener ayuda con la resolución de problemas en distintos tipos de recursos. Por ejemplo, si quieres confirmar cuándo se publicó un producto en particular, puedes revisar el archivo JSON del producto para ver la propiedad published_at, que muestra la fecha y la hora en formato ISO 8601.

Esta tabla no incluye todos los recursos o propiedades JSON almacenados en el panel de control de Shopify, así que consulta la Shopify Developer Documentation para obtener definiciones de cualquier recurso o propiedad que no esté incluida aquí.

Enumera algunos ejemplos de recursos del panel de control y las propiedades comunes asociadas, e incluye definiciones sobre para qué pueden usarse al resolver problemas.
Recurso	Propiedad JSON	Definición
Product	`"product": { "created_at"`	La fecha y la hora en que se creó el producto por primera vez.
	`"product": { "published_at"`	La fecha y la hora en que el estado del producto se estableció como Activo.
	`"product": { "updated_at"`	La fecha y la hora más recientes en que se actualizó el producto. Puede incluir cambios en la descripción del producto, el título o la información de SEO, así como actualizaciones automáticas, como cambios en el inventario cuando se compra un producto.
Variant	`"product": { "variants": [ { "created_at"`	La fecha y la hora en que se creó la variante por primera vez. Puede ser diferente de la fecha y la hora en que se creó el producto.
	`"product": { "variants": [ { "updated_at"`	La fecha y la hora más recientes en que se actualizó la variante. Puede ser diferente de la fecha y la hora en que se actualizó por última vez el producto.
	`"product": { "variants": [ { "inventory_quantity"`	El valor actual en la base de datos y lo que está disponible para que los clientes compren. Puede ser un valor negativo si no se hace seguimiento del inventario de la variante o si está configurada para sobrevender.
	`"product": { "variants": [ { "old_inventory_quantity"`	El valor en la base de datos antes de la última fecha de `updated_at` de la variante.
Order	`"order": { "line_items": [ { "requires_shipping"`	Se muestra como `true` o `false`. Indica la configuración de envío del producto o la variante en el momento de realizar el pedido.
	`"order": { "line_items": [ { "taxable"`	Se muestra como `true` o `false`. Indica cómo se configuró el producto o la variante para cobrar impuestos en el momento de realizar el pedido.
	`"order": { "line_items": [ { "variant_inventory_management"`	Se muestra como `shopify`, `amazon_marketplace_web`, `null` o un valor externo, según el servicio de logística configurado para hacer seguimiento del inventario del producto. Un valor de `null` significa que no se hacía seguimiento del inventario del producto en el momento del pedido.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Muestra cuánto inventario sigue reservado por el sistema para completar el pedido. Esto no equivale al inventario actual de la variante.
	`"order": { "line_items": [ { "quantity"`	La cantidad de productos o variantes que se compraron.
	`"order": { "line_items": [ { "tax_lines"`	En Estados Unidos, muestra valores estatales, del condado y municipales. Si no se muestran líneas de impuestos, pero se cobraron impuestos en el pedido, entonces significa que los impuestos se cobraron sobre el costo de envío.
Customer	`"customer": { "created_at"`	La fecha y la hora en que se creó el cliente por primera vez.
Customer	`"customer": { "updated_at"`	La fecha y la hora más recientes en que se actualizó el perfil de cliente.

Metacampos en JSON

Los metacampos son una forma flexible de adjuntar información personalizada adicional a un recurso de Shopify, como productos o colecciones. Algunos ejemplos de datos almacenados con metacampos incluyen especificaciones del producto, tablas de tallas, documentos descargables, fechas de lanzamiento, imágenes o números de parte. Más información sobre using metafields.

Puedes agregar /metafields.json al final de la URL de la página de un recurso compatible para mostrar los metacampos asociados a ese recurso. Consulta la siguiente tabla para ver algunos ejemplos de recursos y formatos de URL que puedes usar para mostrar información de metacampos con JSON.

Enumera algunos recursos del panel de control con una URL de ejemplo del archivo JSON de metacampos.
Tipo de recurso de ejemplo	URL de ejemplo
Colección inteligente	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Cliente	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Pedido	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Página	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Producto	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Variante	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Imagen del producto	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Nota: Product image metafields solo se pueden agregar mediante la API. Reemplaza `{id}` y otros marcadores de posición en la URL con los valores reales de tus consultas a la API.
Tienda	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Para ver la lista completa de recursos que pueden tener metacampos y los tipos específicos de propiedades que se almacenan para cada tipo de recurso, consulta el Metafield JSON resource en la documentación para desarrolladores de Shopify.

Eventos en JSON

Algunos recursos de Shopify generan eventos cuando se completan ciertas acciones, como la creación de un artículo del blog, la preparación de un pedido o la incorporación de un producto.

Puedes agregar /events.json al final de la URL de la página de un recurso compatible para mostrar los eventos asociados a ese recurso. Consulta la siguiente tabla para ver algunos ejemplos de recursos y formatos de URL que puedes usar para mostrar información de eventos con JSON.

Enumera algunos recursos del panel de control con una URL de ejemplo del archivo JSON de eventos.
Tipo de recurso de ejemplo	URL de ejemplo
Pedido	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Este archivo enumera el `author` de los eventos e informa qué usuarios completaron ciertas acciones, como quién o qué publicó un producto.
Producto	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Este archivo enumera el `author` de los eventos e informa qué usuarios completaron ciertas acciones, como quién o qué marcó un pago como pagado.
Tienda	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Este formato de URL muestra los 250 eventos más recientes que ocurrieron en la tienda. Los eventos pueden incluir, entre otros, la creación o actualización de productos, la eliminación de páginas y las actualizaciones de variantes.

Para ver la lista completa de recursos que pueden crear eventos y los eventos específicos que se generan para cada tipo de recurso, consulta el Event JSON resource en la documentación para desarrolladores de Shopify.