XML-Schnittstelle #

Die optionale XML-Schnittstelle von EULANDA ermöglicht den Import und Export von Stamm- und Bewegungsdaten im XML-Format. Sie dient zum Datenaustausch zwischen EULANDA-Installationen, zur Anbindung von Shop-Systemen und zur Integration mit externen Anwendungen.

Die Schnittstelle kann über den Importdialog in EULANDA, per Kommandozeile oder programmgesteuert über das XMLLIB-Objekt angesprochen werden.

Datenformat #

Alle EULANDA-XML-Dateien folgen einer einheitlichen Struktur:

<?xml version="1.0" encoding="WINDOWS-1252"?>
<EULANDA>
  <METADATA>
    <VERSION>1.1</VERSION>
    <GENERATOR>MeinScript</GENERATOR>
    <DATEFORMAT>ISO8601</DATEFORMAT>
    <FLOATFORMAT>US</FLOATFORMAT>
    <FIELDNAMES>NATIVE</FIELDNAMES>
    <DATE>2026-03-14T12:00:00</DATE>
    <PCNAME>MUSTERPC</PCNAME>
    <USERNAME>MUSTERMANN</USERNAME>
    <DATABASEVERSION>4.69</DATABASEVERSION>
  </METADATA>
  <!-- Datenobjekte -->
</EULANDA>

Metadata-Block #

Der <METADATA>-Block ist Pflicht und beschreibt Format und Herkunft der Daten:

Element	Beschreibung
`VERSION`	Formatversion (aktuell: `1.1`)
`GENERATOR`	Name des erzeugenden Systems
`DATEFORMAT`	Datumsformat – nur `ISO8601` wird unterstützt
`FLOATFORMAT`	Zahlenformat – nur `US` (Dezimalpunkt, keine Tausendertrenner)
`FIELDNAMES`	Feldnamen – nur `NATIVE` (Datenbank-Feldnamen)
`DATE`	Erzeugungsdatum im ISO-8601-Format
`PCNAME`	Name des erzeugenden Computers
`USERNAME`	Benutzername
`DATABASEVERSION`	Version der Datenbankstruktur

Datentypen #

Typ	Format	Beispiel
Feldnamen	Großbuchstaben	`ARTNUMMER`
Gleitkomma	US-Format (Dezimalpunkt, keine Tausendertrenner)	`47.23`
Datum	ISO 8601	`2026-03-14`
Datum/Zeit	ISO 8601	`2026-03-14T12:00:00`
Mehrzeiliger Text	HTML-Tags möglich, Sprachabschnitte in Klammern	`Text [EN]English text`
Bilder	BASE64-kodiertes JPEG	(Binärdaten)

ID.ALIAS – Verknüpfung beim Import #

Der ID.ALIAS-Mechanismus ermöglicht die Verknüpfung von Datensätzen innerhalb einer XML-Datei, ohne dass Datenbank-IDs bekannt sein müssen. Jeder Datensatz erhält einen eindeutigen Text-Alias:

<ADRESSELISTE>
  <ADRESSE>
    <ID.ALIAS>MEINKUNDE</ID.ALIAS>
    <MATCH>MEINKUNDE</MATCH>
    <NAME3>Musterfirma GmbH</NAME3>
    ...
  </ADRESSE>
</ADRESSELISTE>
<AUFTRAGLISTE>
  <AUFTRAG>
    <!-- Verknüpfung über den Alias -->
    <ADRESSEID.ALIAS>MEINKUNDE</ADRESSEID.ALIAS>
    ...
  </AUFTRAG>
</AUFTRAGLISTE>

Datenobjekte (DBObject) #

Beim Import und Export werden die Daten über DBObject-Namen angesprochen:

DBObject	XML-Element	Beschreibung
`SALESARTICLE`	`<ARTIKELLISTE>`	Artikel/Produkte
`SALESADDRESS`	`<ADRESSELISTE>`	Adressen/Kunden
`SALESORDER`	`<AUFTRAGLISTE>`	Aufträge
`SALESOFFER`	`<ANGEBOTLISTE>`	Angebote
`PROPERTY`	`<MERKMALLISTE>`	Merkmalbaum

Zusätzlich können Konstantentabellen importiert werden:

XML-Element	Beschreibung
`<KONZIELLISTE>`	Zahlungsbedingungen
`<KONERLOESKONTOLISTE>`	Erlöskonten
`<KONWGLISTE>`	Warengruppen
`<KONVERSANDARTLISTE>`	Versandarten
`<KONBANKLISTE>`	Bankverbindungen

Kommandozeilen-Import #

Der XML-Import kann auch ohne Benutzerinteraktion über die Kommandozeile ausgeführt werden:

EULANDA.exe -m MeinMandant -xml C:\Daten\Import.xml

Bei erfolgreichem Import wird die Datei automatisch umbenannt (z.B. Import(2).xml).

Export-Optionen #

Beim Export über das XMLLIB-Objekt können zusätzliche Daten einbezogen werden:

Option	Beschreibung
`SHOP`	Shop-spezifische Felder exportieren (Artikeltyp, Varianten, SEO-Daten)
`STOCK`	Lagerbestände im `<LAGER>`-Block exportieren
`BOM`	Stücklisten im `<JUMBO>`-Block exportieren
`PROPERTY`	Merkmalpfade im `<MERKMALLISTE>`-Block exportieren
`LANGUAGE`	Nur Texte einer bestimmten Sprache exportieren (ISO-Code)
`PLAINTEXT`	HTML-Tags aus Texten entfernen

EulandaXtools – Moderner Nachfolger #

Für neue Projekte empfiehlt sich die Verwendung von EulandaXtools – einem PowerShell-Modul, das die XML-Schnittstelle erheblich erweitert:

Standardkonformität: EN16931, XRechnung, ZUGFeRD, Peppol (UBL)
84 XSD-Schemas für Validierung und Formatdefinition
Erweiterte Datenobjekte: Rechnungen, Lieferscheine, Serviceartikel
XSLT-Transformationen: Automatische Konvertierung zwischen EULANDA-XML und Austauschformaten (EDIFACT, BMEcat, CII)
Zeitzone und UTC: Erweiterte Metadata mit DATEUTC, TIMEZONE, UTC_OFFSET
Queue-basierte Verarbeitung: Pipeline für EDI-Nachrichten

EulandaXtools nutzt dasselbe EULANDA-XML-Grundformat, erweitert es aber um komplexe Strukturen und internationale Standards. Eine Übersicht gibt es im EULANDA-Handbuch unter CrossDataHub.

Unterseiten #

Datenobjekte – Feldbeschreibungen aller XML-Objekte
Beispiele – XML-Beispieldateien und VBScript-Integration