Ir al contenido principal

Actualizar las tarifas de sus productos mediante la API (Postman)

En este artículo encontrará los procedimientos a seguir para modificar:

  • el precio base de un producto (precio de compra, precio de venta, IVA), es decir, el precio que se aplica de forma predeterminada durante todo el año

  • sus tarifas de temporada, que sustituyen al precio base durante un período concreto del año (temporada alta, promoción…)

Para saber más sobre las tarifas de temporada, consulte nuestro artículo ✍️ Tarifas de temporada.

Requisitos previos

Antes de empezar, le recomendamos consultar nuestro artículo ✍️ Configurar Postman para sus llamadas a la API.

Necesitará recuperar la siguiente información:

  • Su clave API de Ezus → header x-api-key.

  • Un token válido, obtenido mediante /login y válido durante 12 horas → header Authorization: Bearer …

  • La referencia («Campo API») del o de los productos a modificar.

Las rutas utilizadas funcionan en modo «upsert» = update or insert. Esto significa que si la referencia enviada ya existe, el elemento se actualiza; de lo contrario, se crea.

Cada producto posee una referencia única que corresponde al valor de la columna «Campo API» de su exportación de productos. Es este dato el que permite indicar a Ezus qué producto modificar.

💡 Tenga en cuenta que todos los precios se introducen con Impuestos Incluidos (IVA incluido) y en la divisa del producto. No es posible introducir un precio sin impuestos (base imponible) ni en otra divisa.

Caso 1 — Actualizar el precio base de un producto

Se utiliza la ruta products-upsert, también disponible mediante https://api.ezus.io/#post-products-upsert.

El principio: se envía la referencia del producto + únicamente los campos de precio a cambiar. Toda la demás información relacionada con el producto (título, descripción, categoría…) permanece sin cambios.

Paso 1 — Crear la solicitud

En Postman, cree una nueva solicitud. Elija el método POST e introduzca la URL: https://api.ezus.app/products-upsert

Paso 2 — Rellenar los encabezados (Headers)

En la pestaña Headers, añada tres líneas:

  • x-api-key → su clave API

  • Authorization → Bearer seguido de su token

  • Content-Type → application/json

Paso 3 — Escribir el contenido (Body)

En la pestaña Body, elija raw y luego el formato JSON, y pegue:

{ "reference": "REFERENCIA_DEL_PRODUCTO", "purchase_price": 42, "sales_price": 84, "vat_rate": 20, "vat_regime": "margin" }

Significado de los campos:

  • reference: la referencia del producto («Campo API field»). Obligatorio para apuntar al producto correcto.

  • purchase_price: precio de compra, como número, IVA incluido (p. ej. 42 o 42.50 — punto decimal, sin símbolo €).

  • sales_price: precio de venta, como número, IVA incluido.

  • vat_rate: tipo de IVA en porcentaje (p. ej. 20 para 20 %). Dejado vacío → se aplica el tipo predeterminado de la cuenta.

  • vat_regime: classic (IVA de régimen general), margin (IVA sobre el margen), o none (no aplicable).

💡 Incluya únicamente los campos que desea modificar. Por ejemplo, si solo desea actualizar el precio de venta, envíe únicamente reference y sales_price.

Paso 4 — Enviar y verificar

Haga clic en Send. Una respuesta exitosa se parece a:

{ "error": "false", "message": "ok", "action": "Product successfully updated", "reference": "REFERENCIA_DEL_PRODUCTO" }

A continuación, verifique en Ezus que el precio ha cambiado correctamente en la ficha del producto.

Caso 2 — Crear o actualizar una tarifa de temporada

Para modificar un precio específico durante un período determinado (temporada alta, oferta limitada…), utilice la ruta product-seasons-upsert, también disponible mediante https://api.ezus.io/#post-product-seasons-upsert.

Cada temporada está vinculada a un producto mediante product_reference.

Mismo método que para el Caso 1 (POST + Headers idénticos), con la URL https://api.ezus.app/product-seasons-upsert y este Body:

{ "product_reference": "REFERENCIA_DEL_PRODUCTO", "reference": "REFERENCIA_DE_LA_TEMPORADA", "name": "Temporada alta 2026", "purchase_price": 165.25, "sales_price": 200, "limit_start": "2026-01-01", "limit_end": "2026-01-31", "is_yearly": true }

Significado de los campos:

  • product_reference: referencia del producto en cuestión (obligatorio).

  • reference: referencia única de la temporada. Debe indicarse obligatoriamente si desea actualizar una temporada existente. Si no, Ezus creará automáticamente una nueva temporada.

  • name: nombre de la tarifa de temporada (100 caracteres máx.).

  • purchase_price / sales_price: precio de compra / de venta IVA incluido para el período.

  • limit_start / limit_end: inicio y fin de la temporada, en formato YYYY-MM-DD.

  • is_yearly: indique true si la tarifa se repite cada año, de lo contrario false.

💡 ¿Cómo obtener la referencia única de la temporada?

Primero debe llamar a la API GET /product para el producto en cuestión. La respuesta contiene un array de tarifas, y cada entrada posee su propia referencia. Es este valor el que hay que transmitir como referencia en la API POST /product-seasons-upsert para actualizar una temporada existente.

Actualizar las tarifas de sus productos de forma masiva

Para modificar las tarifas de muchos productos de una vez, puede agrupar una solicitud por producto en una colección y, a continuación, lanzar el Collection Runner:

  • Pase el cursor sobre el nombre de la colección → haga clic en los ··· → Run collection.

  • Verifique que las solicitudes deseadas estén marcadas.

  • Establezca un retardo (Delay) de aproximadamente 200 ms entre las solicitudes.

  • Deje marcada la opción «Stop run if an error occurs»: en caso de error, la ejecución se detiene en la solicitud errónea.

  • Haga clic en Run: cada producto se muestra con un estado Passed o Failed.

💡 Consejo: pruebe siempre una sola solicitud con éxito antes de lanzar un run completo; esto evita enviar decenas de llamadas erróneas.

Resolución de problemas comunes

  • Error 401 / 403: problema de autenticación. Verifique la clave API y el token (sin espacio superfluo). Si el token tiene más de 12 h, regenérelo mediante /login.

  • El precio no ha cambiado: la reference no corresponde a ningún producto existente. Utilice bien el valor de la columna «Campo API».

  • Ha aparecido una tarifa de temporada duplicada: ha utilizado una nueva reference de temporada. Reutilice la misma referencia para actualizar en lugar de crear.

  • Precio rechazado / resultado extraño: introduzca un número (punto decimal, sin símbolo), IVA incluido, en la divisa del producto.

  • Fecha rechazada: respete el formato YYYY-MM-DD (p. ej. 2026-07-01).

¿Ha quedado contestada tu pregunta?