Alya Hotel System — Documentation

Les 4 documentations

Quatre livrables pour les agences qui intègrent le plugin. Pas un site d’aide voyageur.

Aperçu

Identité produit, architecture et faits vérifiés.

Produit

Les cartes mènent à la section correspondante. Les statuts sont des preuves, pas des notes marketing.

Ce n’est pas un PMS. Pas de rôles Hôtel Manager / Réception / Comptable / Corporate.

Architecture cible

Thème et connecteur actuels versus cibles. Les cibles restent PLANNED / FUTURE.

Les cibles sont une présentation documentation. Elles ne remplacent pas l’implémentation live.

Hôtels

Parcours interactif. Ouvrez une étape pour l’évidence. Le paiement n’a pas été soumis.

Recherche Vérifié en production

Ce que fait l’utilisateur Traveler types destination, dates, occupancy on the homepage Hôtels tab or /hotels/.

Côté technique Shortcodes [alya_unified_search] / [alya_hotel_search]. Autocomplete then search.

REST GET /alya/v1/places then GET /alya/v1/place-details

LiteAPI GET /data/places and place details

Base de données None required for autocomplete

Permissions Public wp_rest nonce

Limites Chatbot concierge is a LiteAPI widget; bridge to Alya checkout is UNKNOWN.

↓

Résultats Vérifié en production

Ce que fait l’utilisateur Sees hotel cards, Favori, Comparer, map toggle. Live: Paris 20–22 Sep 2026, ~30 hotels.

Côté technique alya-hotel.js. Favori/Comparer = localStorage, not LiteAPI CRM.

REST GET /alya/v1/search (40/600s)

LiteAPI GET /data/hotels

Base de données Hotel cache possible (alya_hs_hotels)

Permissions Public nonce

Limites Full filter panel PARTIAL this pass. Copy: selling = net + agency margin, no 2nd WP markup.

↓

Fiche hôtel Vérifié en production

Ce que fait l’utilisateur Opens B&B HOTEL Paris 17 Batignolles on /hotel-contract-system/?hotel_id=lp1ea94.

Côté technique [alya_hotel_details]. Slug avoids Traveler /hotel/ CPT.

REST GET /alya/v1/hotel-details, GET /alya/v1/reviews

LiteAPI GET /data/hotel and reviews

Base de données Hotel cache possible

Permissions Public nonce. API key never in the browser.

Limites Some room types showed no offers for those dates.

↓

Tarifs Vérifié code + live

Ce que fait l’utilisateur Compares rate plans, cancellation, price. Live: 6 offers, Réserver.

Côté technique PricingEngine injects LiteAPI margin % (live 10%, overlay 0, cap 90).

REST POST /alya/v1/rates (20/600s)

LiteAPI POST /hotels/rates

Base de données None until prebook

Permissions Public nonce

Limites Min-rates flag default OFF. Not a PMS room inventory.

Voir la capture Available rooms / rate plans Capture réelle

↓

Checkout Vérifié en production

Ce que fait l’utilisateur Fills holder + guest on /checkout-hotel/. Not WooCommerce checkout.

Côté technique [alya_hotel_checkout]. Holder, guest room 1, requests, Vérifier le tarif.

REST POST /alya/v1/prebook (next step)

LiteAPI Not yet; form is local until verify.

Base de données None until prebook

Permissions Public nonce

Limites @example.com refused by Stripe copy. Cards not stored on WordPress.

↓

Prebook Vérifié en production

Ce que fait l’utilisateur Locks the rate. Live: 213.67 EUR, twin, non-refundable, 20–22 Sep 2026.

Côté technique Server calls LiteAPI prebook with usePaymentSdk. Returns secretKey for the widget.

REST POST /alya/v1/prebook

LiteAPI POST /rates/prebook

Base de données Prebook CPT/index possible; no bookingId yet

Permissions Public nonce

Limites Prebook is not a confirmed booking. publishableKey often absent from prebook (CONFIGURATION REQUIRED).

↓

Paiement Partiel

Ce que fait l’utilisateur Sees Stripe Payment SDK: Pay / Google Pay READY.

