Поделиться через

Tesseron Basic Data (Preview)

  • Reference

This connector allows you to create, edit and search enterprises and contacts in your Tesseron Instance.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Tesseron Support
URL https://www.docs.tesseron.de
Email [email protected]
Connector Metadata
Publisher Luithle + Luithle GmbH
Website https://www.tesseron.de
Privacy policy https://www.llnet.de/data-protection/
Categories IT Operations;Communication

This connector allows you to use the main basic data functions in Tesseron ASM. Create, update and retrieve all information of your business partners and contacts. Integrate Tesseron ASM into your flows and automate your business processes.

Prerequisites

You will need the following to proceed:

  • A Tesseron ASM Instance
  • A Tesseron ASM licensed user
  • An API Key (Service: Ticket)

How to get credentials

Please request your API Key from your system partner or administrator.

Get started with your connector

Since Tesseron ASM Rest API uses API keys to validate your user, you first need to contact your system administrator to create an API key for your user. After that is completed you can create your Tesseron ASM connection.

  1. Check user rights With this connector you will be able to perform ticket actions within your Tesseron ASM instance. Therefore you need to have the mandatory user rights in the needed areas (at least editor).

  2. Apply for your API key Currently, API keys can only be created by your system administrator. Therefore, request your API key from your system administrator.

  3. Create a new connection

    • Provide your Tesseron ASM instance URL
    • Enter your Tesseron ASM API key

Provide users with a step-by-step process for getting started with your connector. This is where you should highlight common use cases, such as your expected popular triggers and actions, and how they can help in automation scenarios. Include images where possible.

Known issues and limitations

  • Sufficient user rights are mandatory to receive ticket information in specific areas
  • If the ticket creation is triggered multiple time at once there may be an incomplete ticket creation

Common errors and remedies

  • Currently it is not possible to create a new ticket witch an existing reference number.

FAQ

Is there any extra charge using this connector?

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Instance URL string Your Tesseron instance URL True
Api Key securestring Your Tesseron API key (Service: Ticket) True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

[Obsolete] Get enterprise information

Get the main enterprise information (enterprise ID, business partner ID & domain)
[Obsolete] Search enterprise by parameter

Receive business partner information providing a search query.
[Obsolete] Search Enterprise ID

Search the Tesseron enterprise ID with the customer number.
Create Contact

Add a new contact to your business partners.
Create Enterprise

Add a new enterprise to your business partners.
Get Contacts

Receive contact information providing a search query.
Get Enterprises

Receive business partner information providing a search query.
Set Enterprise Status

Update the status of an existing business partners.
Update Contact

Update an existing contact to your business partners.
Update Enterprise

Update an existing enterprise of your business partners.

[Obsolete] Get enterprise information

Operation ID:
GetEnterprise

Get the main enterprise information (enterprise ID, business partner ID & domain)

Parameters

Name Key Required Type Description
Enterprise ID
 enterpriseId True integer

Please provide the ID of the business partner.

Returns

Name Path Type Description
Enterprise ID
 EnterpriseId integer

The Tesseron ID of the requested enterprise.
Enterprise Name
 EnterpriseName string

The name of the requested enterprise.
Business Partner ID
 BusinessPartnerId string

The business partner ID of the requested enterprise.
Mail Domain
 MailDomain string

The mail domain of the requested enterprise.
Message
 Message string

Message
Success
 Success boolean

Success
Status
 Status string

Status

[Obsolete] Search enterprise by parameter

Operation ID:
SearchEnterpriseByParameter

Receive business partner information providing a search query.

Parameters

Name Key Required Type Description
Filter
 Filter string

Specify a filter for your query
Search Parameters
 searchParam True string

Specify the search parameters for your query.
Take
 take True integer

Specify how many entries you would like to receive.
Skip
 skip True integer

Please specify how many entries should be skipped.

Returns

Name Path Type Description
Success
 Success boolean

Success
Message
 Message string

Message
Count
 Count integer

The count of received entries.
Filtered
 Filtered integer

