Quickstart
The Inventory Push GraphQL API is a comprehensive solution designed to optimize the management of static information and master data in the travel industry. This API enables buyers and sellers to configure, upload, and retrieve crucial data needed to efficiently establish and maintain their inventory.
It is important to note that developments for this API can be carried out either by Travelgate or third parties. This flexibility allows users to choose the option that best suits their needs and resources.
Introduction
This is a comprehensive GraphQL API designed to streamline the handling of static information and master data for the travel industry. This API enables both Buyers and Sellers to efficiently set up, load, and retrieve crucial data necessary for establishing and maintaining their stock. It supports the complete setup of hotels, including the creation of rates, rooms and offers.
This API mirrors the capabilities available on our existing Inventory Extranet but with the added benefits that come from API integration, such as automation, improved efficiency, and reduced likelihood of human error.
What sets this API apart is its use of GraphQL technology, which allows users to precisely define the data they require, reducing the overhead and increasing the efficiency of data transfer. The API also supports asynchronous operations, ensuring that your system can handle large volumes of data without performance bottlenecks.
Highlights of the Inventory Set Up GraphQL API include:
- Efficient Data Management: Directly manage and update hotel information, room details, rate plans, and more.
- Dynamic Updates: Load and update availability and pricing information quickly to reflect real-time changes.
- Error Reduction: Automate data entry and updates to minimize errors and inconsistencies.
- Scalability: Designed to handle operations at scale, making it suitable for both small vendors and large enterprise operations.
By integrating the Inventory Set Up GraphQL API, you can expect a smoother, more responsive workflow that keeps your inventory up-to-date and accurately represented across all channels.
Integration Approaches: Understanding Setup Models
This API supports different integration models adapted to your business needs. Depending on your provider type or channel manager, you can understand which approach best suits your workflow.
Integration Types in Inventory
Before diving into the different setup models and flows, it is important to understand the two integration types available in Inventory.
As a Buyer, your connectivity remains the same regardless of the model; the difference lies in how the Seller manages their data and how the booking is confirmed:
- Push: The Seller sends all their availability, rates, and inventory directly to our system, making Travelgate the "Master Database". When you book, the confirmation is instant because the transaction happens directly against the data already stored in our Inventory solution.
- Hybrid: The Seller manages their setup in Inventory but requires a real-time validation for the final booking. While Inventory handles the initial Search, every Quote or Book request triggers a real-time call to the Seller’s system to confirm the final price and availability.
Setup Approach
This flow explains how the setup is created and maintained in Inventory. Depending on the integration, setup can be manual, fully automated, or partially automated:
Manual SetUp
The traditional approach used by legacy integrations. In this model:
- Setup is managed manually by the client or authorized hotel users through the Inventory Extranet
- No automation occurs—all data entry, updates, and master information management is done directly by users
- Requires significant manual effort and time investment
Full AutoSetUp
A modern, fully automated integration model where Travelgate implements the complete setup using provider information:
- The integration automatically loads and manages all hotel data, rates, rooms, and related properties into Inventory
- Clients do not need to perform any manual setup tasks—everything is handled by the integration
- Significantly reduces time to production and eliminates manual data entry errors
- Provider information is leveraged to fully populate the inventory without any client intervention
- Ideal for providers and channel managers that provide complete data sets
Current Full AutoSetUp integrations:
| Supplier Name | Supplier Code | Integration Type |
|---|---|---|
| IBS Software | IBSP | Push |
| Sandals | SHAP | Push |
| TBO Push | TBOP | Push |
| My Morocco | MMO | Push |
| JumbOnline | JMBP | Push |
| BEDS4GREECE | B4G | Push |
| World2Meet | W2MP | Push |
| Juniper (Connectycs) | H10C | Hybrid |
| DerbySoft | GOHOTEL | Hybrid |
| Swap Systems | SNR | Hybrid |
| Axis Data | AXIS | Hybrid |
| Cretan Holidays | CRE | Hybrid |
| HotelTrader | HTRP | Hybrid |
| Magic Travel | MTRP | Hybrid |
Partial AutoSetUp
A hybrid approach where part of the setup is automated, but some elements require manual configuration:
- The integration handles certain aspects of the setup automatically using provider data
- However, some data may not be available directly from the provider and must be provided by the client first (e.g., hotel codes)
- Once the required information is provided, the integration retrieves and loads the remaining related setup data
- Useful for scenarios where provider data is partially complete
- Reduces manual work while maintaining flexibility for data that requires client specification
Current Partial AutoSetUp integrations:
| Supplier Name | Supplier Code | Integration Type |
|---|---|---|
| Phobs | PHOB | Push |
Each setup approach offers distinct advantages depending on your integration capabilities and data availability.
Booking Flow Approach
Once the setup is ready in Inventory, the booking flow is defined by the integration type:
- Push: Inventory manages the booking lifecycle and sends booking notifications to the provider/channel manager. In some cases, the provider retrieves bookings from Inventory to keep its side updated.
- Hybrid: Inventory stores setup, availability and pricing, but pricing and booking are executed through pull calls to the provider at booking time.
For Hybrid integrations, the price or cancellation policies stored in Inventory can change when the quote is requested from the provider. This can lead to One Step Book flows returning a "booking error" when, in practice, the quote price or policies have been updated by the provider.
To connect safely with Hybrid integrations, we strongly recommend implementing One Step Quote or, alternatively, integrating through Hotel-X Pull Buyers API Quickstart.
Let's Get Started: Power up your Inventory management!
Dive into the GraphQL methods of our newest API, designed to perfect your setup, simplify updates, and ensure complete control over your own stock.
- Explore the Making Requests section to dive deep into how a GraphQL API works and maximize its performance.
- Discover various queries and mutations grouped by the following actions:
- Masters: Check all the hotels and your list of rooms created in Inventory.
- Static Data: Explore or store static data in Inventory.
- Set Up: Learn how to completely set up your product in Inventory.