Merge pull request #81 from square/release/21.0.0.20220720

Generated PR for Release: 21.0.0.20220720

Author: Wolfgang Schuster

doc/api/catalog.md

@@ -170,10 +170,10 @@ bodyBatches0Objects0ItemDataVariations.add(bodyBatches0Objects0ItemDataVariation
 
 CatalogItem catalogItem = new CatalogItem.Builder()
     .name("Tea")
-    .description("Hot Leaf Juice")
     .categoryId("#Beverages")
     .taxIds(catalogItemTaxIds)
     .variations(catalogItemVariations)
+    .descriptionHtml("<p><strong>Hot</strong> Leaf Juice</p>")
     .build();
 CatalogObject bodyBatches0Objects0 = new CatalogObject.Builder(
         "ITEM",
@@ -215,10 +215,10 @@ bodyBatches0Objects1ItemDataVariations.add(bodyBatches0Objects1ItemDataVariation
 
 CatalogItem catalogItem = new CatalogItem.Builder()
     .name("Coffee")
-    .description("Hot Bean Juice")
     .categoryId("#Beverages")
     .taxIds(catalogItemTaxIds)
     .variations(catalogItemVariations)
+    .descriptionHtml("<p>Hot <em>Bean Juice</em></p>")
     .build();
 CatalogObject bodyBatches0Objects1 = new CatalogObject.Builder(
         "ITEM",
@@ -293,7 +293,7 @@ CompletableFuture<CreateCatalogImageResponse> createCatalogImageAsync(
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `request` | [`CreateCatalogImageRequest`](../../doc/models/create-catalog-image-request.md) | Form, Optional | - |
+| `request` | [`CreateCatalogImageRequest`](../../doc/models/create-catalog-image-request.md) | Form (JSON-Encoded), Optional | - |
 | `imageFile` | `FileWrapper` | Form, Optional | - |
 
 ## Response Type
@@ -345,7 +345,7 @@ CompletableFuture<UpdateCatalogImageResponse> updateCatalogImageAsync(
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `imageId` | `String` | Template, Required | The ID of the `CatalogImage` object to update the encapsulated image file. |
-| `request` | [`UpdateCatalogImageRequest`](../../doc/models/update-catalog-image-request.md) | Form, Optional | - |
+| `request` | [`UpdateCatalogImageRequest`](../../doc/models/update-catalog-image-request.md) | Form (JSON-Encoded), Optional | - |
 | `imageFile` | `FileWrapper` | Form, Optional | - |
 
 ## Response Type
@@ -491,9 +491,9 @@ bodyObjectItemDataVariations.add(bodyObjectItemDataVariations1);
 
 CatalogItem catalogItem = new CatalogItem.Builder()
     .name("Cocoa")
-    .description("Hot Chocolate")
     .abbreviation("Ch")
     .variations(catalogItemVariations)
+    .descriptionHtml("<p><strong>Hot</strong> Chocolate</p>")
     .build();
 CatalogObject catalogObject = new CatalogObject.Builder(
         "ITEM",

doc/api/customers.md

@@ -158,8 +158,8 @@ CustomerCreationSourceFilter customerCreationSourceFilter = new CustomerCreation
     .rule("INCLUDE")
     .build();
 TimeRange timeRange = new TimeRange.Builder()
-    .startAt("2018-01-01T00:00:00-00:00")
-    .endAt("2018-02-01T00:00:00-00:00")
+    .startAt("2018-01-01T00:00:00+00:00")
+    .endAt("2018-02-01T00:00:00+00:00")
     .build();
 CustomerTextFilter customerTextFilter = new CustomerTextFilter.Builder()
     .fuzzy("example.com")

doc/api/disputes.md

@@ -178,7 +178,7 @@ CompletableFuture<CreateDisputeEvidenceFileResponse> createDisputeEvidenceFileAs
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `disputeId` | `String` | Template, Required | The ID of the dispute you want to upload evidence for. |
-| `request` | [`CreateDisputeEvidenceFileRequest`](../../doc/models/create-dispute-evidence-file-request.md) | Form, Optional | Defines the parameters for a `CreateDisputeEvidenceFile` request. |
+| `request` | [`CreateDisputeEvidenceFileRequest`](../../doc/models/create-dispute-evidence-file-request.md) | Form (JSON-Encoded), Optional | Defines the parameters for a `CreateDisputeEvidenceFile` request. |
 | `imageFile` | `FileWrapper` | Form, Optional | - |
 
 ## Response Type

doc/api/inventory.md

@@ -190,8 +190,8 @@ BatchRetrieveInventoryChangesRequest body = new BatchRetrieveInventoryChangesReq
     .locationIds(bodyLocationIds)
     .types(bodyTypes)
     .states(bodyStates)
-    .updatedAfter("2016-11-01T00:00:00.000Z")
-    .updatedBefore("2016-12-01T00:00:00.000Z")
+    .updatedAfter("2016-11-01T00:00:00Z")
+    .updatedBefore("2016-12-01T00:00:00Z")
     .build();
 
 inventoryApi.deprecatedBatchRetrieveInventoryChangesAsync(body).thenAccept(result -> {
@@ -235,7 +235,7 @@ bodyLocationIds.add("59TNP9SA8VGDA");
 BatchRetrieveInventoryCountsRequest body = new BatchRetrieveInventoryCountsRequest.Builder()
     .catalogObjectIds(bodyCatalogObjectIds)
     .locationIds(bodyLocationIds)
-    .updatedAfter("2016-11-16T00:00:00.000Z")
+    .updatedAfter("2016-11-16T00:00:00Z")
     .build();
 
 inventoryApi.deprecatedBatchRetrieveInventoryCountsAsync(body).thenAccept(result -> {
@@ -347,8 +347,8 @@ BatchRetrieveInventoryChangesRequest body = new BatchRetrieveInventoryChangesReq
     .locationIds(bodyLocationIds)
     .types(bodyTypes)
     .states(bodyStates)
-    .updatedAfter("2016-11-01T00:00:00.000Z")
-    .updatedBefore("2016-12-01T00:00:00.000Z")
+    .updatedAfter("2016-11-01T00:00:00Z")
+    .updatedBefore("2016-12-01T00:00:00Z")
     .build();
 
 inventoryApi.batchRetrieveInventoryChangesAsync(body).thenAccept(result -> {
@@ -399,7 +399,7 @@ bodyLocationIds.add("59TNP9SA8VGDA");
 BatchRetrieveInventoryCountsRequest body = new BatchRetrieveInventoryCountsRequest.Builder()
     .catalogObjectIds(bodyCatalogObjectIds)
     .locationIds(bodyLocationIds)
-    .updatedAfter("2016-11-16T00:00:00.000Z")
+    .updatedAfter("2016-11-16T00:00:00Z")
     .build();
 
 inventoryApi.batchRetrieveInventoryCountsAsync(body).thenAccept(result -> {

doc/api/labor.md

@@ -354,19 +354,19 @@ ShiftWage shiftWage = new ShiftWage.Builder()
 List<Break> bodyShiftBreaks = new LinkedList<>();
 
 Break bodyShiftBreaks0 = new Break.Builder(
-        "2019-01-25T06:11:00-05:00",
+        "2019-01-25T11:11:00+00:00",
         "REGS1EQR1TPZ5",
         "Tea Break",
         "PT5M",
         true)
-    .endAt("2019-01-25T06:16:00-05:00")
+    .endAt("2019-01-25T11:16:00+00:00")
     .build();
 bodyShiftBreaks.add(bodyShiftBreaks0);
 
 Shift shift = new Shift.Builder(
-        "2019-01-25T03:11:00-05:00")
+        "2019-01-25T08:11:00+00:00")
     .locationId("PAA1RJZZKXBFG")
-    .endAt("2019-01-25T13:11:00-05:00")
+    .endAt("2019-01-25T18:11:00+00:00")
     .wage(shiftWage)
     .breaks(shiftBreaks)
     .teamMemberId("ormj0jJJZ5OZIzxrZYJI")
@@ -422,7 +422,24 @@ CompletableFuture<SearchShiftsResponse> searchShiftsAsync(
 ## Example Usage
 
 ```java
+DateRange dateRange = new DateRange.Builder()
+    .startDate("2019-01-20")
+    .endDate("2019-02-03")
+    .build();
+ShiftWorkday shiftWorkday = new ShiftWorkday.Builder()
+    .dateRange(shiftWorkdayDateRange)
+    .matchShiftsBy("START_AT")
+    .defaultTimezone("America/Los_Angeles")
+    .build();
+ShiftFilter shiftFilter = new ShiftFilter.Builder()
+    .workday(shiftFilterWorkday)
+    .build();
+ShiftQuery shiftQuery = new ShiftQuery.Builder()
+    .filter(shiftQueryFilter)
+    .build();
 SearchShiftsRequest body = new SearchShiftsRequest.Builder()
+    .query(bodyQuery)
+    .limit(100)
     .build();
 
 laborApi.searchShiftsAsync(body).thenAccept(result -> {
@@ -542,20 +559,20 @@ ShiftWage shiftWage = new ShiftWage.Builder()
 List<Break> bodyShiftBreaks = new LinkedList<>();
 
 Break bodyShiftBreaks0 = new Break.Builder(
-        "2019-01-25T06:11:00-05:00",
+        "2019-01-25T11:11:00+00:00",
         "REGS1EQR1TPZ5",
         "Tea Break",
         "PT5M",
         true)
     .id("X7GAQYVVRRG6P")
-    .endAt("2019-01-25T06:16:00-05:00")
+    .endAt("2019-01-25T11:16:00+00:00")
     .build();
 bodyShiftBreaks.add(bodyShiftBreaks0);
 
 Shift shift = new Shift.Builder(
-        "2019-01-25T03:11:00-05:00")
+        "2019-01-25T08:11:00+00:00")
     .locationId("PAA1RJZZKXBFG")
-    .endAt("2019-01-25T13:11:00-05:00")
+    .endAt("2019-01-25T18:11:00+00:00")
     .wage(shiftWage)
     .breaks(shiftBreaks)
     .version(1)

doc/api/orders.md

@@ -418,7 +418,7 @@ An `UpdateOrder` request requires the following:
 
 - The `order_id` in the endpoint path, identifying the order to update.
 - The latest `version` of the order to update.
-- The [sparse order](https://developer.squareup.com/docs/orders-api/manage-orders#sparse-order-objects)
+- The [sparse order](https://developer.squareup.com/docs/orders-api/manage-orders/update-orders#sparse-order-objects)
   containing only the fields to update and the version to which the update is
   being applied.
 - If deleting fields, the [dot notation paths](https://developer.squareup.com/docs/orders-api/manage-orders#on-dot-notation)

doc/api/subscriptions.md

@@ -204,17 +204,7 @@ CompletableFuture<UpdateSubscriptionResponse> updateSubscriptionAsync(
 
 ```java
 String subscriptionId = "subscription_id0";
-Money money = new Money.Builder()
-    .amount(2000L)
-    .currency("USD")
-    .build();
-Subscription subscription = new Subscription.Builder()
-    .taxPercentage("null")
-    .priceOverrideMoney(subscriptionPriceOverrideMoney)
-    .version(1594155459464L)
-    .build();
 UpdateSubscriptionRequest body = new UpdateSubscriptionRequest.Builder()
-    .subscription(bodySubscription)
     .build();
 
 subscriptionsApi.updateSubscriptionAsync(subscriptionId, body).thenAccept(result -> {

doc/api/terminal.md

@@ -93,7 +93,7 @@ CompletableFuture<SearchTerminalActionsResponse> searchTerminalActionsAsync(
 
 ```java
 TimeRange timeRange = new TimeRange.Builder()
-    .startAt("2022-04-01T00:00:00.000Z")
+    .startAt("2022-04-01T00:00:00Z")
     .build();
 TerminalActionQueryFilter terminalActionQueryFilter = new TerminalActionQueryFilter.Builder()
     .createdAt(terminalActionQueryFilterCreatedAt)

doc/client.md

@@ -5,7 +5,7 @@ The following parameters are configurable for the API Client:
 
 | Parameter | Type | Description |
 |  --- | --- | --- |
-| `squareVersion` | `String` | Square Connect API versions<br>*Default*: `"2022-06-16"` |
+| `squareVersion` | `String` | Square Connect API versions<br>*Default*: `"2022-07-20"` |
 | `customUrl` | `String` | Sets the base URL requests are made to. Defaults to `https://connect.squareup.com`<br>*Default*: `"https://connect.squareup.com"` |
 | `environment` | `string` | The API environment. <br> **Default: `production`** |
 | `httpClientConfig` | `ReadonlyHttpClientConfiguration` | Http Client Configuration instance. |
@@ -19,7 +19,7 @@ The API client can be initialized as follows:
 SquareClient client = new SquareClient.Builder()
     .httpClientConfig(configBuilder -> configBuilder
             .timeout(0))
-    .squareVersion("2022-06-16")
+    .squareVersion("2022-07-20")
     .accessToken("AccessToken")
     .environment(Environment.PRODUCTION)
     .customUrl("https://connect.squareup.com")
@@ -45,7 +45,7 @@ public class Program {
         SquareClient client = new SquareClient.Builder()
             .httpClientConfig(configBuilder -> configBuilder
                     .timeout(0))
-            .squareVersion("2022-06-16")
+            .squareVersion("2022-07-20")
             .accessToken("AccessToken")
             .build();
 

doc/models/batch-retrieve-inventory-changes-request.md

@@ -16,7 +16,7 @@
 | `UpdatedAfter` | `String` | Optional | The filter to return results with their `calculated_at` value<br>after the given time as specified in an RFC 3339 timestamp.<br>The default value is the UNIX epoch of (`1970-01-01T00:00:00Z`). | String getUpdatedAfter() |
 | `UpdatedBefore` | `String` | Optional | The filter to return results with their `created_at` or `calculated_at` value<br>strictly before the given time as specified in an RFC 3339 timestamp.<br>The default value is the UNIX epoch of (`1970-01-01T00:00:00Z`). | String getUpdatedBefore() |
 | `Cursor` | `String` | Optional | A pagination cursor returned by a previous call to this endpoint.<br>Provide this to retrieve the next set of results for the original query.<br><br>See the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information. | String getCursor() |
-| `Limit` | `Integer` | Optional | **Constraints**: `>= 1`, `<= 1000` | Integer getLimit() |
+| `Limit` | `Integer` | Optional | The number of [records](../../doc/models/inventory-change.md) to return.<br>**Constraints**: `>= 1`, `<= 1000` | Integer getLimit() |
 
 ## Example (as JSON)