Côté technique Nuitee merchant of record. Front never stores cards. transactionId required for book.

REST POST /alya/v1/book after TRANSACTION_ID (not called this audit)

LiteAPI Payment SDK then POST /rates/book payment.method=TRANSACTION_ID

Base de données alya_hs_payments after a successful book

Permissions Public nonce

Limites Payment submission not performed. Google Pay completion UNKNOWN.

Voir la capture Payment interface Capture réelle

↓

Réservation Accès requis

Ce que fait l’utilisateur Would submit Pay then receive a supplier bookingId.

Côté technique WP injects TRANSACTION_ID. Public REST rejects agency methods.

REST POST /alya/v1/book (10/600s)

LiteAPI POST /rates/book

Base de données CPT alya_booking confirmed + booking_index

Permissions Public nonce

Limites bookingId not generated in this audit. REQUIRES AUTHORIZED TEST.

Capture requise

↓

Confirmation Accès requis

Ce que fait l’utilisateur Would land on confirmation shortcode page.

Côté technique [alya_hotel_confirmation]. GET booking by id.

REST GET /alya/v1/booking/{id}

LiteAPI GET /bookings/{bookingId}

Base de données CPT alya_booking

Permissions Public nonce

Limites NOT VERIFIED IN THIS AUDIT. SCREENSHOT REQUIRED.

Capture requise

↓

Voucher Accès requis

Ce que fait l’utilisateur Would download/view a local voucher PDF.

Côté technique [alya_hotel_voucher] + Documents. QR NOT FOUND. Dompdf optional.

REST Staff: POST /alya/v1/documents/issue

LiteAPI None for the local PDF

Base de données alya_hs_documents

Permissions Traveler after book; staff issue documents

Limites Voucher not generated in this audit. SCREENSHOT REQUIRED.

Capture requise

Vols

Interface live. Les offres de ce passage n’ont pas abouti (nonce expiré).

Recherche Vérifié en production

Ce que fait l’utilisateur IATA form on /flights/: one-way / round-trip, dates, passengers.

Côté technique [alya_flight_booking] + alya-flights.js

REST GET /alya/v1/flights/airports (30/600s)

Limites Live UI confirmed 30 Aug 2026.

→

Offres Vérifié en production

Ce que fait l’utilisateur Would see fare offers after a valid search.

Côté technique POST /alya/v1/flights/search (10/600s)

REST POST /alya/v1/flights/search

Limites ALG–CDG 20–27 Sep 2026: “Session de page expirée. Rechargez la page puis réessayez.” Stale wp_rest nonce. Successful offers: SCREENSHOT REQUIRED.

→

Vérification Vérifié dans le code

Ce que fait l’utilisateur Would lock/verify the selected offer.

Côté technique FlightVerifyService

REST POST /alya/v1/flights/verify (15/600s)

Limites NOT VERIFIED IN THIS AUDIT. SCREENSHOT REQUIRED.

Capture requise

→

Acceptation du prix Vérifié dans le code

Ce que fait l’utilisateur Would accept the verified price.

Côté technique alya-flights.js

REST POST /alya/v1/flights/verify/accept

Limites SCREENSHOT REQUIRED.

Capture requise

→

Extras / bagages Vérifié dans le code

Ce que fait l’utilisateur Would attach extras before book.

Côté technique Prebook services only. Post-book extras NOT FOUND.

REST GET/POST /alya/v1/flights/prebook/{id}/services

Limites Post-book extras NOT FOUND. SCREENSHOT REQUIRED.

Capture requise

→

Prebook Vérifié dans le code

Ce que fait l’utilisateur Would lock the itinerary and mount Payment SDK.

Côté technique usePaymentSdk: true

REST POST /alya/v1/flights/prebook (8/600s)

Limites SCREENSHOT REQUIRED.

Capture requise

→

Paiement Accès requis

Ce que fait l’utilisateur Would pay with TRANSACTION_ID. Front never sends transactionId.

Côté technique Same Stripe Payment SDK pattern as hotels.

