API de PriceZag — Conecta los datos de precios con tus sistemas

curl -vX POST 'https://pricezag.com/api/v3/MYAPIKEY' -d '{"actions":[{"a":"productCreate","code":"000-SOME-TEST-PRODUCT","name":"Some Test Product created via PriceZag API","price":12.34,"currency":"USD"}]}'

curl -X POST 'https://pricezag.com/api/v3/MYAPIKEY' -d '{"actions":[{"a":"productGet","code":"000-SOME-TEST-PRODUCT"}]}' | python -mjson.tool

{
	"stopOnFailure"	: 1,  // (opcional) Por defecto seguimos con la siguiente acción aunque falle. Usa 1 para detener la ejecución.

	// Array con todas las acciones:
	"actions" : [
		// Acción 1:
		{
			"a"	: "someActionName",  // El nombre de la acción siempre es la variable "a" de cada objeto.
			"xx"	: "some parameter this action needs"	// Todo lo demas depende de los parámetros que necesite la acción.
		},
		// Acción 2:
		{
			"a"	: "anotherActionName",
			"abc"	: "some parameter this action needs",
			"xyz"	: {"x":"some object this action needs", "y":5, "z":6}
		},
		// Acción 3:
		{
			"a"	: "aThirdAction",
			"xyz"	: ["some array this action needs", "..."]
		}
	]
}

