← Connectors

Infor HMS (Direct) Setup

business

Infor HMS (Direct) Setup Guide

Connect PropertyPlex to Infor HMS using the Liaison Databridge interface — event-driven room sync for cloud-hosted HMS.

info How this connector works: Infor HMS pushes room status events (check-in, check-out, housekeeping changes) to PropertyPlex in real time via the Liaison Databridge interface. Rooms are automatically created the first time HMS sends an event for them, with full details including room type, bed configuration, and building.

checklistWhat You'll Need

schedule This setup takes about 15–20 minutes. You'll create a Databridge partner in HMS and configure event subscriptions, then add the connector in PropertyPlex.

Step 1: Create a Databridge Partner in HMS

You need to create a new Databridge partner that PropertyPlex will use to receive events from HMS.

  1. Log in to HMS Web
  2. Go to Administration → Databridge → Databridge Partners
  3. Click the New Record button (or the + icon) to create a new partner
  4. Fill in the partner details:
    • Partner ID: PROPERTYPLEX
    • Description: PropertyPlex Integration
    • Default Property: Your property code (e.g., STONE) — double-click the field to select from the list
    • Authentication Scheme: basic
    • Databridge Login User ID: PROPERTYPLEX
    • Password: Choose a strong password (you'll need this for PropertyPlex)
    • Infor HMS User ID: Your HMS admin user ID
    • Active: Checked
  5. Click Save
warning Important: Make sure the Default Property field is set to your hotel's property code. Without this, HMS won't route events to your subscriptions.

Step 2: Add Event Subscriptions

Now you need to tell HMS which events to send to PropertyPlex. You'll add three subscriptions for room status changes, room moves, and PMS events (check-in/check-out).

  1. On the PROPERTYPLEX partner, click the Subscriptions tab
  2. Click the New Record button to add the first subscription
  3. Add the ROOMSTATUS subscription:
    • Event: ROOMSTATUS
    • Document Type: RoomStatus
    • Enabled: Checked
    • Address: https://prprtyplex.com/api/webhooks/infor (or your PropertyPlex server URL)
    • Special Handling: DefaultMessageHandler/R01/R01/LiaisonStandard
    • Log event messages: Checked
  4. Save, then add the ROOMMOVE subscription:
    • Event: ROOMMOVE
    • Document Type: RoomMove
    • Enabled: Checked
    • Address: https://prprtyplex.com/api/webhooks/infor
    • Special Handling: DefaultMessageHandler/R01/R01/LiaisonStandard
    • Log event messages: Checked
  5. Save, then add the PMSEVENT subscription:
    • Event: PMSEVENT
    • Document Type: Liaison_Event
    • Enabled: Checked
    • Address: https://prprtyplex.com/api/webhooks/infor
    • Special Handling: DefaultMessageHandler/R01/R01/LiaisonEvent
    • Log event messages: Checked
  6. Save, then add the RESERVATIONEVENT subscription:
    • Event: RESERVATIONEVENT
    • Document Type: Liaison_Event
    • Enabled: Checked
    • Address: https://prprtyplex.com/api/webhooks/infor
    • Special Handling: DefaultMessageHandler/R01/R01/LiaisonStandard
    • Log event messages: Checked
  7. Save, then add the WORKORDER subscription:
    • Event: WORKORDER
    • Document Type: Liaison_Event
    • Enabled: Checked
    • Address: https://prprtyplex.com/api/webhooks/infor
    • Special Handling: DefaultMessageHandler/R01/R01/LiaisonStandard
    • Log event messages: Checked
  8. Save all changes
warning The Special Handling field is critical. Without DefaultMessageHandler/R01/R01/LiaisonStandard, HMS will fail to deliver events with a ClassNotFoundException error. You can verify delivery in HMS Web under the event log — check for "Event Distribution" entries for the PROPERTYPLEX partner.

Step 3: Add the Connector in PropertyPlex

  1. In PropertyPlex, go to System Admin → Integrations
  2. Click Add Connector
  3. Select Infor HMS (Direct) from the connector type list
  4. Fill in the fields:
    • HMS Web URL: Your HMS Web address (e.g., https://hmsweb.hms.inforcloudsuite.com)
    • Tenant ID: Your HMS tenant ID (e.g., HOTELNAME_PRD — visible in the HMS login URL)
    • Partner User ID: PROPERTYPLEX (the partner you created in Step 1)
    • Partner Password: The password you set in Step 1
    • HMS Property Code: Your property code (e.g., STONE)
  5. Choose which PropertyPlex property this should connect to
  6. Click Save to activate the connector

Step 4: Populate Your Rooms

Since cloud-hosted HMS uses event-driven sync (not polling), rooms are created automatically when HMS sends status events. To populate all your rooms for the first time:

  1. In HMS Web, go to your Housekeeping or Room Status screen
  2. Change each room's housekeeping status (e.g., mark rooms as Dirty then back to Clean)
  3. Each status change triggers an event that creates the room in PropertyPlex with full details (room type, bed configuration, building)
  4. HMS delivers events approximately one per minute, so ~50 rooms will take about an hour to fully populate
check_circle After initial setup, everything is automatic. Any room status change in HMS will immediately update PropertyPlex. Check-ins set rooms to Occupied, check-outs set rooms to Turning, and housekeeping status changes are reflected in real time.

How Room Statuses Match Up

All statuses are inbound only (HMS → PropertyPlex). Status changes cannot be pushed back to Infor HMS.

HMS Code Shows in PropertyPlex As Confirmed
CLEAN / CL → Ready ✓ Tested
DIRTY / DI → Dirty ✓ Tested
INSPCT → Inspection ✓ Tested
TRNDWN → Turndown ✓ Tested
PICKUP → Pickup ✓ Tested
OCCP / occupiedFlag → Occupied ✓ Tested
OOS / OO → Out of Order ✓ Tested
warning Inbound only: PropertyPlex receives all status changes from Infor HMS but cannot push changes back. Infor cloud HMS does not expose an inbound API for status updates. Staff should update room statuses in Infor HMS directly for changes to propagate to booking channels.

What Gets Synced

meeting_room Room Status (HMS → PropertyPlex)

Housekeeping status changes in HMS automatically update PropertyPlex in real time via ROOMSTATUS events.

swap_horiz Room Moves (HMS → PropertyPlex)

When a guest is moved to a different room in HMS, the old room is set to Turning and the new room to Occupied.

login Check-In / Check-Out (HMS → PropertyPlex)

Guest check-ins set rooms to Occupied with guest name. Check-outs set rooms to Turning and clear guest info.

auto_awesome Auto Room Creation

Rooms are automatically created in PropertyPlex the first time HMS sends an event, with room type, bed type, and building info.

build Work Orders (HMS → PropertyPlex)

Work orders created in HMS are automatically imported into PropertyPlex with title, room assignment, priority, and due dates.

inventory Inventory Changes (HMS → PropertyPlex)

Room inventory changes (out of order, out of inventory) are synced via PMSEVENT with room counts per type and property-wide totals.

warning Inbound only. This connector is read-only — data flows from HMS to PropertyPlex but not back. Room status changes made in PropertyPlex will not be pushed to HMS.

Housekeeping Workflow

Since this connector is inbound-only, room status changes must originate from HMS to appear in PropertyPlex. There are two ways housekeepers can update room status:

Option 1: Phone System (PBX)

Many hotels have a PBX integration where housekeepers dial a code from the room phone (e.g., *6) to mark the room clean. This triggers a status change in HMS, which pushes a webhook to PropertyPlex. The flow is:

Housekeeper dials code → PBX notifies HMS → HMS pushes webhook → PropertyPlex updates

The housekeeper only does it once — PropertyPlex picks it up automatically.

Option 2: Manual Update in HMS

A supervisor or head of housekeeping updates the room status directly in Infor HMS Web. The change pushes to PropertyPlex automatically via webhook.

info Avoiding double entry: With either method, staff only need to update the status once (in HMS or via the phone system). PropertyPlex receives the change automatically. There is no need to update both systems separately.

Assumed Status Flow

Based on Infor HMS status codes, the expected housekeeping flow is:

DIRTY → INSPCT → CLEAN

This assumes INSPCT means "awaiting inspection." This will be verified with live testing when the property reopens. If the flow is different, the status mapping can be adjusted without code changes.

info Event data from HMS includes: Room number, room type code, bed configuration (1 King, 2 Queens, etc.), building/wing, smoking preference, suite flag, room attributes (views, accessibility, etc.).

Verifying the Connection

  1. In HMS Web, change any room's housekeeping status (e.g., mark a room Dirty)
  2. Check the HMS event log: go to Administration → Databridge — look for "Event Distribution" entries for the PROPERTYPLEX partner with status Completed
  3. In PropertyPlex, check the connector's Sync Log in System Admin > Integrations — you should see a webhook_room_status entry
  4. Check the Hospitality dashboard — the room card should appear with the updated status

Something Not Working?

error_outline Events show "Failed" with ClassNotFoundException in HMS event log

The Special Handling field is missing or incorrect on the subscription. Set it to DefaultMessageHandler/R01/R01/LiaisonStandard for all three subscriptions (ROOMSTATUS, ROOMMOVE, PMSEVENT). This tells HMS which message builder class to use for formatting the event.

error_outline HMS keeps retrying the same event over and over

HMS expects a SOAP-formatted acknowledgment response. If your PropertyPlex server returns a non-SOAP response, HMS won't mark the delivery as complete and will keep retrying. Make sure your PropertyPlex server is up to date.

error_outline No events appear in HMS event log for PROPERTYPLEX

Check that the Default Property is set on the PROPERTYPLEX partner record (Record View tab). Without a property assignment, HMS won't route events to the partner's subscriptions.

error_outline Events arrive but rooms aren't created

Check the PropertyPlex connector sync log for details. The event XML format may not be recognized. Make sure the connector is active and the PropertyPlex property is correctly linked to the connector.

error_outline "Webhook-only mode" message in sync log

This is normal for cloud-hosted HMS. Cloud HMS does not expose query APIs (SOAP, Databridge) to external systems. The connector runs in webhook-only mode where HMS pushes events to PropertyPlex rather than PropertyPlex pulling data from HMS.

error_outline Only some rooms are showing up

Rooms are only created when HMS sends an event for them. To populate all rooms, you need to trigger a status change for each room in HMS (e.g., mark dirty then clean). HMS delivers events at approximately one per minute.

Technical Details

architecture How It Works

Infor HMS uses the Liaison Databridge messaging system. When a room status changes, HMS creates a Databridge Event, then distributes it to all subscribed partners. HMS posts SOAP 1.2 XML with WS-Security authentication headers to the subscription address.

The XML payload uses the http://schema.softbrands.com/Liaison/event/1 namespace with a Liaison_RoomStatus root element containing room details (ID, type, status, bed configuration, building, attributes).

PropertyPlex's webhook endpoint at /api/webhooks/infor receives these SOAP messages, parses the room data, and creates or updates rooms in the database. It responds with a SOAP acknowledgment so HMS marks the delivery as complete.

dns HMS Event Types

ROOMSTATUS — Fired when a room's housekeeping status changes (CLEAN, DIRTY, INSPCT, TRNDWN, PICKUP, OOS). Includes full room details, bed configuration, and building. Document Type: RoomStatus.

ROOMMOVE — Fired when a guest is moved from one room to another. Includes source and destination room numbers. Document Type: RoomMove.

PMSEVENT — Fired for inventory changes (rooms out of order/inventory counts). Includes room type, date ranges, and availability counts. Document Type: Liaison_Event.

RESERVATIONEVENT — Fired when reservations are created, modified, or cancelled. Includes guest information and dates. Document Type: Liaison_Event.

WORKORDER — Fired when a maintenance work order is created or updated in HMS. Includes title, room, reason code, department, dates, and priority. Auto-creates work orders in PropertyPlex. Document Type: Liaison_Event. Uses ProcessMaintenanceOrder BOD format.

arrow_back Back to Connectors