REST POST /alya/v1/flights/book after SDK

Limites Live flight pay NOT VERIFIED IN THIS AUDIT.

Capture requise

→

Réservation Accès requis

Ce que fait l’utilisateur Would receive a flight booking id.

Côté technique Server injects TRANSACTION_ID

REST POST /alya/v1/flights/book

Limites SCREENSHOT REQUIRED.

Capture requise

→

Confirmation / ICS Vérifié dans le code

Ce que fait l’utilisateur Would see itinerary. ICS exists in CalendarLinks.php.

Côté technique CalendarLinks VERIFIED IN CODE, no live screenshot

REST confirmation / itinerary endpoints

Limites SCREENSHOT REQUIRED. PUT booking = cancel, not amend.

Capture requise

→

CANCELLATION Vérifié dans le code

Ce que fait l’utilisateur Traveler can quote then cancel with session (code).

Côté technique FlightCancel.php + sessionId

REST cancel-quote / cancel

Limites Live cancel NOT VERIFIED IN THIS AUDIT. SCREENSHOT REQUIRED.

Capture requise

Parcours public

Parcours public que l’agence expose. Ce n’est pas un mode d’emploi pour le client final.

Agence

Agency Admin et Agency Staff : opérateurs du plugin. Pas un PMS multi-tenant.

Back office

Cockpit agence. Neuf modules ont des captures réelles. Les autres : écran live non capturé.

Dashboard

Local KPIs. Live: 8/4/1, CA 3446.72 EUR, commission 313.30 EUR, SANDBOX.

#overview · alya_hs_view_dashboard

FrontDashboard DataProvider

Vérifié en production

Voir la capture Dashboard Capture réelle

CRM

Remote + local dossiers. Live: Tous 23 / confirmés 19 / annulés 2. Counts ≠ dashboard.

#crm · alya_hs_view_crm

LiteAPI bookings list + CPT

Vérifié en production

Reservations

Local index. Live: Total 7, confirmées 4.

#bookings · view bookings

alya_hs_booking_index + CPT

Vérifié en production

Pricing

Global margin 10%, overlay 0, cap 90%. No 2nd WP markup.

#pricing · staff pricing caps

PricingEngine + /pricing/margin

Vérifié code + live

Payments

Read-only mirror. 1 row 963.98 EUR, Carte voyageur, succeeded. No WP capture/refund.

#payments · view payments

alya_hs_payments

Vérifié en production

Agencies

1 agency. “Pas un PMS multi-tenant.” No wallet balance UI.

#agencies · manage agencies

alya_hs_agencies

Vérifié en production

Reports

Local SQL. CA 3446.72, commission 313.30, markup 0.00, CSV. Prebook excluded.

#reports · alya_hs_view_reports

ReportsPage

Vérifié en production

Agent Book

Staff hotel funnel. Banner: traveler card / agency card / wallet. Crédit = production only.

#book · edit_alya_bookings

AgentBookingService

Vérifié en production

Voir la capture Agent Book Capture réelle

Webhooks

Inbound Nuitee log. POST /alya/v1/webhooks/nuitee.

#webhooks · view webhooks

WebhookHandler

Vérifié code + live

Flights

Flight ops list. PUT booking = cancel, not amend.

#flights · view bookings

FlightRoutes ops

Vérifié dans le code

Capture requise

Customers

Local upsert from holder email. No LiteAPI customers endpoint. No DELETE in 1.1.10.

#customers · view/edit customers

alya_hs_customers

Vérifié dans le code

Capture requise

Team

WP users mapped to agency 1. No LiteAPI team endpoint.

#team · alya_hs_manage_team

alya_hs_agency_users

Vérifié dans le code

Capture requise

Support

Helpdesk [alya_support]. Guided form, not an AI bot and not LiteAPI concierge.

#support · helpdesk caps

alya_hs_helpdesk_*

Vérifié dans le code

Capture requise

Hotels Cache

Local hotel payload cache. Not a PMS. PARTIEL in cockpit.

#hotels · edit_alya_bookings

HotelCache

Partiel

Capture requise

Destinations

