Skip to content

Commit

Permalink
Merge pull request #310 from XeroAPI/minor-spec-updates
Browse files Browse the repository at this point in the history
minor updates to finance, payrollUK, and appStore apis
  • Loading branch information
rdemarco-xero authored Apr 29, 2022
2 parents b702661 + ebf902b commit 487d7cb
Show file tree
Hide file tree
Showing 25 changed files with 550 additions and 83 deletions.
130 changes: 128 additions & 2 deletions docs/v4/accounting/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6004,7 +6004,7 @@
<nav id="scrollingNav">
<ul class="sidenav nav nav-list">
<li class="nav-header" data-group="Accounting"><strong>SDK: </strong><span id='sdk-name'></span></li>
<li class="nav-header" data-group="Accounting"><strong>VSN: </strong>4.15.1</li>
<li class="nav-header" data-group="Accounting"><strong>VSN: </strong>4.16.0</li>
<li class="nav-header" data-group="Accounting"><a href="#api-Accounting">Methods</a></li>
<li data-group="Accounting" data-name="createAccount" class="">
<a href="#api-Accounting-createAccount">createAccount</a>
Expand Down Expand Up @@ -6375,6 +6375,9 @@
<li data-group="Accounting" data-name="getJournal" class="">
<a href="#api-Accounting-getJournal">getJournal</a>
</li>
<li data-group="Accounting" data-name="getJournalByNumber" class="">
<a href="#api-Accounting-getJournalByNumber">getJournalByNumber</a>
</li>
<li data-group="Accounting" data-name="getJournals" class="">
<a href="#api-Accounting-getJournals">getJournals</a>
</li>
Expand Down Expand Up @@ -9419,7 +9422,7 @@ <h2>Parameters</h2>
"schema" : {
"$ref" : "#/components/schemas/Contacts"
},
"example" : "{ \"Id\": \"e997d6d7-6dad-4458-beb8-d9c1bf7f2edf\", \"Status\": \"OK\", \"ProviderName\": \"Xero API Partner\", \"DateTimeUTC\": \"/Date(1551399321121)/\", \"Contacts\": [ { \"ContactID\": \"3ff6d40c-af9a-40a3-89ce-3c1556a25591\", \"ContactStatus\": \"ACTIVE\", \"Name\": \"Foo9987\", \"EmailAddress\": \"[email protected]\", \"BankAccountDetails\": \"\", \"Addresses\": [ { \"AddressType\": \"STREET\", \"City\": \"\", \"Region\": \"\", \"PostalCode\": \"\", \"Country\": \"\" }, { \"AddressType\": \"POBOX\", \"City\": \"\", \"Region\": \"\", \"PostalCode\": \"\", \"Country\": \"\" } ], \"Phones\": [ { \"PhoneType\": \"DEFAULT\", \"PhoneNumber\": \"\", \"PhoneAreaCode\": \"\", \"PhoneCountryCode\": \"\" }, { \"PhoneType\": \"DDI\", \"PhoneNumber\": \"\", \"PhoneAreaCode\": \"\", \"PhoneCountryCode\": \"\" }, { \"PhoneType\": \"FAX\", \"PhoneNumber\": \"\", \"PhoneAreaCode\": \"\", \"PhoneCountryCode\": \"\" }, { \"PhoneType\": \"MOBILE\", \"PhoneNumber\": \"555-1212\", \"PhoneAreaCode\": \"415\", \"PhoneCountryCode\": \"\" } ], \"UpdatedDateUTC\": \"/Date(1551399321043+0000)/\", \"ContactGroups\": [], \"IsSupplier\": false, \"IsCustomer\": false, \"SalesTrackingCategories\": [], \"PurchasesTrackingCategories\": [], \"PaymentTerms\": { \"Bills\": { \"Day\": 15, \"Type\": \"OFCURRENTMONTH\" }, \"Sales\": { \"Day\": 10, \"Type\": \"DAYSAFTERBILLMONTH\" } }, \"ContactPersons\": [], \"HasValidationErrors\": false } ] }"
"example" : "{ \"Contacts\": [ { \"ContactID\": \"3ff6d40c-af9a-40a3-89ce-3c1556a25591\", \"ContactStatus\": \"ACTIVE\", \"Name\": \"Foo9987\", \"EmailAddress\": \"[email protected]\", \"BankAccountDetails\": \"\", \"Addresses\": [ { \"AddressType\": \"STREET\", \"City\": \"\", \"Region\": \"\", \"PostalCode\": \"\", \"Country\": \"\" }, { \"AddressType\": \"POBOX\", \"City\": \"\", \"Region\": \"\", \"PostalCode\": \"\", \"Country\": \"\" } ], \"Phones\": [ { \"PhoneType\": \"DEFAULT\", \"PhoneNumber\": \"\", \"PhoneAreaCode\": \"\", \"PhoneCountryCode\": \"\" }, { \"PhoneType\": \"DDI\", \"PhoneNumber\": \"\", \"PhoneAreaCode\": \"\", \"PhoneCountryCode\": \"\" }, { \"PhoneType\": \"FAX\", \"PhoneNumber\": \"\", \"PhoneAreaCode\": \"\", \"PhoneCountryCode\": \"\" }, { \"PhoneType\": \"MOBILE\", \"PhoneNumber\": \"555-1212\", \"PhoneAreaCode\": \"415\", \"PhoneCountryCode\": \"\" } ], \"UpdatedDateUTC\": \"/Date(1551399321043+0000)/\", \"ContactGroups\": [], \"IsSupplier\": false, \"IsCustomer\": false, \"SalesTrackingCategories\": [], \"PurchasesTrackingCategories\": [], \"PaymentTerms\": { \"Bills\": { \"Day\": 15, \"Type\": \"OFCURRENTMONTH\" }, \"Sales\": { \"Day\": 10, \"Type\": \"DAYSAFTERBILLMONTH\" } }, \"ContactPersons\": [] } ] }"
}
},
"required" : true
Expand Down Expand Up @@ -26824,6 +26827,129 @@ <h2>Parameters</h2>
</div>
</div>
</td>
</tr>

