Merge pull request #24 from square/release/6.3.0.20200826

release 6.3.0.20200826

Author: okenshields

CHANGELOG.md

@@ -1,5 +1,35 @@
 # Change Log
 
+## Version 6.3.0.20200826 (2020-08-26)
+## Existing API updates
+* Orders API
+  * [Order](https://developer.squareup.com/reference/square_2020-08-26/objects/Order) object. The `total_tip_money` field is now GA.
+  * [CreateOrder](https://developer.squareup.com/reference/square_2020-08-26/orders-api/create-order), [UpdateOrder](https://developer.squareup.com/reference/square_2020-08-26/orders-api/update-order), and [BatchRetrieveOrders](https://developer.squareup.com/reference/square_2020-08-26/orders-api/batch-retrieve-orders). These APIs now support merchant-scoped endpoints (for example, the `CreateOrder` endpoint `POST /v2/orders`). The location-scoped variants of these endpoints (for example, the `CreateOrder` endpoint `POST /v2/locations/{location_id}/orders`) continue to work, but these endpoints are now deprecated. You should use the merchant-scoped endpoints (you provide the location information in the request body).
+* Labor API
+	* [Migrate from Employees to Team Members.](https://developer.squareup.com/docs/labor-api/migrate-to-teams) The Employees API is now deprecated in this release. Accordingly, update references to the  `Shift.employee_id` field to the `Shift.team_member_id` field of the Labor API.
+* v2 Employees API (deprecated)
+	* [Migrate from the Square Employees API.](https://developer.squareup.com/docs/team/migrate-from-v2-employees) The v2 Employees API is now deprecated. This topic provides information to migrate to the Team API.
+* v1 Employees API (deprecated)
+	* [Migrate from the v1 Employees API.](https://developer.squareup.com/docs/migrate-from-v1/guides/v1-employees) The v1 Employees API is now deprecated. This topic provides information to migrate to the Team API. 
+
+## Documentation updates
+* Point of Sale API
+	* [Build on iOS.](https://developer.squareup.com/docs/pos-api/build-on-ios) Corrected the Swift example code in step 7.
+* Team API
+	* [Team API Overview.](https://developer.squareup.com/docs/team/overview) Documented the limitation related to creating a team member in the Square Sandbox.
+
+## All SDKs
+
+SDK technical reference documentation:
+
+* Nulls in SDK documentation example code are replaced with example values.
+
+## .NET SDK
+
+Bug fixes:
+
+* The `APIException.Errors` property was not set on instantiation. Behavior is now corrected to instantiate the class with an empty `Errors` list.
+
 ## Version 6.2.0.20200812 (2020-08-12)
 ## API releases
 * Subscriptions API (beta):

README.md

@@ -33,7 +33,7 @@ Install the client dynamically by adding a dependency to the POM for your projec
 <dependency>
     <groupId>com.squareup</groupId>
     <artifactId>square</artifactId>
-    <version>6.2.0.20200812</version>
+    <version>6.3.0.20200826</version>
 </dependency>
 ```
 
@@ -42,7 +42,7 @@ Install the client dynamically by adding a dependency to the POM for your projec
 Install the client by adding the following dependency to the build file for your project:
 
 ```
-implementation "com.squareup:square:6.2.0.20200812"
+implementation "com.squareup:square:6.3.0.20200826"
 ```
 
 ## API documentation
@@ -100,7 +100,6 @@ implementation "com.squareup:square:6.2.0.20200812"
 * [V1 Transactions]
 * [V1 Items]
 * [Transactions]
-* [Reporting]
 
 ## Usage
 
@@ -323,7 +322,6 @@ You can also use the Square API to create applications or services that work wit
 [Invoices]: doc/invoices.md
 [Apple Pay]: doc/apple-pay.md
 [Refunds]: doc/refunds.md
-[Reporting]: doc/reporting.md
 [Mobile Authorization]: doc/mobile-authorization.md
 [O Auth]: doc/o-auth.md
 [V1 Locations]: doc/v1-locations.md

doc/bank-accounts.md

@@ -42,7 +42,11 @@ CompletableFuture<ListBankAccountsResponse> listBankAccountsAsync(
 ### Example Usage
 
 ```java
-bankAccountsApi.listBankAccountsAsync(null, null, null).thenAccept(result -> {
+String cursor = "cursor6";
+Integer limit = 172;
+String locationId = "location_id4";
+
+bankAccountsApi.listBankAccountsAsync(cursor, limit, locationId).thenAccept(result -> {
     // TODO success callback handler
 }).exceptionally(exception -> {
     // TODO failure callback handler

doc/cash-drawers.md

@@ -48,8 +48,13 @@ CompletableFuture<ListCashDrawerShiftsResponse> listCashDrawerShiftsAsync(
 
 ```java
 String locationId = "location_id4";
+String sortOrder = "DESC";
+String beginTime = "begin_time2";
+String endTime = "end_time2";
+Integer limit = 172;
+String cursor = "cursor6";
 
-cashDrawersApi.listCashDrawerShiftsAsync(locationId, null, null, null, null, null).thenAccept(result -> {
+cashDrawersApi.listCashDrawerShiftsAsync(locationId, sortOrder, beginTime, endTime, limit, cursor).thenAccept(result -> {
     // TODO success callback handler
 }).exceptionally(exception -> {
     // TODO failure callback handler
@@ -123,8 +128,10 @@ CompletableFuture<ListCashDrawerShiftEventsResponse> listCashDrawerShiftEventsAs
 ```java
 String locationId = "location_id4";
 String shiftId = "shift_id0";
+Integer limit = 172;
+String cursor = "cursor6";
 
-cashDrawersApi.listCashDrawerShiftEventsAsync(locationId, shiftId, null, null).thenAccept(result -> {
+cashDrawersApi.listCashDrawerShiftEventsAsync(locationId, shiftId, limit, cursor).thenAccept(result -> {
     // TODO success callback handler
 }).exceptionally(exception -> {
     // TODO failure callback handler