# Quotes

These group of endpoints are designed to manage the creation, retrieval, and updating of flight quotes. These endpoints are essential for streamlining the quoting process, ensuring accuracy, and enhancing operational efficiency.

**Key Features**

- **Creation:** Generate new quotes with detailed information.
- **Retrieval:** Access existing quotes and their details.
- **Updating:** Modify existing quotes to reflect changes in requirements or pricing.
- **Notification:** Automatically notify operators upon successful quote creation or updates.

<br/>

**Business Value**

- **Efficiency:** Streamlines the quote management process, reducing the time and effort required to handle quotes.
- **Accuracy:** Ensures data integrity and accuracy, minimizing errors and discrepancies in quotes.
- **Automation:** Automates the notification process, keeping operators informed in real-time.

<br/>

**Use Cases**

- **Sales Teams:** Quickly generate accurate quotes for potential clients, improving response times and customer satisfaction.
- **Operations Management:** Ensure that all quotes are properly formatted and complete before proceeding with further actions.
- **Financial Planning:** Use the generated quotes to forecast revenue and manage financial expectations.

<br/>

**Why Use These Endpoints?**

Utilizing the endpoints under the `Quotes` tag helps to streamline the quote management process by ensuring data integrity and accuracy. They are essential tools for managing quotes efficiently and effectively.