The count of filtered entries.
Enterprises
 Enterprises array of object

Enterprises
Enterprise ID
 Enterprises.EnterpriseId integer

The enterprise ID.
Enterprise Name
 Enterprises.EnterpriseName string

The enterprise name.
Business Partner ID
 Enterprises.BusinessPartnerId string

The business partner ID.
Mail Domain
 Enterprises.MailDomain string

The enterprise mail domain.
Status
 Enterprises.Status string

Status

[Obsolete] Search Enterprise ID

Operation ID:
SearchEnterprise

Search the Tesseron enterprise ID with the customer number.

Parameters

Name Key Required Type Description
Business Partner ID
 referenceNumber True string

Please provide the business partner ID

Returns

Name Path Type Description
Message
 Message string

Message
Success
 Success boolean

Success
Enterprise ID of the requested business partner.
 EnterpriseId array of integer

Create Contact

Operation ID:
CreateContact

Add a new contact to your business partners.

Parameters

Name Key Required Type Description
Enterprise Reference Number
 enterpriseReferenceNumber True string

Please provide the ID of the business partner.
Title
 title string

Please provide the title.
Form of Address
 formOfAddress string

Please provide the form of address.
Forename
 foreName True string

Please provide the forename of the contact.
Forename 2
 foreName2 string

Please provide the second forename of the contact.
Surname
 sureName True string

Please provide the surname of the new contact.
Searchname
 searchname string

Please provide the searchname of the new contact.
Memo
 memo string

Please provide a memo for the contact.
Responsibilities
 responsibilities string

Please provide the contact responsibilities.
Department
 departmentName string

departmentName
Is VIP?
 IsVIP boolean

Specify whether the contact is a VIP
External number
 externalNumber string

The ID of a third party system.
Contact type
 enterpriseContactType integer

The contact type.
Ticket info
 InfoOnTicketView string

Info on ticket view
Invoice info
 InfoOnServiceAssignment string

Info on service assignmnent creation
Ticket wizard info
 InfoOnTicketCreate string

Info on ticket creation
Street
 street string

The street
Postcode
 Postcode integer

The postcode
City
 city string

The city
Additional address 1
 address1 string

The first additional address
Additional address 2
 address2 string

The second additional address
Additional address 3
 address3 string

The third additional address
Postbox
 postbox string

The postbox
County
 county string

The county
County code
 countyShort string

The county abbreviation
Country
 countryName string

The country name
Country code
 countryCode string

The country code
E-Mail Name
 name string

The email name
E-Mail address
 email string

The email address
Phone number Name
 name string

The phone number name
Phone number
 Number string

The phone number address

Returns

Name Path Type Description
Contact ID
 contactid integer

The ID of the newly created contact.
Message
 message string

message
Success
 success boolean

success

Create Enterprise

Operation ID:
CreateEnterprise

Add a new enterprise to your business partners.

Parameters

Name Key Required Type Description
Business Partner ID
 BusinessPartnerId True string

The business partner ID.
Name
 EnterpriseName True string

The enterprise name.
Name 2
 EnterpriseName2 True string

The second enterprise name.
Searchname
 FreeTextFieldSearch True string

Search name
Trading regirstry number
 TradingRegistryNr string

The trading registry number.
VAT ID number
 UstIdNr string

The VAT ID number.
External ID
 ExternalId string

The external ID.
Mail Domain
 MailDomainPart string

The enterprise mail domain.
Root phone number
 RootPhoneNumber string

The enterprise root phone number.
Webpage
 Webpage string

The webpage of the business partner.
Abbreveation
 EnterpriseAbbreviation string

The abbreveation of the business partner.
Group
 EnterpriseGroup string

The group of the business partner.
Memo
 MemoField string

The memo for the business partner.
Ticket info
 InfoOnTicketView string

Info on ticket view
Invoice info
 InfoOnServiceAssignment string

Info on service assignmnent creation
Ticket wizard info
 InfoOnTicketCreate string

