QuickBooks Time （獨立發行商） （預覽版）
從 QuickBooks Time 讀取數據的連接器。 QuickBooks Time，以前稱為 TSheets，是一款基於網絡的移動時間跟踪和員工調度應用程序。 該服務是通過網絡瀏覽器或移動應用程序訪問的。 TSheets 是紙質時間表或打孔卡的替代品。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | 自流軟件技術有限責任公司 |
| URL | https://artesian.io |
| amit.sharma@artesian.io |
| 連接器中繼資料 | |
|---|---|
| Publisher | 自流軟件技術有限責任公司 |
| 網站 | https://quickbooks.intuit.com/time-tracking/ |
| 隱私權原則 | https://www.intuit.com/privacy/ |
| 類別 | 人力資源;生產力 |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 客戶端 ID - 您的 QuickBooks clientId | 字串 | 請輸入客戶端 ID。 | 對 |
| 用戶端密碼 | securestring | 請輸入客戶端密碼。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 擷取使用者 |
擷取與貴公司相關聯之所有使用者的清單，並使用可選的篩選器來縮小結果範圍。 |
| 擷取專案 |
擷取專案清單，並使用選用篩選器來縮小結果範圍。 |
| 擷取工作代碼 |
擷取與貴公司相關聯的所有工作代碼清單，並使用可選的篩選器來縮小結果範圍。 |
| 擷取時程表 |
擷取與貴公司相關聯的所有時程表清單，並使用篩選器來縮小結果範圍。 |
| 擷取通知 |
擷取與貴公司相關聯的通知清單，並使用篩選器來縮小結果範圍。 |
擷取使用者
擷取與貴公司相關聯之所有使用者的清單，並使用可選的篩選器來縮小結果範圍。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
標識
|
ids | string |
以逗號分隔的清單，列出您要篩選的一或多個使用者 ID |
|
|
不是 ID
|
not_ids | string |
您要排除的使用者 ID 的逗號分隔清單。 |
|
|
員工人數
|
employee_numbers | string |
您要篩選的一或多個員工號碼的逗號分隔清單。 |
|
|
用戶名
|
usernames | string |
您要篩選的一或多個使用者名稱的逗號分隔清單。 |
|
|
群組識別碼
|
group_ids | string |
您要篩選的一或多個群組 ID 的逗號分隔清單。 |
|
|
非群組識別碼
|
not_group_ids | string |
您要排除的群組 ID 的逗號分隔清單。 |
|
|
薪資識別碼
|
payroll_ids | string |
以逗號分隔的薪資識別碼字串。 只有具有這些薪資 ID 的使用者才會被傳回。 |
|
|
Active
|
active | string |
“是”、“否”或“兩者”。 預設值為「是」。 |
|
|
名字
|
first_name | string |
從字串的開頭開始比對。 |
|
|
姓氏
|
last_name | string |
從字串的開頭開始比對。 |
|
|
修改之前
|
modified_before | string |
ISO 8601 格式 （YYYY-MM-DDThh：mm：ss±hh：mm）。 |
|
|
修改時間
|
modified_since | string |
ISO 8601 格式 （YYYY-MM-DDThh：mm：ss±hh：mm）。 |
|
|
補充數據
|
supplemental_data | string |
是“或”否“。 預設值為「是」。 指出是否應該傳回補充資料。 |
|
|
每頁
|
per_page | integer |
代表您想要在每個請求擷取多少個結果 |
|
|
頁面
|
page | integer |
代表您要擷取的結果頁面 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
users
|
results.users | object |
users |
|
more
|
more | boolean |
more |
|
工作代碼
|
supplemental_data.jobcodes | object |
工作代碼 |
|
groups
|
supplemental_data.groups | object |
groups |
擷取專案
擷取專案清單，並使用選用篩選器來縮小結果範圍。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
標識
|
ids | string |
以逗號分隔的專案識別碼清單。 |
|
|
工作代碼識別碼
|
jobcode_ids | string |
與專案相關聯的工作代碼 ID 以逗點分隔的清單。 |
|
|
母項工作代碼 ID
|
parent_jobcode_id | integer |
用於篩選的專案工作代碼父系 ID |
|
|
名稱
|
name | string |
從字串的開頭開始比對 |
|
|
Active
|
active | string |
“是”、“否”或“兩者”。 預設值為「是」。 |
|
|
依工作代碼指派
|
by_jobcode_assignment | boolean |
如果指定，則只會傳回具有指派使用者的jobcode_id的專案 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
projects
|
results.projects | object |
projects |
|
工作代碼
|
supplemental_data.jobcodes | object |
工作代碼 |
|
more
|
more | boolean |
more |
擷取工作代碼
擷取與貴公司相關聯的所有工作代碼清單，並使用可選的篩選器來縮小結果範圍。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
工作代碼識別碼
|
ids | string |
一或多個工作碼 ID 的逗點分隔清單 |
|
|
父 ID
|
parent_ids | string |
一或多個工作代碼parent_ids的逗點分隔清單 |
|
|
名稱
|
name | string |
從字串的開頭開始比對。 |
|
|
類型
|
type | string |
“常規”、“pto”、“paid_break”、“unpaid_break”或“全部”之一。 預設值為「一般」。 |
|
|
自訂欄位
|
customfields | boolean |
真或假 |
|
|
修改之前
|
modified_before | string |
ISO 8601 格式 （YYYY-MM-DDThh：mm：ss±hh：mm） |
|
|
修改時間
|
modified_since | string |
ISO 8601 格式 （YYYY-MM-DDThh：mm：ss±hh：mm）。 |
|
|
補充數據
|
supplemental_data | string |
指出是否應該傳回補充資料。 |
|
|
每頁
|
per_page | integer |
代表您想要每個要求擷取的結果數目。 |
|
|
頁面
|
page | integer |
代表您要擷取的結果頁面。 |
|
|
Active
|
active | string |
“是”、“否”或“兩者”。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
工作代碼
|
results.jobcodes | object |
工作代碼 |
|
more
|
more | boolean |
more |
擷取時程表
擷取與貴公司相關聯的所有時程表清單，並使用篩選器來縮小結果範圍。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
標識
|
ids | string |
您要篩選的一或多個時程表識別碼的逗點分隔清單。 |
|
|
開始日期
|
start_date | string |
YYYY-MM-DD 格式化的日期。 任何日期在此日期或之後的時間表都會被傳回。 |
|
|
結束日期
|
end_date | string |
YYYY-MM-DD 格式化的日期。 任何日期在此日期或之前的時間表都會傳回。 |
|
|
工作代碼識別碼
|
jobcode_ids | string |
以逗號分隔的工作代碼 ID 字串。 |
|
|
薪資識別碼
|
payroll_ids | string |
以逗號分隔的薪資識別碼字串。 |
|
|
使用者 ID
|
user_ids | string |
以逗點分隔的使用者 ID 清單。 |
|
|
群組識別碼
|
group_ids | string |
以逗號分隔的群組識別碼清單。 |
|
|
在時鐘上
|
on_the_clock | string |
“是”、“否”或“兩者”。 預設值為「否」 |
|
|
工作代碼類型
|
jobcode_type | string |
只會傳回連結至指定類型之工作代碼的時程表。 |
|
|
修改之前
|
modified_before | string |
ISO 8601 格式 （YYYY-MM-DDThh：mm：ss±hh：mm） |
|
|
修改時間
|
modified_since | string |
只會傳回自此日期/時間以來修改的時程表，格式為 ISO 8601 格式 （YYYY-MM-DDThh：mm：ss±hh：mm）。 |
|
|
補充數據
|
supplemental_data | string |
是“或”否“。 預設值為「是」。 指出是否應該傳回補充資料。 |
|
|
每頁
|
per_page | integer |
代表您想要每個要求擷取的結果數目。 |
|
|
頁面
|
page | integer |
代表您要擷取的結果頁面。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
時程表
|
results.timesheets | object |
時程表 |
|
more
|
more | boolean |
more |
|
工作代碼
|
supplemental_data.jobcodes | object |
工作代碼 |
|
users
|
supplemental_data.users | object |
users |
|
自訂欄位
|
supplemental_data.customfields | object |
自訂欄位 |
|
files
|
supplemental_data.files | object |
files |
擷取通知
擷取與貴公司相關聯的通知清單，並使用篩選器來縮小結果範圍。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
標識
|
ids | string |
您要篩選的一或多個通知識別碼的逗點分隔清單 |
|
|
交貨前
|
delivery_before | string |
ISO 8601 格式 （YYYY-MM-DDThh：mm：ss±hh：mm） |
|
|
交貨時間
|
delivery_after | string |
ISO 8601 格式 （YYYY-MM-DDThh：mm：ss±hh：mm） |
|
|
使用者識別碼
|
user_id | integer |
只會傳回連結至此使用者 ID 的通知 |
|
|
訊息追蹤 ID
|
msg_tracking_id | string |
通知的追蹤 ID 字串。 只會傳回帶有此msg_tracking_id的通知。 |
|
|
每頁
|
per_page | integer |
代表您想要在每個請求擷取多少個結果 |
|
|
頁面
|
page | integer |
代表您要擷取的結果頁面 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
通知
|
results.notifications | object |
通知 |
|
more
|
results.more | boolean |
more |