stay: a NaptárAI CLI

Szállásadók és ügynökök parancssora a nyilvános API-hoz. Alapértelmezett kimenet magyar; --json gépeknek. Teljes leírás: https://naptarai.hu/dokumentacio/cli

Telepítés

npx naptarai --help
npm i -g naptarai
stay --help

Binárisok: stay és naptarai (ugyanaz a program). Node ≥ 20.

A monorepóban:

pnpm --filter ./apps/cli build
node apps/cli/dist/index.js --help

Bejelentkezés

stay login
stay logout

stay login OAuth eszközfolyamatot indít (POST /device/code, POST /device/token). A böngészőben jóváhagyod; a kulcs ~/.config/naptarai/config.json alá kerül, mód 0600. Ha az eszközvégpont nem válaszol, személyes API-kulcsot kér.

Felülírás:

• NAPTARAI_TOKEN: kulcs, nem kerül fájlba
• NAPTARAI_API_URL vagy --api: alap: https://naptarai.hu/api

OTA- és Channex-jelszót a CLI soha nem tárol.

Parancsok

stay calendar --next 14d [--unit tóparti]
stay bookings --arriving today
stay bookings --departing tomorrow --status CONFIRMED
stay booking <id>
stay revenue --month 2026-08
stay rates set tóparti 2026-09-12:2026-09-15 42000 --min-nights 2
stay block tóparti tomorrow --reason karbantartás
stay unblock tóparti 2026-09-12:2026-09-14
stay channels status
stay messages list
stay properties
stay properties rules get <szálláshely>
stay properties rules set <szálláshely> --instant-book on --allows-pets off
stay properties policy get <szálláshely>
stay properties policy set <szálláshely> MODERATE
stay properties content-status <szálláshely>
stay units
stay units settings get <egység>
stay units settings set <egység> --weekend-rate 45000 --cleaning-fee 15000
stay reservations finance <id>
stay reports summary --by-channel --period month
stay ntak status <szálláshely>
stay ntak log <szálláshely> [--csv|--pdf]
stay ntak resend <szálláshely> <küldés-id>
stay viza status <szálláshely>
stay viza log <szálláshely> [--csv|--pdf]
stay viza resend <szálláshely> <küldés-id>
stay onboarding import <url> [--apply --property <id>]

Minden írás megerősítést kér, hacsak nincs --yes. A pms:write 403 magyarul: Ehhez a művelethez pms:write jogosultság kell.

Kilépési kódok: 0 ok, 1 hiba, 2 használat, 3 hitelesítés.

--lang en angol kimenet. Minden parancsnak van --help.

Nyilvános API

A CLI a /public/v1 PMS felületet hívja (ugyanazok a domain szolgáltatások, mint a bejelentkezett /pms/*). Olvasás: pms:read. Írás: pms:write. Az írások Idempotency-Key fejlécet visznek.

Ha a kulcs tulajdonosa csak egyes szálláshelyekhez fér hozzá, a CLI is csak azokat látja: stay properties a kijelölt házakat listázza, stay calendar --property <id> idegen házra 403-mal áll meg, ugyanazzal a magyar üzenettel, mint a webes felület (Ehhez a szálláshelyhez nincs hozzáférésed.). A CLI nem szűr helyben, a nyilvános API zárja le.

stay messages send szándékosan hibával áll meg: a nyilvános API szálat listáz, küldést nem. Hitelesítés (stay login) a /device/* eszközfolyamattal megy.

Waves 1-9 a nyilvános API-n: units settings a listázási beállítások (hétvégi ár, extra vendég, takarítás, LOS, előfoglalás); properties rules az azonnali foglalás, érkezési ablak és házirend; properties policy a lemondási feltétel; properties content-status hogy a csatorna átveszi-e a címet/fotókat; reservations finance az OTA jutalék, nettó és VCC; reports summary --by-channel --period a csatornánkénti bevétel. NTAK: stay ntak status|log|resend. VIZA: stay viza status|log. Onboarding: stay onboarding import <url> [--apply --property]. Az npm-kiadás (naptarai 0.2.0) a tulajdonos lépése.

English

stay is the command line for the NaptárAI public API (calendar, bookings, rates, channels). Install with npm i -g naptarai, sign in with stay login or set NAPTARAI_TOKEN, add --lang en for English output and --json for machines. Docs: https://naptarai.hu/dokumentacio/cli

Forráskód: https://github.com/norbertlevente/naptarai-cli (a monorepóból szinkronizálva, lásd scripts/export-cli-repo.sh).