Release 2.20190612.0 (#70)

CHANGES.md

@@ -1,5 +1,13 @@
 # Change Log
 
+## Version 2.20190612.0 (2019-06-12)
+
+* **BETA releases**:
+  * Orders API: supports service charges with a new field and datatype.
+  * Catalog API: supports measurement unites for item variation quantities with a new field and datatype.
+* **New functionality**: `Order` entities — now include a `source` field that contains details on where the order originated.
+* **Improved functionality**: ListLocations — Expanded business information available through the Locations API, including business hours, contact email, social media handles, and longitude/latitude for physical locations.
+
 ## Version 2.20190508.1 (2019-05-28)
 
 Bump Jackson dependency for Java SDK.

README.md

@@ -18,7 +18,7 @@ Add this dependency to your project's POM:
 <dependency>
     <groupId>com.squareup</groupId>
     <artifactId>connect</artifactId>
-    <version>2.20190508.1</version>
+    <version>2.20190612.0</version>
     <scope>compile</scope>
 </dependency>
 ```
@@ -28,7 +28,7 @@ Add this dependency to your project's POM:
 Add this dependency to your project's build file:
 
 ```groovy
-compile "com.squareup:connect:2.20190508.1"
+compile "com.squareup:connect:2.20190612.0"
 ```
 
 ### Option 3: Build and Install locally
@@ -70,7 +70,7 @@ At first generate the JAR by executing:
 
 Then manually install the following JARs:
 
-* target/connect-2.20190508.1.jar
+* target/connect-2.20190612.0.jar
 * target/lib/*.jar
 
 ## Getting Started
@@ -257,6 +257,7 @@ Class | Method | HTTP request | Description
  - [AdditionalRecipientReceivable](docs/AdditionalRecipientReceivable.md)
  - [AdditionalRecipientReceivableRefund](docs/AdditionalRecipientReceivableRefund.md)
  - [Address](docs/Address.md)
+ - [AggregationStrategy](docs/AggregationStrategy.md)
  - [BatchChangeInventoryRequest](docs/BatchChangeInventoryRequest.md)
  - [BatchChangeInventoryResponse](docs/BatchChangeInventoryResponse.md)
  - [BatchDeleteCatalogObjectsRequest](docs/BatchDeleteCatalogObjectsRequest.md)
@@ -290,14 +291,17 @@ Class | Method | HTTP request | Description
  - [CatalogItemModifierListInfo](docs/CatalogItemModifierListInfo.md)
  - [CatalogItemProductType](docs/CatalogItemProductType.md)
  - [CatalogItemVariation](docs/CatalogItemVariation.md)
+ - [CatalogMeasurementUnit](docs/CatalogMeasurementUnit.md)
  - [CatalogModifier](docs/CatalogModifier.md)
  - [CatalogModifierList](docs/CatalogModifierList.md)
  - [CatalogModifierListSelectionType](docs/CatalogModifierListSelectionType.md)
  - [CatalogModifierOverride](docs/CatalogModifierOverride.md)
  - [CatalogObject](docs/CatalogObject.md)
  - [CatalogObjectBatch](docs/CatalogObjectBatch.md)
  - [CatalogObjectType](docs/CatalogObjectType.md)
+ - [CatalogPricingRule](docs/CatalogPricingRule.md)
  - [CatalogPricingType](docs/CatalogPricingType.md)
+ - [CatalogProductSet](docs/CatalogProductSet.md)
  - [CatalogQuery](docs/CatalogQuery.md)
  - [CatalogQueryExact](docs/CatalogQueryExact.md)
  - [CatalogQueryItemsForModifierList](docs/CatalogQueryItemsForModifierList.md)
@@ -307,11 +311,13 @@ Class | Method | HTTP request | Description
  - [CatalogQuerySortedAttribute](docs/CatalogQuerySortedAttribute.md)
  - [CatalogQueryText](docs/CatalogQueryText.md)
  - [CatalogTax](docs/CatalogTax.md)
+ - [CatalogTimePeriod](docs/CatalogTimePeriod.md)
  - [CatalogV1Id](docs/CatalogV1Id.md)
  - [ChargeRequest](docs/ChargeRequest.md)
  - [ChargeRequestAdditionalRecipient](docs/ChargeRequestAdditionalRecipient.md)
  - [ChargeResponse](docs/ChargeResponse.md)
  - [Checkout](docs/Checkout.md)
+ - [Coordinates](docs/Coordinates.md)
  - [Country](docs/Country.md)
  - [CreateBreakTypeRequest](docs/CreateBreakTypeRequest.md)
  - [CreateBreakTypeResponse](docs/CreateBreakTypeResponse.md)
@@ -407,6 +413,7 @@ Class | Method | HTTP request | Description
  - [MeasurementUnit](docs/MeasurementUnit.md)
  - [MeasurementUnitArea](docs/MeasurementUnitArea.md)
  - [MeasurementUnitCustom](docs/MeasurementUnitCustom.md)
+ - [MeasurementUnitGeneric](docs/MeasurementUnitGeneric.md)
  - [MeasurementUnitLength](docs/MeasurementUnitLength.md)
  - [MeasurementUnitVolume](docs/MeasurementUnitVolume.md)
  - [MeasurementUnitWeight](docs/MeasurementUnitWeight.md)
@@ -436,8 +443,11 @@ Class | Method | HTTP request | Description
  - [OrderReturnDiscount](docs/OrderReturnDiscount.md)
  - [OrderReturnLineItem](docs/OrderReturnLineItem.md)
  - [OrderReturnLineItemModifier](docs/OrderReturnLineItemModifier.md)
+ - [OrderReturnServiceCharge](docs/OrderReturnServiceCharge.md)
  - [OrderReturnTax](docs/OrderReturnTax.md)
  - [OrderRoundingAdjustment](docs/OrderRoundingAdjustment.md)
+ - [OrderServiceCharge](docs/OrderServiceCharge.md)
+ - [OrderServiceChargeCalculationPhase](docs/OrderServiceChargeCalculationPhase.md)
  - [OrderSource](docs/OrderSource.md)
  - [OrderState](docs/OrderState.md)
  - [Product](docs/Product.md)
@@ -495,6 +505,8 @@ Class | Method | HTTP request | Description
  - [ShiftWorkdayMatcher](docs/ShiftWorkdayMatcher.md)
  - [SortOrder](docs/SortOrder.md)
  - [SourceApplication](docs/SourceApplication.md)
+ - [StandardUnitDescription](docs/StandardUnitDescription.md)
+ - [StandardUnitDescriptionGroup](docs/StandardUnitDescriptionGroup.md)
  - [TaxCalculationPhase](docs/TaxCalculationPhase.md)
  - [TaxInclusionType](docs/TaxInclusionType.md)
  - [Tender](docs/Tender.md)

build.gradle

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

docs/AggregationStrategy.md

@@ -0,0 +1,16 @@
+
+# AggregationStrategy
+
+## Enum
+
+
+* `UNKNOWN` (value: `"UNKNOWN"`)
+
+* `BASE` (value: `"BASE"`)
+
+* `STACKABLE` (value: `"STACKABLE"`)
+
+* `EXCLUSIVE` (value: `"EXCLUSIVE"`)
+
+
+

docs/ApplePayApi.md

@@ -13,7 +13,7 @@ Method | HTTP request | Description
 
 RegisterDomain
 
-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](/payments/sqpaymentform/overview) guide.
+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.
 
 ### Example
 ```java

docs/BatchRetrieveCatalogObjectsRequest.md

@@ -9,7 +9,7 @@
 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, 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]