Info on ticket creation
Priority
 priority integer

The enterprise priority.
Responsible user 1
 ResponsibleUserFirst integer

The responsible User
Responsible user 2
 ResponsibleUserSecond integer

The responsible User
Street
 street string

The street
Postcode
 Postcode integer

The postcode
City
 city string

The city
Additional address 1
 address1 string

The first additional address
Additional address 2
 address2 string

The second additional address
Additional address 3
 address3 string

The third additional address
Postbox
 postbox string

The postbox
County
 county string

The county
County code
 countyShort string

The county abbreviation
Country
 countryName string

The country name
Country Code
 countryCode string

The country code
E-Mail Name
 name string

The email name
E-Mail address
 email string

The email address
Phone number Name
 name string

The phone number name
Phone number
 Number string

The phone number address

Returns

Name Path Type Description
Enterprise ID
 enterpriseid integer

enterpriseid
Enterprise ID
 message string

message
Succsess
 success boolean

success

Get Contacts

Operation ID:
GetContacts

Receive contact information providing a search query.

Parameters

Name Key Required Type Description
Search parameter
 searchParam True string

Please provide a query string.
Take
 take True integer

Specify how many results you would like to receive.
Skip
 skip True integer

Specify how many results should be skipped.
Filter
 filter string

Specify filter options.

Returns

Name Path Type Description
Success
 Success boolean

Success
Message
 Message string

Message
Count
 Count integer

The count of received entries.
Filtered
 Filtered integer

The count of filtered entries.
Contacts
 Contacts array of object
ID
 Contacts.ContactID integer

The ccontact ID.
Title
 Contacts.Title string

The title of the contact.
Form of Address
 Contacts.FormOfAddress string

The form of address of the contact.
Forename
 Contacts.ForeName string

The contact forname.
Forename 2
 Contacts.ForeName2 string

The contact second forname.
Surname
 Contacts.SureName string

The surname of the contact.
Searchname
 Contacts.SearchName string

The searchname of the contact.
Initials
 Contacts.Initials string

The initials of the contact.
Is VIP?
 Contacts.IsVIP boolean

The VIP status of the contact.
Memo
 Contacts.Memo string

The contact memo.
Responsibilities
 Contacts.Responsibilities string

The contact responsibilities.
External number
 Contacts.ExternalNumber string

The external number of the contact.
Status
 Contacts.Status string

Status
Enterprise ID
 Contacts.EnterpriseID integer

The ID of the attached enterprise.
Enterprise name
 Contacts.EnterpriseName string

The name of the attached enterprise
Ticket info
 Contacts.InfoOnTicketView string

Info on ticket view
Invoice info
 Contacts.InfoOnServiceAssignment string

Info on service assignmnent creation
Ticket wizard info
 Contacts.InfoOnTicketCreate string

Info on ticket creation
Emails
 Contacts.Emails array of object
EMail ID
 Contacts.Emails.id integer

The email ID
E-Mail Name
 Contacts.Emails.name string

The email name
E-Mail address
 Contacts.Emails.email string

The email address
PhoneNumbers
 Contacts.PhoneNumbers array of object
Phne number ID
 Contacts.PhoneNumbers.id integer

The phone number ID
Phone number Name
 Contacts.PhoneNumbers.name string

The phone number name
Phone number
 Contacts.PhoneNumbers.email string

The phone number address

Get Enterprises

Operation ID:
GetEnterprises

Receive business partner information providing a search query.

Parameters

Name Key Required Type Description
Search parameter
 searchParam True string

Please provide a query string.
Take
 take True integer

Specify how many results you would like to receive.
Skip
 skip True integer

Specify how many results should be skipped.
Filter
 filter string

Specify filter options.

Returns

Name Path Type Description
Success
 Success boolean

Success
Message
 Message string

Message
Count
 Count integer

The count of received entries.
Filtered
 Filtered integer

The count of filtered entries.
Enterprises
 Enterprises array of object

Enterprises
Enterprise ID
 Enterprises.EnterpriseId integer

