Skip to main content
POST
Crear o actualizar un producto

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.

Body

application/json

sku, name y price son obligatorios: este cuerpo puede crear el producto y son las tres columnas sin valor por defecto. 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
required

Identificador del producto en tu sistema. Único dentro del tenant; es la identidad con la que el upsert resuelve.

Required string length: 1 - 255
name
string
required

Nombre del producto, hasta 500 caracteres.

Required string length: 1 - 500
price
number
required

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

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

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

Maximum string length: 5000
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 creado o actualizado.

ok
boolean
required
id
string<uuid>
required

ID del producto en Revem. Guárdalo: es estable aunque cambie el SKU.

created
boolean
required

true si se creó el producto, false si se actualizó uno existente.

warnings
string[]
required

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