UK Payroll Beta

UK Payroll initial commit - beta
- PayrollUkApi class with all methods for interacting with UK Payroll API
- Models for all UK Payroll objects
- TODO: unit tests for all models

ACCOUNTING
IncludeOnline boolean fixed to be a query Param for creditNote and invoice Attachments

ASSETS
assetTypeId property added to Asset object

IDENTITY
tenantName property added to the Connection object

AU PAYROLL
- allowanceType added with enum values
- earningsType added some missing enum values

ErrorHandler
- Look for Status code 401 and pass code and message in XeroApiException object

Author: SidneyAllen

pom.xml

@@ -5,7 +5,7 @@
     <artifactId>xero-java</artifactId>
     <packaging>jar</packaging>
     <name>xero-java</name>
-    <version>3.5.2</version>
+    <version>3.6.0</version>
     <url>https://github.com/XeroAPI/Xero-Java</url>
     <description>This is the official Java SDK for Xero API</description>
     <licenses>

src/main/java/com/xero/api/XeroApiExceptionHandler.java

@@ -41,6 +41,8 @@ public void execute(HttpResponseException e, ApiClient apiClient)
             elementsItem.addValidationErrorsItem(ve);
             error.addElementsItem(elementsItem);
             throw new XeroApiException(statusCode, error);
