Release 2.20190925.0

CHANGES.md

@@ -1,5 +1,20 @@
 # Change Log
 
+## Version 2.20190925.0 (2019-09-25)
+
+* **GA release**: All SDKs have been updated to support the new Merchants API.
+
+* **Beta release**: All SDKs have been updated to support the new endpoints (RetrieveLocation, UpdateLocation) added to the Locations API.
+
+* **Beta release**: All SDKs have been updated to support the new field (`mcc`) added to the `Location` type. 
+
+* **GA release**:  All SDKs have been updated to support the new field (`bin`) added to the `Card` type. 
+
+* **GA release**: All SDKs have been updated to support the new `CardPaymentDetails` fields  (`verification_results`, `statement_description`, and `verification_method`). 
+
+* **GA release**: All SDKs have been updated to support the new `Payment` field, (`employee_id`).
+
+
 ## Version 2.20190814.2 (2019-08-23)
 
 * **Bug fix**: Fixed path parameters for `UpdateOrder`

README.md

@@ -26,7 +26,7 @@ Add this dependency to your project's POM:
 <dependency>
     <groupId>com.squareup</groupId>
     <artifactId>connect</artifactId>
-    <version>2.20190814.2</version>
+    <version>2.20190925.0</version>
     <scope>compile</scope>
 </dependency>
 ```
@@ -36,7 +36,7 @@ Add this dependency to your project's POM:
 Add this dependency to your project's build file:
 
 ```groovy