+**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]
 
 
 

docs/Card.md

@@ -15,7 +15,7 @@ Name | Type | Description | Notes
 **expYear** | **Long** | The four-digit year of the card's expiration date. |  [optional]
 **cardholderName** | **String** | The name of the cardholder. |  [optional]
 **billingAddress** | [**Address**](Address.md) | The billing address for this card. |  [optional]
-**fingerprint** | **String** | __Not currently set.__ Intended as a Square-assigned identifier, based on the card number, to identify the card across multiple locations within a single application. |  [optional]
+**fingerprint** | **String** | A unique, Square-assigned ID that identifies the card across multiple locations and applications for a single Square account. |  [optional]
 
 
 <a name="CardBrandEnum"></a>

docs/CatalogApi.md

@@ -284,7 +284,7 @@ Name | Type | Description  | Notes
 
 ListCatalog
 
-Returns a list of [CatalogObject](#type-catalogobject)s that includes all objects of a set of desired types (for example, all [CatalogItem](#type-catalogitem) and [CatalogTax](#type-catalogtax) objects) in the catalog. The types parameter is specified as a comma-separated list of valid [CatalogObject](#type-catalogobject) types: `ITEM`, `ITEM_VARIATION`, `MODIFIER`, `MODIFIER_LIST`, `CATEGORY`, `DISCOUNT`, `TAX`.
+Returns a list of [CatalogObject](#type-catalogobject)s that includes all objects of a set of desired types (for example, all [CatalogItem](#type-catalogitem) and [CatalogTax](#type-catalogtax) objects) in the catalog. The `types` parameter is specified as a comma-separated list of valid [CatalogObject](#type-catalogobject) types: `ITEM`, `ITEM_VARIATION`, `MODIFIER`, `MODIFIER_LIST`, `CATEGORY`, `DISCOUNT`, `TAX`.  __Important:__ ListCatalog does not return deleted catalog items. To retrieve deleted catalog items, use SearchCatalogObjects and set `include_deleted_objects` to `true`.
 
 ### Example
 ```java
@@ -358,7 +358,7 @@ oauth2.setAccessToken("YOUR ACCESS TOKEN");
 
 CatalogApi apiInstance = new CatalogApi();
 String objectId = "objectId_example"; // String | The object ID of any type of [CatalogObject](#type-catalogobject)s to be retrieved.
-Boolean includeRelatedObjects = true; // Boolean | If `true`, the response will include additional objects that are related to the requested object, as follows:  If the `object` field of the response contains a [CatalogItem](#type-catalogitem), its associated [CatalogCategory](#type-catalogcategory), [CatalogTax](#type-catalogtax)es, and [CatalogModifierList](#type-catalogmodifierlist)s will be returned in the `related_objects` field of the response. If the `object` 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.  Default value: `false`
+Boolean includeRelatedObjects = true; // Boolean | If `true`, the response will include additional objects that are related to the requested object, as follows:  If the `object` 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 `object` 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.  Default value: `false`
 try {
     RetrieveCatalogObjectResponse result = apiInstance.retrieveCatalogObject(objectId, includeRelatedObjects);
     System.out.println(result);
@@ -373,7 +373,7 @@ try {
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **objectId** | **String**| The object ID of any type of [CatalogObject](#type-catalogobject)s to be retrieved. |
- **includeRelatedObjects** | **Boolean**| If `true`, the response will include additional objects that are related to the requested object, as follows:  If the `object` field of the response contains a [CatalogItem](#type-catalogitem), its associated [CatalogCategory](#type-catalogcategory), [CatalogTax](#type-catalogtax)es, and [CatalogModifierList](#type-catalogmodifierlist)s will be returned in the `related_objects` field of the response. If the `object` 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.  Default value: `false` | [optional]
+ **includeRelatedObjects** | **Boolean**| If `true`, the response will include additional objects that are related to the requested object, as follows:  If the `object` 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 `object` 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.  Default value: `false` | [optional]
 
 ### Return type
 

docs/CatalogInfoResponse.md

@@ -10,6 +10,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **errors** | [**List<Error>**](Error.md) | The set of [Error](#type-error)s encountered. |  [optional]
 **limits** | [**CatalogInfoResponseLimits**](CatalogInfoResponseLimits.md) |  |  [optional]
+**standardUnitDescriptionGroup** | [**StandardUnitDescriptionGroup**](StandardUnitDescriptionGroup.md) | Names and abbreviations for standard units. |  [optional]
 
 
 

docs/CatalogItem.md

@@ -19,7 +19,7 @@ Name | Type | Description | Notes
 **taxIds** | **List<String>** | A set of IDs indicating the [CatalogTax](#type-catalogtax)es that are enabled for this item. When updating an item, any taxes listed here will be added to the item. [CatalogTax](#type-catalogtax)es may also be added to or deleted from an item using `UpdateItemTaxes`. |  [optional]
 **modifierListInfo** | [**List<CatalogItemModifierListInfo>**](CatalogItemModifierListInfo.md) | A set of [CatalogItemModifierListInfo](#type-catalogitemmodifierlistinfo) objects representing the modifier lists that apply to this item, along with the overrides and min and max limits that are specific to this item. [CatalogModifierList](#type-catalogmodifierlist)s may also be added to or deleted from an item using `UpdateItemModifierLists`. |  [optional]
 **imageUrl** | **String** | __Deprecated__. The URL of an image representing this item. Deprecated in favor of `image_id` in [`CatalogObject`](#type-catalogobject). |  [optional]
-**variations** | [**List<CatalogObject>**](CatalogObject.md) | A list of [CatalogObject](#type-catalogobject)s containing the [CatalogItemVariation](#type-catalogitemvariation)s for this item. |  [optional]
+**variations** | [**List<CatalogObject>**](CatalogObject.md) | A list of [CatalogObject](#type-catalogobject)s containing the [CatalogItemVariation](#type-catalogitemvariation)s for this item.  Maximum: 250 item variations |  [optional]
 **productType** | [**ProductTypeEnum**](#ProductTypeEnum) | The product type of the item. May not be changed once an item has been created.  Only items of product type `REGULAR` may be created by this API; items with other product types are read-only. See [CatalogItemProductType](#type-catalogitemproducttype) for possible values |  [optional]
 **skipModifierScreen** | **Boolean** | If `false`, the Square Point of Sale app will present the [CatalogItem](#type-catalogitem)'s details screen immediately, allowing the merchant to choose [CatalogModifier](#type-catalogmodifier)s before adding the item to the cart.  This is the default behavior.  If `true`, the Square Point of Sale app will immediately add the item to the cart with the pre-selected modifiers, and merchants can edit modifiers by drilling down onto the item's details.  Third-party clients are encouraged to implement similar behaviors. |  [optional]
 

docs/CatalogItemVariation.md

@@ -3,7 +3,7 @@
 
 ### Description
 
-An item variation (i.e., product) in the Catalog object model.
+An item variation (i.e., product) in the Catalog object model. Each item may have a maximum of 250 item variations.
 
 ## Properties
 Name | Type | Description | Notes
@@ -21,6 +21,8 @@ Name | Type | Description | Notes
 **inventoryAlertThreshold** | **Long** | If the inventory quantity for the variation is less than or equal to this value and `inventory_alert_type` is `LOW_QUANTITY`, the variation displays an alert in the merchant dashboard.  This value is always an integer. |  [optional]
 **userData** | **String** | Arbitrary user metadata to associate with the item variation. Cannot exceed 255 characters. Searchable. |  [optional]
 **serviceDuration** | **Long** | If the [CatalogItem](#type-catalogitem) that owns this item variation is of type `APPOINTMENTS_SERVICE`, then this is the duration of the service in milliseconds. For example, a 30 minute appointment would have the value `1800000`, which is equal to 30 (minutes) * 60 (seconds per minute) * 1000 (milliseconds per second). |  [optional]
+**catalogMeasurementUnitId** | **String** | Represents the unit used to measure a [CatalogItemVariation](#type-catalogitemvariation) and specifies the precision for decimal quantities. |  [optional]
+**measurementUnitId** | **String** | ID of the ‘CatalogMeasurementUnit’ that is used to measure the quantity sold of this item variation. If left unset, the item will be sold in whole quantities. |  [optional]
 
 
 <a name="PricingTypeEnum"></a>

docs/CatalogMeasurementUnit.md

@@ -0,0 +1,15 @@
+
+# CatalogMeasurementUnit
+
+### Description
+
+Represents the unit used to measure a [CatalogItemVariation](#type-catalogitemvariation) and specifies the precision for decimal quantities.
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**measurementUnit** | [**MeasurementUnit**](MeasurementUnit.md) | Indicates the unit used to measure the quantity of a catalog item variation. |  [optional]
+**precision** | **Integer** |  Represents the maximum number of positions allowed after the decimal in quantities measured with this unit. For example, if the precision is 2, then an itemization’s quantity can be 0.01, 0.12, etc.  Min: 0  Max: 5  Default: 3 |  [optional]
+
+
+