leave suport

Author: corneliujitareanu

README.md

@@ -78,7 +78,7 @@ If you exceed the rate limit, you'll get a [429 Too Many Requests](http://tools.
 * [Clients](sections/clients.md)
 * [Comments](sections/comments.md)
 * [Company](sections/company.md)
-* [Company-Days-Exceptions](sections/companies_days_exceptions.md)
+* [CompaniesDays-Exceptions](sections/companies_days_exceptions.md)
 * [Discussions](sections/discussions.md)
 * [Estimate Templates](sections/estimate_templates.md)
 * [Estimates](sections/estimates.md)

sections/companies_days_exceptions.md

@@ -1,4 +1,4 @@
-# Company Days Exceptions
+# Companies Days Exceptions
 
 Days-exceptions is a date interval that defines a working or a non-working period of time.
 

sections/leaves_support.md

@@ -1,11 +1,57 @@
 # Leaves Support
 
-There are three endpoints to consider when you want to find working/non-working days in a specific interval of time.
+## Get user annual leave info
 
-For company, get from the [company info](company.md) "working_days" and verify if contains the numeric representation of the day of the week (ISO-8601) for every date from the interval.
-Then, make a GET request to `/api/companiesdaysexceptions?where=date<=interval.end_date&&end_date>=interval.start_date` (see [Company Days Exceptions](companies_days_exceptions.md)) and exclude or include the intervals depending on the field "is_working".
+Make sure you've set up the annual leave entitlement for company (POST request to `/api/company/[COMPANY_ID]`) or for an user (POST request to `/api/users/[USER_ID]`) with the body:
 
-For a user, you need to make a GET request to `/api/usersdaysexceptions?where=user_id=[USER_ID]&&date<=interval.end_date&&end_date>=interval.start_date` (see [Users Days Exceptions](users_days_exceptions.md)) and exclude or include the intervals from those of the company.
+```json
+{
+	"annual_leave_days_number":21
+}
+```
+
+Get the user annual leave info by making a POST request to `/api/statsreports` with the body:
+
+```json
+{
+	"params":{
+		"user_id":76509,
+        "date_interval":"this_year"
+	},
+	"type": "user_annual_leave_stats"
+}
+```
+
+Example of response:
+
+```json
+{
+	"statsreports":[
+		{
+			"info": {
+				"type":"user_annual_leave_stats",
+				"params": {
+					"user_id":76509,
+					"date_interval":"this_year"
+				}
+			},
+			"content":[
+				{
+					"user_annual_leave_stats": {
+						"annual_leave_days_number":21,
+						"unpaid_leave_days_count":3,
+						"used_leave_days_count":5
+					}
+				}
+			]
+		}
+	]
+}
+```
+
+Available options for date interval are 'this_year' and 'last_year'.
+
+## Get working days count
 
 You can find the number of the working days for a user in a interval of time by making a POST request to `/api/statsreports` with the body:
 
@@ -29,7 +75,7 @@ Example of response:
 			"info": {
 				"type":"user_working_days_count",
 				"params": {
-					"user_id":8,
+					"user_id":76509,
 					"start_date":"2017-07-06T00:00:00",
 					"end_date":"2017-07-30T00:00:00"
 				}