Merge pull request #57 from square/release/10.0.0.20210421

Generated PR for Release: 10.0.0.20210421

Author: Wolfgang Schuster

CHANGELOG.md

@@ -1,5 +1,51 @@
 # Change Log
 
+## Version 10.0.0.20210421 (2021-04-21)
+## New API releases
+
+## Existing API updates
+
+* **Subscriptions API:** 
+  *  [ResumeSubscription.](https://developer.squareup.com/reference/square_2021-04-21/subscriptions-api/resume-subscription) This new endpoint enables applications to resume [deactivated subscriptions.](https://developer.squareup.com/docs/subscriptions-api/overview#deactivated-subscriptions) After a subscription is created, there are events that can make a subscription non-billable, causing Square to deactivate the subscription. A seller can also resume deactivated subscriptions in the Seller Dashboard. Applications can call  [ListSubscriptionEvents](https://developer.squareup.com/reference/square_2021-04-21/subscriptions-api/list-subscription-events) to determine why Square deactivated a subscription.
+ 
+* **Customers API:**
+
+  * [Customer](https://developer.squareup.com/reference/square_2021-04-21/objects/Customer) object:
+    * New `version` field (beta). This field represents the current version of the customer profile. You can include it in your `UpdateCustomer` and `DeleteCustomer` requests to  enable optimistic concurrency. For more information, see [Customer profile versions and optimistic concurrency support.](https://developer.squareup.com/docs/customers-api/what-it-does#customer-profile-versions-and-optimistic-concurrency-support) 
+    * The `groups` field and corresponding `CustomerGroupInfo` object are retired.
+    
+  * [Customer webhooks](https://developer.squareup.com/docs/customers-api/use-the-api/customer-webhooks) have moved to the [general availability](https://developer.squareup.com/docs/build-basics/api-lifecycle#general-availability) (GA) state. Event notifications now include the `version` field (beta).
+  
+* **Invoices API:**
+
+  * The [Invoices API](https://developer.squareup.com/docs/invoices-api/overview) has moved to the GA state.
+
+  * [Invoice](https://developer.squareup.com/reference/square_2021-04-21/objects/Invoice) object:
+    * A new required `accepted_payment_methods` field that defines the methods of payment that customers can use to pay an invoice on the Square-hosted invoice page. Valid values are defined in the new [InvoiceAcceptedPaymentMethods](https://developer.squareup.com/reference/square_2021-04-21/objects/InvoiceAcceptedPaymentMethods) enum. For more information, see the [migration notes.](https://developer.squareup.com/docs/invoices-api/overview#migration-notes)
+    * A new `subscription_id` field, which is included in invoices created for subscription billing.
+
+* **Loyalty API:** (beta)
+ 
+  * [RetrieveLoyaltyProgram](https://developer.squareup.com/reference/square_2021-04-21/loyalty-api/retrieve-loyalty-program) endpoint. This new endpoint accepts a program ID or the `main` keyword and returns the loyalty program in a seller's account. For more information, see [Retrieve a loyalty program.](https://developer.squareup.com/docs/loyalty-api/overview#retrieve-loyalty-program) This endpoint is preferred over the `ListLoyaltyPrograms` endpoint.
+
+  * Introduced a new mapping implementation for loyalty accounts:
+    * [LoyaltyAccount](https://developer.squareup.com/reference/square_2021-04-21/objects/LoyaltyAccount) object. Added the `mapping` field (of type `LoyaltyAccountMapping`), which is used to associate the loyalty account with a buyer. This field is recommended over the `mappings` field.
+    * [LoyaltyAccountMapping](https://developer.squareup.com/reference/square_2021-04-21/objects/LoyaltyAccountMapping) object. Added the `phone_number` field to represent a phone number mapping. This field is recommended over the `type` and `value` fields.
+
+  * A new [loyalty.program.created](https://developer.squareup.com/reference/square_2021-04-21/webhooks/loyalty.program.created) webhook. Square now publishes an event notification when a loyalty program is created in the Square Seller Dashboard.
+
+* **Inventory API:** 
+  * [InventoryChange](https://developer.squareup.com/reference/square_2021-04-21/objects/InventoryChange) can now have its own measurement unit.
+
+* **Catalog API:** 
+  * [CatalogItem](https://developer.squareup.com/reference/square_2021-04-21/objects/CatalogItem) introduces the  `sort_name` attribute that can take Japanese writing scripts to sort items by. When it is unspecified, the regular `name` attribute is used for sorting.
+  * [CatalogPricingRule](https://developer.squareup.com/reference/square_2021-04-21/objects/CatalogCatalogPricingRule) has the new `customer_group_ids_any` attribute included to support automatic application of discounts to specified product set purchased by members of any of the customer groups identified by the `customer_group_ids_any` attribute values.
+* **Team API**
+  * New [Team webhooks](https://developer.squareup.com/reference/square_2021-04-21/team-api/webhooks): `team_member.created`, `team_member.updated`, `team_member.wage_setting.updated` to notify on created and updated team members and wage settings.
+
+
+
+
 ## Version 9.1.0.20210317 (2021-03-17)
 
 ## Existing API updates

doc/api/bank-accounts.md

@@ -17,7 +17,7 @@ bank_accounts_api = client.bank_accounts
 
 # List Bank Accounts
 
-Returns a list of [BankAccount](#type-bankaccount) objects linked to a Square account.
+Returns a list of [BankAccount](/doc/models/bank-account.md) objects linked to a Square account.
 
 ```python
 def list_bank_accounts(self,
@@ -56,7 +56,7 @@ elif result.is_error():
 
 # Get Bank Account by V1 Id
 
-Returns details of a [BankAccount](#type-bankaccount) identified by V1 bank account ID.
+Returns details of a [BankAccount](/doc/models/bank-account.md) identified by V1 bank account ID.
 
 ```python
 def get_bank_account_by_v1_id(self,
@@ -89,7 +89,7 @@ elif result.is_error():
 
 # Get Bank Account
 
-Returns details of a [BankAccount](#type-bankaccount)
+Returns details of a [BankAccount](/doc/models/bank-account.md)
 linked to a Square account.
 
 ```python

doc/api/bookings.md

@@ -228,7 +228,7 @@ def retrieve_booking(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `booking_id` | `string` | Template, Required | The ID of the [Booking](#type-booking) object representing the to-be-retrieved booking. |
+| `booking_id` | `string` | Template, Required | The ID of the [Booking](/doc/models/booking.md) object representing the to-be-retrieved booking. |
 
 ## Response Type
 
@@ -262,7 +262,7 @@ def update_booking(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `booking_id` | `string` | Template, Required | The ID of the [Booking](#type-booking) object representing the to-be-updated booking. |
+| `booking_id` | `string` | Template, Required | The ID of the [Booking](/doc/models/booking.md) object representing the to-be-updated booking. |
 | `body` | [`Update Booking Request`](/doc/models/update-booking-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ## Response Type
@@ -305,7 +305,7 @@ def cancel_booking(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `booking_id` | `string` | Template, Required | The ID of the [Booking](#type-booking) object representing the to-be-cancelled booking. |
+| `booking_id` | `string` | Template, Required | The ID of the [Booking](/doc/models/booking.md) object representing the to-be-cancelled booking. |
 | `body` | [`Cancel Booking Request`](/doc/models/cancel-booking-request.md) | Body, Required | An object containing the fields to POST for the request.<br><br>See the corresponding object definition for field details. |
 
 ## Response Type

doc/api/cash-drawers.md

@@ -67,7 +67,7 @@ elif result.is_error():
 # Retrieve Cash Drawer Shift
 
 Provides the summary details for a single cash drawer shift. See
-[ListCashDrawerShiftEvents](#endpoint-CashDrawers-ListCashDrawerShiftEvents) for a list of cash drawer shift events.
+[ListCashDrawerShiftEvents](/doc/api/cash-drawers.md#list-cash-drawer-shift-events) for a list of cash drawer shift events.
 
 ```python
 def retrieve_cash_drawer_shift(self,

doc/api/catalog.md

@@ -27,11 +27,11 @@ catalog_api = client.catalog
 
 # Batch Delete Catalog Objects
 
-Deletes a set of [CatalogItem](#type-catalogitem)s based on the
+Deletes a set of [CatalogItem](/doc/models/catalog-item.md)s based on the
 provided list of target IDs and returns a set of successfully deleted IDs in
 the response. Deletion is a cascading event such that all children of the
 targeted object are also deleted. For example, deleting a CatalogItem will
-also delete all of its [CatalogItemVariation](#type-catalogitemvariation)
+also delete all of its [CatalogItemVariation](/doc/models/catalog-item-variation.md)
 children.
 
 `BatchDeleteCatalogObjects` succeeds even if only a portion of the targeted
@@ -71,11 +71,11 @@ elif result.is_error():
 # Batch Retrieve Catalog Objects
 
 Returns a set of objects based on the provided ID.
-Each [CatalogItem](#type-catalogitem) returned in the set includes all of its
+Each [CatalogItem](/doc/models/catalog-item.md) returned in the set includes all of its
 child information including: all of its
-[CatalogItemVariation](#type-catalogitemvariation) objects, references to
-its [CatalogModifierList](#type-catalogmodifierlist) objects, and the ids of
-any [CatalogTax](#type-catalogtax) objects that apply to it.
+[CatalogItemVariation](/doc/models/catalog-item-variation.md) objects, references to
+its [CatalogModifierList](/doc/models/catalog-modifier-list.md) objects, and the ids of
+any [CatalogTax](/doc/models/catalog-tax.md) objects that apply to it.
 
 ```python
 def batch_retrieve_catalog_objects(self,
@@ -338,8 +338,8 @@ elif result.is_error():
 
 # Create Catalog Image
 
-Uploads an image file to be represented by a [CatalogImage](#type-catalogimage) object linked to an existing
-[CatalogObject](#type-catalogobject) instance. A call to this endpoint can upload an image, link an image to
+Uploads an image file to be represented by a [CatalogImage](/doc/models/catalog-image.md) object linked to an existing
+[CatalogObject](/doc/models/catalog-object.md) instance. A call to this endpoint can upload an image, link an image to
 a catalog object, or do both.
 
 This `CreateCatalogImage` endpoint accepts HTTP multipart/form-data requests with a JSON part and an image file part in
@@ -423,14 +423,14 @@ elif result.is_error():
 
 # List Catalog
 
-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:
+Returns a list of [CatalogObject](/doc/models/catalog-object.md)s that includes
+all objects of a set of desired types (for example, all [CatalogItem](/doc/models/catalog-item.md)
+and [CatalogTax](/doc/models/catalog-tax.md) objects) in the catalog. The `types` parameter
+is specified as a comma-separated list of valid [CatalogObject](/doc/models/catalog-object.md) types:
 `ITEM`, `ITEM_VARIATION`, `MODIFIER`, `MODIFIER_LIST`, `CATEGORY`, `DISCOUNT`, `TAX`, `IMAGE`.
 
 __Important:__ ListCatalog does not return deleted catalog items. To retrieve
-deleted catalog items, use [SearchCatalogObjects](#endpoint-Catalog-SearchCatalogObjects)
+deleted catalog items, use [SearchCatalogObjects](/doc/api/catalog.md#search-catalog-objects)
 and set the `include_deleted_objects` attribute value to `true`.
 
 ```python
@@ -446,7 +446,7 @@ def list_catalog(self,
 |  --- | --- | --- | --- |
 | `cursor` | `string` | Query, Optional | The pagination cursor returned in the previous response. Leave unset for an initial request.<br>See [Pagination](https://developer.squareup.com/docs/basics/api101/pagination) for more information. |
 | `types` | `string` | Query, Optional | An optional case-insensitive, comma-separated list of object types to retrieve, for example<br>`ITEM,ITEM_VARIATION,CATEGORY,IMAGE`.<br><br>The legal values are taken from the CatalogObjectType enum:<br>`ITEM`, `ITEM_VARIATION`, `CATEGORY`, `DISCOUNT`, `TAX`,<br>`MODIFIER`, `MODIFIER_LIST`, or `IMAGE`. |
-| `catalog_version` | `long|int` | Query, Optional | The specific version of the catalog objects to be included in the response.<br>This allows you to retrieve historical<br>versions of objects. The specified version value is matched against<br>the [CatalogObject](#type-catalogobject)s' `version` attribute. |
+| `catalog_version` | `long|int` | Query, Optional | The specific version of the catalog objects to be included in the response.<br>This allows you to retrieve historical<br>versions of objects. The specified version value is matched against<br>the [CatalogObject](/doc/models/catalog-object.md)s' `version` attribute. |
 
 ## Response Type
 
@@ -470,7 +470,7 @@ elif result.is_error():
 
 # Upsert Catalog Object
 
-Creates or updates the target [CatalogObject](#type-catalogobject).
+Creates or updates the target [CatalogObject](/doc/models/catalog-object.md).
 
 ```python
 def upsert_catalog_object(self,
@@ -531,12 +531,12 @@ elif result.is_error():
 
 # Delete Catalog Object
 
-Deletes a single [CatalogObject](#type-catalogobject) based on the
+Deletes a single [CatalogObject](/doc/models/catalog-object.md) based on the
 provided ID and returns the set of successfully deleted IDs in the response.
 Deletion is a cascading event such that all children of the targeted object
-are also deleted. For example, deleting a [CatalogItem](#type-catalogitem)
+are also deleted. For example, deleting a [CatalogItem](/doc/models/catalog-item.md)
 will also delete all of its
-[CatalogItemVariation](#type-catalogitemvariation) children.
+[CatalogItemVariation](/doc/models/catalog-item-variation.md) children.
 
 ```python
 def delete_catalog_object(self,
@@ -569,13 +569,13 @@ elif result.is_error():
 
 # Retrieve Catalog Object
 
-Returns a single [CatalogItem](#type-catalogitem) as a
-[CatalogObject](#type-catalogobject) based on the provided ID. The returned
-object includes all of the relevant [CatalogItem](#type-catalogitem)
-information including: [CatalogItemVariation](#type-catalogitemvariation)
+Returns a single [CatalogItem](/doc/models/catalog-item.md) as a
+[CatalogObject](/doc/models/catalog-object.md) based on the provided ID. The returned
+object includes all of the relevant [CatalogItem](/doc/models/catalog-item.md)
+information including: [CatalogItemVariation](/doc/models/catalog-item-variation.md)
 children, references to its
-[CatalogModifierList](#type-catalogmodifierlist) objects, and the ids of
-any [CatalogTax](#type-catalogtax) objects that apply to it.
+[CatalogModifierList](/doc/models/catalog-modifier-list.md) objects, and the ids of
+any [CatalogTax](/doc/models/catalog-tax.md) objects that apply to it.
 
 ```python
 def retrieve_catalog_object(self,
@@ -590,7 +590,7 @@ def retrieve_catalog_object(self,
 |  --- | --- | --- | --- |
 | `object_id` | `string` | Template, Required | The object ID of any type of catalog objects to be retrieved. |
 | `include_related_objects` | `bool` | Query, Optional | If `true`, the response will include additional objects that are related to the<br>requested object, as follows:<br><br>If the `object` field of the response contains a `CatalogItem`, its associated<br>`CatalogCategory`, `CatalogTax`, `CatalogImage` and `CatalogModifierList` objects will<br>be returned in the `related_objects` field of the response. If the `object` field of<br>the response contains a `CatalogItemVariation`, its parent `CatalogItem` will be returned<br>in the `related_objects` field of the response.<br><br>Default value: `false`<br>**Default**: `False` |
-| `catalog_version` | `long|int` | Query, Optional | Requests objects as of a specific version of the catalog. This allows you to retrieve historical<br>versions of objects. The value to retrieve a specific version of an object can be found<br>in the version field of [CatalogObject](#type-catalogobject)s. |
+| `catalog_version` | `long|int` | Query, Optional | Requests objects as of a specific version of the catalog. This allows you to retrieve historical<br>versions of objects. The value to retrieve a specific version of an object can be found<br>in the version field of [CatalogObject](/doc/models/catalog-object.md)s. |
 
 ## Response Type
 
@@ -614,10 +614,10 @@ elif result.is_error():
 
 # Search Catalog Objects
 
-Searches for [CatalogObject](#type-CatalogObject) of any type by matching supported search attribute values,
+Searches for [CatalogObject](/doc/models/catalog-object.md) of any type by matching supported search attribute values,
 excluding custom attribute values on items or item variations, against one or more of the specified query expressions.
 
-This (`SearchCatalogObjects`) endpoint differs from the [SearchCatalogItems](#endpoint-Catalog-SearchCatalogItems)
+This (`SearchCatalogObjects`) endpoint differs from the [SearchCatalogItems](/doc/api/catalog.md#search-catalog-items)
 endpoint in the following aspects:
 
 - `SearchCatalogItems` can only search for items or item variations, whereas `SearchCatalogObjects` can search for any type of catalog objects.
@@ -683,7 +683,7 @@ elif result.is_error():
 Searches for catalog items or item variations by matching supported search attribute values, including
 custom attribute values, against one or more of the specified query expressions.
 
-This (`SearchCatalogItems`) endpoint differs from the [SearchCatalogObjects](#endpoint-Catalog-SearchCatalogObjects)
+This (`SearchCatalogItems`) endpoint differs from the [SearchCatalogObjects](/doc/api/catalog.md#search-catalog-objects)
 endpoint in the following aspects:
 
 - `SearchCatalogItems` can only search for items or item variations, whereas `SearchCatalogObjects` can search for any type of catalog objects.
@@ -769,8 +769,8 @@ elif result.is_error():
 
 # Update Item Modifier Lists
 
-Updates the [CatalogModifierList](#type-catalogmodifierlist) objects
-that apply to the targeted [CatalogItem](#type-catalogitem) without having
+Updates the [CatalogModifierList](/doc/models/catalog-modifier-list.md) objects
+that apply to the targeted [CatalogItem](/doc/models/catalog-item.md) without having
 to perform an upsert on the entire item.
 
 ```python
@@ -807,8 +807,8 @@ elif result.is_error():
 
 # Update Item Taxes
 
-Updates the [CatalogTax](#type-catalogtax) objects that apply to the
-targeted [CatalogItem](#type-catalogitem) without having to perform an
+Updates the [CatalogTax](/doc/models/catalog-tax.md) objects that apply to the
+targeted [CatalogItem](/doc/models/catalog-item.md) without having to perform an
 upsert on the entire item.
 
 ```python

doc/api/customer-groups.md

@@ -30,7 +30,7 @@ def list_customer_groups(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `cursor` | `string` | Query, Optional | A pagination cursor returned by a previous call to this endpoint.<br>Provide this to retrieve the next set of results for your original query.<br><br>See the [Pagination guide](https://developer.squareup.com/docs/working-with-apis/pagination) for more information. |
+| `cursor` | `string` | Query, Optional | A pagination cursor returned by a previous call to this endpoint.<br>Provide this cursor to retrieve the next set of results for your original query.<br><br>For more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination). |
 
 ## Response Type
 

doc/api/customer-segments.md

@@ -27,7 +27,7 @@ def list_customer_segments(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `cursor` | `string` | Query, Optional | A pagination cursor returned by previous calls to __ListCustomerSegments__.<br>Used to retrieve the next set of query results.<br><br>See the [Pagination guide](https://developer.squareup.com/docs/working-with-apis/pagination) for more information. |
+| `cursor` | `string` | Query, Optional | A pagination cursor returned by previous calls to `ListCustomerSegments`.<br>This cursor is used to retrieve the next set of query results.<br><br>For more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination). |
 
 ## Response Type