Skip to content
This repository was archived by the owner on Apr 23, 2021. It is now read-only.

Commit 15bee72

Browse files
Merge pull request #85 from square/release/2.20191120.0
Release 2.20191120.0
2 parents 0487f14 + fcb6006 commit 15bee72

File tree

376 files changed

+3439
-1435
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

376 files changed

+3439
-1435
lines changed

CHANGES.md

+13
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,20 @@
11
# Change Log
22

3+
## Version 2.20191120.0 (2019-11-20)
4+
!!!important
5+
Square has begun the retirement process for Connect v1 APIs. See the [Connect v1 Retirement](/migrate-from-v1) information page for details.
6+
!!!
7+
8+
* __GA releases:__ SDKs now support the new `modify_tax_basis` field to Discounts and v2 Sandbox
9+
* __BETA releases:__ SDKs now support the Shifts API webhooks for Labor shift created, updated, deleted, CreateLocation endpoint, and the ability to customize statement description in Payments API.
10+
* **Deprecated**: Support for v1Items API and v1Locations API is fully deprecated.
11+
12+
13+
14+
315
## Version 2.20191023.0 (2019-10-23)
416
* **GA release**: Merchants.ListMerchant is GA for all SDKs.
17+
* **Beta release**: All SDKs support new Locations API endpoint, CreateLocation.
518
* **Beta release**: All SDKs support exclusion strategies for pricing rules.
619

720

README.md