City cache (DZ/FR). Overlay keys. PARTIEL.

#destinations · staff

DestinationCache + cron

Partiel

Capture requise

Documents

Voucher/receipt. QR NOT FOUND. PARTIEL. Voucher not generated this audit.

#documents · view/manage documents

alya_hs_documents

Partiel

Capture requise

Emails

wp_mail local. WhatsApp NOT FOUND. SMTP UNKNOWN.

#emails · alya_hs_send_emails (admin)

alya_hs_email_log

Vérifié dans le code

Capture requise

Logs

API logs with LogRedactor. Cron purge.

#logs · view logs; purge admin

alya_hs_api_logs

Vérifié dans le code

Capture requise

Audit

Staff audit trail.

#audit · alya_hs_view_audit

alya_hs_audit_log

Vérifié dans le code

Capture requise

Alerts

Ops alerts. Optional Slack/Discord. Cooldown 30 min.

#alerts · staff

OpsAlerts cron

Vérifié dans le code

Capture requise

Connector

Nuitee status. Do not screenshot keys.

#nuitee · administrator

NuiteeClient X-API-Key vault

Vérifié dans le code

Capture requise

Settings

Vault. Min-rates OFF. Never screenshot full keys.

#settings · manage_options

ApiKeyVault

Accès requis

Capture requise

Tools

Flush cache, health. WP-CLI health REQUIRES ACCESS. Flush not clicked this pass.

#tools · administrator

ToolsPage /ops/health

Vérifié dans le code

Capture requise

Paiements

WooCommerce n’est pas le moteur de paiement du connecteur.

Widget vérifié en production. Le paiement n’a pas été soumis. bookingId non généré dans cet audit.

Methods not found in the plugin

Google Pay was visible on the hotel widget. Completion UNKNOWN. Apple Pay not observed. Homepage Elementor may market SATIM/CIB — marketing, not this plugin.

Voir la capture Hotel payment widget READY Capture réelle

Voir la capture Payments cockpit (SANDBOX mirror) Capture réelle

Commission

Observé pour la configuration testée à 10 %. Pas un contrat commercial.

Voir la capture Pricing 10% overlay 0 Capture réelle

Voir la capture Reports CA / commission / markup Capture réelle

Wallet

Ne pas appeler le wallet LiteAPI un wallet prépayé Alya.

Voir la capture Agencies — no wallet UI Capture réelle

Connecteur

Nom commercial : Alya Dev Trip Connector. Hop technique LiteAPI. Les endpoints ne sont pas renommés.

Rapports

Agrégats SQL locaux. Pas un export finance du connecteur.

Voir la capture Reports CA / commission / markup Capture réelle

CA 3446.72 EUR · commission 313.30 · markup 0.00 (SANDBOX, 30 Aug 2026). Formula for tested 10%: selling × 10 / 110. Démonstration uniquement

Manuel agence

Manuel pour l’agence qui intègre et opère le plugin. Le parcours public est ce que voient vos clients.

Documentation pour les agences qui intègrent Alya Hotel System. Ce n’est pas un guide pour le voyageur qui réserve, ni un PMS hôtelier.

Intégrer le plugin

1. WordPress — Activer Alya Hotel System. Thème cible : Hoteldz Tech (PLANNED / FUTURE). Chrome live : Traveler 3.2.9. WooCommerce n’est pas le moteur de paiement du connecteur.
2. Fournisseur — Clés LiteAPI dans le vault WordPress (Administrator). Le navigateur n’envoie jamais la clé.
3. Pages — PagesInstaller / wp alya-hs ensure-pages crée les pages manquantes (vols, mes-reservations, compte, FAQ, documentation) sans écraser l’existant. VERIFIED IN CODE.
4. Rôles — Administrator (vault), Agency Admin (ops, pas de vault), Agency Staff (lecture). Hôtel Manager : NOT FOUND.

Opérer (Agency Admin / Staff)

1. Cockpit /function-user-settings/ — dashboard, CRM, réservations, pricing, rapports.

   Voir la capture Dashboard Capture réelle