{
	"ok"		: 15,  // número de acciones ejecutadas correctamente (ok>0)
	"errors"	: 0,  // número de acciones que generaron un error (ok<0)
	"actionsCount"	: 20,  // total de acciones solicitadas inicialmente (longitud del array "actions")
	// NOTA: deducimos que 5 acciones devolvieron ok=0 (no fallaron, pero no cambiaron nada).
	
	// Array con todas las acciones solicitadas (en el mismo orden):
	"actions" : [
		...
		// Objeto de respuesta de cada acción:
		{
			"a"	: "someActionName",
			"ok"	: 4,		// Resultado: >0 = éxito, 0 = sin cambios, <0 = error
						// Por ejemplo, 0 si cambias un precio por el mismo que ya tenía.
						// -1 si el producto no existe.
						// >0 depende de la acción. Suele ser el número de campos o elementos modificados.
			"error"	: "...",  // Mensaje de error, si ok < 0
						// Nuestros mensajes de error siempre son detallados. Guárdalos en los registros
						// porque contienen la información necesaria para diagnosticar el problema.
			...	// Otros datos específicos devueltos por esta acción
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "productCreate",
		"code"		: "UNIQUE-REF-CODE",  // entre 1 y 80 ([a-z\d][a-z\d_-]{0,78}[a-z\d]); no distingue mayúsculas (se convierte a mayúsculas)
		"name"		: "The Product Name",  // entre 1 y 200
		"price"		: 1234.90,  // Cuidado con comas y puntos. Sin separador de miles; el decimal usa punto.
		"currency"	: "USD",
		"cost"		: 1234.90,  // (opcional)
		"costCurrency"	: "USD",  // obligatorio si hay coste
		"repricingRule"	: "The Rule Name",  // (opcional) Regla de repricing asignada (vacía = desactivada, inexistente = error)
		"myWebsite"	: "https://...",  // (opcional) URL o shopify:productId:variantId, o woocommerce:productId(:variationId)
		"competitors"	: ["https://...", "https://..."],  // (opcional)
		"categories"	: ["The Category 1", "The Category 2"],  // (opcional) categorías del producto (si no existen se crean)
		"comments"	: "Some comments\nAnd another line",  // (opcional) máximo 1000 caracteres UTF-8
		"custom_someFieldName1"	: "Value of custom field",		// (opcional)
		"custom_someFieldName2"	: "Value of other\nCustom\tField",  // (opcional)
		// Los campos personalizados son para tu uso interno. Pueden aparecer en muchos lugares, por ejemplo como columnas al exportar hojas de cálculo.
		// Hasta 20 campos personalizados por producto. Nombre de máximo 40 letras/cifras/guiones bajos (distingue mayúsculas), sin prefijo "custom_" (47 en total).
		// Valor máximo 500 bytes (normalmente caracteres). Puedes asignar un número (custom_varname:123),
		// pero siempre devolvemos cadenas (custom_varname:"123"); convierte los valores al leerlos si hace falta.
		// Para eliminar un campo personalizado, asigna "". No ocurre en productCreate, sino en productEdit.
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "productCreate",
			"ok"	: 1,
			"code"	: "REF-CODE",  // Código final en base de datos (podemos modificar caracteres especiales de tu código)
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "productEdit",
		"code"		: "REF-CODE",
		...		// Usa los parámetros de productCreate, todos opcionales.
		"newCode"	: "REF-CODE-RENAMED",  // (opcional)
		"competitors"	: ["https://...", "https://..."],  // Si se proporciona, SUSTITUYE todas las URL de competidores existentes.
		// Si solo quieres añadir o eliminar competidores de los existentes, utiliza en su lugar la acción productCompetitors.
		"categories"	: ["The Category 1", "The Category 2"],  // Si se proporciona, SUSTITUYE las categorías actuales. Como alternativa, usa productCategories o categoryEdit.
		"custom_someFieldName"	: "New value or empty to delete that custom field",
		// Máximo 20 campos personalizados por producto. Para añadir otros, quita antes algunos asignando "".
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "productEdit",
			"ok"	: 3,  // Número de cambios (p. ej. mi precio + 2 URLs de competidores = 3)
			"code"	: "REF-CODE",  // Código final nuevo en la base de datos (podemos adaptar caracteres especiales)
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"			: "productCompetitors",
		"code"			: "REF-CODE",
		"competitorsAdd"	: ["https://...", "https://..."],  // (opcional) Añadir estas URL a las existentes
		"competitorsRemove"	: ["https://...", "example.com/a0ff80...5f00", "example.net"],  // (opcional) Quitar estos competidores. Cada elemento puede ser:
		// > La URL (incluido el modificador hashtag). Las etiquetas son opcionales.
		// > El "ref" del competidor (devuelto por otras acciones: dominio raíz y hash md5 de 32 caracteres)
		// > Dominio raíz o hostname completo; se quitaran todas las URL de ese dominio del producto.
		// NOTA: "competitorsAdd" y "competitorsRemove" también pueden ser cadenas en vez de arrays de un elemento.
		// Primero se quita y luego se añade: puedes quitar un dominio entero y añadir una URL suya.
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"			: "productCompetitors",
			"ok"			: 3,  // Número de URL de competidores modificadas
			"competitorsAdded"	: 2,  // Número de URL de competidores añadidas al producto
			"competitorsRemoved"	: 1,  // Número de URL de competidores quitadas del producto
			// ERRORES:
			// > Añadir una URL ya existente NO genera error (ok = 0)
			// > Quitar una URL o "ref" inexistente genera error (ok = -1)
			// > Quitar todas las URL de un dominio inexistente NO genera error (ok = 0)
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"			: "productCategories",
		"code"			: "REF-CODE",  // no distingue mayúsculas (cadena), O:
		"code"			: ["REF-CODE-1", "REF-CODE-2"],  // también puede ser un array con varios productos (máximo 100.000)
		"categoriesRemove"	: ["The Category 1", "The Category 2"],  // (opcional) Primero se quitan de estas categorías.
		"categoriesRemoveAll"	: 1,  // (opcional) Primero se quitan de todas las categorías (como productEdit).
		"deleteEmptyCategories"	: 1,  // Con esto cualquier categoría que quede vacía
		// como resultado de quitar productos se eliminara.
		"categoriesAdd"		: ["The Category 1", "The Category 2"],  // (opcional) Después añadir a estas categorías (si no existen, se crean)
		"categoriesAddClear"	: 1,  // (opcional) Primero vaciar las categorías a las que se añaden los productos
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "productCategories",
			"ok"	: 3,  // Número de productos modificados
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"			: "productRepricing",
		"repricingRule"		: "The Rule Name",  // no distingue mayúsculas; "" (cadena vacía existente) significa sin regla (desactivar repricing)
		"products"		: ["REF-CODE-1", "REF-CODE-2"],  // no distingue mayúsculas (máximo 100.000)
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"		: "productRepricing",
			"ok"		: 10,  // Número de productos modificados
			// Si todos los productos ya tenian esa regla, obtendras ok=0.
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"	: "productDelete",
		"code"	: "REF-CODE",  // no distingue mayúsculas (cadena), O:
		"code"	: ["REF-CODE-1", "REF-CODE-2"],  // también puede ser un array para eliminar varios productos (máximo 100.000)
		"deleteEmptyCategories"	: 1,  // Con esto cualquier categoría que quede vacía
		// así se borran también las categorías que queden vacias
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "productDelete",
			"ok"	: 2,  // Número de productos eliminados correctamente
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"			: "productGet",
		"code"			: "REF-CODE",  // no distingue mayúsculas
		"currency"		: "EUR",  // (opcional) convierte todos los importes a esta moneda en lugar de la moneda del producto
		"withStats"		: 1,  // (opcional) devolver el objeto de estadísticas
		"noCompetitors"		: 1,  // (opcional) no devolver el array de competidores (respuesta más pequeña)
		"noComments"		: 1,  // (opcional) no devolver los comentarios (...)
		"withScreenshots"	: 1,  // (opcional) devolver la URL de la última captura para cada competidor
		"sickMax"		: 2,  // (opcional, predeterminado 1) 0-3; devolver solo URL con nivel de error hasta N
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"			: "productGet",
			"ok"			: 1,
			"code"			: "REF-CODE",
			"name"			: "The Product Name",
			"price"			: 1234.90,  // Tu propio precio, siempre en la moneda original
			"currency"		: "USD",  // Moneda original de "price"
			"convCurrency"		: "EUR",  // Moneda de los importes convertidos ("currency" proporcionada o moneda original del producto)
			"priceConv"		: 1234.90,  // Precio propio convertido a "convCurrency", o igual que "price"
			"cost"			: 1234.90,
			"costCurrency"		: "USD",
			"costPriceConv"		: 1234.90,  // Coste propio convertido a la moneda de "currency"
			"costConv"		: 1234.90,  // Coste propio convertido a "convCurrency"
			"margin"		: 10.5,  // Porcentaje (puede ser negativo)
			"repricingRule"		: "The Rule Name",  // Estas 3 variables de repricing NO EXISTEN si no hay repricing.
			"reprice"		: 1234.90,  // Importe de repricing actual calculado según repricingRule
			"repriceCurrency"	: "USD",  // Igual que "convCurrency", solo para mayor claridad
			"myWebsite"		: "https://...",
			"created"		: 1234567890,  // Tiempo Epoch de creación del producto
			"createdBy"		: "SOMEUSER",  // Nombre del usuario o "API"
			"edited"		: 1234567890,  // Tiempo Epoch de la última edición (si la hubo)
			"editedBy"		: "SOMEUSER",  // Nombre del usuario o "API"
			"comments"		: "Some comments\nAnd another line",
			"commentsLast"		: 1234567890,  // Tiempo Epoch de la última edición de comentarios (si la hubo)
			"commentsLastBy"	: "SOMEUSER",  // Nombre del usuario o "API"
			"categories"		: ["The Category 1", "The Category 2"],
			"stats"		: {
				// Solo cuentan competidores de nivel 0 o 1 para estadísticas, independientemente de "sickMax".
				// Todos los importes están en "convCurrency", es decir "currency" o la moneda original del producto.
				// ADVERTENCIA: si no hay importe (p. ej. compIn* sin competidores con stock), el valor es 0.
				"rank"			: 1.23,  // Tu posición en precio (1 = nadie por debajo)
				"rankIn"		: 1.23,  // Tu posición entre competidores con stock
				"compCount"		: 3,  // Número de competidores con precio válido
				"compInCount"		: 3,  // Número de competidores con stock...
				"compOutCount"		: 3,  // Número de competidores sin stock ...
				"compAvg"		: 123.56,  // Media de todos los competidores
				"compAvgVsMe"		: 123.56,  // Diferencia (en convCurrency) entre tu precio y la media (negativo = eres más barato)
				"compInAvg"		: 123.56,  // Media de competidores con stock
				"compInAvgVsMe"		: 123.56,  // Como "compAvgVsMe", pero solo con stock
				"compLowest"		: 123.56,  // Competidor más barato
				"compLowestVsMe"	: 123.56,  // Como "compAvgVsMe", pero usando el mínimo en vez de la media
				"compInLowest"		: 123.56,  // Competidor más barato con stock
				"compInLowestVsMe"	: 123.56,  // Como "compInAvgVsMe", pero ...
				"compHighest"		: 123.56,  // Competidor más caro
				"compHighestVsMe"	: 123.56,  // Como "compAvgVsMe", pero ...
				"compInHighest"		: 123.56,  // Competidor más caro con stock
				"compInHighestVsMe"	: 123.56,  // Como "compInAvgVsMe", pero ...
			},
			"competitors"	: [
				// Array de competidores (más barato primero), cada uno es un objeto:
				...
				{
					"url"		: "https://...",  // Incluye cualquier modificador hashtag
					"ref"		: "example.com/123abc...def",
					// Referencia de URL (dominio raíz + md5 de 32 caracteres); así identificamos URL internamente.
					"domain"	: "example.com",  // Dominio raíz de este competidor
					"price"		: 1234.90,  // Ultimo importe encontrado (tras aplicar cálculos configurados)
					"currency"	: "USD",  // Moneda encontrada en el sitio
					"priceConv"	: 1234.90,  // Precio convertido a "convCurrency"
					"stock"		: "5",  // Inventario (cadena). "A" = disponible, "2" = 2 unidades, "0" = agotado, "" = desconocido.
					"salesWk"	: 123,  // ventas estimadas por semana (si hay datos; consulta la ayuda del producto)
					"screenshotURL"	: "https://pricezag.com/.../screenshot.png",
					// si "withScreenshots", URL de la última captura (enlace accesible sin inicio de sesión)
					"confidence"	: 98,
					// Porcentaje de confianza en el precio detectado (consulta (?) en el producto)
					// Por debajo del 70% (configurable) lo marcamos como "no fiable" con un signo de interrogación.
					// Es independiente del nivel de error. La URL puede fallar ahora aunque el último precio fuese correcto,
					// o funcionar pero no estar seguros de haber detectado el precio correcto.
					"sick"		: 0,  // Nivel de error de URL: de 0 a 3
					// 0: la última visita tuvo éxito (página cargada y precio encontrado)
					// 1: última visita fallida, pero hubo éxito recientemente (algo habitual)
					// 2: sin precio válido desde hace varios días
					// 3: sin precio válido desde hace varias semanas
					// NOTA: "price" y "priceConv" solo aparecen para URL con nivel <=1. Niveles 2 y 3 no tienen precio.
				},
				...
			],
			"custom"	: {
				// Estos son tus campos personalizados. Si no sabes como funcionan, abre
				// un producto en la interfaz y pulsa (?) junto a CUSTOM FIELDS.
				// Si no hay campos personalizados, no aparece el objeto "custom".
				"variable_1"	: "value 1",  // Los valores siempre son cadenas, incluso si representan números.
				"variable_2"	: "value 2",  // Un valor vacío no existe: habría eliminado esa variable.
				...
			}
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"			: "productGetAll",
		"currency"		: "EUR",  // (opcional) convertir importes a esta moneda en vez de a la moneda de cada producto
		"withStats"		: 1,  // (opcional) devolver el objeto de estadísticas
		"noCompetitors"		: 1,  // (opcional) no devolver el array de competidores (respuesta más pequeña)
		"noComments"		: 1,  // (opcional) no devolver los comentarios (...)
		"withScreenshots"	: 1,  // (opcional) devolver la URL de la última captura para cada competidor
		"sickMax"		: 2,  // (opcional, predeterminado 1) 0-3; devolver solo URL con nivel de error hasta N
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"		: "productGetAll",
			"ok"		: 10,  // Número total de productos
			"products"	: [ // Array de productos (orden alfabético por código), cada producto como objeto:
				...
				{ ... },  // Objeto de producto igual al devuelto por la acción productGet (justo arriba)
				...
			],
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "categoryCreate",
		"name"		: "The New Category Name",
		"name"		: ["New Category 1", "New Category 2"],  // también puede ser un array
		"products"	: ["REF-CODE-1", "REF-CODE-2"],  // (opcional) Añadir estos productos a las categorías al crearlas
		"comments"	: "Some comments\nAnd another line",  // (opcional) máximo 1000 caracteres UTF-8
	},
	...
] }

