Fatura do Tesseron (versão prévia)
Esse conector permite que você use a Fatura do Tesseron para criar e pesquisar atribuições de serviço e notas de posição.
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 | Suporte ao Tesseron |
| URL | https://www.docs.tesseron.de |
| development@llnet.de |
| Metadados do conector | |
|---|---|
| Publicador | Tesseron por Luithle + Luithle GmbH |
| Site | https://www.tesseron.de |
| Política de privacidade | https://www.llnet.de/data-protection/ |
| Categorias | Operações de TI; Comunicação |
Esse conector permite que você crie e pesquise atribuições de serviço, anotações de posição e gravações de atividade em sua Instância do Tesseron. Integre o Tesseron aos seus fluxos e automatize seus processos de negócios.
Pré-requisitos
Você precisará do seguinte para continuar:
- Uma instância do Tesseron
- Um usuário licenciado do Tesseron
- Uma chave de API (Serviço: Fatura)
Obtendo credenciais
A autenticação é feita por meio de uma chave de API. Forneça a chave de API e os parâmetros de conexão da URL da instância.
Operações com suporte
O conector dá suporte às seguintes operações:
- Obter Atribuições de Serviço: recupere todas as posições de atribuição de serviço para os filtros especificados.
- Criar Gravação de Atividade: criar uma nova gravação de atividade.
- Criar Nota de Posição da Fatura: crie uma nova nota de posição.
Instruções de implantação
Como a API Rest do Tesseron usa chaves de API para validar o usuário, primeiro você precisa entrar em contato com o administrador do sistema para criar uma chave de API para o usuário. Depois que isso for concluído, você poderá criar sua conexão do Tesseron.
Verifique os direitos do usuário Com esse conector, você poderá executar ações de ativo em sua instância do Tesseron. Portanto, você precisa ter os direitos de usuário obrigatórios.
Aplique-se à chave de API atualmente, as chaves de API só podem ser criadas pelo administrador do sistema. Portanto, solicite sua chave de API do administrador do sistema.
Criar uma nova conexão
- Fornecer a URL da instância do Tesseron
- Insira sua chave de API do Tesseron
Problemas e limitações conhecidos
- Direitos de usuário suficientes são obrigatórios.
Erros e soluções comuns
perguntas frequentes
Há algum custo extra usando esse conector? Não
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 |
|---|---|---|---|
| URL da Instância | cadeia | URL da instância do Tesseron | Verdade |
| API-Key | secureString | Seu API-Key do Tesseron (Serviço: Tíquete) | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Criar novas notas de posição |
Criar novas notas de posição |
| Criar novos registros de atividade |
Criar novos registros de atividade |
| Solicitar atribuições de serviço |
Solicitar atribuições de serviço |
Criar novas notas de posição
Criar novas notas de posição
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Data de
|
dateFrom | True | string |
Especifique uma data de início. |
|
Data para
|
dateTo | True | string |
Especifique uma data de término. |
|
Pausa
|
pause | integer |
Especifique a duração da pausa em minutos. |
|
|
Nenhuma factura?
|
noInvoice | boolean |
Especifique o wheter em que a nota de posição é faturável. |
|
|
Cobrança extra?
|
extraCharge | boolean |
Especifique que os encargos extras do wheter devem ser cobrados. |
|
|
Hint
|
hint | string |
Especifique uma dica de cobrança. |
|
|
ID do Cotrato de Serviço
|
serviceContractId | string |
Especifique um contrato de serviço. |
|
|
Utilizador
|
userName | string |
Especifique um nome de usuário. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da Anotação de Posição
|
invoiceNoteId | string |
Especifica o identificador exclusivo da nota de posição criada. |
|
Message
|
message | string |
mensagem |
|
Êxito
|
success | boolean |
sucesso |
Criar novos registros de atividade
Criar novos registros de atividade
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Data de
|
dateFrom | True | string |
Especifique a data de início. |
|
Quantidade
|
quantity | string |
Especifique a quantidade. |
|
|
Data para
|
dateTo | string |
Especifique a data de término. |
|
|
Texto do Livro
|
bookText | string |
Especifique um texto de reserva. |
|
|
Texto da Observação
|
noteText | string |
Especifique um texto de anotação. |
|
|
ID do projeto
|
projectId | integer |
Especifique um projeto. |
|
|
ID da fase do projeto
|
projectPhaseId | integer |
Especifique uma fase do projeto. |
|
|
ID do tíquete
|
ticketid | integer |
Especifique um tíquete. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Message
|
Message | string |
Message |
|
Êxito
|
Success | boolean |
Êxito |
|
ID de gravação de atividade
|
ActivityRecordingId | string |
ActivityRecordingId |
Solicitar atribuições de serviço
Solicitar atribuições de serviço
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ignorar
|
Skip | True | integer |
Especifique quantos assignemts devem ser ignorados. |
|
Pesquisa
|
Search | string |
Especifique uma cadeia de caracteres de pesquisa. |
|
|
Colunas de Pedidos
|
OrderColumns | integer |
Especifique a ordem das colunas. |
|
|
Oder em ascensão?
|
OrderByAsc | boolean |
Especifique o wheter que você deseja ordenar que seus resultados sejam crescentes. |
|
|
Levar tudo?
|
TakeAll | boolean |
Especifique o wheter que você deseja receber todas as posioções de atribuição. |
|
|
Datetime de
|
DateTimeFrom | True | string |
Especifique a data de início. |
|
Datetime para
|
DateTimeTo | True | string |
Especifique a data de término. |
|
Quantidade de
|
QuantityFrom | float |
Especifique a quantidade mínima. |
|
|
Quantidade para
|
QuantityTo | float |
Especifique a quantidade máxima. |
|
|
IDs de usuário
|
UserIds | array of integer |
Especifique as IDs de usuário. |
|
|
ServiceArticles
|
ServiceArticles | array of string |
Especifique os artigos. |
|
|
Status ID
|
AssignmentStatusId | integer |
Especifique a ID de status. |
|
|
IsInvoice
|
IsInvoice | boolean |
Especifique o tipo de cobrança. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
mensagem
|
message | string |
mensagem |
|
Results
|
result.Results | array of object |
Results |
|
ID da atribuição
|
result.Results.AssignmentId | string |
O identificador exclusivo da atribuição. |
|
Número da atribuição
|
result.Results.AssignmentNumber | string |
O número exclusivo da atribuição. |
|
Texto da atribuição
|
result.Results.AssignmentText | string |
A descrição da atribuição. |
|
Texto de posição
|
result.Results.AssignmentPositionText | string |
A descrição da posição da atribuição. |
|
Atribuição de
|
result.Results.MinAssignmentTime | string |
A hora de início da posição de atribuição. |
|
Atribuição para
|
result.Results.MaxAssignmentTime | string |
A hora de término da posição da atribuição. |
|
Minutos
|
result.Results.PositionsUnits.Minutes | integer |
A duração da posição da atribuição em minutos. |
|
Quantidade
|
result.Results.PositionsUnits.Quantity | float |
A quantidade da posição de atribuição com base na configuração do artigo. |
|
Minutos (no-facutra)
|
result.Results.PositionsUnits.MinutesNoInvoice | integer |
A duração dos esforços não factura da psotion de atribuição em minutos. |
|
Quantidade (no-facutra)
|
result.Results.PositionsUnits.QuantityNoInvoice | integer |
A quantidade de esforços não factura da posição de atribuição com base na configuração do artigo. |
|
Pausa
|
result.Results.PositionsUnits.Pause | integer |
A duração da quebra. |
|
ID do Usuário
|
result.Results.UserInfo.UserId | integer |
O identificador exclusivo do usuário. |
|
Nome do usuário
|
result.Results.UserInfo.UserName | string |
O nome do usuário. |
|
ID do engenheiro
|
result.Results.UserInfo.EngineerId | integer |
A ID do engenheiro do usuário. |
|
Data de Criação
|
result.Results.CreationDate | string |
A data de criação da atribuição. |
|
Data da alteração
|
result.Results.AlterationDate | string |
A data de alteração da atribuição. |
|
Data do serviço
|
result.Results.ServiceDate | string |
A data de término da última posição de atribuição. |
|
Tipo de atribuição
|
result.Results.AssignmentTypeName | string |
Especifica o tipo de atribuição. |
|
Situação
|
result.Results.Status | integer |
Especifica o status da atribuição. |
|
ID do tíquete
|
result.Results.TicketInfo.TicketId | integer |
O identificador exclusivo do tíquete. |
|
Número do Tíquete
|
result.Results.TicketInfo.TicketNumber | string |
O número exclusivo do tíquete. |
|
Cabeçalho de tíquete
|
result.Results.TicketInfo.TicketHead | string |
O cabeçalho do tíquete. |
|
ID da empresa
|
result.Results.TicketInfo.EnterpriseId | integer |
O identificador exclusivo da empresa principal do tíquete. |
|
Nome da empresa
|
result.Results.TicketInfo.EnterpriseName | string |
O nome principal da empresa principal do tíquete. |
|
ID da área
|
result.Results.TicketInfo.AreaId | integer |
O identificador exclusivo da área do tíquete. |
|
ID do contrato de serviço de tíquete
|
result.Results.TicketInfo.ServiceContractID | string |
O identificador exclusivo do contrato de serviço de tíquete. |
|
Data de Encerramento
|
result.Results.TicketInfo.ClosedDate | string |
A data de fechamento do tíquete. |
|
Projeto
|
result.Results.Project | string |
O projeto de atribuição. |
|
ID do contrato de serviço
|
result.Results.ServiceContract.ServiceContractId | integer |
O identificador exclusivo do contrato de serviço. |
|
Nome do contrato de serviço
|
result.Results.ServiceContract.ServiceContractName | string |
O nome do contrato de serviço. |
|
No Factura
|
result.Results.NoInvoice | boolean |
Especifica se a atribuição é faturável. |
|
Nenhuma razão de Factura
|
result.Results.NoInvoiceReason | string |
Especifica o motivo se a atribuição não for faturável. |
|
ID do artigo
|
result.Results.ArticleInfo.InvoiceArticleId | integer |
O identificador exclusivo do artigo. |
|
Número do artigo
|
result.Results.ArticleInfo.ArticleNumber | string |
O número do artigo. |
|
Nome do artigo
|
result.Results.ArticleInfo.ArticleName | string |
O nome do artigo. |
|
Contagem
|
result.Count | integer |
Especifica a contagem de posições de atribuição. |
|
Filtered
|
result.Filtered | integer |
Especifica quantas posições de atribuição foram filtradas. |
|
Próprios horários
|
result.OwnHours | integer |
Especifica quantas horas foram criadas pelos usuários solicitantes. |
|
Total de Horas
|
result.TotalHours | integer |
Especifica o valor total. |