Skip to main content
PATCH
Actualizar un producto por SKU

Authorizations

Authorization
string
header
required

La API key de tu organización, con la forma rvm_<prefijo>.<secreto>, enviada como Authorization: Bearer rvm_…. Revem la emite y sólo se muestra una vez; si la pierdes se reemplaza, no se recupera.

Path Parameters

sku
string
required

SKU del producto en tu sistema.

Required string length: 1 - 255

Body

application/json

Todos los campos son opcionales y una clave ausente deja el valor guardado como está. Los atributos personalizados van al mismo nivel que los campos fijos, identificados por su nombre en Revem (sin distinguir mayúsculas). Tienen que estar definidos para productos: un nombre sin definición responde 422 con la lista en unknownAttributes, y un valor que no calza con el tipo declarado —o una opción que no está en un select— también responde 422. Un null quita el atributo. Hasta 100 atributos por solicitud.

sku
string

Identificador del producto en tu sistema. Único dentro del tenant; es la identidad con la que el upsert resuelve. Opcional: reemplaza el SKU actual. Si ya pertenece a otro producto responde 409.

Required string length: 1 - 255
name
string

Nombre del producto, hasta 500 caracteres.

Required string length: 1 - 500
description
string

Descripción, hasta 5000 caracteres. Una cadena vacía no borra la descripción guardada.

Maximum string length: 5000
price
number

Precio, hasta dos decimales. Un tercer decimal responde 400 en vez de truncarse.

Required range: 0 <= x <= 9999999999.99
currency
string

Código de moneda de 3 letras, por ejemplo CLP.

Pattern: ^[A-Za-z]{3}$
billing_frequency
enum<string>

UNIQUE, WEEKLY, MONTHLY, QUARTERLY, SEMI_ANNUAL o ANNUAL. Al crear, si se omite, queda en UNIQUE.

Available options:
UNIQUE,
WEEKLY,
MONTHLY,
QUARTERLY,
SEMI_ANNUAL,
ANNUAL
billing_model
enum<string>

UNIQUE para un cobro único o RECURRENT para uno recurrente.

Available options:
UNIQUE,
RECURRENT
unit_of_measurement
enum<string>

UNIT, HOUR, DAY, MONTH, KG, G, LITER, METER o M2.

Available options:
UNIT,
HOUR,
DAY,
MONTH,
KG,
G,
LITER,
METER,
M2
maximum_percentage_discount
integer

Descuento máximo permitido, entero de 0 a 100.

Required range: 0 <= x <= 100
tax
integer

Impuesto aplicable, entero de 0 a 100.

Required range: 0 <= x <= 100
active
boolean

Si el producto está disponible. Esta API no borra productos: dar de baja es enviar active: false.

media_url
string

Enlace http o https a la imagen. Responde 409 si la administra la integración que importó el producto.

Maximum string length: 2000
external_url
string

Enlace http o https donde se ve o se compra. Responde 409 si la administra la integración que importó el producto.

Maximum string length: 2000

Response

Producto actualizado.

ok
boolean
required
id
string<uuid>
required

ID del producto actualizado.

warnings
string[]
required

Avisos que no impidieron la escritura. Hoy siempre vacío.