Static data
Static data endpoints configure which hotels you operate on Nuitee Cloud and their room and rate catalog before you send daily ARI.
Endpoints
| Method | Path | Purpose |
|---|---|---|
| POST | /push/hotels | Create or update hotels |
| POST | /push/products | Create or update rooms and rate plans |
| POST | /push/taxes | Create or update tax configuration |
| POST | /push/getHotels | Read back hotels by hotelId (platform — confirm availability) |
| POST | /push/getRoomRateMappings | Read back room/rate mappings (platform — confirm availability) |
| POST | /push/getTaxes | Read back tax configuration |
Prerequisites
- Valid API key (
x-api-key) on every request - Room type names must exist in Nuitee Cloud reference data (
static_room_type) - Meal plan codes must exist in reference data (
static_meal_plan) when sent on products
Contact onboarding to add new room types or meal plans.
Order of operations
Always push hotels before products, and products before taxes. Products require an existing hotelId mapping; otherwise you receive Hotel ID is not found. Product-scoped taxes require the roomId and rateId mappings created by /push/products.
sequenceDiagram participant You participant API as ARI gateway You->>API: POST /push/hotels Note over API: property + hotelId mapping You->>API: POST /push/products Note over API: rooms, rate plans, roomId/rateId mappings You->>API: POST /push/taxes Note over API: property-level and product-scoped taxes
ID model
You send supplier codes only:
| Field | Your system | Nuitee Cloud |
|---|---|---|
hotelId | Property code | Mapped to internal property |
roomId | Room code | Mapped per hotel |
rateId | Rate plan code | Mapped per hotel |
Use the same roomId and rateId in /push/products and /push/ari.
Common mistakes
| Mistake | Result |
|---|---|
| Products before hotels | 400 — Hotel ID is not found |
minChildAge: 0 or maxChildAge: 0 on hotels | Validation error — use positive values |
| More than 500 hotels in one request | 400 — split the batch |
Invalid roomType | RoomType is not valid |
| Product-scoped taxes before products | 400 — room id not found or rate id not found |