Tesseron Basic Data (Preview)

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	development@llnet.de

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