square_connect 2.1.1.106 → 2.2.0.110

Sign up to get free protection for your applications and to get access to all the features.
Files changed (62) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +11 -4
  3. data/docs/Card.md +1 -0
  4. data/docs/CatalogApi.md +4 -4
  5. data/docs/CatalogItem.md +1 -1
  6. data/docs/CatalogItemProductType.md +1 -1
  7. data/docs/CatalogItemVariation.md +1 -1
  8. data/docs/CatalogObject.md +3 -3
  9. data/docs/CatalogQuery.md +2 -2
  10. data/docs/CatalogTax.md +1 -1
  11. data/docs/CatalogV1Id.md +2 -2
  12. data/docs/CreateCheckoutRequest.md +1 -1
  13. data/docs/{CreateOrderRequestOrder.md → CreateOrderRequest.md} +4 -2
  14. data/docs/CreateOrderRequestDiscount.md +14 -0
  15. data/docs/CreateOrderRequestLineItem.md +4 -2
  16. data/docs/CreateOrderRequestTax.md +14 -0
  17. data/docs/CustomersApi.md +2 -2
  18. data/docs/ErrorCode.md +1 -0
  19. data/docs/ItemVariationLocationOverrides.md +5 -5
  20. data/docs/Order.md +2 -1
  21. data/docs/OrderLineItem.md +5 -2
  22. data/docs/OrderLineItemDiscount.md +17 -0
  23. data/docs/OrderLineItemDiscountScope.md +13 -0
  24. data/docs/OrderLineItemDiscountType.md +16 -0
  25. data/docs/OrderLineItemTax.md +15 -0
  26. data/docs/OrderLineItemTaxType.md +14 -0
  27. data/docs/RetrieveCatalogObjectRequest.md +1 -1
  28. data/docs/SearchCatalogObjectsRequest.md +1 -1
  29. data/docs/Transaction.md +2 -2
  30. data/docs/TransactionsApi.md +1 -1
  31. data/lib/square_connect.rb +8 -1
  32. data/lib/square_connect/api/catalog_api.rb +6 -6
  33. data/lib/square_connect/api/customers_api.rb +4 -4
  34. data/lib/square_connect/api/transactions_api.rb +2 -2
  35. data/lib/square_connect/api_client.rb +1 -1
  36. data/lib/square_connect/models/card.rb +14 -4
  37. data/lib/square_connect/models/catalog_item.rb +1 -1
  38. data/lib/square_connect/models/catalog_item_variation.rb +1 -1
  39. data/lib/square_connect/models/catalog_object.rb +3 -3
  40. data/lib/square_connect/models/catalog_query.rb +2 -2
  41. data/lib/square_connect/models/catalog_tax.rb +1 -1
  42. data/lib/square_connect/models/catalog_v1_id.rb +2 -2
  43. data/lib/square_connect/models/create_checkout_request.rb +1 -1
  44. data/lib/square_connect/models/{create_order_request_order.rb → create_order_request.rb} +30 -6
  45. data/lib/square_connect/models/create_order_request_discount.rb +222 -0
  46. data/lib/square_connect/models/create_order_request_line_item.rb +31 -29
  47. data/lib/square_connect/models/create_order_request_tax.rb +255 -0
  48. data/lib/square_connect/models/error.rb +2 -2
  49. data/lib/square_connect/models/error_code.rb +1 -0
  50. data/lib/square_connect/models/item_variation_location_overrides.rb +5 -5
  51. data/lib/square_connect/models/order.rb +24 -14
  52. data/lib/square_connect/models/order_line_item.rb +46 -12
  53. data/lib/square_connect/models/order_line_item_discount.rb +281 -0
  54. data/lib/square_connect/models/order_line_item_discount_scope.rb +19 -0
  55. data/lib/square_connect/models/order_line_item_discount_type.rb +22 -0
  56. data/lib/square_connect/models/order_line_item_tax.rb +249 -0
  57. data/lib/square_connect/models/order_line_item_tax_type.rb +20 -0
  58. data/lib/square_connect/models/retrieve_catalog_object_request.rb +1 -1
  59. data/lib/square_connect/models/search_catalog_objects_request.rb +1 -1
  60. data/lib/square_connect/models/transaction.rb +2 -2
  61. data/lib/square_connect/version.rb +1 -1
  62. metadata +17 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 9bb1e68687abe1be0510709f4b331c13e53b9248
4
- data.tar.gz: da99adcd07f8124ad0f31fcfb3b92a71ebc7acb4
3
+ metadata.gz: 140134240931adbda11d86b180088dac5ee6311b
4
+ data.tar.gz: 5e5b72bd452c1db6d42186491c6a7e3baae2a3ab
5
5
  SHA512:
6
- metadata.gz: a92e8fc80a3154f1cedde275ede340b0c6cf4aa12e11b2fabd5f35d7c23b3f7bcace37a64779afd3a28e1c862c9e4cbd24a96d86f217343d07b366892d14e14e
7
- data.tar.gz: c820dbff99c8bdfc25c1159aa7f102ebab0d406b744671bb365edffafddf2f8bf661231c57b49dd403361bdee24f39fe52dce7b268adee7c1e6759186277e83a
6
+ metadata.gz: fa5a49a639d4e459a1c41f5821f7eed72fba37e7f67d39a125a6e68d9da661480ead976bd10685354c0335890052a07adf24970d837be1145f34d7ff4fd53a6a
7
+ data.tar.gz: 44ac429748a38aa469937c9eb48800af4ac25202ceb2eeb8b784ff5abe1a03bef4f3d5a6b11ea9351478065a7ff330142c9990d379b22b390196961872bf546e
data/README.md CHANGED
@@ -10,7 +10,7 @@ for the specification and template files we used to generate this.
10
10
  This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
