Cancel Policies - Buyers
In the Travelgate Quote (Valuation) response, several fields provide detailed insights. Among them, specific fields offer clear information about cancellation policies, ensuring a precise understanding of available options.
Key Cancellation Policy Fields
-
TIMEZONE
It specifies the timezone in UTC where the cancellation policies apply. Refer to the Metadata documentation for all possible values.tipIf the timezone returned by your Seller is unclear (e.g., if
TimeZone
is set as "Unknown"), we recommend adding a +14-hour offset to prevent unexpected penalties due to timezone differences. -
DEADLINE
The Deadline field in the CancellationPolicies section of the Quote/Valuation response provides precise cancellation deadlines, helping to maintain competitiveness.This field is unambiguous, as it is always expressed in UTC-0 Standard. The date is converted according to the timezone value specified in Metadata.
-
CALCULATED DEADLINE
The CalculatedDeadline field indicates whether the Deadline value originates from the Seller’s response or has been calculated by Travelgate.The table below outlines how cancellation policies are processed based on the timezone specified in Metadata:
Metadata TimeZone HoursBefore Deadline Handling Hotel Local Time Bypass Converted to UTC-0 TimeZone Bypass Converted to UTC-0 Unknown Bypass +14-hour offset added
What Do I Need to Do?
hoursBefore
node (deprecated): Travelgate returns the information exactly as provided by the Seller—no additional hours are added. This logic should be handled on your end.deadline
node: Travelgate returns the calculated deadline based on the table above. Please ensure you use this node.
The HoursBefore
field specified the maximum number of hours before a penalty would apply. To provide more accurate information and maintain competitiveness, we introduced the Deadline
node, which eliminates ambiguity by representing a specific date in UTC-0 Standard.
It is essential to update your logic and discontinue the use of the hoursBefore
node. Instead, use the deadline
node. This update applies to both Hotel-X and Legacy Pull Buyers API.