## Generate Provisional Quote

 - [POST /api/external/quote/lookup](https://developer.fl3xx.com/reference/quotes/postquotelookup.md): This endpoint allows you to simulate the creation of a quote without actually creating a real one. It provides a way to check aircraft availability and validate the pricing information before proceeding with an actual quote creation.



-  Ensures that all required fields are correctly filled and formatted.
-  Provides a simulated response that mimics the actual quote creation process.
-  Fetches price and aircraft availability without notifying the operator.





Using this endpoint helps to prevent errors and streamline the quote creation process by allowing you to test and validate data before committing to a real quote. It is an essential tool for ensuring data integrity and accuracy in your operations.


## Get a Quote

 - [GET /api/external/quote/{reference}](https://developer.fl3xx.com/reference/quotes/getquotebyreference.md): Fetches the details of a quote using its reference (bookingId/quoteId or externalReference).

## Update a Quote

 - [PUT /api/external/quote/{reference}](https://developer.fl3xx.com/reference/quotes/putquotebyreference.md): Updates the details of an existing quote using its reference.

## Delete a Quote

 - [DELETE /api/external/quote/{reference}](https://developer.fl3xx.com/reference/quotes/deletequotebyreference.md): Deletes an existing quote using its reference.

## Generate Quote

 - [POST /api/external/quote](https://developer.fl3xx.com/reference/quotes/postquote.md): This endpoint allows you to create a new quote and notifies the operator.



-  Generates a new quote with the provided details.
-  Notifies the operator upon successful quote creation.





Using this endpoint helps to streamline the quote creation process, it is an essential tool for managing quotes efficiently and effectively.





When submitting a quote, the system will attempt to create or pick the account provided in the following order:

1. : If  is provided and valid, the account is retrieved using the ID.
2. : If no account is found, the system will search for an account using the  field.
3. : If no account is found, the system will search for an account using the  field.
4. : If both   and  fields are provided, the system will attempt to find a match.
5. : If no account is found by the above methods, the system will search for an account using the user's full name (concatenation of and ).





When the aircraft uses the pricing engine, a price will only be returned if the request satisfies the pricing rules defined by the operator. If no applicable pricing rule is matched, the returned price will be 0.

To ensure accurate pricing, it is recommended to contact the operator directly for details on the specific conditions required for price calculation.


## Get Non-Booked Quotes

 - [GET /api/external/quote/notbooked](https://developer.fl3xx.com/reference/quotes/getquotesnotbooked.md): Fetches a list of quotes that have not been booked.

## Create a Booked Quote

 - [POST /api/external/quote/book](https://developer.fl3xx.com/reference/quotes/postquotebook.md): This endpoint allows you to create a new booked quote and notifies the operator.



-  Generates a new quote with the provided details.
-  Notifies the operator upon successful quote creation.





Using this endpoint helps to streamline the quote creation process, it is an essential tool for managing quotes efficiently and effectively.





When submitting a quote, the system will attempt to create or pick the account provided in the following order:

1. : If  is provided and valid, the account is retrieved using the ID.
2. : If no account is found, the system will search for an account using the  field.
3. : If no account is found, the system will search for an account using the  field.
4. : If both   and  fields are provided, the system will attempt to find a match.
5. : If no account is found by the above methods, the system will search for an account using the user's full name (concatenation of and ).





When the aircraft uses the pricing engine, a price will only be returned if the request satisfies the pricing rules defined by the operator. If no applicable pricing rule is matched, the returned price will be 0.

To ensure accurate pricing, it is recommended to contact the operator directly for details on the specific conditions required for price calculation.


## Update a Booked Quote

 - [PUT /api/external/quote/book/{reference}](https://developer.fl3xx.com/reference/quotes/putquotebookbybookingreference.md): Updates a booked quote using its booking reference. If you modify the departure time, you need to make sure to update the arrival time too since FL3XX only calculates it at the first time.

## Cancel a Booked Quote

 - [DELETE /api/external/quote/book/{reference}](https://developer.fl3xx.com/reference/quotes/deletequotebookbybookingreference.md): Cancels a booked quote using its booking reference.

## Update Booking Payment Status

 - [PUT /api/external/quote/bookings/payment/{reference}](https://developer.fl3xx.com/reference/quotes/putbookingpaymentstatusbybookingreference.md): Updates the payment status of a booking using its reference.

## Get Quote Versions

 - [GET /api/external/quote/customer/{customerId}/versions](https://developer.fl3xx.com/reference/quotes/getquoteversionsbycustomerid.md): Fetches all versions of quotes associated with a specific customer ID.

## Get Quote Price

 - [GET /api/external/quote/price/{reference}](https://developer.fl3xx.com/reference/quotes/getquotepricebyquotereference.md): Gets the price details of a quote using its reference.

## Get Booked Snapshot

 - [GET /api/external/quote/{reference}/bookedSnapshot](https://developer.fl3xx.com/reference/quotes/getquotebookedsnapshotbyreference.md): Fetches the snapshot of a booked quote using its reference.

## Get Quote History

 - [GET /api/external/quote/{reference}/history](https://developer.fl3xx.com/reference/quotes/getquotehistorybyreference.md): Fetches the history of a quote using its reference.

## Approve Quote by Owner

 - [POST /api/external/quote/{reference}/owner/approve](https://developer.fl3xx.com/reference/quotes/postquoteapproval.md): Approves a quote by the owner using its reference.

## Get Quote Versions by Account ID

 - [GET /api/external/quote/{rootBookingId}/account/{accountId}/versions](https://developer.fl3xx.com/reference/quotes/getquoteversionsbyrootbookingandaccountid.md): Fetches all versions of quotes associated with a specific account ID.

## Get Quote Versions by Customer ID

 - [GET /api/external/quote/{rootBookingId}/customer/{customerId}/versions](https://developer.fl3xx.com/reference/quotes/getquoteversionsbyrootbookingandcustomerusingget.md): Fetches all versions of quotes associated with a specific customer ID.

## Get All Quote Versions

 - [GET /api/external/quote/{rootBookingId}/versions](https://developer.fl3xx.com/reference/quotes/getquoteversionsbyrootbookingusingget.md): Fetches all versions of quotes associated with a specific root booking ID.

## Generate Quote (deprecated)

 - [POST /api/external/webQuote/create](https://developer.fl3xx.com/reference/quotes/postwebquote.md): Create a new quote (Deprecated)