Merge pull request #96 from square/release/2.20190508.0

Release 2.20190508.0

CHANGES.md

@@ -1,5 +1,15 @@
 # Change Log
 
+## Version 2.20190508.0 (2019-05-08)
+
+## Details
+
+* **Beta functionality**: Orders API — support for fractional quantities,
+  expanded metadata, and embedded information on payments, refunds, and returns.
+* **Beta functionality**: Inventory API — support for fractional quantities.
+* **New functionality**: `Locations.business_hours` — read-only field with
+  information about the business hours at a particular location.
+
 ## Version 2.20190410.1 (2019-04-24)
 
 ## Details

README.md

@@ -148,6 +148,7 @@ Class | Method | HTTP request
 *OAuthApi* | [**revoke_token**](docs/OAuthApi.md#revoke_token) | **POST** /oauth2/revoke
 *OrdersApi* | [**batch_retrieve_orders**](docs/OrdersApi.md#batch_retrieve_orders) | **POST** /v2/locations/{location_id}/orders/batch-retrieve
 *OrdersApi* | [**create_order**](docs/OrdersApi.md#create_order) | **POST** /v2/locations/{location_id}/orders
+*OrdersApi* | [**search_orders**](docs/OrdersApi.md#search_orders) | **POST** /v2/orders/search
 *ReportingApi* | [**list_additional_recipient_receivable_refunds**](docs/ReportingApi.md#list_additional_recipient_receivable_refunds) | **GET** /v2/locations/{location_id}/additional-recipient-receivable-refunds
 *ReportingApi* | [**list_additional_recipient_receivables**](docs/ReportingApi.md#list_additional_recipient_receivables) | **GET** /v2/locations/{location_id}/additional-recipient-receivables
 *TransactionsApi* | [**capture_transaction**](docs/TransactionsApi.md#capture_transaction) | **POST** /v2/locations/{location_id}/transactions/{transaction_id}/capture
@@ -249,6 +250,8 @@ Class | Method | HTTP request
  - [BatchUpsertCatalogObjectsRequest](docs/BatchUpsertCatalogObjectsRequest.md)
  - [BatchUpsertCatalogObjectsResponse](docs/BatchUpsertCatalogObjectsResponse.md)
  - [BreakType](docs/BreakType.md)
+ - [BusinessHours](docs/BusinessHours.md)
+ - [BusinessHoursPeriod](docs/BusinessHoursPeriod.md)
  - [CaptureTransactionRequest](docs/CaptureTransactionRequest.md)
  - [CaptureTransactionResponse](docs/CaptureTransactionResponse.md)
  - [Card](docs/Card.md)
@@ -358,18 +361,29 @@ Class | Method | HTTP request
  - [ListWorkweekConfigsRequest](docs/ListWorkweekConfigsRequest.md)
  - [ListWorkweekConfigsResponse](docs/ListWorkweekConfigsResponse.md)
  - [Location](docs/Location.md)
+ - [MeasurementUnit](docs/MeasurementUnit.md)
+ - [MeasurementUnitCustom](docs/MeasurementUnitCustom.md)
  - [ModelBreak](docs/ModelBreak.md)
  - [Money](docs/Money.md)
  - [ObtainTokenRequest](docs/ObtainTokenRequest.md)
  - [ObtainTokenResponse](docs/ObtainTokenResponse.md)
  - [Order](docs/Order.md)
+ - [OrderEntry](docs/OrderEntry.md)
  - [OrderFulfillment](docs/OrderFulfillment.md)
  - [OrderFulfillmentPickupDetails](docs/OrderFulfillmentPickupDetails.md)
  - [OrderFulfillmentRecipient](docs/OrderFulfillmentRecipient.md)
  - [OrderLineItem](docs/OrderLineItem.md)
  - [OrderLineItemDiscount](docs/OrderLineItemDiscount.md)
  - [OrderLineItemModifier](docs/OrderLineItemModifier.md)
  - [OrderLineItemTax](docs/OrderLineItemTax.md)
+ - [OrderMoneyAmounts](docs/OrderMoneyAmounts.md)
+ - [OrderQuantityUnit](docs/OrderQuantityUnit.md)
+ - [OrderReturn](docs/OrderReturn.md)
+ - [OrderReturnDiscount](docs/OrderReturnDiscount.md)
+ - [OrderReturnLineItem](docs/OrderReturnLineItem.md)
+ - [OrderReturnLineItemModifier](docs/OrderReturnLineItemModifier.md)
+ - [OrderReturnTax](docs/OrderReturnTax.md)
+ - [OrderRoundingAdjustment](docs/OrderRoundingAdjustment.md)
  - [OrderSource](docs/OrderSource.md)
  - [Refund](docs/Refund.md)
  - [RegisterDomainRequest](docs/RegisterDomainRequest.md)
@@ -398,6 +412,16 @@ Class | Method | HTTP request
  - [SearchCatalogObjectsResponse](docs/SearchCatalogObjectsResponse.md)
  - [SearchCustomersRequest](docs/SearchCustomersRequest.md)
  - [SearchCustomersResponse](docs/SearchCustomersResponse.md)
+ - [SearchOrdersCustomerFilter](docs/SearchOrdersCustomerFilter.md)
+ - [SearchOrdersDateTimeFilter](docs/SearchOrdersDateTimeFilter.md)
+ - [SearchOrdersFilter](docs/SearchOrdersFilter.md)
+ - [SearchOrdersFulfillmentFilter](docs/SearchOrdersFulfillmentFilter.md)
+ - [SearchOrdersQuery](docs/SearchOrdersQuery.md)
+ - [SearchOrdersRequest](docs/SearchOrdersRequest.md)
+ - [SearchOrdersResponse](docs/SearchOrdersResponse.md)
+ - [SearchOrdersSort](docs/SearchOrdersSort.md)
+ - [SearchOrdersSourceFilter](docs/SearchOrdersSourceFilter.md)
+ - [SearchOrdersStateFilter](docs/SearchOrdersStateFilter.md)
  - [SearchShiftsRequest](docs/SearchShiftsRequest.md)
  - [SearchShiftsResponse](docs/SearchShiftsResponse.md)
  - [Shift](docs/Shift.md)
@@ -565,6 +589,7 @@ Class | Method | HTTP request
  - [CustomerCreationSource](docs/CustomerCreationSource.md)
  - [CustomerInclusionExclusion](docs/CustomerInclusionExclusion.md)
  - [CustomerSortField](docs/CustomerSortField.md)
+ - [DayOfWeek](docs/DayOfWeek.md)
  - [EmployeeStatus](docs/EmployeeStatus.md)
  - [ErrorCategory](docs/ErrorCategory.md)
  - [ErrorCode](docs/ErrorCode.md)
@@ -574,16 +599,22 @@ Class | Method | HTTP request
  - [LocationCapability](docs/LocationCapability.md)
  - [LocationStatus](docs/LocationStatus.md)
  - [LocationType](docs/LocationType.md)
+ - [MeasurementUnitArea](docs/MeasurementUnitArea.md)
+ - [MeasurementUnitLength](docs/MeasurementUnitLength.md)
+ - [MeasurementUnitVolume](docs/MeasurementUnitVolume.md)
+ - [MeasurementUnitWeight](docs/MeasurementUnitWeight.md)
  - [OrderFulfillmentPickupDetailsScheduleType](docs/OrderFulfillmentPickupDetailsScheduleType.md)
  - [OrderFulfillmentState](docs/OrderFulfillmentState.md)
  - [OrderFulfillmentType](docs/OrderFulfillmentType.md)
  - [OrderLineItemDiscountScope](docs/OrderLineItemDiscountScope.md)
  - [OrderLineItemDiscountType](docs/OrderLineItemDiscountType.md)
  - [OrderLineItemTaxScope](docs/OrderLineItemTaxScope.md)
  - [OrderLineItemTaxType](docs/OrderLineItemTaxType.md)
+ - [OrderState](docs/OrderState.md)
  - [Product](docs/Product.md)
  - [RefundStatus](docs/RefundStatus.md)
  - [RegisterDomainResponseStatus](docs/RegisterDomainResponseStatus.md)
+ - [SearchOrdersSortField](docs/SearchOrdersSortField.md)
  - [ShiftFilterStatus](docs/ShiftFilterStatus.md)
  - [ShiftSortField](docs/ShiftSortField.md)
  - [ShiftStatus](docs/ShiftStatus.md)

docs/BatchRetrieveOrdersResponse.md

@@ -10,6 +10,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **orders** | [**list[Order]**](Order.md) | The requested orders. This will omit any requested orders that do not exist or are not charged. | [optional] 
 **errors** | [**list[Error]**](Error.md) | Any errors that occurred during the request. | [optional] 
+**unconvertible_transaction_ids** | **list[str]** | List of transaction ids within the requested set of ids that encountered transformation issues when being converted to an Order. | [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/BusinessHours.md

@@ -0,0 +1,15 @@
+# BusinessHours
+> squareconnect.models.business_hours
+
+### Description
+
+ Represents the hours of operation for a business location.
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**periods** | [**list[BusinessHoursPeriod]**](BusinessHoursPeriod.md) | The list of time periods during which the business is open. There may be at most 10 periods per day. | [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/BusinessHoursPeriod.md

@@ -0,0 +1,17 @@
+# BusinessHoursPeriod
+> squareconnect.models.business_hours_period
+
+### Description
+
+ Represents a period of time during which a business location is open.
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**day_of_week** | **str** | The day of week for this time period. See [DayOfWeek](#type-dayofweek) for possible values | [optional] 
+**start_local_time** | **str** | The start time of a business hours period, specified in local time using partial-time RFC3339 format. | [optional] 
+**end_local_time** | **str** | The end time of a business hours period, specified in local time using partial-time RFC3339 format. | [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/ChargeRequest.md

@@ -16,9 +16,9 @@ Name | Type | Description | Notes
 **reference_id** | **str** | An optional ID you can associate with the transaction for your own purposes (such as to associate the transaction with an entity ID in your own database).  This value cannot exceed 40 characters. | [optional] 
 **note** | **str** | An optional note to associate with the transaction.  This value cannot exceed 60 characters. | [optional] 
 **customer_id** | **str** | The ID of the customer to associate this transaction with. This field is required if you provide a value for `customer_card_id`, and optional otherwise. | [optional] 
-**billing_address** | [**Address**](Address.md) | The buyer's billing address. This value is optional, but this transaction is ineligible for chargeback protection if neither this parameter nor `shipping_address` is provided. | [optional] 
-**shipping_address** | [**Address**](Address.md) | The buyer's shipping address, if available. This value is optional, but this transaction is ineligible for chargeback protection if neither this parameter nor `billing_address` is provided. | [optional] 
-**buyer_email_address** | **str** | The buyer's email address, if available. This value is optional, but this transaction is ineligible for chargeback protection if it is not provided. | [optional] 
+**billing_address** | [**Address**](Address.md) | The buyer's billing address. | [optional] 
+**shipping_address** | [**Address**](Address.md) | The buyer's shipping address, if available. | [optional] 
+**buyer_email_address** | **str** | The buyer's email address, if available. | [optional] 
 **order_id** | **str** | The ID of the order to associate with this transaction.  If you provide this value, the `amount_money` value of your request must __exactly match__ the value of the order's `total_money` field. | [optional] 
 **additional_recipients** | [**list[AdditionalRecipient]**](AdditionalRecipient.md) | The basic primitive of multi-party transaction. The value is optional. The transaction facilitated by you can be split from here.  If you provide this value, the `amount_money` value in your additional_recipients must not be more than 90% of the `amount_money` value in the charge request. The `location_id` must be the valid location of the app owner merchant.  This field requires the `PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS` OAuth permission.  This field is currently not supported in sandbox. | [optional] 
 

docs/CreateOrderRequest.md

@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **order** | [**Order**](Order.md) | The order to create. If this field is set, then the only other top-level field that can be set is the idempotency_key. | [optional] 
 **idempotency_key** | **str** | A value you specify that uniquely identifies this order among orders you've created.  If you're unsure whether a particular order was created successfully, you can reattempt it with the same idempotency key without worrying about creating duplicate orders.  See [Idempotency](/basics/api101/idempotency) for more information. | [optional] 
-**reference_id** | **str** | __Deprecated__: Please set the reference_id on the nested [order](#type-order) field instead.  An optional ID you can associate with the order for your own purposes (such as to associate the order with an entity ID in your own database).  This value cannot exceed 40 characters. | [optional] 
+**reference_id** | **str** | __Deprecated__: Please set the reference_id on the nested [order](#type-order) field instead.  An optional ID you can associate with the order for your own purposes (such as to associate the order with an entity ID in your own database).  This value cannot exceed 40 characters. -- Top-level fields necessary to support the connect v2 CreateOrderRequest shape. | [optional] 
 **line_items** | [**list[CreateOrderRequestLineItem]**](CreateOrderRequestLineItem.md) | __Deprecated__: Please set the line_items on the nested [order](#type-order) field instead.  The line items to associate with this order.  Each line item represents a different product to include in a purchase. | [optional] 
 **taxes** | [**list[CreateOrderRequestTax]**](CreateOrderRequestTax.md) | __Deprecated__: Please set the taxes on the nested [order](#type-order) field instead.  The taxes to include on the order. | [optional] 
 **discounts** | [**list[CreateOrderRequestDiscount]**](CreateOrderRequestDiscount.md) | __Deprecated__: Please set the discounts on the nested [order](#type-order) field instead.  The discounts to include on the order. | [optional] 

docs/CreateOrderRequestTax.md

@@ -10,7 +10,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **catalog_object_id** | **str** | Only used for catalog taxes. The catalog object ID of an existing [CatalogTax](#type-catalogtax).  Do not provide a value for this field if you provide values in other fields for an ad hoc tax. | [optional] 
 **name** | **str** | Only used for ad hoc taxes. The tax's name.  Do not provide a value for this field if you set `catalog_object_id`. | [optional] 
-**type** | **str** | Only used for ad hoc taxes. Indicates the calculation method used to apply the line item tax.  Default: `ADDITIVE`; See [OrderLineItemTaxType](#type-orderlineitemtaxtype) for possible values | [optional] 
+**type** | **str** | Only used for ad hoc taxes. Indicates the calculation method used to apply the line item tax.  Default: `ADDITIVE`; See [OrderLineItemTaxType](#type-orderlineitemtaxtype) for possible values. See [OrderLineItemTaxType](#type-orderlineitemtaxtype) for possible values | [optional] 
 **percentage** | **str** | Only used for ad hoc taxes. The percentage of the tax, as a string representation of a decimal number.  A value of `7.25` corresponds to a percentage of 7.25%. This value range between 0.0 up to 100.0 | [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/DayOfWeek.md

@@ -0,0 +1,21 @@
+# DayOfWeek
+
+
+### Description
+
+ Indicates the specific day  of the week.
+
+## Properties
+Name | Type
+------------ | -------------
+**SUN** | string
+**MON** | string
+**TUE** | string
+**WED** | string
+**THU** | string
+**FRI** | string
+**SAT** | 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/ErrorCode.md

@@ -81,6 +81,8 @@ Name | Type
 **INVALID_PHONE_NUMBER** | string
 **CHECKOUT_EXPIRED** | string
 **BAD_CERTIFICATE** | string
+**INVALID_SQUARE_VERSION_FORMAT** | string
+**API_VERSION_INCOMPATIBLE** | string
 **CARD_DECLINED** | string
 **VERIFY_CVV_FAILURE** | string
 **VERIFY_AVS_FAILURE** | string

docs/InventoryAdjustment.md

@@ -15,7 +15,7 @@ Name | Type | Description | Notes
 **location_id** | **str** | The Square ID of the [Location](#type-location) where the related quantity of items are being tracked. | [optional] 
 **catalog_object_id** | **str** | The Square generated ID of the [CatalogObject](#type-catalogobject) being tracked. | [optional] 
 **catalog_object_type** | **str** | The [CatalogObjectType](#type-catalogobjecttype) of the [CatalogObject](#type-catalogobject) being tracked. Tracking is only supported for the `ITEM_VARIATION` type. | [optional] 
-**quantity** | **str** | The number of items affected by the adjustment as a decimal string. Fractional quantities are not supported. | [optional] 
+**quantity** | **str** | The number of items affected by the adjustment as a decimal string. Can support up to 5 digits after the decimal point.  _Important_: The Point of Sale app and Dashboard do not currently support decimal quantities. If a Point of Sale app or Dashboard attempts to read a decimal quantity on inventory counts or adjustments, the quantity will be rounded down to the nearest integer. For example, `2.5` will become `2`, and `-2.5` will become `-3`. Read [Decimal Quantities (BETA)](/more-apis/inventory/overview#decimal-quantities-beta) for more information. | [optional] 
 **total_price_money** | [**Money**](Money.md) | The read-only total price paid for goods associated with the adjustment. Present if and only if `to_state` is `SOLD`. Always non-negative. | [optional] 
 **occurred_at** | **str** | A client-generated timestamp in RFC 3339 format that indicates when the adjustment took place. For write actions, the `occurred_at` timestamp cannot be older than 24 hours or in the future relative to the time of the request. | [optional] 
 **created_at** | **str** | A read-only timestamp in RFC 3339 format that indicates when Square received the adjustment. | [optional] 

docs/InventoryCount.md

@@ -3,7 +3,7 @@
 
 ### Description
 
-Represents the estimated quantity of items in a particular state at a particular location based on the known history of physical counts and inventory adjustments.
+Represents Square's estimated quantity of items in a particular state at a particular location based on the known history of physical counts and inventory adjustments
 
 ## Properties
 Name | Type | Description | Notes
@@ -12,7 +12,7 @@ Name | Type | Description | Notes
 **catalog_object_type** | **str** | The [CatalogObjectType](#type-catalogobjecttype) of the [CatalogObject](#type-catalogobject) being tracked. Tracking is only supported for the `ITEM_VARIATION` type. | [optional] 
 **state** | **str** | The current [InventoryState](#type-inventorystate) for the related quantity of items. See [InventoryState](#type-inventorystate) for possible values | [optional] 
 **location_id** | **str** | The Square ID of the [Location](#type-location) where the related quantity of items are being tracked. | [optional] 
-**quantity** | **str** | The number of items in the count as a decimal string. Fractional quantities are not supported. | [optional] 
+**quantity** | **str** | The number of items in the count as a decimal string. Can support up to 5 digits after the decimal point.  _Important_: The Point of Sale app and Dashboard do not currently support decimal quantities. If a Point of Sale app or Dashboard attempts to read a decimal quantity on inventory counts or adjustments, the quantity will be rounded down to the nearest integer. For example, `2.5` will become `2`, and `-2.5` will become `-3`. Read [Decimal Quantities (BETA)](/more-apis/inventory/overview#decimal-quantities-beta) for more information. | [optional] 
 **calculated_at** | **str** | A read-only timestamp in RFC 3339 format that indicates when Square received the most recent physical count or adjustment that had an affect on the estimated count. | [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)