Fixes #11

--README.md
Updated retrieve org data section to contain more links to example files to retrieve products, categories, attributes, makers, models and maker model mappings

--APIv1EndpointOrgRetrieveESDocument.java
Added constants to allow category, maker, maker model, maker model mapping, and attributes to be retrieved.
Modified call method to support pagination, and additional parameters with each data request.

--APIv1ExampleRunnerRetrieveOrgESDDataAttributes.java
Added class to show example of retrieving organisation attribute data from the platform's api.

--APIv1ExampleRunnerRetrieveOrgESDDataCategories.java
Added class to show example of retrieving organisation category data from the platform's api.

--APIv1ExampleRunnerRetrieveOrgESDData.java
Set correct comments in class.

--APIv1ExampleRunnerRetrieveOrgESDDataMakerModelMappings.java
Added class to show example of retrieving organisation maker model mapping data from the platform's api.

--APIv1ExampleRunnerRetrieveOrgESDDataMakerModels.java
Added class to show example of retrieving organisation maker model data from the platform's api.

--APIv1ExampleRunnerRetrieveOrgESDDataMakers.java
Added class to show example of retrieving organisation makers data from the platform's api.

Author: Rowan Drew

README.md

@@ -1,7 +1,7 @@
 package org.squizz.api.v1.endpoint;
 
 /**
-* Copyright (C) 2017 Squizz PTY LTD
+* Copyright (C) 2019 Squizz PTY LTD
 * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License along with this program.  If not, see http://www.gnu.org/licenses/.
@@ -29,8 +29,13 @@
 public class APIv1EndpointOrgRetrieveESDocument
 {
     public static final int RETRIEVE_TYPE_ID_PRODUCTS = 3;
-    public static final int RETRIEVE_TYPE_ID_PRICING = 37;
+	public static final int RETRIEVE_TYPE_ID_CATEGORIES = 8;
     public static final int RETRIEVE_TYPE_ID_PRODUCT_STOCK = 10;
+	public static final int RETRIEVE_TYPE_ID_ATTRIBUTES = 11;
+	public static final int RETRIEVE_TYPE_ID_PRICING = 37;
+	public static final int RETRIEVE_TYPE_ID_MAKERS = 44;
+	public static final int RETRIEVE_TYPE_ID_MAKER_MODELS = 45;
+	public static final int RETRIEVE_TYPE_ID_MAKER_MODEL_MAPPINGS = 46;
 
     /**
      * Calls the platform's API endpoint and gets organisation data in a Ecommerce Standards Document of a specified type
@@ -39,9 +44,12 @@ public class APIv1EndpointOrgRetrieveESDocument
      * @param retrieveTypeID ID of the type of data to retrieve
      * @param supplierOrgID unique ID of the supplier organisation in the SQUIZZ.com platform to obtain data from
      * @param customerAccountCode code of the supplier organisation's customer account. Customer account only needs to be set if the supplier organisation has assigned multiple accounts to the organisation logged into the API session (customer org) and account specific data is being obtained
+	 * @param recordsMaxAmount maximum number of records to obtain from the platform
+	 * @param recordsStartIndex index containing the position of records to start obtaining from the server
+	 * @param requestParameters set additional parameters to in the request URL. Ensure parameter values are URI encoded
      * @return response from calling the API endpoint
      */
