MINERVA-Ecks: Neue Unterseite: allgemeine openTRANS-Schnittstellen (Open Trans 1.0 und 2.1), Empfangsjob-Typen OPT/OPTA/OPTL

2026-09-23T09:24:45Z

Neue Unterseite: allgemeine openTRANS-Schnittstellen (Open Trans 1.0 und 2.1), Empfangsjob-Typen OPT/OPTA/OPTL

Neue Seite

{{Vorlage:Stammdaten}}
= openTRANS allgemein =

openTRANS ist ein Standardformat für Geschäftsdokumente wie Bestellungen, Auftragsbestätigungen und Lieferavise. Viele Lieferanten nehmen Bestellungen in diesem Format an. Für Lieferanten ohne eigene Datenübertragungsart in OBS gibt es die beiden allgemeinen Arten ''Open Trans'' (openTRANS 1.0) und ''Open Trans 2.1''. Welche Version Ihr Lieferant erwartet, gibt der Lieferant vor.

Eine Übersicht aller Schnittstellen finden Sie unter [[OBS/Stammdaten/Schnittstellen/Lagerlieferanten|Lagerlieferanten]].

{| class="wikitable"
! Merkmal !! Open Trans !! Open Trans 2.1
|-
| Format || openTRANS 1.0 (XML, ISO-8859-1) || openTRANS 2.1 (XML, UTF-8)
|-
| Übertragungsweg || FTP-Job || FTP-Job
|-
| Auftragsbestätigung || ✓ || ✓
|-
| Lieferavis || ✓ || ✓
|-
| Rechnung einlesbar || ✓ über [[OBS/Stammdaten/Schnittstellen/Verbandsabrechnung|Verbandsabrechnung]] (openTRANS 1.0) || –
|-
| Streckenlieferung || ✓ || ✓
|}

== 1 Voraussetzungen ==

Bei ''Open Trans'' muss in der Bestellung Ihre Kundennummer beim Lieferanten eingetragen sein. Fehlt sie, bricht OBS den Export mit der Meldung „Interne Kundennummer beim Lieferanten nicht hinterlegt!" ab.

== 2 Einrichtung ==

Legen Sie den Lieferanten wie unter [[OBS/Stammdaten/Schnittstellen/Lagerlieferanten/Einrichtung|Einrichtung]] beschrieben als Lagerlieferanten an und wählen Sie als '''Datenübertragungsart''' ''Open Trans'' oder ''Open Trans 2.1''.

{| class="wikitable"
! Feld !! Bedeutung
|-
| Name des FTP Hosts, Benutzername, Passwort, FTP Port || Zugang zum Server des Lieferanten.
|-
| Sendeordner || Ordner auf dem Server, in den OBS die Bestelldateien überträgt.
|-
| Empfangsordner || Ordner auf dem Server, aus dem OBS Auftragsbestätigungen und Lieferavise abholt.
|-
| Aktiv || Bei ''Open Trans'' und ''Ja'' legt OBS beim Speichern zwei Empfangsjobs an: für Auftragsbestätigungen (Dateien ''ORDRSP-*'') und für Lieferavise (Dateien ''DESADV-*''). Bei ''Open Trans 2.1'' legt OBS keine Empfangsjobs an.
|-
| Kundenauftragsnummer statt der eigenen übergeben (Büroring) || Gilt trotz der Beschriftung auch für ''Open Trans'' (nicht für ''Open Trans 2.1''): Als Kundenbestellnummer wird die Auftragsnummer Ihres Kunden übertragen statt Ihrer OBS-Auftragsnummer.
|}

=== 2.1 Empfangsjobs selbst anlegen ===

Legen Sie Empfangsjobs, die OBS nicht automatisch anlegt, in der [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]] an und geben Sie ihnen einen der folgenden Typen:
* ''OPT'' – OBS erkennt die Art der Rückmeldung am Dateinamen: Dateien, die mit ''ORDRSP'' oder ''OR'' beginnen, sind Auftragsbestätigungen; Dateien, die mit ''DESADV'', ''DLV'' oder ''AXDNO'' beginnen, sind Lieferavise.
* ''OPTA'' – alle Dateien des Jobs werden als Auftragsbestätigung verarbeitet.
* ''OPTL'' – alle Dateien des Jobs werden als Lieferavis verarbeitet.

== 3 Konfiguration ==

Die Einstellungen erreichen Sie über '''Stammdaten – Schnittstellen – Lagerlieferanten''', den Lieferanten auswählen, {{Return}}, '''X – Konfiguration'''. Ist die Liste leer, legt {{Einfg}} die Einträge an.

=== 3.1 Open Trans ===

{| class="wikitable"
! Einstellung !! Standard !! Bedeutung
|-
| Export.Übertragung.AltArtNr || N || Die alternative Artikelnummer aus dem Artikel wird zusätzlich übertragen.
|-
| Export.Übertragung.BeideAUNrs || N || Kundenauftragsnummer und OBS-Auftragsnummer werden gemeinsam in einem Feld übertragen.
|-
| Export.Übertragung.EigeneKundenNr || N || Ihre OBS-Kundennummer des Endkunden wird zusätzlich übertragen.
|}

=== 3.2 Open Trans 2.1 ===

