Compartilhar via


Dados básicos do Tesseron (versão prévia)

Esse conector permite que você use o Tíquete do Tesseron para criar, editar e pesquisar tíquetes.

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
Email 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ê use as principais funções de dados básicas no Tesseron. Crie, atualize e recupere todas as informações de seus parceiros de negócios e contatos. 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: BasicData)

Obter credenciais

Solicite sua chave de API do seu parceiro ou administrador do sistema.

Operações com suporte

O conector dá suporte às seguintes operações:

  • Criar empresa: adicionar um novo parceiro de negócios
  • Atualizar Empresa: atualizar um parceiro de negócios existente
  • Obter empresas: receber uma lista de parceiros de negócios
  • Criar Contato: Adicionar um novo contato
  • Atualizar Contato: Atualizar um contato existente
  • Obter Contatos: Receber uma lista de contatos

Introdução ao conector

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 ASM do Tesseron.

  1. Verifique os direitos do usuário Com esse conector, você poderá executar ações de tíquete na instância do ASM do Tesseron. Portanto, você precisa ter os direitos de usuário obrigatórios nas áreas necessárias (pelo menos editor).

  2. 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.

  3. Criar uma nova conexão

    • Fornecer a URL da instância do Tesseron
    • Insira sua chave de API do Tesseron

Forneça aos usuários um processo passo a passo para começar a usar o conector. É aí que você deve realçar casos de uso comuns, como seus gatilhos e ações populares esperados, e como eles podem ajudar em cenários de automação. Inclua imagens sempre que possível.

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 tesseron API-Key (Serviço: BasicData) Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Adicionar um novo contato

Adicionar um novo contato

Adicionar um novo parceiro de negócios

Adicionar um novo parceiro de negócios

Atualizar o status de um parceiro de negócios existente

Atualizar o status de um parceiro de negócios existente

Atualizar um parceiro de negócios existente

Atualizar um parceiro de negócios existente

Obter uma lista de contatos

Obter uma lista de contatos

Obter uma lista de parceiros de negócios

Obter uma lista de parceiros de negócios

UpdateContact

UpdateContact

Adicionar um novo contato

Adicionar um novo contato

Parâmetros

Nome Chave Obrigatório Tipo Description
Número de referência da empresa
EnterpriseReferenceNumber True string

Especifique um número de referência da empresa.

Title
Title string

Especifique um título.

Formulário de endereço
formOfAddress string

Especifique uma forma de endereço.

Primeiro Nome
foreName True string

Especifique um nome.

Segundo Nome
foreName2 string

Especifique um segundo nome.

Surname
surName True string

Especifique um sobrenome.

Nome de pesquisa
searchname string

Especifique um nome de pesquisa.

Número Externo
externalNumber string

Especifique um identificador externo.

Initials
Initials string

Especifique as iniciais.

Memorando
memo string

Especifique um memorando.

Informações do tíquete
InfoOnTicketView string

Especifique uma informação de tíquete.

Informações da fatura
InfoOnServiceAssignment string

Especifique as informações de uma fatura.

Informações do Assistente de Tíquete
InfoOnTicketCreate string

Especifique as informações do assistente de tíquete.

Departamento
departmentName string

Especifique um nome de departamento.

O Vip?
IsVip boolean

Especifique se o contato é um VIP?

Tipo de contato
enterpriseContactType integer

Especifique um tipo de contato.

Usar o Endereço do Entreprise?
IsAddressFromMainEnterprise boolean

Especifique se o endereço do parceiro de negócios correspondente deve ser usado.

Rua
street string

Especifique uma rua.

city
city string

city

Cp
postcode string

Especifique um código postal.

Adress 1
address1 string

endereço1

Endereço 2
address2 string

endereço2

Endereço 3
address3 string

address3

Caixa postal
postbox string

Especifique uma caixa postal.

Município
county string

Especifique um condado.

County Short
countyShort string

Especifique uma abreviação de condado.

Código do país
countryCode string

Especifique um código de país.

Nome do país
countryName string

Especifique um nome de país.

Número de Telefone
Number string

Especifique um número de telefone.

Nome do número de telefone
Name string

Especifique um nome de número de telefone.

Email
EMail string

Especifique um email.

Nome do email
Name string

Especifique um nome de email.

Retornos

Nome Caminho Tipo Description
Êxito
Success boolean

Êxito

Message
Message string

Message

Código de status
StatusCode integer

CódigoDeStatus

ID de contato
ContactId integer

