square_connect 2.0.2.69 → 2.1.0.beta
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +133 -21
- data/docs/ChargeRequest.md +1 -1
- data/docs/CheckoutApi.md +8 -6
- data/docs/CustomersApi.md +389 -0
- data/docs/Device.md +11 -0
- data/docs/LocationsApi.md +55 -0
- data/docs/TransactionsApi.md +417 -0
- data/docs/V1AdjustInventoryRequest.md +12 -0
- data/docs/V1BankAccount.md +17 -0
- data/docs/V1CashDrawerEvent.md +15 -0
- data/docs/V1CashDrawerShift.md +28 -0
- data/docs/V1Category.md +11 -0
- data/docs/V1CreateRefundRequest.md +14 -0
- data/docs/V1Discount.md +16 -0
- data/docs/V1Employee.md +21 -0
- data/docs/V1EmployeeRole.md +15 -0
- data/docs/V1EmployeesApi.md +915 -0
- data/docs/V1Fee.md +18 -0
- data/docs/V1InventoryEntry.md +11 -0
- data/docs/V1Item.md +23 -0
- data/docs/V1ItemImage.md +11 -0
- data/docs/V1ItemsApi.md +2297 -0
- data/docs/V1LocationApi.md +102 -0
- data/docs/V1LocationsApi.md +102 -0
- data/docs/V1Merchant.md +26 -0
- data/docs/V1MerchantLocationDetails.md +12 -0
- data/docs/V1ModifierList.md +13 -0
- data/docs/V1ModifierOption.md +15 -0
- data/docs/V1Money.md +13 -0
- data/docs/V1Order.md +34 -0
- data/docs/V1OrderHistoryEntry.md +11 -0
- data/docs/V1Page.md +13 -0
- data/docs/V1PageCell.md +15 -0
- data/docs/V1Payment.md +33 -0
- data/docs/V1PaymentDiscount.md +12 -0
- data/docs/V1PaymentItemDetail.md +13 -0
- data/docs/V1PaymentItemization.md +23 -0
- data/docs/V1PaymentModifier.md +12 -0
- data/docs/V1PaymentTax.md +15 -0
- data/docs/V1PhoneNumber.md +13 -0
- data/docs/V1Refund.md +16 -0
- data/docs/V1Settlement.md +15 -0
- data/docs/V1SettlementEntry.md +13 -0
- data/docs/V1Tender.md +22 -0
- data/docs/V1Timecard.md +20 -0
- data/docs/V1TimecardEvent.md +14 -0
- data/docs/V1TransactionsApi.md +650 -0
- data/docs/V1UpdateModifierListRequest.md +11 -0
- data/docs/V1UpdateOrderRequest.md +14 -0
- data/docs/V1Variation.md +20 -0
- data/lib/.DS_Store +0 -0
- data/lib/square_connect.rb +46 -5
- data/lib/square_connect/.DS_Store +0 -0
- data/lib/square_connect/api/checkout_api.rb +4 -9
- data/lib/square_connect/api/{customer_api.rb → customers_api.rb} +150 -61
- data/lib/square_connect/api/{location_api.rb → locations_api.rb} +7 -12
- data/lib/square_connect/api/{transaction_api.rb → transactions_api.rb} +169 -65
- data/lib/square_connect/api/v1_employees_api.rb +974 -0
- data/lib/square_connect/api/v1_items_api.rb +2365 -0
- data/lib/square_connect/api/v1_locations_api.rb +118 -0
- data/lib/square_connect/api/v1_transactions_api.rb +707 -0
- data/lib/square_connect/api_client.rb +1 -1
- data/lib/square_connect/models/charge_request.rb +1 -1
- data/lib/square_connect/models/device.rb +196 -0
- data/lib/square_connect/models/v1_adjust_inventory_request.rb +206 -0
- data/lib/square_connect/models/v1_bank_account.rb +289 -0
- data/lib/square_connect/models/v1_cash_drawer_event.rb +269 -0
- data/lib/square_connect/models/v1_cash_drawer_shift.rb +403 -0
- data/lib/square_connect/models/v1_category.rb +196 -0
- data/lib/square_connect/models/v1_create_refund_request.rb +274 -0
- data/lib/square_connect/models/v1_discount.rb +291 -0
- data/lib/square_connect/models/v1_employee.rb +323 -0
- data/lib/square_connect/models/v1_employee_role.rb +269 -0
- data/lib/square_connect/models/v1_fee.rb +335 -0
- data/lib/square_connect/models/v1_inventory_entry.rb +196 -0
- data/lib/square_connect/models/v1_item.rb +379 -0
- data/lib/square_connect/models/v1_item_image.rb +196 -0
- data/lib/square_connect/models/v1_merchant.rb +372 -0
- data/lib/square_connect/models/v1_merchant_location_details.rb +186 -0
- data/lib/square_connect/models/v1_modifier_list.rb +251 -0
- data/lib/square_connect/models/v1_modifier_option.rb +236 -0
- data/lib/square_connect/models/v1_money.rb +229 -0
- data/lib/square_connect/models/v1_order.rb +463 -0
- data/lib/square_connect/models/v1_order_history_entry.rb +229 -0
- data/lib/square_connect/models/v1_page.rb +218 -0
- data/lib/square_connect/models/v1_page_cell.rb +261 -0
- data/lib/square_connect/models/v1_payment.rb +423 -0
- data/lib/square_connect/models/v1_payment_discount.rb +206 -0
- data/lib/square_connect/models/v1_payment_item_detail.rb +216 -0
- data/lib/square_connect/models/v1_payment_itemization.rb +355 -0
- data/lib/square_connect/models/v1_payment_modifier.rb +206 -0
- data/lib/square_connect/models/v1_payment_tax.rb +271 -0
- data/lib/square_connect/models/v1_phone_number.rb +206 -0
- data/lib/square_connect/models/v1_refund.rb +279 -0
- data/lib/square_connect/models/v1_settlement.rb +271 -0
- data/lib/square_connect/models/v1_settlement_entry.rb +249 -0
- data/lib/square_connect/models/v1_tender.rb +363 -0
- data/lib/square_connect/models/v1_timecard.rb +271 -0
- data/lib/square_connect/models/v1_timecard_event.rb +259 -0
- data/lib/square_connect/models/v1_update_modifier_list_request.rb +229 -0
- data/lib/square_connect/models/v1_update_order_request.rb +264 -0
- data/lib/square_connect/models/v1_variation.rb +331 -0
- data/lib/square_connect/version.rb +1 -1
- data/spec/.DS_Store +0 -0
- data/spec/api/checkout_api_spec.rb +4 -12
- data/spec/api/{customer_api_spec.rb → customers_api_spec.rb} +39 -41
- data/spec/api/{location_api_spec.rb → locations_api_spec.rb} +9 -15
- data/spec/api/{transaction_api_spec.rb → transactions_api_spec.rb} +43 -41
- data/spec/api/v1_employees_api_spec.rb +250 -0
- data/spec/api/v1_items_api_spec.rb +568 -0
- data/spec/api/v1_locations_api_spec.rb +54 -0
- data/spec/api/v1_transactions_api_spec.rb +186 -0
- data/spec/models/address_spec.rb +22 -81
- data/spec/models/capture_transaction_request_spec.rb +3 -6
- data/spec/models/capture_transaction_response_spec.rb +4 -11
- data/spec/models/card_brand_spec.rb +3 -6
- data/spec/models/card_spec.rb +14 -41
- data/spec/models/charge_request_spec.rb +14 -61
- data/spec/models/charge_response_spec.rb +5 -16
- data/spec/models/checkout_spec.rb +12 -51
- data/spec/models/country_spec.rb +3 -6
- data/spec/models/create_checkout_request_spec.rb +10 -41
- data/spec/models/create_checkout_response_spec.rb +5 -16
- data/spec/models/create_customer_card_request_spec.rb +6 -21
- data/spec/models/create_customer_card_response_spec.rb +5 -16
- data/spec/models/create_customer_request_spec.rb +12 -51
- data/spec/models/create_customer_response_spec.rb +5 -16
- data/spec/models/create_order_request_line_item_spec.rb +6 -21
- data/spec/models/create_order_request_order_spec.rb +5 -16
- data/spec/models/create_order_request_spec.rb +5 -16
- data/spec/models/create_refund_request_spec.rb +7 -26
- data/spec/models/create_refund_response_spec.rb +5 -16
- data/spec/models/currency_spec.rb +3 -6
- data/spec/models/customer_group_info_spec.rb +5 -16
- data/spec/models/customer_preferences_spec.rb +4 -11
- data/spec/models/customer_spec.rb +18 -81
- data/spec/models/delete_customer_card_request_spec.rb +3 -6
- data/spec/models/delete_customer_card_response_spec.rb +4 -11
- data/spec/models/delete_customer_request_spec.rb +3 -6
- data/spec/models/delete_customer_response_spec.rb +4 -11
- data/spec/models/device_spec.rb +45 -0
- data/spec/models/error_category_spec.rb +3 -6
- data/spec/models/error_code_spec.rb +3 -6
- data/spec/models/error_spec.rb +15 -26
- data/spec/models/list_customers_request_spec.rb +4 -11
- data/spec/models/list_customers_response_spec.rb +6 -21
- data/spec/models/list_locations_request_spec.rb +3 -6
- data/spec/models/list_locations_response_spec.rb +5 -16
- data/spec/models/list_refunds_request_spec.rb +11 -26
- data/spec/models/list_refunds_response_spec.rb +6 -21
- data/spec/models/list_transactions_request_spec.rb +11 -26
- data/spec/models/list_transactions_response_spec.rb +6 -21
- data/spec/models/location_capability_spec.rb +3 -6
- data/spec/models/location_spec.rb +12 -31
- data/spec/models/money_spec.rb +9 -16
- data/spec/models/order_line_item_spec.rb +8 -31
- data/spec/models/order_spec.rb +8 -31
- data/spec/models/refund_spec.rb +16 -51
- data/spec/models/refund_status_spec.rb +3 -6
- data/spec/models/retrieve_customer_request_spec.rb +3 -6
- data/spec/models/retrieve_customer_response_spec.rb +5 -16
- data/spec/models/retrieve_transaction_request_spec.rb +3 -6
- data/spec/models/retrieve_transaction_response_spec.rb +5 -16
- data/spec/models/sort_order_spec.rb +3 -6
- data/spec/models/tender_card_details_entry_method_spec.rb +3 -6
- data/spec/models/tender_card_details_spec.rb +14 -21
- data/spec/models/tender_card_details_status_spec.rb +3 -6
- data/spec/models/tender_cash_details_spec.rb +5 -16
- data/spec/models/tender_spec.rb +18 -61
- data/spec/models/tender_type_spec.rb +3 -6
- data/spec/models/transaction_product_spec.rb +3 -6
- data/spec/models/transaction_spec.rb +17 -56
- data/spec/models/update_customer_request_spec.rb +12 -51
- data/spec/models/update_customer_response_spec.rb +5 -16
- data/spec/models/v1_adjust_inventory_request_spec.rb +51 -0
- data/spec/models/v1_bank_account_spec.rb +85 -0
- data/spec/models/v1_cash_drawer_event_spec.rb +73 -0
- data/spec/models/v1_cash_drawer_shift_spec.rb +151 -0
- data/spec/models/v1_category_spec.rb +45 -0
- data/spec/models/v1_create_refund_request_spec.rb +67 -0
- data/spec/models/v1_discount_spec.rb +83 -0
- data/spec/models/v1_employee_role_spec.rb +73 -0
- data/spec/models/v1_employee_spec.rb +97 -0
- data/spec/models/v1_fee_spec.rb +103 -0
- data/spec/models/v1_inventory_entry_spec.rb +45 -0
- data/spec/models/v1_item_image_spec.rb +45 -0
- data/spec/models/v1_item_spec.rb +129 -0
- data/spec/models/v1_merchant_location_details_spec.rb +39 -0
- data/spec/models/v1_merchant_spec.rb +131 -0
- data/spec/models/v1_modifier_list_spec.rb +61 -0
- data/spec/models/v1_modifier_option_spec.rb +69 -0
- data/spec/models/v1_money_spec.rb +49 -0
- data/spec/models/v1_order_history_entry_spec.rb +49 -0
- data/spec/models/v1_order_spec.rb +187 -0
- data/spec/models/v1_page_cell_spec.rb +77 -0
- data/spec/models/v1_page_spec.rb +57 -0
- data/spec/models/v1_payment_discount_spec.rb +51 -0
- data/spec/models/v1_payment_item_detail_spec.rb +57 -0
- data/spec/models/v1_payment_itemization_spec.rb +121 -0
- data/spec/models/v1_payment_modifier_spec.rb +51 -0
- data/spec/models/v1_payment_spec.rb +177 -0
- data/spec/models/v1_payment_tax_spec.rb +73 -0
- data/spec/models/v1_phone_number_spec.rb +45 -0
- data/spec/models/v1_refund_spec.rb +79 -0
- data/spec/models/v1_settlement_entry_spec.rb +61 -0
- data/spec/models/v1_settlement_spec.rb +73 -0
- data/spec/models/v1_tender_spec.rb +123 -0
- data/spec/models/v1_timecard_event_spec.rb +67 -0
- data/spec/models/v1_timecard_spec.rb +87 -0
- data/spec/models/v1_update_modifier_list_request_spec.rb +49 -0
- data/spec/models/v1_update_order_request_spec.rb +67 -0
- data/spec/models/v1_variation_spec.rb +107 -0
- data/spec/models/void_transaction_request_spec.rb +3 -6
- data/spec/models/void_transaction_response_spec.rb +4 -11
- data/spec/spec_helper.rb +10 -0
- data/square_connect-2.0.2.gem +0 -0
- data/square_connect-2.1.0.gem +0 -0
- data/square_connect-2.1.0beta.gem +0 -0
- data/square_connect.gemspec +1 -1
- data/travis-ci/accounts.enc +0 -0
- metadata +197 -26
- data/docs/CustomerApi.md +0 -267
- data/docs/CustomerCardApi.md +0 -116
- data/docs/LocationApi.md +0 -56
- data/docs/RefundApi.md +0 -126
- data/docs/TransactionApi.md +0 -285
- data/lib/square_connect/api/customer_card_api.rb +0 -144
- data/lib/square_connect/api/refund_api.rb +0 -159
- data/spec/api/customer_card_api_spec.rb +0 -71
- data/spec/api/refund_api_spec.rb +0 -75
@@ -0,0 +1,12 @@
|
|
1
|
+
# SquareConnect::V1AdjustInventoryRequest
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
## Properties
|
6
|
+
Name | Type | Description | Notes
|
7
|
+
------------ | ------------- | ------------- | -------------
|
8
|
+
**quantity_delta** | **Float** | The number to adjust the variation's quantity by. | [optional]
|
9
|
+
**adjustment_type** | **Float** | The reason for the inventory adjustment. | [optional]
|
10
|
+
**memo** | **String** | A note about the inventory adjustment. | [optional]
|
11
|
+
|
12
|
+
|
@@ -0,0 +1,17 @@
|
|
1
|
+
# SquareConnect::V1BankAccount
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
## Properties
|
6
|
+
Name | Type | Description | Notes
|
7
|
+
------------ | ------------- | ------------- | -------------
|
8
|
+
**id** | **String** | The bank account's Square-issued ID. | [optional]
|
9
|
+
**merchant_id** | **String** | The Square-issued ID of the merchant associated with the bank account. | [optional]
|
10
|
+
**bank_name** | **String** | The name of the bank that manages the account. | [optional]
|
11
|
+
**name** | **String** | The name associated with the bank account. | [optional]
|
12
|
+
**routing_number** | **String** | The bank account's routing number. | [optional]
|
13
|
+
**account_number_suffix** | **String** | The last few digits of the bank account number. | [optional]
|
14
|
+
**currency_code** | **String** | The currency code of the currency associated with the bank account, in ISO 4217 format. For example, the currency code for US dollars is USD. | [optional]
|
15
|
+
**type** | **String** | The bank account's type (for example, savings or checking). | [optional]
|
16
|
+
|
17
|
+
|
@@ -0,0 +1,15 @@
|
|
1
|
+
# SquareConnect::V1CashDrawerEvent
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
## Properties
|
6
|
+
Name | Type | Description | Notes
|
7
|
+
------------ | ------------- | ------------- | -------------
|
8
|
+
**id** | **String** | The event's unique ID. | [optional]
|
9
|
+
**employee_id** | **String** | The ID of the employee that created the event. | [optional]
|
10
|
+
**event_type** | **String** | The type of event that occurred. | [optional]
|
11
|
+
**event_money** | [**V1Money**](V1Money.md) | The amount of money that was added to or removed from the cash drawer because of the event. This value can be positive (for added money) or negative (for removed money). | [optional]
|
12
|
+
**created_at** | **String** | The time when the event occurred, in ISO 8601 format. | [optional]
|
13
|
+
**description** | **String** | An optional description of the event, entered by the employee that created it. | [optional]
|
14
|
+
|
15
|
+
|
@@ -0,0 +1,28 @@
|
|
1
|
+
# SquareConnect::V1CashDrawerShift
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
## Properties
|
6
|
+
Name | Type | Description | Notes
|
7
|
+
------------ | ------------- | ------------- | -------------
|
8
|
+
**id** | **String** | The shift's unique ID. | [optional]
|
9
|
+
**event_type** | **String** | The shift's current state. | [optional]
|
10
|
+
**opened_at** | **String** | The time when the shift began, in ISO 8601 format. | [optional]
|
11
|
+
**ended_at** | **BOOLEAN** | The time when the shift ended, in ISO 8601 format. | [optional]
|
12
|
+
**closed_at** | **String** | The time when the shift was closed, in ISO 8601 format. | [optional]
|
13
|
+
**employee_ids** | **Array<String>** | The IDs of all employees that were logged into Square Register at some point during the cash drawer shift. | [optional]
|
14
|
+
**opening_employee_id** | **String** | The ID of the employee that started the cash drawer shift. | [optional]
|
15
|
+
**ending_employee_id** | **String** | The ID of the employee that ended the cash drawer shift. | [optional]
|
16
|
+
**closing_employee_id** | **String** | The ID of the employee that closed the cash drawer shift by auditing the cash drawer's contents. | [optional]
|
17
|
+
**description** | **String** | The time when the timecard was created, in ISO 8601 format. | [optional]
|
18
|
+
**starting_cash_money** | [**V1Money**](V1Money.md) | The amount of money in the cash drawer at the start of the shift. | [optional]
|
19
|
+
**cash_payment_money** | [**V1Money**](V1Money.md) | The amount of money added to the cash drawer from cash payments. | [optional]
|
20
|
+
**cash_refunds_money** | [**V1Money**](V1Money.md) | The amount of money removed from the cash drawer from cash refunds. This value is always negative or zero. | [optional]
|
21
|
+
**cash_paid_in_money** | [**V1Money**](V1Money.md) | The amount of money added to the cash drawer for reasons other than cash payments. | [optional]
|
22
|
+
**cash_paid_out_money** | [**V1Money**](V1Money.md) | The amount of money removed from the cash drawer for reasons other than cash refunds. | [optional]
|
23
|
+
**expected_cash_money** | [**V1Money**](V1Money.md) | The amount of money that should be in the cash drawer at the end of the shift, based on the shift's other money amounts. | [optional]
|
24
|
+
**closed_cash_money** | [**V1Money**](V1Money.md) | The amount of money found in the cash drawer at the end of the shift by an auditing employee. | [optional]
|
25
|
+
**device** | [**Device**](Device.md) | The device running Square Register that was connected to the cash drawer. | [optional]
|
26
|
+
**events** | [**Array<V1CashDrawerEvent>**](V1CashDrawerEvent.md) | All of the events (payments, refunds, and so on) that involved the cash drawer during the shift. | [optional]
|
27
|
+
|
28
|
+
|
data/docs/V1Category.md
ADDED
@@ -0,0 +1,11 @@
|
|
1
|
+
# SquareConnect::V1Category
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
## Properties
|
6
|
+
Name | Type | Description | Notes
|
7
|
+
------------ | ------------- | ------------- | -------------
|
8
|
+
**id** | **String** | The category's unique ID. | [optional]
|
9
|
+
**name** | **String** | The category's name. | [optional]
|
10
|
+
|
11
|
+
|
@@ -0,0 +1,14 @@
|
|
1
|
+
# SquareConnect::V1CreateRefundRequest
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
## Properties
|
6
|
+
Name | Type | Description | Notes
|
7
|
+
------------ | ------------- | ------------- | -------------
|
8
|
+
**payment_id** | **String** | The ID of the payment to refund. If you're creating a PARTIAL refund for a split tender payment, instead provide the id of the particular tender you want to refund. See Split Tender Payments for details. |
|
9
|
+
**type** | **String** | TThe type of refund (FULL or PARTIAL). |
|
10
|
+
**reason** | **String** | The reason for the refund. |
|
11
|
+
**refunded_money** | [**V1Money**](V1Money.md) | The amount of money to refund. Required only for PARTIAL refunds. | [optional]
|
12
|
+
**request_idempotence_key** | **String** | An optional key to ensure idempotence if you issue the same PARTIAL refund request more than once. | [optional]
|
13
|
+
|
14
|
+
|
data/docs/V1Discount.md
ADDED
@@ -0,0 +1,16 @@
|
|
1
|
+
# SquareConnect::V1Discount
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
## Properties
|
6
|
+
Name | Type | Description | Notes
|
7
|
+
------------ | ------------- | ------------- | -------------
|
8
|
+
**id** | **String** | The discount's unique ID. | [optional]
|
9
|
+
**name** | **String** | The discount's name. | [optional]
|
10
|
+
**rate** | **String** | The rate of the discount, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%. This rate is 0 if discount_type is VARIABLE_PERCENTAGE. | [optional]
|
11
|
+
**amount_money** | [**V1Money**](V1Money.md) | The amount of the discount. This amount is 0 if discount_type is VARIABLE_AMOUNT. This field is not included for rate-based discounts. | [optional]
|
12
|
+
**discount_type** | **String** | Indicates whether the discount is a FIXED value or entered at the time of sale. | [optional]
|
13
|
+
**pin_required** | **BOOLEAN** | Indicates whether a mobile staff member needs to enter their PIN to apply the discount to a payment. | [optional]
|
14
|
+
**color** | **String** | The color of the discount's display label in Square Register, if not the default color. The default color is 9da2a6. | [optional]
|
15
|
+
|
16
|
+
|
data/docs/V1Employee.md
ADDED
@@ -0,0 +1,21 @@
|
|
1
|
+
# SquareConnect::V1Employee
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
Represents one of a business's employees.
|
6
|
+
|
7
|
+
## Properties
|
8
|
+
Name | Type | Description | Notes
|
9
|
+
------------ | ------------- | ------------- | -------------
|
10
|
+
**id** | **String** | The employee's unique ID. | [optional]
|
11
|
+
**first_name** | **String** | The employee's first name. |
|
12
|
+
**last_name** | **String** | The employee's last name. |
|
13
|
+
**role_ids** | **Array<String>** | The ids of the employee's associated roles. Currently, you can specify only one or zero roles per employee. | [optional]
|
14
|
+
**authorized_location_ids** | **Array<String>** | The IDs of the locations the employee is allowed to clock in at. | [optional]
|
15
|
+
**email** | **String** | The employee's email address. | [optional]
|
16
|
+
**status** | **String** | CWhether the employee is ACTIVE or INACTIVE. Inactive employees cannot sign in to Square Register.Merchants update this field from the Square Dashboard. | [optional]
|
17
|
+
**external_id** | **String** | An ID the merchant can set to associate the employee with an entity in another system. | [optional]
|
18
|
+
**created_at** | **String** | The time when the employee entity was created, in ISO 8601 format. | [optional]
|
19
|
+
**updated_at** | **String** | The time when the employee entity was most recently updated, in ISO 8601 format. | [optional]
|
20
|
+
|
21
|
+
|
@@ -0,0 +1,15 @@
|
|
1
|
+
# SquareConnect::V1EmployeeRole
|
2
|
+
|
3
|
+
### Description
|
4
|
+
|
5
|
+
## Properties
|
6
|
+
Name | Type | Description | Notes
|
7
|
+
------------ | ------------- | ------------- | -------------
|
8
|
+
**id** | **String** | The role's unique ID, Can only be set by Square. | [optional]
|
9
|
+
**name** | **String** | The role's merchant-defined name. |
|
10
|
+
**permissions** | **Array<String>** | The role's permissions. |
|
11
|
+
**is_owner** | **BOOLEAN** | If true, employees with this role have all permissions, regardless of the values indicated in permissions. | [optional]
|
12
|
+
**created_at** | **String** | The time when the employee entity was created, in ISO 8601 format. Is set by Square when the Role is created. | [optional]
|
13
|
+
**updated_at** | **String** | The time when the employee entity was most recently updated, in ISO 8601 format. Is set by Square when the Role updated. | [optional]
|
14
|
+
|
15
|
+
|
@@ -0,0 +1,915 @@
|
|
1
|
+
# SquareConnect::V1EmployeesApi
|
2
|
+
|
3
|
+
All URIs are relative to *https://connect.squareup.com*
|
4
|
+
|
5
|
+
Method | HTTP request | Description
|
6
|
+
------------- | ------------- | -------------
|
7
|
+
[**create_employee**](V1EmployeesApi.md#create_employee) | **POST** /v1/me/employees | Creates an employee for a business.
|
8
|
+
[**create_employee_role**](V1EmployeesApi.md#create_employee_role) | **POST** /v1/me/roles | Creates an employee role you can then assign to employees.
|
9
|
+
[**create_timecard**](V1EmployeesApi.md#create_timecard) | **POST** /v1/me/timecards | Creates a timecard for an employee. Each timecard corresponds to a single shift.
|
10
|
+
[**delete_timecard**](V1EmployeesApi.md#delete_timecard) | **DELETE** /v1/me/timecards/{timecard_id} | Deletes a timecard. Deleted timecards are still accessible from Connect API endpoints, but the value of their deleted field is set to true. See Handling deleted timecards for more information.
|
11
|
+
[**list_cash_drawer_shifts**](V1EmployeesApi.md#list_cash_drawer_shifts) | **GET** /v1/{location_id}/cash-drawer-shifts | Provides the details for all of a location's cash drawer shifts during a date range. The date range you specify cannot exceed 90 days.
|
12
|
+
[**list_employee_roles**](V1EmployeesApi.md#list_employee_roles) | **GET** /v1/me/roles | Provides summary information for all of a business's employee roles.
|
13
|
+
[**list_employees**](V1EmployeesApi.md#list_employees) | **GET** /v1/me/employees | Provides summary information for all of a business's employees.
|
14
|
+
[**list_timecard_events**](V1EmployeesApi.md#list_timecard_events) | **GET** /v1/me/timecards/{timecard_id}/events | Provides summary information for all events associated with a particular timecard.
|
15
|
+
[**list_timecards**](V1EmployeesApi.md#list_timecards) | **GET** /v1/me/timecards | Provides summary information for all of a business's employee timecards.
|
16
|
+
[**retrieve_cash_drawer_shift**](V1EmployeesApi.md#retrieve_cash_drawer_shift) | **GET** /v1/{location_id}/cash-drawer-shifts/{shift_id} | Provides the details for a single cash drawer shift, including all events that occurred during the shift.
|
17
|
+
[**retrieve_employee**](V1EmployeesApi.md#retrieve_employee) | **GET** /v1/me/employees/{employee_id} | Provides the details for a single employee.
|
18
|
+
[**retrieve_employee_role**](V1EmployeesApi.md#retrieve_employee_role) | **GET** /v1/me/roles/{role_id} | Provides the details for a single employee role.
|
19
|
+
[**retrieve_timecard**](V1EmployeesApi.md#retrieve_timecard) | **GET** /v1/me/timecards/{timecard_id} | Provides the details for a single timecard.
|
20
|
+
[**update_employee**](V1EmployeesApi.md#update_employee) | **PUT** /v1/me/employees/{employee_id} | V1 UpdateEmployee
|
21
|
+
[**update_employee_role**](V1EmployeesApi.md#update_employee_role) | **PUT** /v1/me/roles/{role_id} | Modifies the details of an employee role.
|
22
|
+
[**update_timecard**](V1EmployeesApi.md#update_timecard) | **PUT** /v1/me/timecards/{timecard_id} | Modifies a timecard's details. This creates an API_EDIT event for the timecard. You can view a timecard's event history with the List Timecard Events endpoint.
|
23
|
+
|
24
|
+
|
25
|
+
# **create_employee**
|
26
|
+
> V1Employee create_employee(body)
|
27
|
+
|
28
|
+
Creates an employee for a business.
|
29
|
+
|
30
|
+
Creates an employee for a business.
|
31
|
+
|
32
|
+
### Example
|
33
|
+
```ruby
|
34
|
+
# load the gem
|
35
|
+
require 'square_connect'
|
36
|
+
# setup authorization
|
37
|
+
SquareConnect.configure do |config|
|
38
|
+
# Configure OAuth2 access token for authorization: oauth2
|
39
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
40
|
+
end
|
41
|
+
|
42
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
43
|
+
|
44
|
+
body = SquareConnect::V1Employee.new # V1Employee | An object containing the fields to POST for the request. See the corresponding object definition for field details.
|
45
|
+
|
46
|
+
|
47
|
+
begin
|
48
|
+
#Creates an employee for a business.
|
49
|
+
result = api_instance.create_employee(body)
|
50
|
+
p result
|
51
|
+
rescue SquareConnect::ApiError => e
|
52
|
+
puts "Exception when calling V1EmployeesApi->create_employee: #{e}"
|
53
|
+
end
|
54
|
+
```
|
55
|
+
|
56
|
+
### Parameters
|
57
|
+
|
58
|
+
Name | Type | Description | Notes
|
59
|
+
------------- | ------------- | ------------- | -------------
|
60
|
+
**body** | [**V1Employee**](V1Employee.md)| An object containing the fields to POST for the request. See the corresponding object definition for field details. |
|
61
|
+
|
62
|
+
### Return type
|
63
|
+
|
64
|
+
[**V1Employee**](V1Employee.md)
|
65
|
+
|
66
|
+
### Authorization
|
67
|
+
|
68
|
+
[oauth2](../README.md#oauth2)
|
69
|
+
|
70
|
+
### HTTP request headers
|
71
|
+
|
72
|
+
- **Content-Type**: application/json
|
73
|
+
- **Accept**: application/json
|
74
|
+
|
75
|
+
|
76
|
+
|
77
|
+
# **create_employee_role**
|
78
|
+
> V1EmployeeRole create_employee_role(employee_role)
|
79
|
+
|
80
|
+
Creates an employee role you can then assign to employees.
|
81
|
+
|
82
|
+
Creates an employee role you can then assign to employees.
|
83
|
+
|
84
|
+
### Example
|
85
|
+
```ruby
|
86
|
+
# load the gem
|
87
|
+
require 'square_connect'
|
88
|
+
# setup authorization
|
89
|
+
SquareConnect.configure do |config|
|
90
|
+
# Configure OAuth2 access token for authorization: oauth2
|
91
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
92
|
+
end
|
93
|
+
|
94
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
95
|
+
|
96
|
+
employee_role = SquareConnect::V1EmployeeRole.new # V1EmployeeRole | An EmployeeRole object with a name and permissions, and an optional owner flag.
|
97
|
+
|
98
|
+
|
99
|
+
begin
|
100
|
+
#Creates an employee role you can then assign to employees.
|
101
|
+
result = api_instance.create_employee_role(employee_role)
|
102
|
+
p result
|
103
|
+
rescue SquareConnect::ApiError => e
|
104
|
+
puts "Exception when calling V1EmployeesApi->create_employee_role: #{e}"
|
105
|
+
end
|
106
|
+
```
|
107
|
+
|
108
|
+
### Parameters
|
109
|
+
|
110
|
+
Name | Type | Description | Notes
|
111
|
+
------------- | ------------- | ------------- | -------------
|
112
|
+
**employee_role** | [**V1EmployeeRole**](V1EmployeeRole.md)| An EmployeeRole object with a name and permissions, and an optional owner flag. |
|
113
|
+
|
114
|
+
### Return type
|
115
|
+
|
116
|
+
[**V1EmployeeRole**](V1EmployeeRole.md)
|
117
|
+
|
118
|
+
### Authorization
|
119
|
+
|
120
|
+
[oauth2](../README.md#oauth2)
|
121
|
+
|
122
|
+
### HTTP request headers
|
123
|
+
|
124
|
+
- **Content-Type**: application/json
|
125
|
+
- **Accept**: application/json
|
126
|
+
|
127
|
+
|
128
|
+
|
129
|
+
# **create_timecard**
|
130
|
+
> V1Timecard create_timecard(body)
|
131
|
+
|
132
|
+
Creates a timecard for an employee. Each timecard corresponds to a single shift.
|
133
|
+
|
134
|
+
Creates a timecard for an employee. Each timecard corresponds to a single shift.
|
135
|
+
|
136
|
+
### Example
|
137
|
+
```ruby
|
138
|
+
# load the gem
|
139
|
+
require 'square_connect'
|
140
|
+
# setup authorization
|
141
|
+
SquareConnect.configure do |config|
|
142
|
+
# Configure OAuth2 access token for authorization: oauth2
|
143
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
144
|
+
end
|
145
|
+
|
146
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
147
|
+
|
148
|
+
body = SquareConnect::V1Timecard.new # V1Timecard | An object containing the fields to POST for the request. See the corresponding object definition for field details.
|
149
|
+
|
150
|
+
|
151
|
+
begin
|
152
|
+
#Creates a timecard for an employee. Each timecard corresponds to a single shift.
|
153
|
+
result = api_instance.create_timecard(body)
|
154
|
+
p result
|
155
|
+
rescue SquareConnect::ApiError => e
|
156
|
+
puts "Exception when calling V1EmployeesApi->create_timecard: #{e}"
|
157
|
+
end
|
158
|
+
```
|
159
|
+
|
160
|
+
### Parameters
|
161
|
+
|
162
|
+
Name | Type | Description | Notes
|
163
|
+
------------- | ------------- | ------------- | -------------
|
164
|
+
**body** | [**V1Timecard**](V1Timecard.md)| An object containing the fields to POST for the request. See the corresponding object definition for field details. |
|
165
|
+
|
166
|
+
### Return type
|
167
|
+
|
168
|
+
[**V1Timecard**](V1Timecard.md)
|
169
|
+
|
170
|
+
### Authorization
|
171
|
+
|
172
|
+
[oauth2](../README.md#oauth2)
|
173
|
+
|
174
|
+
### HTTP request headers
|
175
|
+
|
176
|
+
- **Content-Type**: application/json
|
177
|
+
- **Accept**: application/json
|
178
|
+
|
179
|
+
|
180
|
+
|
181
|
+
# **delete_timecard**
|
182
|
+
> Object delete_timecard(timecard_id)
|
183
|
+
|
184
|
+
Deletes a timecard. Deleted timecards are still accessible from Connect API endpoints, but the value of their deleted field is set to true. See Handling deleted timecards for more information.
|
185
|
+
|
186
|
+
Deletes a timecard. Deleted timecards are still accessible from Connect API endpoints, but the value of their deleted field is set to true. See Handling deleted timecards for more information.
|
187
|
+
|
188
|
+
### Example
|
189
|
+
```ruby
|
190
|
+
# load the gem
|
191
|
+
require 'square_connect'
|
192
|
+
# setup authorization
|
193
|
+
SquareConnect.configure do |config|
|
194
|
+
# Configure OAuth2 access token for authorization: oauth2
|
195
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
196
|
+
end
|
197
|
+
|
198
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
199
|
+
|
200
|
+
timecard_id = "timecard_id_example" # String | The ID of the timecard to delete.
|
201
|
+
|
202
|
+
|
203
|
+
begin
|
204
|
+
#Deletes a timecard. Deleted timecards are still accessible from Connect API endpoints, but the value of their deleted field is set to true. See Handling deleted timecards for more information.
|
205
|
+
result = api_instance.delete_timecard(timecard_id)
|
206
|
+
p result
|
207
|
+
rescue SquareConnect::ApiError => e
|
208
|
+
puts "Exception when calling V1EmployeesApi->delete_timecard: #{e}"
|
209
|
+
end
|
210
|
+
```
|
211
|
+
|
212
|
+
### Parameters
|
213
|
+
|
214
|
+
Name | Type | Description | Notes
|
215
|
+
------------- | ------------- | ------------- | -------------
|
216
|
+
**timecard_id** | **String**| The ID of the timecard to delete. |
|
217
|
+
|
218
|
+
### Return type
|
219
|
+
|
220
|
+
**Object**
|
221
|
+
|
222
|
+
### Authorization
|
223
|
+
|
224
|
+
[oauth2](../README.md#oauth2)
|
225
|
+
|
226
|
+
### HTTP request headers
|
227
|
+
|
228
|
+
- **Content-Type**: application/json
|
229
|
+
- **Accept**: application/json
|
230
|
+
|
231
|
+
|
232
|
+
|
233
|
+
# **list_cash_drawer_shifts**
|
234
|
+
> Array<V1CashDrawerShift> list_cash_drawer_shifts(location_id, opts)
|
235
|
+
|
236
|
+
Provides the details for all of a location's cash drawer shifts during a date range. The date range you specify cannot exceed 90 days.
|
237
|
+
|
238
|
+
Provides the details for all of a location's cash drawer shifts during a date range. The date range you specify cannot exceed 90 days.
|
239
|
+
|
240
|
+
### Example
|
241
|
+
```ruby
|
242
|
+
# load the gem
|
243
|
+
require 'square_connect'
|
244
|
+
# setup authorization
|
245
|
+
SquareConnect.configure do |config|
|
246
|
+
# Configure OAuth2 access token for authorization: oauth2
|
247
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
248
|
+
end
|
249
|
+
|
250
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
251
|
+
|
252
|
+
location_id = "location_id_example" # String | The ID of the location to list cash drawer shifts for.
|
253
|
+
|
254
|
+
opts = {
|
255
|
+
order: "order_example", # String | The order in which cash drawer shifts are listed in the response, based on their created_at field. Default value: ASC
|
256
|
+
begin_time: "begin_time_example", # String | The beginning of the requested reporting period, in ISO 8601 format. Default value: The current time minus 90 days.
|
257
|
+
end_time: "end_time_example" # String | The beginning of the requested reporting period, in ISO 8601 format. Default value: The current time.
|
258
|
+
}
|
259
|
+
|
260
|
+
begin
|
261
|
+
#Provides the details for all of a location's cash drawer shifts during a date range. The date range you specify cannot exceed 90 days.
|
262
|
+
result = api_instance.list_cash_drawer_shifts(location_id, opts)
|
263
|
+
p result
|
264
|
+
rescue SquareConnect::ApiError => e
|
265
|
+
puts "Exception when calling V1EmployeesApi->list_cash_drawer_shifts: #{e}"
|
266
|
+
end
|
267
|
+
```
|
268
|
+
|
269
|
+
### Parameters
|
270
|
+
|
271
|
+
Name | Type | Description | Notes
|
272
|
+
------------- | ------------- | ------------- | -------------
|
273
|
+
**location_id** | **String**| The ID of the location to list cash drawer shifts for. |
|
274
|
+
**order** | **String**| The order in which cash drawer shifts are listed in the response, based on their created_at field. Default value: ASC | [optional]
|
275
|
+
**begin_time** | **String**| The beginning of the requested reporting period, in ISO 8601 format. Default value: The current time minus 90 days. | [optional]
|
276
|
+
**end_time** | **String**| The beginning of the requested reporting period, in ISO 8601 format. Default value: The current time. | [optional]
|
277
|
+
|
278
|
+
### Return type
|
279
|
+
|
280
|
+
[**Array<V1CashDrawerShift>**](V1CashDrawerShift.md)
|
281
|
+
|
282
|
+
### Authorization
|
283
|
+
|
284
|
+
[oauth2](../README.md#oauth2)
|
285
|
+
|
286
|
+
### HTTP request headers
|
287
|
+
|
288
|
+
- **Content-Type**: application/json
|
289
|
+
- **Accept**: application/json
|
290
|
+
|
291
|
+
|
292
|
+
|
293
|
+
# **list_employee_roles**
|
294
|
+
> Array<V1EmployeeRole> list_employee_roles(opts)
|
295
|
+
|
296
|
+
Provides summary information for all of a business's employee roles.
|
297
|
+
|
298
|
+
Provides summary information for all of a business's employee roles.
|
299
|
+
|
300
|
+
### Example
|
301
|
+
```ruby
|
302
|
+
# load the gem
|
303
|
+
require 'square_connect'
|
304
|
+
# setup authorization
|
305
|
+
SquareConnect.configure do |config|
|
306
|
+
# Configure OAuth2 access token for authorization: oauth2
|
307
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
308
|
+
end
|
309
|
+
|
310
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
311
|
+
|
312
|
+
opts = {
|
313
|
+
order: "order_example", # String | The order in which employees are listed in the response, based on their created_at field.Default value: ASC
|
314
|
+
limit: 56, # Integer | The maximum integer number of employee entities to return in a single response. Default 100, maximum 200.
|
315
|
+
cursor: "cursor_example" # String | A pagination cursor to retrieve the next set of results for your original query to the endpoint.
|
316
|
+
}
|
317
|
+
|
318
|
+
begin
|
319
|
+
#Provides summary information for all of a business's employee roles.
|
320
|
+
result = api_instance.list_employee_roles(opts)
|
321
|
+
p result
|
322
|
+
rescue SquareConnect::ApiError => e
|
323
|
+
puts "Exception when calling V1EmployeesApi->list_employee_roles: #{e}"
|
324
|
+
end
|
325
|
+
```
|
326
|
+
|
327
|
+
### Parameters
|
328
|
+
|
329
|
+
Name | Type | Description | Notes
|
330
|
+
------------- | ------------- | ------------- | -------------
|
331
|
+
**order** | **String**| The order in which employees are listed in the response, based on their created_at field.Default value: ASC | [optional]
|
332
|
+
**limit** | **Integer**| The maximum integer number of employee entities to return in a single response. Default 100, maximum 200. | [optional]
|
333
|
+
**cursor** | **String**| A pagination cursor to retrieve the next set of results for your original query to the endpoint. | [optional]
|
334
|
+
|
335
|
+
### Return type
|
336
|
+
|
337
|
+
[**Array<V1EmployeeRole>**](V1EmployeeRole.md)
|
338
|
+
|
339
|
+
### Authorization
|
340
|
+
|
341
|
+
[oauth2](../README.md#oauth2)
|
342
|
+
|
343
|
+
### HTTP request headers
|
344
|
+
|
345
|
+
- **Content-Type**: application/json
|
346
|
+
- **Accept**: application/json
|
347
|
+
|
348
|
+
|
349
|
+
|
350
|
+
# **list_employees**
|
351
|
+
> Array<V1Employee> list_employees(opts)
|
352
|
+
|
353
|
+
Provides summary information for all of a business's employees.
|
354
|
+
|
355
|
+
Provides summary information for all of a business's employees.
|
356
|
+
|
357
|
+
### Example
|
358
|
+
```ruby
|
359
|
+
# load the gem
|
360
|
+
require 'square_connect'
|
361
|
+
# setup authorization
|
362
|
+
SquareConnect.configure do |config|
|
363
|
+
# Configure OAuth2 access token for authorization: oauth2
|
364
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
365
|
+
end
|
366
|
+
|
367
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
368
|
+
|
369
|
+
opts = {
|
370
|
+
order: "order_example", # String | The order in which employees are listed in the response, based on their created_at field. Default value: ASC
|
371
|
+
begin_updated_at: "begin_updated_at_example", # String | If filtering results by their updated_at field, the beginning of the requested reporting period, in ISO 8601 format
|
372
|
+
end_updated_at: "end_updated_at_example", # String | If filtering results by there updated_at field, the end of the requested reporting period, in ISO 8601 format.
|
373
|
+
begin_created_at: "begin_created_at_example", # String | If filtering results by their created_at field, the beginning of the requested reporting period, in ISO 8601 format.
|
374
|
+
end_created_at: "end_created_at_example", # String | If filtering results by their created_at field, the end of the requested reporting period, in ISO 8601 format.
|
375
|
+
status: "status_example", # String | If provided, the endpoint returns only employee entities with the specified status (ACTIVE or INACTIVE).
|
376
|
+
external_id: "external_id_example", # String | If provided, the endpoint returns only employee entities with the specified external_id.
|
377
|
+
limit: 56 # Integer | The maximum integer number of employee entities to return in a single response. Default 100, maximum 200.
|
378
|
+
}
|
379
|
+
|
380
|
+
begin
|
381
|
+
#Provides summary information for all of a business's employees.
|
382
|
+
result = api_instance.list_employees(opts)
|
383
|
+
p result
|
384
|
+
rescue SquareConnect::ApiError => e
|
385
|
+
puts "Exception when calling V1EmployeesApi->list_employees: #{e}"
|
386
|
+
end
|
387
|
+
```
|
388
|
+
|
389
|
+
### Parameters
|
390
|
+
|
391
|
+
Name | Type | Description | Notes
|
392
|
+
------------- | ------------- | ------------- | -------------
|
393
|
+
**order** | **String**| The order in which employees are listed in the response, based on their created_at field. Default value: ASC | [optional]
|
394
|
+
**begin_updated_at** | **String**| If filtering results by their updated_at field, the beginning of the requested reporting period, in ISO 8601 format | [optional]
|
395
|
+
**end_updated_at** | **String**| If filtering results by there updated_at field, the end of the requested reporting period, in ISO 8601 format. | [optional]
|
396
|
+
**begin_created_at** | **String**| If filtering results by their created_at field, the beginning of the requested reporting period, in ISO 8601 format. | [optional]
|
397
|
+
**end_created_at** | **String**| If filtering results by their created_at field, the end of the requested reporting period, in ISO 8601 format. | [optional]
|
398
|
+
**status** | **String**| If provided, the endpoint returns only employee entities with the specified status (ACTIVE or INACTIVE). | [optional]
|
399
|
+
**external_id** | **String**| If provided, the endpoint returns only employee entities with the specified external_id. | [optional]
|
400
|
+
**limit** | **Integer**| The maximum integer number of employee entities to return in a single response. Default 100, maximum 200. | [optional]
|
401
|
+
|
402
|
+
### Return type
|
403
|
+
|
404
|
+
[**Array<V1Employee>**](V1Employee.md)
|
405
|
+
|
406
|
+
### Authorization
|
407
|
+
|
408
|
+
[oauth2](../README.md#oauth2)
|
409
|
+
|
410
|
+
### HTTP request headers
|
411
|
+
|
412
|
+
- **Content-Type**: application/json
|
413
|
+
- **Accept**: application/json
|
414
|
+
|
415
|
+
|
416
|
+
|
417
|
+
# **list_timecard_events**
|
418
|
+
> Array<V1TimecardEvent> list_timecard_events(timecard_id)
|
419
|
+
|
420
|
+
Provides summary information for all events associated with a particular timecard.
|
421
|
+
|
422
|
+
Provides summary information for all events associated with a particular timecard.
|
423
|
+
|
424
|
+
### Example
|
425
|
+
```ruby
|
426
|
+
# load the gem
|
427
|
+
require 'square_connect'
|
428
|
+
# setup authorization
|
429
|
+
SquareConnect.configure do |config|
|
430
|
+
# Configure OAuth2 access token for authorization: oauth2
|
431
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
432
|
+
end
|
433
|
+
|
434
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
435
|
+
|
436
|
+
timecard_id = "timecard_id_example" # String | The ID of the timecard to list events for.
|
437
|
+
|
438
|
+
|
439
|
+
begin
|
440
|
+
#Provides summary information for all events associated with a particular timecard.
|
441
|
+
result = api_instance.list_timecard_events(timecard_id)
|
442
|
+
p result
|
443
|
+
rescue SquareConnect::ApiError => e
|
444
|
+
puts "Exception when calling V1EmployeesApi->list_timecard_events: #{e}"
|
445
|
+
end
|
446
|
+
```
|
447
|
+
|
448
|
+
### Parameters
|
449
|
+
|
450
|
+
Name | Type | Description | Notes
|
451
|
+
------------- | ------------- | ------------- | -------------
|
452
|
+
**timecard_id** | **String**| The ID of the timecard to list events for. |
|
453
|
+
|
454
|
+
### Return type
|
455
|
+
|
456
|
+
[**Array<V1TimecardEvent>**](V1TimecardEvent.md)
|
457
|
+
|
458
|
+
### Authorization
|
459
|
+
|
460
|
+
[oauth2](../README.md#oauth2)
|
461
|
+
|
462
|
+
### HTTP request headers
|
463
|
+
|
464
|
+
- **Content-Type**: application/json
|
465
|
+
- **Accept**: application/json
|
466
|
+
|
467
|
+
|
468
|
+
|
469
|
+
# **list_timecards**
|
470
|
+
> Array<V1Timecard> list_timecards(opts)
|
471
|
+
|
472
|
+
Provides summary information for all of a business's employee timecards.
|
473
|
+
|
474
|
+
Provides summary information for all of a business's employee timecards.
|
475
|
+
|
476
|
+
### Example
|
477
|
+
```ruby
|
478
|
+
# load the gem
|
479
|
+
require 'square_connect'
|
480
|
+
# setup authorization
|
481
|
+
SquareConnect.configure do |config|
|
482
|
+
# Configure OAuth2 access token for authorization: oauth2
|
483
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
484
|
+
end
|
485
|
+
|
486
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
487
|
+
|
488
|
+
opts = {
|
489
|
+
order: "order_example", # String | The order in which timecards are listed in the response, based on their created_at field.
|
490
|
+
employee_id: "employee_id_example", # String | If provided, the endpoint returns only timecards for the employee with the specified ID.
|
491
|
+
begin_clockin_time: "begin_clockin_time_example", # String | If filtering results by their clockin_time field, the beginning of the requested reporting period, in ISO 8601 format.
|
492
|
+
end_clockin_time: "end_clockin_time_example", # String | If filtering results by their clockin_time field, the end of the requested reporting period, in ISO 8601 format.
|
493
|
+
begin_clockout_time: "begin_clockout_time_example", # String | If filtering results by their clockout_time field, the beginning of the requested reporting period, in ISO 8601 format.
|
494
|
+
end_clockout_time: "end_clockout_time_example", # String | If filtering results by their clockout_time field, the end of the requested reporting period, in ISO 8601 format.
|
495
|
+
begin_updated_at: "begin_updated_at_example", # String | If filtering results by their updated_at field, the beginning of the requested reporting period, in ISO 8601 format.
|
496
|
+
end_updated_at: "end_updated_at_example", # String | If filtering results by their updated_at field, the end of the requested reporting period, in ISO 8601 format.
|
497
|
+
deleted: true, # BOOLEAN | If true, only deleted timecards are returned. If false, only valid timecards are returned.If you don't provide this parameter, both valid and deleted timecards are returned.
|
498
|
+
limit: 56, # Integer | The maximum integer number of employee entities to return in a single response. Default 100, maximum 200.
|
499
|
+
cursor: "cursor_example" # String | A pagination cursor to retrieve the next set of results for your original query to the endpoint.
|
500
|
+
}
|
501
|
+
|
502
|
+
begin
|
503
|
+
#Provides summary information for all of a business's employee timecards.
|
504
|
+
result = api_instance.list_timecards(opts)
|
505
|
+
p result
|
506
|
+
rescue SquareConnect::ApiError => e
|
507
|
+
puts "Exception when calling V1EmployeesApi->list_timecards: #{e}"
|
508
|
+
end
|
509
|
+
```
|
510
|
+
|
511
|
+
### Parameters
|
512
|
+
|
513
|
+
Name | Type | Description | Notes
|
514
|
+
------------- | ------------- | ------------- | -------------
|
515
|
+
**order** | **String**| The order in which timecards are listed in the response, based on their created_at field. | [optional]
|
516
|
+
**employee_id** | **String**| If provided, the endpoint returns only timecards for the employee with the specified ID. | [optional]
|
517
|
+
**begin_clockin_time** | **String**| If filtering results by their clockin_time field, the beginning of the requested reporting period, in ISO 8601 format. | [optional]
|
518
|
+
**end_clockin_time** | **String**| If filtering results by their clockin_time field, the end of the requested reporting period, in ISO 8601 format. | [optional]
|
519
|
+
**begin_clockout_time** | **String**| If filtering results by their clockout_time field, the beginning of the requested reporting period, in ISO 8601 format. | [optional]
|
520
|
+
**end_clockout_time** | **String**| If filtering results by their clockout_time field, the end of the requested reporting period, in ISO 8601 format. | [optional]
|
521
|
+
**begin_updated_at** | **String**| If filtering results by their updated_at field, the beginning of the requested reporting period, in ISO 8601 format. | [optional]
|
522
|
+
**end_updated_at** | **String**| If filtering results by their updated_at field, the end of the requested reporting period, in ISO 8601 format. | [optional]
|
523
|
+
**deleted** | **BOOLEAN**| If true, only deleted timecards are returned. If false, only valid timecards are returned.If you don't provide this parameter, both valid and deleted timecards are returned. | [optional]
|
524
|
+
**limit** | **Integer**| The maximum integer number of employee entities to return in a single response. Default 100, maximum 200. | [optional]
|
525
|
+
**cursor** | **String**| A pagination cursor to retrieve the next set of results for your original query to the endpoint. | [optional]
|
526
|
+
|
527
|
+
### Return type
|
528
|
+
|
529
|
+
[**Array<V1Timecard>**](V1Timecard.md)
|
530
|
+
|
531
|
+
### Authorization
|
532
|
+
|
533
|
+
[oauth2](../README.md#oauth2)
|
534
|
+
|
535
|
+
### HTTP request headers
|
536
|
+
|
537
|
+
- **Content-Type**: application/json
|
538
|
+
- **Accept**: application/json
|
539
|
+
|
540
|
+
|
541
|
+
|
542
|
+
# **retrieve_cash_drawer_shift**
|
543
|
+
> V1CashDrawerShift retrieve_cash_drawer_shift(location_id, shift_id)
|
544
|
+
|
545
|
+
Provides the details for a single cash drawer shift, including all events that occurred during the shift.
|
546
|
+
|
547
|
+
Provides the details for a single cash drawer shift, including all events that occurred during the shift.
|
548
|
+
|
549
|
+
### Example
|
550
|
+
```ruby
|
551
|
+
# load the gem
|
552
|
+
require 'square_connect'
|
553
|
+
# setup authorization
|
554
|
+
SquareConnect.configure do |config|
|
555
|
+
# Configure OAuth2 access token for authorization: oauth2
|
556
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
557
|
+
end
|
558
|
+
|
559
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
560
|
+
|
561
|
+
location_id = "location_id_example" # String | The ID of the location to list cash drawer shifts for.
|
562
|
+
|
563
|
+
shift_id = "shift_id_example" # String | The shift's ID.
|
564
|
+
|
565
|
+
|
566
|
+
begin
|
567
|
+
#Provides the details for a single cash drawer shift, including all events that occurred during the shift.
|
568
|
+
result = api_instance.retrieve_cash_drawer_shift(location_id, shift_id)
|
569
|
+
p result
|
570
|
+
rescue SquareConnect::ApiError => e
|
571
|
+
puts "Exception when calling V1EmployeesApi->retrieve_cash_drawer_shift: #{e}"
|
572
|
+
end
|
573
|
+
```
|
574
|
+
|
575
|
+
### Parameters
|
576
|
+
|
577
|
+
Name | Type | Description | Notes
|
578
|
+
------------- | ------------- | ------------- | -------------
|
579
|
+
**location_id** | **String**| The ID of the location to list cash drawer shifts for. |
|
580
|
+
**shift_id** | **String**| The shift's ID. |
|
581
|
+
|
582
|
+
### Return type
|
583
|
+
|
584
|
+
[**V1CashDrawerShift**](V1CashDrawerShift.md)
|
585
|
+
|
586
|
+
### Authorization
|
587
|
+
|
588
|
+
[oauth2](../README.md#oauth2)
|
589
|
+
|
590
|
+
### HTTP request headers
|
591
|
+
|
592
|
+
- **Content-Type**: application/json
|
593
|
+
- **Accept**: application/json
|
594
|
+
|
595
|
+
|
596
|
+
|
597
|
+
# **retrieve_employee**
|
598
|
+
> V1Employee retrieve_employee(employee_id)
|
599
|
+
|
600
|
+
Provides the details for a single employee.
|
601
|
+
|
602
|
+
Provides the details for a single employee.
|
603
|
+
|
604
|
+
### Example
|
605
|
+
```ruby
|
606
|
+
# load the gem
|
607
|
+
require 'square_connect'
|
608
|
+
# setup authorization
|
609
|
+
SquareConnect.configure do |config|
|
610
|
+
# Configure OAuth2 access token for authorization: oauth2
|
611
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
612
|
+
end
|
613
|
+
|
614
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
615
|
+
|
616
|
+
employee_id = "employee_id_example" # String | The employee's ID.
|
617
|
+
|
618
|
+
|
619
|
+
begin
|
620
|
+
#Provides the details for a single employee.
|
621
|
+
result = api_instance.retrieve_employee(employee_id)
|
622
|
+
p result
|
623
|
+
rescue SquareConnect::ApiError => e
|
624
|
+
puts "Exception when calling V1EmployeesApi->retrieve_employee: #{e}"
|
625
|
+
end
|
626
|
+
```
|
627
|
+
|
628
|
+
### Parameters
|
629
|
+
|
630
|
+
Name | Type | Description | Notes
|
631
|
+
------------- | ------------- | ------------- | -------------
|
632
|
+
**employee_id** | **String**| The employee's ID. |
|
633
|
+
|
634
|
+
### Return type
|
635
|
+
|
636
|
+
[**V1Employee**](V1Employee.md)
|
637
|
+
|
638
|
+
### Authorization
|
639
|
+
|
640
|
+
[oauth2](../README.md#oauth2)
|
641
|
+
|
642
|
+
### HTTP request headers
|
643
|
+
|
644
|
+
- **Content-Type**: application/json
|
645
|
+
- **Accept**: application/json
|
646
|
+
|
647
|
+
|
648
|
+
|
649
|
+
# **retrieve_employee_role**
|
650
|
+
> V1EmployeeRole retrieve_employee_role(role_id)
|
651
|
+
|
652
|
+
Provides the details for a single employee role.
|
653
|
+
|
654
|
+
Provides the details for a single employee role.
|
655
|
+
|
656
|
+
### Example
|
657
|
+
```ruby
|
658
|
+
# load the gem
|
659
|
+
require 'square_connect'
|
660
|
+
# setup authorization
|
661
|
+
SquareConnect.configure do |config|
|
662
|
+
# Configure OAuth2 access token for authorization: oauth2
|
663
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
664
|
+
end
|
665
|
+
|
666
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
667
|
+
|
668
|
+
role_id = "role_id_example" # String | The role's ID.
|
669
|
+
|
670
|
+
|
671
|
+
begin
|
672
|
+
#Provides the details for a single employee role.
|
673
|
+
result = api_instance.retrieve_employee_role(role_id)
|
674
|
+
p result
|
675
|
+
rescue SquareConnect::ApiError => e
|
676
|
+
puts "Exception when calling V1EmployeesApi->retrieve_employee_role: #{e}"
|
677
|
+
end
|
678
|
+
```
|
679
|
+
|
680
|
+
### Parameters
|
681
|
+
|
682
|
+
Name | Type | Description | Notes
|
683
|
+
------------- | ------------- | ------------- | -------------
|
684
|
+
**role_id** | **String**| The role's ID. |
|
685
|
+
|
686
|
+
### Return type
|
687
|
+
|
688
|
+
[**V1EmployeeRole**](V1EmployeeRole.md)
|
689
|
+
|
690
|
+
### Authorization
|
691
|
+
|
692
|
+
[oauth2](../README.md#oauth2)
|
693
|
+
|
694
|
+
### HTTP request headers
|
695
|
+
|
696
|
+
- **Content-Type**: application/json
|
697
|
+
- **Accept**: application/json
|
698
|
+
|
699
|
+
|
700
|
+
|
701
|
+
# **retrieve_timecard**
|
702
|
+
> V1Timecard retrieve_timecard(timecard_id)
|
703
|
+
|
704
|
+
Provides the details for a single timecard.
|
705
|
+
|
706
|
+
Provides the details for a single timecard.
|
707
|
+
|
708
|
+
### Example
|
709
|
+
```ruby
|
710
|
+
# load the gem
|
711
|
+
require 'square_connect'
|
712
|
+
# setup authorization
|
713
|
+
SquareConnect.configure do |config|
|
714
|
+
# Configure OAuth2 access token for authorization: oauth2
|
715
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
716
|
+
end
|
717
|
+
|
718
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
719
|
+
|
720
|
+
timecard_id = "timecard_id_example" # String | The timecard's ID.
|
721
|
+
|
722
|
+
|
723
|
+
begin
|
724
|
+
#Provides the details for a single timecard.
|
725
|
+
result = api_instance.retrieve_timecard(timecard_id)
|
726
|
+
p result
|
727
|
+
rescue SquareConnect::ApiError => e
|
728
|
+
puts "Exception when calling V1EmployeesApi->retrieve_timecard: #{e}"
|
729
|
+
end
|
730
|
+
```
|
731
|
+
|
732
|
+
### Parameters
|
733
|
+
|
734
|
+
Name | Type | Description | Notes
|
735
|
+
------------- | ------------- | ------------- | -------------
|
736
|
+
**timecard_id** | **String**| The timecard's ID. |
|
737
|
+
|
738
|
+
### Return type
|
739
|
+
|
740
|
+
[**V1Timecard**](V1Timecard.md)
|
741
|
+
|
742
|
+
### Authorization
|
743
|
+
|
744
|
+
[oauth2](../README.md#oauth2)
|
745
|
+
|
746
|
+
### HTTP request headers
|
747
|
+
|
748
|
+
- **Content-Type**: application/json
|
749
|
+
- **Accept**: application/json
|
750
|
+
|
751
|
+
|
752
|
+
|
753
|
+
# **update_employee**
|
754
|
+
> V1Employee update_employee(employee_id, body)
|
755
|
+
|
756
|
+
V1 UpdateEmployee
|
757
|
+
|
758
|
+
### Example
|
759
|
+
```ruby
|
760
|
+
# load the gem
|
761
|
+
require 'square_connect'
|
762
|
+
# setup authorization
|
763
|
+
SquareConnect.configure do |config|
|
764
|
+
# Configure OAuth2 access token for authorization: oauth2
|
765
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
766
|
+
end
|
767
|
+
|
768
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
769
|
+
|
770
|
+
employee_id = "employee_id_example" # String | The ID of the role to modify.
|
771
|
+
|
772
|
+
body = SquareConnect::V1Employee.new # V1Employee | An object containing the fields to POST for the request. See the corresponding object definition for field details.
|
773
|
+
|
774
|
+
|
775
|
+
begin
|
776
|
+
#V1 UpdateEmployee
|
777
|
+
result = api_instance.update_employee(employee_id, body)
|
778
|
+
p result
|
779
|
+
rescue SquareConnect::ApiError => e
|
780
|
+
puts "Exception when calling V1EmployeesApi->update_employee: #{e}"
|
781
|
+
end
|
782
|
+
```
|
783
|
+
|
784
|
+
### Parameters
|
785
|
+
|
786
|
+
Name | Type | Description | Notes
|
787
|
+
------------- | ------------- | ------------- | -------------
|
788
|
+
**employee_id** | **String**| The ID of the role to modify. |
|
789
|
+
**body** | [**V1Employee**](V1Employee.md)| An object containing the fields to POST for the request. See the corresponding object definition for field details. |
|
790
|
+
|
791
|
+
### Return type
|
792
|
+
|
793
|
+
[**V1Employee**](V1Employee.md)
|
794
|
+
|
795
|
+
### Authorization
|
796
|
+
|
797
|
+
[oauth2](../README.md#oauth2)
|
798
|
+
|
799
|
+
### HTTP request headers
|
800
|
+
|
801
|
+
- **Content-Type**: application/json
|
802
|
+
- **Accept**: application/json
|
803
|
+
|
804
|
+
|
805
|
+
|
806
|
+
# **update_employee_role**
|
807
|
+
> V1EmployeeRole update_employee_role(role_id, body)
|
808
|
+
|
809
|
+
Modifies the details of an employee role.
|
810
|
+
|
811
|
+
Modifies the details of an employee role.
|
812
|
+
|
813
|
+
### Example
|
814
|
+
```ruby
|
815
|
+
# load the gem
|
816
|
+
require 'square_connect'
|
817
|
+
# setup authorization
|
818
|
+
SquareConnect.configure do |config|
|
819
|
+
# Configure OAuth2 access token for authorization: oauth2
|
820
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
821
|
+
end
|
822
|
+
|
823
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
824
|
+
|
825
|
+
role_id = "role_id_example" # String | The ID of the role to modify.
|
826
|
+
|
827
|
+
body = SquareConnect::V1EmployeeRole.new # V1EmployeeRole | An object containing the fields to POST for the request. See the corresponding object definition for field details.
|
828
|
+
|
829
|
+
|
830
|
+
begin
|
831
|
+
#Modifies the details of an employee role.
|
832
|
+
result = api_instance.update_employee_role(role_id, body)
|
833
|
+
p result
|
834
|
+
rescue SquareConnect::ApiError => e
|
835
|
+
puts "Exception when calling V1EmployeesApi->update_employee_role: #{e}"
|
836
|
+
end
|
837
|
+
```
|
838
|
+
|
839
|
+
### Parameters
|
840
|
+
|
841
|
+
Name | Type | Description | Notes
|
842
|
+
------------- | ------------- | ------------- | -------------
|
843
|
+
**role_id** | **String**| The ID of the role to modify. |
|
844
|
+
**body** | [**V1EmployeeRole**](V1EmployeeRole.md)| An object containing the fields to POST for the request. See the corresponding object definition for field details. |
|
845
|
+
|
846
|
+
### Return type
|
847
|
+
|
848
|
+
[**V1EmployeeRole**](V1EmployeeRole.md)
|
849
|
+
|
850
|
+
### Authorization
|
851
|
+
|
852
|
+
[oauth2](../README.md#oauth2)
|
853
|
+
|
854
|
+
### HTTP request headers
|
855
|
+
|
856
|
+
- **Content-Type**: application/json
|
857
|
+
- **Accept**: application/json
|
858
|
+
|
859
|
+
|
860
|
+
|
861
|
+
# **update_timecard**
|
862
|
+
> V1Timecard update_timecard(timecard_id, body)
|
863
|
+
|
864
|
+
Modifies a timecard's details. This creates an API_EDIT event for the timecard. You can view a timecard's event history with the List Timecard Events endpoint.
|
865
|
+
|
866
|
+
Modifies a timecard's details. This creates an API_EDIT event for the timecard. You can view a timecard's event history with the List Timecard Events endpoint.
|
867
|
+
|
868
|
+
### Example
|
869
|
+
```ruby
|
870
|
+
# load the gem
|
871
|
+
require 'square_connect'
|
872
|
+
# setup authorization
|
873
|
+
SquareConnect.configure do |config|
|
874
|
+
# Configure OAuth2 access token for authorization: oauth2
|
875
|
+
config.access_token = 'YOUR ACCESS TOKEN'
|
876
|
+
end
|
877
|
+
|
878
|
+
api_instance = SquareConnect::V1EmployeesApi.new
|
879
|
+
|
880
|
+
timecard_id = "timecard_id_example" # String | TThe ID of the timecard to modify.
|
881
|
+
|
882
|
+
body = SquareConnect::V1Timecard.new # V1Timecard | An object containing the fields to POST for the request. See the corresponding object definition for field details.
|
883
|
+
|
884
|
+
|
885
|
+
begin
|
886
|
+
#Modifies a timecard's details. This creates an API_EDIT event for the timecard. You can view a timecard's event history with the List Timecard Events endpoint.
|
887
|
+
result = api_instance.update_timecard(timecard_id, body)
|
888
|
+
p result
|
889
|
+
rescue SquareConnect::ApiError => e
|
890
|
+
puts "Exception when calling V1EmployeesApi->update_timecard: #{e}"
|
891
|
+
end
|
892
|
+
```
|
893
|
+
|
894
|
+
### Parameters
|
895
|
+
|
896
|
+
Name | Type | Description | Notes
|
897
|
+
------------- | ------------- | ------------- | -------------
|
898
|
+
**timecard_id** | **String**| TThe ID of the timecard to modify. |
|
899
|
+
**body** | [**V1Timecard**](V1Timecard.md)| An object containing the fields to POST for the request. See the corresponding object definition for field details. |
|
900
|
+
|
901
|
+
### Return type
|
902
|
+
|
903
|
+
[**V1Timecard**](V1Timecard.md)
|
904
|
+
|
905
|
+
### Authorization
|
906
|
+
|
907
|
+
[oauth2](../README.md#oauth2)
|
908
|
+
|
909
|
+
### HTTP request headers
|
910
|
+
|
911
|
+
- **Content-Type**: application/json
|
912
|
+
- **Accept**: application/json
|
913
|
+
|
914
|
+
|
915
|
+
|