Wo finde ich die Import-Schnittstellen-Spezifikation?

Interface Import| XML | Json

Die Import-Schnittstelle bietet Ihnen die Möglichkeit, gewünschten Inhalte aus Ihrem System als Datensätze an guidle zu übertragen:

Format/Struktur
Sie stellen die Daten als XML in der guidle StandardImportInterface-Struktur zur Verfügung. Unter "Download" finden Sie die Schnittstellenbeschreibung, die Schema-Datei und ein Beispiel-File

Modus
Die Import-Schnittstelle funktioniert im FULL-Modus. Sie stellen uns immer einen kompletten Datensatz zur Verfügung. Der guidle Importprozess kümmert sich um die korrekte Erstellung und Aktualisierung von Anzeigen.
In Ausnahmefällen unterstütz das Import-Interface einen DELTA-Modus. Dieser ist aber nur unter Absprache mit guidle zu verwenden. Melden Sie sich dafür beim guidle Support.

Feld guidle:sourceOfferId
Diese Feld dient zur eindeutigen Identifikation einer Anzeige beim Importprozess und muss über den ganzen Daten-Feed eindeutig sein. Nach der Eventübermittlung an guidle, darf sich diese ID für eine Anzeige nicht mehr ändern. Idealerweise wird eine Datenbankinterne VeranstaltungsID dafür verwendet.

Feld guidle:sourceBpId und guidle:bpId
Diese Felder sind für jedes Import-Interface individuell. Bitte fragen Sie die zu verwendende ID bei guidle Support an.

Übermittlung von Anzeigen verschiedener Institutionen
Für den Fall, dass Ihr Import-Interface Anzeigen verschiedener Institutionen an guidle übermittelt, ist der Container "guidle:customBusinessPartner" zu verwenden. Darin teilen Sie uns für jede Anzeige mit zu welcher Institution diese gehört. Idealerweise sind uns die folgenden vier Felder zu übermitteln:

> guidle:ownerReferenceId
> guidle:ownerReferenceName
> guidle:ownerReferenceZip
> guidle:ownerReferenceCity

Es reicht aber auch schon das Feld guidle:ownerReferenceId. Es gilt zu beachten, dass die Kombination der Felder eine eindeutige Identifikation einer Institution zulässt.
Wird der Container "guidle:customBusinessPartner" verwendet, so muss das Feld  "guidle:bpId" (siehe Abschnitt oben) aus dem Datenfeed entfernt werden.

Kategorisierung
Mittels guidle:customClassification können Sie uns für jeden Inhalt die entsprechende Kategorisierung aus Ihrem SourceSystem übermitteln. guidle überführt diese Kategorisierung beim Importprozess mittels Kategorienmapping in die passende guidle-Kategorie.

Datenbereitstellung
Stellen Sie uns die das XML via URL zur Verfügung. In Absprache mit Ihnen definiert guidle wann und wie oft die Daten von diesem Link abgerufen werden.


Downloads

• Schnittstellenspezifikation Standard Import Interface
• Schema-Datei
• Beispiel-File