Formatbeschreibung Siemens Inhouse
Veröffentlicht 2004
Copyright © 2001 von PMS COMPELEC GmbH
Die PMS COMPELEC GmbH haftet nicht für technische oder drucktechnische Fehler oder Mängel in diesen technischen Informationen und übernimmt auch keine Haftung für Schäden, die direkt oder indirekt auf Lieferung, Leistung und Nutzung dieses Materials zurückzuführen sind.
Diese technischen Informationen enthalten eigentumsrechtlich geschützte Informationen, die dem Urheberrecht unterliegen. Alle Rechte sind geschützt. Ohne vorherige Genehmigung von PMS COMPELEC GmbH dürfen diese Informationen weder vollständig noch in Auszügen kopiert oder anderweitig vervielfältigt werden.
Die in diesen technischen Informationen beschriebene Software unterliegt einem Lizenzvertrag. Nutzung und Vervielfältigung sind nur im Rahmen dieses Vertrages gestattet.
EPLAN® ist ein eingetragenes Warenzeichen der EPLAN Software & Service GmbH & Co. KG.
DATEV® ist ein eingetragenes Warenzeichen der DATEV eG.
Microsoft Windows® ist ein eingetragenes Warenzeichen der Microsoft Corporation.
Anmerkung: Für die verwendete Hardware gelten die von den Betriebssystemherstellern angegebenen Voraussetzungen. Hardware-Kombinationen, die laut Herstellerangaben Störungen verursachen, können auch auf den Betrieb von PMS Einfluss haben. Für den einwandfreien Betrieb von PMS ist daher eine fehlerfreie Grundinstallation von Hardware, Betriebssystem und Hardwaretreiber (z.B. Grafikkartentreiber etc.) Grundvoraussetzung. Die von den Hardware-Herstellern angegebenen Rahmenbedingungen und Anwendungsgebiete gelten sinngemäß auch für den Betrieb von PMS.
1.1 Struktur einer FlatFile–Übertragungsdatei
2.1.1 Darstellung von Feldformaten und –Längen
2.1.2 Auffüllen von nicht benutzten Zeichen
2.1.3 Status von Feldern und Sätzen
2.2 Nachrichtentypdiagramm ORDERSI (Siemens ORDERS)
1 Erläuterungen
1.1 Struktur einer FlatFile–Übertragungsdatei
Eine Übertragungsdatei besteht aus
|
UNBP einem Dateiheader – Satz für die gesamte FlatFile - Datei |
|
|
|
UNHP Nachrichtenheader - Satz FlatFile – Nachricht Nr. 1 … Nutzdatensätze |
|
UNHP Nachrichtenheader - Satz FlatFile – Nachricht Nr. 2 … Nutzdatensätze |
|
|
… … weitere Nachrichten … |
|
|
UNHP Nachrichtenheader - Satz FlatFile – Nachricht Nr. n … Nutzdatensätze |
|
1.2 FlatFile–Nachrichten
Jede FlatFile–Nachricht enthält FlatFile-Sätze die in folgenden Bereichen angesiedelt werden
- Kopf–Teil Diese Sätze beziehen sich auf die ganze Nachricht.
- Positions – Teil Diese Sätze beziehen sich nur auf die Positionsinformationen. Da diese Struktur je Nachricht mehrfach vorkommen kann, werden sie in Satzgruppen zusammengefasst.
1.3 FlatFile–Satzgruppen
Innerhalb einer Nachricht können sich Gruppen funktionell zusammenhängender Sätze wiederholen; diese Gruppen heißen „Satzgruppen“. Satzgruppen enthalten eine Abfolge von FlatFile–Sätzen (z.B. Satzgruppen für Positionsdaten in einer Rechnung). Innerhalb von Satzgruppen gibt es Muss- und Kann-Sätze mit unterschiedlicher Wiederholungshäufigkeit. Genauso sind Satzgruppen wiederholbar oder können entsprechend ihrer Definition weggelassen werden.
2 FlatFile-Sätze
FlatFile-Sätze sind mit fester Länge definiert und bestehen aus
- einer Satzerkennung zur Identifikation des Satzes (im ersten Feld „Keys“),
- FlatFile-Feldern und
- einem Satz-Endzeichen CRLF.
Es gibt Muss-Sätze (Status M=Memory und Kann-Sätze (Status C=Conditional).
Der gleiche Satztyp kann in mehreren Teilen der Nachricht vorkommen, z.B. im Kopf- und Positionsteil und/oder auch mehrfach im selben Nachrichtenteil. Einige Sätze können sich an ihrem bestimmten Platz in der Nachricht wiederholen. Die maximale Wiederholungshäufigkeit und der Status – Kann oder Muss – wird in der Nachrichtenstruktur vorgegeben.
Beispiel: UNHP1 ORDERSI2203521361 1998203...
Im Beispiel handelt es sich um einen Nachrichtenheader für eine ORDERSI-Nachricht (Siemens Orders).
2.1 FlatFile-Felder
Ein Feld wird durch seine Position im Satz identifiziert und hat gem. Definition eine fest vorgegebene Feldlänge. Ein Feld kann Code-Werte enthalten. Die erlaubten Codes sind der Spalte „Hinweise“ im Kapitel Nachrichtenstruktur zu entnehmen.
2.1.1 Darstellung von Feldformaten und –Längen
an alphanumerische Zeichen
n numerische Zeichen
an3 3 alphanumerische Zeichen (feste Feldlänge 3 Zeichen)
n3 3 numerische Zeichen (feste Feldlänge 3 Zeichen)
2.1.2 Auffüllen von nicht benutzten Zeichen
Das FlatFile-Format ist ein Format mit fester Salzlänge. Daher müssen Felder immer vollständig belegt werden.
Hierfür gibt es folgendes zu beachten:
- Alpha und alphanumerische Felder werden linksbündig befüllt und nach rechts mit Leerzeichen aufgefüllt.
Beispiel: Feld an25 [linksbündig befüllt]
- numerische Felder werden rechtsbündig befüllt und nach links mit Nullen [0]aufgefüllt.
Beispiel: Feld n10 [000012.345]
2.1.3 Status von Feldern und Sätzen
M Muss Feld (Mandatory)
C Kann Feld (Konditional)
2.1.4 Dezimalzeichen
Als Dezimalzeichen wird der Punkt (.) verwendet. Der Dezimalpunkt wird bei der Ermittlung der Feldlänge eines Feldes mitgezählt.
Außer dem Dezimalzeichen sind keine weiteren Gliederungszeichen zugelassen. (Erlaubt: 2500000; Nicht erlaubt: 2,500,000 oder 2.500.000 oder 2 500 000).
2.2 Nachrichtentypdiagramm ORDERSI (Siemens ORDERS)
ORDERSI Auftrag Siemens
UNHP Status M Wdh 1 Ebene 0
Nachrichtenheader
RFFP Status C Wdh 1 Ebene 0
Referenzangaben
NBYP Status M Wdh 1 Ebene 0
Name und Adresse des Käufers
NSUP Status M Wdh 1 Ebene 0
Name und Adresse des Lieferanten
NUCP Status C Wdh 1 Ebene 0
Name und Adresse des endgültigen Warenempfängers
NBTP Status C Wdh 1 Ebene 0
Name und Adresse eines Beteiligten, der mit anderen als Frachtkosten belastet
wird
SAGLIN Status M Wdh 200000 Ebene 1
Satzgruppe für Positionsdaten
LINP Status M Wdh 1 Ebene 1
Positionsdaten
FTXP Status C Wdh 1 Ebene 2
Freier Text
PRIP Status C Wdh 1 Ebene
2
Preisdaten
ALLP Status C Wdh 15 Ebene
2
Artikel Zu-/Abschlag auf Positionsebene
|
Satzart UNBP (104 Zeichen) - Dateiheader für die gesamte Inhouse- Status M Wdh. 1 max. Wdh. 1 |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzerkennung |
Erlaubter Code UNBP |
|
SEID |
M |
5 |
an35 |
Sender-ID, Absenderbezeichnung Name oder Code, der den Absender einer Übertragungsdatei identifiziert |
|
|
SILN |
M |
40 |
an35 |
Empfänger - ID, Empfängerbezeichnung Name oder Code, der den Empfänger einer Übertragungsdatei identifiziert. |
|
|
TEST |
C |
75 |
n1 |
Testkennung |
Muss belegt werden, wenn es sich um eine Testdatei handelt Erlaubte Codes 0 kein Test |
|
R020 |
C |
76 |
an14 |
Datenaustauschreferenz für UNB. 0020 Eindeutige Referenznummer zur Identifizierung der vorliegenden Übertragungsdatei. |
|
|
R014 |
C |
90 |
an14 |
Weiterleitungsadresse für UNB. 0014 Eine Adresse, die vom Empfänger einer Übertragungsdatei definiert wurde. Sie ist vom Absender anzugeben und wird vom Empfänger zur Weiterleitung von Übertragungsdateien innerhalb seiner Organisation verwendet. |
|
|
Satzart UNHP (98 Zeichen) - Nachrichtenheader- Status M Wdh. 1 max. Wdh. 1 |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzerkennung |
Erlaubter Code UNHP |
|
RFNR |
M |
5 |
an14 |
Referenznummer der Nachricht |
|
|
TYPE |
M |
19 |
an7 |
Nachrichtenkennung codiert |
erlaubter Code ORDERSI Auftrag |
|
DOCN |
M |
26 |
an3 |
Dokumentenname codiert |
erlaubter Code 220 Bestellung/Auftrag |
|
DCID |
M |
29 |
an35 |
Dokumentennummer/- Identifikation |
|
|
DCDT |
M |
64 |
N8 |
Dokumentendatum JJJJMMTT |
|
|
COUN |
C |
72 |
an3 |
Land codiert |
|
|
ZPRF |
C |
75 |
an3 |
Art der Zollregelung, codiert Identifikation der Regelung, nach der volle oder Präferenz- Zollsätze angewendet werden. |
|
|
SOKO |
C |
78 |
an2 |
Sonderkonditionskennung
|
erlaubte Codes 18
BRD-Ausfuhrgenehmigunspflichtig |
|
SOKO |
C |
80 |
an2 |
Sonderkonditionskennung
|
Erlaubte Codes 16 US-Embargopflichtig |
|
CUXD |
M |
82 |
an3 |
Währung des Belegs, ISO 4217 3-Alpha-Code |
|
|
LFPT |
C |
85 |
an2 |
Lieferungsanforderung, codiert Kennzeichen für allgemeine Lieferungsanforderungen. |
Erlaubte Codes BK Teillieferung zugelassen |
|
LFDT |
C |
87 |
n8 |
Lieferdatum JJJJMMTT
|
Gewünschtes Lieferdatum |
|
RSAB |
C |
95 |
n1 |
Schalter Betriebeswirtschaftliche Bestätigung erwünscht |
erlaubte Codes 0 Bestätigung nicht erwünscht |
|
Satzart RFFP (75 Zeichen) - Referenzangaben - Status C Wdh. 1 max. Wdh. 1 |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzerkennung |
Erlaubter Code RFFP |
|
RFCT |
C |
5 |
an35 |
Vertragsnummer |
|
|
SEA2 |
C |
40 |
an35 |
Siemens-interne Kontierungsangabe AKZ2 |
Nur für Siemens-interne Besteller |
|
Satzart NBYP (213 Zeichen) - Angaben des Bestellers Status M Wdh. 1 max. Wdh. 1 |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzerkennung |
Erlaubter Code NBYP |
|
CILN |
C |
5 |
n13 |
ILN des Beteiligten |
|
|
SE91 |
M |
18 |
an13 |
Siemens-interne Partnernummer |
|
|
SENR |
C |
31 |
an13 |
Siemens interner Partner Code für NRS |
|
|
SEA1 |
C |
44 |
an35 |
Siemens-interne Kontierungsangabe AKZ1 |
|
|
TXID |
C |
79 |
an14 |
Umsatzsteuer ID |
|
|
ORNM |
M |
93 |
an35 |
Name des Bestellers |
|
|
ORDP |
M |
128 |
an35 |
Abteilung des Bestellers |
|
|
TFON |
M |
163 |
an25 |
Telefonnummer |
|
|
TFAX |
C |
188 |
an25 |
Faxnummer |
|
|
Satzart NSUP (66 Zeichen) - Angaben des Lieferanten Status M Wdh. 1 max. Wdh. 1 |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzerkennung |
Erlaubter Code NSUP |
|
CILN |
C |
5 |
n13 |
ILN des Beteiligten |
|
|
SE92 |
M |
18 |
an35 |
Vom Lieferanten für Siemens vergebene Partnernummer |
|
|
SENR |
C |
53 |
an13 |
Siemens interner Partner-Code für NRS |
|
|
Satzart NUCP (166 Zeichen) - Abweichende Lieferadresse Status C Wdh. 1 max. Wdh. 1 |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzerkennung |
Erlaubter Code NUCP |
|
PART |
M |
5 |
an13 |
(leer) |
|
|
CNAM |
M |
18 |
an35 |
Name 1 |
|
|
CNAM |
M |
53 |
an35 |
Name 2 |
|
|
STRT |
M |
88 |
an35 |
Straße |
|
|
LOCA |
M |
123 |
an35 |
ORT |
|
|
PLZ0 |
M |
158 |
an5 |
Postleitzahl |
|
|
COUN |
M |
163 |
an3 |
Land codiert |
|
Satzart NBTP - Abweichende Rechnungsadresse Status C Wdh. 1 max. Wdh. 1 (derzeit von PMS nicht verwendet) |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzerkennung |
erlaubter Code NBTP Dieses Segment kann z. Zeit nicht verwendet werden |
|
CNAM |
M |
5 |
an35 |
Name |
|
|
CNAM |
M |
40 |
an35 |
Name |
|
|
STRT |
M |
75 |
an19 |
Straße |
|
|
LOCA |
M |
94 |
an19 |
ORT |
|
|
PLZ0 |
M |
113 |
an5 |
Postleitzahl |
|
|
COUN |
M |
118 |
an3 |
Land codiert |
|
|
Satzgruppe SAGLIN -Positionsdaten Status M Wiederholung 1 max. Wiederholung 200000 |
|||||||||
|
Satzart LINP (352 Zeichen) - Positionsdaten Status M Wdh. 1 max. Wdh. 1 |
|||||||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
||||
|
KEYS |
M |
1 |
an4 |
Satzerkennung |
Erlaubter Code LINP |
||||
|
POSN |
M |
5 |
n5 |
Positionsnummer fortlaufende, aufsteigende Positionsnummer je Positionsdatensatz. Je Belag Beginnend mit 1. |
|
||||
|
EAN0 |
C |
10 |
n13 |
EAN Artikelnummer |
EAN in Abstimmung mit Siemens |
||||
|
SEAN |
M |
23 |
an31 |
Artikelnummer von Siemens (MLFB) |
Siemens.Artikelnummer (MLFB) oder Artikelnummer des Bestellers, wenn mit Siemens vereinbart |
||||
|
REAN |
C |
54 |
an31 |
Artikelnummer des Verkäufers |
Siemens Artikelnummer (MLFB), wenn SEAN Artikelnummer des Bestellers |
||||
|
SEIS |
C |
85 |
an31 |
Verschlüsselte Kurzangabe für Artikel, Leistung, Produkt (BAV - Textart B) |
Nur in Abstimmung mit Siemens |
||||
|
SEIS |
C |
116 |
an31 |
Verschlüsselte Kurzangabe für Artikel, Leistung, Produkt (BAV - Textart B) |
Nur in Abstimmung mit Siemens |
||||
|
SEIS |
C |
147 |
an31 |
Verschlüsselte Kurzangabe für Artikel, Leistung, Produkt (BAV - Textart B) |
Nur in Abstimmung mit Siemens |
||||
|
SETE |
C |
178 |
an31 |
Unverschlüsselte Vollidentifizierte Erzeugungsnummer (Kurzangabe BAV-Textart E) |
Nur in Abstimmung mit Siemens |
||||
|
SETE |
C |
209 |
an31 |
Unverschlüsselte Vollidentifizierte Erzeugungsnummer (Kurzangabe BAV-Textart E) |
Nur in Abstimmung mit Siemens |
||||
|
SETE |
C |
240 |
an31 |
Unverschlüsselte Vollidentifizierte Erzeugungsnummer (Kurzangabe BAV-Textart E) |
Nur in Abstimmung mit Siemens |
||||
|
SETE |
C |
271 |
an31 |
Unverschlüsselte Vollidentifizierte Erzeugungsnummer (Kurzangabe BAV-Textart E) |
Nur in Abstimmung mit Siemens |
||||
|
SETE |
C |
302 |
an31 |
Unverschlüsselte Vollidentifizierte Erzeugungsnummer (Kurzangabe BAV-Textart E) |
Nur in Abstimmung mit Siemens |
||||
|
QTYC |
M |
333 |
n8 |
Berechnete Menge |
|
||||
|
QTYU |
M |
341 |
an3 |
Mengeneinheit |
erlaubte Codes PCE Stück |
||||
|
LFDT |
M |
344 |
N8 |
Lieferdatum JJJJMMTT |
Positionsbezogenes Lieferdatum |
||||
|
Satzgruppe SAGLIN - Postitionsdaten Status M Wiederholung 1 max. Wiederholung 200000 |
|||||
|
Satzart FTXP -Freier Text für Hinweise, die auf Status C Wdh. 1 max. Wdh. 1 Lieferschein und Rechnung über- nommen werden |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzkennung |
erlaubter Code FTXP |
|
INID |
M |
5 |
an3 |
Inhaltskennung |
erlaubte Codes CUR Anmerkungen des Kunden |
|
TEXT |
M |
8 |
an31 |
Textelement |
|
|
TEXT |
C |
39 |
an31 |
Textelement |
|
|
TEXT |
C |
70 |
an31 |
Textelement |
|
|
TEXT |
C |
101 |
an31 |
Textelement |
|
|
TEXT |
C |
132 |
an31 |
Textelement |
|
|
TEXT |
C |
163 |
an31 |
Textelement |
|
|
TEXT |
C |
194 |
an31 |
Textelement |
|
|
TEXT |
C |
225 |
an31 |
Textelement |
|
|
TEXT |
C |
256 |
an31 |
Textelement |
|
|
TEXT |
C |
287 |
an31 |
Textelement |
|
|
TEXT |
C |
318 |
an31 |
Textelement |
|
|
TEXT |
C |
349 |
an31 |
Textelement |
|
|
TEXT |
C |
380 |
an31 |
Textelement |
|
|
TEXT |
C |
411 |
an31 |
Textelement |
|
|
Beispiel FTXPCURBestellinfo 1 und2 |
|||||
|
Satzgruppe SAGLIN - Positionsdaten Status M Wiederholung 1 max. 200000 |
|||||
|
Satzart PRIP - Preisdaten Status C Wdh. 1 max. Wdh. 1 |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzkennung |
erlaubter Code PRIP |
|
PRIK |
M |
5 |
an3 |
Preisschlüssel |
erlaubte Codes CAL Preis ist Kalkulationsbasis (für diese Bestellung) |
|
PRIU |
M |
8 |
n15 |
Preis/Einheit |
|
|
PRBM |
M |
23 |
n9 |
Preisbasis-Menge Anzahl der Mengeneinheiten, auf die sich der Preis je Einheit bezieht. |
|
|
QTYU |
M |
32 |
an3 |
Mengeneinheit |
erlaubte Codes PCE Stück |
|
Beispiel PRIPCAL000000022575.00000000001PCE |
|||||
|
Satzgruppe SAGLIN - Postitionsdaten Status M Wiederholung 1 max.Wiederholung 200000 |
|||||
|
Satzart ALLP - Artikel Zu-/Abschlag auf Positionsebene Status C Wdh. 1 max.Wdh. 15 |
|||||
|
Feld |
St |
Pos |
Format |
Beschreibung |
Hinweise |
|
KEYS |
M |
1 |
an4 |
Satzkennung |
erlaubter Code ALLP |
|
ALCI |
M |
5 |
an1 |
Zu-/Abschlagskennung Angabe, ob der Betrag für eine bestimmte Dienstleistung als ein Zu- oder Abschlag zu werten ist. |
erlaubte Codes H Abschlag auf Positionsebene |
|
ALCE |
M |
6 |
an3 |
Erläuterung zum Zu-/Abschlag |
erlaubte Codes RAA Rabatt |
|
ALCS |
M |
9 |
n4 |
Rabatt-Prozentsatz |
|
|
Beispiel ALLPHRAA12.5 |
|||||