{ "actions" : [
	...
	{
		"a"			: "categoryEdit",
		"name"			: "The Category Name",		// no distingue mayúsculas
		"newName"		: "The Category Renamed",  // (opcional)
		"products"		: ["REF-CODE-1", "REF-CODE-2"],  // (opcional) Sustituir la lista de productos
		"productsAdd"		: ["REF-CODE-1", "REF-CODE-2"],  // (opcional) Añadir productos a la categoría
		"productsRemove"	: ["REF-CODE-3", "REF-CODE-4"],  // (opcional) Quitar productos de la categoría (NO los elimina)
		"comments"		: "To overwrite the comments.",  // (opcional) máximo 1000 caracteres UTF-8
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"			: "categoryEdit",
			"ok"			: 5,  // Número de modificaciones
			// (renombrar y editar comentarios cuentan como 1 cada uno; también cada producto anadido o quitado)
			"name"			: "The Category Name",  // nombre nuevo si se renombro, o nombre anterior
			"productsCount"		: 30,  // Nueva cantidad de productos en categoría (haya cambiado o no)
			"productsAdded"		: 2,  // Número de productos anadidos a categoría
			"productsRemoved"	: 2,  // Número de productos quitados de categoría
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"			: "categoryDelete",
		"name"			: "The Category Name",  // no distingue mayúsculas (cadena), O:
		"name"			: ["Category 1", "Category 2"],  // también puede ser un array para eliminar varias categorías (máximo 1000)
		"deleteProducts"	: 1,
		// Por defecto se elimina la categoría, pero sus productos permanecen,
		// pero con deleteProducts, todos los productos de la categoria se eliminan sin confirmacion,
		// y sus URL de competidores también se borran sin posibilidad de recuperarlas!
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"			: "categoryDelete",
			"ok"			: 2,  // Número de categorías eliminadas
			"productsCount"		: 123,  // Número de productos afectados por esas categorías
			"productsDeleted"	: 123,  // Número de productos eliminados mediante la opción "deleteProducts"
			// NOTA: un producto que pertenezca a varias categorías indicadas solo se cuenta una vez
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"			: "categoryCopy",
		"categoriesFrom"	: ["Category 1", "Category 2"],  // Buscar productos en estas categorías (origen)
		"removeMode"		: "cat",  // (opcional) Quitar los productos correspondientes de las "categoriesFrom" indicadas
		"removeMode"		: "all",  // (opcional) Quitar los productos correspondientes de todas sus categorías
		// Sin removeMode los productos permanecen en "categoriesFrom" y se añaden a "categoriesTo" (copiar, no mover)
		"deleteMode"		: "cat",  // (opcional) Eliminar las categorías "categoriesFrom" después de copiar
		"deleteMode"		: "all",  // (opcional) Eliminar todas las categorías a las que pertenecen esos productos
		// Si se omite deleteMode, "categoriesFrom" sigue existiendo aunque removeMode haya quitado sus productos.
		"categoriesTo"		: ["Another Category 1", "Another Category 2"],
		// Colocar todos los productos encontrados en estas categorías de destino (si no existen se crean)
		"categoriesToClear"	: 1,  // (opcional) Primero vaciar las categorías a las que se añaden los productos
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"			: "categoryCopy",
			"ok"			: 3,  // Número de categorías modificadas (origen y destino)
			// "ok" es la suma de categoriesModified + categoriesCreated + categoriesDeleted
			"categoriesModified"	: 2,  // Número de categorías existentes modificadas (origen y destino)
			"categoriesCreated"	: 1,  // Número de categorías nuevas creadas
			"categoriesDeleted"	: 0,  // Número de categorías eliminadas mediante "deleteMode"
			"productsCount"		: 123,  // Número de productos encontrados en las "categoriesFrom" indicadas
			// NOTA: un producto en varias "categoriesFrom" indicadas solo se cuenta una vez
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "categoryGet",
		"name"		: "The Category Name",  // no distingue mayúsculas
		"currency"	: "EUR",  // (OBLIGATORIO si withStats o withProducts) moneda de las estadísticas
		"withStats"	: 1,  // devolver también las estadísticas (más lento)
		"withProducts"	: 1,  // devolver también los productos de la categoría (puede generar muchos datos)
		"noCompetitors"	: 1,  // si withProducts, no devolver el array de competidores (para reducir datos)
		"noComments"	: 1,  // si withProducts, no devolver comentarios de productos (si los de categoría)
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"			: "categoryGet",
			"ok"			: 1,
			"name"			: "The Category Name",
			"created"		: 1234567890,  // Tiempo Epoch
			"createdBy"		: "SOMEUSER",  // Nombre del usuario o "API"
			"comments"		: "Comments of this category",
			"commentsLast"		: 1234567890,  // Tiempo Epoch de la última edición de comentarios (si la hubo)
			"commentsLastBy"	: "SOMEUSER",  // Nombre del usuario o "API"
			"productsCount"		: 10,  // Número de productos de la categoría
			"stats"		: {
				// Estas estadísticas aparecen en la UI de la categoría y como columnas en la lista de categorías.
				// Para detalles, seleccionalas como columna en la lista de categorías y pulsa (?).
				// Todos los importes están en la "currency" indicada en la solicitud.
				// ADVERTENCIA: si no hay importe (p. ej. compIn* sin competidores con stock), el valor es 0.
				"priceAvg"		: 123.45,  // Tu precio promedio
				"costAvg"		: 123.45,  // Solo productos con coste entran en esta media
				"marginAvg"		: 10.5,  // Porcentaje (puede ser negativo; solo productos con coste)
				"rankAvg"		: 1.23,  // Tu rango medio por precio (1 = nadie por debajo)
				"rankInAvg"		: 1.23,  // Tu rango medio entre competidores con stock
				"productsCountComp"	: 9,  // Número de productos con competidores
				"productsCountCompIn"	: 7,  // Número de productos con competidores con stock
				"compAvg"		: 123.56,  // Media de las medias de todos los competidores
				"compAvgVsMe"		: 123.56,  // Diferencia media (en currency) entre tu precio y los competidores (negativo = eres más barato)
				"compInAvg"		: 123.56,  // Como "compAvg", pero solo con competidores con stock
				"compInAvgVsMe"		: 123.56,  // Como "compAvgVsMe", pero solo con stock
				"compLowest"		: 123.56,  // Igual que "compAvg", pero promedio del competidor más barato de cada producto
				"compLowestVsMe"	: 123.56,  // Como "compAvgVsMe", pero ...
				"compInLowest"		: 123.56,  // Igual que "compInAvg", pero ...
				"compInLowestVsMe"	: 123.56,  // Como "compInAvgVsMe", pero ...
				"compHighest"		: 123.56,  // Igual que "compAvg", pero promedio del competidor más caro de cada producto
				"compHighestVsMe"	: 123.56,  // Como "compAvgVsMe", pero ...
				"compInHighest"		: 123.56,  // Igual que "compInAvg", pero ...
				"compInHighestVsMe"	: 123.56,  // Como "compInAvgVsMe", pero ...
			},
			"products"	: [ // Array de productos (orden alfabético por código), cada producto como objeto:
				...
				{ ... },  // Objeto de producto igual al devuelto por la acción productGet
				...
			],
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "categoryGetAll",
		"withStats"	: 1,  // devolver también las estadísticas (más lento)
		"noComments"	: 1,  // no devolver comentarios (para reducir datos)
		"noProducts"	: 1,  // no devolver array de productos (...)
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"		: "categoryGetAll",
			"ok"		: 10,  // Total de categorías (longitud de array "categories")
			"categories"	: [ // Array de categorías (orden alfabético), cada una es un objeto:
				...
				{
					"name"			: "The Category Name",
					"created"		: 1234567890,  // Tiempo Epoch
					"createdBy"		: "SOMEUSER",  // Nombre del usuario o "API"
					"comments"		: "Comments of this category",
					"commentsLast"		: 1234567890,  // Tiempo Epoch de la última edición de comentarios (si la hubo)
					"commentsLastBy"	: "SOMEUSER",  // Nombre del usuario o "API"
					"productsCount"		: 2,  // Número de productos de la categoría
					"products"	: ["REF-CODE-1", "REF-CODE-2"],  // Codigos de sus productos (orden alfabético), salvo noProducts=1
					"stats"		: {
						// Si se usa "withStats", es el mismo objeto de estadísticas que en la acción categoryGet (justo arriba)
						...
					},
				}
				...
			],
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "alertRecipientCreate",
		"email"		: "john@example.net",  // también puede ser teléfono para alertas SMS; consulta la ayuda en UI
		"name"		: "john",  // Nombre visible sencillo (normalmente nombre de pila; no distingue mayúsculas)
		"maxFrequency"	: 1800,  // (opcional, predeterminado 7200) consulta ayuda en UI
		"simplify"	: 0,  // (opcional, predeterminado 1) Activar simplificación (consulta UI)
		"sleepEnabled"	: 1,  // (opcional) Activar período de descanso
		"sleepFrom"	: "18:30",  // (solo si sleepEnabled) formato 24 horas
		"sleepTo"	: "07:00",  // (solo si sleepEnabled) formato 24 horas
		"timezone"	: "America/Los_Angeles",  // (solo si sleepEnabled) ruta de carpetas Linux /usr/share/zoneinfo
				// Los espacios se convierten en guiones bajos.
				// Busca tu zona horaria en [New Recipient] en la UI para indicar su nombre exacto.
		"status"	: "hold",  // (opcional) "hold" o "disable". Cualquier otro valor (como "") está activo.
		"rules"		: [...],  // (opcional) Reglas de alerta iniciales (array de objetos de regla), como "rulesAdd" en alertRecipientEdit más abajo
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "alertRecipientCreate",
			"ok"	: 1,
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "alertRecipientEdit",
		"email"		: "john@example.net",  // Correo electrónico o número de teléfono actual (exactamente en el formato devuelto por la acción alertGetAll)
		"newEmail"	: "john2@example.net",  // (opcional) Email o teléfono nuevo; consulta ayuda de UI
		"name"		: "john2",  // (opcional) Nombre nuevo
		"maxFrequency"	: 1800,  // (opcional) consulta ayuda en UI
		"simplify"	: 1,  // (opcional) Activar simplificación (consulta UI)
		"sleepEnabled"	: 1,  // (opcional) Activar período de descanso
		"sleepFrom"	: "18:30",  // (solo si sleepEnabled) formato 24 horas
		"sleepTo"	: "07:00",  // (solo si sleepEnabled) formato 24 horas
		"timezone"	: "America/Los_Angeles",  // (solo si sleepEnabled) consulta la acción alertRecipientCreate de arriba
		"status"	: "hold",  // (opcional) "hold" o "disable". Cualquier otro valor (como "") pasa a "active".
		"rules"		: [{ruleObject}, {ruleObject}],  // (opcional) Sustituir todas las reglas actuales (array vacía para quitarlas todas)
				  // No proporciones un array "rules" si quieres conservar las reglas actuales
		"rulesAdd"	: [ // (opcional) Añadir estas reglas a las actuales
			...
			{  // ESTE ES EL FORMATO DE OBJETO DE UNA REGLA:
				"name"		: "me_cross_avg",  // ve a Alerts > [Rules] > [+ New Rule] y selecciona una regla para ver su nombre API
				"disabled"	: 1,  // (opcional) No tiene mucho sentido crear una regla desactivada, pero la acción alertRuleEdit de abajo puede necesitarlo
				"var_n"		: 123.00,  // Una variable "X" se convierte en "var_x",
				"var_c"		: "USD",  // ... así que incluye lo que necesite esa regla,
				"var_h"		: 24,  // ... algunas reglas no requieren variables.
				"direction"	: "both",  // O "drop" o "rise" si la regla tiene dirección
				"categories"	: ["The Category 1", "The Category 2"],  // (opcional) Vacio u omitido significa TODOS LOS PRODUCTOS
				"ignoreOos"	: 1,  // (opcional) Ignorar competidores sin stock (ver UI)
				"urlInclude"	: "",  // (opcional, no distingue mayúsculas)
				"urlExclude"	: "amazon",  // (opcional, no distingue mayúsculas)
				// "ruleNumber" identifica cada regla (por ejemplo para editarla o eliminarla).
				// Lo veras al leer las reglas, pero no puedes asignarlo.
			}
			...
		],
		"rulesRemove"	: [1,4,7],  // (opcional) "ruleNumber" de las reglas que se quitaran
					// Obtendrás este "ruleNumber" de la acción alertGetAll de abajo.
					// NOTA: para quitar todas las reglas usa "rules" = [].
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "alertRecipientEdit",
			"ok"	: 3,  // Número de cambios (variables y reglas añadidas/eliminadas)
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "alertRecipientDelete",
		"email"		: "john@example.net",  // Correo electrónico o número de teléfono actual (exactamente en el formato devuelto por la acción alertGetAll)
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "alertRecipientDelete",
			"ok"	: 1,
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "alertRuleEdit",
		"email"		: "john@example.net",  // Correo electrónico o número de teléfono del destinatario (exactamente en el formato devuelto por la acción alertGetAll)
		"ruleNumber"	: 1,  // Número de referencia de la regla que se va a editar, devuelto por la acción alertGetAll de abajo.
		"rule"		: {
			// Variables de la regla que se van a sobrescribir. Consulta "rulesAdd" en alertRecipientEdit más arriba para ver el FORMATO DEL OBJETO DE REGLA.
			"disabled"	: 1,  // por ejemplo activar o desactivar una regla
			"var_n"		: 5,  // u otra variable, como N, según el tipo de regla
			...
		},
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "alertRuleEdit",
			"ok"	: 1,  // Número de variables modificadas
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"	: "alertGetAll",
		// Esta acción no necesita parámetros
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"		: "alertGetAll",
			"ok"		: 3,  // Número de destinatarios (longitud del array "recipients")
			"recipients"	: [ // Array de todos los destinatarios, cada uno representado por un objeto como el de la acción alertRecipientCreate de arriba
				...
				{
					"email"		: "john@example.net",
					"name"		: "john",
					"maxFrequency"	: 1800,
					"simplify"	: 0,
					"sleepEnabled"	: 1,
					"sleepFrom"	: "18:30",
					"sleepTo"	: "07:00",
					"timezone"	: "America/Los_Angeles",
					"status"	: "active",
					"rules"		: [ // Array de reglas, cada una representada por un objeto como se describe en la acción alertRecipientEdit de arriba
						...
						{
							"ruleNumber"	: 4,  // Número de referencia que debes usar para editar esta regla mediante la acción alertRuleEdit de arriba
							"name"		: "me_cross_avg",
							"disabled"	: 0,
							"var_n"		: "123.00",  // NOTA: devolvemos todas las variables como cadenas, incluso si son números
							"var_c"		: "USD",
							"var_h"		: "24",
							"direction"	: "both",
							"categories"	: [],  // vacío significa todos los productos
							"ignoreOos"	: 0,
							"urlInclude"	: "",
							"urlExclude"	: "amazon",
						}
						...
					],
				}
				...
			],
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"	: "repricingCreate",
		"name"	: "The Rule Name",  // máximo 50 caracteres
		"init"	: { // objeto inicial (primera fila "Fijar mi precio en")
			"target"	: "cheapest_n",  // (consulta la lista inferior)
			"var_n"		: 3,  // solo si el objetivo necesita variable N
			"plusAmount"	: -2,  // positivo: por encima; negativo: por debajo
			"plusCurrency"	: "%",  // moneda (p. ej. "USD") o "%"
			// Corresponde a "Fijar mi precio un 2 % por debajo de la media de los 3 competidores más baratos"
			// ADVERTENCIA: el objeto inicial no tiene "direction", a diferencia de "never". El signo de "plusAmount" determina arriba/abajo.
		},
		"never"	: [ // (opcional) objetos "but never" ejecutados en orden (máximo 10)
			{
				"target"	: "cheapest_n_in",  // (consulta la lista inferior)
				"var_n"		: 1,  // solo si el objetivo necesita variable N
				"direction"	: "below",  // o "above"
				"plusAmount"	: -10,  // positivo: suma; negativo: resta (obligatorio incluso si 0)
				"plusCurrency"	: "USD",  // moneda o "%" (obligatorio incluso si plusAmount=0)
				// Corresponde a "Pero nunca por debajo del competidor más barato con existencias menos 10,00 USD"
			},
			{
				"target"	: "cost",
				"direction"	: "below",
				"plusAmount"	: 5,
				"plusCurrency"	: "%",
				// Corresponde a "Pero nunca por debajo de mi coste más un 5 %"
			}
		],
		"ignoreDomains"	: "amazon ebay.com MyLabel1",  // (opcional) dominios o etiquetas que se ignoraran (sin distinguir mayúsculas; ver UI)
		"charm"		: "none|zeros|charm",  // (opcional, predeterminado "none") precios psicológicos ("", "none" u omitido son iguales)
		"confidence"	: 82,  // (opcional, predeterminado 70) confianza mínima 0-99% (ver UI)
		"disabled"	: 1,  // (opcional)
	},
	...
] }
// ========== Cadenas "target" disponibles: ==========
// "average" : Media de todos los competidores
// "average_in" : Media de competidores con stock
// "cheapest_n" : Media de N competidores más baratos (o el mínimo si N=1)
// "cheapest_n_in" : Media de N competidores más baratos con stock (o ...)
// "highest_n" : Media de N competidores más caros (o ...)
// "highest_n_in" : Media de N competidores más caros con stock (o ...)
// "cost" : Mi coste
// "me_avg_n" : Mi precio promedio de las últimas N horas (limita la velocidad de cambios)
// "domain:example.com" : precio de example.com (mínimo si hay varias URL)
// "domainIn:example.com" : precio de example.com solo con stock (...)