Identificador exclusivo do contato.

Adicionar um novo parceiro de negócios

Adicionar um novo parceiro de negócios

Parâmetros

Nome Chave Obrigatório Tipo Description
GPID (ID do Parceiro de Negócios)
businessPartnerId True string

Especificar uma ID de parceiro de negócios

Nome da Empresa 1
enterpriseName1 True string

Especifique um nome de empresa primário.

Nome da Empresa 2
enterpriseName2 string

Especifique um nome de empresa secundário.

Nome de pesquisa
searchName True string

Especifique um nome de pesquisa.

Abreviação
EnterpriseAbbreviation string

Especifique uma abreviação.

Memorando
Memo string

Especifique um memorando.

Nome do Branch
EnterpriseBranchName1 string

Especifique um nome de branch.

Página da Web
Webpage string

Especifique uma página da Web.

Domínio de email
MailDomainPart string

Especifique um domínio de email.

Informações do Assistente de Tíquete
ticketWizardInfo string

Especifique as informações do assistente de tíquete.

Informações do tíquete
ticketInfo string

Especifique uma informação de tíquete.

Informações da fatura
ticketInvoiceInfo string

Especifique as informações de uma fatura.

priority
priority integer

Especifique uma prioridade.

Número do Registro de Negociação
TradingRegistryNr string

Especifique um número de registro de negociação.

Número Externo
ExternalNumber string

Especifique um identificador externo.

Número do IVA
UstIdNr string

Especifique um número de IVA.

Usuário Responsável 1
ResponsibleUserFirst integer

Especifique um usuário responsável.

Usuário Responsável 2
ResponsibleUserSecond integer

Especifique um usuário responsável.

Grupo
EnterpriseGroup string

Especifique um grupo empresarial.

Número de telefone raiz
RootPhoneNumber string

Especifique um número de telefone raiz.

Número de Telefone
number string

Especifique um número de telefone.

Nome do número de telefone
name string

Especificar um nome de número de telefone

Email
email string

Especifique um email.

Nome do email
name string

Especifique um nome de email.

Rua
street string

Especifique um número de rua e casa.

Cp
postcode string

Especificar um código postal

City
city string

Especificar uma cidade

Município
county string

Especificar um município

Abreviação de Condado
countyShort string

Especifique uma abreviação de condado.

Código do país
countryCode string

Especifique um código de país.

País
countryName string

Especificar um país

endereço1
address1 string

endereço1

endereço2
address2 string

endereço2

address3
address3 string

address3

Caixa postal
postbox string

Caixa postal

Retornos

Nome Caminho Tipo Description
Êxito
Success boolean

Êxito

Message
Message string

Message

EnterpriseIds
EnterpriseIds array of integer

Uma lista de empresas.

Código de status
StatusCode integer

CódigoDeStatus

Atualizar o status de um parceiro de negócios existente

Atualizar o status de um parceiro de negócios existente

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da empresa
enterpriseId True integer

Especifique a ID do parceiro de negócios.

Status ID
statusId True integer

Selecione o status.

Retornos

Nome Caminho Tipo Description
Êxito
Success boolean

Êxito

Message
Message string

Message

Enterprises
EnterpriseId array of integer

Atualizar um parceiro de negócios existente

Atualizar um parceiro de negócios existente

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da empresa
enterpriseId True string

Especifique o identificador exclusivo do parceiro de negócios.

GPID (ID do Parceiro de Negócios)
businessPartnerId True string

Especificar uma ID de parceiro de negócios

Especifique um nome de empresa primário.
enterpriseName1 True string

Nome da Empresa 1

Nome da Empresa 2
enterpriseName2 string

Especifique um nome de empresa secundário.

Nome de pesquisa
searchName True string

Especifique um nome de pesquisa.

Abreviação
EnterpriseAbbreviation string

Especifique uma abreviação.

Memorando
Memo string

Especifique um memorando.

Nome do Branch
EnterpriseBranchName1 string

Especifique um nome de branch.

Página da Web
Webpage string

Especifique uma página da Web.

Domínio de email
MailDomainPart string

Especifique um domínio de email.

Informações do Assistente de Tíquete
InfoOnTicketCreate string

Especifique as informações do assistente de tíquete.

Informações do tíquete
InfoOnTicketView string

Especifique uma informação de tíquete.

Informações da fatura
InfoOnServiceAssignment string

Especifique as informações de uma fatura.

priority
priority integer

Especifique uma prioridade.

Número do Registro de Negociação
TradingRegistryNr string

