Notwendige XML-Codes für elektronische Auftragsbestätigungen im Format OEX 3.0

    Auf den kommenden Seiten werden alle Knoten und Bereiche näher analysiert, die seitens Concept Office zwingend erforderlich sind. Diese Beschreibung basiert auf Basis von OEX 3.0 – zwischen den verschiedenen OEX Versionen (z. B. 2.1 und 3.0) gab es inkompatible Änderungen. Es sollte mit dem derzeit aktuellen Standard 3.0 gearbeitet werden.

     

    oexDocFrame

    Basisknoten mit Versionsinformationen, unterstützt werden: 1.1.0, 1.1.1, 2.1.0, 3.0.0

    Handelt es sich um eine unbekannte Version, wird versucht mit dem Major zu importieren.

    <oexDocFrame aMajor="3" noNamespaceSchemaLocation="oex-ordrsp_3.0.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

     

    oexFile

    Bevorzugt sollte nur ein Dokument pro AB übermittelt werden, bisher gibt es keinen Hersteller, der mehrere im Einsatz verwendet.

    <oexFile aDocumentCount="1">

     

    vDocumentType

    Auf Basis dieser Angaben wird ermittelt, welches Import-Schema verwendet wird (siehe oexDocFrame). Ebenso muss der Typ „ORDRSP“ verwendet werden, ansonsten schlägt das Einlesen der Auftragsbestätigung fehl.

    <vDocumentType aMajor="3" aMinor="0" aBuild="0">ORDRSP</vDocumentType>

     

    oexDocument

    Die Anzahl der Items wird gegen die tatsächlich importierten Positionen geprüft, der Inhalt des Knotens wird in den Reiter Kopf und Positionen behandelt.

    <oexDocument aDocNo="1" aItemCount="2" aAction="M">

     

    docHeader

    <docHeader aAction="C">

     

    Pflichtfelder

    Die folgenden Felder sind für den Betrieb des eAB-Moduls zwingend erforderlich.

    <vPrecedingDocType>ORD</vPrecedingDocType>

    <vPrecedingDocNo>123456</vPrecedingDocNo>

    Bestellnummer, beide Zeilen notwendig!

    <vOrderConfirmNo>567890</vOrderConfirmNo>

    Hersteller Auftragsbestätigungsnummer

    <vClientNumber>00000</vClientNumber>

     

    <vVendorNumber>XX</vVendorNumber>

    Herstellerkürzel. Zuordnung Auftragsbestätigung zu Hersteller.

    <vDocCurrency>EUR</vDocCurrency>

    Währung

    <vPartialDelivery>N</vPartialDelivery>

    Teillieferung Ja / Nein

    <vDocLanguage>de</vDocLanguage>

    Dokumentensprache

    <vOrderType>SO</vOrderType>

     

      

    hdrDocNo

    CON (Rahmenvertragsnummer)

    <hdrDocNo>

     

     

    <vDocNoType aContext=“R“>CON</vDocNoType>
    <vDocNo>***Rahmenvertragsnummer***</vDocNo>

    </hdrDocNo>

     

     

    hdrOrgData

    SOR (Mandant)

    Verkaufsorganisation (SOR) wird gegen Mandantennummer geprüft und ist zwingend erforderlich.

    < HdrOrgData>

     

     

    <OrgDataType aContext=“R“>SOR</OrgDataType>
    <OrgDataValue>98</OrgDataValue>

    </HdrOrgData>

     

     

    SGR

    Verkäufergruppe (SGR) wird aktuell nur für einen Hersteller verwendet.

     

    hdrDateTime

    Bei allen folgenden hdrDateTime Angaben werden sowohl Tag (D), als auch Wochenangaben (W) unterstützt. Bitte achten Sie auf die Kleinschreibung von „hdr“!

     

    DLD (Liefertermine)

    Es werden die Angaben in folgender Reihenfolge ausgewertet:

    • Fixtermin (FXD),
    • Liefertermin (DLD),
    • Spätester Liefertermin (LPD)
    • Frühester Liefertermin (EPD)

    <hdrDateTime>

     

     

    <vDateTimeType>DLD</vDateTimeType>
    <vTimeZone>+0100</vTimeZone>
    <vDateValue aDateFormat="D">20190709</vDateValue>

    </hdrDateTime>

     

     

    hdrAddress

    SO (Käuferanschrift)

    <hdrAddress>

     

     

     

    <vAddressType>SO</vAddressType>

    <vName1>CO Nutzer Firma</vName1>

    <vStreet>An der richtigen Allee 45</vStreet>

    <vCountryCode>DE</vCountryCode>

    <vPostalCode>81671</vPostalCode>

    <vLocation>München</vLocation>

    Käuferanschrift

     

    </hdrAddress>

     

     

     

    SH (Lieferanschrift)

    <hdrAddress>

     

     

     

    <vAddressType>SH</vAddressType>

    <vName1>John Doe Org</vName1>

    <vStreet>Karl-Marx-Straße 39</vStreet>

    <vCountryCode>DE</vCountryCode>

    <vPostalCode>09117</vPostalCode>

    <vLocation>Chemnitz</vLocation>         

    Lieferanschrift

     

    </hdrAddress>

     

     

     

    IN (Rechnungsanschrift)

    <hdrAddress>

     

     

     

    <vAddressType>IN</vAddressType>

    <vName1>Einrichtungshändler</vName1>

    <vStreet>Kirchenplatz 32</vStreet>

    <vCountryCode>DE</vCountryCode>

    <vPostalCode>91093</vPostalCode>

    <vLocation>Hannberg</vLocation>

    Rechnungsanschrift

     

    </hdrAddress>

     

     

     

    IS (Montageanschrift)

    <hdrAddress>

     

     

     

    <vAddressType>IS</vAddressType>

    <vName1>Montagefirma</vName1>

    <vStreet>Bastelstr. 3a</vStreet>

    <vCountryCode>DE</vCountryCode>

    <vPostalCode>09228</vPostalCode>

    <vLocation>Chemnitz</vLocation>

    Montageanschrift

     

    </hdrAddress>

     

     

     

    hdrPayment / PAYC (Zahlungsbedingungen)

    Detaillierte Angabe der Zahlungsbedingung.

    <hdrPayment>

    <vPaymentPart>1</vPaymentPart>

    <vPaymentRate>2</vPaymentRate>

    <vPaymentDays>10</vPaymentDays>

    </hdrPayment>

    <hdrPayment>

    <vPaymentPart>2</vPaymentPart>

    <vPaymentRate>0</vPaymentRate>

    <vPaymentDays>30</vPaymentDays>

    </hdrPayment>

    Über diese Details wird versucht eine passende Zahlungsbedingung im CO zu ermitteln, ist keine vorhanden, dann wird mit dem PAYC fortgesetzt. Sind richtige Zahlungsbedingungen über <hdrPayment> angegeben, wird versucht über diese Angaben eine Zahlungsbedingung zu ermitteln.

    <hdrText>

    <vTextType>PAYC</vTextType>

    <vTextLanguage>de</vTextLanguage>

    <vTextContent aTextLineNo="1">10 Tage 2%, 30 Tage netto</vTextContent>

    </hdrText>

     

    hdrText

    HEAD (Kopftext)

    Die Zeilenanzahl ist unendlich, jede neue Zeile muss entsprechend gekennzeichnet werden (aTextLineNo).

    <hdrText>

    <vTextType>HEAD</vTextType>

    <vTextLanguage>de</vTextLanguage>

    <vTextContent aTextLineNo="1">Änderung möglich bis: 18.06.2019</vTextContent>

    <vTextContent aTextLineNo="1">mehrzeilig!</vTextContent>

    </hdrText>

     

    DNOT (Versandart)

    <hdrText>

    <vTextType>DNOT</vTextType>

    <vTextLanguage>de</vTextLanguage>

    <vTextContent aTextLineNo="1">Versandart</vTextContent>

    </hdrText>

     

    DCON (Lieferbedingungen)

    Wenn der Text dem Schlüssel einer Lieferbedingung entspricht, wird diese übernommen. Wenn nicht, wird es nur ein Hinweistext.

    <hdrText>

    <vTextType>DCON</vTextType>

    <vTextLanguage>de</vTextLanguage>

    <vTextContent aTextLineNo="1">frei Bordsteinkante</vTextContent>

    </hdrText>

     

    hdrReference – ATT (z. B. AB-PDF)

    Alle Referenzen vom Typ ATT oder DOC werden im Importverzeichnis erwartet und in das Zielverzeichnis verschoben, so dass sie dort parallel zur E-AB erhalten bleiben. Der letzte Link wird im eAB-Modul angezeigt und ist von dort abrufbar.

    <hdrReference>

    <vReferenceType>ATT</vReferenceType>

    <vReferenceValue>4622_9478163_1.pdf</vReferenceValue>

    <vReferenceDesc>Auftragsbestätigung PDF</vReferenceDesc>

    </hdrReference>

     

    hdrPricing

    TNET (Gesamtnetto)

    Gesamtnetto wird gegen Bestellung geprüft.

    <hdrPricing aCondNo="2">

    <vConditionType aCondArea= "S">TNET</vConditionType>

    <vConditionValue>27000.00</vConditionValue>

    <vCondCurrency>EUR</vCondCurrency>

    </hdrPricing>

     

    SURH (Frachtkosten)

    Wird als Frachtkosten importiert, allerdings nur einmalig, ein zweiter Eintrag wird ignoriert.

    <hdrPricing aCondNo="2">

    <vConditionType aCondArea= "S">SURH</vConditionType>

    <vConditionValue>54.95</vConditionValue>

    <vCondCurrency>EUR</vCondCurrency>

    <vConditionText>Frachtkosten</vConditionText>

    </hdrPricing>

     

    docItem

    Pflichtfelder

    Die folgenden Werte sind pro Position zu hinterlegen.

    <docArticleItem aItemNo="1" aAction="M“>

    Artikelposition

    <docFolderItem aItemNo="1" aAction="M“>

    Ordnerposition

    <vPrecDocItemNo>1</vPrecDocItemNo>

    Positionsnummer

    <vOrdConfItemNumber>10</vOrdConfItemNumber>

    Bestätigungspositionsnummer

    <vVendorArticleNo aStatus="O">90SA1600</vVendorArticleNo>

    Bestellnummer und Artikelstatus

    <vVendorID>XXX</vVendorID>

    Herstellerkürzel

    <vVendorSeries>XXX</vVendorSeries>

    Herstellerserie

    <vOrdConfQuantity>9</vConfOrdQuantity>

    AB-Menge

    <vOrdConfUnit >9</vConfOrdUnit >

    AB-Mengeneinheit

     

    LOC (Rauminformationen)


    <itmOrgData>

    <vOrgDataType>LOC</vOrgDataType>

    <vOrgDataValue>Rauminformationen</vOrgDataValue>

    </itmOrgData>

    itmConfiguration (Artikelvariante)

    Variantencode und Variantentext, jeder Eintrag wird auf Basis der vValueID verglichen.

    <itmConfiguration>

     

     

     

    <vClassID></vClassID>

    <vOptionID>00</vOptionID>

    <vValueID>00</vValueID>

    <itmConfigText>

     

     

     

    <vTextLanguage>de</vTextLanguage>

    <vOptionText>Name Variante 00</vOptionText>

    <vValueText aTextLineNo="1">Wert Variante00</vValueText>

     

    </itmConfigText>

     

    </itmConfiguration>

     

     

     

     

    itmText

    ARTS (Kurztext)

    <itmText>

    <vTextType>ARTS</vTextType>

    <vTextLanguage>de</vTextLanguage>

    <vTextContent aTextLineNo="1">Manueller Artikel</vTextContent>

    </itmText>

     

    ARTL (Langtext)

    <itmText>

    <vTextType>ARTL</vTextType>

    <vTextLanguage>de</vTextLanguage>

    <vTextContent aTextLineNo="1">Manueller Artikel - Zeile 1</vTextContent>

    <vTextContent aTextLineNo="2">Manueller Artikel - Zeile 2</vTextContent>

    </itmText>

     

    ARTM (Sonderanfertigungstext / TextID 71)

    <itmText>

    <vTextType>ARTM</vTextType>

    <vTextLanguage>de</vTextLanguage>

    <vTextContent aTextLineNo="1">Sonderanfertigungstext</vTextContent>

    </itmText>

     

    itmPricing

    SGRO (Bruttoeinzelpreis)

    Der Bruttoeinzelpreis wird in Concept Office nicht dargestellt, kann aber trotzdem übermittelt werden.
    Dieser wird mit der hinterlegten Menge multipliziert.

    <itmPricing aCondNo="1">

    <vConditionType aCondArea="S">SGRO</vConditionType>

    <vConditionValue>10000.00</vConditionValue>

    <vCondCurrency>EUR</vCondCurrency>

    <vPriceUnit>1</vPriceUnit>

    <vMeasureUnit>C62</vMeasureUnit>

    </itmPricing>

     

    TGRO (Gesamtpreis)

    Alternative zu SGRO.

     

    DISI (Rabatt)

    Als Basis der Kalkulation dient der Bruttogesamtpreis des Artikels, es können bis zu 3 Rabatte dargestellt werden.
    Es erfolgt keine Berechnung auf Basis dieser Werte. Diese dienen ausschließlich zur besseren Nachvollziehbarkeit.

    <itmPricing aCondNo="2">

    <vConditionType aCondArea="S" aCondRef="1" aCondSign="-">DISI</vConditionType>

    <vConditionRate>50.00</vConditionRate>

    <vCondCurrency>%</vCondCurrency>

    <vPriceUnit>1</vPriceUnit>

    </itmPricing>
     
    SNET (Nettopreis)

    <itmPricing aCondNo="3">
    <vConditionType aCondArea="S">SNET</vConditionType>
    <vConditionValue>6750.00</vConditionValue>
    <vCondCurrency>EUR</vCondCurrency>
    <vPriceUnit>1</vPriceUnit>
    <vMeasureUnit>C62</vMeasureUnit>
    </itmPricing>
      
    TNET (Positionswert)

    Falls TNET nicht gefüllt, wird SNET x Menge multipliziert und angezeigt.

    <itmPricing aCondNo="4">

    <vConditionType aCondArea="S">TNET</vConditionType>

    <vConditionValue>1056.92</vConditionValue>

    <vCondCurrency>EUR</vCondCurrency>

    <vPriceUnit>9</vPriceUnit>

    </itmPricing>

    Veröffentlicht