As part of the inter-agency agreement implementation process, it can be important to set maximum turnovers per agency.
A non-IATA agency which cannot issue/book tickets must use a referring IATA agency for such transactions, requiring a payment guarantee mechanism (and therefore checks): non-IATA agencies must not be able to make limitless numbers of bookings, and must thus be limited to a threshold number.
It must be possible to change an agency’s threshold at any time, manually, via a parent “administrator” agency.
A responsibility tree could, for example, be defined on 3 levels:
- Parent agency (1..1)
- Main agencies at country levels (1..N) (Morocco, Egypt, etc.)
- Local agencies (IATA and non-IATA) (1..N)
Implementation in Orchestra
- The concept of a “threshold” is unique to an agency, and does not depend on other agencies, or on the parent agency(ies). Checking the threshold for an agency is therefore simply a question of verifying the threshold for that agency.
- An agency at level N can specify thresholds for lower-level agencies (N+1, N+2) without any notion of maximums/consistency with regard to its own threshold, if it has one.
- For example, if agency A has a threshold of 100K, it can define a 200K threshold for any of its daughter agencies.
- An agency has the following threshold information:
- Initial threshold
- Current threshold
- Current consumption
- Remaining consumption
Transactions on Business Volume
For each reservation made by an agency, the agency’s consumption is decreased by the value of the transaction.
This is the Total Business Volume (transport, accommodation, fees, insurance, etc.).
For each payment by the non-IATA agency to a (parent) IATA agency, its consumption is decreased by the same amount because, as the payment has been made, it is therefore possible to “re-credit” the account of the non-IATA agency. Because the payment system is not connected to this mechanism, the decrease/increase is performed manually by the parent agency(ies) by modifying the consumed turnover using an administration interface.
A non-specified turnover threshold means no limit to turnover.
Verification of thresholds
Option 1 – Alert as a background task
Email alerts are set up as background tasks (jobs) when an agency reaches a percentage of the threshold. This percentage is a configuration which is common to all agencies.
For example, it is possible to generate an alert once the agency has reached 90% of its threshold.
Senders, subjects and content are not configurable and are in English only. The recipient will be the agency that reaches the % of the threshold; the parent agency and the main contact for the account are copied into the alert.
Option 2 – As a service
1/ A remote service is also created to collect the threshold information for an agency.
- This service may be called to collect the connected agency’s threshold information and display a warning message if the threshold is exceeded with the search engine; otherwise, the agency can book.
- Checks on the thresholds are only made during calls and for these services, not during the platform’s booking process.
- If the agency threshold is reached, the agency can neither search nor book.
2/ A service is created to update the agency consumption during a booking.
- This service can update the current/remaining consumption.
- It does not check thresholds, and therefore does not prevent searches or bookings.
Interface
A new interface has been created to view all this information on a per-agency basis.
It is possible for each agency at a level N to view consumption for the agencies it manages (level N-1, N-2). An agency cannot change its own ceiling.
Only agencies with a threshold appear in this interface.
Agency ceilings are changed on an agency-by-agency basis (no bulk changes).