+        } else if (statusCode == 401) {
+            throw new XeroApiException(401, "Unauthorized - check your scopes and confirm access to this resource" );
         } else if (statusCode != 400) {
             throw new XeroApiException(statusCode, e.getStatusMessage());
         } else {

src/main/java/com/xero/api/client/AccountingApi.java

@@ -91,7 +91,7 @@ public class AccountingApi {
     private ApiClient apiClient;
     private static AccountingApi instance = null;
     private String userAgent = "Default";
-    private String version = "3.5.2";
+    private String version = "3.6.0";
 
     public AccountingApi() {
         this(new ApiClient());
@@ -1263,16 +1263,16 @@ public HttpResponse createCreditNoteAllocationForHttpResponse(String accessToken
     * @param xeroTenantId Xero identifier for Tenant
     * @param creditNoteID Unique identifier for a Credit Note
     * @param fileName Name of the file you are attaching to Credit Note
-    * @param includeOnline Set an attachment to be included with the invoice when viewed online (through Xero)
     * @param body Byte array of file in body of request
+    * @param includeOnline Allows an attachment to be seen by the end customer within their online invoice
     * @param accessToken Authorization token for user set in header of each request
     * @return Attachments
     * @throws IOException if an error occurs while attempting to invoke the API
     **/
-    public Attachments  createCreditNoteAttachmentByFileName(String accessToken, String xeroTenantId, UUID creditNoteID, String fileName, Boolean includeOnline, File body) throws IOException {
+    public Attachments  createCreditNoteAttachmentByFileName(String accessToken, String xeroTenantId, UUID creditNoteID, String fileName, File body, Boolean includeOnline) throws IOException {
         try {
             TypeReference<Attachments> typeRef = new TypeReference<Attachments>() {};
-            HttpResponse response = createCreditNoteAttachmentByFileNameForHttpResponse(accessToken, xeroTenantId, creditNoteID, fileName, includeOnline, body);
+            HttpResponse response = createCreditNoteAttachmentByFileNameForHttpResponse(accessToken, xeroTenantId, creditNoteID, fileName, body, includeOnline);
             return apiClient.getObjectMapper().readValue(response.getContent(), typeRef);
         } catch (HttpResponseException e) {
             XeroApiExceptionHandler handler = new XeroApiExceptionHandler();
@@ -1283,7 +1283,7 @@ public Attachments  createCreditNoteAttachmentByFileName(String accessToken, Str
         return null;
     }
 
-    public HttpResponse createCreditNoteAttachmentByFileNameForHttpResponse(String accessToken,  String xeroTenantId,  UUID creditNoteID,  String fileName,  Boolean includeOnline, File  body) throws IOException {
+    public HttpResponse createCreditNoteAttachmentByFileNameForHttpResponse(String accessToken,  String xeroTenantId,  UUID creditNoteID,  String fileName, File  body,  Boolean includeOnline) throws IOException {
         // verify the required parameter 'xeroTenantId' is set
         if (xeroTenantId == null) {
             throw new IllegalArgumentException("Missing the required parameter 'xeroTenantId' when calling createCreditNoteAttachmentByFileName");
@@ -1293,9 +1293,6 @@ public HttpResponse createCreditNoteAttachmentByFileNameForHttpResponse(String a
         }// verify the required parameter 'fileName' is set
         if (fileName == null) {
             throw new IllegalArgumentException("Missing the required parameter 'fileName' when calling createCreditNoteAttachmentByFileName");
-        }// verify the required parameter 'includeOnline' is set
-        if (includeOnline == null) {
-            throw new IllegalArgumentException("Missing the required parameter 'includeOnline' when calling createCreditNoteAttachmentByFileName");
         }// verify the required parameter 'body' is set
         if (body == null) {
             throw new IllegalArgumentException("Missing the required parameter 'body' when calling createCreditNoteAttachmentByFileName");
@@ -1314,9 +1311,19 @@ public HttpResponse createCreditNoteAttachmentByFileNameForHttpResponse(String a
         final Map<String, Object> uriVariables = new HashMap<String, Object>();
         uriVariables.put("CreditNoteID", creditNoteID);
         uriVariables.put("FileName", fileName);
-        uriVariables.put("IncludeOnline", includeOnline);
 
         UriBuilder uriBuilder = UriBuilder.fromUri(apiClient.getBasePath() + correctPath);
+        if (includeOnline != null) {
+            String key = "IncludeOnline";
+            Object value = includeOnline;
+            if (value instanceof Collection) {
+                uriBuilder = uriBuilder.queryParam(key, ((Collection) value).toArray());
+            } else if (value instanceof Object[]) {
+                uriBuilder = uriBuilder.queryParam(key, (Object[]) value);
+            } else {
+                uriBuilder = uriBuilder.queryParam(key, value);
+            }
+        }
         String url = uriBuilder.buildFromMap(uriVariables).toString();
         GenericUrl genericUrl = new GenericUrl(url);
 
@@ -1731,16 +1738,16 @@ public HttpResponse createExpenseClaimsForHttpResponse(String accessToken,  Stri
     * @param xeroTenantId Xero identifier for Tenant
     * @param invoiceID Unique identifier for an Invoice
     * @param fileName Name of the file you are attaching
-    * @param includeOnline Set an attachment to be included with the invoice when viewed online (through Xero)
     * @param body Byte array of file in body of request
+    * @param includeOnline Allows an attachment to be seen by the end customer within their online invoice
     * @param accessToken Authorization token for user set in header of each request
     * @return Attachments
     * @throws IOException if an error occurs while attempting to invoke the API
     **/
-    public Attachments  createInvoiceAttachmentByFileName(String accessToken, String xeroTenantId, UUID invoiceID, String fileName, Boolean includeOnline, File body) throws IOException {
+    public Attachments  createInvoiceAttachmentByFileName(String accessToken, String xeroTenantId, UUID invoiceID, String fileName, File body, Boolean includeOnline) throws IOException {
         try {
             TypeReference<Attachments> typeRef = new TypeReference<Attachments>() {};
-            HttpResponse response = createInvoiceAttachmentByFileNameForHttpResponse(accessToken, xeroTenantId, invoiceID, fileName, includeOnline, body);
+            HttpResponse response = createInvoiceAttachmentByFileNameForHttpResponse(accessToken, xeroTenantId, invoiceID, fileName, body, includeOnline);
             return apiClient.getObjectMapper().readValue(response.getContent(), typeRef);
         } catch (HttpResponseException e) {
             XeroApiExceptionHandler handler = new XeroApiExceptionHandler();
@@ -1751,7 +1758,7 @@ public Attachments  createInvoiceAttachmentByFileName(String accessToken, String
         return null;
     }
 
-    public HttpResponse createInvoiceAttachmentByFileNameForHttpResponse(String accessToken,  String xeroTenantId,  UUID invoiceID,  String fileName,  Boolean includeOnline, File  body) throws IOException {
+    public HttpResponse createInvoiceAttachmentByFileNameForHttpResponse(String accessToken,  String xeroTenantId,  UUID invoiceID,  String fileName, File  body,  Boolean includeOnline) throws IOException {
         // verify the required parameter 'xeroTenantId' is set
         if (xeroTenantId == null) {
             throw new IllegalArgumentException("Missing the required parameter 'xeroTenantId' when calling createInvoiceAttachmentByFileName");
@@ -1761,9 +1768,6 @@ public HttpResponse createInvoiceAttachmentByFileNameForHttpResponse(String acce
         }// verify the required parameter 'fileName' is set
         if (fileName == null) {
             throw new IllegalArgumentException("Missing the required parameter 'fileName' when calling createInvoiceAttachmentByFileName");
-        }// verify the required parameter 'includeOnline' is set
-        if (includeOnline == null) {
-            throw new IllegalArgumentException("Missing the required parameter 'includeOnline' when calling createInvoiceAttachmentByFileName");
         }// verify the required parameter 'body' is set
         if (body == null) {
             throw new IllegalArgumentException("Missing the required parameter 'body' when calling createInvoiceAttachmentByFileName");
@@ -1782,9 +1786,19 @@ public HttpResponse createInvoiceAttachmentByFileNameForHttpResponse(String acce
         final Map<String, Object> uriVariables = new HashMap<String, Object>();
         uriVariables.put("InvoiceID", invoiceID);
         uriVariables.put("FileName", fileName);
-        uriVariables.put("IncludeOnline", includeOnline);
 
         UriBuilder uriBuilder = UriBuilder.fromUri(apiClient.getBasePath() + correctPath);
+        if (includeOnline != null) {
+            String key = "IncludeOnline";
+            Object value = includeOnline;
+            if (value instanceof Collection) {
+                uriBuilder = uriBuilder.queryParam(key, ((Collection) value).toArray());
+            } else if (value instanceof Object[]) {
+                uriBuilder = uriBuilder.queryParam(key, (Object[]) value);
+            } else {
+                uriBuilder = uriBuilder.queryParam(key, value);
+            }
+        }
         String url = uriBuilder.buildFromMap(uriVariables).toString();
         GenericUrl genericUrl = new GenericUrl(url);
 

src/main/java/com/xero/api/client/AssetApi.java

@@ -45,7 +45,7 @@ public class AssetApi {
     private ApiClient apiClient;
     private static AssetApi instance = null;
     private String userAgent = "Default";
-    private String version = "3.5.2";
+    private String version = "3.6.0";
 
     public AssetApi() {
         this(new ApiClient());

src/main/java/com/xero/api/client/BankFeedsApi.java

@@ -45,7 +45,7 @@ public class BankFeedsApi {
     private ApiClient apiClient;
     private static BankFeedsApi instance = null;
     private String userAgent = "Default";
-    private String version = "3.5.2";
+    private String version = "3.6.0";
 
     public BankFeedsApi() {
         this(new ApiClient());

src/main/java/com/xero/api/client/IdentityApi.java

@@ -41,7 +41,7 @@ public class IdentityApi {
     private ApiClient apiClient;
     private static IdentityApi instance = null;
     private String userAgent = "Default";
-    private String version = "3.5.2";
+    private String version = "3.6.0";
 
     public IdentityApi() {
         this(new ApiClient());

src/main/java/com/xero/api/client/PayrollAuApi.java

@@ -59,7 +59,7 @@ public class PayrollAuApi {
     private ApiClient apiClient;
     private static PayrollAuApi instance = null;
     private String userAgent = "Default";
-    private String version = "3.5.2";
+    private String version = "3.6.0";
 
     public PayrollAuApi() {
         this(new ApiClient());