+23-10
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Add this dependency to your project's POM:
2626
<dependency>
2727
<groupId>com.squareup</groupId>
2828
<artifactId>connect</artifactId>
29-
<version>2.20191023.0</version>
29+
<version>2.20191120.0</version>
3030
<scope>compile</scope>
3131
</dependency>
3232
```
@@ -36,7 +36,7 @@ Add this dependency to your project's POM:
3636
Add this dependency to your project's build file:
3737

3838
```groovy
39-
compile "com.squareup:connect:2.20191023.0"
39+
compile "com.squareup:connect:2.20191120.0"
4040
```
4141

4242
### Option 3: Build and Install locally
@@ -78,7 +78,7 @@ At first generate the JAR by executing:
7878

7979
Then manually install the following JARs:
8080

81-
* target/connect-2.20191023.0.jar
81+
* target/connect-2.20191120.0.jar
8282
* target/lib/*.jar
8383

8484
## Getting Started
@@ -200,6 +200,7 @@ Class | Method | HTTP request | Description
200200
*LaborApi* | [**updateBreakType**](docs/LaborApi.md#updateBreakType) | **PUT** /v2/labor/break-types/{id} | UpdateBreakType
201201
*LaborApi* | [**updateShift**](docs/LaborApi.md#updateShift) | **PUT** /v2/labor/shifts/{id} | UpdateShift
202202
*LaborApi* | [**updateWorkweekConfig**](docs/LaborApi.md#updateWorkweekConfig) | **PUT** /v2/labor/workweek-configs/{id} | UpdateWorkweekConfig
203+
*LocationsApi* | [**createLocation**](docs/LocationsApi.md#createLocation) | **POST** /v2/locations | CreateLocation
203204
*LocationsApi* | [**listLocations**](docs/LocationsApi.md#listLocations) | **GET** /v2/locations | ListLocations
204205
*LocationsApi* | [**retrieveLocation**](docs/LocationsApi.md#retrieveLocation) | **GET** /v2/locations/{location_id} | RetrieveLocation
205206
*LocationsApi* | [**updateLocation**](docs/LocationsApi.md#updateLocation) | **PUT** /v2/locations/{location_id} | UpdateLocation
@@ -336,8 +337,10 @@ Class | Method | HTTP request | Description
336337
- [Card](docs/Card.md)
337338
- [CardBrand](docs/CardBrand.md)
338339
- [CardPaymentDetails](docs/CardPaymentDetails.md)
340+
- [CashPaymentDetails](docs/CashPaymentDetails.md)
339341
- [CatalogCategory](docs/CatalogCategory.md)
340342
- [CatalogDiscount](docs/CatalogDiscount.md)
343+
- [CatalogDiscountModifyTaxBasis](docs/CatalogDiscountModifyTaxBasis.md)
341344
- [CatalogDiscountType](docs/CatalogDiscountType.md)
342345
- [CatalogIdMapping](docs/CatalogIdMapping.md)
343346
- [CatalogImage](docs/CatalogImage.md)
@@ -364,7 +367,13 @@ Class | Method | HTTP request | Description
364367
- [CatalogPricingType](docs/CatalogPricingType.md)
365368
- [CatalogProductSet](docs/CatalogProductSet.md)
366369
- [CatalogQuery](docs/CatalogQuery.md)
370+
- [CatalogQueryCustomAttributeUsage](docs/CatalogQueryCustomAttributeUsage.md)
367371
- [CatalogQueryExact](docs/CatalogQueryExact.md)
372+
- [CatalogQueryFilteredItems](docs/CatalogQueryFilteredItems.md)
373+
- [CatalogQueryFilteredItemsCustomAttributeFilter](docs/CatalogQueryFilteredItemsCustomAttributeFilter.md)
374+
- [CatalogQueryFilteredItemsCustomAttributeFilterFilterType](docs/CatalogQueryFilteredItemsCustomAttributeFilterFilterType.md)
375+
- [CatalogQueryFilteredItemsNullableAttribute](docs/CatalogQueryFilteredItemsNullableAttribute.md)
376+
- [CatalogQueryFilteredItemsStockLevel](docs/CatalogQueryFilteredItemsStockLevel.md)
368377
- [CatalogQueryItemVariationsForItemOptionValues](docs/CatalogQueryItemVariationsForItemOptionValues.md)
369378
- [CatalogQueryItemsForItemOptions](docs/CatalogQueryItemsForItemOptions.md)
370379
- [CatalogQueryItemsForModifierList](docs/CatalogQueryItemsForModifierList.md)
@@ -386,12 +395,16 @@ Class | Method | HTTP request | Description
386395
- [Country](docs/Country.md)
387396
- [CreateBreakTypeRequest](docs/CreateBreakTypeRequest.md)
388397
- [CreateBreakTypeResponse](docs/CreateBreakTypeResponse.md)
398+
- [CreateCatalogImageRequest](docs/CreateCatalogImageRequest.md)
399+
- [CreateCatalogImageResponse](docs/CreateCatalogImageResponse.md)
389400
- [CreateCheckoutRequest](docs/CreateCheckoutRequest.md)
390401
- [CreateCheckoutResponse](docs/CreateCheckoutResponse.md)
391402
- [CreateCustomerCardRequest](docs/CreateCustomerCardRequest.md)
392403
- [CreateCustomerCardResponse](docs/CreateCustomerCardResponse.md)
393404
- [CreateCustomerRequest](docs/CreateCustomerRequest.md)
394405
- [CreateCustomerResponse](docs/CreateCustomerResponse.md)
406+
- [CreateLocationRequest](docs/CreateLocationRequest.md)
407+
- [CreateLocationResponse](docs/CreateLocationResponse.md)
395408
- [CreateMobileAuthorizationCodeRequest](docs/CreateMobileAuthorizationCodeRequest.md)
396409
- [CreateMobileAuthorizationCodeResponse](docs/CreateMobileAuthorizationCodeResponse.md)
397410
- [CreateOrderRequest](docs/CreateOrderRequest.md)
@@ -437,6 +450,7 @@ Class | Method | HTTP request | Description
437450
- [ErrorCategory](docs/ErrorCategory.md)
438451
- [ErrorCode](docs/ErrorCode.md)
439452
- [ExcludeStrategy](docs/ExcludeStrategy.md)
453+
- [ExternalPaymentDetails](docs/ExternalPaymentDetails.md)
440454
- [GetBreakTypeRequest](docs/GetBreakTypeRequest.md)
441455
- [GetBreakTypeResponse](docs/GetBreakTypeResponse.md)
442456
- [GetEmployeeWageRequest](docs/GetEmployeeWageRequest.md)
@@ -794,7 +808,6 @@ Class | Method | HTTP request | Description
794808
- [V1VariationPricingType](docs/V1VariationPricingType.md)
795809
- [VoidTransactionRequest](docs/VoidTransactionRequest.md)
796810
- [VoidTransactionResponse](docs/VoidTransactionResponse.md)
797-
- [WebhookEvents](docs/WebhookEvents.md)
798811
- [Weekday](docs/Weekday.md)
799812
- [WorkweekConfig](docs/WorkweekConfig.md)
800813

@@ -815,18 +828,18 @@ Authentication schemes defined for the API:
815828
- EMPLOYEES_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to employee profile information. For example, to create and modify employee profiles.
816829
- INVENTORY_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to inventory information. For example, to call the RetrieveInventoryCount endpoint.
817830
- INVENTORY_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to inventory information. For example, to call the BatchChangeInventory endpoint.
818-
- ITEMS_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to product catalog information. For example, to get an item or a list of items.
831+
- ITEMS_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to business and location information. For example, to obtain a location ID for subsequent activity.
819832
- ITEMS_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to product catalog information. For example, to modify or add to a product catalog.
820833
- MERCHANT_PROFILE_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to business and location information. For example, to obtain a location ID for subsequent activity.
821834
- ORDERS_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to order information. For example, to call the BatchRetrieveOrders endpoint.
822835
- ORDERS_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to order information. For example, to call the CreateCheckout endpoint.
823836
- PAYMENTS_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to transaction and refund information. For example, to call the RetrieveTransaction endpoint.
824-
- PAYMENTS_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to transaction and refunds information. For example, to process payments with the Transactions or Checkout API.
825-
- PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Allow third party applications to deduct a portion of each transaction amount. __Required__ to use multiparty transaction functionality with the Transactions API.
826-
- PAYMENTS_WRITE_IN_PERSON: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to transaction and refunds information. For example, to process in-person payments.
837+
- PAYMENTS_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to transaction and refunds information. For example, to process payments with the Payments or Checkout API.
838+
- PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Allow third party applications to deduct a portion of each transaction amount. __Required__ to use multiparty transaction functionality with the Payments API.
839+
- PAYMENTS_WRITE_IN_PERSON: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to payments and refunds information. For example, to process in-person payments.
827840
- SETTLEMENTS_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to settlement (deposit) information. For example, to call the Connect v1 ListSettlements endpoint.
828-
- TIMECARDS_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to employee timecard information. For example, to call the Connect v1 ListTimecards endpoint.
829-
- TIMECARDS_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to employee timecard information. For example, to create and modify timecards.
841+
- TIMECARDS_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to employee timecard information. For example, to call the Connect v2 SearchShifts endpoint.
842+
- TIMECARDS_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to employee shift information. For example, to create and modify employee shifts.
830843
- TIMECARDS_SETTINGS_READ: __HTTP Method__: &#x60;GET&#x60; Grants read access to employee timecard settings information. For example, to call the GetBreakType endpoint.
831844
- TIMECARDS_SETTINGS_WRITE: __HTTP Method__: &#x60;POST&#x60;, &#x60;PUT&#x60;, &#x60;DELETE&#x60; Grants write access to employee timecard settings information. For example, to call the UpdateBreakType endpoint.
832845

build.gradle

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ apply plugin: 'idea'
22
apply plugin: 'eclipse'
33

44
group = 'com.squareup'
5-
version = '2.20191023.0'
5+
version = '2.20191120.0'
66

77
buildscript {
88
repositories {

docs/ApplePayApi.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Method | HTTP request | Description
1313
1414
RegisterDomain
1515

16-
Activates a domain for use with Web Apple Pay and Square. A validation will be performed on this domain by Apple to ensure is it properly set up as an Apple Pay enabled domain. This endpoint provides an easy way for platform developers to bulk activate Web Apple Pay with Square for merchants using their platform. To learn more about Apple Pay on Web see the Apple Pay section in the [Embedding the Square Payment Form](/payment-form/add-digital-wallets/apple-pay) guide.
16+
Activates a domain for use with Web Apple Pay and Square. A validation will be performed on this domain by Apple to ensure is it properly set up as an Apple Pay enabled domain. This endpoint provides an easy way for platform developers to bulk activate Web Apple Pay with Square for merchants using their platform. To learn more about Apple Pay on Web see the Apple Pay section in the [Square Payment Form Walkthrough](/docs/payment-form/payment-form-walkthrough).
1717

1818
### Example
1919
```java

