PYN-TTHotel Auto Check-in API

Project Description

We are looking for an experienced backend developer to build an automated integration between PYN Booking (Romanian PMS / Channel Manager with Open API) and TTHotel (TTLock hotel system).

The goal is to automatically generate time-limited PIN codes for hotel room access based on reservations received in PYN Booking.

⸻

System Overview

Reservations are created in PYN Booking from multiple sources (Booking.com, Airbnb, website, walk-ins).
When a reservation is created, updated, or cancelled, the system must automatically manage room access via TTHotel API.

⸻

Integration Flow
1. Reservation is created in PYN Booking
2. PYN Booking sends reservation data via webhook or API
3. Middleware service processes the reservation
4. Room is mapped to a smart lock
5. TTHotel API generates a PIN code valid from check-in to check-out
6. PIN code is sent automatically to the guest
7. On reservation update or cancellation, access is updated or revoked

⸻

Required Integrations

PYN Booking
• Webhooks or API endpoints for:
• reservation_created
• reservation_updated
• reservation_cancelled

Required reservation data:
• reservation_id
• room_id or unit_id
• check_in datetime
• check_out datetime
• guest_name
• guest_email
• guest_phone
• reservation_status

⸻

TTHotel (TTLock)
• Use TTHotel Open API
• Required actions:
• create time-limited PIN codes
• update PIN validity
• revoke PIN access on cancellation

⸻

Middleware Responsibilities
• Receive and validate reservation events
• Map rooms to lock IDs
• Calculate access validity windows
• Generate PIN codes via TTHotel API
• Send PIN codes to guests (email required, SMS optional)
• Handle updates and cancellations correctly
• Log events and handle API errors

⸻

Technical Requirements
• Backend development (Node.js, Python, or PHP)
• REST API integration experience
• Secure webhook handling
• Clean, documented code
• Lightweight database for room-lock mapping
• Deployment-ready solution (VPS or cloud)

No frontend or UI is required.

⸻

Deliverables
• Fully functional middleware service
• Working integration with PYN Booking API
• Working integration with TTHotel API
• Configuration and setup documentation
• Basic test cases for create, update, and cancel reservation scenarios

⸻

Important Notes
• The solution must be reusable for future hotels
• Code ownership will belong to us
• Experience with hotel PMS or smart lock systems is a plus