{
	...
	"actions" : [
		...
		{
			"a"	: "repricingCreate",
			"ok"	: 3,  // Número de objetos analizados y guardados (p. ej. init + never[0] + never[1] = 3)
			"name"	: "The Rule Name",  // Nombre final en la base de datos (podemos adaptar caracteres especiales)
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "repricingEdit",
		"name"		: "The Rule Name",  // no distingue mayúsculas
		"newName"	: "The Rule Renamed",  // (opcional) máximo 50 caracteres
		"init"		: { // (opcional) Si se proporciona, sustituye variables del objeto inicial (ver repricingCreate)
			"plusAmount"	: 1,  // p. ej. cambiar solo "plusAmount" y conservar las demas variables
			// ADVERTENCIA: si el nuevo "target" requiere N debes proporcionar "var_n"
		},
		"never"		: [...], // (opcional) Puedes sustituir todo el array "never", pero suele convenir never_*
		// "never":[] borra todas las condiciones. Omite la variable para conservarlas.
		"never_0"	: { // (opcional) sustituir el primer objeto "but never" (indice 0)
			"var_n"		: 2,  // p. ej. cambiar solo "var_n" y conservar las demas variables
		},
		"never_2"	: {
			"target"	: "",  // desactiva la tercera condición "but never" (indice 2)
			// No te preocupes por las otras variables del objeto si "target" es "".
			// "never_2":{} hace lo mismo
		},
		"never_6"	: {...}, // Puede ser una nueva condición "but never"; requiere todas las variables como en repricingCreate
		// "never_9" es el máximo; el array "never" admite hasta 10 elementos
		"ignoreDomains"	: "",  // (opcional) igual que repricingCreate
		"charm"		: "zeros",  // (opcional) ...
		"confidence"	: 82,  // (opcional) ...
		"disabled"	: 1,  // (opcional) 0 para activar una regla desactivada
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "repricingEdit",
			"ok"	: 3,  // Número de cambios (una variable de never_N, otra de "init" y "charm", por ejemplo)
			"name"	: "The Rule Name",  // Nombre nuevo final en la base de datos (podemos adaptar caracteres especiales)
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "repricingDelete",
		"name"		: "The Rule Name",  // no distingue mayúsculas
		"onlyIfUnused"	: 1,  // (opcional) Por seguridad, genera un error si algún producto utiliza esta regla
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"		: "repricingDelete",
			"ok"		: 1,
			"productsCount"	: 10,  // Número de productos que utilizaban esta regla (ahora sin regla)
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"	: "repricingGetAll",
		// Esta acción no requiere más parámetros
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "repricingGetAll",
			"ok"	: 10,  // Número total de reglas (longitud de "rules")
			"rules"	: [ // Array de reglas de repricing (orden alfabético), cada una como objeto:
				...
				{
					"name"		: "Some Repricing Rule",
					"created"	: 1234567890,  // Tiempo Epoch de creación de la regla
					"createdBy"	: "SOMEUSER",  // Nombre del usuario o "API"
					"edited"	: 1234567890,  // Última modificacion (si la hubo; en caso contrario variable ausente)
					"editedBy"	: "SOMEUSER",  // Usuario o "API" (o ausente)
					"disabled"	: 1234567890,  // Si la regla está desactivada: tiempo Epoch de la última desactivación; si no, ausente.
					"disabledBy"	: "SOMEUSER",  // Usuario o "API" (o ausente)
					"productsCount"	: 10,  // Número de productos que utilizan actualmente la regla
					"ignoreDomains"	: "amazon ebay.com MyLabel1",  // dominios o etiquetas de competidores ignorados (ver UI)
					"charm"		: "charm",  // modo de precios psicológicos (none|zeros|charm)
					"confidence"	: 82,  // confianza mínima 0-99% (ver UI)
					"init"	: { // objeto inicial (primera fila "Fijar mi precio en")
						"target"	: "cheapest_n",  // (consulta la lista en repricingCreate)
						"var_n"		: 3,  // si el objetivo requiere N; si no, ausente
						"plusAmount"	: -2,  // positivo: por encima; negativo: por debajo
						"plusCurrency"	: "%",  // moneda (p. ej. "USD") o "%"
						// Corresponde a "Fijar mi precio un 2 % por debajo de la media de los 3 competidores más baratos"
						// ADVERTENCIA: el objeto inicial no tiene "direction", a diferencia de "never". El signo de "plusAmount" determina arriba/abajo.
					},
					"never"	: [ // objetos "but never" ejecutados en orden
						{
							"target"	: "cheapest_n_in",
							"var_n"		: 1,
							"direction"	: "below",  // o "above"
							"plusAmount"	: -10,  // positivo: sumar; negativo: restar
							"plusCurrency"	: "USD",  // moneda o "%"
							// Corresponde a "Pero nunca por debajo del competidor más barato con existencias menos 10,00 USD"
						},
						{},  // Esta segunda fila de condiciones "But never" está vacía
						{
							"target"	: "cost",
							"direction"	: "below",
							"plusAmount"	: 5,
							"plusCurrency"	: "%",
							// Corresponde a "Pero nunca por debajo de mi coste más un 5 %"
						}
					],
				}
				...
			],
		},
		...
	]
}