-compile "com.squareup:connect:2.20190814.2"
+compile "com.squareup:connect:2.20190925.0"
 ```
 
 ### Option 3: Build and Install locally
@@ -78,7 +78,7 @@ At first generate the JAR by executing:
 
 Then manually install the following JARs:
 
-* target/connect-2.20190814.2.jar
+* target/connect-2.20190925.0.jar
 * target/lib/*.jar
 
 ## Getting Started
@@ -201,6 +201,9 @@ Class | Method | HTTP request | Description
 *LaborApi* | [**updateShift**](docs/LaborApi.md#updateShift) | **PUT** /v2/labor/shifts/{id} | UpdateShift
 *LaborApi* | [**updateWorkweekConfig**](docs/LaborApi.md#updateWorkweekConfig) | **PUT** /v2/labor/workweek-configs/{id} | UpdateWorkweekConfig
 *LocationsApi* | [**listLocations**](docs/LocationsApi.md#listLocations) | **GET** /v2/locations | ListLocations
+*LocationsApi* | [**retrieveLocation**](docs/LocationsApi.md#retrieveLocation) | **GET** /v2/locations/{location_id} | RetrieveLocation
+*LocationsApi* | [**updateLocation**](docs/LocationsApi.md#updateLocation) | **PUT** /v2/locations/{location_id} | UpdateLocation
+*MerchantsApi* | [**retrieveMerchant**](docs/MerchantsApi.md#retrieveMerchant) | **GET** /v2/merchants/{merchant_id} | RetrieveMerchant
 *MobileAuthorizationApi* | [**createMobileAuthorizationCode**](docs/MobileAuthorizationApi.md#createMobileAuthorizationCode) | **POST** /mobile/authorization-code | CreateMobileAuthorizationCode
 *OAuthApi* | [**obtainToken**](docs/OAuthApi.md#obtainToken) | **POST** /oauth2/token | ObtainToken
 *OAuthApi* | [**renewToken**](docs/OAuthApi.md#renewToken) | **POST** /oauth2/clients/{client_id}/access-token/renew | RenewToken
@@ -486,9 +489,12 @@ Class | Method | HTTP request | Description
  - [MeasurementUnitCustom](docs/MeasurementUnitCustom.md)
  - [MeasurementUnitGeneric](docs/MeasurementUnitGeneric.md)
  - [MeasurementUnitLength](docs/MeasurementUnitLength.md)
+ - [MeasurementUnitTime](docs/MeasurementUnitTime.md)
  - [MeasurementUnitUnitType](docs/MeasurementUnitUnitType.md)
  - [MeasurementUnitVolume](docs/MeasurementUnitVolume.md)
  - [MeasurementUnitWeight](docs/MeasurementUnitWeight.md)
+ - [Merchant](docs/Merchant.md)
+ - [MerchantStatus](docs/MerchantStatus.md)
  - [ModelBreak](docs/ModelBreak.md)
  - [Money](docs/Money.md)
  - [ObtainTokenRequest](docs/ObtainTokenRequest.md)
@@ -556,6 +562,8 @@ Class | Method | HTTP request | Description
  - [RetrieveInventoryPhysicalCountResponse](docs/RetrieveInventoryPhysicalCountResponse.md)
  - [RetrieveLocationRequest](docs/RetrieveLocationRequest.md)
  - [RetrieveLocationResponse](docs/RetrieveLocationResponse.md)
+ - [RetrieveMerchantRequest](docs/RetrieveMerchantRequest.md)
+ - [RetrieveMerchantResponse](docs/RetrieveMerchantResponse.md)
  - [RetrieveTransactionRequest](docs/RetrieveTransactionRequest.md)
  - [RetrieveTransactionResponse](docs/RetrieveTransactionResponse.md)
  - [RevokeTokenRequest](docs/RevokeTokenRequest.md)
@@ -610,6 +618,8 @@ Class | Method | HTTP request | Description
  - [UpdateItemModifierListsResponse](docs/UpdateItemModifierListsResponse.md)
  - [UpdateItemTaxesRequest](docs/UpdateItemTaxesRequest.md)
  - [UpdateItemTaxesResponse](docs/UpdateItemTaxesResponse.md)
+ - [UpdateLocationRequest](docs/UpdateLocationRequest.md)
+ - [UpdateLocationResponse](docs/UpdateLocationResponse.md)
  - [UpdateOrderRequest](docs/UpdateOrderRequest.md)
  - [UpdateOrderResponse](docs/UpdateOrderResponse.md)
  - [UpdateShiftRequest](docs/UpdateShiftRequest.md)

build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'idea'
 apply plugin: 'eclipse'
 
 group = 'com.squareup'
-version = '2.20190814.2'
+version = '2.20190925.0'
 
 buildscript {
     repositories {

docs/AdditionalRecipient.md

@@ -11,7 +11,7 @@ Name | Type | Description | Notes
 **locationId** | **String** | The location ID for a recipient (other than the merchant) receiving a portion of this tender. | 
 **description** | **String** | The description of the additional recipient. | 
 **amountMoney** | [**Money**](Money.md) | The amount of money distributed to the recipient. | 
-**receivableId** | **String** | The unique ID for this [AdditionalRecipientReceivable](#type-additionalrecipientreceivable), assigned by the server. |  [optional]
+**receivableId** | **String** | The unique ID for this `AdditionalRecipientReceivable`, assigned by the server. |  [optional]
 
 
 

docs/BatchChangeInventoryRequest.md

@@ -8,7 +8,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**idempotencyKey** | **String** | A client-supplied, universally unique identifier (UUID) for the request.  See [Idempotency](/basics/api101/idempotency) in the [API Development 101](/basics/api101/overview) section for more information. |  [optional]
+**idempotencyKey** | **String** | A client-supplied, universally unique identifier (UUID) for the request.  See [Idempotency](https://developer.squareup.com/docs/basics/api101/idempotency) in the [API Development 101](https://developer.squareup.com/docs/basics/api101/overview) section for more information. |  [optional]
 **changes** | [**List<InventoryChange>**](InventoryChange.md) | The set of physical counts and inventory adjustments to be made. Changes are applied based on the client-supplied timestamp and may be sent out of order. Max size is 100 changes. |  [optional]
 **ignoreUnchangedCounts** | **Boolean** | Indicates whether the current physical count should be ignored if the quantity is unchanged since the last physical count. Default: `true`. |  [optional]
 

docs/BatchDeleteCatalogObjectsRequest.md

@@ -8,7 +8,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**objectIds** | **List<String>** | The IDs of the [CatalogObject](#type-catalogobject)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 [CatalogItem](#type-catalogitem) will delete its [CatalogItemVariation](#type-catalogitemvariation)s). |  [optional]
+**objectIds** | **List<String>** | The IDs of the `CatalogObject`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 `CatalogItem](#type-catalogitem) will delete its [CatalogItemVariation`. |  [optional]
 
 
 

docs/BatchDeleteCatalogObjectsResponse.md

@@ -8,8 +8,8 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**errors** | [**List<Error>**](Error.md) | The set of [Error](#type-error)s encountered. |  [optional]
-**deletedObjectIds** | **List<String>** | The IDs of all [CatalogObject](#type-catalogobject)s deleted by this request. |  [optional]
+**errors** | [**List<Error>**](Error.md) | The set of `Error`s encountered. |  [optional]
+**deletedObjectIds** | **List<String>** | The IDs of all `CatalogObject`s deleted by this request. |  [optional]
 **deletedAt** | **String** | The database [timestamp](#workingwithdates) of this deletion in RFC 3339 format, e.g., \"2016-09-04T23:59:33.123Z\". |  [optional]
 
 

docs/BatchRetrieveCatalogObjectsRequest.md

@@ -8,8 +8,8 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**objectIds** | **List<String>** | The IDs of the [CatalogObject](#type-catalogobject)s to be retrieved. | 
-**includeRelatedObjects** | **Boolean** | If `true`, the response will include additional objects that are related to the requested objects, as follows:  If the `objects` field of the response contains a [CatalogItem](#type-catalogitem),  its associated [CatalogCategory](#type-catalogcategory), [CatalogTax](#type-catalogtax)es, [CatalogImage](#type-catalogimage)s and [CatalogModifierList](#type-catalogmodifierlist)s will be returned in the `related_objects` field of the response. If the `objects` field of the response contains a [CatalogItemVariation](#type-catalogitemvariation), its parent [CatalogItem](#type-catalogitem) will be returned in the `related_objects` field of the response. |  [optional]
+**objectIds** | **List<String>** | The IDs of the `CatalogObject`s to be retrieved. | 
+**includeRelatedObjects** | **Boolean** | If `true`, the response will include additional objects that are related to the requested objects, as follows:  If the `objects` field of the response contains a `CatalogItem`,  its associated `CatalogCategory](#type-catalogcategory), [CatalogTax`es, `CatalogImage](#type-catalogimage)s and [CatalogModifierList`s will be returned in the `related_objects` field of the response. If the `objects` field of the response contains a `CatalogItemVariation`, its parent `CatalogItem` will be returned in the `related_objects` field of the response. |  [optional]
 
 
 

docs/BatchRetrieveCatalogObjectsResponse.md

@@ -8,9 +8,9 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**errors** | [**List<Error>**](Error.md) | The set of [Error](#type-error)s encountered. |  [optional]
-**objects** | [**List<CatalogObject>**](CatalogObject.md) | A list of [CatalogObject](#type-catalogobject)s returned. |  [optional]
-**relatedObjects** | [**List<CatalogObject>**](CatalogObject.md) | A list of [CatalogObject](#type-catalogobject)s referenced by the object in the `objects` field. |  [optional]
+**errors** | [**List<Error>**](Error.md) | The set of `Error`s encountered. |  [optional]
+**objects** | [**List<CatalogObject>**](CatalogObject.md) | A list of `CatalogObject`s returned. |  [optional]
+**relatedObjects** | [**List<CatalogObject>**](CatalogObject.md) | A list of `CatalogObject`s referenced by the object in the `objects` field. |  [optional]
 
 
 

docs/BatchRetrieveInventoryChangesRequest.md

@@ -8,13 +8,13 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**catalogObjectIds** | **List<String>** | Filters results by [CatalogObject](#type-catalogobject) ID. Only applied when set. Default: unset. |  [optional]
-**locationIds** | **List<String>** | Filters results by [Location](#type-location) ID. Only applied when set. Default: unset. |  [optional]
-**types** | **List<String>** | Filters results by [InventoryChangeType](#type-inventorychangetype). Default: [`PHYSICAL_COUNT`, `ADJUSTMENT`]. `TRANSFER` is not supported as a filter. See [InventoryChangeType](#type-inventorychangetype) for possible values |  [optional]
-**states** | **List<String>** | Filters `ADJUSTMENT` query results by [InventoryState](#type-inventorystate). Only applied when set. Default: unset. See [InventoryState](#type-inventorystate) for possible values |  [optional]
+**catalogObjectIds** | **List<String>** | Filters results by `CatalogObject` ID. Only applied when set. Default: unset. |  [optional]
+**locationIds** | **List<String>** | Filters results by `Location` ID. Only applied when set. Default: unset. |  [optional]
+**types** | **List<String>** | Filters results by `InventoryChangeType`. Default: [`PHYSICAL_COUNT`, `ADJUSTMENT`]. `TRANSFER` is not supported as a filter. See [InventoryChangeType](#type-inventorychangetype) for possible values |  [optional]
+**states** | **List<String>** | Filters `ADJUSTMENT` query results by `InventoryState`. Only applied when set. Default: unset. See [InventoryState](#type-inventorystate) for possible values |  [optional]
 **updatedAfter** | **String** | Provided as an RFC 3339 timestamp. Returns results whose `created_at` or `calculated_at` value is after the given time. Default: UNIX epoch (`1970-01-01T00:00:00Z`). |  [optional]
 **updatedBefore** | **String** | Provided as an RFC 3339 timestamp. Returns results whose `created_at` or `calculated_at` value is strictly before the given time. Default: UNIX epoch (`1970-01-01T00:00:00Z`). |  [optional]
-**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](/basics/api101/pagination) for more information. |  [optional]
+**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]
 
 
 

docs/BatchRetrieveInventoryChangesResponse.md

@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **errors** | [**List<Error>**](Error.md) | Any errors that occurred during the request. |  [optional]
 **changes** | [**List<InventoryChange>**](InventoryChange.md) | The current calculated inventory changes for the requested objects and locations. |  [optional]
-**cursor** | **String** | The pagination cursor to be used in a subsequent request. If unset, this is the final response. See [Pagination](/basics/api101/pagination) for more information. |  [optional]
+**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]
 
 
 

docs/BatchRetrieveInventoryCountsRequest.md

@@ -8,10 +8,10 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**catalogObjectIds** | **List<String>** | Filters results by [CatalogObject](#type-catalogobject) ID. Only applied when set. Default: unset. |  [optional]
-**locationIds** | **List<String>** | Filters results by [Location](#type-location) ID. Only applied when set. Default: unset. |  [optional]
+**catalogObjectIds** | **List<String>** | Filters results by `CatalogObject` ID. Only applied when set. Default: unset. |  [optional]
+**locationIds** | **List<String>** | Filters results by `Location` ID. Only applied when set. Default: unset. |  [optional]
 **updatedAfter** | **String** | Provided as an RFC 3339 timestamp. Returns results whose `calculated_at` value is after the given time. Default: UNIX epoch (`1970-01-01T00:00:00Z`). |  [optional]
-**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](/basics/api101/pagination) for more information. |  [optional]
+**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]
 
 
 

docs/BatchRetrieveInventoryCountsResponse.md

@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **errors** | [**List<Error>**](Error.md) | Any errors that occurred during the request. |  [optional]
 **counts** | [**List<InventoryCount>**](InventoryCount.md) | The current calculated inventory counts for the requested objects and locations. |  [optional]
-**cursor** | **String** | The pagination cursor to be used in a subsequent request. If unset, this is the final response.  See [Pagination](/basics/api101/pagination) for more information. |  [optional]
+**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]