Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

Beschreibung

Quelle

PerformX Adressen

Ziel

Abacus CRM/Adressen

Abacus Schnittstellenversion

Adressen 2021.00

Dokumentation Abacus

AbaConnect-Dokumentation (abacus.ch)

Beschreibung

. Siehe Übersicht "Integrationen"

Bedingungen

...

Standard-Bedingung

...

Aktive Adressen

...

Manuell für den Übertrag an Abacus markierte Adressen

...

Adresse mit Beleg im aktuellen Geschäftsbereich/Mandant (Typ Debitoren)

Inhalt
minLevel2
maxLevel2
outlinefalse
typelist
printablefalse

1. Konzept

Rollenaufteilung

  • Standardintegration von PerformX mit dem Newsletter-Tool Brevo via API von Brevo

  • Diese Schnittstelle wird mit dem PerformX-Connector realisiert und bietet die Möglichkeit, PerformX-Adressen für den Versand von Newslettern und Mailings direkt aus PerformX nach Brevo zu übertragen und zu aktualisieren

  • Das Führen und Administrieren der Segmentierung sowie auch die An-/Abmelde-Funktionen werden vollständig durch Brevo bereitgestellt. Es erfolgt keine Rückschreibung in PerformX

  • Brevo wird durch den Kunden, bzw. einen Drittpartner aufgesetzt, konfiguriert und betreut

Funktionsweise

  • Die gemäss Selektion definierten Adressen werden periodisch an Brevo übermittelt

  • Die von Brevo vergebene BrevoID wird im PerformX als Fremdschlüssel gespeichert, damit jederzeit eine Zuordnung möglich ist

  • Adressmutation übermittelter Adressen werden ebenfalls in Brevo aktualisiert

  • Löschungen und Inaktivierungen geschehen im Backend von Brevo

Versandlisten in Brevo

  • Aus PerformX werden zwei Versandlisten bedient:

    • Opt-In: Kontakte in dieser Liste müssen einen Opt-In-Prozess durchlaufen, bevor sie einen Newsletter erhalten

    • Newsletter: Kontakte in dieser Liste können direkt mit Newslettern beliefert werden, da sie den Opt-In-Prozess bereits auf einem anderen Weg durchlaufen haben

Initialimport

  • Vor dem erstmaligen Export werden die definierten Adressen im PerformX markiert und in die entsprechende Brevo-Liste exportiert

  • Der Connector synchronisiert die BrevoID retour in PerformX, damit eine spätere Aktualisierung möglich ist

2. Schnittstellendefinition

Quellobjekt

Adresse

Formel für Primärschlüsselfeld

--

Zielobjekt

adre/address_2021.00

Mapping Mandanten

Mehrere Mandanten oder Nummern pro Datensatz

Formel für Abacus Mandanten-Nr.

Parameters("Mandantennummer")

Formel für ConnectorMapping Feld

--

Synchronisations-Option

Update und

Quelle

PerformX Adressen

Ziel

https://api.brevo.com/v3/contacts

Schnittstelle

Brevo API

Dokumentation Brevo

Getting started (brevo.com)

Bedingung für Erstellung neuer Kontakte in Brevo

  • Nur aktive Adressen

  • Zu definierendes E-Mail-Feld (oder ein beliebiges E-Mail-Feld von mehreren in einer zu definierenden Reihenfolge) ist ausgefüllt

  • Buchung oder Adressmutation ab einem zu definierenden Stichtag vorhanden

  • Mutation seit der letzten Synchronisation oder noch nie übertragen (keine BrevoID)

(Aktiv == true) && (UebertragAbacus == true  || ( OP.Bereich.DebiExterneMandantNr == Parameters("MandantenNummer") 
&& ( OP.Typ == 1 || OP.Typ == -1) ) ) &&  (!AbaSync.ConnectorMappingFieldHasValue(Parameters("MandantenNummer"), "ConnectorAdressnummer") || ?DatumMutation ||  EndOfDay(DatumMutation) > CurrentJob.LastSuccessfulExecution())

Vergabe Identifikation/Nummer

PerformX

Parameter Aufgabe

ParameterName: MandantenNummer
ParameterWert: Mandantennummer
ParameterTyp: Integer

Konfiguration Zuordnungsdefinition

Bedingung für Update in Brevo

  • Nur aktive Adressen

  • Adresse bereits an Brevo übertragen (BrevoID ausgefüllt)

  • Mutation seit der letzten Synchronisation

Vergabe Identifikation/Nummer

Brevo

3. PerformX-Erweiterungen für Brevo

Auf der Tabelle Adresse im Register “Info” wird ein zusätzliches Feld “Brevo ID” ergänzt (integer 8, standardmässig leer)

4. Konfiguration Connector

4.1 Benötigte Zuordnungen und Schnittstellen

1. Übertrag Adressen ohne Opt-in-Prozess

Name

Kein Opt-In

Quellobjekt

Adresse

Zielobjekt

/contacts:createContact