The enterprise ID.
Name
 Enterprises.EnterpriseName string

The enterprise name.
Name 2
 Enterprises.EnterpriseName2 string

The second enterprise name.
Business Partner ID
 Enterprises.BusinessPartnerId string

The business partner ID.
Business Partner ID
 Enterprises.TradingRegistryNr string

The trading registry number.
VAT ID number
 Enterprises.UstIdNr string

The VAT ID number.
External ID
 Enterprises.ExternalId string

The external ID.
Mail Domain
 Enterprises.MailDomainPart string

The enterprise mail domain.
Root phone number
 Enterprises.RootPhoneNumber string

The enterprise root phone number.
Webpage
 Enterprises.Webpage string

The webpage of the business partner.
Status
 Enterprises.Status string

Status
StatusName
 Enterprises.StatusName string

Status name
EnterpriseAbbreviation
 Enterprises.EnterpriseAbbreviation string

Abbreviation
EnterpriseGroup
 Enterprises.EnterpriseGroup string

Group
CreationDate
 Enterprises.CreationDate date-time

Creation date
AlterationDate
 Enterprises.AlterationDate date-time

Alteration Date
FreeTextFieldSearch1
 Enterprises.FreeTextFieldSearch1 string

Search name
MemoField
 Enterprises.MemoField string

Memo
InfoOnTicketView
 Enterprises.InfoOnTicketView string

Info on ticket view
InfoOnServiceAssignment
 Enterprises.InfoOnServiceAssignment string

Info on service assignmnent creation
InfoOnTicketCreate
 Enterprises.InfoOnTicketCreate string

Info on ticket cration
Priority
 Enterprises.priority integer

The enterprise priority.
Responsible user 1
 Enterprises.ResponsibleUserFirstName string

The responsible User
Responsible user 2
 Enterprises.ResponsibleUserSecondName string

The responsible User
Street
 Enterprises.Address.street string

The street
Postcode
 Enterprises.Address.Postcode integer

The postcode
City
 Enterprises.Address.city string

The city
Additional address 1
 Enterprises.Address.address1 string

The first additional address
Additional address 2
 Enterprises.Address.address2 string

The second additional address
Additional address 3
 Enterprises.Address.address3 string

The third additional address
Postbox
 Enterprises.Address.postbox string

The postbox
County
 Enterprises.Address.county string

The county
Postbox
 Enterprises.Address.countyShort string

The county abbreviation
Country
 Enterprises.Address.countryName string

The country name
Country Code
 Enterprises.Address.countryCode string

The country code
Emails
 Enterprises.Emails array of object
E-Mail Name
 Enterprises.Emails.name string

The email name
E-Mail address
 Enterprises.Emails.email string

The email address
PhoneNumbers
 Enterprises.PhoneNumbers array of object
Phone number Name
 Enterprises.PhoneNumbers.name string

The phone number name
Phone number
 Enterprises.PhoneNumbers.email string

The phone number address
Creator
 Enterprises.UserNameCreator string

The username of creator
Creator ID
 Enterprises.UserCreator integer

The user ID of creator
Editor
 Enterprises.UserNameEditor string

The username of the last editor
Editor ID
 Enterprises.UserEditor integer

The user ID of the last editor

Set Enterprise Status

Operation ID:
SetEnterpriseStatus

Update the status of an existing business partners.

Parameters

Name Key Required Type Description
Enterprise ID
 enterpriseID True integer

Please provide the ID of the business partner.
Status
 status True integer

Please provide the ID of the business partner.

Returns

Name Path Type Description
Enterprise ID
 contactid integer

The ID of the updated business partner.
Message
 message string

message
Success
 success boolean

success

Update Contact

Operation ID:
UpdateContact

Update an existing contact to your business partners.

Parameters

Name Key Required Type Description
Contact ID
 ContactID integer

Please provide the ID of the contact.
Enterprise Reference Number
 enterpriseReferenceNumber True string

