Cómo usar las fórmulas de Jaguar Sheet en una hója de cálculos

Cómo usar las fórmulas de Jaguar Sheet en una hója de cálculos

Fácil de usar fórmulas para mostrar datos de Mercado Libre en Google Sheets

Jaguar Sheet tiene mas de 20 fórmulas que permiten mostrar información actualizada de tu cuenta de Mercado Libre de forma directa en Google Sheets. Puedes armar un listado de tus publicaciones con estadísticas, ver y controlar tu stock de fulfillment, calcular la conversión de tus distintos productos y mucho más. Todas las funciones comienzan con JAGUAR_ como se muestra en la imagen.


Listado de funciones disponibles y sus parámetros


JAGUAR_ITEMLIST() - Listado de publicaciones.

image

Descripción:

Devuelve una lista de dos columnas con el identificador de la publicación y sus variaciones.

Sintaxis:

JAGUAR_ITEMLIST([seller_sku], [status], [logistic_type], [catalog_listing], [include_variations])

Parámetros:
seller_sku - OPCIONAL

SKU del vendedor.

status - OPCIONAL

Estado de la publicación, los valores válidos son:

  • pending (Inactivas por deuda con MercadoLibre or violación de las políticas)
  • not_yet_active (Creadas recientemente o pendientes de activación)
  • programmed (Programadas para activarse en el futuro)
  • active (Activas)
  • paused (Pausadas)
  • closed (Terminadas)

Por defecto se incluyen todas.

logistic_type - OPCIONAL

Tipo de logística, los valores válidos son:

  • cross_docking (Mercado Envíos Colecta)
  • fulfillment (Mercado Envíos Full)
  • not_specified (No especificado)

Por defecto se incluyen todos.

catalog_listing - OPCIONAL

Filtrar si la publicación es o no de catálogo, los valores válidos son:

  • all (Incluir todas)
  • true (Solo en catálogo)
  • false (Solo fuera de catálogo)

El valor por defecto es “all”.

include_variations - OPCIONAL

Incluir o no las variaciones, los valores válidos son:

  • true
  • false

El valor por defecto es true.

Ejemplos:

=JAGUAR_ITEMLIST()
Sin ningún atributo devuelve todas tus publicaciones en todos los estados.
=JAGUAR_ITEMLIST("SKU_123")
Devuelve las publicaciones donde el SKU comience con “SKU_123”.
=JAGUAR_ITEMLIST(, "active")
Devuelve solo las publicaciones activas.
=JAGUAR_ITEMLIST(, , "fulfillment")
Devuelve solo las publicaciones que son Full. Como “status” no esta especificado devuelve todos los estados.
=JAGUAR_ITEMLIST(, "active", , true)
Devuelve las publicaciones activas que sean de catálogo.

JAGUAR_ITEMCATEGORY() - Obtener la categoría de una publicación.

image

Descripción:

Devuelve la categoría o árbol de categorías de una publicación.

Sintaxis:

JAGUAR_ITEMCATEGORY([item_id], [return_style])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

return_style - OPCIONAL

Como devolver la información, los valores válidos son:

  • full (Árbol completo de la categoría)
  • inner (Solo la categoría mas específica)

El valor por defecto es “full”.

Ejemplos:

=JAGUAR_ITEMCATEGORY("MLA000000000")
Devuelve el árbol completo de categorías, por ejemplo: Bebés -> Paseo del Bebé -> Huevitos y Sillitas para Autos
=JAGUAR_ITEMCATEGORY("MLA000000000", "inner")
Devuelve solo la categoría mas específica, por ejemplo para la publicación anterior: Huevitos y Sillitas para Autos

JAGUAR_ITEMESTFEE() - Comisión estimada de la publicación.

image

Descripción:

Devuelve la comisión estimada de la publicación por listado y por venta.

Sintaxis:

JAGUAR_ITEMESTFEE([item_id], [return_style])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

return_style - OPCIONAL

Qué comisiones devolver, los valores válidos son:

  • full (Suma de comisión por venta y listado)
  • sale (Por venta)
  • listing (Por listado)

El valor por defecto es “full”.

Ejemplos:

=JAGUAR_ITEMESTFEE("MLA000000000")
Devuelve la suma del costo por publicar más la comisión por venta.
=JAGUAR_ITEMESTFEE("MLA000000000", "sale")
Devuelve la comisión por venta.
=JAGUAR_ITEMESTFEE("MLA000000000", "listing")
Devuelve el costo por publicar.

JAGUAR_ITEMVISITS() - Número de visitas.

image

Descripción:

Devuelve el número de visitas de una publicación. Puedes obtener el total, los últimos x días o bien un período definido por fecha de comienzo y fin.

Sintaxis:

JAGUAR_ITEMVISITS([item_id], [last_number_days], [start_date], [end_date])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

last_number_days - OPCIONAL

Cantidad de días para obtener las visitas.

start_date - OPCIONAL

Fecha de inicio para obtener las visitas.

end_date - OPCIONAL

Fecha de fin para obtener las visitas.

Ejemplos:

=JAGUAR_ITEMVISITS("MLA000000000")
Devuelve el número total de visitas de una publicación.
=JAGUAR_ITEMVISITS("MLA000000000", 15)
Devuelve el número de visitas que una publicación tuvo en los últimos 15 días.
=JAGUAR_ITEMVISITS("MLA000000000", , "2021-01-01", "2021-01-31")
Devuelve el número de visitas que una publicación tuvo entre el 1 de Enero de 2021 y el 31 de Enero de 2021.

JAGUAR_ITEMRATINGAVRG() - Promedio de las opiniones.

image

Descripción:

Devuelve el promedio de las opiniones de los compradores sobre una publicación.

Sintaxis:

JAGUAR_ITEMRATINGAVRG([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_ITEMRATINGAVRG("MLA000000000")
Devuelve el promedio de las opiniones de la publicación con id “MLA000000000”.

JAGUAR_ITEMQUESTIONS() - Número total de preguntas.

image

Descripción:

Devuelve el número total de preguntas que recibió una publicación.

Sintaxis:

JAGUAR_ITEMQUESTIONS([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_ITEMQUESTIONS("MLA000000000")
Devuelve el número total de preguntas que recibió la publicación con id “MLA000000000”.

JAGUAR_ITEMPOS() - Posición de la publicación respecto a la búsqueda.

image

Descripción:

Devuelve la posición de la publicación con respecto al término de búsqueda. Busca dentro de los primeros 1.000 resultados.

Sintaxis:

JAGUAR_ITEMPOS([item_id], [search_term])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

search_term - OBLIGATORIO

Término de búsqueda.

Ejemplos:

=JAGUAR_ITEMPOS("MLA000000000", "zapatillas bebe")
Devuelve la posición que tiene en los resultados la publicación con id “MLA000000000” respecto del término de búsqueda “zapatillas bebe”.

JAGUAR_ITEMIMGMESSAGE() - Mensaje sobre calidad de las imágenes.

image

Descripción:

Devuelve un mensaje detallando el estado actual de la calidad de las imágenes

Sintaxis:

JAGUAR_ITEMIMGMESSAGE([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_ITEMIMGMESSAGE("MLA000000000")
Mensaje con el estado actual de la calidad de las imágenes.

JAGUAR_ITEMIMGQA() - La calidad de las imágenes de la publicación.

image

Descripción:

Devuelve el estado general de la calidad de las imágenes de la publicación o bien un listado con las condiciones y si aplican o no.

Sintaxis:

JAGUAR_ITEMIMGQA([item_id], [return_style])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

return_style - OPCIONAL

Como devolver la información, los valores válidos son:

  • quality (Estado de la calidad general)
  • conditions (Listado de condiciones y si aplican o no)

El valor por defecto es “quality”.

Ejemplos:

=JAGUAR_ITEMIMGQA("MLA000000000")
Estado actual de la calidad de las imágenes, por ejemplo “good”
=JAGUAR_ITEMIMGQA("MLA000000000", "conditions")
Listado de las condiciones actuales relacionadas a las imágenes, si cumple o no con el mínimo requerido, si tiene o no fondo blanco, etc.

JAGUAR_ITEM() -Información relacionada a la publicación.

image

Descripción:

Devuelve información relacionada a la publicación, como por ejemplo imagen, precio, titulo, etc.

Sintaxis:

JAGUAR_ITEM([item_id], [property])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

property - OBLIGATORIO

Propiedad de la publicación que queremos mostrar. Las propiedades disponibles entre otras son:

  • title (Título)
  • price (Precio)
  • base_price (Precio base)
  • initial_quantity (Cantidad inicial)
  • available_quantity (Cantidad disponible)
  • sold_quantity (Cantidad vendida)
  • permalink (Link a la publicación)
  • secure_thumbnail (Imagen pequeña)
  • status (Estado)
  • warranty (Garantía)
  • seller_custom_field (Campo personalizado del vendedor)
  • health (Salud)
  • category_id (Id de la categoría)
Ejemplos:

=JAGUAR_ITEM("MLA000000000", "secure_thumbnail")
Esta fórmula devuelve la url de la imagen principal de la publicación, se puede mostrar combinando con la fórmula IMAGEN/IMAGE, =IMAGE(JAGUAR_ITEM("MLA000000000", "secure_thumbnail"))
=JAGUAR_ITEM("MLA000000000", "sold_quantity")
Devuelve la cantidad vendida de la publicación.
=JAGUAR_ITEM("MLA000000000", "health")
Devuelve la salud de la publicación.

JAGUAR_ITEMATTR() - Obtiene el atributo de una publicación.

image

Descripción:

Devuelve el valor del atributo de una publicación, los atributos disponibles dependen de la categoría.

Sintaxis:

JAGUAR_ITEMATTR([item_id], [attribute])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

attribute - OBLIGATORIO

Id o nombre del atributo. Los valores dependen de la categoría del item, ejemplos son SELLER_SKU, COLOR, DETAILED_MODEL, etc.

Ejemplos:

=JAGUAR_ITEMATTR("MLA000000000", "SELLER_SKU")
Devuelve el SKU de la publicación con id “MLA000000000”. Podes usar también SKU.
=JAGUAR_ITEMATTR("MLA000000000", "COLOR")
Devuelve el color de la publicación con id “MLA000000000”
=JAGUAR_ITEMATTR("MLA000000000", "DETAILED_MODEL")
Devuelve el modelo detallado de la publicación con id “MLA000000000”

JAGUAR_VARIAATTR() -Obtiene el atributo de la variación de una publicación.

image

Descripción:

Devuelve el valor del atributo de la variación de una publicación, los atributos disponibles dependen de la categoría.

Sintaxis:

JAGUAR_VARIAATTR([item_id], [variation_id] [attribute])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

variation_id - OPTIONAL

Id de la variación. Si no hay un valor, busca el atributo en la publicación.

attribute - OBLIGATORIO

Id o nombre del atributo. Los valores dependen de la categoría del item, ejemplos son SELLER_SKU, COLOR, DETAILED_MODEL, etc.

Ejemplos:

=JAGUAR_VARIAATTR("MLA000000000", "00000000000", "SELLER_SKU")
Devuelve el SKU de la publicación con id “MLA000000000”. Podes usar también SKU.
=JAGUAR_VARIAATTR("MLA000000000", "00000000000", "COLOR")
Devuelve el color de la publicación con id “MLA000000000”
=JAGUAR_VARIAATTR("MLA000000000", "00000000000", "DETAILED_MODEL")
Devuelve el modelo detallado de la publicación con id “MLA000000000”

JAGUAR_INFRACTIONS() -Infracciones de una publicación.

image

Descripción:

Devuelve las infracciones especificando la razón y el remedio relacionadas a una publicación.

Sintaxis:

JAGUAR_INFRACTIONS([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_INFRACTIONS("MLA000000000")
Lista de dos columnas con razón y remedio de cada infracción.

JAGUAR_INVENTORY() - Devuelve el inventario de una publicación.

image

Descripción:

Stock disponible de una publicación o de la variación específica de una publicación. Sirve para verificar stock disponible y no disponible cuando la publicación es Full.

Sintaxis:

JAGUAR_INVENTORY([item_id], [variation_id], [status])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

variation_id - OPCIONAL

Id de la variación.

status - OPCIONAL

Estado del stock, aplica solo cuando la publicación es Full, los valores válidos son:

  • available (Disponible)
  • not_available (No disponible)

El valor por defecto es “available”.

Ejemplos:

=JAGUAR_INVENTORY("MLA000000000")
Devuelve el inventario disponible total de la publicación.
=JAGUAR_INVENTORY("MLA000000000", "00000000000")
Devuelve el inventario disponible de la variación.
=JAGUAR_INVENTORY("MLA000000000", "00000000000", "not_available")
Devuelve el inventario NO disponible en Full de la variación.

JAGUAR_CATALOGSTATUS() - Estado de la publicación en catálogo.

image

Descripción:

Devuelve el estado de la publicación relacionada a catálogo.

Sintaxis:

JAGUAR_CATALOGSTATUS([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_CATALOGSTATUS("MLA000000000")
Devuelve el estado de la publicación relacionada a catálogo.

JAGUAR_CATALOGCURPRICE() - Precio de la publicación en catálogo.

image

Descripción:

Devuelve el precio de la publicación compitiendo en catálogo.

Sintaxis:

JAGUAR_CATALOGCURPRICE([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_CATALOGCURPRICE("MLA000000000")
Devuelve el precio de la publicación que esta compitiendo en catálogo.

JAGUAR_CATALOGWINPRICE() -Precio para ganar la publicación en catálogo.

image

Descripción:

Devuelve el precio necesario para que la publicación gane en catálogo.

Sintaxis:

JAGUAR_CATALOGWINPRICE([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_CATALOGWINPRICE("MLA000000000")
Devuelve el precio necesario para que la publicación gane en catálogo.

JAGUAR_CATALOGBOOSTS() -Acciones para impulsar la publicación en catálogo.

image

Descripción:

Devuelve las acciones disponibles para impulsar la publicación en catálogo.

Sintaxis:

JAGUAR_CATALOGBOOSTS([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_CATALOGBOOSTS("MLA000000000")
Devuelve las acciones disponibles para impulsar la publicación en catálogo y poder ganar el listado.

JAGUAR_CATALOGREASONS() - Razones por las que no compite.

image

Descripción:

Devuelve las razones por las cuales la publicación no esta compitiendo en catálogo.

Sintaxis:

JAGUAR_CATALOGREASONS([item_id])

Parámetros:
item_id - OBLIGATORIO

Id de la publicación.

Ejemplos:

=JAGUAR_CATALOGREASONS("MLA000000000")
Devuelve las razones por las cuales la publicación no esta compitiendo en catálogo.

JAGUAR_SALESCOUNT() - Unidades vendidas en un período.

image

Descripción:

Devuelve el total de unidades vendidas de un producto en un período determinado. Soporta solo las ventas dentro de los últimos 12 meses.

Sintaxis:

JAGUAR_SALESCOUNT([period], [item_id], [variation_id], [status], [start_date], [end_date])

Parámetros:
period - OBLIGATORIO

Período a utilizar para limitar los resultados, las opciones son:

  • Custom (En este caso debes especificar start_date y end_date)
  • Hoy
  • Ayer
  • Mismo día semana pasada
  • Mismo día mes pasado
  • Últimos 7 días
  • Últimos 14 días
  • Últimos 30 días
  • Últimos 60 días
  • Esta semana
  • Este mes
  • Semana pasada
  • Mes pasado
  • Últimos 12 meses
item_id - OBLIGATORIO

Id de la publicación.

variation_id - OPCIONAL

Id de la variación.

status - OPCIONAL

Estado de la orden, los valores válidos son:

  • paid (Ordenes concretadas)
  • cancelled (Ordenes canceladas)

El valor por defecto es “paid”

start_date - OPCIONAL

Fecha de comienzo para obtener las ventas del período, el formato es YYYY-MM-DD, por ejemplo “2021-01-31”

end_date - OPCIONAL

Fecha de fin para obtener las ventas del período, el formato es YYYY-MM-DD, por ejemplo “2021-01-01”

Ejemplos:

=JAGUAR_SALESCOUNT("Custom", "MLA000000000", , , "2021-01-01", "2021-01-31")
Devuelve el total de unidades vendidas que fueron concretadas de la publicación MLA000000000 incluidas todas las variaciones en el período 1 de Enero del 2021 al 31 de Enero del 2021.
=JAGUAR_SALESCOUNT("Este mes", "MLA000000000", , "cancelled")
Devuelve el total de ventas canceladas de la publicación MLA000000000 del mes corriente.
=JAGUAR_SALESCOUNT("Mismo día mes pasado", "MLA000000000")
Devuelve el total de ventas concretadas de la publicación MLA000000000 el mismo día que hoy pero del mes pasado.
=JAGUAR_SALESCOUNT("Últimos 12 meses", "MLA000000000")
Devuelve el total de ventas de los últimos 12 meses de la publicación MLA000000000.

JAGUAR_SALESTOTAL() - Cifra de ventas en un período.

image

Descripción:

Devuelve la cifra de ventas de un producto en un período determinado. Soporta solo las ventas dentro de los últimos 12 meses.

Sintaxis:

JAGUAR_SALESTOTAL([period], [item_id], [variation_id], [status], [start_date], [end_date])

Parámetros:
period - OBLIGATORIO

Período a utilizar para limitar los resultados, las opciones son:

  • Custom (En este caso debes especificar start_date y end_date)
  • Hoy
  • Ayer
  • Mismo día semana pasada
  • Mismo día mes pasado
  • Últimos 7 días
  • Últimos 14 días
  • Últimos 30 días
  • Últimos 60 días
  • Esta semana
  • Este mes
  • Semana pasada
  • Mes pasado
  • Últimos 12 meses
item_id - OBLIGATORIO

Id de la publicación.

variation_id - OPCIONAL

Id de la variación.

status - OPCIONAL

Estado de la orden, los valores válidos son:

  • paid (Ordenes concretadas)
  • cancelled (Ordenes canceladas)

El valor por defecto es “paid”

start_date - OPCIONAL

Fecha de comienzo para obtener la cifra de ventas del período, el formato es YYYY-MM-DD, por ejemplo “2021-01-31”

end_date - OPCIONAL

Fecha de fin para obtener la cifra de ventas del período, el formato es YYYY-MM-DD, por ejemplo “2021-01-01”

Ejemplos:

=JAGUAR_SALESTOTAL("Custom", "MLA000000000", , , "2021-01-01", "2021-01-31")
Devuelve la cifra de ventas que fueron concretadas de la publicación MLA000000000 incluidas todas las variaciones en el período 1 de Enero del 2021 al 31 de Enero del 2021.
=JAGUAR_SALESTOTAL("Este mes", "MLA000000000", , "cancelled")
Devuelve la cifra de ventas canceladas de la publicación MLA000000000 del mes corriente.
=JAGUAR_SALESTOTAL("Mismo día mes pasado", "MLA000000000")
Devuelve la cifra de ventas concretadas de la publicación MLA000000000 el mismo día que hoy pero del mes pasado.
=JAGUAR_SALESTOTAL("Últimos 12 meses", "MLA000000000")
Devuelve la cifra de ventas de los últimos 12 meses de la publicación MLA000000000.

JAGUAR_TRENDS() - Obtener tendencias.

image

Descripción:

Devuelve el listado de tendencias y links según país y categoría.

Sintaxis:

JAGUAR_TRENDS([site_id], [category_id])

Parámetros:
site_id - OPCIONAL

Sitio, MLA, MLB, etc. El valor por defecto es el sitio al cual pertenece tu cuenta.

category_id - OPCIONAL

Filtrar las tendencias por categoría, si no se especifica devuelve todas.

Ejemplos:

=JAGUAR_TRENDS()
Tendencias del país al que pertenece tu cuenta.
=JAGUAR_TRENDS("MLB")
Tendencias de Brasil.
=JAGUAR_TRENDS(, "MLA1386")
Tendencias del país al que pertenece tu cuenta de la categoría “MLA1386”. Puedes combinar esta función con JAGUAR_ITEM(“MLA000000000”, “category_id”) para obtener eld id de la categoría de un producto.

JAGUAR_CATATTR() - Atributos de la categoría.

image

Descripción:

Devuelve los atributos disponibles de una categoría.

Sintaxis:

JAGUAR_CATATTR(category_id)

Parámetros:
category_id - OBLIGATORIO

Id de la categoría.

Ejemplos:

=JAGUAR_CATATTR("MLA1386")
Devuelve los atributos de la categoría con id “MLA1386”