Mapping Mandanten

Ein Mandant/eine Nummer pro Datensatz

Synchronisations-Option

Update oder Insert

Daten nach Operation zurücklesen

Ja

Brevo-Listen-ID “listid”

Gemäss Brevo Backend

2. Übertrag Adressen mit Opt-In-Prozess

Name

Mit Opt-In

Quellobjekt

Adresse

Zielobjekt

/contacts:createContact

Mapping Mandanten

Ein Mandant/eine Nummer pro Datensatz

Synchronisations-Option

Update oder Insert

Daten nach Operation zurücklesen

Ja

Brevo-Listen-ID “listid”

Gemäss Brevo Backend

3. Synchronisierung der Brevo-IDs nach PerformX

Name

Brevo-ID Synch

Sortierung

3

Quellobjekt

Adresse

Zielobjekt

/contacts/{email}:getContactInfo

Mapping Mandanten

Ein Mandant/eine Nummer pro Datensatz

Synchronisations-Option

Update oder Insert

Daten nach Operation zurücklesen

Ja

Verwendeter Index

--

WebSerivce Parameter

...

XML Element Name

...

Beschreibung Abacus

...

PerformX Beschreibung

...

Mapping

Übertrag von PerformX nach Abacus

XML Element Name

Beschreibung Abacus

4. Aktualisierung bestehender Adressen

Name

Update Contact

Sortierung

4

Quellobjekt

Adresse

Zielobjekt

/contacts:createContact

Mapping Mandanten

Ein Mandant/eine Nummer pro Datensatz

Synchronisations-Option

Update oder Insert

Daten nach Operation zurücklesen

Ja

Brevo-Listen-ID “listid”

Gemäss Brevo Backend

4.2 Feldmapping pro Schnittstelle

1. und 2. Übertrag Adressen ohne Opt-in-Prozess und Übertrag Adressen mit Opt-in-Prozess

Brevo Beschreibung

PerformX Beschreibung

Mapping/Übertrag an

Abacus

+ AddressData

Subelement Adresse

- AddressNumber

AdressNr

ConnectorMapping.ConnectorAdressnummer ?? ""

- CodeName

Suchbegriff

Suchbegriff

- Name

Name

Firmenname oder Personenname mit allfälligem Zweitname

if(Aufnahmeart.IstFirma, Firma, if(Aufnahmeart.IstKontakt, Beziehung.Adresse.Firma ?? Firma, null)) ?? Name+Name2

- FirstName

Vorname

Vorname (falls kein Adresstyp "Firma")

if(!Aufnahmeart.IstFirma && !Aufnahmeart.IstKontakt, Vorname, null)

- Supplement

Zusatz

Firmenzusatz

Firmenzusatz

- Line1

Strasse

Strasse und Nummer

Hinweis: Die Strasse und Hausnummer wird automatisch durch den Abacus-WebSerivce aufgeteilt

Strasse

- PostOfficeBoxText

Postfach

Zusatz1

- Line2

Zeile 2

Zusatz 2/Postfach

Zusatz2

- Country

Land

ISO-Code des Landes

Land.IsoCode

- ZIP

Plz

PLZ

PLZ

- City

Ort

Ort

Ort

- Phone1

Telefon 1

Telefon Privat

TelP

- Phone2

Telefon 2

  1. Telefon Direkt, 2. Telefon Geschäft

TelD ?? TelG

- Mobile

Mobiltelefon

  1. Mobile Direkt, 2. Mobile Geschäft, 3. Mobile Privat

NatelD ?? NatelG ?? Natel

- SalutationNumber

Anrede-Nr

Externe ID der Anrede

Anrede.ExterneAnredeNr

- SalutationName

Anredename

Briefanrede gemäss Anredetabelle

Anrede.Anrede

- Title

Titel

Titel

Titel

- Text

Bemerkung

Notizen

Notizen

- Website

WWW

Webseite

HomepageG

- Email

E-Mail

  1. E-Mail Direkt, 2. E-Mail Geschäft, 3. E-Mail Privat

EmailD ?? EmailG ?? Email

- Language

Sprache

Korrespondenzsprache

Standard.ToLower(Standard.substring(Sprache,0,2))

- Title

Titel

Titel

- SubjectType

Adresstyp

Personentyp (ab Anrede)

Anrede.Personentyp

- AdressValidAsOf

Gültig ab

DatumMutation

Übertrag von Abacus nach PerformX

XML Element Name

Beschreibung Abacus

PerformX Beschreibung

Mapping/Übertrag an PerformX

+ AddressData

Subelement Adresse

- AddressNumber

AdressNr

ConnectorMapping.ConnectorAdressnummer

Brevo

Beschreibung

attributes[0].name

Formel “LASTUPDATE”

Selektiert Attribut “LASTUPDATE” in Brevo

attributes[0].numeric

DatumMutation

1:1

Überträgt ID nach attributes[0]

attributes[1].name

Formel “LASTNAME”

Selektiert Attribut “LASTNAME” in Brevo