-    public static APIv1EndpointResponseESD call(APIv1OrgSession apiOrgSession, int endpointTimeoutMilliseconds, int retrieveTypeID, String supplierOrgID, String customerAccountCode)
+    public static APIv1EndpointResponseESD call(APIv1OrgSession apiOrgSession, int endpointTimeoutMilliseconds, int retrieveTypeID, String supplierOrgID, String customerAccountCode, int recordsMaxAmount, int recordsStartIndex, String requestParameters)
     {
         ArrayList<Pair<String, String>> requestHeaders = new ArrayList<>();
         APIv1EndpointResponseESD endpointResponse = new APIv1EndpointResponseESD();
@@ -50,7 +58,14 @@ public static APIv1EndpointResponseESD call(APIv1OrgSession apiOrgSession, int e
 
         try{
             //set endpoint parameters
-            String endpointParams = "data_type_id="+retrieveTypeID + "&supplier_org_id=" + URLEncoder.encode(supplierOrgID, StandardCharsets.UTF_8.name()) + "&customer_account_code="+URLEncoder.encode(customerAccountCode, StandardCharsets.UTF_8.name());
+            String endpointParams = 
+				"data_type_id="+retrieveTypeID + 
+				"&supplier_org_id=" + 
+				URLEncoder.encode(supplierOrgID, StandardCharsets.UTF_8.name()) + 
+				"&customer_account_code="+URLEncoder.encode(customerAccountCode, StandardCharsets.UTF_8.name())+
+				"&records_max_amount="+recordsMaxAmount+
+				"&records_start_index="+recordsStartIndex+ 
+				(requestParameters!= null && !requestParameters.isEmpty()? "&"+requestParameters: "");
 
             //create JSON deserializer to interpret the response from the endpoint
             ObjectMapper jsonMapper = new ObjectMapper();
@@ -66,6 +81,21 @@ public static APIv1EndpointResponseESD call(APIv1OrgSession apiOrgSession, int e
                     break;
                 case RETRIEVE_TYPE_ID_PRODUCT_STOCK:
                     endpointJSONReader = jsonMapper.readerFor(ESDocumentStockQuantity.class);
+                    break;
+				case RETRIEVE_TYPE_ID_CATEGORIES:
+                    endpointJSONReader = jsonMapper.readerFor(ESDocumentCategory.class);
+                    break;
+				case RETRIEVE_TYPE_ID_ATTRIBUTES:
+                    endpointJSONReader = jsonMapper.readerFor(ESDocumentAttribute.class);
+                    break;
+				case RETRIEVE_TYPE_ID_MAKERS:
+                    endpointJSONReader = jsonMapper.readerFor(ESDocumentMaker.class);
+                    break;
+				case RETRIEVE_TYPE_ID_MAKER_MODELS:
+                    endpointJSONReader = jsonMapper.readerFor(ESDocumentMakerModel.class);
+                    break;
+				case RETRIEVE_TYPE_ID_MAKER_MODEL_MAPPINGS:
+                    endpointJSONReader = jsonMapper.readerFor(ESDocumentMakerModelMapping.class);
                     break;
                 default:
                     callEndpoint  = false;
@@ -99,4 +129,18 @@ public static APIv1EndpointResponseESD call(APIv1OrgSession apiOrgSession, int e
 
         return endpointResponse;
     }
+	
+	/**
+     * Calls the platform's API endpoint and gets organisation data in a Ecommerce Standards Document of a specified type
+     * @param apiOrgSession existing organisation API session
+     * @param endpointTimeoutMilliseconds amount of milliseconds to wait after calling the the API before giving up, set a positive number
+     * @param retrieveTypeID ID of the type of data to retrieve
+     * @param supplierOrgID unique ID of the supplier organisation in the SQUIZZ.com platform to obtain data from
+     * @param customerAccountCode code of the supplier organisation's customer account. Customer account only needs to be set if the supplier organisation has assigned multiple accounts to the organisation logged into the API session (customer org) and account specific data is being obtained
+     * @return response from calling the API endpoint
+     */
+    public static APIv1EndpointResponseESD call(APIv1OrgSession apiOrgSession, int endpointTimeoutMilliseconds, int retrieveTypeID, String supplierOrgID, String customerAccountCode)
+    {
+		return call(apiOrgSession, endpointTimeoutMilliseconds, retrieveTypeID, supplierOrgID, customerAccountCode, 5000, 0, "");
+	}
 }

src/org/squizz/api/v1/endpoint/APIv1EndpointOrgRetrieveESDocument.java

@@ -1,5 +1,5 @@
 /**
-* Copyright (C) 2017 Squizz PTY LTD
+* Copyright (C) 2019 Squizz PTY LTD
 * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License along with this program.  If not, see http://www.gnu.org/licenses/.
@@ -75,16 +75,16 @@ public static void main(String[] args)
 			System.out.println("FAIL - API session failed to be created. Reason: " + endpointResponse.result_message  + " Error Code: " + endpointResponse.result_code);
 		}
 
-		//import organisation data if the API was successfully created
+		//retrieve organisation data if the API was successfully created
 		if(apiOrgSession.sessionExists())
 		{   
 			//after 60 seconds give up on waiting for a response from the API when creating the notification
 			int timeoutMilliseconds = 60000;
 
-			//call the platform's API to import in the organisation's data, which for this example is product pricing
+			//call the platform's API to retrieve the organisation's data, which for this example is product pricing
 			APIv1EndpointResponseESD endpointResponseESD = APIv1EndpointOrgRetrieveESDocument.call(apiOrgSession, timeoutMilliseconds, recordType, supplierOrgID, customerAccountCode);
 
-			//check that the data successfully imported
+			//check that the data successfully retrieved
 			if(endpointResponseESD.result.equals(APIv1EndpointResponse.ENDPOINT_RESULT_SUCCESS)){
                 System.out.println("SUCCESS - organisation data successfully obtained from the platform");
 				DecimalFormat decimalFormat = new DecimalFormat("#.####");
@@ -133,7 +133,7 @@ public static void main(String[] args)
 							int i=0;
 							for(ESDRecordProduct productRecord: esDocumentProduct.dataRecords)
 							{    
-								//output details of the price record
+								//output details of the product record
 								System.out.println(APIv1OrgTestRunner.CONSOLE_LINE);
 								System.out.println("Product Record #: " + i);
 								System.out.println("  Key Product ID: " + productRecord.keyProductID);
@@ -176,7 +176,7 @@ public static void main(String[] args)
 							int i=0;
 							for(ESDRecordStockQuantity stockQuantityRecord: esDocumentStockQuantity.dataRecords)
 							{    
-								//output details of the price record
+								//output details of the product stock record
 								System.out.println(APIv1OrgTestRunner.CONSOLE_LINE);
 								System.out.println("Product Record #: " + i);
 								System.out.println("  Key Product ID: " + stockQuantityRecord.keyProductID);