2. Réserver pour un client (agent book) — cap requise.

   Voir la capture Agent book Capture réelle

3. Marge / commission observée 10 % — pas un contrat.

   Voir la capture Pricing Capture réelle

Parcours public (clients de l’agence)

Ce que voient les voyageurs sur le site de l’agence — pas un mode d’emploi client final.

1. STEP 01 Open homepage Hôtels.

   Voir la capture Hotel tab Capture réelle

2. STEP 02 Search Paris 20–22 Sep 2026, 2 adults. Result: ~30 hotels.

   Voir la capture Results Capture réelle

3. STEP 03 Open fiche hotel_id=lp1ea94.

   Voir la capture Details Capture réelle

4. STEP 04 Checkout holder form.

   Voir la capture Checkout Capture réelle

5. STEP 05 Vérifier le tarif → 213.67 EUR Pay READY. Result: Prebook confirmed. Pay not submitted. API: POST /alya/v1/prebook.

   Voir la capture Prebook Capture réelle

6. STEP 06 Book / confirmation / voucher — REQUIRES AUTHORIZED TEST

Flight booking

1. STEP 01 Open /flights/.

   Voir la capture Flight UI Capture réelle

2. STEP 02 Search ALG–CDG. Result: Session de page expirée.

   Voir la capture Nonce error Capture réelle

3. STEP 03+ Offers → book — SCREENSHOT REQUIRED

Agency Admin / Staff / Administrator

Agency Admin : agent book, CRM, team, pas de vault. Staff : lecture. Administrator : vault. Voir le back office.

Captures

Captures réelles uniquement. Pas de mockups.

Catalogue

Fonctionnalités à présenter à une agence qui intègre. Les filtres n’inventent pas de couverture.

Sécurité

Pas de certifications inventées. Les secrets ne sont jamais affichés.

Thème

Cible visuelle : Hoteldz Tech (PLANNED / FUTURE). Chrome live aujourd’hui : Traveler 3.2.9.

Glossaire

Termes produit. Les noms techniques ne sont pas traduits.

Prebook

Verrouillage tarifaire avant paiement. Ce n’est pas un bookingId.

bookingId

Identifiant fournisseur LiteAPI après book réussi.

TRANSACTION_ID

TRANSACTION_ID — identifiant Payment SDK, jamais envoyé par le navigateur vers LiteAPI.

WALLET

WALLET LiteAPI (staff). Pas un ledger prépayé Alya.

Margin

Pourcentage injecté serveur dans le corps tarifs LiteAPI.

LiteAPI

LiteAPI — hop technique d’Alya Dev Trip Connector. Endpoints inchangés.

Alya Dev Trip Connector

Alya Dev Trip Connector — nom commercial du connecteur. Ne renomme pas LiteAPI.

Hoteldz Tech

Hoteldz Tech — direction frontend FUTURE. Pas le thème live.

FAQ

Questions fréquentes tirées des preuves. Pas de fonctionnalités inventées.

Audit

Portail riche en preuves, pas une certification de production.

• Accès requis Hotel Pay → bookingId / confirmation / voucher / my-bookings
• Accès requis Flight offers after nonce reload, then verify → book
• Accès requis Vault screenshot (hints only), WP-CLI health, DNS/SMTP
• Partiel Hotel funnel through prebook/Pay UI only
• Partiel Back office: 9 modules screenshot; remaining LIVE SCREEN NOT CAPTURED
• Démonstration uniquement 110 EUR → 10 EUR commission example (same 10% formula, not a live booking)

Production modifications during the forensic audit: NONE. This shortcode adds a documentation UI only.

Open Gamma-style presentation

Limites

Fondé sur les preuves. Pas une certification de production.

• Accès requis Hotel Pay → bookingId / voucher
• Accès requis Flight offers after nonce reload
• Non trouvé PMS, extra hotel roles, CIB / SATIM / Edahabia / PayPal / chèque / cash in plugin
• Non trouvé Alya prepaid wallet (LiteAPI WALLET only)
• Planifié / futur Hoteldz Tech theme · Alya Dev Trip Connector branding