๐Ÿงช Experimental KB โ€” Official knowledge hub: community.kaptio.com

59 articles

๐Ÿ”ท

API Connection Timeout Errors

How to troubleshoot and resolve API connection timeout errors when integrating with Kaptio

api โ€ข 3 min read โ€ข Jan 15
api timeout integration
โš™๏ธ

Activating Users in Salesforce Sandbox After Refresh (Removing .invalid Email Suffix)

After a Salesforce sandbox refresh, user email addresses have '.invalid' appended to them. Users cannot log in because verification codes are being sent to the invalid email addresses instead of their

configuration
sandbox user-activation email
๐Ÿ“š

apex heap size error when adding services or promotions to bookings

Knowledge base article

general
kb
๐Ÿ“š

apex heap size too large error during sfi bulk import

Knowledge base article

general
kb
โš™๏ธ

API Booking Error: Issuing Country Cannot Be Null - Incomplete PGI Identity Document Fields

When attempting to book services through third-party supplier APIs, the booking fails with an error message containing 'issuing country cannot be null' or 'identification_document > [issuing country]

configuration
PGI passport identity-document
โš™๏ธ

Auto-generated confirmation documents missing content after payment

When a payment is processed and triggers automatic document generation, the resulting confirmation document may be missing expected content such as booking details, passenger information, or payment s

configuration
documents confirmation auto-generation
โš™๏ธ

Applying per-passenger pricing adjustments for PNR bookings with mixed fares (FOC/paid)

When a PNR with multiple passengers having different pricing conditions (e.g., one Free of Charge, one paid) is imported into Salesforce, the Costings view displays the combined total as a single cost

configuration
PNR costings per-passenger-pricing
๐Ÿ“š

braintree 3ds challenge failures and payment rejections

Knowledge base article

general
kb
โš™๏ธ

Builder Bulk Move Fails When Custom Validation Rule Blocks Items with Closed Inventory

When bulk moving services in the Builder, an error popup appears saying 'This Date is Closed Out' and prevents the line items (including surrounding items) from moving to the correct dates.

configuration
builder bulk-move validation-rule
โš™๏ธ

How to Configure Business Units in Kaptio

Business Units are the foundational organizational structure in Kaptio, representing distinct business entities, brands, or operational divisions. This guide covers setup, configuration, and common issues.

configuration
business-unit organization setup
โš™๏ธ

Configuring Max Unit Occupants for Cruise/Cabin Passenger Allocation