Especifique um número de registro de negociação.

ID externa
ExternalId string

Especifique um identificador externo.

Número do IVA
UstIdNr string

Especifique um número de IVA.

Usuário Responsável 1
ResponsibleUserFirst integer

Especifique um usuário responsável.

Usuário Responsável 2
ResponsibleUserSecond integer

Especifique um usuário responsável.

Grupo
EnterpriseGroup string

Especifique um grupo empresarial.

Número de telefone raiz
RootPhoneNumber string

Especifique um número de telefone raiz.

Número de Telefone
number string

Especifique um número de telefone.

Nome do número de telefone
name string

Especificar um nome de número de telefone

Email
email string

Especifique um email.

Nome do email
name string

Especifique um nome de email.

Rua
street string

Especifique um número de rua e casa.

Cp
postcode string

Especificar um código postal

City
city string

Especificar uma cidade

Município
county string

Especificar um município

Abreviação de Condado
countyShort string

Especifique uma abreviação de condado.

Código do condado
countryCode string

Especifique um código de país.

País
countryName string

Especificar um país

endereço1
address1 string

endereço1

endereço2
address2 string

endereço2

address3
address3 string

address3

Caixa postal
postbox string

Caixa postal

Retornos

Nome Caminho Tipo Description
Êxito
Success boolean

Êxito

Message
Message string

Message

EnterpriseIds
EnterpriseIds array of integer

Uma lista de IDs corporativas.

Código de status
StatusCode integer

CódigoDeStatus

Obter uma lista de contatos

Obter uma lista de contatos

Parâmetros

Nome Chave Obrigatório Tipo Description
Filter
Filter string

Especifique um filtro.

Take
take True integer

Especifique quantos contatos você deseja receber.

Ignorar
skip integer

Especifique quantos contatos devem ser ignorados.

Param de Pesquisa
searchParam True string

Especifique uma cadeia de caracteres de consulta.

Retornos

Nome Caminho Tipo Description
Êxito
Success boolean

Êxito

Message
Message string

Message

Contagem
Count integer

A contagem de contatos.

Filtered
Filtered integer

A contagem de contatos filtrados.

Código de status
StatusCode integer

CódigoDeStatus

Contatos
Contacts array of object

Contatos

ID de contato
Contacts.ContactId integer

O identificador exclusivo do contato.

Formulário de endereço
Contacts.FormOfAddress string

A forma de suplementos.

Primeiro Nome
Contacts.ForeName string

O nome do contato.

Segundo Nome
Contacts.ForeName2 string

O segundo nome do contato.

Apelido
Contacts.SureName string

O sobrenome do contato.

Nome de pesquisa
Contacts.SearchName string

O nome de pesquisa do contato.

Situação
Contacts.Status string

O status do contato

Initials
Contacts.Initials string

A abreviação do contato.

Title
Contacts.Title string

O título do contato.

O VIP é?
Contacts.IsVIP boolean

Define o wheter em que o contato é um VIP.

Memorando
Contacts.Memo string

O memorando de contato.

Responsabilidades
Contacts.Responsibilities string

As responsabilidades de contato

ID da empresa
Contacts.EnterpriseId integer

O identificador exclusivo do parceiro de negócios correspondente.

Nome da empresa
Contacts.EnterpriseName string

O nome do parceiro de negócios correspondente.

GPID (ID do Parceiro de Negócios)
Contacts.BusinessPartnerId string

A ID do parceiro de negócios.

Número Externo
Contacts.ExternalNumber string

O número externo do parceiro de negócios correspondente.

Números de Telefone
Contacts.PhoneNumbers array of object

Números de Telefone

ID do número de telefone
Contacts.PhoneNumbers.Id integer

O identificador exclusivo do número de telefone.

Número de Telefone
Contacts.PhoneNumbers.Number string

O número de telefone.

Nome do número de telefone
Contacts.PhoneNumbers.Name string

O nome do número de telefone.

E-mails
Contacts.Emails array of object

E-mails

ID do email
Contacts.Emails.Id integer

O identificador exclusivo do email.

Email
Contacts.Emails.Email string

O email

Nome do email
Contacts.Emails.Name string

O nome do email.

Addresses
Contacts.Addresses array of object

Addresses

ID do endereço global
Contacts.Addresses.GlobalAddressID integer

O identificador exclusivo do endereço.

Rua
Contacts.Addresses.Street string

A rua.

Cp
Contacts.Addresses.Postcode string

O Código Postal