docs/BatchDeleteCatalogObjectsRequest.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
## Properties
99
Name | Type | Description | Notes
1010
------------ | ------------- | ------------- | -------------
11-
**objectIds** | **List&lt;String&gt;** | The IDs of the &#x60;CatalogObject&#x60;s to be deleted. When an object is deleted, other objects in the graph that depend on that object will be deleted as well (for example, deleting a &#x60;CatalogItem](#type-catalogitem) will delete its [CatalogItemVariation&#x60;. | [optional]
11+
**objectIds** | **List&lt;String&gt;** | The IDs of the CatalogObjects to be deleted. When an object is deleted, other objects in the graph that depend on that object will be deleted as well (for example, deleting a CatalogItem will delete its CatalogItemVariation. | [optional]
1212

1313

1414

docs/BatchDeleteCatalogObjectsResponse.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@
88
## Properties
99
Name | Type | Description | Notes
1010
------------ | ------------- | ------------- | -------------
11-
**errors** | [**List&lt;Error&gt;**](Error.md) | The set of &#x60;Error&#x60;s encountered. | [optional]
12-
**deletedObjectIds** | **List&lt;String&gt;** | The IDs of all &#x60;CatalogObject&#x60;s deleted by this request. | [optional]
13-
**deletedAt** | **String** | The database [timestamp](#workingwithdates) of this deletion in RFC 3339 format, e.g., \&quot;2016-09-04T23:59:33.123Z\&quot;. | [optional]
11+
**errors** | [**List&lt;Error&gt;**](Error.md) | The set of Errors encountered. | [optional]
12+
**deletedObjectIds** | **List&lt;String&gt;** | The IDs of all CatalogObjects deleted by this request. | [optional]
13+
**deletedAt** | **String** | The database [timestamp](https://developer.squareup.com/docs/build-basics/working-with-dates) of this deletion in RFC 3339 format, e.g., \&quot;2016-09-04T23:59:33.123Z\&quot;. | [optional]
1414

1515

1616

docs/BatchRetrieveCatalogObjectsRequest.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@
88
## Properties
99
Name | Type | Description | Notes
1010
------------ | ------------- | ------------- | -------------
11-
**objectIds** | **List&lt;String&gt;** | The IDs of the &#x60;CatalogObject&#x60;s to be retrieved. |
12-
**includeRelatedObjects** | **Boolean** | If &#x60;true&#x60;, the response will include additional objects that are related to the requested objects, as follows: If the &#x60;objects&#x60; field of the response contains a &#x60;CatalogItem&#x60;, its associated &#x60;CatalogCategory](#type-catalogcategory), [CatalogTax&#x60;es, &#x60;CatalogImage](#type-catalogimage)s and [CatalogModifierList&#x60;s will be returned in the &#x60;related_objects&#x60; field of the response. If the &#x60;objects&#x60; field of the response contains a &#x60;CatalogItemVariation&#x60;, its parent &#x60;CatalogItem&#x60; will be returned in the &#x60;related_objects&#x60; field of the response. | [optional]
11+
**objectIds** | **List&lt;String&gt;** | The IDs of the CatalogObjects to be retrieved. |
12+
**includeRelatedObjects** | **Boolean** | If &#x60;true&#x60;, the response will include additional objects that are related to the requested objects, as follows: If the &#x60;objects&#x60; field of the response contains a CatalogItem, its associated CatalogCategory objects, CatalogTax objects, CatalogImage objects and CatalogModifierLists will be returned in the &#x60;related_objects&#x60; field of the response. If the &#x60;objects&#x60; field of the response contains a CatalogItemVariation, its parent CatalogItem will be returned in the &#x60;related_objects&#x60; field of the response. | [optional]
1313

1414

1515

docs/BatchRetrieveInventoryChangesRequest.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Name | Type | Description | Notes
1414
**states** | **List&lt;String&gt;** | Filters &#x60;ADJUSTMENT&#x60; query results by &#x60;InventoryState&#x60;. Only applied when set. Default: unset. See [InventoryState](#type-inventorystate) for possible values | [optional]
1515
**updatedAfter** | **String** | Provided as an RFC 3339 timestamp. Returns results whose &#x60;created_at&#x60; or &#x60;calculated_at&#x60; value is after the given time. Default: UNIX epoch (&#x60;1970-01-01T00:00:00Z&#x60;). | [optional]
1616
**updatedBefore** | **String** | Provided as an RFC 3339 timestamp. Returns results whose &#x60;created_at&#x60; or &#x60;calculated_at&#x60; value is strictly before the given time. Default: UNIX epoch (&#x60;1970-01-01T00:00:00Z&#x60;). | [optional]
17-
**cursor** | **String** | A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See [Pagination](https://developer.squareup.com/docs/basics/api101/pagination) for more information. | [optional]
17+
**cursor** | **String** | A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See the [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pagination) guide for more information. | [optional]
1818

1919

2020

docs/BatchRetrieveInventoryChangesResponse.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Name | Type | Description | Notes
1010
------------ | ------------- | ------------- | -------------
1111
**errors** | [**List&lt;Error&gt;**](Error.md) | Any errors that occurred during the request. | [optional]
1212
**changes** | [**List&lt;InventoryChange&gt;**](InventoryChange.md) | The current calculated inventory changes for the requested objects and locations. | [optional]
13-
**cursor** | **String** | The pagination cursor to be used in a subsequent request. If unset, this is the final response. See [Pagination](https://developer.squareup.com/docs/basics/api101/pagination) for more information. | [optional]
13+
**cursor** | **String** | The pagination cursor to be used in a subsequent request. If unset, this is the final response. See the [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pagination) guide for more information. | [optional]
1414

1515

1616

docs/BatchRetrieveInventoryCountsRequest.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Name | Type | Description | Notes
1111
**catalogObjectIds** | **List&lt;String&gt;** | Filters results by &#x60;CatalogObject&#x60; ID. Only applied when set. Default: unset. | [optional]
1212
**locationIds** | **List&lt;String&gt;** | Filters results by &#x60;Location&#x60; ID. Only applied when set. Default: unset. | [optional]
1313
**updatedAfter** | **String** | Provided as an RFC 3339 timestamp. Returns results whose &#x60;calculated_at&#x60; value is after the given time. Default: UNIX epoch (&#x60;1970-01-01T00:00:00Z&#x60;). | [optional]
14-
**cursor** | **String** | A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See [Pagination](https://developer.squareup.com/docs/basics/api101/pagination) for more information. | [optional]
14+
**cursor** | **String** | A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query. See the [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pagination) guide for more information. | [optional]
1515

1616

1717

docs/BatchRetrieveInventoryCountsResponse.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Name | Type | Description | Notes
1010
------------ | ------------- | ------------- | -------------
1111
**errors** | [**List&lt;Error&gt;**](Error.md) | Any errors that occurred during the request. | [optional]
1212
**counts** | [**List&lt;InventoryCount&gt;**](InventoryCount.md) | The current calculated inventory counts for the requested objects and locations. | [optional]
13-
**cursor** | **String** | The pagination cursor to be used in a subsequent request. If unset, this is the final response. See [Pagination](https://developer.squareup.com/docs/basics/api101/pagination) for more information. | [optional]
13+
**cursor** | **String** | The pagination cursor to be used in a subsequent request. If unset, this is the final response. See the [Pagination](https://developer.squareup.com/docs/docs/working-with-apis/pagination) guide for more information. | [optional]
1414

1515

1616

0 commit comments

Comments
 (0)