QuickBooks Time (Editora Independente) (Pré-visualização)
Conector para ler dados do QuickBooks Time. O QuickBooks Time, anteriormente conhecido como TSheets, é um aplicativo de rastreamento de tempo e agendamento de funcionários baseado na Web e móvel. O serviço foi acessado por meio de um navegador da Web ou de um aplicativo móvel. O TSheets era uma alternativa a uma folha de ponto em papel ou cartões perfurados.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 | |
|---|---|
| Editora | Artesian Software Technologies LLP |
| Sítio Web | https://quickbooks.intuit.com/time-tracking/ |
| Política de Privacidade | https://www.intuit.com/privacy/ |
| Categorias | Recursos Humanos; Produtividade |
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 - Seu cliente QuickBooks clientId | cadeia (de caracteres) | Introduza o ID do cliente. | Verdade |
| Segredo do Cliente | securestring | Introduza o segredo do cliente. | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Recuperar Jobcodes |
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 Jobcodes
Recupera uma lista de todos os códigos de trabalho associados à sua empresa, com filtros opcionais para restringir os resultados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ids de código de trabalho
|
ids | string |
Lista separada por vírgulas de uma ou mais ids de jobcode |
|
|
IDs pai
|
parent_ids | string |
Lista separada por vírgulas de um ou mais parent_ids jobcode |
|
|
Nome
|
name | string |
Começa a corresponder desde o início da cadeia de caracteres. |
|
|
Tipo
|
type | string |
Um de 'regular', 'pto', 'paid_break', 'unpaid_break', ou 'todos'. O padrão é 'regular'. |
|
|
Campos personalizados
|
customfields | boolean |
verdadeiro ou falso |
|
|
Modificado antes
|
modified_before | string |
no formato ISO 8601 (AAAA-MM-DDThh:mm:ss±hh:mm) |
|
|
Modificado desde
|
modified_since | string |
no formato ISO 8601 (AAAA-MM-DDThh:mm:ss±hh:mm). |
|
|
Dados suplementares
|
supplemental_data | string |
Indica se os dados suplementares 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». |
Devoluções
| Name | 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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ids
|
ids | string |
Lista separada por vírgulas de um ou mais IDs de notificação que você deseja filtrar |
|
|
Entrega Antes
|
delivery_before | string |
no formato ISO 8601 (AAAA-MM-DDThh:mm:ss±hh:mm) |
|
|
Entrega Após
|
delivery_after | string |
no formato ISO 8601 (AAAA-MM-DDThh:mm:ss±hh:mm) |
|
|
ID de utilizador
|
user_id | integer |
Apenas as notificações associadas a este ID de utilizador serão devolvidas |
|
|
ID de rastreamento da mensagem
|
msg_tracking_id | string |
Cadeia de caracteres de ID de acompanhamento de uma notificação. Apenas a notificação com este msg_tracking_id será devolvida. |
|
|
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 |
Devoluções
| Name | 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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ids
|
ids | string |
Lista de ids de projeto separada por vírgula. |
|
|
Ids de código de trabalho
|
jobcode_ids | string |
Lista separada por vírgulas de ids de jobcode associadas a um projeto. |
|
|
ID do código de trabalho pai
|
parent_jobcode_id | integer |
Id do pai de um jobcode de projeto a ser usado para filtragem |
|
|
Nome
|
name | string |
Começa a corresponder desde o início da cadeia de caracteres |
|
|
Active
|
active | string |
«Sim», «Não» ou «ambos». O padrão é 'sim'. |
|
|
Por atribuição de Jobcode
|
by_jobcode_assignment | boolean |
Se especificado, somente os projetos com um jobcode_id ao qual o usuário está atribuído serão retornados |
Devoluções
| Name | 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
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ids
|
ids | string |
Lista separada por vírgulas de uma ou mais ids de quadro de horários que você deseja filtrar. |
|
|
Data de início
|
start_date | string |
AAAA-MM-DD data formatada. Todos os quadros de horários com uma data que caia nessa data ou após essa data serão devolvidos. |
|
|
Data de fim
|
end_date | string |
AAAA-MM-DD data formatada. Quaisquer quadros de horários com uma data que caia em ou antes dessa data serão devolvidos. |
|
|
Ids de código de trabalho
|
jobcode_ids | string |
Uma cadeia de caracteres separada por vírgulas de ids de jobcode. |
|
|
Ids da folha de pagamento
|
payroll_ids | string |
Uma cadeia de caracteres separada por vírgulas de ids da 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 é 'não |
|
|
Tipo de código de trabalho
|
jobcode_type | string |
Somente quadros de horários vinculados a um código de trabalho do tipo determinado são retornados. |
|
|
Modificado antes
|
modified_before | string |
no formato ISO 8601 (AAAA-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 (AAAA-MM-DDThh:mm:ss±hh:mm). |
|
|
Dados suplementares
|
supplemental_data | string |
sim" ou "não". O padrão é 'sim'. Indica se os dados suplementares 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. |
Devoluções
| Name | 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 |
|
files
|
supplemental_data.files | object |
files |
Recuperar usuários
Recupera uma lista de todos os usuários associados à sua empresa, com filtros opcionais para restringir os resultados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Ids
|
ids | string |
Lista separada por vírgulas de um ou mais IDs de usuário que você gostaria de filtrar |
|
|
Não Ids
|
not_ids | string |
Lista separada por vírgulas dos IDs de usuário que você deseja excluir. |
|
|
Número de funcionários
|
employee_numbers | string |
Lista separada por vírgulas de um ou mais números de funcionários que você gostaria de filtrar. |
|
|
Nomes de utilizador
|
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 que você deseja filtrar. |
|
|
Não Ids de grupo
|
not_group_ids | string |
Lista separada por vírgulas das ids de grupo que pretende excluir. |
|
|
Ids da folha de pagamento
|
payroll_ids | string |
Uma cadeia de caracteres separada por vírgulas de ids da folha de pagamento. Somente usuários com esses IDs de folha de pagamento serão retornados. |
|
|
Active
|
active | string |
«Sim», «Não» ou «ambos». O padrão é 'sim'. |
|
|
Nome Próprio
|
first_name | string |
Começa a corresponder desde o início da cadeia de caracteres. |
|
|
Apelido
|
last_name | string |
Começa a corresponder desde o início da cadeia de caracteres. |
|
|
Modificado antes
|
modified_before | string |
no formato ISO 8601 (AAAA-MM-DDThh:mm:ss±hh:mm). |
|
|
Modificado desde
|
modified_since | string |
no formato ISO 8601 (AAAA-MM-DDThh:mm:ss±hh:mm). |
|
|
Dados suplementares
|
supplemental_data | string |
sim" ou "não". O padrão é 'sim'. Indica se os dados suplementares 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 |
Devoluções
| Name | 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 |