Release 2.20190612.0 (#98)

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.0 (2019-05-08)
 
 ## Details
@@ -62,15 +70,15 @@
 ## New API: Labor API
 
 The Labor API now includes functionality
-that gives a Square account the ability to track and retrieve employee labor hours 
-including multiple hourly wage rates per employee, work shift break tracking, and 
+that gives a Square account the ability to track and retrieve employee labor hours
+including multiple hourly wage rates per employee, work shift break tracking, and
 standardized break templates.
 
 See the Connect v2 Technical Reference.
 
 ## New API: Employees API
 
-The Employees API includes the ability to list employees for a Square 
+The Employees API includes the ability to list employees for a Square
 account and retrieve a single employee by ID.
 
 See the Connect v2 Technical Reference.

README.md

@@ -265,11 +265,14 @@ Class | Method | HTTP request
  - [CatalogItem](docs/CatalogItem.md)
  - [CatalogItemModifierListInfo](docs/CatalogItemModifierListInfo.md)
  - [CatalogItemVariation](docs/CatalogItemVariation.md)
+ - [CatalogMeasurementUnit](docs/CatalogMeasurementUnit.md)
  - [CatalogModifier](docs/CatalogModifier.md)
  - [CatalogModifierList](docs/CatalogModifierList.md)
  - [CatalogModifierOverride](docs/CatalogModifierOverride.md)
  - [CatalogObject](docs/CatalogObject.md)
  - [CatalogObjectBatch](docs/CatalogObjectBatch.md)
+ - [CatalogPricingRule](docs/CatalogPricingRule.md)
+ - [CatalogProductSet](docs/CatalogProductSet.md)
  - [CatalogQuery](docs/CatalogQuery.md)
  - [CatalogQueryExact](docs/CatalogQueryExact.md)
  - [CatalogQueryItemsForModifierList](docs/CatalogQueryItemsForModifierList.md)
@@ -279,11 +282,13 @@ Class | Method | HTTP request
  - [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)
  - [CreateBreakTypeRequest](docs/CreateBreakTypeRequest.md)
  - [CreateBreakTypeResponse](docs/CreateBreakTypeResponse.md)
  - [CreateCheckoutRequest](docs/CreateCheckoutRequest.md)
@@ -382,8 +387,10 @@ Class | Method | HTTP request
  - [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)
  - [OrderSource](docs/OrderSource.md)
  - [Refund](docs/Refund.md)
  - [RegisterDomainRequest](docs/RegisterDomainRequest.md)
@@ -431,6 +438,8 @@ Class | Method | HTTP request
  - [ShiftWage](docs/ShiftWage.md)
  - [ShiftWorkday](docs/ShiftWorkday.md)
  - [SourceApplication](docs/SourceApplication.md)
+ - [StandardUnitDescription](docs/StandardUnitDescription.md)
+ - [StandardUnitDescriptionGroup](docs/StandardUnitDescriptionGroup.md)
  - [Tender](docs/Tender.md)
  - [TenderCardDetails](docs/TenderCardDetails.md)
  - [TenderCashDetails](docs/TenderCashDetails.md)
@@ -578,6 +587,7 @@ Class | Method | HTTP request
 
 ## Documentation For Enums
 
+ - [AggregationStrategy](docs/AggregationStrategy.md)
  - [CardBrand](docs/CardBrand.md)
  - [CatalogDiscountType](docs/CatalogDiscountType.md)
  - [CatalogItemProductType](docs/CatalogItemProductType.md)
@@ -600,6 +610,7 @@ Class | Method | HTTP request
  - [LocationStatus](docs/LocationStatus.md)
  - [LocationType](docs/LocationType.md)
  - [MeasurementUnitArea](docs/MeasurementUnitArea.md)
+ - [MeasurementUnitGeneric](docs/MeasurementUnitGeneric.md)
  - [MeasurementUnitLength](docs/MeasurementUnitLength.md)
  - [MeasurementUnitVolume](docs/MeasurementUnitVolume.md)
  - [MeasurementUnitWeight](docs/MeasurementUnitWeight.md)
@@ -610,6 +621,7 @@ Class | Method | HTTP request
  - [OrderLineItemDiscountType](docs/OrderLineItemDiscountType.md)
  - [OrderLineItemTaxScope](docs/OrderLineItemTaxScope.md)
  - [OrderLineItemTaxType](docs/OrderLineItemTaxType.md)
+ - [OrderServiceChargeCalculationPhase](docs/OrderServiceChargeCalculationPhase.md)
  - [OrderState](docs/OrderState.md)
  - [Product](docs/Product.md)
  - [RefundStatus](docs/RefundStatus.md)

docs/AggregationStrategy.md

@@ -0,0 +1,18 @@
+# AggregationStrategy
+
+
+### Description
+
+Indicates how a [CatalogPricingRule](#type-catalogpricingrule) can be combined with other rules.
+
+## Properties
+Name | Type
+------------ | -------------
+**UNKNOWN** | string
+**BASE** | string
+**STACKABLE** | string
+**EXCLUSIVE** | string
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/ApplePayApi.md

@@ -14,7 +14,7 @@ Method | HTTP request
 
 ### Description
 
-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.
 
 ### Parameters
 

docs/BatchRetrieveCatalogObjectsRequest.md

@@ -9,7 +9,7 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **object_ids** | **list[str]** | The IDs of the [CatalogObject](#type-catalogobject)s to be retrieved. | 
-**include_related_objects** | **bool** | 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] 
+**include_related_objects** | **bool** | 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] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/Card.md

@@ -15,7 +15,7 @@ Name | Type | Description | Notes
 **exp_year** | **int** | The four-digit year of the card's expiration date. | [optional] 
 **cardholder_name** | **str** | The name of the cardholder. | [optional] 
 **billing_address** | [**Address**](Address.md) | The billing address for this card. | [optional] 
-**fingerprint** | **str** | __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** | **str** | A unique, Square-assigned ID that identifies the card across multiple locations and applications for a single Square account. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/CatalogApi.md

@@ -136,7 +136,7 @@ Assign your **Access Token** from developer portal to the authorization paramete
 
 ### Description
 
-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`.
 
 ### Parameters
 

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] 
+**standard_unit_description_group** | [**StandardUnitDescriptionGroup**](StandardUnitDescriptionGroup.md) | Names and abbreviations for standard units. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/CatalogItem.md

@@ -19,7 +19,7 @@ Name | Type | Description | Notes
 **tax_ids** | **list[str]** | 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] 
 **modifier_list_info** | [**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] 
 **image_url** | **str** | __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] 
 **product_type** | **str** | 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] 
 **skip_modifier_screen** | **bool** | 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
 **inventory_alert_threshold** | **int** | 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] 
 **user_data** | **str** | Arbitrary user metadata to associate with the item variation. Cannot exceed 255 characters. Searchable. | [optional] 
 **service_duration** | **int** | 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] 
+**catalog_measurement_unit_id** | **str** | Represents the unit used to measure a [CatalogItemVariation](#type-catalogitemvariation) and specifies the precision for decimal quantities. | [optional] 
+**measurement_unit_id** | **str** | 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] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/CatalogMeasurementUnit.md

@@ -0,0 +1,16 @@
+# CatalogMeasurementUnit
+> squareconnect.models.catalog_measurement_unit
+
+### Description
+
+Represents the unit used to measure a [CatalogItemVariation](#type-catalogitemvariation) and specifies the precision for decimal quantities.
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**measurement_unit** | [**MeasurementUnit**](MeasurementUnit.md) | Indicates the unit used to measure the quantity of a catalog item variation. | [optional] 
+**precision** | **int** |  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] 
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

docs/CatalogObject.md

@@ -26,6 +26,7 @@ Name | Type | Description | Notes
 **modifier_list_data** | [**CatalogModifierList**](CatalogModifierList.md) | Structured data for a [CatalogModifierList](#type-catalogmodifierlist), set for CatalogObjects of type `MODIFIER_LIST`. | [optional] 
 **modifier_data** | [**CatalogModifier**](CatalogModifier.md) | Structured data for a [CatalogModifier](#type-catalogmodifier), set for CatalogObjects of type `MODIFIER`. | [optional] 
 **image_data** | [**CatalogImage**](CatalogImage.md) | Structured data for a [CatalogImage](#type-catalogimage), set for CatalogObjects of type `IMAGE`. | [optional] 
+**measurement_unit_data** | [**CatalogMeasurementUnit**](CatalogMeasurementUnit.md) | Structured data for a [CatalogMeasurementUnit](#type-catalogmeasurementunit), set for CatalogObjects of type `MEASUREMENT_UNIT`. | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

docs/CatalogObjectType.md

@@ -16,6 +16,9 @@ Name | Type
 **DISCOUNT** | string
 **MODIFIER_LIST** | string
 **MODIFIER** | string
+**PRICING_RULE** | string
+**PRODUCT_SET** | string
+**TIME_PERIOD** | string
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)