Tempo de QuickBooks (Editor Independente) (versão prévia)
Conector para ler dados do QuickBooks Time. O QuickBooks Time anteriormente conhecido como TSheets é um aplicativo de acompanhamento de tempo móvel e baseado na Web e de agendamento de funcionários. O serviço foi acessado por meio de um navegador da Web ou de um aplicativo móvel. TSheets era uma alternativa a um quadro de horários de papel ou cartões de soco.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Artesian Software Technologies LLP |
| URL | https://artesian.io |
| amit.sharma@artesian.io |
| Metadados do conector | |
|---|---|
| Publicador | Artesian Software Technologies LLP |
| Site | https://quickbooks.intuit.com/time-tracking/ |
| Política de Privacidade | https://www.intuit.com/privacy/ |
| Categorias | Recursos humanos; Produtividade |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID do cliente – Sua ID de cliente do QuickBooks | cadeia | Insira a ID do cliente. | Verdade |
| Segredo de Cliente | secureString | Insira o segredo do cliente. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Recuperar códigos de trabalho |
Recupera uma lista de todos os códigos de trabalho associados à sua empresa, com filtros opcionais para restringir os resultados. |
| Recuperar Notificações |
Recupera uma lista de notificações associadas à sua empresa, com filtros para restringir os resultados. |
| Recuperar projetos |
Recupera uma lista de projetos, com filtros opcionais para restringir os resultados. |
| Recuperar quadros de horários |
Recupera uma lista de todos os quadros de horários associados à sua empresa, com filtros para restringir os resultados. |
| Recuperar usuários |
Recupera uma lista de todos os usuários associados à sua empresa, com filtros opcionais para restringir os resultados. |
Recuperar códigos de trabalho
Recupera uma lista de todos os códigos de trabalho associados à sua empresa, com filtros opcionais para restringir os resultados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
IDs de código de trabalho
|
ids | string |
Lista separada por vírgulas de uma ou mais IDs de código de trabalho |
|
|
IDs pai
|
parent_ids | string |
Lista separada por vírgulas de um ou mais parent_ids de código de trabalho |
|
|
Nome
|
name | string |
Inicia a correspondência desde o início da cadeia de caracteres. |
|
|
Tipo
|
type | string |
Um de 'regular', 'pto', 'paid_break', 'unpaid_break' ou 'all'. O padrão é "regular". |
|
|
Campos personalizados
|
customfields | boolean |
verdadeiro ou falso |
|
|
Modificado antes
|
modified_before | string |
no formato ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm) |
|
|
Modificado desde
|
modified_since | string |
no formato ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). |
|
|
Dados complementares
|
supplemental_data | string |
Indica se os dados complementares devem ser retornados. |
|
|
Por Página
|
per_page | integer |
Representa quantos resultados você gostaria de recuperar por solicitação. |
|
|
Página
|
page | integer |
Representa a página de resultados que você gostaria de recuperar. |
|
|
Active
|
active | string |
"Sim", "não" ou "ambos". |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
códigos de trabalho
|
results.jobcodes | object |
códigos de trabalho |
|
more
|
more | boolean |
more |
Recuperar Notificações
Recupera uma lista de notificações associadas à sua empresa, com filtros para restringir os resultados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ids
|
ids | string |
Lista separada por vírgulas de uma ou mais IDs de notificação em que você gostaria de filtrar |
|
|
Entrega antes
|
delivery_before | string |
no formato ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm) |
|
|
Entrega após
|
delivery_after | string |
no formato ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm) |
|
|
ID do Usuário
|
user_id | integer |
Somente as notificações vinculadas a essa ID de usuário serão retornadas |
|
|
ID de Acompanhamento de Msg
|
msg_tracking_id | string |
Acompanhando a cadeia de caracteres de ID de uma notificação. Somente a notificação com esse msg_tracking_id será retornada. |
|
|
Por Página
|
per_page | integer |
Representa quantos resultados você gostaria de recuperar por solicitação |
|
|
Página
|
page | integer |
Representa a página de resultados que você gostaria de recuperar |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
notificações
|
results.notifications | object |
notificações |
|
more
|
results.more | boolean |
more |
Recuperar projetos
Recupera uma lista de projetos, com filtros opcionais para restringir os resultados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ids
|
ids | string |
Lista separada por vírgulas de IDs do projeto. |
|
|
IDs de código de trabalho
|
jobcode_ids | string |
Lista separada por vírgulas de IDs de código de trabalho associadas a um projeto. |
|
|
ID do Código de Trabalho Pai
|
parent_jobcode_id | integer |
ID do pai de um código de trabalho do projeto a ser usada para filtragem |
|
|
Nome
|
name | string |
Inicia a correspondência desde o início da cadeia de caracteres |
|
|
Active
|
active | string |
"Sim", "não" ou "ambos". O padrão é "sim". |
|
|
Por atribuição de código de trabalho
|
by_jobcode_assignment | boolean |
Se especificado, somente projetos com um jobcode_id ao qual o usuário é atribuído serão retornados |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
projects
|
results.projects | object |
projects |
|
códigos de trabalho
|
supplemental_data.jobcodes | object |
códigos de trabalho |
|
more
|
more | boolean |
more |
Recuperar quadros de horários
Recupera uma lista de todos os quadros de horários associados à sua empresa, com filtros para restringir os resultados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ids
|
ids | string |
Lista separada por vírgulas de uma ou mais IDs de quadro de horários em que você gostaria de filtrar. |
|
|
Data de Início
|
start_date | string |
YYYY-MM-DD data formatada. Todos os quadros de horários com uma data caindo ou após essa data serão retornados. |
|
|
Data de Término
|
end_date | string |
YYYY-MM-DD data formatada. Todos os quadros de horários com uma data caindo ou antes dessa data serão retornados. |
|
|
IDs de código de trabalho
|
jobcode_ids | string |
Uma cadeia de caracteres separada por vírgulas de IDs de código de trabalho. |
|
|
IDs de folha de pagamento
|
payroll_ids | string |
Uma cadeia de caracteres separada por vírgulas de IDs de folha de pagamento. |
|
|
IDs de usuário
|
user_ids | string |
Uma lista separada por vírgulas de IDs de usuário. |
|
|
IDs de grupo
|
group_ids | string |
Uma lista separada por vírgulas de IDs de grupo. |
|
|
No relógio
|
on_the_clock | string |
"Sim", "não" ou "ambos". O padrão é 'no |
|
|
Tipo de código de trabalho
|
jobcode_type | string |
Somente quadros de horários vinculados a um código de trabalho do tipo fornecido são retornados. |
|
|
Modificado antes
|
modified_before | string |
no formato ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm) |
|
|
Modificado desde
|
modified_since | string |
Somente quadros de horários modificados desde essa data/hora serão retornados, no formato ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). |
|
|
Dados complementares
|
supplemental_data | string |
Sim" ou "não". O padrão é "sim". Indica se os dados complementares devem ser retornados. |
|
|
Por Página
|
per_page | integer |
Representa quantos resultados você gostaria de recuperar por solicitação. |
|
|
Página
|
page | integer |
Representa a página de resultados que você gostaria de recuperar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
quadros de horários
|
results.timesheets | object |
quadros de horários |
|
more
|
more | boolean |
more |
|
códigos de trabalho
|
supplemental_data.jobcodes | object |
códigos de trabalho |
|
users
|
supplemental_data.users | object |
users |
|
campos personalizados
|
supplemental_data.customfields | object |
campos personalizados |
|
arquivos
|
supplemental_data.files | object |
arquivos |
Recuperar usuários
Recupera uma lista de todos os usuários associados à sua empresa, com filtros opcionais para restringir os resultados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ids
|
ids | string |
Lista separada por vírgulas de uma ou mais IDs de usuário nas quais você gostaria de filtrar |
|
|
Não IDs
|
not_ids | string |
Lista separada por vírgulas das IDs de usuário que você gostaria de excluir. |
|
|
Números de funcionários
|
employee_numbers | string |
Lista separada por vírgulas de um ou mais números de funcionários em que você gostaria de filtrar. |
|
|
Nomes de usuário
|
usernames | string |
Lista separada por vírgulas de um ou mais nomes de usuário que você gostaria de filtrar. |
|
|
IDs de grupo
|
group_ids | string |
Lista separada por vírgulas de uma ou mais IDs de grupo em que você gostaria de filtrar. |
|
|
Não IDs de grupo
|
not_group_ids | string |
Lista separada por vírgulas das IDs de grupo que você gostaria de excluir. |
|
|
IDs de folha de pagamento
|
payroll_ids | string |
Uma cadeia de caracteres separada por vírgulas de IDs de folha de pagamento. Somente os usuários com essas IDs de folha de pagamento serão retornados. |
|
|
Active
|
active | string |
"Sim", "não" ou "ambos". O padrão é "sim". |
|
|
Primeiro Nome
|
first_name | string |
Inicia a correspondência desde o início da cadeia de caracteres. |
|
|
Apelido
|
last_name | string |
Inicia a correspondência desde o início da cadeia de caracteres. |
|
|
Modificado antes
|
modified_before | string |
no formato ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). |
|
|
Modificado desde
|
modified_since | string |
no formato ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). |
|
|
Dados complementares
|
supplemental_data | string |
Sim" ou "não". O padrão é "sim". Indica se os dados complementares devem ser retornados. |
|
|
Por Página
|
per_page | integer |
Representa quantos resultados você gostaria de recuperar por solicitação |
|
|
Página
|
page | integer |
Representa a página de resultados que você gostaria de recuperar |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
users
|
results.users | object |
users |
|
more
|
more | boolean |
more |
|
códigos de trabalho
|
supplemental_data.jobcodes | object |
códigos de trabalho |
|
groups
|
supplemental_data.groups | object |
groups |