</table>
</article>
</div>
<hr>
<div id="api-Accounting-getJournalByNumber">
<article id="api-Accounting-getJournalByNumber-0" data-group="User" data-name="getJournalByNumber" data-version="0">
<div class="pull-left">
<h1>getJournalByNumber</h1>
<p>Retrieves a specific journal using a unique journal number.</p>
</div>
<div class="pull-right"></div>
<div class="clearfix"></div>
<p></p>
<p class="marked"></p>
<p></p>
<br />
<pre class="prettyprint language-html prettyprinted" data-type="get"><code><span class="pln">/Journals/{JournalNumber}</span></code></pre>
<p>
<h3>Usage and SDK Samples</h3>
</p>
<ul class="nav nav-tabs nav-tabs-examples">
<li class=""><a href="#examples-Accounting-getJournalByNumber-0-java">Java</a></li>
</ul>
<div class="tab-content">
<div class="tab-pane" id="examples-Accounting-getJournalByNumber-0-java">
<pre class="prettyprint"><code class="language-java">import org.openapitools.client.api.*;
import org.openapitools.client.api.client.AccountingApi;
import org.openapitools.client.models.accounting.*;

import java.io.File;
import java.util.*;

public class AccountingApiExample {
private AccountingApi apiInstance;

public static void main(String[] args) {
String accessToken = "YOUR_ACCESS_TOKEN";
ApiClient defaultClient = new ApiClient();

apiInstance = AccountingApi.getInstance(defaultClient);
String xeroTenantId = 'YOUR_XERO_TENANT_ID';
Integer journalNumber = 1000;

try {
Journals result = apiInstance.getJournalByNumber(accessToken, xeroTenantId, journalNumber);
System.out.println(result);
} catch (XeroException e) {
System.err.println("Exception when calling AccountingApi#getJournalByNumber");
e.printStackTrace();
}
}
}</code></pre>
</div>
</div>
<h2>Scopes</h2>
<table>

<tr>
<td>accounting.journals.read</td>
<td>Grant read-only access to journals</td>
</tr>

</table>
<h2>Parameters</h2>
<div class="methodsubtabletitle">Path parameters</div>
<table id="methodsubtable">
<tr>
<th width="150px">Name</th>
<th>Description</th>
</tr>
<tr><td style="width:150px;">JournalNumber<span style="color:red;">*</span></td>
<td>


<div id="d2e199_getJournalByNumber_journalNumber">
<div class="json-schema-view">
<div class="primitive">
<span class="type">
Integer
</span>

<div class="inner description marked">
Number of a Journal
</div>
</div>
<div class="inner required">
Required
</div>
</div>
</div>
</td>
</tr>

</table>
<div class="methodsubtabletitle">Header parameters</div>
<table id="methodsubtable">
<tr>
<th width="150px">Name</th>
<th>Description</th>
</tr>
<tr><td style="width:150px;">xero-tenant-id<span style="color:red;">*</span></td>
<td>


<div id="d2e199_getJournalByNumber_xeroTenantId">
<div class="json-schema-view">
<div class="primitive">
<span class="type">
String
</span>

<div class="inner description marked">
Xero identifier for Tenant
</div>
</div>
<div class="inner required">
Required
</div>
</div>
</div>
</td>
</tr>

