R2 Connect API
Catálogo
Todo lo que el negocio vende: habitaciones, platillos, productos y experiencias, con su precio base.
GET/itemsrequiere read:items
En R2 todo lo vendible es un artículo de catálogo, sin importar el giro. Lo que distingue una habitación de un platillo es su categoría y su tipo de producto, no una tabla distinta.
Campos#
| Campo | Tipo | Descripción |
|---|---|---|
| name · description | string | Nombre y descripción del artículo. |
| sku | string | Clave interna del negocio, si la definió. |
| category_id · category_name | string | Categoría a la que pertenece. |
| product_type | string | Naturaleza del artículo: room, dish, product, tour, entre otros. |
| base_price | number | Precio de lista, antes de reglas de precio dinámico. |
| currency | string | Moneda del negocio. |
| status | string | Si el artículo está activo. |
El precio base no siempre es el precio cobrado
R2 aplica reglas de precio que dependen de la fecha, la temporada, el canal o el plan tarifario. Para saber cuánto se cobró realmente, lee el unit_price del renglón de la orden, no el base_price del catálogo.
Ejemplo#
json
{
"data": [
{
"id": "c31ka9df02mz",
"slug": "lodge-104",
"name": "Lodge 104",
"description": "Cabaña con vista al mar, cama king.",
"sku": "LDG-104",
"category_id": "cat_8fk2",
"category_name": "Lodge",
"product_type": "room",
"base_price": 1800,
"currency": "MXN",
"status": "active"
}
],
"pagination": { "cursor": null, "has_more": false }
}