To find out how you can tell the difference between Wholesale, Direct Connect and the Hybrid (Wholesale & Direct Connect) rates please see below.
Note: The following is based on adult fares but the same principle applies to any fare calculation.
Hybrid (Wholesale + Direct Connect)
Livn wholesale does all the calculations for you, including currency conversion from the operator to the selling currency. You will receive the retail rate and the commission you will earn.
At the product details level, you will get the amount and the currency which is the minimum fare for a single unit of a standard ticket (usually adult) from the Livn cache:
"fromPrices": [
{
"amount": 279,
"currency": "AUD"
}
],
you'll also get:
commissionPerc - the retail commission percentage
Calculate Min Nett Rate: amount - commissionPerc
If you use the departures call you'll get the minimum fare for a particular date/s in the following format:
[{
"date": "2023-03-16",
"fromPrices": [
{
"amount": 279,
"currency": "AUD"
}
]
}, ...]
After starting a booking flow, once you reach the FARE_SELECTION milestone then you can see the Live fares for all the passenger types and you can use POST /api/flows/previewPrice that will give you a Quote object with a breakdown of the prices including commissions for the selected fare/s, example of the response below for an adult with a product with 18% commission:
{
"lineItems": [
{
"title": "Adult",
"type": "FARE",
"quantity": 1,
"salesComputationDetails": {
"resSuppliedPrice": {
"amount": 100,
"currency": "AUD"
},
"resSuppliedPriceIsNetRate": false,
"commissionable": true,
"contractCommPrice": {
"amount": 18,
"currency": "AUD"
},
"contractCommPerc": 18
},
"grossPerUnit": {
"amount": 100,
"currency": "AUD"
},
"grossTotal": {
"amount": 100,
"currency": "AUD"
},
"netPerUnit": {
"amount": 82,
"currency": "AUD"
},
"netTotal": {
"amount": 82,
"currency": "AUD"
},
"commissionTotal": {
"amount": 18,
"currency": "AUD"
},
"fareUuids": [
"00000003-0019-0003-0001-000000000000"
]
}
],
"cancellationPolicy": {
"setAtTimeOfBooking": false,
"text": "Please refer to the supplier's terms and conditions for the cancellation policy."
},
"grossTotal": {
"amount": 100,
"currency": "AUD"
},
"netTotal": {
"amount": 82,
"currency": "AUD"
},
"contractCommTotal": {
"amount": 18,
"currency": "AUD"
},
"generalTerms": "Please refer to the supplier's website for general terms and the cancellation policy.",
"title": "Preview Price",
"displayPrice": {
"amount": 100,
"currency": "AUD"
}
}
usesNetRates - Flag to identify a nett rate (False = Gross rate, True = nett rate)
For products purchased under the Direct Connect model, prices may be supplied as net rates (this can be found under the product details and the Boolean property: usesNetRates), meaning the final non-commissionable amounts are payable directly to the product’s supplier. You as the seller are responsible for applying the appropriate mark-up to prices supplied as net amounts (as indicated by the boolean value of every quote.lineItem.salesComputationDetails.resSuppliedPriceIsNetRate.) same quote object structure as above.
As an example this is the quote object for a DC product with net rates for one Adult fare, Livn doesn’t know the commission so it will be displayed as 0.
{
"lineItems": [
{
"title": "Adult",
"type": "FARE",
"quantity": 1,
"salesComputationDetails": {
"resSuppliedPrice": {
"amount": 288.57,
"currency": "AUD"
},
"resSuppliedPriceIsNetRate": true,
"commissionable": true,
"contractCommPrice": {
"amount": 0,
"currency": "AUD"
},
"contractCommPerc": 0
},
"grossPerUnit": {
"amount": 288.57,
"currency": "AUD"
},
"grossTotal": {
"amount": 288.57,
"currency": "AUD"
},
"netPerUnit": {
"amount": 288.57,
"currency": "AUD"
},
"netTotal": {
"amount": 288.57,
"currency": "AUD"
},
"commissionTotal": {
"amount": 0,
"currency": "AUD"
},
"fareUuids": [
"00000002-0019-0003-0002-000000000002"
]
}
],
"cancellationPolicy": {
"setAtTimeOfBooking": false,
"text": "Please refer to the supplier's terms and conditions for the cancellation policy."
},
"grossTotal": {
"amount": 288.57,
"currency": "AUD"
},
"netTotal": {
"amount": 288.57,
"currency": "AUD"
},
"contractCommTotal": {
"amount": 0,
"currency": "AUD"
},
"resSuppliedCommTotal": {
"amount": 0,
"currency": "AUD"
},
"generalTerms": "Please refer to the supplier's website for general terms and the cancellation policy.",
"title": "Preview Price",
"displayPrice": {
"amount": 288.57,
"currency": "AUD"
}
}
In a Hybrid setup, products coming from your Direct Connect and Livn Wholesale channels will appear side by side, so it is important to take note of the directConnect flag present on the product’s channel or the checkout flow and to handle pricing accordingly by checking whether prices are supplied as gross or net rates which need to be marked up.
Calculate Nett Rate for gross: fare amount – commissionPerc (As seen above this is calculated in the quote object)
Note: Nett rate for nett rates is just the fare amount
Therefore, you can calculate the nett payable to Livn for Wholesale or the supplier for Direct Connect with a calculation to reduce the retail rate by the commission. From there your margin management system can apply a markup to get to your desired retail rate.
If you cannot see any of the above in the API or have any questions please contact Livn by raising a Support Ticket via our Customer Portal.