{ "actions" : [
	{
		"a"		: "spreadsheetDownload",
		"preset"	: "Some Preset Name",  // (opcional) En lugar de indicar los parámetros siguientes, usa uno de tus ajustes predefinidos o nuestros
			// Para tus ajustes: nombre completo sin usuario delante ni moneda detrás.
			// Para nuestros ajustes, consulta nombres en DIRECT DOWNLOAD de Export (pasa el raton sobre ellos).
			// Por ejemplo "pricezag_backup" es un ajuste especial de copia de seguridad (ver "Special BACKUP format to re-import" en DIRECT DOWNLOAD)
			// Puedes indicar más variables para sustituir opciones del ajuste (otra moneda, formato o categorías).
		"savePreset"	: "My New Preset Name",  // (opcional) Guardar los parámetros siguientes como ajuste nuevo (utilizable en UI y API)
			// EXCEPCION DE LA EXCEPCION: con savePreset no se descarga archivo; devuelve un objeto JSON.
		"savePresetOverwrite"	: 1,  // (opcional) Sustituir un ajuste existente indicado en "savePreset" (sin esto habría error)
			// ADVERTENCIA: sustituir elimina todas las opciones anteriores; no cambies solo un campo.
			// Para cambiar el nombre de un ajuste predefinido o eliminarlo, utiliza la acción spreadsheetPresetEdit de abajo.
		"downloadURL"	: 1,  // (opcional) EXCEPCION: en vez del archivo devuelve JSON con "fileURL",
			// URL pública del archivo, sin clave ni inicio de sesión. Disponible 15 minutos para descargar desde cualquier lugar.
			// "ok" es el número de filas; también "fileSize" en bytes.
		"format"	: "xlsx|xls|csv|csv-tab",  // (predeterminado CSV para API)
		"currency"	: "USD",  // (OBLIGATORIO salvo con preset) moneda de TODOS los importes
		"categories"	: ["Category 1", "Category 2"],  // Solo productos de estas categorías (si se omite, todos)
		"historyPeriod"	: "prev_6mo",  // (opcional, predeterminado "now")
			// PRIMERO: consulta los (?) sobre períodos históricos en Export; contienen explicaciones importantes.
			// "historyPeriod" indica hasta cuanto retroceder; "historyRow" divide datos en filas por producto.
			// "now": sin historial, solo datos actuales (sin "historyRow")
			// "all": todo el historial disponible desde tu registro (o el de esos productos). PUEDE SER LENTO.
			// "1234500000-1237800000": intervalo propio (tiempos Epoch inicio-fin)
			// "123h": últimas 123 horas sin alinear al reloj; fin ahora y comienzo puede ser entre horas.
			// "cur_123(d|wk|mo|yr)": ultimos 123 días/semanas/meses/años incluyendo el período actual incompleto. "cur_2mo" el día 10 = 40 días.
			// "prev_123(d|wk|mo|yr)": 123 períodos anteriores completos. "prev_2mo" el 10 feb. = diciembre+enero (62 días).
			// Inicio de cur_* y prev_* (y fin de prev_*) se alinea a medianoche anterior; cur_* termina ahora.
			// Así "cur_2d" al mediodia cubre 36 horas; "prev_2d" cubre 48 horas hasta hace 12 horas.
		"historyRow"	: "2w",  // (obligatorio si "historyPeriod" no es "now")
			// "historyRow" define la duración de cada fila (media de ese período), varias filas por producto (salvo "all").
			// Piensa en "historyRow" como división de "historyPeriod" en filas por producto.
			// "all": media del historyPeriod completo, una fila por producto.
			// "123(d|wk|mo|qt|yr)": intervalos calendario de 123 días/semanas/meses/trimestres/años desde medianoche. 123 opcional si vale 1 ("wk" = "1wk")
			// Si descargas el sábado con historyRow:"7d", cada fila promedia sábado 00:00 - viernes 23:59.
			// Pero historyRow:"1wk" promedia lunes 00:00 - domingo 23:59; fila más reciente es semana actual incompleta.
			// LIMITE 500.000 FILAS: UI y API rechazan parámetros históricos que generan más de 500K filas.
			// Puede ocurrir con historyRow:"day" y un historyPeriod largo, p. ej. 365 días x 1400 productos.
			// Si lo necesitas, descarga un archivo por categoría de unos cientos de productos.
		"timezone"	: "America/Los_Angeles",  // (opcional, predeterminado "UTC") ruta de Linux /usr/share/zoneinfo
			// Los espacios se convierten en guiones bajos.
			// Zona horaria solo sirve si history* usa períodos de calendario (para calcular medianoche).
			// UI usa zona horaria del usuario; API no tiene ajuste y debe recibirla en solicitud.
		// ========== COLUMNAS: ==========
		// Las variables column* determinan columnas del archivo (consulta el formulario Export para detalles)
		// Predeterminado 0 (no incluir), salvo Code.
		"columnCode"		: 1,  // Esta columna no se puede quitar: siempre incluye REF-CODE.
		"columnName"		: 1,  // Nombre de producto
		"columnCategories"	: 1,  // Categorías del producto ("Category 1; Category 2" en una celda)
		"columnComments"	: 1,  // Comentarios de producto
		"columnCreated"		: 1,  // Fecha de creación YYYY/MM/DD (en nuestro sistema)
		"columnCustom"		: 1,  // Campos personalizados (una columna por cada variable única entre productos)
		"columnPrice"		: 1,  // Precio del producto en moneda solicitada (NO en su moneda original)
		"columnCost"		: 1,  // Coste del producto (en ...)
		"columnMargin"		: 1,  // Porcentaje de margen basado en precio y coste
		"columnRank"		: 1,  // Mi posición
		"columnInRank"		: 1,  // Mi posición entre los que tienen existencias
		"columnMyWebsite"	: 1,  // URL de mi sitio web
		"columnReprice"		: 1,  // Importe de repricing (en ...)
		"columnRepricingRule"	: 1,  // Nombre de regla de repricing
		"columnRecommended"	: 1,  // Precio recomendado (consulta ayuda en Export)
		"columnCompUrls"	: 1,  // URL de competidores (una por columna)
		"columnCompUrlsJoin"	: 1,  // URL de competidores (separadas por espacios en una celda)
		"columnCompMinMaxAvg"	: 1,  // Añade 3 columnas: Min/Max/Media de competidores
		"columnInCompMinMaxAvg"	: 1,  // Añade 3 columnas: Min/Max/Media de competidores CON STOCK
		"columnCompPrice"	: 1,  // Una columna por competidor con su precio (en ...)
		"columnCompStock"	: 1,  // Una columna por competidor con stock (123|IN|OUT)
		"columnCompSales"	: 1,  // Una columna por competidor con ventas/semana
		"columnCompRank"	: 1,  // Una columna por competidor con su posición entre todos (incluido tu)
		"columnCompInRank"	: 1,  // Una columna por competidor con su posición entre competidores CON STOCK (incluido tu)
		// ========== PARAMETROS AVANZADOS OCULTOS: ==========
		// También tenemos opciones no oficiales, poco documentadas; algunas las usa "pricezag_backup".
		"originalCurrencies"	: 1,  // En lugar de convertir importes en números en moneda elegida, pone texto con moneda original ("123.90 USD")
		"keepUrlLabels"		: 1,  // Normalmente quitamos etiquetas de las URL; esto las conserva (para copias de seguridad).
		"csvSeparator"		: ";",  // Para usar en CSV otro separador diferente de coma o tabulador.
		"csvNoQuote"		: 1,  // Impide comillas (") en CSV. Puede producir formato invalido.
	}
] }
// Ejemplo sencillo para descargar una copia CSV:
// curl --connect-timeout 15 --max-time 600 --retry 2 -X POST 'https://pricezag.com/api/v3/MYAPIKEY' -d '{"actions":[{"a":"spreadsheetDownload","preset":"pricezag_backup"}]}' -o pricezag-backup-20241225.csv

