Merge pull request #53 from square/release/8.1.0.20210121

Generated PR for Release: 8.1.0.20210121

Author: mohsin-sq

CHANGELOG.md

@@ -1,11 +1,45 @@
 # Change Log
 
+## Version 8.1.0.20210121 (2021-01-21T00:00)
+## Existing API updates
+
+* **Invoices API:** (beta)
+
+  The `InvoicePaymentRequest.request_method` field is deprecated, and its current options are separated into two new fields that better represent their scope: 
+  * `Invoice.delivery_method` specifies how Square should send invoices, reminders, and receipts to the customer. 
+  * `InvoicePaymentRequest.automatic_payment_source` specifies the payment method for an automatic payment.
+
+  As part of this change, the [InvoiceDeliveryMethod](https://developer.squareup.com/reference/square_2021-01-21/enums/InvoiceDeliveryMethod) and [InvoiceAutomaticPaymentSource](https://developer.squareup.com/reference/square_2021-01-21/enums/InvoiceAutomaticPaymentSource) enums are added and the `InvoiceRequestMethod` enum is deprecated.
+
+  The Invoices API will continue to accept `request_method` in create and update requests until the field is retired, but starting in this version, `request_method` is not included in returned `Invoice` objects. For more information, see the [migration notes.](https://developer.squareup.com/docs/invoices-api/overview#migrate-InvoicePaymentRequest.request_method)
+  
+
+* **Locations API:**
+  * The [Locations.MCC](https://developer.squareup.com/reference/square_2021-01-21/objects/Location#definition__property-mcc) field is now updatable (beta). You can use the `UpdateLocation` endpoint to update the merchant category code (MCC) associated with a seller location. For more information, see [Initialize a merchant category code.](https://developer.squareup.com/docs/locations-api#initialize-a-merchant-category-code)
+
+
+
+
+## SDKs
+* **Connect Node.js SDK:** (deprecated) 
+
+  The deprecated Connect Node.js SDK is in the security [maintenance state.](https://developer.squareup.com/docs/build-basics/api-lifecycle#maintenance) It will not receive any bug fixes or API updates from the Square version 2021-01-21 release. However, the SDK will receive support and security patches until it is retired (EOL) in Q2, 2021. For more information, including steps for migrating to the [Square Node.js SDK,](https://github.com/square/square-nodejs-sdk) see the [Connect SDK README.](https://github.com/square/connect-nodejs-sdk/blob/master/README.md)
+  
+## Documentation updates
+* **Catalog API:**
+  * The [Use Item Options to Manage Item Variations](https://developer.squareup.com/docs/catalog-api/item-options-migration) topic is added. It demonstrates how item variations are usually used and how item options can be used to enable random access to item variations.
+
+* **Inventory API:**
+  * The [Inventory API](inventory-api/what-it-does) content is updated. It provides clearer guidance about how to use the API, with a task-oriented TOC and improved code examples.
+
+
+
 ## Version 8.0.0.20201216 (2020-12-16T00:00)
 ## Existing API updates
 
 * **Orders API:** 
-  * [OrderLineItemPricingBlocklists.](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderLineItemPricingBlocklists) You can explicitly specify taxes and discounts in an order or automatically apply preconfigured taxes and discounts to an order. In addition, you can now block applying these taxes and discounts to a specific [OrderLineItem](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderLineItem) in an [order](https://developer.squareup.com/reference/square_2020_12_16/objects/Order). You add the `pricing_blocklists` attribute to individual line items and specify the `blocked_discounts` and `blocked_taxes` that you do not want to apply. For more information, see [Apply Taxes and Discounts.](orders-api/apply-taxes-and-discounts) For example walkthroughs, see [Automatically Apply Discounts](orders-api/apply-taxes-and-discounts/auto-apply-discounts) and [Automatically Apply Taxes.](orders-api/apply-taxes-and-discounts/auto-apply-taxes)
-  * [OrderPricingOptions](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderPricingOptions). Previously, the `pricing_options` field in an [order](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderPricingOptions) supported only `auto_apply_discounts` to enable the automatic application of preconfigured discounts. Now it also supports `auto_apply_taxes` to enable the automatic application of preconfigured taxes. For more information, see [Automatically apply preconfigured catalog taxes or discounts.](orders-api/apply-taxes-and-discounts#automatically-apply-preconfigured-catalog-taxes-or-discounts)
+  * [OrderLineItemPricingBlocklists.](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderLineItemPricingBlocklists) You can explicitly specify taxes and discounts in an order or automatically apply preconfigured taxes and discounts to an order. In addition, you can now block applying these taxes and discounts to a specific [OrderLineItem](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderLineItem) in an [order](https://developer.squareup.com/reference/square_2020_12_16/objects/Order). You add the `pricing_blocklists` attribute to individual line items and specify the `blocked_discounts` and `blocked_taxes` that you do not want to apply. For more information, see [Apply Taxes and Discounts.](https://developer.squareup.com/docs/orders-api/apply-taxes-and-discounts) For example walkthroughs, see [Automatically Apply Discounts](https://developer.squareup.com/docs/orders-api/apply-taxes-and-discounts/auto-apply-discounts) and [Automatically Apply Taxes.](https://developer.squareup.com/docs/orders-api/apply-taxes-and-discounts/auto-apply-taxes)
+  * [OrderPricingOptions](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderPricingOptions). Previously, the `pricing_options` field in an [order](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderPricingOptions) supported only `auto_apply_discounts` to enable the automatic application of preconfigured discounts. Now it also supports `auto_apply_taxes` to enable the automatic application of preconfigured taxes. For more information, see [Automatically apply preconfigured catalog taxes or discounts.](https://developer.squareup.com/docs/orders-api/apply-taxes-and-discounts#automatically-apply-preconfigured-catalog-taxes-or-discounts)
 
   * [OrderLineItemTax](https://developer.squareup.com/reference/square_2020_12_16/objects/OrderLineItemTax). It now includes the new `auto_applied` field. It indicates whether the tax was automatically applied using a preconfigured [CatalogTax](https://developer.squareup.com/reference/square_2020_12_16/objects/CatalogTax). 
 
@@ -378,7 +412,7 @@ Square is excited to announce the public release of customized SDKs for [Java](h
 
 * __Beta release:__ SDKs updated to support the new [CashDrawerShifts](cashdrawershift-api/reporting) API.
 
-* Square now follows the semantic versioning scheme for all SDKs except PHP and Node.js. This versioning scheme uses three numbers to delineate MAJOR, MINOR, and PATCH versions of our SDK. In addition, the SDK version also includes the API version so you know what Square API version the SDK is related to. For more information, see [Versioning and SDKs](build-basics/versioning-overview#versioning-and-sdks).
+* Square now follows the semantic versioning scheme for all SDKs except PHP and Node.js. This versioning scheme uses three numbers to delineate MAJOR, MINOR, and PATCH versions of our SDK. In addition, the SDK version also includes the API version so you know what Square API version the SDK is related to. For more information, see [Versioning and SDKs](https://developer.squareup.com/docs/build-basics/versioning-overview#versioning-and-sdks).
 * Java, .Net, Python, and Ruby SDKs are now version 4.0.0. Java and .Net SDKs have breaking changes in version 4.0.0. Ruby and Python do not have breaking changes.
 
 ## Version 3.20191120.0 (2019-11-20)

LICENSE

@@ -1,4 +1,4 @@
-Copyright 2020 Square, Inc.
+Copyright 2121 Square, Inc.
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

README.md

@@ -2,7 +2,7 @@
 
 # Square Python SDK
 
-[![Travis status](https://travis-ci.com/square/square-python-sdk.svg?branch=master)](https://travis-ci.com/square/square-python-sdk)
+[![Travis status](https://travis-ci.org/square/square-python-sdk.svg?branch=master)](https://travis-ci.org/square/square-python-sdk)
 [![PyPi version](https://badge.fury.io/py/squareup.svg?new)](https://badge.fury.io/py/squareup)
 [![Apache-2 license](https://img.shields.io/badge/license-Apache2-brightgreen.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 

doc/api/bookings.md

@@ -156,7 +156,7 @@ def list_team_member_booking_profiles(self,
 
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
-| `bookable_only` | `bool` | Query, Optional | Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`). |
+| `bookable_only` | `bool` | Query, Optional | Indicates whether to include only bookable team members in the returned result (`true`) or not (`false`).<br>**Default**: `False` |
 | `limit` | `int` | Query, Optional | The maximum number of results to return. |
 | `cursor` | `string` | Query, Optional | The cursor for paginating through the results. |
 | `location_id` | `string` | Query, Optional | Indicates whether to include only team members enabled at the given location in the returned result. |

doc/api/catalog.md

@@ -589,7 +589,7 @@ def retrieve_catalog_object(self,
 | Parameter | Type | Tags | Description |
 |  --- | --- | --- | --- |
 | `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` |
+| `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. |
 
 ## Response Type
@@ -614,8 +614,8 @@ elif result.is_error():
 
 # Search Catalog Objects
 
-Searches for [CatalogObject](#type-CatalogObject) of any types against supported search attribute values,
-excluding custom attribute values on items or item variations, against one or more of the specified query expressions,
+Searches for [CatalogObject](#type-CatalogObject) 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)
 endpoint in the following aspects:
@@ -681,7 +681,7 @@ elif result.is_error():
 # Search Catalog Items
 
 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,
+custom attribute values, against one or more of the specified query expressions.
 
 This (`SearchCatalogItems`) endpoint differs from the [SearchCatalogObjects](#endpoint-Catalog-SearchCatalogObjects)
 endpoint in the following aspects:

doc/api/employees.md

@@ -16,6 +16,8 @@ employees_api = client.employees
 
 # List Employees
 
+**This endpoint is deprecated. **
+
 ListEmployees
 
 ```python
@@ -58,6 +60,8 @@ elif result.is_error():
 
 # Retrieve Employee
 
+**This endpoint is deprecated. **
+
 RetrieveEmployee
 
 ```python

doc/api/invoices.md

@@ -108,13 +108,14 @@ body['invoice']['payment_requests'] = []
 
 body['invoice']['payment_requests'].append({})
 body['invoice']['payment_requests'][0]['uid'] = 'uid4'
-body['invoice']['payment_requests'][0]['request_method'] = 'EMAIL'
+body['invoice']['payment_requests'][0]['request_method'] = 'SHARE_MANUALLY'
 body['invoice']['payment_requests'][0]['request_type'] = 'BALANCE'
 body['invoice']['payment_requests'][0]['due_date'] = '2030-01-24'
 body['invoice']['payment_requests'][0]['fixed_amount_requested_money'] = {}
 body['invoice']['payment_requests'][0]['fixed_amount_requested_money']['amount'] = 52
 body['invoice']['payment_requests'][0]['fixed_amount_requested_money']['currency'] = 'USS'
 body['invoice']['payment_requests'][0]['tipping_enabled'] = True
+body['invoice']['payment_requests'][0]['automatic_payment_source'] = 'NONE'
 body['invoice']['payment_requests'][0]['reminders'] = []
 
 body['invoice']['payment_requests'][0]['reminders'].append({})
@@ -125,6 +126,7 @@ body['invoice']['payment_requests'][0]['reminders'][0]['status'] = 'PENDING'
 body['invoice']['payment_requests'][0]['reminders'][0]['sent_at'] = 'sent_at2'
 
 
+body['invoice']['delivery_method'] = 'EMAIL'
 body['invoice']['invoice_number'] = 'inv-100'
 body['invoice']['title'] = 'Event Planning Services'
 body['invoice']['description'] = 'We appreciate your business!'
@@ -333,7 +335,7 @@ elif result.is_error():
 Cancels an invoice. The seller cannot collect payments for
 the canceled invoice.
 
-You cannot cancel an invoice in a terminal state: `PAID`, `REFUNDED`, `CANCELED`, or `FAILED`.
+You cannot cancel an invoice in the `DRAFT` state or in a terminal state: `PAID`, `REFUNDED`, `CANCELED`, or `FAILED`.
 
 ```python
 def cancel_invoice(self,

doc/api/labor.md

@@ -238,6 +238,8 @@ elif result.is_error():
 
 # List Employee Wages
 
+**This endpoint is deprecated. **
+
 Returns a paginated list of `EmployeeWage` instances for a business.
 
 ```python
@@ -277,6 +279,8 @@ elif result.is_error():
 
 # Get Employee Wage
 
+**This endpoint is deprecated. **
+
 Returns a single `EmployeeWage` specified by id.
 
 ```python

doc/api/o-auth.md

@@ -17,6 +17,8 @@ o_auth_api = client.o_auth
 
 # Renew Token
 
+**This endpoint is deprecated. **
+
 `RenewToken` is deprecated. For information about refreshing OAuth access tokens, see
 [Renew OAuth Token](https://developer.squareup.com/docs/oauth-api/cookbook/renew-oauth-tokens).
 

doc/api/transactions.md

@@ -21,6 +21,8 @@ transactions_api = client.transactions
 
 # List Refunds
 
+**This endpoint is deprecated. **
+
 Lists refunds for one of a business's locations.
 
 In addition to full or partial tender refunds processed through Square APIs,
@@ -75,6 +77,8 @@ elif result.is_error():
 
 # List Transactions
 
+**This endpoint is deprecated. **
+
 Lists transactions for a particular location.
 
 Transactions include payment information from sales and exchanges and refund
@@ -125,6 +129,8 @@ elif result.is_error():
 
 # Charge
 
+**This endpoint is deprecated. **
+
 Charges a card represented by a card nonce or a customer's card on file.
 
 Your request to this endpoint must include _either_:
@@ -216,6 +222,8 @@ elif result.is_error():
 
 # Retrieve Transaction
 
+**This endpoint is deprecated. **
+
 Retrieves details for a single transaction.
 
 ```python
@@ -252,6 +260,8 @@ elif result.is_error():
 
 # Capture Transaction
 
+**This endpoint is deprecated. **
+
 Captures a transaction that was created with the [Charge](#endpoint-charge)
 endpoint with a `delay_capture` value of `true`.
 
@@ -292,6 +302,8 @@ elif result.is_error():
 
 # Create Refund
 
+**This endpoint is deprecated. **
+
 Initiates a refund for a previously charged tender.
 
 You must issue a refund within 120 days of the associated payment. See
@@ -345,6 +357,8 @@ elif result.is_error():
 
 # Void Transaction
 
+**This endpoint is deprecated. **
+
 Cancels a transaction that was created with the [Charge](#endpoint-charge)
 endpoint with a `delay_capture` value of `true`.