Skip to main content

Create an order or quote

POST 
/v1/orders

This endpoint is designed to create orders or quotes.

Delivery Date and Wheels Up/Down Date​

The delivery date must be in the future.
So you can't create an order or quote if the delivery date is in the past.
The delivery date is rounded down to 15 minutes.
wheelsUpDate/wheelsDownDate is rounded down to one minute.
If deliveryDate is not passed, it is calculated based on wheelsUpDate/wheelsDownDate using the formula deliveryDate = wheelsUpDate/wheelsDownDate - 2h (in this case the same validation rules described above will be applied).

Airport and FBO​

Airport​

At least one of the following codes must be passed: icaoCode, iataCode or faaCode.
By these codes, we will make an association with the airport.

If more than one airport was found by the passed codes, we return the corresponding errors and interrupt the order creation. In this case, it is recommended to provide additional airport codes.

FBO​

If we are unable to find the FBO by name in our database, we will create one. In this case, the address is necessary. Otherwise, the address is ignored.

Items​

Formation Catering has 4 types of items:

  • "general" - general items, like Sandwich, Coffee, etc.
  • "restaurantFacilitation" - restaurant facilitation items.
  • "service" - service items, like Cleaning, Trash Removal, etc.
  • "fee" - fee items. Items of this type can only be added from Formation side and can neither be deleted nor edited, they are fully controlled by Formation.

Please indicate meal type (crew or passenger) in "label" property of each item.

Remember that the "type" of existing items can't be changed on the update operation.

Request​

Responses​