{ "actions" : [
	{
		"a"		: "spreadsheetPresetEdit",
		"preset"	: "Some Preset Name",  // Nombre actual del ajuste
		"newName"	: "The Renamed Preset",  // Renombrar este ajuste
		"delete"	: 1,  // Borra ese "preset" de la cuenta
		// NOTA: no se puede borrar un ajuste usado en un auto-export (error).
		// Borra antes los auto-exports programados (ver Export).
	}
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "spreadsheetPresetEdit",
			"ok"	: 1,
		},
		...
	]
}

{ "actions" : [
	{
		"a"			: "spreadsheetAutoCreate",
		"preset"		: "The Preset Name",
		"email"			: "john@example.net",
		"currency"		: "USD",  // (opcional) Valor predeterminado "preset": usa moneda del preset
		"attach"		: "link",  // (opcional, predeterminado "attach") "attach" para adjunto, "link" para enlace alojado
		"everyMonday"		: 1,  // Enviar hoja todos los lunes
		"everyTuesday"		: 1,  // ... y así todos los días hasta "everySunday"
		"everyMonthDay1"	: 15,  // Enviar cada día 15 del mes
		"everyMonthDay2"	: 21,  // ... y también cada día 21
		"everyMonthDay3"	: "last",  // ... y el último día de cada mes
			// everyMonthDay* de 0 a 9, máximo 10 días del mes
		"time"			: "3:59pm",  // "15.59" también sirve y equivale a "3:59pm". "0:9", "0.09", "00:09", "0:09am" son equivalentes.
		"timezone"		: "America/Los_Angeles",  // (opcional, predeterminado "UTC") ruta de Linux /usr/share/zoneinfo
			// Los espacios de ciudad se convierten en guiones bajos.
	}
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "spreadsheetAutoCreate",
			"ok"	: 1,
			"id"	: "5gwi6fqa",  // ID de referencia de esta exportación automática por si necesitas modificarla más adelante (consulta la acción spreadsheetAutoEdit de abajo)
		},
		...
	]
}