11
11
 
12
12
  - API version: 2.0
13
- - Package version: 2.1.1
13
+ - Package version: 2.2.0
14
14
  - Build package: io.swagger.codegen.languages.RubyClientCodegen
15
15
 
16
16
  For more information, please visit [https://squareup.com/developers](https://squareup.com/developers)
@@ -228,8 +228,10 @@ Class | Method | HTTP request | Description
228
228
  - [SquareConnect::CreateCustomerCardResponse](docs/CreateCustomerCardResponse.md)
229
229
  - [SquareConnect::CreateCustomerRequest](docs/CreateCustomerRequest.md)
230
230
  - [SquareConnect::CreateCustomerResponse](docs/CreateCustomerResponse.md)
231
+ - [SquareConnect::CreateOrderRequest](docs/CreateOrderRequest.md)
232
+ - [SquareConnect::CreateOrderRequestDiscount](docs/CreateOrderRequestDiscount.md)
231
233
  - [SquareConnect::CreateOrderRequestLineItem](docs/CreateOrderRequestLineItem.md)
232
- - [SquareConnect::CreateOrderRequestOrder](docs/CreateOrderRequestOrder.md)
234
+ - [SquareConnect::CreateOrderRequestTax](docs/CreateOrderRequestTax.md)
233
235
  - [SquareConnect::CreateRefundRequest](docs/CreateRefundRequest.md)
234
236
  - [SquareConnect::CreateRefundResponse](docs/CreateRefundResponse.md)
235
237
  - [SquareConnect::Currency](docs/Currency.md)
@@ -263,6 +265,11 @@ Class | Method | HTTP request | Description
263
265
  - [SquareConnect::Money](docs/Money.md)
264
266
  - [SquareConnect::Order](docs/Order.md)
265
267
  - [SquareConnect::OrderLineItem](docs/OrderLineItem.md)
268
+ - [SquareConnect::OrderLineItemDiscount](docs/OrderLineItemDiscount.md)
269
+ - [SquareConnect::OrderLineItemDiscountScope](docs/OrderLineItemDiscountScope.md)
270
+ - [SquareConnect::OrderLineItemDiscountType](docs/OrderLineItemDiscountType.md)
271
+ - [SquareConnect::OrderLineItemTax](docs/OrderLineItemTax.md)
272
+ - [SquareConnect::OrderLineItemTaxType](docs/OrderLineItemTaxType.md)
266
273
  - [SquareConnect::Refund](docs/Refund.md)
267
274
  - [SquareConnect::RefundStatus](docs/RefundStatus.md)
268
275
  - [SquareConnect::RetrieveCatalogObjectRequest](docs/RetrieveCatalogObjectRequest.md)
@@ -352,8 +359,8 @@ Class | Method | HTTP request | Description
352
359
  - BANK_ACCOUNTS_READ: GET endpoints related to a merchant's bank accounts
353
360
  - ITEMS_READ: GET endpoints related to a merchant's item library
354
361
  - ITEMS_WRITE: POST, PUT, and DELETE endpoints related to a merchant's item library
355
- - ORDERS_READ: GET endpoints related to a merchant's Square online store.
356
- - ORDERS_WRITE: POST, PUT, and DELETE endpoints related to a merchant's Square online store
362
+ - ORDERS_READ: GET endpoints related to a merchant's orders
363
+ - ORDERS_WRITE: POST, PUT, and DELETE endpoints related to a merchant's orders
357
364
  - EMPLOYEES_READ: GET endpoints related to employee management
358
365
  - EMPLOYEES_WRITE: POST, PUT, and DELETE endpoints related to employee management
359
366
  - TIMECARDS_READ: GET endpoints related to employee timecards
@@ -14,5 +14,6 @@ Name | Type | Description | Notes
14
14
  **exp_year** | **Integer** | The four-digit year of the card's expiration date. | [optional]
15
15
  **cardholder_name** | **String** | The cardholder name. This value is present only if this object represents a customer's card on file. | [optional]
16
16
  **billing_address** | [**Address**](Address.md) | The card's billing address. This value is present only if this object represents a customer's card on file. | [optional]
17
+ **fingerprint** | **String** | The unique string fingerprint for the card. The fingerprint is based on the credit card number and is unique to the merchant. If a card is used at multiple locations for the same merchant, it will have the same fingerprint in each case. Note: Fingerprint may not exist on old transactions. | [optional]
17
18
 
18
19
 
@@ -74,7 +74,7 @@ Name | Type | Description | Notes
74
74
 
75
75
  BatchRetrieveCatalogObjects
76
76
 
77
- Returns a set of objects based on the provided ID. [CatalogItem](#type-catalogitem)s returned in the set include all of the child information including: all [CatalogItemVariation](#type-catalogitemvariation) objects, references to its [CatalogModifierList](#type-catalogmodifierlist) objects, and the ids of any [CatalogTax](#type-catalogtax) objects that apply to it.
77
+ Returns a set of objects based on the provided ID. Each [CatalogItem](#type-catalogitem) 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.
78
78
 
79
79
  ### Example
80
80
  ```ruby
@@ -348,7 +348,7 @@ api_instance = SquareConnect::CatalogApi.new
348
348
  object_id = "object_id_example" # String | The object ID of any type of [CatalogObject](#type-catalogobject)s to be retrieved.
349
349
 
350
350
  opts = {
351
- include_related_objects: 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.
351
+ include_related_objects: 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`
352
352
  }
353
353
 
354
354
  begin
@@ -365,7 +365,7 @@ end
365
365
  Name | Type | Description | Notes
366
366
  ------------- | ------------- | ------------- | -------------
367
367
  **object_id** | **String**| The object ID of any type of [CatalogObject](#type-catalogobject)s to be retrieved. |
368
- **include_related_objects** | **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. | [optional]
368
+ **include_related_objects** | **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]
369
369
 
370
370
  ### Return type
371
371
 
@@ -387,7 +387,7 @@ Name | Type | Description | Notes
387
387
 
388
388
  SearchCatalogObjects
389
389
 
390
- Queries the targeted catalog using a variety of query types ([CatalogQuerySortedAttribute](#type-catalogquerysortedattribute), ([CatalogQueryExact](#type-catalogqueryexact, ([CatalogQueryRange](#type-catalogqueryrange), ([CatalogQueryText](#type-catalogquerytext), ([CatalogQueryItemsForTax](#type-catalogqueryitemsfortax), ([CatalogQueryItemsForModifierList](#type-catalogqueryitemsformodifierlist)).
390
+ Queries the targeted catalog using a variety of query types ([CatalogQuerySortedAttribute](#type-catalogquerysortedattribute), ([CatalogQueryExact](#type-catalogqueryexact), ([CatalogQueryRange](#type-catalogqueryrange), ([CatalogQueryText](#type-catalogquerytext), ([CatalogQueryItemsForTax](#type-catalogqueryitemsfortax), ([CatalogQueryItemsForModifierList](#type-catalogqueryitemsformodifierlist)).
391
391
 
392
392
  ### Example
393
393
  ```ruby
@@ -10,7 +10,7 @@ Name | Type | Description | Notes
10
10
  **name** | **String** | The item's name. Searchable. |
11
11
  **description** | **String** | The item's description. Searchable. | [optional]
12
12
  **abbreviation** | **String** | The text of the item's display label in the Square Point of Sale app. Only up to the first five characters of the string are used. Searchable. | [optional]
13
- **label_color** | **String** | The color of the item's display label in the Square Point of Sale app. Searchable. | [optional]
13
+ **label_color** | **String** | The color of the item's display label in the Square Point of Sale app. | [optional]
14
14
  **available_online** | **BOOLEAN** | If `true`, the item can be added to shipping orders from the merchant's online store. | [optional]
15
15
  **available_for_pickup** | **BOOLEAN** | If `true`, the item can be added to pickup orders from the merchant's online store. | [optional]
16
16
  **available_electronically** | **BOOLEAN** | If `true`, the item can be added to electronically fulfilled orders from the merchant's online store. | [optional]
@@ -2,7 +2,7 @@
2
2
 
3
3
  ### Description
4
4
 
5
- The type of a [CatalogItem](#type-catalogitem).
5
+ The type of a [CatalogItem](#type-catalogitem). Connect V2 only allows the creation of `REGULAR` items.
6
6
 
7
7
  ## Properties
8
8
  Name | Type
@@ -13,7 +13,7 @@ Name | Type | Description | Notes
13
13
  **upc** | **String** | The item variation's UPC, if any. Searchable. | [optional]
14
14
  **pricing_type** | **String** | Indicates whether the item variation's price is fixed or determined at the time of sale. See [CatalogPricingType](#type-catalogpricingtype) for all possible values. | [optional]
15
15
  **price_money** | [**Money**](Money.md) | The item variation's price, if fixed pricing is used. | [optional]
16
- **location_overrides** | [**Array<ItemVariationLocationOverrides>**](ItemVariationLocationOverrides.md) | Per-location price and inventory overrides. | [optional]
16
+ **location_overrides** | [**Array<ItemVariationLocationOverrides>**](ItemVariationLocationOverrides.md) | Per-[location][#type-location] price and inventory overrides. | [optional]
17
17
  **track_inventory** | **BOOLEAN** | If `true`, inventory tracking is active for the variation. | [optional]
18
18
  **inventory_alert_type** | **String** | Indicates whether the item variation displays an alert when its inventory quantity is less than or equal to its `inventory_alert_threshold`. See [InventoryAlertType](#type-inventoryalerttype) for all possible values. | [optional]
19
19
  **inventory_alert_threshold** | **Integer** | 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]
@@ -8,11 +8,11 @@ The wrapper object for object types in the Catalog data model. The type of a par
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
10
  **type** | **String** | The type of this object. Each object type has expected properties expressed in a structured format within its corresponding `*_data` field below. See [CatalogObjectType](#type-catalogobjecttype) for all possible values. |
11
- **id** | **String** | A unique Square-assigned identifier to reference this object in the catalog. |
11
+ **id** | **String** | An identifier to reference this object in the catalog. When a new CatalogObject is inserted, the client should set the id to a temporary identifier starting with a `'#'` character. Other objects being inserted or updated within the same request may use this identifier to refer to the new object. When the server receives the new object, it will supply a unique identifier that replaces the temporary identifier for all future references. |
12
12
  **updated_at** | **String** | Last modification [timestamp](#workingwithdates) in RFC 3339 format, e.g., `\"2016-08-15T23:59:33.123Z\"` would indicate the UTC time (denoted by `Z`) of August 15, 2016 at 23:59:33 and 123 milliseconds. | [optional]
13
13
  **version** | **Integer** | The version of the object. When updating an object, the version supplied by the must match the version in the database, otherwise the write will be rejected as conflicting. | [optional]
14
- **is_deleted** | **BOOLEAN** | If `true`, the object has been deleted from the database. Must be `false` for new objects being inserted. When deleted, the `updated_at` field will equal the deletion time. being inserted. When deleted, the `updated_at` field will equal the deletion time. | [optional]
15
- **catalog_v1_ids** | [**Array<CatalogV1Id>**](CatalogV1Id.md) | The Connect V1 IDs for this object at each location where it is present, where they differ from the object's Connect V2 ID. The field will only be present for objects that have been created or modified by legacy APIs. | [optional]
14
+ **is_deleted** | **BOOLEAN** | If `true`, the object has been deleted from the database. Must be `false` for new objects being inserted. When deleted, the `updated_at` field will equal the deletion time. | [optional]
15
+ **catalog_v1_ids** | [**Array<CatalogV1Id>**](CatalogV1Id.md) | The Connect V1 IDs for this object at each [location][#type-location] where it is present, where they differ from the object's Connect V2 ID. The field will only be present for objects that have been created or modified by legacy APIs. | [optional]
16
16
  **present_at_all_locations** | **BOOLEAN** | If `true`, this object is present at all locations (including future locations), except where specified in the `absent_at_location_ids` field. If `false`, this object is not present at any locations (including future locations), except where specified in the `present_at_location_ids` field. | [optional]
17
17
  **present_at_location_ids** | **Array<String>** | A list of locations where the object is present, even if `present_at_all_locations` is `false`. | [optional]
18
18
  **absent_at_location_ids** | **Array<String>** | A list of locations where the object is not present, even if `present_at_all_locations` is `true`. | [optional]
@@ -2,7 +2,7 @@
2
2
 
3
3
  ### Description
4
4
 
5
- A query to be applied to a [SearchCatalogObjectsRequest](#type-searchcatalogobjectsrequest) request. Only one query field may be present. Where an attribute name is required, it should be specified as the name of any field marked \"searchable\" from the structured data types for the desired result object type(s) ([CatalogItem](#type-catalogitem), [CatalogItemVariation](#type-catalogitemvariation), [CatalogCategory](#type-catalogcategory), [CatalogTax](#type-catalogtax), [CatalogDiscount](#type-catalogdiscount), [CatalogModifierList](#type-catalogmodifierlist), or [CatalogModifier](#type-catalogmodifier)). For example, a query that should return Items may specify an attribute names from any of the searchable fields of the [CatalogItem](#type-catalogitem) data type, namely `\"name\"`, `\"description\"`, and `\"abbreviation\"`.
5
+ A query to be applied to a [SearchCatalogObjectsRequest](#type-searchcatalogobjectsrequest). Only one query field may be present. Where an attribute name is required, it should be specified as the name of any field marked \"searchable\" from the structured data types for the desired result object type(s) ([CatalogItem](#type-catalogitem), [CatalogItemVariation](#type-catalogitemvariation), [CatalogCategory](#type-catalogcategory), [CatalogTax](#type-catalogtax), [CatalogDiscount](#type-catalogdiscount), [CatalogModifierList](#type-catalogmodifierlist), [CatalogModifier](#type-catalogmodifier)). For example, a query that should return Items may specify attribute names from any of the searchable fields of the [CatalogItem](#type-catalogitem) data type, namely `\"name\"`, `\"description\"`, and `\"abbreviation\"`.
6
6
 
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
@@ -11,7 +11,7 @@ Name | Type | Description | Notes
11
11
  **exact_query** | [**CatalogQueryExact**](CatalogQueryExact.md) | A query that returns only objects for which the given (string-valued) attribute has the given case-insensitive value. | [optional]
12
12
  **prefix_query** | [**CatalogQueryPrefix**](CatalogQueryPrefix.md) | A query that returns only objects for which the given (string-valued) attribute has the given case-insensitive prefix. | [optional]
13
13
  **range_query** | [**CatalogQueryRange**](CatalogQueryRange.md) | A query that returns only objects for which the given (integer-valued) attribute lies in the given range. | [optional]
14
- **text_query** | [**CatalogQueryText**](CatalogQueryText.md) | A query that returns only objects whose searchable attributes contain all of the given keywords as prefixes. For example, if a [CatalogItem](#type-catalogitem) contains attributes `{\"name\": \"t-shirt\"}` and `{\"description\": \"Small, Red\"}`, it will be matched by the query `{\"keywords\": [\"shirt\", \"sm\", \"re\"]}`. | [optional]
14
+ **text_query** | [**CatalogQueryText**](CatalogQueryText.md) | A query that returns only objects whose searchable attributes contain all of the given keywords as prefixes. For example, if a [CatalogItem](#type-catalogitem) contains attributes `{\"name\": \"t-shirt\"}` and `{\"description\": \"Small, Purple\"}`, it will be matched by the query `{\"keywords\": [\"shirt\", \"sma\", \"purp\"]}`. | [optional]
15
15
  **items_for_tax_query** | [**CatalogQueryItemsForTax**](CatalogQueryItemsForTax.md) | A query that returns all [CatalogItem](#type-catalogitem)s that have any of the given [CatalogTax](#type-catalogtax)es enabled. | [optional]
16
16
  **items_for_modifier_list_query** | [**CatalogQueryItemsForModifierList**](CatalogQueryItemsForModifierList.md) | A query that returns all [CatalogItem](#type-catalogitem)s that have any of the given [CatalogModifierList](#type-catalogmodifierlist)s enabled. | [optional]
17
17
 
@@ -10,7 +10,7 @@ Name | Type | Description | Notes
10
10
  **name** | **String** | The tax's name. Searchable. |
11
11
  **calculation_phase** | **String** | Whether the tax is calculated based on a payment's subtotal or total. See [TaxCalculationPhase](#type-taxcalculationphase) for all possible values. | [optional]
12
12
  **inclusion_type** | **String** | Whether the tax is `ADDITIVE` or `INCLUSIVE`. See [TaxInclusionType](#type-taxinclusiontype) for all possible values. | [optional]
13
- **percentage** | **String** | The percentage of the tax in decimal form, using a '.' as the decimal separator and without a '%' sign. A value of `7.5` corresponds to 7.5%. | [optional]
13
+ **percentage** | **String** | The percentage of the tax in decimal form, using a `'.'` as the decimal separator and without a `'%'` sign. A value of `7.5` corresponds to 7.5%. | [optional]
14
14
  **applies_to_custom_amounts** | **BOOLEAN** | If `true`, the fee applies to custom amounts entered into the Square Point of Sale app that are not associated with a particular [CatalogItem](#type-catalogitem). | [optional]
15
15
  **enabled** | **BOOLEAN** | If `true`, the tax will be shown as enabled in the Square Point of Sale app. | [optional]
16
16
 
@@ -2,12 +2,12 @@
2
2
 
3
3
  ### Description
4
4
 
5
- An Items Connect V1 object ID along with its associated location ID.
5
+ An Items Connect V1 object ID along with its associated [location][#type-location] ID.
6
6
 
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
10
  **catalog_v1_id** | **String** | The ID for an object in Connect V1, if different from its Connect V2 ID. | [optional]
11
- **location_id** | **String** | The ID of the location this Connect V1 ID is associated with. | [optional]
11
+ **location_id** | **String** | The ID of the [location][#type-location] this Connect V1 ID is associated with. | [optional]
12
12
 
13
13
 
@@ -8,7 +8,7 @@ Defines the parameters that can be included in the body of a request to the [Cre
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
10
  **idempotency_key** | **String** | A unique string that identifies this checkout among others you've created. It can be any valid string but must be unique for every order sent to Square Checkout for a given location ID. The idempotency key is used to avoid processing the same order more than once. If you're unsure whether a particular checkout was created successfully, you can reattempt it with the same idempotency key and all the same other parameters without worrying about creating duplicates. We recommend using a random number/string generator native to the language you are working in to generate strings for your idempotency keys. See [Idempotency keys](#idempotencykeys) for more information. |
11
- **order** | [**CreateOrderRequestOrder**](CreateOrderRequestOrder.md) | The order including line items to be checked out. |
11
+ **order** | [**CreateOrderRequest**](CreateOrderRequest.md) | The order including line items to be checked out. |
12
12
  **ask_for_shipping_address** | **BOOLEAN** | If `true`, Square Checkout will collect shipping information on your behalf and store that information with the transaction information in your Square Dashboard. Default: `false`. | [optional]
13
13
  **merchant_support_email** | **String** | The email address to display on the Square Checkout confirmation page and confirmation email that the buyer can use to contact the merchant. If this value is not set, the confirmation page and email will display the primary email address associated with the merchant's Square account. Default: none; only exists if explicitly set. | [optional]
14
14
  **pre_populate_buyer_email** | **String** | If provided, the buyer's email is pre-populated on the checkout page as an editable text field. Default: none; only exists if explicitly set. | [optional]
@@ -1,13 +1,15 @@
1
- # SquareConnect::CreateOrderRequestOrder
1
+ # SquareConnect::CreateOrderRequest
2
2
 
3
3
  ### Description
4
4
 
5
- The object describes the order.
5
+ Defines the parameters that can be included in the body of a request to the [CreateCheckout](#endpoint-createcheckout) endpoint.
6
6
 
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
10
  **reference_id** | **String** | 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]
11
11
  **line_items** | [**Array<CreateOrderRequestLineItem>**](CreateOrderRequestLineItem.md) | The line items to associate with this order. Each line item represents a different product (or a custom monetary amount) to include in a purchase. |
12
+ **taxes** | [**Array<CreateOrderRequestTax>**](CreateOrderRequestTax.md) | The taxes include the custom taxes. | [optional]
13
+ **discounts** | [**Array<CreateOrderRequestDiscount>**](CreateOrderRequestDiscount.md) | The discounts include the custom discounts . | [optional]
12
14
 
13
15
 
@@ -0,0 +1,14 @@
1
+ # SquareConnect::CreateOrderRequestDiscount
2
+
3
+ ### Description
4
+
5
+ Represents a discount that to either a single line item or an entire order.
6
+
7
+ ## Properties
8
+ Name | Type | Description | Notes
9
+ ------------ | ------------- | ------------- | -------------
10
+ **name** | **String** | The discount's name. | [optional]
11
+ **percentage** | **String** | The percentage of the discount, 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]
12
+ **amount_money** | [**Money**](Money.md) | The monetary amount of the discount. | [optional]
13
+
14
+
@@ -7,8 +7,10 @@ Represents a line item to include in an order. Each line item describes a differ
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
- **name** | **String** | The name of the line item. This value cannot exceed 500 characters. |
10
+ **name** | **String** | The name of the line item. This value cannot exceed 500 characters. | [optional]
11
11
  **quantity** | **String** | The quantity to purchase, as a string representation of a number. Currently, only integer values are supported. |
12
- **base_price_money** | [**Money**](Money.md) | The base price for a single unit of the line item's associated variation. If a line item represents a Custom Amount instead of a particular product, this field indicates that amount. |
12
+ **base_price_money** | [**Money**](Money.md) | The base price for a single unit of the line item's associated variation. If a line item represents a Custom Amount instead of a particular product, this field indicates that amount. | [optional]
13
+ **taxes** | [**Array<CreateOrderRequestTax>**](CreateOrderRequestTax.md) | The taxes include the custom taxes. | [optional]
14
+ **discounts** | [**Array<CreateOrderRequestDiscount>**](CreateOrderRequestDiscount.md) | The discounts include the custom discounts. | [optional]
13
15
 
14
16
 
@@ -0,0 +1,14 @@
1
+ # SquareConnect::CreateOrderRequestTax
2
+
3
+ ### Description
4
+
5
+ Represents a tax that applies to either a single line item or an entire order.
6
+
7
+ ## Properties
8
+ Name | Type | Description | Notes
9
+ ------------ | ------------- | ------------- | -------------
10
+ **name** | **String** | The tax's name. | [optional]
11
+ **type** | **String** | Indicates the calculation method used to apply the line item tax. Default: `ADDITIVE`; See [OrderLineItemTaxType](#type-orderlineitemtaxtype) for possible values. | [optional]
12
+ **percentage** | **String** | 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]
13
+
14
+
@@ -70,7 +70,7 @@ Name | Type | Description | Notes
70
70
 
71
71
  CreateCustomerCard
72
72
 
73
- Adds a card on file to an existing customer.
73
+ Adds a card on file to an existing customer. In the United States Square takes care of automatically updating any cards on file that might have expired since you first attached them to a customer.
74
74
 
75
75
  ### Example
76
76
  ```ruby
@@ -337,7 +337,7 @@ Name | Type | Description | Notes
337
337
 
338
338
  UpdateCustomer
339
339
 
340
- Updates the details of an existing customer. You cannot edit a customer's cards on file with this endpoint. To make changes to a card on file, you must delete the existing card on file with the [DeleteCustomerCard](#endpoint-deletecustomercard) endpoint, then create a new one with the [CreateCustomerCard](#endpoint-createcustomercard) endpoint.
340
+ Updates the details of an existing customer. The ID of the customer may change if the customer has been merged into another customer. You cannot edit a customer's cards on file with this endpoint. To make changes to a card on file, you must delete the existing card on file with the [DeleteCustomerCard](#endpoint-deletecustomercard) endpoint, then create a new one with the [CreateCustomerCard](#endpoint-createcustomercard) endpoint.
341
341
 
342
342
  ### Example
343
343
  ```ruby
@@ -70,6 +70,7 @@ Name | Type
70
70
  **UNEXPECTED_VALUE** | string
71
71
  **SANDBOX_NOT_SUPPORTED** | string
72
72
  **INVALID_EMAIL_ADDRESS** | string
73
+ **CHECKOUT_EXPIRED** | string
73
74
  **CARD_DECLINED** | string
74
75
  **VERIFY_CVV_FAILURE** | string
75
76
  **VERIFY_AVS_FAILURE** | string
@@ -2,15 +2,15 @@
2
2
 
3
3
  ### Description
4
4
 
5
- Price and inventory overrides for a [CatalogItemVariation](#type-catalogitemvariation) at a specific location.
5
+ Price and inventory alerting overrides for a [CatalogItemVariation](#type-catalogitemvariation) at a specific [location][#type-location].
6
6
 
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
- **location_id** | **String** | The ID of the location. | [optional]
11
- **price_money** | [**Money**](Money.md) | The price of the [CatalogItemVariation](#type-catalogitemvariation) at the given location, or blank for variable pricing. | [optional]
12
- **pricing_type** | **String** | The pricing type (fixed or variable) for the [CatalogItemVariation](#type-catalogitemvariation) at the given location. See [CatalogPricingType](#type-catalogpricingtype) for all possible values. | [optional]
13
- **track_inventory** | **BOOLEAN** | If `true`, inventory tracking is active for the [CatalogItemVariation](#type-catalogitemvariation) at this location. | [optional]
10
+ **location_id** | **String** | The ID of the [location][#type-location]. | [optional]
11
+ **price_money** | [**Money**](Money.md) | The price of the [CatalogItemVariation](#type-catalogitemvariation) at the given [location][#type-location], or blank for variable pricing. | [optional]
12
+ **pricing_type** | **String** | The pricing type (fixed or variable) for the [CatalogItemVariation](#type-catalogitemvariation) at the given [location][#type-location]. See [CatalogPricingType](#type-catalogpricingtype) for all possible values. | [optional]
13
+ **track_inventory** | **BOOLEAN** | If `true`, inventory tracking is active for the [CatalogItemVariation](#type-catalogitemvariation) at this [location][#type-location]. | [optional]
14
14
  **inventory_alert_type** | **String** | Indicates whether the [CatalogItemVariation](#type-catalogitemvariation) displays an alert when its inventory quantity is less than or equal to its `inventory_alert_threshold`. See [InventoryAlertType](#type-inventoryalerttype) for all possible values. | [optional]
15
15
  **inventory_alert_threshold** | **Integer** | 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]
16
16
 
@@ -7,10 +7,11 @@ Contains all information related to a single order to process with Square, inclu
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
- **id** | **String** | The order's unique ID. This value is not present if the order was not created with the [CreateOrder](#endpoint-createorder) endpoint. | [optional]
11
10
  **location_id** | **String** | The ID of the merchant location this order is associated with. | [optional]
12
11
  **reference_id** | **String** | A client specified identifier to associate an entity in another system with this order. | [optional]
13
12
  **line_items** | [**Array<OrderLineItem>**](OrderLineItem.md) | The line items included in the order. Every order has at least one line item. | [optional]
14
13
  **total_money** | [**Money**](Money.md) | The total amount of money to collect for the order. | [optional]
14
+ **total_tax_money** | [**Money**](Money.md) | The total tax amount of money to collect for the order. | [optional]
15
+ **total_discount_money** | [**Money**](Money.md) | The total discount amount of money to collect for the order. | [optional]
15
16
 
16
17
 
@@ -7,10 +7,13 @@ Represents a line item in an order. Each line item describes a different product
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
- **id** | **String** | The line item's ID, unique only within this order. | [optional]
11
10
  **name** | **String** | The name of the line item. | [optional]
12
11
  **quantity** | **String** | The quantity of the product to purchase. Currently, this string must have an integer value. | [optional]
13
- **base_price_money** | [**Money**](Money.md) | The base price for a single unit of the line item's associated variation. If a line item represents a Custom Amount instead of a particular product, this field indicates that amount. | [optional]
12
+ **taxes** | [**Array<OrderLineItemTax>**](OrderLineItemTax.md) | The taxes applied to this line item. | [optional]
13
+ **discounts** | [**Array<OrderLineItemDiscount>**](OrderLineItemDiscount.md) | The discounts applied to this line item. | [optional]
14
+ **base_price_money** | [**Money**](Money.md) | The base price for a single unit of the line item. | [optional]
15
+ **total_tax_money** | [**Money**](Money.md) | The total tax amount of money to collect for the line item. | [optional]
16
+ **total_discount_money** | [**Money**](Money.md) | The total discount amount of money to collect for the line item. | [optional]
14
17
  **total_money** | [**Money**](Money.md) | The total amount of money to collect for this line item. | [optional]
15
18
 
16
19
 
@@ -0,0 +1,17 @@
1
+ # SquareConnect::OrderLineItemDiscount
2
+
3
+ ### Description
4
+
5
+ Represents a discount that applies to one or more line items in an order. Fixed-amount, order-level discounts are distributed across all non-zero line item totals. The amount distributed to each line item is relative to that item’s contribution to the order subtotal.
6
+
7
+ ## Properties
8
+ Name | Type | Description | Notes
9
+ ------------ | ------------- | ------------- | -------------
10
+ **name** | **String** | The discount's name. | [optional]
11
+ **type** | **String** | The type of the discount. If it is created by API, it would be either `FIXED_PERCENTAGE` or `FIXED_AMOUNT`. VARIABLE_* is not supported in API because the order is created at the time of sale and either percentage or amount has to be specified. See [OrderLineItemDiscountType](#type-orderlineitemdiscounttype) for possible values. | [optional]
12
+ **percentage** | **String** | 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%. The percentage won't be set for an amount-based discount. | [optional]
13
+ **amount_money** | [**Money**](Money.md) | The total monetary amount of the applicable discount. If it is at order level, it is the value of the order level discount. If it is at line item level, it is the value of the line item level discount. The amount_money won't be set for a percentage-based discount. | [optional]
14
+ **applied_money** | [**Money**](Money.md) | The amount of discount actually applied to this line item. Represents the amount of money applied to a line item as a discount When an amount-based discount is at order-level, this value is different from `amount_money` because the discount is distributed across the line items. | [optional]
15
+ **scope** | **String** | Indicates the level at which the discount applies. See [OrderLineItemDiscountScope](#type-orderlineitemdiscountscope) for possible values. | [optional]
16
+
17
+
@@ -0,0 +1,13 @@
1
+ # SquareConnect::OrderLineItemDiscountScope
2
+
3
+ ### Description
4
+
5
+ Indicates whether this is a line item or order-level discount.
6
+
7
+ ## Properties
8
+ Name | Type
9
+ ------------ | -------------
10
+ **LINE_ITEM** | string
11
+ **ORDER** | string
12
+
13
+
@@ -0,0 +1,16 @@
1
+ # SquareConnect::OrderLineItemDiscountType
2
+
3
+ ### Description
4
+
5
+ Indicates how the discount is applied to the associated line item or order.
6
+
7
+ ## Properties
8
+ Name | Type
9
+ ------------ | -------------
10
+ **UNKNOWN** | string
11
+ **FIXED_PERCENTAGE** | string
12
+ **FIXED_AMOUNT** | string
13
+ **VARIABLE_PERCENTAGE** | string
14
+ **VARIABLE_AMOUNT** | string
15
+
16
+
@@ -0,0 +1,15 @@
1
+ # SquareConnect::OrderLineItemTax
2
+
3
+ ### Description
4
+
5
+ Represents a tax that applies to one or more line items in an order.
6
+
7
+ ## Properties
8
+ Name | Type | Description | Notes
9
+ ------------ | ------------- | ------------- | -------------
10
+ **name** | **String** | The tax's name. | [optional]
11
+ **type** | **String** | Indicates the calculation method used to apply the tax. See [OrderLineItemTaxType](#type-orderlineitemtaxtype) for possible values. | [optional]
12
+ **percentage** | **String** | 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%. | [optional]
13
+ **applied_money** | [**Money**](Money.md) | The amount of the money applied by the tax in an order. | [optional]
14
+
15
+
@@ -0,0 +1,14 @@
1
+ # SquareConnect::OrderLineItemTaxType
2
+
3
+ ### Description
4
+
5
+ Indicates how the tax is applied to the associated line item or order.
6
+
7
+ ## Properties
8
+ Name | Type
9
+ ------------ | -------------
10
+ **UNKNOWN** | string
11
+ **ADDITIVE** | string
12
+ **INCLUSIVE** | string
13
+
14
+
@@ -7,6 +7,6 @@
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
9
9
  ------------ | ------------- | ------------- | -------------
10
- **include_related_objects** | **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. | [optional]
10
+ **include_related_objects** | **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]
11
11
 
12
12
 
@@ -11,7 +11,7 @@ Name | Type | Description | Notes
11
11
  **object_types** | **Array<String>** | The desired set of object types to apper in the search results. The legal values are taken from the [CatalogObjectType](#type-catalogobjecttype) enumeration, namely `\"ITEM\"`, `\"ITEM_VARIATION\"`, `\"CATEGORY\"`, `\"DISCOUNT\"`, `\"TAX\"`, `\"MODIFIER\"`, or `\"MODIFIER_LIST\"`. | [optional]
12
12
  **include_deleted_objects** | **BOOLEAN** | If `true`, deleted objects will be included in the results. Deleted objects will have their `is_deleted` field set to `true`. | [optional]
13
13
  **include_related_objects** | **BOOLEAN** | If `true`, the response will include additional objects that are related to the requested object, as follows: If a [CatalogItem](#type-catalogitem) is returned in the object field of the response, its associated [CatalogCategory](#type-catalogcategory), [CatalogTax](#type-catalogtax)es, and [CatalogModifierList](#type-catalogmodifierlist)s will be included in the `related_objects` field of the response. If a [CatalogItemVariation](#type-catalogitemvariation) is returned in the object field of the response, its parent [CatalogItem](#type-catalogitem) will be included in the `related_objects` field of the response. | [optional]
14
- **begin_time** | **String** | Return only objects that have been modified after this [timestamp](#workingwithdates) (in RFC 3339 format, e.g., \"2016-09-04T23:59:33.123Z\"). | [optional]
14
+ **begin_time** | **String** | Return only objects that have been modified after this [timestamp](#workingwithdates) (in RFC 3339 format, e.g., \"2016-09-04T23:59:33.123Z\"). The timestamp is exclusive - objects whose timestamp is equal to `begin_time` will not be included in the response. | [optional]
15
15
  **query** | [**CatalogQuery**](CatalogQuery.md) | A query to be used to filter or sort the results. If no query is specified, the entire catalog will be returned. | [optional]
16
16
  **limit** | **Integer** | A limit on the number of results to be returned in a single page. The limit is advisory - the implementation may return more or fewer results. If the supplied limit is negative, zero, or is higher than the maximum limit of 1,000, it will be ignored. | [optional]
17
17
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  ### Description
4
4
 
5
- Represents a transaction processed with Square, either with the Connect API or with Square Register. The `tenders` field of this object lists all methods of payment used to pay in the transaction.
5
+ Represents a transaction processed with Square, either with the Connect API or with Square Point of Sale. The `tenders` field of this object lists all methods of payment used to pay in the transaction.
6
6
 
7
7
  ## Properties
8
8
  Name | Type | Description | Notes
@@ -14,7 +14,7 @@ Name | Type | Description | Notes
14
14
  **refunds** | [**Array<Refund>**](Refund.md) | Refunds that have been applied to any tender in the transaction. | [optional]
15
15
  **reference_id** | **String** | If the transaction was created with the [Charge](#endpoint-charge) endpoint, this value is the same as the value provided for the `reference_id` parameter in the request to that endpoint. Otherwise, it is not set. | [optional]
16
16
  **product** | **String** | The Square product that processed the transaction. | [optional]
17
- **client_id** | **String** | If the transaction was created in the Square Register app, this value is the ID generated for the transaction by Square Register. This ID has no relationship to the transaction's canonical `id`, which is generated by Square's backend servers. This value is generated for bookkeeping purposes, in case the transaction cannot immediately be completed (for example, if the transaction is processed in offline mode). It is not currently possible with the Connect API to perform a transaction lookup by this value. | [optional]
17
+ **client_id** | **String** | If the transaction was created in the Square Point of Sale app, this value is the ID generated for the transaction by Square Point of Sale. This ID has no relationship to the transaction's canonical `id`, which is generated by Square's backend servers. This value is generated for bookkeeping purposes, in case the transaction cannot immediately be completed (for example, if the transaction is processed in offline mode). It is not currently possible with the Connect API to perform a transaction lookup by this value. | [optional]
18
18
  **order** | [**Order**](Order.md) | The order associated with this transaction, if any. | [optional]
19
19
  **shipping_address** | [**Address**](Address.md) | The shipping address provided in the request, if any. | [optional]
20
20