Please provide the ID of the business partner.
Enterprise ID
 enterpriseID integer

Please provide the ID of the attached enterprise.
Title
 title string

Please provide the title.
Form of Address
 formOfAddress string

Please provide the form of address.
Forename
 foreName True string

Please provide the forename of the contact.
Forename 2
 foreName2 string

Please provide the second forename of the contact.
Surname
 sureName True string

Please provide the surname of the new contact.
Searchname
 searchname string

Please provide the searchname of the new contact.
Memo
 memo string

Please provide a memo for the contact.
Responsibilities
 responsibilities string

Please provide the contact responsibilities.
Department
 departmentName string

departmentName
Is VIP?
 IsVIP boolean

Specify whether the contact is a VIP
Status
 Status integer

The new status of the contact.
External ID
 externalNumber string

The ID of a third party system.
Contact type
 enterpriseContactType integer

The contact type.
Ticket info
 InfoOnTicketView string

Info on ticket view
Invoice info
 InfoOnServiceAssignment string

Info on service assignmnent creation
Ticket wizard info
 InfoOnTicketCreate string

Info on ticket creation
Street
 street string

The street
Postcode
 Postcode integer

The postcode
City
 city string

The city
Additional address 1
 address1 string

The first additional address
Additional address 2
 address2 string

The second additional address
Additional address 3
 address3 string

The third additional address
Postbox
 postbox string

The postbox
County
 county string

The county
Postbox
 countyShort string

The county abbreviation
Country
 countryName string

The country name
Country Code
 countryCode string

The country code
E-Mail Name
 name string

The email name
E-Mail address
 email string

The email address
Phone number Name
 name string

The phone number name
Phone number
 Number string

The phone number address

Returns

Name Path Type Description
Contact ID
 contactid integer

The ID of the newly created contact.
Message
 message string

message
Success
 success boolean

success

Update Enterprise

Operation ID:
UpdateEnterprise

Update an existing enterprise of your business partners.

Parameters

Name Key Required Type Description
Enterprise ID
 EnterpriseId integer

The enterprise ID.
Business Partner ID
 BusinessPartnerId True string

The business partner ID.
Name
 EnterpriseName string

The enterprise name.
Name 2
 EnterpriseName2 string

The second enterprise name.
Searchname
 FreeTextFieldSearch string

The searchname
Trading registry number
 TradingRegistryNr string

The trading registry number.
VAT ID number
 UstIdNr string

The VAT ID number.
External ID
 ExternalId string

The external ID.
Mail Domain
 MailDomainPart string

The enterprise mail domain.
Root phone number
 RootPhoneNumber string

The enterprise root phone number.
Webpage
 Webpage string

The webpage of the business partner.
Abbreveation
 EnterpriseAbbreviation string

Abbreviation
Group
 EnterpriseGroup string

Group
Memo
 MemoField string

Memo
Ticket info
 InfoOnTicketView string

Info on ticket view
Invoice info
 InfoOnServiceAssignment string

Info on service assignmnent creation
Ticket wizard info
 InfoOnTicketCreate string

Info on ticket creation
Priority
 priority integer

The enterprise priority.
Responsible user 1
 ResponsibleUserFirst integer

The responsible User
Responsible user 2
 ResponsibleUserSecond integer

The responsible User
Street
 street string

The street
Postcode
 Postcode integer

The postcode
City
 city string

The city
Additional address 1
 address1 string

The first additional address
Additional address 2
 address2 string

The second additional address
Additional address 3
 address3 string

The third additional address
Postbox
 postbox string

The postbox
County
 county string

The county
Postbox
 countyShort string

The county abbreviation
Country
 countryName string

The country name
Country Code
 countryCode string

The country code
E-Mail Name
 name string

The email name
E-Mail address
 email string

The email address
Phone number Name
 name string

The phone number name
Phone number
 Number string

The phone number address

Returns

Name Path Type Description
Enterprise ID
 enterpriseid integer

enterpriseid
Message
 message string

message
Success
 success boolean

success