</table>
Expand Down
18 changes: 13 additions & 5 deletions docs/v4/appstore/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -949,14 +949,18 @@
"type" : "string",
"description" : "The name of the product"
},
"seatUnit" : {
"type" : "string",
"description" : "The unit of the per seat product. e.g. \"user\", \"organisation\", \"SMS\", etc"
},
"type" : {
"type" : "string",
"description" : "The pricing model of the product:\n* FIXED: Customers are charged a fixed amount for each billing period\n* PER_SEAT: Customers are charged based on the number of units they purchase\n",
"enum" : [ "FIXED", "PER_SEAT" ]
"description" : "The pricing model of the product:\n* FIXED: Customers are charged a fixed amount for each billing period\n* PER_SEAT: Customers are charged based on the number of units they purchase\n* METERED: Customers are charged per use of this product\n",
"enum" : [ "FIXED", "PER_SEAT", "METERED" ]
},
"seatUnit" : {
"usageUnit" : {
"type" : "string",
"description" : "The unit of the per seat product. e.g. \"user\", \"organisation\", \"SMS\", etc"
"description" : "The unit of the usage product. e.g. \"user\", \"minutes\", \"SMS\", etc"
}
},
"description" : ""
Expand Down Expand Up @@ -1031,6 +1035,10 @@
"product" : {
"$ref" : "#/components/schemas/Product"
},
"quantity" : {
"type" : "integer",
"description" : "The quantity of the item. For a fixed product, it is 1. For a per-seat product, it is a positive integer. For metered products, it is always null."
},
"startDate" : {
"type" : "string",
"description" : "Date the subscription started, or will start. Note: this could be in\nthe future for downgrades or reduced number of seats that haven't taken effect yet.\n",
Expand Down Expand Up @@ -1129,7 +1137,7 @@
<nav id="scrollingNav">
<ul class="sidenav nav nav-list">
<li class="nav-header" data-group="AppStore"><strong>SDK: </strong><span id='sdk-name'></span></li>
<li class="nav-header" data-group="AppStore"><strong>VSN: </strong>4.15.1</li>
<li class="nav-header" data-group="AppStore"><strong>VSN: </strong>4.16.0</li>
<li class="nav-header" data-group="AppStore"><a href="#api-AppStore">Methods</a></li>
<li data-group="AppStore" data-name="getSubscription" class="">
<a href="#api-AppStore-getSubscription">getSubscription</a>
Expand Down
5 changes: 3 additions & 2 deletions docs/v4/assets/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1007,7 +1007,8 @@
"example" : 33
}
},
"description" : ""
"description" : "",
"x-snake" : "asset_type"
};
defs["Assets"] = {
"title" : "",
Expand Down Expand Up @@ -1387,7 +1388,7 @@
<nav id="scrollingNav">
<ul class="sidenav nav nav-list">
<li class="nav-header" data-group="Asset"><strong>SDK: </strong><span id='sdk-name'></span></li>
<li class="nav-header" data-group="Asset"><strong>VSN: </strong>4.15.1</li>
<li class="nav-header" data-group="Asset"><strong>VSN: </strong>4.16.0</li>
<li class="nav-header" data-group="Asset"><a href="#api-Asset">Methods</a></li>
<li data-group="Asset" data-name="createAsset" class="">
<a href="#api-Asset-createAsset">createAsset</a>
Expand Down
2 changes: 1 addition & 1 deletion docs/v4/files/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1151,7 +1151,7 @@
<nav id="scrollingNav">
<ul class="sidenav nav nav-list">
<li class="nav-header" data-group="Files"><strong>SDK: </strong><span id='sdk-name'></span></li>
<li class="nav-header" data-group="Files"><strong>VSN: </strong>4.15.1</li>
<li class="nav-header" data-group="Files"><strong>VSN: </strong>4.16.0</li>
<li class="nav-header" data-group="Files"><a href="#api-Files">Methods</a></li>
<li data-group="Files" data-name="createFileAssociation" class="">
<a href="#api-Files-createFileAssociation">createFileAssociation</a>
Expand Down
16 changes: 14 additions & 2 deletions docs/v4/finance/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2343,7 +2343,19 @@
},
"importSource" : {
"type" : "string",
"description" : "Import source of statement (STMTIMPORTSRC/MANUAL, STMTIMPORTSRC/CSV, STMTIMPORTSRC/QIF, STMTIMPORTSRC/OFX, XeroApi)"
"description" : "Indicates the source of the statement data. Either imported from 1) direct bank feed OR 2) manual customer entry or upload. Manual import sources are STMTIMPORTSRC/MANUAL, STMTIMPORTSRC/CSV, STMTIMPORTSRC/OFX, Ofx or STMTIMPORTSRC/QIF. All other import sources are direct and, depending on the direct solution, may contain the name of the financial institution."
},
"startBalance" : {
"type" : "number",
"description" : "Opening balance sourced from imported bank statements (if supplied). Note, for manually uploaded statements, this balance is also manual and usually not supplied.",
"format" : "double",
"x-is-money" : true
},
"endBalance" : {
"type" : "number",
"description" : "Closing balance sourced from imported bank statements (if supplied). Note, for manually uploaded statements, this balance is also manual and usually not supplied.",
"format" : "double",
"x-is-money" : true
},
"statementLines" : {
"type" : "array",
Expand Down Expand Up @@ -2702,7 +2714,7 @@
<nav id="scrollingNav">
<ul class="sidenav nav nav-list">
<li class="nav-header" data-group="Finance"><strong>SDK: </strong><span id='sdk-name'></span></li>
<li class="nav-header" data-group="Finance"><strong>VSN: </strong>4.15.1</li>
<li class="nav-header" data-group="Finance"><strong>VSN: </strong>4.16.0</li>
<li class="nav-header" data-group="Finance"><a href="#api-Finance">Methods</a></li>
<li data-group="Finance" data-name="getAccountingActivityAccountUsage" class="">
<a href="#api-Finance-getAccountingActivityAccountUsage">getAccountingActivityAccountUsage</a>
Expand Down
2 changes: 1 addition & 1 deletion docs/v4/payroll-au/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -3250,7 +3250,7 @@
<nav id="scrollingNav">
<ul class="sidenav nav nav-list">
<li class="nav-header" data-group="PayrollAu"><strong>SDK: </strong><span id='sdk-name'></span></li>
<li class="nav-header" data-group="PayrollAu"><strong>VSN: </strong>4.15.1</li>
<li class="nav-header" data-group="PayrollAu"><strong>VSN: </strong>4.16.0</li>
<li class="nav-header" data-group="PayrollAu"><a href="#api-PayrollAu">Methods</a></li>
<li data-group="PayrollAu" data-name="createEmployee" class="">
<a href="#api-PayrollAu-createEmployee">createEmployee</a>
Expand Down
2 changes: 1 addition & 1 deletion docs/v4/payroll-nz/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -3834,7 +3834,7 @@
<nav id="scrollingNav">
<ul class="sidenav nav nav-list">
<li class="nav-header" data-group="PayrollNz"><strong>SDK: </strong><span id='sdk-name'></span></li>
<li class="nav-header" data-group="PayrollNz"><strong>VSN: </strong>4.15.1</li>
<li class="nav-header" data-group="PayrollNz"><strong>VSN: </strong>4.16.0</li>
<li class="nav-header" data-group="PayrollNz"><a href="#api-PayrollNz">Methods</a></li>
<li data-group="PayrollNz" data-name="approveTimesheet" class="">
<a href="#api-PayrollNz-approveTimesheet">approveTimesheet</a>
Expand Down
4 changes: 2 additions & 2 deletions docs/v4/payroll-uk/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2276,7 +2276,7 @@
"type" : "string",
"description" : "The NI Category of the employee",
"example" : "A",
"enum" : [ "A", "B", "C", "H", "J", "M", "Z", "X" ]
"enum" : [ "A", "B", "C", "F", "H", "I", "J", "L", "M", "S", "V", "X", "Z" ]
}
},
"description" : ""
Expand Down Expand Up @@ -3506,7 +3506,7 @@
<nav id="scrollingNav">
<ul class="sidenav nav nav-list">
<li class="nav-header" data-group="PayrollUk"><strong>SDK: </strong><span id='sdk-name'></span></li>
<li class="nav-header" data-group="PayrollUk"><strong>VSN: </strong>4.15.1</li>
<li class="nav-header" data-group="PayrollUk"><strong>VSN: </strong>4.16.0</li>
<li class="nav-header" data-group="PayrollUk"><a href="#api-PayrollUk">Methods</a></li>
<li data-group="PayrollUk" data-name="approveTimesheet" class="">
<a href="#api-PayrollUk-approveTimesheet">approveTimesheet</a>
Expand Down
2 changes: 1 addition & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<artifactId>xero-java</artifactId>
<packaging>jar</packaging>
<name>xero-java</name>
<version>4.15.1</version>
<version>4.16.0</version>
<url>https://github.com/XeroAPI/Xero-Java</url>
<description>This is the official Java SDK for Xero API</description>
<licenses>
Expand Down
Loading

0 comments on commit 487d7cb

Please sign in to comment.