City
Contacts.Addresses.City string

A Cidade

Município
Contacts.Addresses.County string

O Condado

Abreviação de Condado
Contacts.Addresses.CountyShort string

A abreviação do condado.

Código do país
Contacts.Addresses.CountryCode string

O código do país.

Nome do país
Contacts.Addresses.CountryName string

O nome do país.

ID do país
Contacts.Addresses.CountryID integer

O identificador exclusivo do contry.

Endereço 1
Contacts.Addresses.Address1 string

Address1

Endereço 2
Contacts.Addresses.Address2 string

Address2

Endereço 3
Contacts.Addresses.Address3 string

Endereço3

Caixa postal
Contacts.Addresses.Postbox string

Caixa postal

O endereço é da Empresa Principal?
Contacts.IsAddressFromMainEnterprise boolean

Define o wheter em que o endereço é da empresa correspondente.

Obter uma lista de parceiros de negócios

Obter uma lista de parceiros de negócios

Parâmetros

Nome Chave Obrigatório Tipo Description
Param de Pesquisa
searchParam True string

Especifique uma cadeia de caracteres de consulta.

Take
take True integer

Especifique quantos parceiros de negócios você gostaria de receber.

Ignorar
skip integer

Especifique quantos parceiros de negócios devem ser ignorados.

Retornos

Nome Caminho Tipo Description
Êxito
Success boolean

Êxito

Message
Message string

Message

Código de status
StatusCode integer

CódigoDeStatus

Contagem
Count integer

A quantidade de empresas.

Filtered
Filtered integer

A quantidade de empresas filtradas.

Enterprises
Enterprises array of object

Enterprises

ID da empresa
Enterprises.EnterpriseId integer

O identificador exclusivo do parceiro de negócios.

Nome da Empresa 1
Enterprises.EnterpriseName string

O nome principal do parceiro de negócios.

Nome da Empresa 2
Enterprises.EnterpriseName2 string

O nome secundário do parceiro de negócios.

GPID (ID do Parceiro de Negócios)
Enterprises.businessPartnerId string

A ID do parceiro de negócios.

Domínio de email
Enterprises.MailDomain string

O domínio de email do parceiro de negócios.

Status ID
Enterprises.Status integer

O status (identificador) do parceiro de negócios.

Nome do Status
Enterprises.StatusName string

O status (nome) do parceiro de negócios.

Abreviação
Enterprises.EnterpriseAbbreviation string

A abreviação do parceiro de negócios.

Grupo
Enterprises.EnterpriseGroup string

O grupo do parceiro de negócios.

Data de Criação
Enterprises.CreationDate string

A data de criação do parceiro de negócios.

Data da alteração
Enterprises.AlterationDate string

A data de alteração do parceiro de negócios.

Nome de pesquisa
Enterprises.FreeTextFieldSearch1 string

O nome de pesquisa do parceiro de negócios.

Memorando
Enterprises.MemoField string

O memorando do parceiro de negócios.

Informações do Assistente de Tíquete
Enterprises.TicketWizardInfo string

As informações sobre a criação de tíquetes.

Informações do tíquete
Enterprises.TicketInfo string

As informações no modo de exibição de tíquete.

Informações da fatura
Enterprises.TicketInvoiceInfo string

As informações sobre a criação da atribuição de serviço.

ID do Criador
Enterprises.UserCreator integer

O identificador exclusivo do criador.

Nome do Criador
Enterprises.UserNameCreator string

O nome de usuário do criador.

Editor ID
Enterprises.UserEditor integer

O identificador exclusivo do editor.

Nome do Editor
Enterprises.UserNameEditor string

O nome de usuário do editor.

Página da Web
Enterprises.Webpage string

A página da Web do parceiro de negócios.

Priority
Enterprises.Priority integer

A prioridade do parceiro de negócios.

Número do IVA
Enterprises.UstIdNr string

O número de IVA do parceiro de negócios.

Número do Registro de Negociação
Enterprises.TradingRegistryNr string

O número do registro de negociação do parceiro de negócios.

Número Externo
Enterprises.ExternalNumber string

Um identificador externo do parceiro de negócios.

ID do Usuário Responsável 1
Enterprises.ResponsibleUserFirst integer

O identificador do usuário repsonsível para esse parceiro de negócios.

Nome do Usuário Responsável 1
Enterprises.ResponsibleUserFirstName string

O nome de usuário do usuário repsonsível para este parceiro de negócios.

ID do Usuário Responsável 2
Enterprises.ResponsibleUserSecond integer