{ "actions" : [
	{
		"a"			: "spreadsheetAutoEdit",
		"id"			: "5gwi6fqa",  // ID de referencia del auto-export a modificar
			// ID devuelto por spreadsheetAutoCreate; también aparece en el titulo de la ventana Edit de auto-export en UI.
		"disabled"		: 1,  // (opcional) 0 para activar un auto-export desactivado
		"delete"		: 1,  // (opcional) Eliminar completamente este auto-export
		// ===== Los siguientes campos (todos opcionales) son iguales a los de la acción spreadsheetAutoCreate de arriba =====
		"preset"		: "The Preset Name",
		"email"			: "john@example.net",
		"currency"		: "USD",
		"attach"		: "link",
		"everyMonday"		: 1,  // ADVERTENCIA: al indicar cualquier variable every*, se borran todas las variables every* anteriores.
		"everyMonthDay1"	: 15,  // Así, si tenias "everyFriday"=1 y asignas "everyMonthDay3", se quitara "everyFriday".
		// ... y así sucesivamente (ver every* en spreadsheetAutoCreate)
		"time"			: "3:59pm",
		"timezone"		: "America/Los_Angeles",
	}
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "spreadsheetAutoEdit",
			"ok"	: 3,  // Número de cambios
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "competitorDeleteAll",
		"domain"	: "competitordomain.com",
		"categories"	: ["The Category 1", "The Category 2"],  // (opcional) Si falta debes usar "allProducts" = 1
		"allProducts"	: 1,  // (opcional) quitar de todos los productos (NO proporcionar "categories")
		// Debes usar "categories" O "allProducts", nunca ambos ni ninguno.
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "competitorDeleteAll",
			"ok"	: 10,  // Número de URL eliminadas
		},
		...
	]
}