attributes[1].text

Name ??

1:1

Überträgt Name nach attributes[1]

attributes[2].name

Formel “FIRSTNAME”

Selektiert Attribut “FIRSTNAME” in Brevo

attributes[2].text

Vorname ??

1:1

Überträgt Vorname nach attributes[2]

attributes[3].name

Formel “SALUTATION

Selektiert Attribut “SALUTATION” in Brevo

attributes[3].text

Anrede.Anrede

1:1

Überträgt Anrede nach attributes[3]

email

berechnet aus verschiedenen Feldern (siehe nächste Spalte)

Formel “EMailNewsletter ?? EMailD ?? EMail ?? EMailG”

Überträgt berechnete E-Mail nach email (Reihenfolge ist gemäss Spezifikation anzupassen)

listids

--

Formel ‘Listen-ID’ (siehe Zuordnungen oben)

Listen-ID der Listen in Brevo

attributes[4].name

Formel “LANGUAGE”

Selektiert Attribut “LANGUAGE” in Brevo

attributes[4].text

Sprache

1:1

Überträgt Sprache nach attributes[4]

attributes[5].name

Formel “DATEOFBIRTH”

Selektiert Attribut “DATEOFBIRTH” in Brevo

attributes[5].text

Geburtsdatum

1:1

Überträgt Geburtsdatum nach attributes[5]

attributes[6].name

Formel “SMS”

Selektiert Attribut “SMS” in Brevo

attributes[6].text

Natel

1:1

Überträgt Natel nach attributes[6]

3. Synchronisierung der BrevoIDs nach PerformX

Brevo Beschreibung

PerformX Beschreibung

Mapping/Übertrag an Brevo

Beschreibung

email

berechnet aus verschiedenen Feldern (siehe nächste Spalte)

Formel “EMailNewsletter ?? EMailD ?? EMail ?? EMailG”

Überträgt berechnete E-Mail nach email (Reihenfolge ist gemäss Spezifikation anzupassen)

id

BrevoID

1:1

ID, die aus Brevo nach PerformX übertragen wird

4. Aktualisierung bestehender Adressen

Brevo Beschreibung

PerformX Beschreibung

Mapping/Übertrag an Brevo

Beschreibung

attributes[0].name

Formel “EMAIL”

Selektiert Attribut “EMail” in Brevo

attributes[0].text

berechnet aus verschiedenen Feldern (siehe nächste Spalte)

Formel “EMailNewsletter ?? EMailD ?? EMail ?? EMailG”

Überträgt berechnete E-Mail nach attributes[0] (Reihenfolge ist gemäss Spezifikation anzupassen)

attributes[1].name

Formel “LASTNAME”

Selektiert Attribut “LASTNAME” in Brevo

attributes[1].text

Name ??

1:1

Überträgt Name nach attributes[1]

attributes[2].name

Formel “FIRSTNAME”

Selektiert Attribut “FIRSTNAME” in Brevo

attributes[2].text

Vorname ??

1:1

Überträgt Vorname nach attributes[2]

attributes[3].name

Formel “SALUTATION

Selektiert Attribut “SALUTATION” in Brevo

attributes[3].text

Anrede.Anrede

1:1

Überträgt Anrede nach attributes[3]

attributes[4].name

Formel “LANGUAGE”

Selektiert Attribut “LANGUAGE” in Brevo

attributes[4].text

Sprache

1:1

Überträgt Sprache nach attributes[4]

attributes[5].name

Formel “DATEOFBIRTH”

Selektiert Attribut “DATEOFBIRTH” in Brevo

attributes[5].text

Geburtsdatum

1:1

Überträgt Geburtsdatum nach attributes[5]

attributes[6].name

Formel “SMS”

Selektiert Attribut “SMS” in Brevo

attributes[6].text

Natel

1:1

Überträgt Natel nach attributes[6]

attributes[7].name

Formel “LASTUPDATE”

Selektiert Attribut “LASTUPDATE” in Brevo

attributes[7].numeric

DatumMutation

1:1

Überträgt ID nach attributes[0]

email

Formel “'{BrevoID}'“

Setzt den Query-Parameter für den Abgleich

4.3 Definition Zielverbindung Brevo

Name

KUNDE Brevo

Verbindungsart

OpenAPI

Serveradresse

https://api.brevo.com/v3

Relativer Pfad zur OpenAPI Definition

/swagger_definition.yml

Verbindungszertifikat überprüfen

Ja

5. Konfiguration Brevo

5.1 Notwendige Listen

Liste 1

KUNDE_OptIn

Liste 2

identified_contacts

Liste 2

KUNDE_Newsletter

5.2 Kontaktattribute

Attributname

Attributart

EMAIL

Text

SALUTATION

Text

LASTNAME

Text

FIRSTNAME

Text

LANGUAGE

Text

DATEOFBIRTH

Datum

LASTUPDATE

Datum

DOUBLE_OPT-IN

Kategorie

SALUTATION

Text