Inclusion Mapping for RatePlanCodes in Softrip

Inclusion Mapping for RatePlanCodes in Softrip

Overview

This article explains the new inclusion mapping functionality for RatePlanCodes in the Softrip platform, designed to enhance the clarity and usability of rate information for both internal and external users. This feature is a prerequisite for the ID Travel Group go-live and is available on the Next platform.

Purpose

The inclusion mapping feature allows the system to display user-friendly titles and descriptions for rate codes returned from external interfaces (such as HBSI & SynXis). This helps customers and agents understand what each rate includes, rather than relying on cryptic RatePlanCodes.

Background

Previously, all rate code options for each service were displayed as returned from the interface, often using the raw RatePlanCode (e.g., "1NRBF", "1BFCM"). Some codes had mapped inclusions, while others did not, leading to confusion. The new mapping system allows for more descriptive information to be shown, improving the booking experience.

How It Works

Display Logic

  • Mapped RatePlanCodes: If a RatePlanCode is mapped, the system displays a user-friendly title and description instead of the raw code.

  • Unmapped RatePlanCodes: If a RatePlanCode is not mapped:

    • Internal users with a special checkpoint can see the raw RatePlanCode.

    • External users (travel agents, direct customers) will not see unmapped codes.

image-20250923-180733.png

 

Room/Rate Line Item Format

Each Room/Rate line item in the cart is displayed as:

[RoomCategory]~~[RatePlanCode or Title]~~[Nonrefundable]
  • RoomCategory: Name of the room category from the interface.

  • RatePlanCode or Title: The mapped title if available; otherwise, the raw RatePlanCode.

  • Nonrefundable: Appended if the service is non-refundable.

A "Details" link is available for each Room/Rate option, showing a pop-up with more information (title and description) if mapped.

Mapping Structure

Mappings are controlled by a new PromoType: SupplierPromo.PromoType = EXTINC. Each mapping includes:

  • Supplier ID: Relevant supplier.

  • Service ID: Relevant service (supports wildcards).

  • Promo ID: Customer-defined, recommended to standardize.

  • Cost Code: The RatePlanCode(s) being mapped (comma-delimited).

  • Promo Type: Always "EXTINC".

  • Title: Displayed as the Room/Rate title.

  • Description: Displayed in the "Details" pop-up.

image-20250923-180813.png

 

User Experience

Internal Users

  • See all mapped and unmapped RatePlanCodes (if they have the checkpoint).

  • Mapped codes show the title and description.

  • Unmapped codes show the raw RatePlanCode and no description.

External Users

  • Only see mapped RatePlanCodes.

  • Unmapped codes are hidden.

Post-Booking

  • Mapped inclusion data is displayed in the cart and edit item screens.

Data Handling

  • All inclusion mapping data is saved to AdditionalData for use throughout the shopping and booking process.

  • The default service description is [Room Description] - [Rate Plan Code].

  • If mapped, the description uses the mapped title instead of the RatePlanCode.

Acceptance Criteria

  • When shopping for an interface service and the rate code is mapped, the service’s description includes the mapped title.

  • The mapped title and description are added to the service’s AdditionalData for display in the "More details" link.

  • If the rate code is not mapped, the raw RatePlanCode is shown (internal users only).

  • External users do not see unmapped rate codes.

Implementation Notes

  • The mapping system supports wildcards for Service IDs.

  • Promo IDs should follow a standardized naming convention.

  • HTML can be pasted into the Description field if needed.

  • Separate tickets will address document display and additional filtering options.

Example

Mapped RatePlanCode:

  • Title: "Long Stay Offer"

  • Description: "Upgrade on arrival…"

  • Display: "Ambassador Suite Ocean View - Long Stay Offer"

Unmapped RatePlanCode:

  • Title: "MF1" (raw code)

  • Description: (blank)

  • Display: "Deluxe Room with 2 Queen Bed - MF1"

FAQ

Q: Can unmapped RatePlanCodes be displayed to external users?
A: No, only internal users with the checkpoint can see unmapped codes.

Q: Where is the inclusion mapping data stored?
A: In the AdditionalData field for each service.

Q: Can HTML be used in descriptions?
A: Yes, HTML can be pasted directly into the Description field.