Add booking create with bookings_fees and bookings_taxes

Author: przemyslaw kedzierski

content/reference/endpoints/bookings.md

@@ -187,6 +187,13 @@ POST /rentals/:rental_id/bookings
     { bookings_write: "bookings_read-bookings_write" }
   ] %>
 
+You can pass booking additional parameters: `bookings_fees` and `bookings_taxes`:
+<%= render 'json_response', endpoint: "bookings", request: "request_with_fees_and_taxes",
+  scopes: [
+    { bookings_write: "bookings_read-bookings_write_with_fees_and_taxes" }
+  ] %>
+You need to remember that sum of `bookings_fees` (`price * times_booked`) and `bookings_taxes` (`amount`) minus `discount` must equal the given `final_price`. Otherwise booking is not valid. Given `rental` (`rental_type` and `rental_id`) in `bookings_taxes` must belong to your account. Also `rentals_fee_id` must point to `rentals_fee` that belongs to you.
+
 ## Update a booking
 
 Returns an updated booking identified by ID.

responses/bookings/bookings_read-bookings_write-scope.json

@@ -4,7 +4,10 @@
     "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
     "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
     "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
-    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}"
+    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}",
+    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
+    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
+    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}"
   },
   "bookings": [
     {
@@ -13,7 +16,10 @@
         "rental": 16,
         "client": 37,
         "rental_agreement": null,
-        "source": 1
+        "source": null,
+        "bookings_fees": [],
+        "bookings_taxes": [],
+        "bookings_tags": []
       },
       "id": 80,
       "start_at": "START_AT",

responses/bookings/bookings_read-bookings_write_with_fees_and_taxes-scope.json

@@ -0,0 +1,50 @@
+{
+  "links": {
+    "bookings.account": "https://www.bookingsync.com/api/v3/accounts/{bookings.account}",
+    "bookings.rental": "https://www.bookingsync.com/api/v3/rentals/{bookings.rental}",
+    "bookings.client": "https://www.bookingsync.com/api/v3/clients/{bookings.client}",
+    "bookings.rental_agreement": "https://www.bookingsync.com/api/v3/rental_agreements/{bookings.rental_agreement}",
+    "bookings.source": "https://www.bookingsync.com/api/v3/sources/{bookings.source}",
+    "bookings.bookings_fees": "https://www.bookingsync.com/api/v3/bookings_fees/{bookings.bookings_fees}",
+    "bookings.bookings_taxes": "https://www.bookingsync.com/api/v3/bookings_taxes/{bookings.bookings_taxes}",
+    "bookings.bookings_tags": "https://www.bookingsync.com/api/v3/bookings_tags/{bookings.bookings_tags}"
+  },
+  "bookings": [
+    {
+      "links": {
+        "account": 1,
+        "rental": 16,
+        "client": 37,
+        "rental_agreement": null,
+        "source": null,
+        "bookings_fees": [10, 11],
+        "bookings_taxes": [22, 23],
+        "bookings_tags": []
+      },
+      "id": 80,
+      "start_at": "START_AT",
+      "end_at": "END_AT",
+      "status": "Booked",
+      "updated_at": "UPDATED_AT",
+      "booked": true,
+      "unavailable": false,
+      "tentative_expires_at": null,
+      "initial_price": "3000.0",
+      "discount": "10%",
+      "final_price": "2700.0",
+      "downpayment": null,
+      "paid_amount": "0.0",
+      "currency": "USD",
+      "notes": "",
+      "adults": 5,
+      "children": null,
+      "bookings_payments_count": 0,
+      "review_requests_count": 0,
+      "locked": null,
+      "created_at": "CREATED_AT",
+      "canceled_at": null
+    }
+  ],
+  "meta": {
+  }
+}

responses/bookings/request_with_fees_and_taxes.json

@@ -0,0 +1,23 @@
+{
+  "bookings": [
+    {
+      "booked": true,
+      "client_id": 37,
+      "adults": 5,
+      "currency": "USD",
+      "discount": "10%",
+      "final_price": "2930.0",
+      "initial_price": "3000.0",
+      "start_at": "START_AT",
+      "end_at": "END_AT",
+      "bookings_fees": [
+        { "price": "50", "times_booked": "2", "rentals_fee_id": "10" },
+        { "price": "30", "times_booked": "1", "rentals_fee_id": "10" }
+      ],
+      "bookings_taxes": [
+        { "taxable_type": "Rental", "taxable_id": "1", "amount": "60", "tax_id": "5" },
+        { "taxable_type": "Rental", "taxable_id": "1", "amount": "40", "tax_id": "7" }
+      ]
+    }
+  ]
+}