API reference
/Trip
//
Finalize the given pnr.
This endpoint changes the metadata of PNR to finalized and triggers supplier actions if required.
Security
Bearer
finalizeIntentAirPriceOptimizationMetadataWrapper (object) or ManualVerificationIntentWrapper (object) or QcFinalizationWrapper (object) or PriceOptimizationMetadataWrapper (object)(FinalizeIntent)
One of:
Deprecated. Use PriceOptimizationMetadataWrapper with suspend reason PRICE_OPTIMIZATION instead. Legacy wrapper for air-only reshop, used only with suspend reason AIR_PRICE_OPTIMIZATION.
Custom field user responses for the booking.
- Sandbox URLhttps://api-ext-sboxmeta.partners.spotnana.com/v3/trips/{tripId}/pnrs/{pnrId}/finalize
- Spotnana mock serverhttps://developer.spotnana.com/_mock/openapi/tripapi/v3/trips/{tripId}/pnrs/{pnrId}/finalize
curl -i -X POST \
https://api-ext-sboxmeta.partners.spotnana.com/v3/trips/6926658168/pnrs/6926658168/finalize \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"preBookAnswers": {
"answers": [
{
"entityId": "string",
"userInput": "string",
"itemIds": [
0
],
"answers": [
{
"item": "string",
"value": "string",
"description": "string"
}
],
"customFieldType": "QUESTION",
"questionDisplayText": "string",
"question": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"questionFormat": "CHECKBOX",
"optionInfo": {
"source": "MANUAL",
"sourceMetadata": {
"companyConfig": {}
},
"totalNumOptions": 0,
"options": [
{}
]
},
"isRequired": true,
"isDisabled": true,
"includeInItinerary": true,
"customFieldLocations": [
"POLICY_APPROVAL_EMAIL"
],
"matchConditions": {
"travelerConditions": {
"workerTypes": [
null
],
"countries": [
null
],
"legalEntities": [
null
],
"departments": [
null
],
"costCenters": [
null
],
"offices": [
null
]
},
"travelTypes": [
"AIR"
],
"travelRegionTypes": [
"DOMESTIC"
],
"tripUsageTypes": [
"STANDARD"
]
},
"questionType": {
"preSearchQuestionType": "PURPOSE_OF_TRIP",
"preCheckoutQuestionType": "OOP_REASON_CODE"
}
}
}
],
"preBookQuestionResponseId": "string"
},
"finalizeIntent": {
"airPriceOptimizationMetadata": {
"oldTickets": [
"0111234567890"
],
"newTickets": [
"0111234567890"
],
"oldPnrId": "6789533589",
"newPnrId": "6789533589",
"oldPrice": {
"amount": 510,
"currencyCode": "GBP",
"convertedAmount": 715.42,
"convertedCurrency": "USD",
"otherCoinage": [
{
"coinageCode": "BREX_POINTS",
"amount": 1000,
"conversionRate": 0.01,
"preferredCurrencyConversionRate": 0.01,
"otherCoinageMetadata": {
"metadataType": "FlightPassPaymentMetadata",
"flightPassMetadata": {}
}
}
]
},
"newPrice": {
"amount": 510,
"currencyCode": "GBP",
"convertedAmount": 715.42,
"convertedCurrency": "USD",
"otherCoinage": [
{
"coinageCode": "BREX_POINTS",
"amount": 1000,
"conversionRate": 0.01,
"preferredCurrencyConversionRate": 0.01,
"otherCoinageMetadata": {
"metadataType": "FlightPassPaymentMetadata",
"flightPassMetadata": {}
}
}
]
},
"priceDrop": {
"amount": 510,
"currencyCode": "GBP",
"convertedAmount": 715.42,
"convertedCurrency": "USD",
"otherCoinage": [
{
"coinageCode": "BREX_POINTS",
"amount": 1000,
"conversionRate": 0.01,
"preferredCurrencyConversionRate": 0.01,
"otherCoinageMetadata": {
"metadataType": "FlightPassPaymentMetadata",
"flightPassMetadata": {}
}
}
]
},
"penaltyPrice": {
"amount": 510,
"currencyCode": "GBP",
"convertedAmount": 715.42,
"convertedCurrency": "USD",
"otherCoinage": [
{
"coinageCode": "BREX_POINTS",
"amount": 1000,
"conversionRate": 0.01,
"preferredCurrencyConversionRate": 0.01,
"otherCoinageMetadata": {
"metadataType": "FlightPassPaymentMetadata",
"flightPassMetadata": {}
}
}
]
}
}
},
"finalizeMetadata": {
"isMandatoryTicketing": true,
"mandatorySkipTicketing": true,
"suspendReason": "PRICE_OPTIMIZATION",
"taskId": "string"
},
"customFieldV3UserResponses": [
{
"fieldId": "84922011-b03d-4966-bc95-c5b49bc2e342",
"fieldName": "string",
"armId": "0fd508db-63ff-4444-bfb1-b89c43061433",
"includeLocations": [
"APPROVAL_EMAILS"
],
"selectedOptions": [
{
"name": "string",
"translatedName": "string",
"description": "string",
"translatedDescription": "string",
"additionalUserInput": "string",
"additionalInfos": [
"string"
],
"additionalInfoConfigs": [
{
"type": "VARIABLE",
"name": "LLF"
}
],
"optionId": "dee15a0e-f1fe-4cd8-88ac-c090810707f8"
}
]
}
]
}'