{ "actions" : [
	...
	{
		"a"		: "mathEdit",
		"domain"	: "competitordomain.com",
		"clear"		: 1,  // (opcional) Desactivar todos los cálculos de ese dominio (borra ajustes anteriores)
		// Si clear:1, no puedes indicar más campos o habrá error.
		"math"	: [  // Array de bloques matematicos a aplicar
			{  // Objeto bloque matematico; todos los campos opcionales
				"categories"		: ["Category 1", "Category 2"],  // Solo productos de estas categorías
				"theirPriceMin"		: 1234.90,  // Solo si su precio es >= N
				"theirPriceMinCurrency"	: "USD",  // Moneda ("original" = moneda original del sitio)
				"theirPriceMax"		: 1234.90,  // ... <= N
				"theirPriceMaxCurrency"	: "USD",  // Moneda (...)
				"themMeMin"		: -20.00,  // Solo si [ellos - yo] >= N (ver UI)
				"themMeMinCurrency"	: "USD",  // Moneda o "%" de tu propio precio (NO "original")
				"themMeMax"		: -1.5,  // ... <= N
				"themMeMaxCurrency"	: "%",  // Moneda (...)
				"addPre"		: -10.00,  // Importe que se suma antes de multiplicar (negativo para restar)
				"addPreCurrency"	: "USD",  // Moneda ("original" = moneda original del sitio)
				"multiply"		: 1.1,  // Multiplicar por este factor
				"divide"		: 1.1,  // O dividir (no usar ambos)
				"addPost"		: 5.00,  // Importe que se suma tras multiplicar (negativo para restar)
				"addPostCurrency"	: "USD",  // Moneda (...)
				// Parece complicado? Mira el ejemplo sencillo debajo de la respuesta.
			},
			... // Máximo 10 bloques (aplicados por orden)
		],
		// NOTA: aún no se puede modificar un solo campo/bloque. Proporcionar el array "math" sustituye todo.
		// NOTA: un bloque sin multiplicacion/división (ausente o 1) ni addPre/addPost distintos de 0 se ignora;
		// si todos se ignoran, equivale a borrar todos los cálculos con clear:1.
		// En otras palabras, los cálculos deben hacer algo para guardarse.
		// TRUCO: para desactivar temporalmente cálculos de un dominio sin borrarlos,
		// usa categories: ["Some Empty Existing Category"]
	},
	...
] }

{
	...
	"actions" : [
		...
		{
			"a"	: "mathEdit",
			"ok"	: 3,  // Número de bloques matematicos cambiados (quitar o limpiar también cuenta)
		},
		...
	]
}

{ "actions" : [
	{
		"a"		: "mathEdit",
		"domain"	: "amazon.co.uk",
		"math"		: [
			{
				"divide"	: 1.1
			}
		]
	}
] }