Dela via


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

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

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

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

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

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

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

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

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

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

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