When building packages with cruise cabins, the system only allocates passengers to a single cabin even when multiple cabins are needed. For example, a package search for 4 adults requiring 2 cabins (2

configuration
cruise cabin passenger-allocation
โš™๏ธ

Configuring Service Search Default Filters and Location Pre-population

Users want to control default filter behavior in Service Search, specifically: (1) Having the Internal filter checked by default instead of Live Inventory, and (2) Having the location pre-populated wh

configuration
service-search itinerary-builder filters
๐Ÿ“…

Confirmation status not updating to 'Unconfirmed Amendment' when changing itinerary dates

When using the 'Change Start Date' function on an itinerary, confirmed services were not updating their confirmation status to 'Unconfirmed Amendment' as expected. The services remained showing as 'Co

booking
confirmation-status change-start-date unconfirmed-amendment
โš™๏ธ

Duplicate field name error when creating Sales Invoices due to custom field namespace collision

Customer was unable to create Sales Invoices. The system was throwing a 'duplicate field' error during invoice generation.

configuration
sales-invoice custom-fields namespace
โš™๏ธ

Emails Not Sending in Sandbox Environment

Emails are not being sent from a sandbox or UAT environment. Emails may remain in 'Rendered' status in the email queue, or supplier booking emails do not generate. This commonly occurs after a sandbox

configuration
sandbox email configuration
โš™๏ธ

Enable email sending in Salesforce sandbox environments

Emails are not being sent from sandbox or UAT environments. This commonly occurs after a sandbox refresh or new sandbox creation.

configuration
sandbox email app-settings
๐Ÿ“š

error adding component options after upgrade physicalinventoryselection field re

Knowledge base article

general
kb
โš™๏ธ

Featured Images Appearing Blank After Mass Update

After performing a mass update to the Featured Image field on Content records (via Data Loader or similar tool), the images appear blank in the edit screen and do not display in documents.

configuration
content featured-image content-assignment
๐Ÿ“š

final travel document error null reference in needtoknow controller

Knowledge base article

general
kb
๐Ÿ“š

heap size error when merging amendments

Knowledge base article

general
kb
โš™๏ธ

How Owner ID is assigned during Lead to Trip conversion

Customer wanted to understand how the Owner ID field is determined when converting a Lead to a Trip in Kaptio, and whether there is a way to change the default behavior.

configuration
lead-conversion trip owner-id
โš™๏ธ

How to Add Fields to Price Category View for Service Types

When adding or editing Price Categories (Ticket Types) on Services, certain fields do not appear in the interface even though they have been added to the Price Category page layout in Salesforce Setup

configuration
price-category field-set service-record-type
๐Ÿ”ท

How to auto-assign Room Group IDs (AllocationId) for passengers created via API

When passengers are created via API instead of the Kaptio UI, the KaptioTravel__AllocationId__c (Room Group ID) field is not automatically populated. This means passengers don't get assigned to room g

api
api passengers allocation
โš™๏ธ

How to Auto-Set Gross Invoicing for Travel Agency Accounts

Customer reported that the Gross Invoicing checkbox (KaptioTravel__GrossInvoicing__c) was not being automatically checked when new Travel Agency accounts were created. They believed this used to work

configuration
gross-invoicing account automation
โš™๏ธ

How to Auto-Update Itinerary Item Status When Passenger Information Changes

Customer needed itinerary items to automatically change to 'Unconfirmed Amendment' status when passenger guest information (PGI) is updated, so suppliers can be re-confirmed with the new passenger det

configuration
flow passenger confirmation-status
โš™๏ธ

How to Connect a New or Refreshed Sandbox to KTAPI

When customers create new sandboxes or refresh existing ones, the KTAPI connection is lost and must be reconfigured. The sandbox needs to be connected to KTAPI with all external supplier gateways conf

configuration
sandbox KTAPI configuration
๐Ÿ”Œ

How to Connect KTAPI to a Salesforce Sandbox

Customer needed to connect KTAPI to Salesforce sandbox environments. The connection process was blocked by MFA/authenticator app verification requirements on the admin user account.

integration
KTAPI sandbox authentication
โš™๏ธ

How to Customize the Payments Related List Columns on Itinerary

Users want to see additional fields or different columns in the Payments related list that appears on Itinerary records. By default, the related list may not show all the information users need to vie

configuration
payments page-layout itinerary
โš™๏ธ

How to configure Max Unit Occupants for Vehicle UOM services

Services with UOM set to 'vehicle(s)' were not creating Itinerary Services or Itinerary Price Lines when a room occupancy was set. The customer had set Max Room Occupants but the services still weren'

configuration
vehicle UOM price-category
โš™๏ธ

How to Enable Emails in Sandbox Environments

Emails cannot be sent from sandbox or UAT environments. Email records may show status 'Rendered' but never send, or errors may include 'Failed to resolve' DNS errors pointing to the courier staging AP

configuration
sandbox email configuration
โš™๏ธ

How to Hide Services with Specific Inventory Statuses from Service Search

Services with specific inventory statuses (such as 'Closed' or 'Sold Out') continue to appear in Service Search results, even though users expect these services to be hidden based on their inventory s

configuration
service-search inventory-status kaptio-settings
โšก

How to identify and handle Salesforce platform outages affecting Kaptio

Customer reported being unable to use Kaptio - users could not add services or access itinerary functionality. The issue was described as a BLOCKER with the system being completely unusable.

performance
salesforce-outage platform-incident status-page
โš™๏ธ

How to resolve Builder FLS permission errors after Kaptio package upgrade

Users cannot access the Itinerary Builder screen after a Kaptio package upgrade. Some users receive a Field Level Security (FLS) error when trying to open itineraries in the Builder tab, while other u

configuration
permissions FLS builder
โš™๏ธ

How to resolve 'Insufficient Permissions' errors when moving services or adding packages

Users receive 'Insufficient permissions: secure query included inaccessible field' errors when attempting to bulk move services or add packages to itineraries. This blocks users from completing these

configuration
permissions FLS field-level-security
โš™๏ธ

How to resolve 'Required fields are missing: LastName' error when batch deleting Passenger Itinerary Unit Assignments

When batch deleting Passenger Itinerary Unit Assignment (PIUA) records, the operation fails with error: 'Required fields are missing: [KaptioTravel__LastName__c]'. This typically occurs when customers

configuration
PIUA batch-delete triggers
๐Ÿ””

How to Set Up Automated Payment Reminder Emails

Customer asked if Kaptio has built-in automated payment reminders and pointed to visible payment reminder settings in the system, asking what they do.

notifications
payment-reminders flows email-templates
๐Ÿ“š

how to track cancelled service values only for booking stage cancellations

Knowledge base article

general
kb
๐Ÿ”ท

How to Trigger Itinerary Recalculation Programmatically via Apex

Customer needed to trigger itinerary price recalculation from custom Apex code and wanted to know how to detect when the recalculation completes.

api
apex recalculation itinerary
โš™๏ธ

Itinerary item not appearing on confirmation document - IsVisible field set to false

Customer reported that an itinerary item/service was not appearing on the booking confirmation document, even though the item existed on the itinerary.

configuration
document-generation confirmation isvisible
๐Ÿ“š

how to use the bulk manager for mass itinerary operations

Knowledge base article

general
kb
๐Ÿ“š

kaptiopay payment confirmation dialog not appearing for internal users

Knowledge base article

general
kb
๐Ÿ”ท

KTAPI Connection Error When Adding Services to Itinerary - New Account Sync Timing

Customer reported KTAPI connection errors and errors when saving added Services in Itinerary. The issue occurred in a sandbox environment and was reproduced across multiple environments.

api
KTAPI sync pricing
โš™๏ธ

KTAPI Endpoint Misconfiguration: Sandbox Pointing to Production Environment

Users encounter errors when adding services, cabins, or costing items in a Salesforce sandbox environment. Error messages include 'item_option_id(s) do not exist', 'insufficient access rights on cross

configuration
ktapi sandbox configuration
๐Ÿ’ณ

Missing Payment Button Due to Invalid Braintree Credentials

Customer reported the 'Continue to Payment' button was missing from the Billing Address page, with an 'Authentication credentials are invalid' error appearing in the console.

payments
braintree payment-gateway configuration
โš™๏ธ

Package Components Empty in Costings - Lightning Page Configuration Required

Customer reported that when selecting a package in costings, it appears empty even though components (like hotels) have been added to the package.

configuration
packages lightning components
โš™๏ธ

Package 'No Main Component Selected' Warning Messages After Release Update

After a Kaptio release update, customers see warning triangle icons in the Package Components tab with the message 'Package has no main component selected'. This affects all packages that existed befo

configuration
packages cancellation-engine components
๐Ÿ“š

passenger allocations limited to 1 on transfers with vehicle s uom

Knowledge base article

general
kb
๐Ÿ“š

pnr import error airport code not found in system

Knowledge base article

general
kb
๐Ÿ”ท

Price incorrect after updating costing quantity with RequiredCostingsManagement.updateCostingQuantity

Customer reported that after using RequiredCostingsManagement.updateCostingQuantity to update costing quantity programmatically, the price became incorrect even though the quantity update appeared to

api
RequiredCostingsManagement updateCostingQuantity costing
๐Ÿ“š

pricing overview stuck recalculationstatus completed but callout request in prog

Knowledge base article

general
kb
๐Ÿ“š

promotion search api returns no results required parameters

Knowledge base article

general
kb
โš™๏ธ

Re-establishing KTAPI Connection After Sandbox Refresh

After a Salesforce sandbox refresh, the KTAPI connection stops working. Customer reported KTAPI connection issues in their UAT environment following a sandbox refresh, causing API errors and

configuration
ktapi sandbox-refresh connection
โš™๏ธ

How to Configure Sales Channels in Kaptio

Sales Channels define how products are sold and priced within a Business Unit. This guide covers setup, pricing configuration, and common troubleshooting.

configuration
sales-channel pricing setup
โš™๏ธ

Service not appearing in search results despite API availability - Check Is Active field

Customer reported that a hotel service was returning availability from the API but was not appearing in Kaptio service search results.

configuration
service-search item-configuration is-active
๐Ÿ”ท

Troubleshooting 'customer_id not found' errors due to KTAPI push topic sync delays

Users received 'customer_id not found' errors when trying to book services for newly created accounts. The errors appeared intermittently, typically lasting 15-30 minutes before self-resolving.

api
ktapi push-topics sync
๐Ÿ“š

troubleshooting kt agenda pdf generation errors

Knowledge base article

general
kb
๐Ÿ“…

Unable to edit services in Itinerary Builder after add-on deletion

Users were unable to add or edit services in the Itinerary Builder. The system would show an error when trying to make changes to service lines on affected itineraries.

booking
itinerary-builder add-ons service-editing
๐Ÿ“š

understanding cumulative pricing for volume based discounts

Knowledge base article

general
kb
๐Ÿ”Œ

Why Markup Is Not Applied to Taxes on PNR Flight Imports

Customer reported that markup was not being applied to taxes when importing PNR flights. They expected the configured markup to apply to both fare and tax price lines.

integration
PNR flights taxes