O identificador do usuário repsonsível para esse parceiro de negócios.

Nome do Usuário Responsável 2
Enterprises.ResponsibleUserSecondName string

O nome de usuário do usuário repsonsível para este parceiro de negócios.

Nome do Branch
Enterprises.EnterpriseBranchName string

O nome do branch do parceiro de negócios.

ID do nome do branch
Enterprises.EnterpriseBranchTypeId integer

O identificador de branch do parceiro de negócios.

Números de Telefone
Enterprises.PhoneNumbers array of object

Números de Telefone

ID do número de telefone
Enterprises.PhoneNumbers.Id integer

O identificador exclusivo do número de telefone.

Número de Telefone
Enterprises.PhoneNumbers.Number string

O número de telefone.

Nome do número de telefone
Enterprises.PhoneNumbers.Name string

O nome do número de telefone.

E-mails
Enterprises.Emails array of object

E-mails

ID do email
Enterprises.Emails.Id integer

O identificador exclusivo do email.

Email
Enterprises.Emails.Email string

O email

Nome do email
Enterprises.Emails.Name string

O nome do email.

Addresses
Enterprises.Addresses array of object

Addresses

ID do endereço global
Enterprises.Addresses.GlobalAddressID integer

O identificador exclusivo do endereço.

Rua
Enterprises.Addresses.Street string

A rua.

Cp
Enterprises.Addresses.Postcode string

O Código Postal

City
Enterprises.Addresses.City string

A Cidade

Município
Enterprises.Addresses.County string

O Condado

Abreviação de Condado
Enterprises.Addresses.CountyShort string

A abreviação do condado.

Código do país
Enterprises.Addresses.CountryCode string

O código do país.

Nome do país
Enterprises.Addresses.CountryName string

O nome do país.

ID do país
Enterprises.Addresses.CountryID integer

O identificador exclusivo do contry.

Endereço 1
Enterprises.Addresses.Address1 string

Address1

Endereço 2
Enterprises.Addresses.Address2 string

Address2

Endereço 3
Enterprises.Addresses.Address3 string

Endereço3

Caixa postal
Enterprises.Addresses.Postbox string

Caixa postal

UpdateContact

UpdateContact

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de contato
contactId string

Especifique o identificador exclusivo do contato.

Número de referência da empresa
EnterpriseReferenceNumber True string

Especifique um número de referência da empresa.

Title
Title string

Especifique um título.

Formulário de endereço
formOfAddress string

Especifique uma forma de endereço.

Primeiro Nome
foreName True string

Especifique um nome.

Segundo Nome
foreName2 string

Especifique um segundo nome.

Surname
surName True string

Especifique um sobrenome.

Nome de pesquisa
searchname string

Especifique um nome de pesquisa.

Número Externo
externalNumber string

Especifique um identificador externo.

Initials
Initials string

Especifique as iniciais.

Memorando
memo string

Especifique um memorando.

Informações do tíquete
InfoOnTicketView string

Especifique uma informação de tíquete.

Informações da fatura
InfoOnServiceAssignment string

Especifique as informações de uma fatura.

Informações do Assistente de Tíquete
InfoOnTicketCreate string

Especifique as informações do assistente de tíquete.

Departamento
departmentName string

Especifique um nome de departamento.

O Vip?
IsVip boolean

Especifique se o contato é um VIP?

Usar Addres do Entreprise?
IsAddressFromMainEnterprise boolean

Especifique se o endereço do parceiro de negócios correspondente deve ser usado.

Rua
street string

Especifique uma rua.

city
city string

city

Cp
postcode string

Especifique um código postal.

Adress 1
address1 string

endereço1

Endereço 2
address2 string

endereço2

Endereço 3
address3 string

address3

Caixa postal
postbox string

Especifique uma caixa postal.

Município
county string

Especifique um condado.

County Short
countyShort string

Especifique uma abreviação de condado.

Código do país
countryCode string

Especifique um código de país.

Nome do país
countryName string

Especifique um nome de país.

Número de Telefone
Number string

Especifique um número de telefone.

Nome do número de telefone
Name string

Especifique um nome de número de telefone.

Email
EMail string

Especifique um email.

Nome do email
Name string

Especifique um nome de email.

Retornos

Nome Caminho Tipo Description
Êxito
Success boolean

Êxito

Message
Message string

Message

Código de status
StatusCode integer

CódigoDeStatus

ID de contato
ContactId integer

Identificador exclusivo do contato.