{| class="wikitable"
! Einstellung !! Standard !! Bedeutung
|-
| Export.Übertragung.PartyID || ''leer'' || Feste Lieferanten-Kennung (Party Role „supplier") in der Datei.
|-
| Export.Übertragung.PartyIDILN || N || Bei ''J'' wird die feste PartyID als ILN gekennzeichnet.
|-
| Export.Übertragung.Email || ''leer'' || E-Mail-Adresse für den Kontakt in der Bestellung.
|-
| Export.Versand.KeineVersandkosten || N || Bei ''N'' überträgt OBS die [[OBS/Kostenfreie Module/Zusatzkosten|Zusatzkosten]] des Lieferanten als Versandkosten mit, bei ''J'' nicht.
|-
| Export.Versand.Mindermenge || ''leer'' || Versandkosten-Typ, der als Mindermengenzuschlag übertragen wird.
|-
| Export.Versand.Pauschale || ''leer'' || Versandkosten-Typ, der als Auftragspauschale übertragen wird.
|-
| Export.Versand.MehrlagerStrecke || N || Bei ''J'' werden Bestellungen für Lager, die als Streckenlager gekennzeichnet sind, wie Streckenbestellungen behandelt.
|-
| Export.Übertragung.TelePflicht || N || Bei ''J'' bricht OBS den Export mit einer Meldung ab, wenn in den eigenen Konstanten oder in der Lieferanschrift keine Telefonnummer eingetragen ist.
|-
| Export.Übertragung.LiefDatPos || N || Das Lieferdatum wird zusätzlich bei jeder Position übertragen.
|-
| Export.AufNrKu.proZeile || N || Die Auftragsnummer Ihres Kunden wird bei Streckenpositionen als Bemerkung übertragen.
|-
| Export.LS.Versand || N || Bei ''J'' wird die Lieferstufe übertragen, die im Versand für den Lieferanten hinterlegt ist.
|-
| Export.LS.Anweisung || N || Der Betreff der Bestellung wird als Lieferanweisung übertragen – nur zusammen mit einer Lieferstufe (''Export.LS.Versand'').
|-
| Export.LS.AnweisungRemark || N || Der Betreff der Bestellung wird als Bemerkung übertragen.
|-
| Export.Übertragung.NameSpace || ''leer'' || Namespace-Präfix für die betreffenden Elemente der Datei, falls der Lieferant eines verlangt.
|-
| Invoice.Import.FesterArtikel || ''leer'' || Fester Artikel für den Rechnungsimport.
|-
| Invoice.Import.FesterArtikelErm || ''leer'' || Fester Artikel (ermäßigter Steuersatz) für den Rechnungsimport.
|}

== 4 Übertragener Inhalt ==

{| class="wikitable"
! Angabe !! Open Trans !! Open Trans 2.1 !! Hinweis
|-
| Bestellnummer, Bestelldatum || ✓ || ✓ ||
|-
| Liefertermin || – || ✓ || Das Lieferdatum der Bestellung; ist keines eingetragen, setzt OBS ein Datum kurz nach dem Bestelldatum ein.
|-
| Ihre Kundennummer beim Lieferanten || ✓ || ✓ || Aus der Bestellung.
|-
| Kundenbestellnummer || ✓ || ✓ || Bei ''Open Trans'' OBS-Auftragsnummer oder Kundenauftragsnummer (siehe Einrichtung), bei ''Open Trans 2.1'' immer die OBS-Auftragsnummer.
|-
| Artikelnummer beim Lieferanten || ✓ || ✓ || Die Bestellnummer des Artikels beim Lieferanten.
|-
| Ihre eigene Artikelnummer || optional || ✓ || Bei ''Open Trans'' die alternative Artikelnummer über ''Export.Übertragung.AltArtNr''.
|-
| Menge und Einheit || ✓ || ✓ || Bei ''Open Trans 2.1'' nur ganze Mengen.
|-
| Preise || – || ✓ ||
|-
| Versandkosten || – || optional || Siehe ''Export.Versand.KeineVersandkosten''.
|-
| Lieferanschrift bei Streckenbestellung || ✓ || ✓ || Die Anschrift Ihres Kunden.
|-
| Lieferanschrift bei Lagerbestellung || – || ✓ || Bei ''Open Trans 2.1'' Ihre Firmenanschrift aus den [[OBS/System/Konstanten|Konstanten]].
|}

== 5 Besonderheiten ==

* OBS bricht den Export ab, wenn für eine Position keine Bestellnummer beim Lieferanten gefunden wird, und meldet die betroffene Position.
* Bei ''Open Trans 2.1'' werden die Positionsnummern dreistellig übertragen.
* Rückmeldungen verarbeiten Sie im [[OBS/Zusatzprogramme/FTP Ein- und Ausgänge|FTP-Eingang]]. Aus einem Lieferavis zu einer Streckenbestellung erstellt OBS dort den Einkaufslieferschein und den Lieferschein an Ihren Kunden.
* Für einzelne Lieferanten gibt es eigene openTRANS-Varianten mit Anpassungen, zum Beispiel [[OBS/Stammdaten/Schnittstellen/Lagerlieferanten/Soennecken|Soennecken]] oder [[OBS/Stammdaten/Schnittstellen/Lagerlieferanten/Tekno|Tekno]]. Eine vollständige Liste finden Sie in der [[OBS/Stammdaten/Schnittstellen/Lagerlieferanten|Übersicht]].

OBS/Stammdaten/Schnittstellen/Lagerlieferanten/openTRANS - Versionsgeschichte

MINERVA-Ecks: Neue Unterseite: allgemeine openTRANS-Schnittstellen (Open Trans 1.0 und 2.1), Empfangsjob-Typen OPT/OPTA/OPTL