HTK Wiki - Benutzerbeiträge [de]

OmniBelegService:XMLFormatbeschreibung

2026-05-27T14:12:12Z

MH: /* ARTICLE_PRICE */

{{DISPLAYTITLE:XML-Format-Beschreibung}}

== Vorwort ==
Hier auf dieser Seite wird das zu importierende XML-Format beschrieben. Es kann durchaus sein dass das ein oder andere Feld nicht in der XML vorhanden ist, da manche davon erst beim Übersetzen des BelegMappers eingefügt werden oder optionale Felder sind.

== ORDER_HEADER ==

=== CONTROL_INFO ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|GENERATION_INFO
| -
|lediglich ein Hinweis über den Ersteller der XML, kein Einfluss auf den Import
|-
|GENERATION_DATE
| -
|lediglich ein Hinweis über das Erstell-Datum der XML, fließt allerdings in die globale Einstellung "DocumentOlderThanXValue" ein und dadurch können zu alte XML-Dateien blockiert werden.
|}

=== ORDER_INFO ===
In dem ORDER_INFO Bereich werden grundlegende Informationen zur Bestellung angegeben.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ORDER_PARTIES
| -
|siehe Detailbereich ORDER_PARTIES
|-
|PAYMENTS
| -
|siehe Detailbereich PAYMENTS
|-
|PRICE_CURRENCY
|setzt Währungskennzeichen
|wenn leer, dann wird standardmäßig "EUR" für Euro gesetzt
|-
|BRUTTO_KZ
|steuert ob Brutto- oder Nettobeleg
|0 = netto; -1 = brutto. Je nach Kennzeichen werden auch die Positionspreise als Netto bzw. Brutto Preis verarbeitet
|-
|DELIVERY_CONDITION
|Lieferbedingung
|setzt die Lieferbedingung anhand Schlüssel oder Bezeichnung (Konfiguration),
|-
|ORDER_IDENTIFICATION
|USER_OrderIdentification
|füllt Userfeld, anhand dessen Inhalt wird ermittelt, ob es bereits ein Beleg zu der zu importierenden Bestellung gibt und ggf. dann ein BelegUpdate auf einen bestehenden Beleg ausgeführt
|-
|VDL
|Versandart
|setzt die Versandart anhand Schlüssel oder Bezeichnung (Konfiguration)
|-
|ORDER_ID
|USER_OrderId
|füllt Userfeld, dient lediglich für den Benutzer zum Suchen einer Bestellung
|-
|ORDER_PAYMENT_STATUS
|USER_OrderPaymentStatus
|füllt Userfeld, beinhaltet den Bezahl-Status aus dem Shop
|-
|ORDER_DATE
|USER_OrderDate bzw. BelegDatum
|füllt Userfeld. Sollte in der Konfiguration bei Belegdatum der wert "XML-Datum" hinterlegt sein wird das Belegdatum im Beleg gesetzt.
|-
|ORDER_CHANNEL
|USER_OrderChannel
|füllt Userfeld, notwendig für den OmniSeller Statusupload. Kann auch für kundenindividuelle Auswertungen und Analysen verwendet werden
|-
|ORDER_ACCOUNT
| USER_OrderAccount
|füllt Userfeld
|-
|ORDER_CUSTOMER_ACCOUNT
| -
|aktuell keine Verwendung
|-
|ORDER_DELIVERYDATE
|Liefertermin Beleg
|setzt Liefertermin im Beleg (falls in Konfiguration bei Liefertermin Beleg "XML Daten" ausgewählt ist. Schreibt standardmäßig tagesaktuelles Datum falls Property ausgewählt und trotzdem ein leeres Datum in der XML.
|-
|ORDER_VALUTADATE
|ValutaDatum Beleg
|(Ab Rev 16) Setzt das Valutadatum im Beleg. Übernimmt standardmäßig den Wert aus ORDER_DELIVERYDATE sollte nichts gesetzt sein.
|-
|ORDER_PAYMENT_ID
|Bezahlart, USER_PaymentID
|steuert die Bezahlart anhand Schlüssel oder Bezeichnung (Konfiguration), setzt außerdem das UserFeld USER_PaymentID
|-
|ORDER_STATUS_ID
|USER_OrderStatusID
|füllt Userfeld, Shop Status der Bestellung
|-
|ORDER_NOTE
|USER_OrderNote, BelegMemo
|Je nach Konfiguration wird das Bestellkommentar in das UserFeld oder auch in das Memo Feld des Belegs geschrieben
|-
|ORDER_TAX_AREA
|Besteuerung
|steuert u.A. die Besteuerung in der Sage. Auswahl "MERCHANT" (Inland), "EU" und "NONEU". Bei abweichendem Inhalt wird die Besteuerung aus dem Kunden übernommen.
|-
|ORDER_COUPON
|USER_OrderCoupon
|füllt Userfeld des angewendeten Gutschein-Codes
|-
|ORDER_COUPON_AMOUNT
|USER_OrderCouponAmount
|füllt Userfeld des angewendeten Gutschein-Betrags
|-
|ORDER_USER
|Beleg Bearbeiter
|setzt den Belegbearbeiter, übersteuert den in der Konfiguration hinterlegten Bearbeiter falls gefüllt.
|-
|ORDER_HEADER_TEXT
|Kopftext
|Setzt den Kopftext des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_HTML
|KopftextHTML
|Setzt den KopftextHtml des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_RTF
|KopfTextRTF
|Setzt den KopftextRtf des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT
|Fußtext
|Setzt den Fußtext des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_HTML
|FußtextHTML
|Setzt den FußtextHtml des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_RTF
|FußtextRTF
|Setzt den FußtextRtf des Belegs falls gefüllt
|-
|ORDER_TAX_CODE
| -
|aktuell keine Verwendung
|-
|ORDER_LANGUAGE
|Belegsprache
|Setzt die Sprache des Belegs falls gefüllt, ansonsten wird die Sprache der ermittelten/angelegten Adresse gesetzt.
Setzt bei Adress-Anlage die Sprache aus dem Feld.
|-
|ORDER_TAXEU_COUNTRY
|EULand
|setzt das EU Land auf Belegebene, falls gefüllt. Wenn das EU Land nicht vom Kunden übernommen sondern leer gelassen werden soll kann man dies mit dem Feldinhalt "-" (minus) ansteuern.
|-
|ORDER_TAXATIONTYPE
|Besteuerung
|übersteuert die durch ORDER_TAX_AREA ermittelte Besteuerung durch den hier eingetragenen Wert und setzt die Besteuerung auf Belegebene.
"steuerfrei", "inland", "EU mit UStID", "EU ohne UstID", "Verbundene Unternehmen", "Export/Import" als mögliche Werte. Ebenfalls findet auch eine Auswertung mit dem Input MERCHANT; EU und NON_EU statt. (wie bei ORDER_TAX_AREA)

Sollte das Feld gefüllt sein aber von der Schreibweise auf keinen der Fälle passen wird in den Sage Besteuerungsarten geprüft, ob eine individuelle Besteuerungsart anhand der angegebenen Bezeichnung vorliegt und diese dann auf Belegebene gesetzt.
|-
|ORDER_DOCUMENTTYPE
|Belegart
|übersteuert die in der Konfiguration hinterlegte Belegart, mit der der Beleg angelegt wird. Der Wert muss mit dem entsprechenden Kennzeichen gefüllt sein. (z.B. "VVA" für Auftragsbestätigungen)
|-
|ORDER_SAVE_STATUS
|Beleg speichern/parken
|Übersteuert die Konfiguration, ob ein Beleg gespeichert oder geparkt werden soll.
Wert "1" = speichern, "2" = parken.

Hinweis: Die globale Einstellung "Parken bei abweichendem Lieferland" kann den Wert dann noch übersteuern.
|-
|ORDER_IGNORE
| -
|sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als ignoriert markiert wird und das File in den Save-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ORDER_ERROR
| -
|(Ab Rev.11) sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als Fehler markiert wird und das File in den Fehler-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|}

==== ORDER_PARTIES ====
In dem Bereich der ORDER_PARTIES existieren zwei Knoten namens "BUYER_PARTY" und "SHIPMENT_PARTIES". Dort sind dann ebenfalls weitere Unterknoten definiert welche die Daten nochmal ins Detail auflösen können.

Am Ende gibt es einen größeren ADDRESS-Knoten in der BUYER_PARTY, welcher der Auftraggeber ist. Die angegebenen Daten in diesem ADDRESS-Knoten bilden dann die Grundlage für das in der Sage100 erzeugte Kundenkonto.

Die Daten der DELIVERY_PARTY werden lediglich als Lieferadresse im Sage Beleg hinterlegt.

===== ADDRESS =====
in BUYER_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|Name1 (Adresse),
A0Name1,

A2Name1
|Setzt Name1 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen1 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.

Generiert teilweise den Beleg Matchcode mit (Format NAME, CITY)
|-
|NAME2
|Name2 (Adresse),
A0Name2,

A2Name2
|Setzt Name2 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen2 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|MATCHCODE
|Matchcode
|Setzt Matchcode in einer neuen Adresse (und Kunde), die angelegt wird, falls gefüllt
Setzt auf BelegEbene ebenfalls den A0Matchcode falls gefüllt.

Sollte der Matchcode leer sein, wird das Standard Sage Pattern mit "Name, Ort" gesetzt.
|-
|STREET
|Lieferstraße (Adresse),
A0Straße,

A2Straße
|Setzt die Lieferstraße bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungsstraße, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|Lieferzusatz (Adresse),
A0Zusatz,
A2Zusatz
|Setzt den Lieferzusatz bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Lieferzusatzinformationen, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|LieferPLZ (Adresse),
A0Postleitzahl,
A2Postleitzahl
|Setzt die Postleitzahl bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Postleitzahl, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|LieferOrt (Adresse),
Matchcode (Adresse),
Matchcode (Kto)
A0Ort,
A2Ort
|Setzt den Ort/Stadt bei einer neuen Adresse die angelegt wird.
Bildet in Kombination mit Name ein Teil des Adress- sowie Kto-Matchcodes. (Format NAME, CITY)
Setzt auf Belegebene den Auftraggeber- und Rechnungsort, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|Lieferland (Adresse),
A0Land,
A2Land
|Setzt das Lieferland bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene das Auftraggeber- und Rechnungs-Land, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|USTID
| -
|setzt Umsatzsteuer ID, wird allerdings durch das Feld CUSTOMER_USTID in den CUSTOMER_MASTER_DATA übersteuert. Weitere Informationen dazu sind unter CUSTOMER_USTID zu finden.
|-
|SALUTATION
|Anrede (Adresse)
Anrede (Ansprechpartner)
A0Anrede,
A2Anrede
|Setzt Anrede bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Anrede bei einem neuen Ansprechpartner der angelegt wird
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Anrede, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|SALUTATION_LETTER
|Ansprache (Adresse)
Briefanrede (Ansprechpartner)
|Setzt Ansprache bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Briefanrede bei einem neuen Ansprechpartner
|-
|HOMEPAGE
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_MASTER_DATA
| -
|siehe Detailbereich CUSTOMER_MASTER_DATA
|-
|CONTACT
| -
|siehe Detailbereich CONTACT
|-
|<USER_XXXXX>
|UserFelder für KHKAdressen
|Hier können diverse UserFelder für den Adressstamm mit gesetzt werden.
|}
In DELIVERY_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|A1Name1
|Setzt auf Belegebene den Namen1 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|NAME2
|A1Name2
|Setzt auf Belegebene den Namen2 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|STREET
|A1Straße
|Setzt auf Belegebene die Straße in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|A1Zusatz
|Setzt auf Belegebene das Zusatzfeld in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|A1Postleitzahl
|Setzt auf Belegebene die Postleitzahl in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|A1Ort
|Setzt auf Belegebene den Ortsnamen in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|A1Land
EULand
|Setzt auf Belegebene das Land in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
Setzt ebenfalls das EULand, wenn es sich um eine EU-Bestellung (TAX_AREA = EU) handeln und nicht durch ORDER_TAXEU_COUNTRY übersteuert ist.
|-
|SALUTATION
|A1Anrede
|Setzt auf Belegebene die Anrede in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|}

====== CUSTOMER_MASTER_DATA ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CUSTOMER_USTID
|EUUstID (Kto),
EUUmsatzsteuerID
|Setzt bei einem neuen Kunden die UmsatzsteuerID,
Setzt auf Belegebene die EU-UmsatzsteuerID, falls gefüllt.
|-
|CUSTOMER_GROUP
|Gruppe (Kto),
Kontogruppe
|Setzt bei einem neuen Kunden die Kundengruppe, falls gefüllt (andernfalls Wert aus Kunden-Vorlage)
Setzt auf Belegebene die Kundengruppe, falls gefüllt
|-
|CUSTOMER_PRICELIST_ID
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_PRICELIST_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_TYPE_OF_TRANSPORT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|ADDRESS_GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|EU_COUNTRY
|EULand(Kto)
|setzt bei einer Kunden-Neuanlage im Kunden das EU Land, falls gefüllt
|-
|TAX_AREA
| -
|übersteuert das XML-Feld ORDER_TAX_AREA und hilft dabei, den Vorlage-Kunden zu ermitteln. (MERCHANT; EU; NON_EU als mögliche Eingabe-Werte)
|-
|<USER_XXXXX>
|Userfelder Konto
|Hier können diverse UserFelder für den Kunden (KHKKontokorrent) gesetzt werden.
|}

====== CONTACT ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CONTACT_NAME
|Ansprechpartner (ASP),
A0Ansprechpartner,

A2Ansprechpartner
|Setzt bei einer Ansprechpartner-Anlage den Matchcode.
Setzt auf Belegebene den Ansprechpartner des Auftraggebers
Setzt auf Belegebene den Ansprechpartner des Rechnungsempfängers
|-
|PHONE (type=private)
|Telefon (ASP)
TelefonPrivat (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Telefon & Telefon (privat)
|-
|PHONE (type=mobile)
|Mobilfunk (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Mobil"
|-
|FAX
|Telefax (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Fax"
|-
|EMAIL
|Email(Adresse)
Email (ASP)
|Setzt bei einer neuen Adresse die Email-Adresse (Ist auch relevantes Feld bei der Prüfung ob der Ansprechpartner bereits existiert)
Setzt bei einer Ansprechpartner-Anlage die Email-Adresse
|-
|DEPARTMENT
| -
|aktuell keine Verwendung in der Sage
|-
|GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|POSITION
| -
|aktuell keine Verwendung in der Sage
|-
|SALUTATION
|Anrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Anrede"
|-
|SALUTATION_LETTER
|Briefanrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Briefanrede"
|-
|<USER_XXXXX>
|UserFelder Ansprechpartner
|Hier können diverse UserFelder für den Ansprechpartner KHKAnsprechpartner gesetzt werden.
|}

==== PAYMENTS ====
der Knoten PAYMENTS beinhaltet einen Knoten PAYMENT, dieser ist wie folgt aufgebaut:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ACCOUNT
| -
|siehe Detailbereich ACCOUNT
|-
|TRANS_ID
|USER_TransID
|füllt Userfeld
|-
|PAYMENT_STATUS
|USER_Paymentstatus
|füllt Userfeld
|-
|PAYMENT_AMOUNT
|USER_PaymentAmount
|füllt Userfeld
|}

===== ACCOUNT =====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|HOLDER
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_COUNTRY
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_ACCOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_BIC
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_IBAN
| -
|aktuell keine Verwendung in der Sage
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BUSINESS_TRANSACTION_ID
| -
|aktuell keine Verwendung in der Sage
|-
|ORDER_REFERENCE
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_ITEM_LIST ==

=== ORDER_ITEM ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|POSTYPE
|Positionstyp
|gibt an welche Art Position die aktuelle Position ist.
0 = Gruppenüberschrift (Text kann in DESCRIPTION_SHORT mit übergeben werden.
1 = Artikelposition,

2 = Zwischensumme (Text kann in DESCRIPTION_SHORT mit übergeben werden.

3 = Textposition (Text kann in DESCRIPTION_LONG mit übergeben werden.

7 = optionale Artikelposition
|-
|ORDER_POS_ID
|USER_OrderPosID
|füllt Userfeld
|-
|STORNIERT
|USER_Storniert
|füllt Userfeld
|-
|LINE_ITEM_ID
| -
|aktuell keine Verwendung in der Sage. Wird aber dennoch zur Reihenfolge der Positionen verwendet.
|-
|VARIANT_ID
|AuspraegungID
|setzt die AuspraegungID der Position
|-
|STORAGE_AREA_NAME
|Lagerplatz
|setzt den Lagerplatz an der Position. Es muss der Name der Kurzbezeichnung des Lagerplatzes in der XML hinterlegt werden.
|-
|ARTICLE_ID
| -
|siehe Detailbereich ARTICLE_ID
|-
|QUANTITY
|Menge
|setzt die Menge der Position
|-
|ORDER_UNIT
| -
|(ab Rev.4) Setzt die Mengeneinheit der Position. Hinweis: Es findet keine Prüfung statt, ob diese angegebene Mengeneinheit in der Sage auch existiert.
Es muss der entsprechende Sage Schlüssel angegeben werden (z.B. "Stk" für Stück oder "Pal" für Palette)
|-
|DELIVERYDATE
|Liefertermin
|setzt den Liefertermin der Position. XML-Datum wird übernommen, wenn in der Konfiguration bei "Liefertermin Belegeposition" der Wert XMLDatum eingestellt ist.
|-
|ARTICLE_PRICE
| -
|siehe Detailbereich ARTICLE_PRICE
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|-
|QUANTITY_UNIT
|Mengeneinheit
|Steuert die Mengeneinheit.
Zulässige Werte: BME = Basismengeneinheit; VPE = Verpackungseinheit; VME = Verkaufsmengeneinheit

Hinweis: Sollte das Feld in der XML gefüllt sein, übersteuert dies die globale Property "POS_VKMengeneinheit".

Die Menge der Position wird durch den XML-Wert übernommen. Es findet keine Umrechnung statt.

Dieses Feld übersteuert die ORDER_UNIT und die globale Einstellungen POS_VKMengeneinheit
|-
|USE_OL_PRICE
| -
|(ab Rev.11) übersteuert auf Positionsebene, ob der Preis aus der Sage100 bezogen werden soll.
0 = XML Preis; 1 = Preis aus Sage;
übersteuert die Einstellung "Preisermittlung der Artikel-Positionen aus Sage statt XML-Betrag"
|}

==== ARTICLE_ID ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SUPPLIER_AID
|Artikelnummer
|ermittelt anhand des Feldinhalt den Sage Artikel, beim Wert "0" wird anhand der DESCRIPTION_SHORT der Zuschlagsname ermittelt (PosType muss bei Zuschlägen ebenfalls 1 sein)
|-
|BUYER_AID
|USER_BuyerAID
|füllt Userfeld, meist Verwendet als Referenzfeld für z.B. Marktplatz-Artikelnummer etc.
|-
|DESCRIPTION_SHORT
|Bezeichnung1
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_SHORT2
|Bezeichnung2
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_LONG
|Langtext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_DIMENSION
|Dimensionstext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|}

==== ARTICLE_PRICE ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|PRICE_AMOUNT
|Einzelpreis
|setzt den Einzelpreis der Position.
Setzt bei globaler Property "Gutschein als Belegrabatt" anhand des gesetzen Preises den Absolutwert des Belegrabattes.
|-
|PRICE_LINE_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX
| -
|aktuell keine Verwendung in der Sage
|-
|DISCOUNT_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|DISCOUNT_PERCENT
|prozentueller Rabatt
|setzt den prozentuellen Rabatt an einer Position. Werte von 0-100 werden akzeptiert.
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BATCHES
| -
|aktuell keine Verwendung in der Sage
|-
|SERIAL_NUMBERS
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_DISCOUNTS ==
Da Sage bis zu drei Beleg-Rabatte unterstützt gibt es hier auch entsprechend drei Knoten. Jeder der drei Knoten hat drei weitere Felder unter sich die dann die die entsprechenden Werte verarbeiten.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DISCOUNT1
|steuert ersten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT2
|steuert zweiten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT3
|steuert dritten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|}

==== Werte-Felder für Beleg-Rabatte ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DESCRIPTION
|Rabatttext
|setzt zu dem jeweiligen Rabatt den Rabatttext
|-
|DISCOUNTPERCENT
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt kein AbsolutRabatt ist.
Sollte in der XML sowohl DISCOUNTVALUE als auch DISCOUNTPERCENT gefüllt sein übersteuer das DISCOUNTVALUE Und der Rabatt wird als Absolutrabatt mit dem Festbetrag aus DISCOUNTVALUE angelegt
|-
|DISCOUNTVALUE
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt ein AbsolutRabatt ist.
|}

== ORDER_FIELDS ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SALES_REPRESENTATIVE
| Vertreter
|(ab Rev10) Setzt die Vertreternummer im Belegfuß. Es findet keine Prüfung statt, ob dieser Vertreter auch existiert.
|-
|CUSTOMER_TEMPLATE
| -
|(ab Rev10) Übersteuert den Vorlagenkunden aus der Konfiguration. Kundenneuanlage muss trotzdem in der Konfiguration aktiviert sein.
|-
|CUSTOMER_OL_ID
|Adresse
|Setzt das Auftraggeber Konto des zu importierenden Belegs
|-
|YOUR_ORDER
|Referenznummer
|Setzt die Referenznummer/Ihre Belegnummer auf Belegebene (falls gefüllt)
|-
|YOUR_TOKEN
|Referenzzeichen
|Setzt das Referenzzeichen/Ihr Zeichen auf Belegebene (falls gefüllt)
|-
|ORDER_MATCHCODE
|Matchcode
|Setzt den Belegmatchcode (falls gefüllt)
|-
|BUSINESS_TRANSACTION_MATCHCODE
|Hauptvorgangsmatchcode
|Setzt den Hauptvorgangsmatchcode (falls gefüllt)
|-
|OL_PROJECT_ID
| -
|keine Verwendung in der Sage
|-
|<USER_XXXXX>
|
|
|}

== ORDER_SUMMARY ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|TOTAL_ITEM_NUM
| -
|keine Verwendung in der Sage
|-
|TOTAL_AMOUNT
| -
|keine Verwendung in der Sage
|}

== XML-Beispiele ==
[[OmniBelegService:XMLExample 1|Beispiel1: Oxid eSales Bestell-XML]]

[[OmniBelegService:XMLExample 2|Beispiel2: komplexere XML Struktur mit unterschiedlichen Belege-Positionstypen nach einer XSL-Transformation]]

[[OmniBelegService:XSD|XML Schema Definition (XSD)]]

[[OmniBelegService:XMLExample TESTSchema|Beispiel3: TESTSCHEMA inkl. Kommentaren welcher Knoten auf welchem Sage Feld landet.]]

OmniBelegService:XMLFormatbeschreibung

2026-05-27T14:11:50Z

MH: /* ARTICLE_PRICE */

{{DISPLAYTITLE:XML-Format-Beschreibung}}

== Vorwort ==
Hier auf dieser Seite wird das zu importierende XML-Format beschrieben. Es kann durchaus sein dass das ein oder andere Feld nicht in der XML vorhanden ist, da manche davon erst beim Übersetzen des BelegMappers eingefügt werden oder optionale Felder sind.

== ORDER_HEADER ==

=== CONTROL_INFO ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|GENERATION_INFO
| -
|lediglich ein Hinweis über den Ersteller der XML, kein Einfluss auf den Import
|-
|GENERATION_DATE
| -
|lediglich ein Hinweis über das Erstell-Datum der XML, fließt allerdings in die globale Einstellung "DocumentOlderThanXValue" ein und dadurch können zu alte XML-Dateien blockiert werden.
|}

=== ORDER_INFO ===
In dem ORDER_INFO Bereich werden grundlegende Informationen zur Bestellung angegeben.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ORDER_PARTIES
| -
|siehe Detailbereich ORDER_PARTIES
|-
|PAYMENTS
| -
|siehe Detailbereich PAYMENTS
|-
|PRICE_CURRENCY
|setzt Währungskennzeichen
|wenn leer, dann wird standardmäßig "EUR" für Euro gesetzt
|-
|BRUTTO_KZ
|steuert ob Brutto- oder Nettobeleg
|0 = netto; -1 = brutto. Je nach Kennzeichen werden auch die Positionspreise als Netto bzw. Brutto Preis verarbeitet
|-
|DELIVERY_CONDITION
|Lieferbedingung
|setzt die Lieferbedingung anhand Schlüssel oder Bezeichnung (Konfiguration),
|-
|ORDER_IDENTIFICATION
|USER_OrderIdentification
|füllt Userfeld, anhand dessen Inhalt wird ermittelt, ob es bereits ein Beleg zu der zu importierenden Bestellung gibt und ggf. dann ein BelegUpdate auf einen bestehenden Beleg ausgeführt
|-
|VDL
|Versandart
|setzt die Versandart anhand Schlüssel oder Bezeichnung (Konfiguration)
|-
|ORDER_ID
|USER_OrderId
|füllt Userfeld, dient lediglich für den Benutzer zum Suchen einer Bestellung
|-
|ORDER_PAYMENT_STATUS
|USER_OrderPaymentStatus
|füllt Userfeld, beinhaltet den Bezahl-Status aus dem Shop
|-
|ORDER_DATE
|USER_OrderDate bzw. BelegDatum
|füllt Userfeld. Sollte in der Konfiguration bei Belegdatum der wert "XML-Datum" hinterlegt sein wird das Belegdatum im Beleg gesetzt.
|-
|ORDER_CHANNEL
|USER_OrderChannel
|füllt Userfeld, notwendig für den OmniSeller Statusupload. Kann auch für kundenindividuelle Auswertungen und Analysen verwendet werden
|-
|ORDER_ACCOUNT
| USER_OrderAccount
|füllt Userfeld
|-
|ORDER_CUSTOMER_ACCOUNT
| -
|aktuell keine Verwendung
|-
|ORDER_DELIVERYDATE
|Liefertermin Beleg
|setzt Liefertermin im Beleg (falls in Konfiguration bei Liefertermin Beleg "XML Daten" ausgewählt ist. Schreibt standardmäßig tagesaktuelles Datum falls Property ausgewählt und trotzdem ein leeres Datum in der XML.
|-
|ORDER_VALUTADATE
|ValutaDatum Beleg
|(Ab Rev 16) Setzt das Valutadatum im Beleg. Übernimmt standardmäßig den Wert aus ORDER_DELIVERYDATE sollte nichts gesetzt sein.
|-
|ORDER_PAYMENT_ID
|Bezahlart, USER_PaymentID
|steuert die Bezahlart anhand Schlüssel oder Bezeichnung (Konfiguration), setzt außerdem das UserFeld USER_PaymentID
|-
|ORDER_STATUS_ID
|USER_OrderStatusID
|füllt Userfeld, Shop Status der Bestellung
|-
|ORDER_NOTE
|USER_OrderNote, BelegMemo
|Je nach Konfiguration wird das Bestellkommentar in das UserFeld oder auch in das Memo Feld des Belegs geschrieben
|-
|ORDER_TAX_AREA
|Besteuerung
|steuert u.A. die Besteuerung in der Sage. Auswahl "MERCHANT" (Inland), "EU" und "NONEU". Bei abweichendem Inhalt wird die Besteuerung aus dem Kunden übernommen.
|-
|ORDER_COUPON
|USER_OrderCoupon
|füllt Userfeld des angewendeten Gutschein-Codes
|-
|ORDER_COUPON_AMOUNT
|USER_OrderCouponAmount
|füllt Userfeld des angewendeten Gutschein-Betrags
|-
|ORDER_USER
|Beleg Bearbeiter
|setzt den Belegbearbeiter, übersteuert den in der Konfiguration hinterlegten Bearbeiter falls gefüllt.
|-
|ORDER_HEADER_TEXT
|Kopftext
|Setzt den Kopftext des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_HTML
|KopftextHTML
|Setzt den KopftextHtml des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_RTF
|KopfTextRTF
|Setzt den KopftextRtf des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT
|Fußtext
|Setzt den Fußtext des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_HTML
|FußtextHTML
|Setzt den FußtextHtml des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_RTF
|FußtextRTF
|Setzt den FußtextRtf des Belegs falls gefüllt
|-
|ORDER_TAX_CODE
| -
|aktuell keine Verwendung
|-
|ORDER_LANGUAGE
|Belegsprache
|Setzt die Sprache des Belegs falls gefüllt, ansonsten wird die Sprache der ermittelten/angelegten Adresse gesetzt.
Setzt bei Adress-Anlage die Sprache aus dem Feld.
|-
|ORDER_TAXEU_COUNTRY
|EULand
|setzt das EU Land auf Belegebene, falls gefüllt. Wenn das EU Land nicht vom Kunden übernommen sondern leer gelassen werden soll kann man dies mit dem Feldinhalt "-" (minus) ansteuern.
|-
|ORDER_TAXATIONTYPE
|Besteuerung
|übersteuert die durch ORDER_TAX_AREA ermittelte Besteuerung durch den hier eingetragenen Wert und setzt die Besteuerung auf Belegebene.
"steuerfrei", "inland", "EU mit UStID", "EU ohne UstID", "Verbundene Unternehmen", "Export/Import" als mögliche Werte. Ebenfalls findet auch eine Auswertung mit dem Input MERCHANT; EU und NON_EU statt. (wie bei ORDER_TAX_AREA)

Sollte das Feld gefüllt sein aber von der Schreibweise auf keinen der Fälle passen wird in den Sage Besteuerungsarten geprüft, ob eine individuelle Besteuerungsart anhand der angegebenen Bezeichnung vorliegt und diese dann auf Belegebene gesetzt.
|-
|ORDER_DOCUMENTTYPE
|Belegart
|übersteuert die in der Konfiguration hinterlegte Belegart, mit der der Beleg angelegt wird. Der Wert muss mit dem entsprechenden Kennzeichen gefüllt sein. (z.B. "VVA" für Auftragsbestätigungen)
|-
|ORDER_SAVE_STATUS
|Beleg speichern/parken
|Übersteuert die Konfiguration, ob ein Beleg gespeichert oder geparkt werden soll.
Wert "1" = speichern, "2" = parken.

Hinweis: Die globale Einstellung "Parken bei abweichendem Lieferland" kann den Wert dann noch übersteuern.
|-
|ORDER_IGNORE
| -
|sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als ignoriert markiert wird und das File in den Save-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ORDER_ERROR
| -
|(Ab Rev.11) sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als Fehler markiert wird und das File in den Fehler-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|}

==== ORDER_PARTIES ====
In dem Bereich der ORDER_PARTIES existieren zwei Knoten namens "BUYER_PARTY" und "SHIPMENT_PARTIES". Dort sind dann ebenfalls weitere Unterknoten definiert welche die Daten nochmal ins Detail auflösen können.

Am Ende gibt es einen größeren ADDRESS-Knoten in der BUYER_PARTY, welcher der Auftraggeber ist. Die angegebenen Daten in diesem ADDRESS-Knoten bilden dann die Grundlage für das in der Sage100 erzeugte Kundenkonto.

Die Daten der DELIVERY_PARTY werden lediglich als Lieferadresse im Sage Beleg hinterlegt.

===== ADDRESS =====
in BUYER_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|Name1 (Adresse),
A0Name1,

A2Name1
|Setzt Name1 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen1 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.

Generiert teilweise den Beleg Matchcode mit (Format NAME, CITY)
|-
|NAME2
|Name2 (Adresse),
A0Name2,

A2Name2
|Setzt Name2 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen2 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|MATCHCODE
|Matchcode
|Setzt Matchcode in einer neuen Adresse (und Kunde), die angelegt wird, falls gefüllt
Setzt auf BelegEbene ebenfalls den A0Matchcode falls gefüllt.

Sollte der Matchcode leer sein, wird das Standard Sage Pattern mit "Name, Ort" gesetzt.
|-
|STREET
|Lieferstraße (Adresse),
A0Straße,

A2Straße
|Setzt die Lieferstraße bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungsstraße, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|Lieferzusatz (Adresse),
A0Zusatz,
A2Zusatz
|Setzt den Lieferzusatz bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Lieferzusatzinformationen, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|LieferPLZ (Adresse),
A0Postleitzahl,
A2Postleitzahl
|Setzt die Postleitzahl bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Postleitzahl, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|LieferOrt (Adresse),
Matchcode (Adresse),
Matchcode (Kto)
A0Ort,
A2Ort
|Setzt den Ort/Stadt bei einer neuen Adresse die angelegt wird.
Bildet in Kombination mit Name ein Teil des Adress- sowie Kto-Matchcodes. (Format NAME, CITY)
Setzt auf Belegebene den Auftraggeber- und Rechnungsort, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|Lieferland (Adresse),
A0Land,
A2Land
|Setzt das Lieferland bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene das Auftraggeber- und Rechnungs-Land, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|USTID
| -
|setzt Umsatzsteuer ID, wird allerdings durch das Feld CUSTOMER_USTID in den CUSTOMER_MASTER_DATA übersteuert. Weitere Informationen dazu sind unter CUSTOMER_USTID zu finden.
|-
|SALUTATION
|Anrede (Adresse)
Anrede (Ansprechpartner)
A0Anrede,
A2Anrede
|Setzt Anrede bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Anrede bei einem neuen Ansprechpartner der angelegt wird
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Anrede, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|SALUTATION_LETTER
|Ansprache (Adresse)
Briefanrede (Ansprechpartner)
|Setzt Ansprache bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Briefanrede bei einem neuen Ansprechpartner
|-
|HOMEPAGE
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_MASTER_DATA
| -
|siehe Detailbereich CUSTOMER_MASTER_DATA
|-
|CONTACT
| -
|siehe Detailbereich CONTACT
|-
|<USER_XXXXX>
|UserFelder für KHKAdressen
|Hier können diverse UserFelder für den Adressstamm mit gesetzt werden.
|}
In DELIVERY_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|A1Name1
|Setzt auf Belegebene den Namen1 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|NAME2
|A1Name2
|Setzt auf Belegebene den Namen2 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|STREET
|A1Straße
|Setzt auf Belegebene die Straße in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|A1Zusatz
|Setzt auf Belegebene das Zusatzfeld in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|A1Postleitzahl
|Setzt auf Belegebene die Postleitzahl in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|A1Ort
|Setzt auf Belegebene den Ortsnamen in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|A1Land
EULand
|Setzt auf Belegebene das Land in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
Setzt ebenfalls das EULand, wenn es sich um eine EU-Bestellung (TAX_AREA = EU) handeln und nicht durch ORDER_TAXEU_COUNTRY übersteuert ist.
|-
|SALUTATION
|A1Anrede
|Setzt auf Belegebene die Anrede in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|}

====== CUSTOMER_MASTER_DATA ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CUSTOMER_USTID
|EUUstID (Kto),
EUUmsatzsteuerID
|Setzt bei einem neuen Kunden die UmsatzsteuerID,
Setzt auf Belegebene die EU-UmsatzsteuerID, falls gefüllt.
|-
|CUSTOMER_GROUP
|Gruppe (Kto),
Kontogruppe
|Setzt bei einem neuen Kunden die Kundengruppe, falls gefüllt (andernfalls Wert aus Kunden-Vorlage)
Setzt auf Belegebene die Kundengruppe, falls gefüllt
|-
|CUSTOMER_PRICELIST_ID
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_PRICELIST_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_TYPE_OF_TRANSPORT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|ADDRESS_GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|EU_COUNTRY
|EULand(Kto)
|setzt bei einer Kunden-Neuanlage im Kunden das EU Land, falls gefüllt
|-
|TAX_AREA
| -
|übersteuert das XML-Feld ORDER_TAX_AREA und hilft dabei, den Vorlage-Kunden zu ermitteln. (MERCHANT; EU; NON_EU als mögliche Eingabe-Werte)
|-
|<USER_XXXXX>
|Userfelder Konto
|Hier können diverse UserFelder für den Kunden (KHKKontokorrent) gesetzt werden.
|}

====== CONTACT ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CONTACT_NAME
|Ansprechpartner (ASP),
A0Ansprechpartner,

A2Ansprechpartner
|Setzt bei einer Ansprechpartner-Anlage den Matchcode.
Setzt auf Belegebene den Ansprechpartner des Auftraggebers
Setzt auf Belegebene den Ansprechpartner des Rechnungsempfängers
|-
|PHONE (type=private)
|Telefon (ASP)
TelefonPrivat (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Telefon & Telefon (privat)
|-
|PHONE (type=mobile)
|Mobilfunk (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Mobil"
|-
|FAX
|Telefax (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Fax"
|-
|EMAIL
|Email(Adresse)
Email (ASP)
|Setzt bei einer neuen Adresse die Email-Adresse (Ist auch relevantes Feld bei der Prüfung ob der Ansprechpartner bereits existiert)
Setzt bei einer Ansprechpartner-Anlage die Email-Adresse
|-
|DEPARTMENT
| -
|aktuell keine Verwendung in der Sage
|-
|GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|POSITION
| -
|aktuell keine Verwendung in der Sage
|-
|SALUTATION
|Anrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Anrede"
|-
|SALUTATION_LETTER
|Briefanrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Briefanrede"
|-
|<USER_XXXXX>
|UserFelder Ansprechpartner
|Hier können diverse UserFelder für den Ansprechpartner KHKAnsprechpartner gesetzt werden.
|}

==== PAYMENTS ====
der Knoten PAYMENTS beinhaltet einen Knoten PAYMENT, dieser ist wie folgt aufgebaut:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ACCOUNT
| -
|siehe Detailbereich ACCOUNT
|-
|TRANS_ID
|USER_TransID
|füllt Userfeld
|-
|PAYMENT_STATUS
|USER_Paymentstatus
|füllt Userfeld
|-
|PAYMENT_AMOUNT
|USER_PaymentAmount
|füllt Userfeld
|}

===== ACCOUNT =====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|HOLDER
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_COUNTRY
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_ACCOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_BIC
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_IBAN
| -
|aktuell keine Verwendung in der Sage
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BUSINESS_TRANSACTION_ID
| -
|aktuell keine Verwendung in der Sage
|-
|ORDER_REFERENCE
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_ITEM_LIST ==

=== ORDER_ITEM ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|POSTYPE
|Positionstyp
|gibt an welche Art Position die aktuelle Position ist.
0 = Gruppenüberschrift (Text kann in DESCRIPTION_SHORT mit übergeben werden.
1 = Artikelposition,

2 = Zwischensumme (Text kann in DESCRIPTION_SHORT mit übergeben werden.

3 = Textposition (Text kann in DESCRIPTION_LONG mit übergeben werden.

7 = optionale Artikelposition
|-
|ORDER_POS_ID
|USER_OrderPosID
|füllt Userfeld
|-
|STORNIERT
|USER_Storniert
|füllt Userfeld
|-
|LINE_ITEM_ID
| -
|aktuell keine Verwendung in der Sage. Wird aber dennoch zur Reihenfolge der Positionen verwendet.
|-
|VARIANT_ID
|AuspraegungID
|setzt die AuspraegungID der Position
|-
|STORAGE_AREA_NAME
|Lagerplatz
|setzt den Lagerplatz an der Position. Es muss der Name der Kurzbezeichnung des Lagerplatzes in der XML hinterlegt werden.
|-
|ARTICLE_ID
| -
|siehe Detailbereich ARTICLE_ID
|-
|QUANTITY
|Menge
|setzt die Menge der Position
|-
|ORDER_UNIT
| -
|(ab Rev.4) Setzt die Mengeneinheit der Position. Hinweis: Es findet keine Prüfung statt, ob diese angegebene Mengeneinheit in der Sage auch existiert.
Es muss der entsprechende Sage Schlüssel angegeben werden (z.B. "Stk" für Stück oder "Pal" für Palette)
|-
|DELIVERYDATE
|Liefertermin
|setzt den Liefertermin der Position. XML-Datum wird übernommen, wenn in der Konfiguration bei "Liefertermin Belegeposition" der Wert XMLDatum eingestellt ist.
|-
|ARTICLE_PRICE
| -
|siehe Detailbereich ARTICLE_PRICE
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|-
|QUANTITY_UNIT
|Mengeneinheit
|Steuert die Mengeneinheit.
Zulässige Werte: BME = Basismengeneinheit; VPE = Verpackungseinheit; VME = Verkaufsmengeneinheit

Hinweis: Sollte das Feld in der XML gefüllt sein, übersteuert dies die globale Property "POS_VKMengeneinheit".

Die Menge der Position wird durch den XML-Wert übernommen. Es findet keine Umrechnung statt.

Dieses Feld übersteuert die ORDER_UNIT und die globale Einstellungen POS_VKMengeneinheit
|-
|USE_OL_PRICE
| -
|(ab Rev.11) übersteuert auf Positionsebene, ob der Preis aus der Sage100 bezogen werden soll.
0 = XML Preis; 1 = Preis aus Sage;
übersteuert die Einstellung "Preisermittlung der Artikel-Positionen aus Sage statt XML-Betrag"
|}

==== ARTICLE_ID ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SUPPLIER_AID
|Artikelnummer
|ermittelt anhand des Feldinhalt den Sage Artikel, beim Wert "0" wird anhand der DESCRIPTION_SHORT der Zuschlagsname ermittelt (PosType muss bei Zuschlägen ebenfalls 1 sein)
|-
|BUYER_AID
|USER_BuyerAID
|füllt Userfeld, meist Verwendet als Referenzfeld für z.B. Marktplatz-Artikelnummer etc.
|-
|DESCRIPTION_SHORT
|Bezeichnung1
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_SHORT2
|Bezeichnung2
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_LONG
|Langtext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_DIMENSION
|Dimensionstext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|}

==== ARTICLE_PRICE ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|PRICE_AMOUNT
|Einzelpreis
|setzt den Einzelpreis der Position.
Setzt bei globaler Property "Gutschein als Belegrabatt" anhand des gesetzen Preises den Absolutwert des Belegrabattes.
|-
|PRICE_LINE_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX
| -
|aktuell keine Verwendung in der Sage
|-
|DISCOUNT_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|DISCOUNT_PERCENT
|prozentueller Rabatt
|setzt den prozentuellen Rabatt auf eine Position. Werte von 0-100 werden akzeptiert.
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BATCHES
| -
|aktuell keine Verwendung in der Sage
|-
|SERIAL_NUMBERS
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_DISCOUNTS ==
Da Sage bis zu drei Beleg-Rabatte unterstützt gibt es hier auch entsprechend drei Knoten. Jeder der drei Knoten hat drei weitere Felder unter sich die dann die die entsprechenden Werte verarbeiten.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DISCOUNT1
|steuert ersten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT2
|steuert zweiten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT3
|steuert dritten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|}

==== Werte-Felder für Beleg-Rabatte ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DESCRIPTION
|Rabatttext
|setzt zu dem jeweiligen Rabatt den Rabatttext
|-
|DISCOUNTPERCENT
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt kein AbsolutRabatt ist.
Sollte in der XML sowohl DISCOUNTVALUE als auch DISCOUNTPERCENT gefüllt sein übersteuer das DISCOUNTVALUE Und der Rabatt wird als Absolutrabatt mit dem Festbetrag aus DISCOUNTVALUE angelegt
|-
|DISCOUNTVALUE
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt ein AbsolutRabatt ist.
|}

== ORDER_FIELDS ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SALES_REPRESENTATIVE
| Vertreter
|(ab Rev10) Setzt die Vertreternummer im Belegfuß. Es findet keine Prüfung statt, ob dieser Vertreter auch existiert.
|-
|CUSTOMER_TEMPLATE
| -
|(ab Rev10) Übersteuert den Vorlagenkunden aus der Konfiguration. Kundenneuanlage muss trotzdem in der Konfiguration aktiviert sein.
|-
|CUSTOMER_OL_ID
|Adresse
|Setzt das Auftraggeber Konto des zu importierenden Belegs
|-
|YOUR_ORDER
|Referenznummer
|Setzt die Referenznummer/Ihre Belegnummer auf Belegebene (falls gefüllt)
|-
|YOUR_TOKEN
|Referenzzeichen
|Setzt das Referenzzeichen/Ihr Zeichen auf Belegebene (falls gefüllt)
|-
|ORDER_MATCHCODE
|Matchcode
|Setzt den Belegmatchcode (falls gefüllt)
|-
|BUSINESS_TRANSACTION_MATCHCODE
|Hauptvorgangsmatchcode
|Setzt den Hauptvorgangsmatchcode (falls gefüllt)
|-
|OL_PROJECT_ID
| -
|keine Verwendung in der Sage
|-
|<USER_XXXXX>
|
|
|}

== ORDER_SUMMARY ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|TOTAL_ITEM_NUM
| -
|keine Verwendung in der Sage
|-
|TOTAL_AMOUNT
| -
|keine Verwendung in der Sage
|}

== XML-Beispiele ==
[[OmniBelegService:XMLExample 1|Beispiel1: Oxid eSales Bestell-XML]]

[[OmniBelegService:XMLExample 2|Beispiel2: komplexere XML Struktur mit unterschiedlichen Belege-Positionstypen nach einer XSL-Transformation]]

[[OmniBelegService:XSD|XML Schema Definition (XSD)]]

[[OmniBelegService:XMLExample TESTSchema|Beispiel3: TESTSCHEMA inkl. Kommentaren welcher Knoten auf welchem Sage Feld landet.]]

OmniBelegService:Releases Rev 16

2026-05-27T13:55:55Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

* Skript 91: Erweiterung der OmniBelegService_Belege Tabelle um das Feld Order_ValutaDate.
* Skript 92: (ehemals 46) Erweiterung der Prozedur spOmniBelegService_InsertXMLBeleg um den Parameter Order_ValutaDate
* Skript 93: Erweiterung der OmniBelegService_BelegePositionen Tabelle um das Feld Discount_Percent.
* Skript 94: (ehemals 74) Erweiterung der Prozedur spOmniBelegService_InsertXMLPosition um den Parameter Discount_Percent

==== Konfiguration ====

* Es wurde ein Fehler behoben, dass Änderungen in untergeordneten Gruppen wie z.B. den Prozeduren optisch nicht angezeigt und teilweise auch nicht gespeichert und übernommen wurden.

==== Dienst ====

* Es wurde das Start-Argument /nomutex hinzugefügt. Dieser Start Parameter überspringt die Mutex Prüfung und erlaubt somit mehrfach parallel laufende Instanzen des Dienstes auf dem gleichen System.

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.
* Einführung FehlerCode 55: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden." Dieser Fall tritt ein, wenn auf einem bereits gespeicherten Beleg ein BelegUpdate eingespielt werden soll, was aber lediglich den Speicherstatus parken hat.
* ORDER_ITEMs mit negativem Preis und ohne angegebene Artikelnummer werden nun nicht mehr als negative Zuschläge (Abschläge), sondern als Belegrabatt importiert.
* Das XML-Feld ORDER_VALUTADATE kann nun angesteuert werden und setzt das ValutaDatum auf Belegebene.
* Auf Positionsebene kann nun das Feld DISCOUNT_PERCENT in dem ARTICLE_PRICE Segment übermittelt werden. Es setzt prozentuellen Rabatt an einer Position.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

==== weiteres: ====

OmniBelegService:Releases Rev 16

2026-05-27T13:54:11Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

* Skript 91: Erweiterung der OmniBelegService_Belege Tabelle um das Feld Order_ValutaDate.
* Skript 92: (ehemals 46) Erweiterung der Prozedur spOmniBelegService_InsertXMLBeleg um den Parameter Order_ValutaDate
* Skript 93: Erweiterung der OmniBelegService_BelegePositionen Tabelle um das Feld Discount_Percent.
* Skript 94: (ehemals 74) Erweiterung der Prozedur spOmniBelegService_InsertXMLPosition um den Parameter Discount_Percent

==== Konfiguration ====

* Es wurde ein Fehler behoben, dass Änderungen in untergeordneten Gruppen wie z.B. den Prozeduren optisch nicht angezeigt und teilweise auch nicht gespeichert und übernommen wurden.

==== Dienst ====

* Es wurde das Start-Argument /nomutex hinzugefügt. Dieser Start Parameter überspringt die Mutex Prüfung und erlaubt somit mehrfach parallel laufende Instanzen des Dienstes auf dem gleichen System.

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.
* Einführung FehlerCode 55: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden." Dieser Fall tritt ein, wenn auf einem bereits gespeicherten Beleg ein BelegUpdate eingespielt werden soll, was aber lediglich den Speicherstatus parken hat.
* ORDER_ITEMs mit negativem Preis und ohne angegebene Artikelnummer werden nun nicht mehr als negative Zuschläge (Abschläge), sondern als Belegrabatt importiert.
* Das XML-Feld ORDER_VALUTADATE kann nun angesteuert werden und setzt das ValutaDatum auf Belegebene.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

==== weiteres: ====

OmniBelegService:XMLFormatbeschreibung

2026-05-27T13:13:01Z

MH: /* ORDER_INFO */

{{DISPLAYTITLE:XML-Format-Beschreibung}}

== Vorwort ==
Hier auf dieser Seite wird das zu importierende XML-Format beschrieben. Es kann durchaus sein dass das ein oder andere Feld nicht in der XML vorhanden ist, da manche davon erst beim Übersetzen des BelegMappers eingefügt werden oder optionale Felder sind.

== ORDER_HEADER ==

=== CONTROL_INFO ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|GENERATION_INFO
| -
|lediglich ein Hinweis über den Ersteller der XML, kein Einfluss auf den Import
|-
|GENERATION_DATE
| -
|lediglich ein Hinweis über das Erstell-Datum der XML, fließt allerdings in die globale Einstellung "DocumentOlderThanXValue" ein und dadurch können zu alte XML-Dateien blockiert werden.
|}

=== ORDER_INFO ===
In dem ORDER_INFO Bereich werden grundlegende Informationen zur Bestellung angegeben.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ORDER_PARTIES
| -
|siehe Detailbereich ORDER_PARTIES
|-
|PAYMENTS
| -
|siehe Detailbereich PAYMENTS
|-
|PRICE_CURRENCY
|setzt Währungskennzeichen
|wenn leer, dann wird standardmäßig "EUR" für Euro gesetzt
|-
|BRUTTO_KZ
|steuert ob Brutto- oder Nettobeleg
|0 = netto; -1 = brutto. Je nach Kennzeichen werden auch die Positionspreise als Netto bzw. Brutto Preis verarbeitet
|-
|DELIVERY_CONDITION
|Lieferbedingung
|setzt die Lieferbedingung anhand Schlüssel oder Bezeichnung (Konfiguration),
|-
|ORDER_IDENTIFICATION
|USER_OrderIdentification
|füllt Userfeld, anhand dessen Inhalt wird ermittelt, ob es bereits ein Beleg zu der zu importierenden Bestellung gibt und ggf. dann ein BelegUpdate auf einen bestehenden Beleg ausgeführt
|-
|VDL
|Versandart
|setzt die Versandart anhand Schlüssel oder Bezeichnung (Konfiguration)
|-
|ORDER_ID
|USER_OrderId
|füllt Userfeld, dient lediglich für den Benutzer zum Suchen einer Bestellung
|-
|ORDER_PAYMENT_STATUS
|USER_OrderPaymentStatus
|füllt Userfeld, beinhaltet den Bezahl-Status aus dem Shop
|-
|ORDER_DATE
|USER_OrderDate bzw. BelegDatum
|füllt Userfeld. Sollte in der Konfiguration bei Belegdatum der wert "XML-Datum" hinterlegt sein wird das Belegdatum im Beleg gesetzt.
|-
|ORDER_CHANNEL
|USER_OrderChannel
|füllt Userfeld, notwendig für den OmniSeller Statusupload. Kann auch für kundenindividuelle Auswertungen und Analysen verwendet werden
|-
|ORDER_ACCOUNT
| USER_OrderAccount
|füllt Userfeld
|-
|ORDER_CUSTOMER_ACCOUNT
| -
|aktuell keine Verwendung
|-
|ORDER_DELIVERYDATE
|Liefertermin Beleg
|setzt Liefertermin im Beleg (falls in Konfiguration bei Liefertermin Beleg "XML Daten" ausgewählt ist. Schreibt standardmäßig tagesaktuelles Datum falls Property ausgewählt und trotzdem ein leeres Datum in der XML.
|-
|ORDER_VALUTADATE
|ValutaDatum Beleg
|(Ab Rev 16) Setzt das Valutadatum im Beleg. Übernimmt standardmäßig den Wert aus ORDER_DELIVERYDATE sollte nichts gesetzt sein.
|-
|ORDER_PAYMENT_ID
|Bezahlart, USER_PaymentID
|steuert die Bezahlart anhand Schlüssel oder Bezeichnung (Konfiguration), setzt außerdem das UserFeld USER_PaymentID
|-
|ORDER_STATUS_ID
|USER_OrderStatusID
|füllt Userfeld, Shop Status der Bestellung
|-
|ORDER_NOTE
|USER_OrderNote, BelegMemo
|Je nach Konfiguration wird das Bestellkommentar in das UserFeld oder auch in das Memo Feld des Belegs geschrieben
|-
|ORDER_TAX_AREA
|Besteuerung
|steuert u.A. die Besteuerung in der Sage. Auswahl "MERCHANT" (Inland), "EU" und "NONEU". Bei abweichendem Inhalt wird die Besteuerung aus dem Kunden übernommen.
|-
|ORDER_COUPON
|USER_OrderCoupon
|füllt Userfeld des angewendeten Gutschein-Codes
|-
|ORDER_COUPON_AMOUNT
|USER_OrderCouponAmount
|füllt Userfeld des angewendeten Gutschein-Betrags
|-
|ORDER_USER
|Beleg Bearbeiter
|setzt den Belegbearbeiter, übersteuert den in der Konfiguration hinterlegten Bearbeiter falls gefüllt.
|-
|ORDER_HEADER_TEXT
|Kopftext
|Setzt den Kopftext des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_HTML
|KopftextHTML
|Setzt den KopftextHtml des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_RTF
|KopfTextRTF
|Setzt den KopftextRtf des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT
|Fußtext
|Setzt den Fußtext des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_HTML
|FußtextHTML
|Setzt den FußtextHtml des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_RTF
|FußtextRTF
|Setzt den FußtextRtf des Belegs falls gefüllt
|-
|ORDER_TAX_CODE
| -
|aktuell keine Verwendung
|-
|ORDER_LANGUAGE
|Belegsprache
|Setzt die Sprache des Belegs falls gefüllt, ansonsten wird die Sprache der ermittelten/angelegten Adresse gesetzt.
Setzt bei Adress-Anlage die Sprache aus dem Feld.
|-
|ORDER_TAXEU_COUNTRY
|EULand
|setzt das EU Land auf Belegebene, falls gefüllt. Wenn das EU Land nicht vom Kunden übernommen sondern leer gelassen werden soll kann man dies mit dem Feldinhalt "-" (minus) ansteuern.
|-
|ORDER_TAXATIONTYPE
|Besteuerung
|übersteuert die durch ORDER_TAX_AREA ermittelte Besteuerung durch den hier eingetragenen Wert und setzt die Besteuerung auf Belegebene.
"steuerfrei", "inland", "EU mit UStID", "EU ohne UstID", "Verbundene Unternehmen", "Export/Import" als mögliche Werte. Ebenfalls findet auch eine Auswertung mit dem Input MERCHANT; EU und NON_EU statt. (wie bei ORDER_TAX_AREA)

Sollte das Feld gefüllt sein aber von der Schreibweise auf keinen der Fälle passen wird in den Sage Besteuerungsarten geprüft, ob eine individuelle Besteuerungsart anhand der angegebenen Bezeichnung vorliegt und diese dann auf Belegebene gesetzt.
|-
|ORDER_DOCUMENTTYPE
|Belegart
|übersteuert die in der Konfiguration hinterlegte Belegart, mit der der Beleg angelegt wird. Der Wert muss mit dem entsprechenden Kennzeichen gefüllt sein. (z.B. "VVA" für Auftragsbestätigungen)
|-
|ORDER_SAVE_STATUS
|Beleg speichern/parken
|Übersteuert die Konfiguration, ob ein Beleg gespeichert oder geparkt werden soll.
Wert "1" = speichern, "2" = parken.

Hinweis: Die globale Einstellung "Parken bei abweichendem Lieferland" kann den Wert dann noch übersteuern.
|-
|ORDER_IGNORE
| -
|sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als ignoriert markiert wird und das File in den Save-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ORDER_ERROR
| -
|(Ab Rev.11) sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als Fehler markiert wird und das File in den Fehler-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|}

==== ORDER_PARTIES ====
In dem Bereich der ORDER_PARTIES existieren zwei Knoten namens "BUYER_PARTY" und "SHIPMENT_PARTIES". Dort sind dann ebenfalls weitere Unterknoten definiert welche die Daten nochmal ins Detail auflösen können.

Am Ende gibt es einen größeren ADDRESS-Knoten in der BUYER_PARTY, welcher der Auftraggeber ist. Die angegebenen Daten in diesem ADDRESS-Knoten bilden dann die Grundlage für das in der Sage100 erzeugte Kundenkonto.

Die Daten der DELIVERY_PARTY werden lediglich als Lieferadresse im Sage Beleg hinterlegt.

===== ADDRESS =====
in BUYER_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|Name1 (Adresse),
A0Name1,

A2Name1
|Setzt Name1 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen1 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.

Generiert teilweise den Beleg Matchcode mit (Format NAME, CITY)
|-
|NAME2
|Name2 (Adresse),
A0Name2,

A2Name2
|Setzt Name2 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen2 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|MATCHCODE
|Matchcode
|Setzt Matchcode in einer neuen Adresse (und Kunde), die angelegt wird, falls gefüllt
Setzt auf BelegEbene ebenfalls den A0Matchcode falls gefüllt.

Sollte der Matchcode leer sein, wird das Standard Sage Pattern mit "Name, Ort" gesetzt.
|-
|STREET
|Lieferstraße (Adresse),
A0Straße,

A2Straße
|Setzt die Lieferstraße bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungsstraße, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|Lieferzusatz (Adresse),
A0Zusatz,
A2Zusatz
|Setzt den Lieferzusatz bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Lieferzusatzinformationen, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|LieferPLZ (Adresse),
A0Postleitzahl,
A2Postleitzahl
|Setzt die Postleitzahl bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Postleitzahl, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|LieferOrt (Adresse),
Matchcode (Adresse),
Matchcode (Kto)
A0Ort,
A2Ort
|Setzt den Ort/Stadt bei einer neuen Adresse die angelegt wird.
Bildet in Kombination mit Name ein Teil des Adress- sowie Kto-Matchcodes. (Format NAME, CITY)
Setzt auf Belegebene den Auftraggeber- und Rechnungsort, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|Lieferland (Adresse),
A0Land,
A2Land
|Setzt das Lieferland bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene das Auftraggeber- und Rechnungs-Land, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|USTID
| -
|setzt Umsatzsteuer ID, wird allerdings durch das Feld CUSTOMER_USTID in den CUSTOMER_MASTER_DATA übersteuert. Weitere Informationen dazu sind unter CUSTOMER_USTID zu finden.
|-
|SALUTATION
|Anrede (Adresse)
Anrede (Ansprechpartner)
A0Anrede,
A2Anrede
|Setzt Anrede bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Anrede bei einem neuen Ansprechpartner der angelegt wird
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Anrede, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|SALUTATION_LETTER
|Ansprache (Adresse)
Briefanrede (Ansprechpartner)
|Setzt Ansprache bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Briefanrede bei einem neuen Ansprechpartner
|-
|HOMEPAGE
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_MASTER_DATA
| -
|siehe Detailbereich CUSTOMER_MASTER_DATA
|-
|CONTACT
| -
|siehe Detailbereich CONTACT
|-
|<USER_XXXXX>
|UserFelder für KHKAdressen
|Hier können diverse UserFelder für den Adressstamm mit gesetzt werden.
|}
In DELIVERY_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|A1Name1
|Setzt auf Belegebene den Namen1 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|NAME2
|A1Name2
|Setzt auf Belegebene den Namen2 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|STREET
|A1Straße
|Setzt auf Belegebene die Straße in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|A1Zusatz
|Setzt auf Belegebene das Zusatzfeld in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|A1Postleitzahl
|Setzt auf Belegebene die Postleitzahl in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|A1Ort
|Setzt auf Belegebene den Ortsnamen in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|A1Land
EULand
|Setzt auf Belegebene das Land in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
Setzt ebenfalls das EULand, wenn es sich um eine EU-Bestellung (TAX_AREA = EU) handeln und nicht durch ORDER_TAXEU_COUNTRY übersteuert ist.
|-
|SALUTATION
|A1Anrede
|Setzt auf Belegebene die Anrede in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|}

====== CUSTOMER_MASTER_DATA ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CUSTOMER_USTID
|EUUstID (Kto),
EUUmsatzsteuerID
|Setzt bei einem neuen Kunden die UmsatzsteuerID,
Setzt auf Belegebene die EU-UmsatzsteuerID, falls gefüllt.
|-
|CUSTOMER_GROUP
|Gruppe (Kto),
Kontogruppe
|Setzt bei einem neuen Kunden die Kundengruppe, falls gefüllt (andernfalls Wert aus Kunden-Vorlage)
Setzt auf Belegebene die Kundengruppe, falls gefüllt
|-
|CUSTOMER_PRICELIST_ID
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_PRICELIST_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_TYPE_OF_TRANSPORT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|ADDRESS_GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|EU_COUNTRY
|EULand(Kto)
|setzt bei einer Kunden-Neuanlage im Kunden das EU Land, falls gefüllt
|-
|TAX_AREA
| -
|übersteuert das XML-Feld ORDER_TAX_AREA und hilft dabei, den Vorlage-Kunden zu ermitteln. (MERCHANT; EU; NON_EU als mögliche Eingabe-Werte)
|-
|<USER_XXXXX>
|Userfelder Konto
|Hier können diverse UserFelder für den Kunden (KHKKontokorrent) gesetzt werden.
|}

====== CONTACT ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CONTACT_NAME
|Ansprechpartner (ASP),
A0Ansprechpartner,

A2Ansprechpartner
|Setzt bei einer Ansprechpartner-Anlage den Matchcode.
Setzt auf Belegebene den Ansprechpartner des Auftraggebers
Setzt auf Belegebene den Ansprechpartner des Rechnungsempfängers
|-
|PHONE (type=private)
|Telefon (ASP)
TelefonPrivat (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Telefon & Telefon (privat)
|-
|PHONE (type=mobile)
|Mobilfunk (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Mobil"
|-
|FAX
|Telefax (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Fax"
|-
|EMAIL
|Email(Adresse)
Email (ASP)
|Setzt bei einer neuen Adresse die Email-Adresse (Ist auch relevantes Feld bei der Prüfung ob der Ansprechpartner bereits existiert)
Setzt bei einer Ansprechpartner-Anlage die Email-Adresse
|-
|DEPARTMENT
| -
|aktuell keine Verwendung in der Sage
|-
|GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|POSITION
| -
|aktuell keine Verwendung in der Sage
|-
|SALUTATION
|Anrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Anrede"
|-
|SALUTATION_LETTER
|Briefanrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Briefanrede"
|-
|<USER_XXXXX>
|UserFelder Ansprechpartner
|Hier können diverse UserFelder für den Ansprechpartner KHKAnsprechpartner gesetzt werden.
|}

==== PAYMENTS ====
der Knoten PAYMENTS beinhaltet einen Knoten PAYMENT, dieser ist wie folgt aufgebaut:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ACCOUNT
| -
|siehe Detailbereich ACCOUNT
|-
|TRANS_ID
|USER_TransID
|füllt Userfeld
|-
|PAYMENT_STATUS
|USER_Paymentstatus
|füllt Userfeld
|-
|PAYMENT_AMOUNT
|USER_PaymentAmount
|füllt Userfeld
|}

===== ACCOUNT =====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|HOLDER
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_COUNTRY
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_ACCOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_BIC
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_IBAN
| -
|aktuell keine Verwendung in der Sage
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BUSINESS_TRANSACTION_ID
| -
|aktuell keine Verwendung in der Sage
|-
|ORDER_REFERENCE
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_ITEM_LIST ==

=== ORDER_ITEM ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|POSTYPE
|Positionstyp
|gibt an welche Art Position die aktuelle Position ist.
0 = Gruppenüberschrift (Text kann in DESCRIPTION_SHORT mit übergeben werden.
1 = Artikelposition,

2 = Zwischensumme (Text kann in DESCRIPTION_SHORT mit übergeben werden.

3 = Textposition (Text kann in DESCRIPTION_LONG mit übergeben werden.

7 = optionale Artikelposition
|-
|ORDER_POS_ID
|USER_OrderPosID
|füllt Userfeld
|-
|STORNIERT
|USER_Storniert
|füllt Userfeld
|-
|LINE_ITEM_ID
| -
|aktuell keine Verwendung in der Sage. Wird aber dennoch zur Reihenfolge der Positionen verwendet.
|-
|VARIANT_ID
|AuspraegungID
|setzt die AuspraegungID der Position
|-
|STORAGE_AREA_NAME
|Lagerplatz
|setzt den Lagerplatz an der Position. Es muss der Name der Kurzbezeichnung des Lagerplatzes in der XML hinterlegt werden.
|-
|ARTICLE_ID
| -
|siehe Detailbereich ARTICLE_ID
|-
|QUANTITY
|Menge
|setzt die Menge der Position
|-
|ORDER_UNIT
| -
|(ab Rev.4) Setzt die Mengeneinheit der Position. Hinweis: Es findet keine Prüfung statt, ob diese angegebene Mengeneinheit in der Sage auch existiert.
Es muss der entsprechende Sage Schlüssel angegeben werden (z.B. "Stk" für Stück oder "Pal" für Palette)
|-
|DELIVERYDATE
|Liefertermin
|setzt den Liefertermin der Position. XML-Datum wird übernommen, wenn in der Konfiguration bei "Liefertermin Belegeposition" der Wert XMLDatum eingestellt ist.
|-
|ARTICLE_PRICE
| -
|siehe Detailbereich ARTICLE_PRICE
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|-
|QUANTITY_UNIT
|Mengeneinheit
|Steuert die Mengeneinheit.
Zulässige Werte: BME = Basismengeneinheit; VPE = Verpackungseinheit; VME = Verkaufsmengeneinheit

Hinweis: Sollte das Feld in der XML gefüllt sein, übersteuert dies die globale Property "POS_VKMengeneinheit".

Die Menge der Position wird durch den XML-Wert übernommen. Es findet keine Umrechnung statt.

Dieses Feld übersteuert die ORDER_UNIT und die globale Einstellungen POS_VKMengeneinheit
|-
|USE_OL_PRICE
| -
|(ab Rev.11) übersteuert auf Positionsebene, ob der Preis aus der Sage100 bezogen werden soll.
0 = XML Preis; 1 = Preis aus Sage;
übersteuert die Einstellung "Preisermittlung der Artikel-Positionen aus Sage statt XML-Betrag"
|}

==== ARTICLE_ID ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SUPPLIER_AID
|Artikelnummer
|ermittelt anhand des Feldinhalt den Sage Artikel, beim Wert "0" wird anhand der DESCRIPTION_SHORT der Zuschlagsname ermittelt (PosType muss bei Zuschlägen ebenfalls 1 sein)
|-
|BUYER_AID
|USER_BuyerAID
|füllt Userfeld, meist Verwendet als Referenzfeld für z.B. Marktplatz-Artikelnummer etc.
|-
|DESCRIPTION_SHORT
|Bezeichnung1
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_SHORT2
|Bezeichnung2
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_LONG
|Langtext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_DIMENSION
|Dimensionstext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|}

==== ARTICLE_PRICE ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|PRICE_AMOUNT
|Einzelpreis
|setzt den Einzelpreis der Position.
Setzt bei globaler Property "Gutschein als Belegrabatt" anhand des gesetzen Preises den Absolutwert des Belegrabattes.
|-
|PRICE_LINE_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX
| -
|aktuell keine Verwendung in der Sage
|-
|DISCOUNT_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BATCHES
| -
|aktuell keine Verwendung in der Sage
|-
|SERIAL_NUMBERS
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_DISCOUNTS ==
Da Sage bis zu drei Beleg-Rabatte unterstützt gibt es hier auch entsprechend drei Knoten. Jeder der drei Knoten hat drei weitere Felder unter sich die dann die die entsprechenden Werte verarbeiten.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DISCOUNT1
|steuert ersten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT2
|steuert zweiten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT3
|steuert dritten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|}

==== Werte-Felder für Beleg-Rabatte ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DESCRIPTION
|Rabatttext
|setzt zu dem jeweiligen Rabatt den Rabatttext
|-
|DISCOUNTPERCENT
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt kein AbsolutRabatt ist.
Sollte in der XML sowohl DISCOUNTVALUE als auch DISCOUNTPERCENT gefüllt sein übersteuer das DISCOUNTVALUE Und der Rabatt wird als Absolutrabatt mit dem Festbetrag aus DISCOUNTVALUE angelegt
|-
|DISCOUNTVALUE
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt ein AbsolutRabatt ist.
|}

== ORDER_FIELDS ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SALES_REPRESENTATIVE
| Vertreter
|(ab Rev10) Setzt die Vertreternummer im Belegfuß. Es findet keine Prüfung statt, ob dieser Vertreter auch existiert.
|-
|CUSTOMER_TEMPLATE
| -
|(ab Rev10) Übersteuert den Vorlagenkunden aus der Konfiguration. Kundenneuanlage muss trotzdem in der Konfiguration aktiviert sein.
|-
|CUSTOMER_OL_ID
|Adresse
|Setzt das Auftraggeber Konto des zu importierenden Belegs
|-
|YOUR_ORDER
|Referenznummer
|Setzt die Referenznummer/Ihre Belegnummer auf Belegebene (falls gefüllt)
|-
|YOUR_TOKEN
|Referenzzeichen
|Setzt das Referenzzeichen/Ihr Zeichen auf Belegebene (falls gefüllt)
|-
|ORDER_MATCHCODE
|Matchcode
|Setzt den Belegmatchcode (falls gefüllt)
|-
|BUSINESS_TRANSACTION_MATCHCODE
|Hauptvorgangsmatchcode
|Setzt den Hauptvorgangsmatchcode (falls gefüllt)
|-
|OL_PROJECT_ID
| -
|keine Verwendung in der Sage
|-
|<USER_XXXXX>
|
|
|}

== ORDER_SUMMARY ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|TOTAL_ITEM_NUM
| -
|keine Verwendung in der Sage
|-
|TOTAL_AMOUNT
| -
|keine Verwendung in der Sage
|}

== XML-Beispiele ==
[[OmniBelegService:XMLExample 1|Beispiel1: Oxid eSales Bestell-XML]]

[[OmniBelegService:XMLExample 2|Beispiel2: komplexere XML Struktur mit unterschiedlichen Belege-Positionstypen nach einer XSL-Transformation]]

[[OmniBelegService:XSD|XML Schema Definition (XSD)]]

[[OmniBelegService:XMLExample TESTSchema|Beispiel3: TESTSCHEMA inkl. Kommentaren welcher Knoten auf welchem Sage Feld landet.]]

OmniBelegService:XMLFormatbeschreibung

2026-05-27T13:09:44Z

MH: /* ORDER_INFO */

{{DISPLAYTITLE:XML-Format-Beschreibung}}

== Vorwort ==
Hier auf dieser Seite wird das zu importierende XML-Format beschrieben. Es kann durchaus sein dass das ein oder andere Feld nicht in der XML vorhanden ist, da manche davon erst beim Übersetzen des BelegMappers eingefügt werden oder optionale Felder sind.

== ORDER_HEADER ==

=== CONTROL_INFO ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|GENERATION_INFO
| -
|lediglich ein Hinweis über den Ersteller der XML, kein Einfluss auf den Import
|-
|GENERATION_DATE
| -
|lediglich ein Hinweis über das Erstell-Datum der XML, fließt allerdings in die globale Einstellung "DocumentOlderThanXValue" ein und dadurch können zu alte XML-Dateien blockiert werden.
|}

=== ORDER_INFO ===
In dem ORDER_INFO Bereich werden grundlegende Informationen zur Bestellung angegeben.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ORDER_PARTIES
| -
|siehe Detailbereich ORDER_PARTIES
|-
|PAYMENTS
| -
|siehe Detailbereich PAYMENTS
|-
|PRICE_CURRENCY
|setzt Währungskennzeichen
|wenn leer, dann wird standardmäßig "EUR" für Euro gesetzt
|-
|BRUTTO_KZ
|steuert ob Brutto- oder Nettobeleg
|0 = netto; -1 = brutto. Je nach Kennzeichen werden auch die Positionspreise als Netto bzw. Brutto Preis verarbeitet
|-
|DELIVERY_CONDITION
|Lieferbedingung
|setzt die Lieferbedingung anhand Schlüssel oder Bezeichnung (Konfiguration),
|-
|ORDER_IDENTIFICATION
|USER_OrderIdentification
|füllt Userfeld, anhand dessen Inhalt wird ermittelt, ob es bereits ein Beleg zu der zu importierenden Bestellung gibt und ggf. dann ein BelegUpdate auf einen bestehenden Beleg ausgeführt
|-
|VDL
|Versandart
|setzt die Versandart anhand Schlüssel oder Bezeichnung (Konfiguration)
|-
|ORDER_ID
|USER_OrderId
|füllt Userfeld, dient lediglich für den Benutzer zum Suchen einer Bestellung
|-
|ORDER_PAYMENT_STATUS
|USER_OrderPaymentStatus
|füllt Userfeld, beinhaltet den Bezahl-Status aus dem Shop
|-
|ORDER_DATE
|USER_OrderDate bzw. BelegDatum
|füllt Userfeld. Sollte in der Konfiguration bei Belegdatum der wert "XML-Datum" hinterlegt sein wird das Belegdatum im Beleg gesetzt.
|-
|ORDER_CHANNEL
|USER_OrderChannel
|füllt Userfeld, notwendig für den OmniSeller Statusupload. Kann auch für kundenindividuelle Auswertungen und Analysen verwendet werden
|-
|ORDER_ACCOUNT
| USER_OrderAccount
|füllt Userfeld
|-
|ORDER_CUSTOMER_ACCOUNT
| -
|aktuell keine Verwendung
|-
|ORDER_DELIVERYDATE
|Liefertermin Beleg
|setzt Liefertermin im Beleg (falls in Konfiguration bei Liefertermin Beleg "XML Daten" ausgewählt ist. Schreibt standardmäßig tagesaktuelles Datum falls Property ausgewählt und trotzdem ein leeres Datum in der XML.
|-
|ORDER_VALUTADATE
|ValutaDatum Beleg
|Setzt das Valutadatum im Beleg. Übernimmt standardmäßig den Wert aus ORDER_DELIVERYDATE sollte nichts gesetzt sein.
|-
|ORDER_PAYMENT_ID
|Bezahlart, USER_PaymentID
|steuert die Bezahlart anhand Schlüssel oder Bezeichnung (Konfiguration), setzt außerdem das UserFeld USER_PaymentID
|-
|ORDER_STATUS_ID
|USER_OrderStatusID
|füllt Userfeld, Shop Status der Bestellung
|-
|ORDER_NOTE
|USER_OrderNote, BelegMemo
|Je nach Konfiguration wird das Bestellkommentar in das UserFeld oder auch in das Memo Feld des Belegs geschrieben
|-
|ORDER_TAX_AREA
|Besteuerung
|steuert u.A. die Besteuerung in der Sage. Auswahl "MERCHANT" (Inland), "EU" und "NONEU". Bei abweichendem Inhalt wird die Besteuerung aus dem Kunden übernommen.
|-
|ORDER_COUPON
|USER_OrderCoupon
|füllt Userfeld des angewendeten Gutschein-Codes
|-
|ORDER_COUPON_AMOUNT
|USER_OrderCouponAmount
|füllt Userfeld des angewendeten Gutschein-Betrags
|-
|ORDER_USER
|Beleg Bearbeiter
|setzt den Belegbearbeiter, übersteuert den in der Konfiguration hinterlegten Bearbeiter falls gefüllt.
|-
|ORDER_HEADER_TEXT
|Kopftext
|Setzt den Kopftext des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_HTML
|KopftextHTML
|Setzt den KopftextHtml des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_RTF
|KopfTextRTF
|Setzt den KopftextRtf des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT
|Fußtext
|Setzt den Fußtext des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_HTML
|FußtextHTML
|Setzt den FußtextHtml des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_RTF
|FußtextRTF
|Setzt den FußtextRtf des Belegs falls gefüllt
|-
|ORDER_TAX_CODE
| -
|aktuell keine Verwendung
|-
|ORDER_LANGUAGE
|Belegsprache
|Setzt die Sprache des Belegs falls gefüllt, ansonsten wird die Sprache der ermittelten/angelegten Adresse gesetzt.
Setzt bei Adress-Anlage die Sprache aus dem Feld.
|-
|ORDER_TAXEU_COUNTRY
|EULand
|setzt das EU Land auf Belegebene, falls gefüllt. Wenn das EU Land nicht vom Kunden übernommen sondern leer gelassen werden soll kann man dies mit dem Feldinhalt "-" (minus) ansteuern.
|-
|ORDER_TAXATIONTYPE
|Besteuerung
|übersteuert die durch ORDER_TAX_AREA ermittelte Besteuerung durch den hier eingetragenen Wert und setzt die Besteuerung auf Belegebene.
"steuerfrei", "inland", "EU mit UStID", "EU ohne UstID", "Verbundene Unternehmen", "Export/Import" als mögliche Werte. Ebenfalls findet auch eine Auswertung mit dem Input MERCHANT; EU und NON_EU statt. (wie bei ORDER_TAX_AREA)

Sollte das Feld gefüllt sein aber von der Schreibweise auf keinen der Fälle passen wird in den Sage Besteuerungsarten geprüft, ob eine individuelle Besteuerungsart anhand der angegebenen Bezeichnung vorliegt und diese dann auf Belegebene gesetzt.
|-
|ORDER_DOCUMENTTYPE
|Belegart
|übersteuert die in der Konfiguration hinterlegte Belegart, mit der der Beleg angelegt wird. Der Wert muss mit dem entsprechenden Kennzeichen gefüllt sein. (z.B. "VVA" für Auftragsbestätigungen)
|-
|ORDER_SAVE_STATUS
|Beleg speichern/parken
|Übersteuert die Konfiguration, ob ein Beleg gespeichert oder geparkt werden soll.
Wert "1" = speichern, "2" = parken.

Hinweis: Die globale Einstellung "Parken bei abweichendem Lieferland" kann den Wert dann noch übersteuern.
|-
|ORDER_IGNORE
| -
|sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als ignoriert markiert wird und das File in den Save-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ORDER_ERROR
| -
|(Ab Rev.11) sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als Fehler markiert wird und das File in den Fehler-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|}

==== ORDER_PARTIES ====
In dem Bereich der ORDER_PARTIES existieren zwei Knoten namens "BUYER_PARTY" und "SHIPMENT_PARTIES". Dort sind dann ebenfalls weitere Unterknoten definiert welche die Daten nochmal ins Detail auflösen können.

Am Ende gibt es einen größeren ADDRESS-Knoten in der BUYER_PARTY, welcher der Auftraggeber ist. Die angegebenen Daten in diesem ADDRESS-Knoten bilden dann die Grundlage für das in der Sage100 erzeugte Kundenkonto.

Die Daten der DELIVERY_PARTY werden lediglich als Lieferadresse im Sage Beleg hinterlegt.

===== ADDRESS =====
in BUYER_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|Name1 (Adresse),
A0Name1,

A2Name1
|Setzt Name1 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen1 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.

Generiert teilweise den Beleg Matchcode mit (Format NAME, CITY)
|-
|NAME2
|Name2 (Adresse),
A0Name2,

A2Name2
|Setzt Name2 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen2 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|MATCHCODE
|Matchcode
|Setzt Matchcode in einer neuen Adresse (und Kunde), die angelegt wird, falls gefüllt
Setzt auf BelegEbene ebenfalls den A0Matchcode falls gefüllt.

Sollte der Matchcode leer sein, wird das Standard Sage Pattern mit "Name, Ort" gesetzt.
|-
|STREET
|Lieferstraße (Adresse),
A0Straße,

A2Straße
|Setzt die Lieferstraße bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungsstraße, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|Lieferzusatz (Adresse),
A0Zusatz,
A2Zusatz
|Setzt den Lieferzusatz bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Lieferzusatzinformationen, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|LieferPLZ (Adresse),
A0Postleitzahl,
A2Postleitzahl
|Setzt die Postleitzahl bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Postleitzahl, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|LieferOrt (Adresse),
Matchcode (Adresse),
Matchcode (Kto)
A0Ort,
A2Ort
|Setzt den Ort/Stadt bei einer neuen Adresse die angelegt wird.
Bildet in Kombination mit Name ein Teil des Adress- sowie Kto-Matchcodes. (Format NAME, CITY)
Setzt auf Belegebene den Auftraggeber- und Rechnungsort, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|Lieferland (Adresse),
A0Land,
A2Land
|Setzt das Lieferland bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene das Auftraggeber- und Rechnungs-Land, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|USTID
| -
|setzt Umsatzsteuer ID, wird allerdings durch das Feld CUSTOMER_USTID in den CUSTOMER_MASTER_DATA übersteuert. Weitere Informationen dazu sind unter CUSTOMER_USTID zu finden.
|-
|SALUTATION
|Anrede (Adresse)
Anrede (Ansprechpartner)
A0Anrede,
A2Anrede
|Setzt Anrede bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Anrede bei einem neuen Ansprechpartner der angelegt wird
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Anrede, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|SALUTATION_LETTER
|Ansprache (Adresse)
Briefanrede (Ansprechpartner)
|Setzt Ansprache bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Briefanrede bei einem neuen Ansprechpartner
|-
|HOMEPAGE
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_MASTER_DATA
| -
|siehe Detailbereich CUSTOMER_MASTER_DATA
|-
|CONTACT
| -
|siehe Detailbereich CONTACT
|-
|<USER_XXXXX>
|UserFelder für KHKAdressen
|Hier können diverse UserFelder für den Adressstamm mit gesetzt werden.
|}
In DELIVERY_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|A1Name1
|Setzt auf Belegebene den Namen1 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|NAME2
|A1Name2
|Setzt auf Belegebene den Namen2 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|STREET
|A1Straße
|Setzt auf Belegebene die Straße in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|A1Zusatz
|Setzt auf Belegebene das Zusatzfeld in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|A1Postleitzahl
|Setzt auf Belegebene die Postleitzahl in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|A1Ort
|Setzt auf Belegebene den Ortsnamen in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|A1Land
EULand
|Setzt auf Belegebene das Land in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
Setzt ebenfalls das EULand, wenn es sich um eine EU-Bestellung (TAX_AREA = EU) handeln und nicht durch ORDER_TAXEU_COUNTRY übersteuert ist.
|-
|SALUTATION
|A1Anrede
|Setzt auf Belegebene die Anrede in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|}

====== CUSTOMER_MASTER_DATA ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CUSTOMER_USTID
|EUUstID (Kto),
EUUmsatzsteuerID
|Setzt bei einem neuen Kunden die UmsatzsteuerID,
Setzt auf Belegebene die EU-UmsatzsteuerID, falls gefüllt.
|-
|CUSTOMER_GROUP
|Gruppe (Kto),
Kontogruppe
|Setzt bei einem neuen Kunden die Kundengruppe, falls gefüllt (andernfalls Wert aus Kunden-Vorlage)
Setzt auf Belegebene die Kundengruppe, falls gefüllt
|-
|CUSTOMER_PRICELIST_ID
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_PRICELIST_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_TYPE_OF_TRANSPORT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|ADDRESS_GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|EU_COUNTRY
|EULand(Kto)
|setzt bei einer Kunden-Neuanlage im Kunden das EU Land, falls gefüllt
|-
|TAX_AREA
| -
|übersteuert das XML-Feld ORDER_TAX_AREA und hilft dabei, den Vorlage-Kunden zu ermitteln. (MERCHANT; EU; NON_EU als mögliche Eingabe-Werte)
|-
|<USER_XXXXX>
|Userfelder Konto
|Hier können diverse UserFelder für den Kunden (KHKKontokorrent) gesetzt werden.
|}

====== CONTACT ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CONTACT_NAME
|Ansprechpartner (ASP),
A0Ansprechpartner,

A2Ansprechpartner
|Setzt bei einer Ansprechpartner-Anlage den Matchcode.
Setzt auf Belegebene den Ansprechpartner des Auftraggebers
Setzt auf Belegebene den Ansprechpartner des Rechnungsempfängers
|-
|PHONE (type=private)
|Telefon (ASP)
TelefonPrivat (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Telefon & Telefon (privat)
|-
|PHONE (type=mobile)
|Mobilfunk (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Mobil"
|-
|FAX
|Telefax (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Fax"
|-
|EMAIL
|Email(Adresse)
Email (ASP)
|Setzt bei einer neuen Adresse die Email-Adresse (Ist auch relevantes Feld bei der Prüfung ob der Ansprechpartner bereits existiert)
Setzt bei einer Ansprechpartner-Anlage die Email-Adresse
|-
|DEPARTMENT
| -
|aktuell keine Verwendung in der Sage
|-
|GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|POSITION
| -
|aktuell keine Verwendung in der Sage
|-
|SALUTATION
|Anrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Anrede"
|-
|SALUTATION_LETTER
|Briefanrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Briefanrede"
|-
|<USER_XXXXX>
|UserFelder Ansprechpartner
|Hier können diverse UserFelder für den Ansprechpartner KHKAnsprechpartner gesetzt werden.
|}

==== PAYMENTS ====
der Knoten PAYMENTS beinhaltet einen Knoten PAYMENT, dieser ist wie folgt aufgebaut:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ACCOUNT
| -
|siehe Detailbereich ACCOUNT
|-
|TRANS_ID
|USER_TransID
|füllt Userfeld
|-
|PAYMENT_STATUS
|USER_Paymentstatus
|füllt Userfeld
|-
|PAYMENT_AMOUNT
|USER_PaymentAmount
|füllt Userfeld
|}

===== ACCOUNT =====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|HOLDER
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_COUNTRY
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_ACCOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_BIC
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_IBAN
| -
|aktuell keine Verwendung in der Sage
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BUSINESS_TRANSACTION_ID
| -
|aktuell keine Verwendung in der Sage
|-
|ORDER_REFERENCE
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_ITEM_LIST ==

=== ORDER_ITEM ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|POSTYPE
|Positionstyp
|gibt an welche Art Position die aktuelle Position ist.
0 = Gruppenüberschrift (Text kann in DESCRIPTION_SHORT mit übergeben werden.
1 = Artikelposition,

2 = Zwischensumme (Text kann in DESCRIPTION_SHORT mit übergeben werden.

3 = Textposition (Text kann in DESCRIPTION_LONG mit übergeben werden.

7 = optionale Artikelposition
|-
|ORDER_POS_ID
|USER_OrderPosID
|füllt Userfeld
|-
|STORNIERT
|USER_Storniert
|füllt Userfeld
|-
|LINE_ITEM_ID
| -
|aktuell keine Verwendung in der Sage. Wird aber dennoch zur Reihenfolge der Positionen verwendet.
|-
|VARIANT_ID
|AuspraegungID
|setzt die AuspraegungID der Position
|-
|STORAGE_AREA_NAME
|Lagerplatz
|setzt den Lagerplatz an der Position. Es muss der Name der Kurzbezeichnung des Lagerplatzes in der XML hinterlegt werden.
|-
|ARTICLE_ID
| -
|siehe Detailbereich ARTICLE_ID
|-
|QUANTITY
|Menge
|setzt die Menge der Position
|-
|ORDER_UNIT
| -
|(ab Rev.4) Setzt die Mengeneinheit der Position. Hinweis: Es findet keine Prüfung statt, ob diese angegebene Mengeneinheit in der Sage auch existiert.
Es muss der entsprechende Sage Schlüssel angegeben werden (z.B. "Stk" für Stück oder "Pal" für Palette)
|-
|DELIVERYDATE
|Liefertermin
|setzt den Liefertermin der Position. XML-Datum wird übernommen, wenn in der Konfiguration bei "Liefertermin Belegeposition" der Wert XMLDatum eingestellt ist.
|-
|ARTICLE_PRICE
| -
|siehe Detailbereich ARTICLE_PRICE
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|-
|QUANTITY_UNIT
|Mengeneinheit
|Steuert die Mengeneinheit.
Zulässige Werte: BME = Basismengeneinheit; VPE = Verpackungseinheit; VME = Verkaufsmengeneinheit

Hinweis: Sollte das Feld in der XML gefüllt sein, übersteuert dies die globale Property "POS_VKMengeneinheit".

Die Menge der Position wird durch den XML-Wert übernommen. Es findet keine Umrechnung statt.

Dieses Feld übersteuert die ORDER_UNIT und die globale Einstellungen POS_VKMengeneinheit
|-
|USE_OL_PRICE
| -
|(ab Rev.11) übersteuert auf Positionsebene, ob der Preis aus der Sage100 bezogen werden soll.
0 = XML Preis; 1 = Preis aus Sage;
übersteuert die Einstellung "Preisermittlung der Artikel-Positionen aus Sage statt XML-Betrag"
|}

==== ARTICLE_ID ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SUPPLIER_AID
|Artikelnummer
|ermittelt anhand des Feldinhalt den Sage Artikel, beim Wert "0" wird anhand der DESCRIPTION_SHORT der Zuschlagsname ermittelt (PosType muss bei Zuschlägen ebenfalls 1 sein)
|-
|BUYER_AID
|USER_BuyerAID
|füllt Userfeld, meist Verwendet als Referenzfeld für z.B. Marktplatz-Artikelnummer etc.
|-
|DESCRIPTION_SHORT
|Bezeichnung1
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_SHORT2
|Bezeichnung2
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_LONG
|Langtext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_DIMENSION
|Dimensionstext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|}

==== ARTICLE_PRICE ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|PRICE_AMOUNT
|Einzelpreis
|setzt den Einzelpreis der Position.
Setzt bei globaler Property "Gutschein als Belegrabatt" anhand des gesetzen Preises den Absolutwert des Belegrabattes.
|-
|PRICE_LINE_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX
| -
|aktuell keine Verwendung in der Sage
|-
|DISCOUNT_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BATCHES
| -
|aktuell keine Verwendung in der Sage
|-
|SERIAL_NUMBERS
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_DISCOUNTS ==
Da Sage bis zu drei Beleg-Rabatte unterstützt gibt es hier auch entsprechend drei Knoten. Jeder der drei Knoten hat drei weitere Felder unter sich die dann die die entsprechenden Werte verarbeiten.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DISCOUNT1
|steuert ersten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT2
|steuert zweiten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT3
|steuert dritten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|}

==== Werte-Felder für Beleg-Rabatte ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DESCRIPTION
|Rabatttext
|setzt zu dem jeweiligen Rabatt den Rabatttext
|-
|DISCOUNTPERCENT
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt kein AbsolutRabatt ist.
Sollte in der XML sowohl DISCOUNTVALUE als auch DISCOUNTPERCENT gefüllt sein übersteuer das DISCOUNTVALUE Und der Rabatt wird als Absolutrabatt mit dem Festbetrag aus DISCOUNTVALUE angelegt
|-
|DISCOUNTVALUE
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt ein AbsolutRabatt ist.
|}

== ORDER_FIELDS ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SALES_REPRESENTATIVE
| Vertreter
|(ab Rev10) Setzt die Vertreternummer im Belegfuß. Es findet keine Prüfung statt, ob dieser Vertreter auch existiert.
|-
|CUSTOMER_TEMPLATE
| -
|(ab Rev10) Übersteuert den Vorlagenkunden aus der Konfiguration. Kundenneuanlage muss trotzdem in der Konfiguration aktiviert sein.
|-
|CUSTOMER_OL_ID
|Adresse
|Setzt das Auftraggeber Konto des zu importierenden Belegs
|-
|YOUR_ORDER
|Referenznummer
|Setzt die Referenznummer/Ihre Belegnummer auf Belegebene (falls gefüllt)
|-
|YOUR_TOKEN
|Referenzzeichen
|Setzt das Referenzzeichen/Ihr Zeichen auf Belegebene (falls gefüllt)
|-
|ORDER_MATCHCODE
|Matchcode
|Setzt den Belegmatchcode (falls gefüllt)
|-
|BUSINESS_TRANSACTION_MATCHCODE
|Hauptvorgangsmatchcode
|Setzt den Hauptvorgangsmatchcode (falls gefüllt)
|-
|OL_PROJECT_ID
| -
|keine Verwendung in der Sage
|-
|<USER_XXXXX>
|
|
|}

== ORDER_SUMMARY ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|TOTAL_ITEM_NUM
| -
|keine Verwendung in der Sage
|-
|TOTAL_AMOUNT
| -
|keine Verwendung in der Sage
|}

== XML-Beispiele ==
[[OmniBelegService:XMLExample 1|Beispiel1: Oxid eSales Bestell-XML]]

[[OmniBelegService:XMLExample 2|Beispiel2: komplexere XML Struktur mit unterschiedlichen Belege-Positionstypen nach einer XSL-Transformation]]

[[OmniBelegService:XSD|XML Schema Definition (XSD)]]

[[OmniBelegService:XMLExample TESTSchema|Beispiel3: TESTSCHEMA inkl. Kommentaren welcher Knoten auf welchem Sage Feld landet.]]

OmniBelegService:Releases Rev 16

2026-05-27T12:03:05Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

* Skript 91: Erweiterung der OmniBelegService_Belege Tabelle um das Feld Order_ValutaDate.
* Skript 92: (ehemals 46) Erweiterung der Prozedur spOmniBelegService_InsertXMLBeleg um den Parameter Order_ValutaDate

==== Konfiguration ====

* Es wurde ein Fehler behoben, dass Änderungen in untergeordneten Gruppen wie z.B. den Prozeduren optisch nicht angezeigt und teilweise auch nicht gespeichert und übernommen wurden.

==== Dienst ====

* Es wurde das Start-Argument /nomutex hinzugefügt. Dieser Start Parameter überspringt die Mutex Prüfung und erlaubt somit mehrfach parallel laufende Instanzen des Dienstes auf dem gleichen System.

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.
* Einführung FehlerCode 55: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden." Dieser Fall tritt ein, wenn auf einem bereits gespeicherten Beleg ein BelegUpdate eingespielt werden soll, was aber lediglich den Speicherstatus parken hat.
*  ORDER_ITEMs mit negativem Preis und ohne angegebene Artikelnummer werden nun nicht mehr als negative Zuschläge (Abschläge), sondern als Belegrabatt importiert.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

==== weiteres: ====

OmniBelegService:Releases

2026-05-27T11:56:54Z

MH:

{{DISPLAYTITLE:Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive Changelog.

Die Versionsnummern sind wie folgt aufgebaut: [MajorVersion].[MinorVersion].[Revision]

- MajorVersion: Hauptversion der Sage

- MinorVersion: Unterversion der Sage

-Revision: Aktueller Entwicklungsstand der Software. Fortlaufende, sich erhöhende Nummer.

Es werden hier lediglich die Veränderungen zur Vorgänger-Version aufgelistet.

Sollte eine Version den Status "Beta" haben, behält sich HTK noch vor, Änderungen an dieser Version vorzunehmen und ein Update der selben Version zu veröffentlichen. Änderungen sind dann entsprechend noch im Changelog dokumentiert.

Den Entwicklungs-Hinweisen ist Beachtung zu schenken und diese sollen auch bei einem Update auf diese oder höhere Version Folge geleistet werden. Andernfalls könnte der Import nach dem Update nicht mehr wie gewünscht funktionieren.
{{{!}} class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
!Testumgebung und Freigabe (Sage-Version)
! Changelog
! Downloadlink
|-
|9.0.16
| -
|in Entwicklung
|
|
|[[OmniBelegService:Releases Rev 16|changelog]]
|
|-
|9.0.15
| 26.02.2026
|stable
|Erweiterung der AdressenCheck-Prozedur um den Parameter @isEK (dies muss bei einem Update, sofern eine abweichende "AdressenCheck"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 15|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.15.2-Setup.exe download]
|-
|9.0.14
| 02.01.2026
|stable
|
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 14|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.14.1-Setup.exe download]
|-
|9.0.13
| 29.08.2025
|stable
|Sage hat den internen Aufruf für Vorgangsrechnungen mit der 9.0.9 verändert. Ab Sage Version 9.0.9 ist das Modul Autorechnungen mit älteren Versionen des Dienstes inkompatibel.
|9.0.9 (auch kompatibel und freigegeben für 9.0.10)
|[[OmniBelegService:Releases Rev 13|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.13.2-Setup.exe download]
|-
|9.0.12
| 18.02.2025
|stable
|Erweiterung der Prozedur spOmniBelegService_InsertXMLAdressen um die Parameter A0_CMD_EU_Country und A0_CMD_Tax_Area (dies muss bei einem Update, sofern eine abweichende "InsertXMLAdressen"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.7 + 9.0.8
|[[OmniBelegService:Releases Rev 12|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.12-Setup.exe download]
|-
|9.0.11
| 28.08.2024
|stable
|Die Belege-Positionen Insert Prozedur wurde um den Parameter 'UseOLPrice' erweitert. (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.6 + 9.0.7 ( 9.0.7 Release auch kompatibel für 9.0.8)
|[[OmniBelegService:Releases Rev 11|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.11-Setup_OL907.exe download_9.0.7] [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.11-Setup_OL906.exe download_9.0.6]
|-
|9.0.10
| 08.07.2024
||stable
|unterschiedliche Setups für 9.0.6 & 9.0.7
Hinweis Bei Liveupdate auf 9.0.7 sind ältere Versionen höchstwahrscheinlich nicht mehr kompatibel
|9.0.6 + 9.0.7
|[[OmniBelegService:Releases Rev 10|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.10-Setup_OL907.exe download_9.0.7] [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.10-Setup_OL906.exe download_9.0.6]
|-
|9.0.9
| 20.02.2024
|stable
|
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 9|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.9-Setup.exe download]
|-
|9.0.8
| 04.12.2023
||stable
|Überarbeitung der Standard Prozedur ArtikelCheck (wg. Sage Varianten)
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 8|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.8-Setup.exe download]
|-
|9.0.7
|17.08.2023
||stable
|Hinweis: Sage-Version (Liveupdate-Stand) von mind. 9.0.5 benötigt.
|9.0.5
|[[OmniBelegService:Releases Rev 7|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.7-Setup.exe download]
|-
|9.0.6
| 31.07.2023
| -
|Status aufgrund der neuen Version nach kurzem Abstand nicht weiter verfolgt.
|9.0.4
|[[OmniBelegService:Releases Rev 6|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.6-Setup.exe download]
|-
|9.0.5
| 22.05.2023
|stable
| Erweiterung der Prozedur "spOmniBelegService_InsertXMLPosition" um den Parameter "Quantity Unit" (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
| -
|[[OmniBelegService:Releases Rev 5|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.5-Setup.exe download]
|-
|9.0.4
| 27.02.2023
|stable
|
| -
|[[OmniBelegService:Releases Rev 4|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.4-Setup.exe download]
{{!}}-
{{!}} 9.0.3
{{!}} 09.01.2023
{{!}} stable
{{!}}
| -
{{!}}
[[OmniBelegService:Releases Rev 3|changelog]]
{{!}}
[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.3-Setup.exe download ]
{{!}}-
{{!}} 9.0.2
{{!}} 08.12.2022
{{!}} stable
{{!}} 
| -
{{!}} [[OmniBelegService:Releases Rev 2{{!}}changelog]]
{{!}} [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.2-Setup.exe download]
{{!}}-
{{!}} 9.0.1
{{!}} 20.10.2022
{{!}} stable
{{!}}
 
| -
{{!}} [[OmniBelegService:Releases Rev 1{{!}}changelog]]*
{{!}} [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.1-Setup.exe download]
{{!}}}
<nowiki>*</nowiki>=Die erste Version erfasst Erweiterungen/Verbesserungen, welche sich seit dem letzten Beta Release Stand verändert haben. Weitere grundsätzliche Funktionen können entsprechend dem [[OmniBelegService:Handbuch{{!}}Handbuch]] entnommen werden.

OmniBelegService:Releases Rev 16

2026-05-22T14:42:24Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

==== Konfiguration ====

* Es wurde ein Fehler behoben, dass Änderungen in untergeordneten Gruppen wie z.B. den Prozeduren optisch nicht angezeigt und teilweise auch nicht gespeichert und übernommen wurden.

==== Dienst ====

* Es wurde das Start-Argument /nomutex hinzugefügt. Dieser Start Parameter überspringt die Mutex Prüfung und erlaubt somit mehrfach parallel laufende Instanzen des Dienstes auf dem gleichen System.

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.
* Einführung FehlerCode 55: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden." Dieser Fall tritt ein, wenn auf einem bereits gespeicherten Beleg ein BelegUpdate eingespielt werden soll, was aber lediglich den Speicherstatus parken hat.
*  ORDER_ITEMs mit negativem Preis und ohne angegebene Artikelnummer werden nun nicht mehr als negative Zuschläge (Abschläge), sondern als Belegrabatt importiert.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

==== weiteres: ====

OmniBelegService:Releases Rev 16

2026-05-22T13:49:38Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

==== Konfiguration ====

==== Dienst ====

* Es wurde das Start-Argument /nomutex hinzugefügt. Dieser Start Parameter überspringt die Mutex Prüfung und erlaubt somit mehrfach parallel laufende Instanzen des Dienstes auf dem gleichen System.

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.
* Einführung FehlerCode 55: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden." Dieser Fall tritt ein, wenn auf einem bereits gespeicherten Beleg ein BelegUpdate eingespielt werden soll, was aber lediglich den Speicherstatus parken hat.
*  ORDER_ITEMs mit negativem Preis und ohne angegebene Artikelnummer werden nun nicht mehr als negative Zuschläge (Abschläge), sondern als Belegrabatt importiert.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

==== weiteres: ====

OmniBelegService:Releases Rev 16

2026-05-22T13:22:56Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

*** 

==== Konfiguration ====

****

==== Dienst ====

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.
* Einführung FehlerCode 55: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden." Dieser Fall tritt ein, wenn auf einem bereits gespeicherten Beleg ein BelegUpdate eingespielt werden soll, was aber lediglich den Speicherstatus parken hat.
*  ORDER_ITEMs mit negativem Preis und ohne angegebene Artikelnummer werden nun nicht mehr als negative Zuschläge (Abschläge), sondern als Belegrabatt importiert.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

****

==== weiteres: ====

OmniBelegService:Fehlercodes

2026-05-22T12:11:00Z

MH:

{{DISPLAYTITLE:Fehlercodes & Hilfestellungen}}

== Vorwort ==
Auf dieser Seite sind diverse Fehlermeldungen aufgelistet und es ist entsprechende Hilfestellung bei der ein oder anderen Fehlermeldung angegeben.

Die Fehlernummern sind nach Bereichen getrennt.

Die niedrigen Fehlernummern (1-49) sind im Bereich des XML-Einlese & Verarbeitungsvorgang.

Der Hunderter Bereich (100-199) sind im Bereich der Beleganlage & Belegimport.

der Zweihunderter Bereich (200-299) ist reserviert für den Beleg-Transform.

Die Fehlernummern ab 300 betrifft die Hintergrund-Prozesse (z.B. Lizenz Prüfung).

== XML-Einlese & Verarbeitungsvorgang ==

<div style="background-color:#d3d3d3;">

==== FehlerCode #-1 ====
'''Meldung: "unbekannter Fehler!"'''

'''Auslöser:'''

unbekannt

'''Analyse & Lösungsmöglichkeiten:'''

* Rückmeldung an HTK zur Fehleranalyse
</div>

==== FehlerCode #1 ====
'''Meldung: "technischer Fehler beim Auslesen der Importformate"'''

'''Auslöser:'''

Die Konfigurierten Importformate konnten nicht sauber aus der Datenbank-Tabelle "OmniBelegService_Importformate" ausgelesen werden.

'''mögliche Ursache(n):'''

* Es wurden Konfigurationen Datenbank-technisch verändert oder eingefügt die nun nicht durch die Software ausgelesen werden können.
'''Analyse & Lösungsmöglichkeiten:'''

* Sichtung der Dateninhalte der Tabelle
* Analyse der Query über den SQL-Profiler für genauere Informationen
<div style="background-color:#d3d3d3;">

==== FehlerCode #2 ====
'''Meldung: "Fehler beim Einlesen der Dateien aus dem Pfad: {Pfad}"'''

'''Auslöser:'''

Die Dateien konnten nicht aus dem konfigurierten Pfad ausgelesen werden.

'''mögliche Ursache(n):'''

* Es wurden Ordner-Strukturen gelöscht.
* Es wurden UNC-Freigabe Pfade gelöscht und Ordner nicht mehr erreichbar
* Möglicherweise ist eine Datei durch irgendeinen Benutzer gesperrt
* Schreibfehler in dem Pfad und daher nicht auffindbar
'''Analyse & Lösungsmöglichkeiten:'''

* genannten Pfad über den Windows-Explorer aufrufen
* falsche Pfade über die Importformat-Konfiguration nachkorrigieren.
</div>

==== FehlerCode #3 ====
'''Meldung: "Fehler beim Einlesen der XSL Datei"'''

'''Auslöser:'''

Das XSL-Konfigurationsfile konnte nicht aus dem konfigurierten Pfad eingelesen werden.

'''mögliche Ursache(n):'''

* Es wurden Ordner-Strukturen gelöscht.
* Es wurden UNC-Freigabe Pfade gelöscht und Ordner nicht mehr erreichbar
* Möglicherweise ist eine Datei durch irgendeinen Benutzer gesperrt
* Schreibfehler in dem Pfad und daher nicht auffindbar
* Syntax-Fehler in der Datei und diese ist somit nicht kompilierbar.
'''Analyse & Lösungsmöglichkeiten:'''

* genannten Pfad über den Windows-Explorer aufrufen
* falsche Pfade über die Importformat-Konfiguration nachkorrigieren.
* Syntax-Prüfung der Datei
<div style="background-color:#d3d3d3;">

==== FehlerCode #4 ====
'''Meldung: "Fehler bei der XML/XSL Transformation"'''

'''Auslöser:'''

Die eingelesene XSL-Konfigration konnte nicht auf die zu importierende XML-Datei angewendet werden.

'''mögliche Ursache(n):'''

*die einzulesende XML-Datei ist fehlerhaft
*die einzulesende XML-Datei ist gesperrt
'''Analyse & Lösungsmöglichkeiten:'''

*Überprüfung der XML-Datei nach Syntax-Fehlern
*Überprüfung auf Blockaden der XML-Datei
</div>

==== FehlerCode #5 ====
'''Meldung: "Fehler beim Einlesen der XSD Datei"'''

'''Auslöser:'''

Die XSD-Datei konnte nicht aus dem Installationsverzeichnis des Dienstes eingelesen werden.

'''mögliche Ursache(n):'''

* Datei fehlt auf Kundensystem
* Datei ist gesperrt
'''Analyse & Lösungsmöglichkeiten'''

* Überprüfung ob die Datei "Sage_Belegformat.xsd" in dem BelegService Installationsverzeichnis vorhanden ist. Standardmäßig wird diese immer mit dem Setup ausgeliefert.
<div style="background-color:#d3d3d3;">

==== FehlerCode #6 ====
'''Meldung: "Fehler bei der  XSD Schema Validierung"'''

'''Auslöser:'''

wird ausgegeben, wenn die einzulesende XML-Datei mit der dazugehörigen XSL-Datei nicht den vorgegebenen Anforderungen der XSD-Validierung entspricht

'''mögliche Ursache(n):'''

*XML-Datensätze sind länger als in der Sage erlaubt
*Es fehlen Pflichtfelder in der XML-Datei
*XSL-Anpassungen sorgen für Überlängen oder nicht gesetzte Pflichtfelder
'''Analyse & Lösungsmöglichkeiten:'''

*Lesen der Fehlermeldungen und Korrektur der vorliegenden Daten in der XML-Datei
</div>

==== FehlerCode #7 ====
'''Meldung: "technischer Fehler beim Auslesen der BelegServiceProperties"'''

'''Auslöser:'''

wird ausgegeben, wenn die globalen Einstellungen technisch nicht ausgelesen werden können (Tabelle OmniBelegService_Settings)

'''mögliche Ursache(n):'''

*Verbindungsprobleme zum SQL-Server
*Softwarebug
'''Analyse & Lösungsmöglichkeiten:'''

*Datensichtung der Tabelle "OmniBelegService_Settings"
<div style="background-color:#d3d3d3;">

==== FehlerCode #8 ====
'''Meldung: "Fehler beim Einlesen der Property {propertyname}"'''

'''Auslöser:'''

wird ausgegeben, wenn eine bestimmte Einstellungen nicht korrekt gesetzt werden kann

'''mögliche Ursache(n):'''

*falsche Datentyp-Angabe/Schreibfehler in dem Property-Wert
'''Analyse & Lösungsmöglichkeiten:'''

*Überprüfung des Wertes der Property in den globalen Einstellungen
</div>

==== FehlerCode #9 ====
'''Meldung: "Fehler bei Übernahme der Daten in XML-Belegobjekt"'''

'''Auslöser:'''

wird ausgegeben, wenn die eingelesenen XML-Daten nicht sauber in ein internes Datenobjekt überführt werden kann und somit Datenverlust entstehen würde.

'''mögliche Ursache(n):'''

*diverse XML-Feldinhalte die versehentlich durch die XSD-Prüfung gerutscht sind
'''Analyse & Lösungsmöglichkeiten:'''

*nur über Sichtung der Daten möglich
<div style="background-color:#d3d3d3;">

==== FehlerCode #10 ====
'''Meldung: "Fehler beim Importieren der Daten in die Datenbank (Bereich: {bereich} )"'''

'''Auslöser:'''

wird ausgegeben, wenn die Daten des zu erstellenden Auftrags nicht in die SQL-Tabellen eingetragen werden können.

'''mögliche Ursache(n):'''

*Fehler in angepasster Prozedur Adressen-Insert
*Fehler in angepasster Prozedur BelegePosition-Insert
*Fehler in angepasster Prozedur Belege-Insert
*Verweise auf Prozeduren in Importformat-Konfiguration die nicht existieren
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung der gespeicherten Prozedur(en)
</div>

==== FehlerCode #11 ====
'''Meldung: "Fehler beim Anwenden der kundenspezifischen Einstellung: {Name}"'''

'''Auslöser:'''

wird ausgegeben, wenn bei einer Initialen Prüfung manche gesetzten Properties und Voraussetzungen nicht erfüllt werden können und es zu einem technischen Fehler kommt

'''mögliche Ursache(n):'''

*technischer Fehler beim setzen des Liefertermins der Position/Beleges
*technischer Fehler bei der Prüfung der Artikelnummern
*technischer Fehler bei der Ermittlung der Vorlagen-Adressen
*technischer Fehler beim Setzen des Belegbearbeiters
*technischer Fehler bei der Prüfung des Datei/Order-Datums
*technischer Fehler bei der Propertyprüfung "ParkenBeiAbweichendemLIeferland"
'''Analyse & Lösungsmöglichkeiten:'''

*Datensichtung und Überprüfung auf Datensätze der o.g. Punkte
<div style="background-color:#d3d3d3;">

==== FehlerCode #12 ====
'''Meldung: "Fehler bei der Überprüfung/Ermittlung der Adressnummer;"'''

'''Auslöser:'''

Aktuell nicht mehr vorhanden. Wird in einem späteren 100er Fehler geprüft und ausgegeben.

</div>

==== FehlerCode #13 ====
'''Meldung: "Die hinterlegte Customer_OL_ID existiert nicht oder konnte nicht gefunden werden"'''

'''Auslöser:'''

Aktuell nicht mehr vorhanden. Wird in einem späteren 100er Fehler geprüft und ausgegeben.

<div style="background-color:#d3d3d3;">

==== FehlerCode #14 ====
'''Meldungen:'''

'''"Es konnte keine passende Kunden-Vorlage ermittelt werden"'''

'''"Fehler bei der Adressvorlagenermittlung, ggf. falscher Input in XML-Felder TAX_AREA oder fehlende Importvorlagen für das Szenario"'''

'''"Es konnte keine passende Vorlage ermittelt werden. (Kundenvorlagen-Prozedur aktiv!) "'''

'''Auslöser:'''

wird ausgegeben, wenn durch Kombination aus dem Brutto-Kennzeichen und der ORDER_TAX_AREA keine passende Kundenvorlage ermittelt werden kann.

'''mögliche Ursache(n):'''
*ungültiger Wert in dem XML-Feld "ORDER_TAX_AREA" bzw. "CUSTOMER_TAX_AREA"
*nicht alle Kundenvorlagen wurden in der Importformat-Konfiguration gesetzt (und der Haken "Anlage von Neukunden" ist in der Konfiguration gesetzt)
*die Kundenvorlagen-Prozedur liefert ein leeres Ergebnis
'''Analyse & Lösungsmöglichkeiten:'''

* Prüfung ob in dem XML-Feld "ORDER_TAX_AREA" bzw. "CUSTOMER_TAX_AREA" der Wert "MERCHANT","EU" oder "NON_EU" steht.
* Prüfung ob in der Importformat-Konfiguration für alle entsprechenden Vorlagenbereiche Kundennummern hinterlegt wurden.
* Deaktivierung von "Anlage von Neukunden" wenn Aufträge sowieso nur auf Bestandskunden angelegt werden.
* Prüfung der Kundenvorlagen-Prozedur (falls aktiviert)
</div>
==== FehlerCode #15 ====
'''Meldung: "Die angegebene Artikelnummer {Artikelnummer} konnte nicht gefunden werden. Prüfen Sie, ob die Artikelnummer existiert bzw. dieser auch Aktiv ist und auf Verkauf steht."'''

'''Auslöser:'''

wird ausgegeben, wenn bei der Artikelnummer-Prüfung (gespeicherte Prozedur "spOmniBelegService_ArtikelCheck" kein Artikel gefunden wird.

'''mögliche Ursache(n):'''

*Artikelnummer nicht in Sage vorhanden
*Artikelnummer nicht in Sage aktiv
*Artikel steht nicht auf Verkauf
*Fehler bei einer angepassten Prozedur
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung der Artikelnummer in der Sage
<div style="background-color:#d3d3d3;">

==== FehlerCode #16 ====
'''Meldung: "Fehler beim Auslesen der Email-Einstellungen"'''

'''Auslöser:'''

aktuell noch nicht implementiert. Wird dann ausgegeben wenn Email-Einstellungen nicht ausgelesen werden können für spätere Email-Benachrichtigungen bei Fehlerfällen.

</div>

==== FehlerCode #17 ====
'''Meldung: "mindestens ein falsch angegebener Pfad in der Importformatdefinition. Importformat kann somit nicht starten"'''

'''Auslöser:'''

wird ausgegeben, wenn mindestens ein Pfad in der Import-Definition nicht gefunden wurde

'''mögliche Ursache(n):'''

*gelöschte Ordner-Strukturen
*falsch geschriebene Pfade
'''Analyse & Lösungsmöglichkeiten:'''

*Die in der Import-Definition angegebenen Pfade über den Windows-Explorer überprüfen und ggf. korrigieren.
<div style="background-color:#d3d3d3;">

==== FehlerCode #18 ====
'''Meldung: "Die globalen Einstellungen erlauben keine Positionen mit Nullpreisen. Der Import wurde abgebrochen"'''

'''Auslöser:'''

Es existiert eine Artikelposition die keinen Preis hat. In der Konfiguration werden allerdings Null Euro Preise nicht zugelassen

'''mögliche Ursache(n):'''

*In den globalen Einstellungen werden Nullpreise nicht erlaubt
*In der XML-Datei ist eine Position ohne Preis
'''Analyse & Lösungsmöglichkeiten:'''

*Property umstellen dass dies nun zulässig ist
</div>

==== FehlerCode #19 ====
'''Meldungen:'''

'''"Das Bestell Datum in der XML Datei ist älter als die Tage, die laut globaler Einstellung (DocumentOlderThenXValue = {Zahl}) zulässig ist."'''

'''"Das Generate Datum in der XML Datei ist älter als die Tage, die laut globaler Einstellung (DocumentOlderThenXValue={Zahl}) zulässig ist."'''

'''Auslöser:'''

Die Datei oder das Bestelldatum in der XML-Datei ist älter als die globale Konfiguration erlaubt. Dies dient als Schutz-Mechanismus um alte, nicht mehr aktuelle und fehlerhafte Importe zu vermeiden.

'''mögliche Ursache(n):'''

* zu altes Datum in dem XML-Knoten GENERATION_DATE im ORDER_HEADER
* zu altes Datum in dem XML-Knoten ORDER_DATE in ORDER_INFO
* zu niedrige Property in der globalen Einstellung "DocumentOlderThenXValue"
'''Analyse & Lösungsmöglichkeiten:'''

*XMl-Felder Sichtung
*Umstellung der globalen Einstellung und erneutes Importieren
<div style="background-color:#d3d3d3;">

==== FehlerCode #20 ====
'''Meldung: "die Länge der Order_Note ist länger als 250 Zeichen und kann deshalb auch nicht in das lt. Konfiguration gewünschte Feld USER_OrderNote eingetragen werden"'''

'''Auslöser:'''

wird ausgegeben, wenn die Länge des Bestellkommentars zu lange ist (über 250Zeichen) und somit nicht in das lt. Konfiguration gesetzte USER_OrderNote Feld eingefügt werden kann

'''mögliche Ursache(n):'''

*Feldinhalt zu lang
'''Analyse & Lösungsmöglichkeiten:'''

*In der Importformat-Konfiguration nicht mehr in das "USER_OrderNote" Feld schreiben lassen
*XSL-Anpassung dass das nach 250Zeichen abgeschnitten wird.
</div>

==== FehlerCode #21 ====
'''Meldung: "Fehler in der Prozedur KDVorlagen: {Meldung}."'''

'''Auslöser:'''

wird ausgegeben, wenn die optionale Prozedur Kundenvorlagen-Ermittlung verwendet wird und in einen (technischen) Fehler läuft.

'''mögliche Ursache(n):'''

* Fehlerhaftes Customizing in der Prozedur

'''Analyse & Lösungsmöglichkeiten:'''

* Sichtung der SQL-Prozedur

<div style="background-color:#d3d3d3;">
==== FehlerCode #22 ====
'''Meldung: "Das Pflichtfeld ORDER_IDENTIFICATION wurde nicht angegeben."'''

'''Auslöser:'''

wird ausgegeben, wenn das XML Feld ORDER_IDENTIFICATION leer ist. Da dieses Feld eine zentrale Bedeutung bei der Belegermittlung hat wird ein leerer Feldinhalt blockiert.

'''mögliche Ursache(n):'''

*der BelegMapper zeigt auf ein leeres/nicht vorhandenes XML-Feld.
'''Analyse & Lösungsmöglichkeiten:'''

*Über den BelegMapper eine gültige Zuordnung generieren.
*den Urheber der Datei informieren, dass das entsprechende Feld gefüllt sein muss. (Standardpfad ORDER/ORDER_HEADER/ORDER_INFO/ORDER_ID)
</div>

==== FehlerCode #23 ====
'''Meldung: "Fehlerfall durch BelegMapper-Konfiguration: {Meldung aus Mapper}."'''

'''Auslöser:'''

wird ausgegeben, wenn laut Konfiguration in dem BelegMapper ein Beleg einen Fehlerfall auslösen soll. Es wird hier dann die im BelegMapper definierte Meldung als Grund ausgegeben.

'''mögliche Ursache(n):'''

* Customizing im BelegMapper die dieses Verhalten herbeiführen.

<div style="background-color:#d3d3d3;">
==== FehlerCode #24 ====
'''Meldung: "Die Feldlänge des Feldes {Feldname} überschreitet die maximal zulässige Länge von {x} Zeichen."'''

'''Auslöser:'''

wird ausgegeben, wenn ebsteimmte XML-Feldinhalte zu lange sind.

'''mögliche Ursache(n):'''

* Customizing im BelegMapper oder zu lange XML Feldinhalte die dadurch sageseitig nicht verarbeitet werden können.
</div>
== Beleganlage & Belegimport ==

<div style="background-color:#d3d3d3;">
==== FehlerCode #100 ====
'''Meldung: "unbekannter Fehler beim importieren in das ERP System"'''

'''Auslöser:'''

unbekannt, hat technischen Ursprung

'''mögliche Ursache(n):'''

* unbekannt
'''Analyse & Lösungsmöglichkeiten:'''

*Rücksprache HTK
</div>
==== FehlerCode #101 ====
'''Meldung: "unbekannter Fehler beim importieren in das ERP System"'''

'''Auslöser:'''

unbekannt, steht ggf. in einem Zusammenhang mit einer Sage Komponente.

'''mögliche Ursache(n):'''

* unbekannt
'''Analyse & Lösungsmöglichkeiten:'''

*Überprüfung im TraceLog Manager ob etwas ersichtlich ist.
*Rücksprache HTK

<div style="background-color:#d3d3d3;">
==== FehlerCode #102 ====
'''Meldung: "Fehler bei der Erstellung der ERP-Belegkopfdaten. {Meldung}"'''

'''Auslöser:'''

wird ausgegeben, wenn an einer Stelle die Daten aus dem Sage Belegkopf nicht richtig gefüllt werden können.

'''mögliche Ursache(n):'''

* eventuelle Feldüberlängen die vorher nicht abgefangen wurden
* fehlende Daten in einem XML-Feld die vorher nicht abgefangen wurden
'''Analyse & Lösungsmöglichkeiten:'''

*Überprüfung im TraceLog Manager ob etwas ersichtlich ist.
*Rücksprache HTK
</div>
==== FehlerCode #103 ====
'''Meldung: "Fehler bei der Erstellung der BelegePositionen"'''

'''Auslöser:'''

wird ausgegeben, wenn an einer Stelle die Daten der Sage-Belegpositionen nicht richtig gefüllt werden können, aber dir Ursache nicht genauer spezifiziert wurde.

'''mögliche Ursache(n):'''

* eventuelle Feldüberlängen die vorher nicht abgefangen wurden
* fehlende Daten in einem XML-Feld die vorher nicht abgefangen wurden
'''Analyse & Lösungsmöglichkeiten:'''

*Überprüfung im TraceLog Manager ob etwas ersichtlich ist.
*Rücksprache HTK
<div style="background-color:#d3d3d3;">
==== FehlerCode #104 ====
'''Meldung: "unbehandelter Fehler beim Anlegen des Belegs"'''

'''Auslöser:'''

wird ausgegeben, wenn das Speichern des Beleges an irgendeiner Stelle auf einen unerwarteten Fehler läuft.

'''mögliche Ursache(n):'''

* Zusatzlösungen die in die Standard-Sage-Prozesse eingreifen sorgen für ein Fehlverhalten.
'''Analyse & Lösungsmöglichkeiten:'''

*Überprüfung im TraceLog Manager ob etwas ersichtlich ist.
</div>
==== FehlerCode #105 ====
'''Meldung: "Fehler beim Validieren des Beleges!"'''

'''Auslöser:'''

wird ausgegeben, wenn die Validierung des Beleges (Sage-Funktion die die eingetragenen BelegDaten gegenprüft) fehlschlägt.

'''mögliche Ursache(n):'''

* fehlende/falsche Daten im Beleg
'''Analyse & Lösungsmöglichkeiten:'''

*Lesen und Reagieren auf ausgegebene Sage Fehlermeldung.
*Überprüfung im TraceLog Manager ob etwas ersichtlich ist.
<div style="background-color:#d3d3d3;">
==== FehlerCode #106 ====
'''Meldung: "Fehler beim Speichern des Beleges! "'''

'''Auslöser:'''

wird ausgegeben, wenn der Beleg in Sage nicht gespeichert werden konnte

'''mögliche Ursache(n):'''

* fehlende/falsche Daten im Beleg
'''Analyse & Lösungsmöglichkeiten:'''

*Lesen und Reagieren auf ausgegebene Sage Fehlermeldung.
*Überprüfung im TraceLog Manager ob etwas ersichtlich ist.
</div>
==== FehlerCode #107 ====
'''Meldung: "Fehler bei der Bearbeitung der angegebenen Adress-Daten"'''

'''Auslöser:'''

wird ausgegeben, wenn bei dem Adress-Handling ein Fehler aufgetreten ist, nicht genauer spezifiziert.

'''mögliche Ursache(n):'''

* Kunde konnte nicht ermittelt werden
* Kunde konnte dem Beleg nicht zugeordnet werden
* Kunde konnte nicht angelegt werden
'''Analyse & Lösungsmöglichkeiten:'''

*Überprüfung im TraceLog Manager ob etwas ersichtlich ist.
*Rücksprache HTK
<div style="background-color:#d3d3d3;">
==== FehlerCode #108 ====
'''Meldung: "Fehler bei der Initialisierung bzw. beim Laden eines vorhandenen Beleges"'''

'''Auslöser:'''

wird ausgegeben wenn ein Beleg nicht geladen werden konnte

'''mögliche Ursache(n):'''

* SQL-Fehler/Netzwerkfehler bei der Prüfung ob der Beleg bereits existiert
* Fehler beim Laden des gefundenen Belegs
* Fehler beim Initialisieren eines neuen Belegs
'''Analyse & Lösungsmöglichkeiten:'''

*Überprüfung im TraceLog Manager ob etwas ersichtlich ist.
</div>
==== FehlerCode #109 ====
'''Meldung: "Fehler bei der Auswertung der Benutzerfelder"'''

'''Auslöser:'''

wird ausgegeben, wenn die Userfelder nicht korrekt aufgeschlüsselt werden können.

'''mögliche Ursache(n):'''
*fehlerhafte Anpassung in der Prozedur "spOmniBelegService_InsertXMLBeleg", die die Benutzerfelder betreffen
*fehlerhafte Anpassung in der Prozedur "spOmniBelegService_InsertXMLPosition", die die Benutzerfelder betreffen
*fehlerhafte Anpassung in der Prozedur "spOmniBelegService_InsertXMLAdressen", die die Benutzerfelder betreffen
'''Analyse & Lösungsmöglichkeiten:'''
*Sichtung der Prozeduren
*kurzzeitige Deaktivierung des ERP-Import Tasks und Sichtung der Daten nach dem Einlesen der Daten in den OmniBelegService Import Tabellen ( Belege; Belege_Adressen; Belege_Positionen)

<div style="background-color:#d3d3d3;">
==== FehlerCode #110 ====
'''Meldung: "Fehler beim Auslesen der offenen Belegdaten"'''

'''Auslöser:'''

technischer Fehler. Wird ausgegeben, wenn die Belegdaten nicht aus der Tabelle OmniBelegService_Belege ausgelesen werden können.

'''mögliche Ursache(n):'''
*nicht passender Datensatz in der OmniBelegService_Belege Tabelle
'''Analyse & Lösungsmöglichkeiten:'''
*Sichtung der Daten in der OmniBelegService_Belege Tabelle.
*über den SQL-Profiler die abgesetzte SQL-Abfrage für die OmniBelegService_Belege Tabelle ermitteln und diese manuell nochmal prüfen.
</div>
==== FehlerCode #111 ====
'''Meldung: "Fehler beim setzen des Belegdatums: Fehlerbehandlung: aktuelles Datum wird gesetzt"'''

'''Auslöser:'''

wird ausgegeben, wenn das Belegdatum nicht gesetzt werden kann.

'''mögliche Ursache(n):'''
*verstelltes Windows-Datum
*fehlendes Datum in der XML
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung in Importformat-Definition ob Belegdatum auf XML-Datum steht.
*Falls XML-Datum, Prüfung des XML-Feldinhaltes "ORDER_DATE".
*Falls System- bzw. Belegdatum, Prüfung ob die Windows-Einstellungen das korrekte heutige Datum gesetzt haben.

<div style="background-color:#d3d3d3;">
==== FehlerCode #112 ====
'''Meldung: "Fehler bei der Überprüfung ob Neu- oder Bestandskunde"'''
</div>

Information: Fehlernummer nicht mehr vorhanden. Wurde durch FehlerCode115 abgelöst bei Erweiterung mit Ansprechpartner & Kontokorrent.
==== FehlerCode #113 ====
'''Meldung: "Das Mandanten-Objekt für den Mandanten <Nummer> konnte nicht geöffnet werden. Bitte Prüfen Sie Netzwerk/Sage-Dienste/Zugangsdaten für den Benutzer <UserName>"'''

'''Auslöser:'''

wird ausgegeben, wenn der hinterlegte Benutzer sich nicht in die Sage (AddOn Anmeldung) einloggen kann.

'''mögliche Ursache(n):'''
*Netzwerk-Störung
*keine Sage Dienste laufen
*bei dem hinterlegten Benutzer wurden Zugangsdaten geändert.
'''Analyse & Lösungsmöglichkeiten:'''
*ggf. hilft ein Neustart der Dienste
*Fehleranalyse im TraceLog Manager
<div style="background-color:#d3d3d3;">
==== FehlerCode #114 ====
'''Meldung: "Ein Mandantenobjekt konnte nicht geöffnet werden"'''

'''Auslöser:'''

wird ausgegeben, wenn kein Mandantenobjekt für den aktuellen Mandanten geöffnet werden kann.

'''mögliche Ursache(n):'''
*technische oder Sageseitige Störung.
*eventuelle Ursache ist ein Neustart des Datenbank-Servers oder der Sage Dienste.
'''Analyse & Lösungsmöglichkeiten:'''
*Fehleranalyse im TraceLog Manager
*"normaler" Login-Versuch in die Warenwirtschaft
*Neustart des Dienstes
</div>
==== FehlerCode #115 ====
'''Meldung: "Fehler bei der Überprüfung der AdressDaten (AdressenCheck), Prozedur {Prozedurname}, Meldung: {Meldung}"'''

'''Auslöser:'''

wird ausgegeben, wenn die Adress-Prüfung in einen Fehler läuft

'''mögliche Ursache(n):'''
*fehlerhafte Anpassung in der Prozedur spOmniBelegService_AdressenCheck
'''Analyse & Lösungsmöglichkeiten:'''
*Sichtung der Prozedur spOmniBelegService_AdressenCheck
<div style="background-color:#d3d3d3;">
==== FehlerCode #116 ====
'''Meldung: "Fehler beim Verschieben des Files in den Endordner"'''

'''Auslöser:'''

wird ausgegeben, wenn die XML-Datei nicht aus dem Processing in den Save bzw. Fehler-Ordner verschoben werden konnte

'''mögliche Ursache(n):'''
*gelöschte Ordner
*fehlende Berechtigungen auf die Ordner
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung der Ordner und Schreibrechte
</div>
==== FehlerCode #117 ====
'''Meldung: "Fehler beim Prüfen der Referenznummer."'''

'''Auslöser:'''

wird ausgegeben, wenn die Abfrage nach der Referenznummer auf einen Fehler stößt

'''mögliche Ursache(n):'''
*unbekannt, technischer Herkunft
'''Analyse & Lösungsmöglichkeiten:'''
*unbekannt
<div style="background-color:#d3d3d3;">
==== FehlerCode #118 ====
'''Meldung: "Die Referenznummer {Nummer} existiert bereits."'''

'''Auslöser:'''

wird ausgegeben, wenn eine Referenznummer bereits existiert und die Gefahr besteht, dass ein Beleg dann doppelt vorhanden sein wird.

'''mögliche Ursache(n):'''
*Ein Beleg mit der Referenznummer des aktuellen Belegs existiert bereits in der Sage100
'''Analyse & Lösungsmöglichkeiten:'''
*Das muss der Kunde entscheiden was zu tun ist
*optional: Deaktivierung der globalen Einstellung "Referenznummer prüfen" für den Import der Bestellung
</div>
==== FehlerCode #119 ====
'''Meldung: "Kundenanlage ist deaktiviert, aber es konnte kein Kunde zugeordnet werden"'''

'''Auslöser:'''

wird ausgegeben, wenn dem Beleg kein Bestandskunde zugeordnet werden konnte, aber lauf Importdefinition keine Kundenanlage erlaubt ist

'''mögliche Ursache(n):'''
*Fehler in dem XSL-Mapper, dass für diese Bestellung kein Sammelkonto o.Ä. zugewiesen wurde
'''Analyse & Lösungsmöglichkeiten:'''
*inhaltliche Prüfung des XSL-Mappers und der XML-Datei
*Aktivierung der Kundenanlage
<div style="background-color:#d3d3d3;">
==== FehlerCode #120 ====
'''Meldung: "Das Vorlagenkonto '{Adressvorlage}' konnte nicht ermittelt werden"'''

'''Auslöser:'''

wird ausgegeben, wenn das hinterlegte Vorlagen-Konto in der Sage nicht gefunden wurde

'''mögliche Ursache(n):'''
*Schreibfehler in der Importformat-Definition
*Vorlagen-Konto wurde in der Sage gelöscht
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung nach vorhanden Adress-Vorlagen in der Sage & Korrektur falls abweichende Nummern vorhanden
</div>
==== FehlerCode #121 ====
'''Meldung: "Der angegebene Zuschlagsname '{Zuschlagsname}' wurde nicht in der Sage  gefunden."'''

'''Auslöser:'''

wird ausgegeben, wenn in der XML-Datei eine Position als Zuschlag ermittelt wurde, aber dessen Bezeichnung nicht in der Sage existiert.

'''mögliche Ursache(n):'''
*Zuschlag nicht in der Sage definiert, Betrag würde verloren gehen und somit abweichender Endbetrag zwischen XML und Sage
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung des Zuschlag-Namen in der XML-Datei.
*Anlage der (neuen) Zuschlagsbezeichnung in der Sage.
<div style="background-color:#d3d3d3;">
==== FehlerCode #122 ====
'''Meldung: "Es können nicht alle Belegrabatte erfasst werden"'''

'''Auslöser:'''

wird ausgegeben, wenn nicht alle Belegrabatte erfasst werden können. (mehr als 3 vorhanden.)

'''mögliche Ursache(n):'''
*Es gibt sehr viele Gutscheine als BelegPositionen.
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung der XML-Datei nach Anzahl der Gutscheine.
*ggf. Deaktivierung der globalen Einstellung "GutscheinAlsBelegRabatt" für Gutscheine auf Positionsebene mit Negativbetrag.
</div>
==== FehlerCode #123 ====
'''Meldung: "Die VorlagenAdresse zu dem Kunden {kto} konnte nicht gefunden werden"'''

'''Auslöser:'''

wird ausgegeben, wenn zu dem hinterlegten Vorlage-Konto keine Adressnummer gefunden wird

'''mögliche Ursache(n):'''
*das hinterlegte Vorlagen-Konto bzw. die Adresse dazu existiert nicht mehr in der Sage
*Schreibfehler in der Konto-Vorlage
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung nach vorhanden Adress-Vorlagen in der Sage & Korrektur falls abweichende Nummern vorhanden
<div style="background-color:#d3d3d3;">
==== FehlerCode #124 ====
'''Meldung: "Es konnte kein Mandantenobjekt zu dem Mandant {ID} geöffnet werden"'''

'''Auslöser:'''

Tritt im Multi-Mandanten-Betrieb auf, wenn zu einem Mandanten kein Mandanenobjekt geöffnet werden konnte.

'''mögliche Ursache(n):'''
*Mandant existiert nicht, Schreibfehler in der Importformat-Definition
*ungültige Zugangsdaten/Berechtigungen für unseren Benutzer für den Mandanten
*durch Neustart Datenbank-Server oder Sage Dienste eventuell Probleme mit der Datenbank-Verbindung.
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung vorhandener Mandanten in der Sage
*Prüfung hinterlegte Mandanten in den Importformat-Definitionen
*Dienst-Neustart
</div>
==== FehlerCode #125 ====
'''Meldung: "Fehler beim Initialisieren des Sage Belegobjekts"'''

'''Auslöser:'''

wird ausgegeben, wenn kein neuer Beleg initialisiert werden konnte

'''mögliche Ursache(n):'''
*Sageseitiger/technischer Fehler
'''Analyse & Lösungsmöglichkeiten:'''
*Fehleranalyse im TraceLog Manager
*Dienst-Neustart
<div style="background-color:#d3d3d3;">
==== FehlerCode #126 ====
'''Meldung: "Fehler beim Schließen des Mandantenobjekts"'''

'''Auslöser:'''

wird ausgegeben, wenn ein Mandant aufgrund von Fehlern nicht geschlossen werden konnten.

'''mögliche Ursache(n):'''
*unbekannt, technische Ursache
'''Analyse & Lösungsmöglichkeiten:'''
*unbekannt
</div>
==== FehlerCode #127 ====
'''Meldung: "Fehler bei der Ermittlung des Belegjahres (ggf. neues Geschäftsjahr noch nicht angelegt?)"'''

'''Auslöser:'''

wird ausgegeben, wenn das Belegjahr nicht aus dem Periodenmanager ausgelesen werden kann, weil das aktuellen Datum in keiner Periode vorhanden ist.

'''mögliche Ursache(n):'''
*Neues Geschäftsjahr noch nicht angelegt
*Es ist ein Dienst Neustart notwendig, nachdem das neue Geschäftsjahr angelegt wurde.
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung ob ein aktuelles Geschäftsjahr noch gültig ist.
*Dienst neu starten
<div style="background-color:#d3d3d3;">
==== FehlerCode #128 ====
'''Meldung: "keine passende ZKD gefunden. Die Konfiguration verhindert den Standard-Wert aus dem Kunden"'''

'''Auslöser:'''

wird ausgegeben, wenn in der XML-Datei keine gültige Zahlungskondition hinterlegt wurde, und der Standard aus Sage laut Konfiguration nicht erlaubt ist.

'''mögliche Ursache(n):'''
*Es fehlt noch eine Übersetzung der Zahlungskondition
'''Analyse & Lösungsmöglichkeiten:'''
*Prüfung des XML-Feldinhalts auf übermittelte Zahlungskondition
*Prüfung der Bezahlarten in Sage
</div>
==== FehlerCode #129 ====
'''Meldung: "Die Kundennummer-Ermittlung lieferte kein Ergebnis, eventuell ist der hinterlegte Nummernkreis voll oder die höchste Kontonummer des Preset-Nummernkreises ist vergeben"'''

'''Auslöser:'''

wird ausgegeben, wenn die gespeicherte Prozedur spOmniBelegService_KtoNummerErmittlung für die Konto-Nummer Ermittlung kein Ergebnis zurück liefert und dadurch kein neuer Kunde angelegt werden kann.

'''mögliche Ursache(n):'''

* Der Nummernkreis hinter dem Preset ist voll bzw.
* die höchst mögliche Kto-Nummer wurde vergeben.
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung in den Kunden, ob tatsächlich die höchst mögliche Kto-Nummer mit dem in den globalen Einstellungen hinterlegten Preset vergeben ist.
*Änderung des Presets in den globalen Einstellungen auf einen neuen Nummernkreis
*Prüfung oder Anpassung der gespeicherten Prozedur

<div style="background-color:#d3d3d3;">
==== FehlerCode #130 ====
'''Meldung: "Die Artikelposition für Artikel {Artikelnummer};{AuspraegungID} hat einen Betrag von 0. Dies ist laut globaler Einstellung 'ErlaubeNullPreisPositionen' nicht zulässig."'''

'''Auslöser:'''

wird ausgegeben, wenn eine Position einen Betrag von 0 € hat beim Anlegen der BelegePositionen

'''mögliche Ursache(n):'''

* Bei der Property Preisermittlung aus Sage ist in der Sage100 für den aktuellen Kunden bei dem Artikel kein Preis hinterlegt.
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung ob der genannte Artikel in der bei dem Kunden hinterlegten Preisliste einen Preis hat
*Aktivierung der globalen Einstellung, wenn dies gewünscht und beabsichtigt ist.
</div>

==== FehlerCode #131 ====
'''Meldung: "Der Artikel {pos.Artikelnummer};{pos.AuspraegungsHandle} hat keine Verkaufsmengeneinheit hinterlegt.."'''

'''Auslöser:'''

wird ausgegeben, wenn eine Artikelposition keine Verkaufsmengeneinheit hinterlegt hat und die globale Einstellung "POS_VKMengeneinheit" aktiviert ist.

'''mögliche Ursache(n):'''

* keine Verkaufsmengeneinheit in Sage gepflegt
'''Analyse & Lösungsmöglichkeiten:'''

*Setzen der Verkaufsmengeneinheit bei dem betroffenen Artikel im Artikelstamm
*Die globalen Einstellung "POS_VKMengeneinheit" auf false setzen. (nicht empfohlen, da so ggf. eine Palette zum Stückpreis verkauft werden könnte!)

<div style="background-color:#d3d3d3;">
==== FehlerCode #132 ====
'''Meldung: "Die Position hat einen ungültigen XML-Wert für Quantity_Unit ({Wert})"'''

'''Auslöser:'''

wird ausgegeben, wenn eine Position in der XML (XSL-Mapper) für das Feld Quantity_Unit einen nicht zulässigen Wert beinhaltet.

'''mögliche Ursache(n):'''

* Fehler im XSL-Mapper. Zulässige Werte: "BME" (BasisMengeneinheit); "VPE" (Verpackungseinheit); "VME" (Verkaufsmengeneinheit)
'''Analyse & Lösungsmöglichkeiten:'''

*Sichtung des BelegMappers
</div>

==== FehlerCode #133 ====
'''Meldung: "technischer Fehler in der AfterBelegSave Prozedur: {Meldung}"'''

'''Auslöser:'''

wird ausgegeben, wenn in der AfterBelegSave Prozedur ein Fehler auftritt.

'''mögliche Ursache(n):'''

* SQL Fehler in der gespeicherten Prozedur "spOmniBelegService_AfterBelegSave"
'''Analyse & Lösungsmöglichkeiten:'''

*Sichtung der Prozedur
*Prüfung auf Notwendigkeit und ggf. Deaktivierung in der Konfiguration des Importformats im Reiter Prozeduren

<div style="background-color:#d3d3d3;">
==== FehlerCode #134 ====
'''Meldung: "Die Mengeneinheit {Mengeneinheit} konnte bei dem Artikel {Artikelnummer} keiner Mengeneinheit zugeordnet werden."'''

'''Auslöser:'''

wird ausgegeben, wenn das XML-Feld Order_Unit bei einer Artikelposition gefüllt ist, aber diese Mengeneinheit zu keiner in der Sage angegebenen Mengeneinheiten zugeordnet werden konnte (Verpackung-/Verkaufs-/Basismengeneinheit)

'''mögliche Ursache(n):'''

* Schreibfehler der Mengeneinheit in der XML
* Veränderung der Artikel-Mengeneinheiten im Artikelstamm
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung XML-Inhalt
*Prüfung des Artikels im Artikelstamm
</div>

==== FehlerCode #135 ====
'''Meldung: "technischer Fehler bei der Abmeldung des Mandanten für Mandant {Nummer}. Wenden Sie sich umgehend an den Support. Der Dienst wird zu Ihrer Sicherheit nun beendet."'''

'''Auslöser:'''

wird ausgegeben, wenn die Sitzung des Mandanten nicht geschlossen werden kann.

'''mögliche Ursache(n):'''

* Es gibt möglicherweise alte Verweise welche die Arbeitsweise des Dienstes negativ beeinflussen.
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung des Installations-Ordners des Dienstes. Löschen der dort abliegenden Sage DLLs (Achtung, die SageBelegTransformator.dll ist nicht von Sage!) .
*Fehlerprüfung im Tracelog-Manager

<div style="background-color:#d3d3d3;">
==== FehlerCode #136 ====
'''Meldung: "Es gab einen Fehler bei der Ermittlung der Fremdkurs-Währung ({Währungskennzeichen}): {<spezifischere Fehlermeldung aus Sage>}"'''

'''Auslöser:'''

wird ausgegeben, wenn das XML-Feld PRICE_CURRENCY mit einer Währung gefüllt ist, von EUR abweicht und notwendige Kurse ermittelt werden müssen.

'''mögliche Ursache(n):'''

*Die angegebene Fremdwährung existiert nicht in der Sage.
*Zu der angegebenen Fremdwährung gibt es zur aktuellen Periode (noch) keinen Kurs
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung ob dieser Währungskurs für die aktuelle Periode in der Sage existiert.
*Umstellung der globalen Property "WAEHRUNGSKURSTYP" auf einen anderen Wert der dann eventuell in der Sage vorhanden ist.
</div>
==== FehlerCode #137 ====
'''Meldung: "Die Kundennummer-Ermittlungs Prozedur ({Prozedur-Name}) lief in einen technischen Fehler: {Meldung}"'''

'''Auslöser:'''

wird ausgegeben, wenn die Prozedur für die Kundennummer-Ermittlung in einen Fehler läuft.

'''mögliche Ursache(n):'''

*SQL-Fehler in der konfigurierbaren Prozedur
*Netzwerk Störungen
'''Analyse & Lösungsmöglichkeiten:'''

*sqlseitige Prüfung der Prozedur
*Nach Rücksprache Wiederherstellung auf Standard-Prozedur in der BelegService Konfiguration. (spOmniBelegService_KtoNummerErmittlung)
<div style="background-color:#d3d3d3;">
==== FehlerCode #138 ====
'''Meldung: "Fehler bei der Ermittlung der BesteuerungsID von '{Besteuerungsart}'"'''

'''Auslöser:'''

wird ausgegeben, wenn die Prüfung der BesteuerungsID in einen Fehler läuft oder die angegebene Besteuerungsart nicht gefunden wird.

'''mögliche Ursache(n):'''

*falsche Angabe der Besteuerungsart
*Besteuerungsart wurde gelöscht
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung der Besteuerungsarten in der Sage
*Leeren des Feldinhaltes per BelegMapper Konfiguration.
</div>
==== FehlerCode #139 ====
'''Meldung: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich."'''

'''Auslöser:'''

wird ausgegeben, wenn eine unterschiedlicher Anzahl von Gruppenüberschriften (POSTYPE = 0) und Zwischensummen (POSTYPE = 2) in den zu importierenden Artikelpositionen existieren.

'''Analyse & Lösungsmöglichkeiten:'''

* Die ORDER_ITEMS der XML-Datei prüfen und korrigieren.

<div style="background-color:#d3d3d3;">
==== FehlerCode #140 ====
'''Meldung: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}"'''

'''Auslöser''':

tritt auf, wenn die Beleg-Ermittlungs Prozedur in einen technischen Fehler läuft.

'''Analyse & Lösungsmöglichkeiten:'''

* Sichtung des in der Konfiguration hinterlegten Prozedurnamens der "Beleg-Ermittlung" Prozedur
* Sichtung der Prozedur per SQL-Management Studio
</div>
== Beleg-Transform ==

<div style="background-color:#d3d3d3;">
==== FehlerCode #200 ====
'''Meldung: "Unbekannter Fehler!"'''

'''Auslöser:'''
* unbekannt

'''Analyse & Lösungsmöglichkeiten:'''

* '''Rückmeldung an HTK zur Fehleranalyse'''
</div>
==== FehlerCode #201 ====
'''Meldung: "das Mandantenobjekt konnte nicht geöffnet werden. Vermutlich ist die Kommunikation zum Sage Mehrbenutzer Dienst gestört."'''

'''Auslöser:'''

wird ausgegeben, wenn kein Mandantenobjekt für den Standard-Mandanten (der aus dem Setup) geöffnet werden kann.

'''mögliche Ursachen:'''

* technische oder Sageseitige Störung
* eventuelle Ursache ist ein Neustart des Datenbank-Servers oder der Sage Dienste

'''Analyse & Lösungsmöglichkeiten:'''

* Fehleranalyse im TraceLog-Manager
* "normaler" Login-Versuch in die Warenwirtschaft
* Prüfung der Zugangsdaten für den Benutzer
* Neustart des Dienstes

<div style="background-color:#d3d3d3;">
==== FehlerCode #202 ====
'''Meldung: "Fehler bei der Lieferschein Erstellung: {Meldung}"'''

'''Auslöser:'''

wird ausgegeben, wenn ein zu erstellender Lieferschein Sageseitig nicht erstellt werden kann.

'''mögliche Ursachen:'''

* technische oder Sageseitige Störung
* fehlende Bestände
* sonstige Fehler die aus der Meldung entnommen werden können.

'''Analyse & Lösungsmöglichkeiten:'''

* Analyse im TraceLog-Manager
* die angegebenen Fehler aus der Meldung beseitigen.
</div>

== Hintergrund-Prozesse ==
<div style="background-color:#d3d3d3;">
==== FehlerCode #300 ====
'''Meldung: "Es gab bereits seit {x} Tagen keine Lizenz Synchronisation mehr. Bitte umgehend den Lizenz-Status klären. Der Dienst wird sich in {14 - x} Tagen beenden."'''

'''Auslöser:'''

wird ausgegeben, wenn seit mindestens 7 Tagen keine Lizenz-Synchronisierung mehr funktioniert hat.

'''mögliche Ursache(n):'''

* Firewall blockiert ausgehende HttpRequests (Port 80) an "<nowiki>https://api.omnisellerservices.de</nowiki>" (Standard)
'''Analyse & Lösungsmöglichkeiten:'''

*eingetragener Lizenz-Key & Lizenz-Status prüfen
*manuelle Synchronisation der Lizenz einmal anstoßen in der Lizensierung
</div>
==== FehlerCode #301 ====
'''Meldung: "Der Lizenzstatus ist auf inaktiv. Der Dienst wird keine Aufträge verarbeiten."'''

'''Auslöser:'''

wird ausgegeben, wenn laut Lizenz-Synchronisation kein Modul lizensiert ist.

'''mögliche Ursache(n):'''

* Lizenz ist abgelaufen oder wurde abgeschaltet
'''Analyse & Lösungsmöglichkeiten:'''

*Klärung Lizenz-Status mit HTK
<div style="background-color:#d3d3d3;">
==== FehlerCode #302 ====
'''Meldung: "Fehler beim Versenden der Lizenz-Status Email"'''

'''Auslöser:'''

wird ausgegeben, wenn eine Email bzgl. des Lizenz-Status nicht verwendet werden konnte.

'''mögliche Ursache(n):'''

* Programmier-Fehler der (Beta-) Funktion.
* falsch hinterlegte Email- & SMTP Daten
'''Analyse & Lösungsmöglichkeiten:'''

*Prüfung und Korrektur der SMTP-Daten.
*Meldung an HTK falls Test-Email funktioniert.
</div>
== sonstige Meldungen ==
<div style="background-color:#d3d3d3;">
==== Code #50 ====
'''Meldung: "Beleg wurde ignoriert; es gibt bereits einen Folgebeleg"'''

'''Auslöser:'''

wird ausgegeben, wenn zu der in der XML angegebenen Order_Id in der Sage schon mehr als ein Beleg existiert.

'''mögliche Ursache(n):'''

* Es gibt bereits Folgebelege in der Sage. Änderungen werden nun nicht mehr berücksichtigt.
</div>
==== Code #51 ====
'''Meldung: "Beleg wurde ignoriert. Es gibt bereits einen Beleg. Laut Importdefinition werden keine Updates eingespielt"'''

'''Auslöser:'''

wird ausgegeben, wenn zu der in der XML angegebenen Order_ID in der Sage schon ein Beleg existiert.

'''mögliche Ursache(n):'''

* Die Konfiguration in der Importformat-Definition verhindert BelegUpdates. Somit werden Folge-XMLs ignoriert.
<div style="background-color:#d3d3d3;">
==== Code #52 ====
'''Meldung: "Beleg wurde ignoriert (BelegMapper): <Meldung>"'''

'''Auslöser:'''

wird ausgegeben, wenn laut Konfiguration in dem BelegMapper ein Beleg nicht importiert werden soll. Es wird hier dann die im BelegMapper definierte Meldung als Grund ausgegeben.

'''mögliche Ursache(n):'''

* Kundenindividuelle Anforderungen, die umgesetzt wurden.
</div>
==== Code #53 ====
'''Meldung: "Beleg wurde ignoriert. Der Vorgang ist bereits erfüllt."'''

'''Auslöser:'''

wird ausgegeben, wenn zu der in der XML angegebenen Order_ID ein Beleg gefunden wird, aber der Vorgang zu dem gefundenen Beleg bereits als erfüllt markiert ist.

'''mögliche Ursache(n):'''

* Es wurde der Beleg z.B. als Direktrechnung importiert (und wir ändern nachträglich keine Daten mehr ab, da wir nicht wissen ob diese bereits bearbeitet wurde, da niemals Folgebelege existieren werden).
* Der Beleg wurde bereits verarbeitet und abgeschlossen mit Folgebelegen.

<div style="background-color:#d3d3d3;">
==== Code #54: ====
'''Meldung: "Beleg wird laut OrderChannel-Konfiguration ignoriert."'''

'''Auslöser''':

wird ausgegeben, wenn in dem XML Feld "ORDER_CHANNEL" der Inhalt "ignore" steht.

'''mögliche Ursache(n):'''

* in den OmniSeller-Zuordnungen wurde ein Channel auf "ignore" gemappt.
</div>

==== Code #55 ====
'''Meldung: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden."'''

'''Auslöser''': wird ausgegeben, wenn bei einem Belegupdate der Beleg bereits den Status gespeichert hat, aber das Update lediglich den Status "parken" setzen würde.

OmniBelegService:Releases Rev 16

2026-05-22T12:08:12Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

***

==== Konfiguration ====

***

==== Dienst ====

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.
* Einführung FehlerCode 55: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden." Dieser Fall tritt ein, wenn auf einem bereits gespeicherten Beleg ein BelegUpdate eingespielt werden soll, was aber lediglich den Speicherstatus parken hat.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

***

==== weiteres: ====

OmniBelegService:Releases Rev 16

2026-05-22T12:07:20Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

**

==== Konfiguration ====

**

==== Dienst ====

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.
* Einführung FehlerCode 54: "Beleg wurde ignoriert. Der Beleg ist bereits gespeichert und kann nicht mehr mit geparkt Status aktualisiert werden." Dieser Fall tritt ein, wenn auf einem bereits gespeicherten Beleg ein BelegUpdate eingespielt werden soll, was aber lediglich den Speicherstatus parken hat.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

**

==== weiteres: ====

OmniBelegService:CSV2XMLConverterRelease2 1 1

2026-05-14T18:04:54Z

MH:

Changelogs:

* interne Bibliotheken (z.B. MailClient, NewtonSoftJson, SQLite Bibliothek) wurden auf den aktuellsten Stand aktualisiert
* die verwendete DevExpress Version wurde von 23.1.5 auf Version 25.1.5 erhöht
* Es wurde ein Absturz abgefangen, wenn in einem Feld ein falsches Format stand (z.B.  Text in dem Betrags- oder Mengenfeld).
* Die Felder sind nun Quote-Sicher, d.h. es wird nicht mehr fälschlicherweise alles verschoben, sollte ein Textfeld den enthaltenen Delimiter beinhalten.
* Die Property TrimHochkomma funktioniert nun auch für das XMLOrder Format.
* Das Produkt wird nun standardmäßig in C:\OmniVersum\Apps installiert statt dem alten C:\ProgramFiles (x86) Pfad.
* Das Produkt wird nun in x64 Architektur ausgeliefert.

OmniBelegService:CSV2XMLConverterRelease2 1 1

2026-05-14T17:51:48Z

MH:

OmniBelegService:CSV2XMLConverterRelease2 1 1

2026-05-14T17:50:45Z

MH:

Changelogs:

* interne Bibliotheken (z.B. MailClient, NewtonSoftJson, SQLite Bibliothek) wurden auf den aktuellsten Stand aktualisiert
* die verwendete DevExpress Version wurde von 23.1.5 auf Version 25.1.5 erhöht
* Es wurde ein Absturz abgefangen, dass wenn in einem Feld ein falsches Format stand (z.B. Betragsfeld oder Mengenfeld).
* Die Felder sind nun Quote-Sicher sind, d.h. es wird nicht mehr fälschlicherweise alles verschoben, sollte ein Textfeld den enthaltenen Delimiter beinhalten.
* Die Property TrimHochkomma funktioniert nun auch für das XMLOrder Format.

OmniBelegService:CSV2XMLConverterReleases

2026-05-14T17:44:26Z

MH:

{{DISPLAYTITLE:CSV2XMLConverter - Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive eines kleinen Changelogs.

Da der Dienst ohne Datenbank- oder Sage-Abhängigkeiten arbeitet gibt es hier nicht allzu viel anzumerken, außer dass eine höhere Version einen neueren Software Stand bedeutet.

Im Changelog werden lediglich die Veränderungen zur Vorgänger-Version aufgelistet.
{| class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
! Changelog
! Downloadlink
|-
| 2.1.1
| 14.05.2026
| beta
|
 
| [[OmniBelegService:CSV2XMLConverterRelease2 1 1|changelog]]
| [https://www.omniseller.de/downloads/OmniBelegService/HTK-CSV2XMLConverter-2.1.1-Setup.exe download]
|-
| 2.0.0
| -
| instabile Alpha
|
 
| [[OmniBelegService:CSV2XMLConverterRelease2 0 0|changelog]]
|
 
|-
| 1.0.2
| -
| kein off. Release
|
 
| [[OmniBelegService:CSV2XMLConverterRelease1 0 2|changelog]]
|
 
|-
| 1.0.1
| 20.10.2022
| stable
|
 
| -
| [https://www.omniseller.de/downloads/OmniBelegService/HTK-CSV2XMLConverter-1.0.1-Setup.exe download]
|}

OmniBelegService:CSV2XMLConverterReleases

2026-05-14T17:43:38Z

MH:

{{DISPLAYTITLE:CSV2XMLConverter - Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive eines kleinen Changelogs.

Da der Dienst ohne Datenbank- oder Sage-Abhängigkeiten arbeitet gibt es hier nicht allzu viel anzumerken, außer dass eine höhere Version einen neueren Software Stand bedeutet.

Im Changelog werden lediglich die Veränderungen zur Vorgänger-Version aufgelistet.
{| class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
! Changelog
! Downloadlink
|-
| 2.1.1
| 14.05.2026
| beta
|
 
| [[OmniBelegService:CSV2XMLConverterRelease2 1 1|changelog]]
| [https://www.omniseller.de/downloads/OmniBelegService/HTK-CSV2XMLConverter-2.1.1-Setup.exe download]
|-
| 2.0.0
| -
| instabil
|
 
| [[OmniBelegService:CSV2XMLConverterRelease2 0 0|changelog]]
|
 
|-
| 1.0.2
| -
| kein off. Release
|
 
| [[OmniBelegService:CSV2XMLConverterRelease1 0 2|changelog]]
|
 
|-
| 1.0.1
| 20.10.2022
| stable
|
 
| -
| [https://www.omniseller.de/downloads/OmniBelegService/HTK-CSV2XMLConverter-1.0.1-Setup.exe download]
|}

OmniBelegService:CSV2XMLConverterReleases

2026-05-14T17:42:08Z

MH:

{{DISPLAYTITLE:CSV2XMLConverter - Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive eines kleinen Changelogs.

Da der Dienst ohne Datenbank- oder Sage-Abhängigkeiten arbeitet gibt es hier nicht allzu viel anzumerken, außer dass eine höhere Version einen neueren Software Stand bedeutet.

Im Changelog werden lediglich die Veränderungen zur Vorgänger-Version aufgelistet.
{| class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
! Changelog
! Downloadlink
|-
| 2.1.1
| 14.05.2026
| beta
|
 
| changelog
| [https://www.omniseller.de/downloads/OmniBelegService/HTK-CSV2XMLConverter-2.1.1-Setup.exe download]
|-
| 2.0.0
| -
| instabil
|
 
| [[OmniBelegService:CSV2XMLConverterRelease2 0 0|changelog]]
|
 
|-
| 1.0.2
| -
| ausstehend
|
 
| [[OmniBelegService:CSV2XMLConverterRelease1 0 2|changelog]]
|
 
|-
| 1.0.1
| 20.10.2022
| stable
|
 
| -
| [https://www.omniseller.de/downloads/OmniBelegService/HTK-CSV2XMLConverter-1.0.1-Setup.exe download]
|}

OmniBelegService:CSV2XMLConverterReleases

2026-05-14T16:59:41Z

MH:

{{DISPLAYTITLE:CSV2XMLConverter - Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive eines kleinen Changelogs.

Da der Dienst ohne Datenbank- oder Sage-Abhängigkeiten arbeitet gibt es hier nicht allzu viel anzumerken, außer dass eine höhere Version einen neueren Software Stand bedeutet.

Im Changelog werden lediglich die Veränderungen zur Vorgänger-Version aufgelistet.
{| class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
! Changelog
! Downloadlink
|-
| 2.1.1
| 14.05.2026
| beta
|
 
| changelog
| download
|-
| 2.0.0
| -
| instabil
|
 
| [[OmniBelegService:CSV2XMLConverterRelease2 0 0|changelog]]
|
 
|-
| 1.0.2
| -
| ausstehend
|
 
| [[OmniBelegService:CSV2XMLConverterRelease1 0 2|changelog]]
|
 
|-
| 1.0.1
| 20.10.2022
| stable
|
 
| -
| [https://www.omniseller-ftp.de/OmniBelegService/Releases/HTK-CSV2XMLConverter-1.0.1-Setup.exe download]
|}

OmniBelegService:CSV2XMLConverterRelease2 1 1

2026-05-14T16:59:00Z

MH: Die Seite wurde neu angelegt: „Changelogs“

Changelogs

OmniBelegService:CSV2XMLConverterReleases

2026-05-14T16:57:44Z

MH:

{{DISPLAYTITLE:CSV2XMLConverter - Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive eines kleinen Changelogs.

Da der Dienst ohne Datenbank- oder Sage-Abhängigkeiten arbeitet gibt es hier nicht allzu viel anzumerken, außer dass eine höhere Version einen neueren Software Stand bedeutet.

Im Changelog werden lediglich die Veränderungen zur Vorgänger-Version aufgelistet.
{| class="wikitable"
!Version
!Erscheinungsdatum
!Status
!Entwicklungs-Hinweis
!Changelog
!Downloadlink
|-
|2.1.1
|14.05.2026
|beta
|
|changelog
|download
|-
|2.0.0
| -
|instabil
|
|[[OmniBelegService:CSV2XMLConverterRelease2 0 0|changelog]]
|
|-
|1.0.2
| -
|ausstehend
|
|[[OmniBelegService:CSV2XMLConverterRelease1 0 2|changelog]]
|
|-
|1.0.1
|20.10.2022
|stable
|
| -
|[https://www.omniseller-ftp.de/OmniBelegService/Releases/HTK-CSV2XMLConverter-1.0.1-Setup.exe download]
|}

OmniBelegService:Releases Rev 16

2026-05-12T11:39:58Z

MH: Die Seite wurde neu angelegt: „=== Neuerungen, Fehlerbehebungen & Verbesserungen === ==== Setup ==== ===== Installationsskripte ===== * ==== Konfiguration ==== * ==== Dienst ==== ===== Auftragsimport ===== * Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war. ===== Auto-Lieferscheine: ===== * Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, w…“

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====

*

==== Konfiguration ====

*

==== Dienst ====

===== Auftragsimport =====

* Es wurde ein Fehler abgefangen, dass der Dienst in einen technischen Fehler gelaufen ist, wenn in der bereitgestellten XML-Datei kein Telefonnummer Feld vorhanden war.

===== Auto-Lieferscheine: =====

* Es wurde ein Timing Fehler abgefangen, welches dann aufgetreten ist, wenn ein ganz neu geschriebener Auftrag unmittelbar zu einem Lieferscheine umgewandelt wurde aber der Auftrag zu dem Zeitpunkt noch nicht vollständig fertig geschrieben bzw. gespeichert war. Resultat des Fehlverhaltens war eine doppelte Lieferscheinerstellung.

==== sonstiges: ====

*

==== weiteres: ====

OmniBelegService:XMLFormatbeschreibung

2026-04-24T14:10:03Z

MH: /* XML-Beispiele */

{{DISPLAYTITLE:XML-Format-Beschreibung}}

== Vorwort ==
Hier auf dieser Seite wird das zu importierende XML-Format beschrieben. Es kann durchaus sein dass das ein oder andere Feld nicht in der XML vorhanden ist, da manche davon erst beim Übersetzen des BelegMappers eingefügt werden oder optionale Felder sind.

== ORDER_HEADER ==

=== CONTROL_INFO ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|GENERATION_INFO
| -
|lediglich ein Hinweis über den Ersteller der XML, kein Einfluss auf den Import
|-
|GENERATION_DATE
| -
|lediglich ein Hinweis über das Erstell-Datum der XML, fließt allerdings in die globale Einstellung "DocumentOlderThanXValue" ein und dadurch können zu alte XML-Dateien blockiert werden.
|}

=== ORDER_INFO ===
In dem ORDER_INFO Bereich werden grundlegende Informationen zur Bestellung angegeben.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ORDER_PARTIES
| -
|siehe Detailbereich ORDER_PARTIES
|-
|PAYMENTS
| -
|siehe Detailbereich PAYMENTS
|-
|PRICE_CURRENCY
|setzt Währungskennzeichen
|wenn leer, dann wird standardmäßig "EUR" für Euro gesetzt
|-
|BRUTTO_KZ
|steuert ob Brutto- oder Nettobeleg
|0 = netto; -1 = brutto. Je nach Kennzeichen werden auch die Positionspreise als Netto bzw. Brutto Preis verarbeitet
|-
|DELIVERY_CONDITION
|Lieferbedingung
|setzt die Lieferbedingung anhand Schlüssel oder Bezeichnung (Konfiguration),
|-
|ORDER_IDENTIFICATION
|USER_OrderIdentification
|füllt Userfeld, anhand dessen Inhalt wird ermittelt, ob es bereits ein Beleg zu der zu importierenden Bestellung gibt und ggf. dann ein BelegUpdate auf einen bestehenden Beleg ausgeführt
|-
|VDL
|Versandart
|setzt die Versandart anhand Schlüssel oder Bezeichnung (Konfiguration)
|-
|ORDER_ID
|USER_OrderId
|füllt Userfeld, dient lediglich für den Benutzer zum Suchen einer Bestellung
|-
|ORDER_PAYMENT_STATUS
|USER_OrderPaymentStatus
|füllt Userfeld, beinhaltet den Bezahl-Status aus dem Shop
|-
|ORDER_DATE
|USER_OrderDate bzw. BelegDatum
|füllt Userfeld. Sollte in der Konfiguration bei Belegdatum der wert "XML-Datum" hinterlegt sein wird das Belegdatum im Beleg gesetzt.
|-
|ORDER_CHANNEL
|USER_OrderChannel
|füllt Userfeld, notwendig für den OmniSeller Statusupload. Kann auch für kundenindividuelle Auswertungen und Analysen verwendet werden
|-
|ORDER_ACCOUNT
| USER_OrderAccount
|füllt Userfeld
|-
|ORDER_CUSTOMER_ACCOUNT
| -
|aktuell keine Verwendung
|-
|ORDER_DELIVERYDATE
|Liefertermin Beleg
|setzt Liefertermin im Beleg (falls in Konfiguration bei Liefertermin Beleg "XML Daten" ausgewählt ist. Schreibt standardmäßig tagesaktuelles Datum falls Property ausgewählt und trotzdem ein leeres Datum in der XML.
|-
|ORDER_PAYMENT_ID
|Bezahlart, USER_PaymentID
|steuert die Bezahlart anhand Schlüssel oder Bezeichnung (Konfiguration), setzt außerdem das UserFeld USER_PaymentID
|-
|ORDER_STATUS_ID
|USER_OrderStatusID
|füllt Userfeld, Shop Status der Bestellung
|-
|ORDER_NOTE
|USER_OrderNote, BelegMemo
|Je nach Konfiguration wird das Bestellkommentar in das UserFeld oder auch in das Memo Feld des Belegs geschrieben
|-
|ORDER_TAX_AREA
|Besteuerung
|steuert u.A. die Besteuerung in der Sage. Auswahl "MERCHANT" (Inland), "EU" und "NONEU". Bei abweichendem Inhalt wird die Besteuerung aus dem Kunden übernommen.
|-
|ORDER_COUPON
|USER_OrderCoupon
|füllt Userfeld des angewendeten Gutschein-Codes
|-
|ORDER_COUPON_AMOUNT
|USER_OrderCouponAmount
|füllt Userfeld des angewendeten Gutschein-Betrags
|-
|ORDER_USER
|Beleg Bearbeiter
|setzt den Belegbearbeiter, übersteuert den in der Konfiguration hinterlegten Bearbeiter falls gefüllt.
|-
|ORDER_HEADER_TEXT
|Kopftext
|Setzt den Kopftext des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_HTML
|KopftextHTML
|Setzt den KopftextHtml des Belegs falls gefüllt
|-
|ORDER_HEADER_TEXT_RTF
|KopfTextRTF
|Setzt den KopftextRtf des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT
|Fußtext
|Setzt den Fußtext des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_HTML
|FußtextHTML
|Setzt den FußtextHtml des Belegs falls gefüllt
|-
|ORDER_FOOTER_TEXT_RTF
|FußtextRTF
|Setzt den FußtextRtf des Belegs falls gefüllt
|-
|ORDER_TAX_CODE
| -
|aktuell keine Verwendung
|-
|ORDER_LANGUAGE
|Belegsprache
|Setzt die Sprache des Belegs falls gefüllt, ansonsten wird die Sprache der ermittelten/angelegten Adresse gesetzt.
Setzt bei Adress-Anlage die Sprache aus dem Feld.
|-
|ORDER_TAXEU_COUNTRY
|EULand
|setzt das EU Land auf Belegebene, falls gefüllt. Wenn das EU Land nicht vom Kunden übernommen sondern leer gelassen werden soll kann man dies mit dem Feldinhalt "-" (minus) ansteuern.
|-
|ORDER_TAXATIONTYPE
|Besteuerung
|übersteuert die durch ORDER_TAX_AREA ermittelte Besteuerung durch den hier eingetragenen Wert und setzt die Besteuerung auf Belegebene.
"steuerfrei", "inland", "EU mit UStID", "EU ohne UstID", "Verbundene Unternehmen", "Export/Import" als mögliche Werte. Ebenfalls findet auch eine Auswertung mit dem Input MERCHANT; EU und NON_EU statt. (wie bei ORDER_TAX_AREA)

Sollte das Feld gefüllt sein aber von der Schreibweise auf keinen der Fälle passen wird in den Sage Besteuerungsarten geprüft, ob eine individuelle Besteuerungsart anhand der angegebenen Bezeichnung vorliegt und diese dann auf Belegebene gesetzt.
|-
|ORDER_DOCUMENTTYPE
|Belegart
|übersteuert die in der Konfiguration hinterlegte Belegart, mit der der Beleg angelegt wird. Der Wert muss mit dem entsprechenden Kennzeichen gefüllt sein. (z.B. "VVA" für Auftragsbestätigungen)
|-
|ORDER_SAVE_STATUS
|Beleg speichern/parken
|Übersteuert die Konfiguration, ob ein Beleg gespeichert oder geparkt werden soll.
Wert "1" = speichern, "2" = parken.

Hinweis: Die globale Einstellung "Parken bei abweichendem Lieferland" kann den Wert dann noch übersteuern.
|-
|ORDER_IGNORE
| -
|sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als ignoriert markiert wird und das File in den Save-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ORDER_ERROR
| -
|(Ab Rev.11) sorgt dafür, dass ein Beleg nicht importiert wird, sondern mit einer Meldung mit dem Inhalt dieses Textfeldes als Fehler markiert wird und das File in den Fehler-Ordner verschoben wird. (greift, sobald der Feldinhalt nicht leer ist.)
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|}

==== ORDER_PARTIES ====
In dem Bereich der ORDER_PARTIES existieren zwei Knoten namens "BUYER_PARTY" und "SHIPMENT_PARTIES". Dort sind dann ebenfalls weitere Unterknoten definiert welche die Daten nochmal ins Detail auflösen können.

Am Ende gibt es einen größeren ADDRESS-Knoten in der BUYER_PARTY, welcher der Auftraggeber ist. Die angegebenen Daten in diesem ADDRESS-Knoten bilden dann die Grundlage für das in der Sage100 erzeugte Kundenkonto.

Die Daten der DELIVERY_PARTY werden lediglich als Lieferadresse im Sage Beleg hinterlegt.

===== ADDRESS =====
in BUYER_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|Name1 (Adresse),
A0Name1,

A2Name1
|Setzt Name1 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen1 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.

Generiert teilweise den Beleg Matchcode mit (Format NAME, CITY)
|-
|NAME2
|Name2 (Adresse),
A0Name2,

A2Name2
|Setzt Name2 in einer neuen Adresse, die angelegt wird.
Setzt auf Belegebene den Namen2 in der Auftraggeber- und Rechnungsadresse, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|MATCHCODE
|Matchcode
|Setzt Matchcode in einer neuen Adresse (und Kunde), die angelegt wird, falls gefüllt
Setzt auf BelegEbene ebenfalls den A0Matchcode falls gefüllt.

Sollte der Matchcode leer sein, wird das Standard Sage Pattern mit "Name, Ort" gesetzt.
|-
|STREET
|Lieferstraße (Adresse),
A0Straße,

A2Straße
|Setzt die Lieferstraße bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungsstraße, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|Lieferzusatz (Adresse),
A0Zusatz,
A2Zusatz
|Setzt den Lieferzusatz bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Lieferzusatzinformationen, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|LieferPLZ (Adresse),
A0Postleitzahl,
A2Postleitzahl
|Setzt die Postleitzahl bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Postleitzahl, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|LieferOrt (Adresse),
Matchcode (Adresse),
Matchcode (Kto)
A0Ort,
A2Ort
|Setzt den Ort/Stadt bei einer neuen Adresse die angelegt wird.
Bildet in Kombination mit Name ein Teil des Adress- sowie Kto-Matchcodes. (Format NAME, CITY)
Setzt auf Belegebene den Auftraggeber- und Rechnungsort, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|Lieferland (Adresse),
A0Land,
A2Land
|Setzt das Lieferland bei einer neuen Adresse die angelegt wird.
Setzt auf BelegEbene das Auftraggeber- und Rechnungs-Land, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|USTID
| -
|setzt Umsatzsteuer ID, wird allerdings durch das Feld CUSTOMER_USTID in den CUSTOMER_MASTER_DATA übersteuert. Weitere Informationen dazu sind unter CUSTOMER_USTID zu finden.
|-
|SALUTATION
|Anrede (Adresse)
Anrede (Ansprechpartner)
A0Anrede,
A2Anrede
|Setzt Anrede bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Anrede bei einem neuen Ansprechpartner der angelegt wird
Setzt auf BelegEbene die Auftraggeber- und Rechnungs-Anrede, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|SALUTATION_LETTER
|Ansprache (Adresse)
Briefanrede (Ansprechpartner)
|Setzt Ansprache bei einer neuen Adresse die angelegt wird (falls gefüllt)
Setzt Briefanrede bei einem neuen Ansprechpartner
|-
|HOMEPAGE
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_MASTER_DATA
| -
|siehe Detailbereich CUSTOMER_MASTER_DATA
|-
|CONTACT
| -
|siehe Detailbereich CONTACT
|-
|<USER_XXXXX>
|UserFelder für KHKAdressen
|Hier können diverse UserFelder für den Adressstamm mit gesetzt werden.
|}
In DELIVERY_PARTY:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|NAME
|A1Name1
|Setzt auf Belegebene den Namen1 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|NAME2
|A1Name2
|Setzt auf Belegebene den Namen2 in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|STREET
|A1Straße
|Setzt auf Belegebene die Straße in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZUSATZ
|A1Zusatz
|Setzt auf Belegebene das Zusatzfeld in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|ZIP
|A1Postleitzahl
|Setzt auf Belegebene die Postleitzahl in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|CITY
|A1Ort
|Setzt auf Belegebene den Ortsnamen in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|-
|COUNTRY
|A1Land
EULand
|Setzt auf Belegebene das Land in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
Setzt ebenfalls das EULand, wenn es sich um eine EU-Bestellung (TAX_AREA = EU) handeln und nicht durch ORDER_TAXEU_COUNTRY übersteuert ist.
|-
|SALUTATION
|A1Anrede
|Setzt auf Belegebene die Anrede in der Lieferanschrift, solange nicht durch die Konfiguration mit "Daten aus Stamm" übersteuert wird.
|}

====== CUSTOMER_MASTER_DATA ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CUSTOMER_USTID
|EUUstID (Kto),
EUUmsatzsteuerID
|Setzt bei einem neuen Kunden die UmsatzsteuerID,
Setzt auf Belegebene die EU-UmsatzsteuerID, falls gefüllt.
|-
|CUSTOMER_GROUP
|Gruppe (Kto),
Kontogruppe
|Setzt bei einem neuen Kunden die Kundengruppe, falls gefüllt (andernfalls Wert aus Kunden-Vorlage)
Setzt auf Belegebene die Kundengruppe, falls gefüllt
|-
|CUSTOMER_PRICELIST_ID
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_PRICELIST_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|CUSTOMER_TYPE_OF_TRANSPORT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|ADDRESS_GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|EU_COUNTRY
|EULand(Kto)
|setzt bei einer Kunden-Neuanlage im Kunden das EU Land, falls gefüllt
|-
|TAX_AREA
| -
|übersteuert das XML-Feld ORDER_TAX_AREA und hilft dabei, den Vorlage-Kunden zu ermitteln. (MERCHANT; EU; NON_EU als mögliche Eingabe-Werte)
|-
|<USER_XXXXX>
|Userfelder Konto
|Hier können diverse UserFelder für den Kunden (KHKKontokorrent) gesetzt werden.
|}

====== CONTACT ======
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|CONTACT_NAME
|Ansprechpartner (ASP),
A0Ansprechpartner,

A2Ansprechpartner
|Setzt bei einer Ansprechpartner-Anlage den Matchcode.
Setzt auf Belegebene den Ansprechpartner des Auftraggebers
Setzt auf Belegebene den Ansprechpartner des Rechnungsempfängers
|-
|PHONE (type=private)
|Telefon (ASP)
TelefonPrivat (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Telefon & Telefon (privat)
|-
|PHONE (type=mobile)
|Mobilfunk (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Mobil"
|-
|FAX
|Telefax (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Fax"
|-
|EMAIL
|Email(Adresse)
Email (ASP)
|Setzt bei einer neuen Adresse die Email-Adresse (Ist auch relevantes Feld bei der Prüfung ob der Ansprechpartner bereits existiert)
Setzt bei einer Ansprechpartner-Anlage die Email-Adresse
|-
|DEPARTMENT
| -
|aktuell keine Verwendung in der Sage
|-
|GROUP
| -
|aktuell keine Verwendung in der Sage
|-
|POSITION
| -
|aktuell keine Verwendung in der Sage
|-
|SALUTATION
|Anrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Anrede"
|-
|SALUTATION_LETTER
|Briefanrede (ASP)
|Setzt bei einer Ansprechpartner-Anlage das Feld "Briefanrede"
|-
|<USER_XXXXX>
|UserFelder Ansprechpartner
|Hier können diverse UserFelder für den Ansprechpartner KHKAnsprechpartner gesetzt werden.
|}

==== PAYMENTS ====
der Knoten PAYMENTS beinhaltet einen Knoten PAYMENT, dieser ist wie folgt aufgebaut:
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|ACCOUNT
| -
|siehe Detailbereich ACCOUNT
|-
|TRANS_ID
|USER_TransID
|füllt Userfeld
|-
|PAYMENT_STATUS
|USER_Paymentstatus
|füllt Userfeld
|-
|PAYMENT_AMOUNT
|USER_PaymentAmount
|füllt Userfeld
|}

===== ACCOUNT =====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|HOLDER
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_NAME
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_COUNTRY
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_CODE
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_ACCOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_BIC
| -
|aktuell keine Verwendung in der Sage
|-
|BANK_IBAN
| -
|aktuell keine Verwendung in der Sage
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BUSINESS_TRANSACTION_ID
| -
|aktuell keine Verwendung in der Sage
|-
|ORDER_REFERENCE
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_ITEM_LIST ==

=== ORDER_ITEM ===
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|POSTYPE
|Positionstyp
|gibt an welche Art Position die aktuelle Position ist.
0 = Gruppenüberschrift (Text kann in DESCRIPTION_SHORT mit übergeben werden.
1 = Artikelposition,

2 = Zwischensumme (Text kann in DESCRIPTION_SHORT mit übergeben werden.

3 = Textposition (Text kann in DESCRIPTION_LONG mit übergeben werden.

7 = optionale Artikelposition
|-
|ORDER_POS_ID
|USER_OrderPosID
|füllt Userfeld
|-
|STORNIERT
|USER_Storniert
|füllt Userfeld
|-
|LINE_ITEM_ID
| -
|aktuell keine Verwendung in der Sage. Wird aber dennoch zur Reihenfolge der Positionen verwendet.
|-
|VARIANT_ID
|AuspraegungID
|setzt die AuspraegungID der Position
|-
|STORAGE_AREA_NAME
|Lagerplatz
|setzt den Lagerplatz an der Position. Es muss der Name der Kurzbezeichnung des Lagerplatzes in der XML hinterlegt werden.
|-
|ARTICLE_ID
| -
|siehe Detailbereich ARTICLE_ID
|-
|QUANTITY
|Menge
|setzt die Menge der Position
|-
|ORDER_UNIT
| -
|(ab Rev.4) Setzt die Mengeneinheit der Position. Hinweis: Es findet keine Prüfung statt, ob diese angegebene Mengeneinheit in der Sage auch existiert.
Es muss der entsprechende Sage Schlüssel angegeben werden (z.B. "Stk" für Stück oder "Pal" für Palette)
|-
|DELIVERYDATE
|Liefertermin
|setzt den Liefertermin der Position. XML-Datum wird übernommen, wenn in der Konfiguration bei "Liefertermin Belegeposition" der Wert XMLDatum eingestellt ist.
|-
|ARTICLE_PRICE
| -
|siehe Detailbereich ARTICLE_PRICE
|-
|ADDITIONAL_INFORMATION
| -
|siehe Detailbereich ADDITIONAL_INFORMATION
|-
|QUANTITY_UNIT
|Mengeneinheit
|Steuert die Mengeneinheit.
Zulässige Werte: BME = Basismengeneinheit; VPE = Verpackungseinheit; VME = Verkaufsmengeneinheit

Hinweis: Sollte das Feld in der XML gefüllt sein, übersteuert dies die globale Property "POS_VKMengeneinheit".

Die Menge der Position wird durch den XML-Wert übernommen. Es findet keine Umrechnung statt.

Dieses Feld übersteuert die ORDER_UNIT und die globale Einstellungen POS_VKMengeneinheit
|-
|USE_OL_PRICE
| -
|(ab Rev.11) übersteuert auf Positionsebene, ob der Preis aus der Sage100 bezogen werden soll.
0 = XML Preis; 1 = Preis aus Sage;
übersteuert die Einstellung "Preisermittlung der Artikel-Positionen aus Sage statt XML-Betrag"
|}

==== ARTICLE_ID ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SUPPLIER_AID
|Artikelnummer
|ermittelt anhand des Feldinhalt den Sage Artikel, beim Wert "0" wird anhand der DESCRIPTION_SHORT der Zuschlagsname ermittelt (PosType muss bei Zuschlägen ebenfalls 1 sein)
|-
|BUYER_AID
|USER_BuyerAID
|füllt Userfeld, meist Verwendet als Referenzfeld für z.B. Marktplatz-Artikelnummer etc.
|-
|DESCRIPTION_SHORT
|Bezeichnung1
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_SHORT2
|Bezeichnung2
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_LONG
|Langtext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|-
|DESCRIPTION_DIMENSION
|Dimensionstext
|
* "normaler Text" -> XML-Werte werden übernommen
* ""(leerer Text) -> Sage Texte werden bezogen
* "-"(minus) -> Texte werden explizit leer gelassen
|}

==== ARTICLE_PRICE ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|PRICE_AMOUNT
|Einzelpreis
|setzt den Einzelpreis der Position.
Setzt bei globaler Property "Gutschein als Belegrabatt" anhand des gesetzen Preises den Absolutwert des Belegrabattes.
|-
|PRICE_LINE_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|-
|TAX
| -
|aktuell keine Verwendung in der Sage
|-
|DISCOUNT_AMOUNT
| -
|aktuell keine Verwendung in der Sage
|}

==== ADDITIONAL_INFORMATION ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|BATCHES
| -
|aktuell keine Verwendung in der Sage
|-
|SERIAL_NUMBERS
| -
|aktuell keine Verwendung in der Sage
|}

== ORDER_DISCOUNTS ==
Da Sage bis zu drei Beleg-Rabatte unterstützt gibt es hier auch entsprechend drei Knoten. Jeder der drei Knoten hat drei weitere Felder unter sich die dann die die entsprechenden Werte verarbeiten.
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DISCOUNT1
|steuert ersten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT2
|steuert zweiten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|-
|DISCOUNT3
|steuert dritten Beleg-Rabatt
|siehe Detailbereich "Werte-Felder für Beleg-Rabatte"
|}

==== Werte-Felder für Beleg-Rabatte ====
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|DESCRIPTION
|Rabatttext
|setzt zu dem jeweiligen Rabatt den Rabatttext
|-
|DISCOUNTPERCENT
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt kein AbsolutRabatt ist.
Sollte in der XML sowohl DISCOUNTVALUE als auch DISCOUNTPERCENT gefüllt sein übersteuer das DISCOUNTVALUE Und der Rabatt wird als Absolutrabatt mit dem Festbetrag aus DISCOUNTVALUE angelegt
|-
|DISCOUNTVALUE
|Rabatt
HatAbsolutrabatt
|setzt den Rabatt und definiert, dass der Rabatt ein AbsolutRabatt ist.
|}

== ORDER_FIELDS ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|SALES_REPRESENTATIVE
| Vertreter
|(ab Rev10) Setzt die Vertreternummer im Belegfuß. Es findet keine Prüfung statt, ob dieser Vertreter auch existiert.
|-
|CUSTOMER_TEMPLATE
| -
|(ab Rev10) Übersteuert den Vorlagenkunden aus der Konfiguration. Kundenneuanlage muss trotzdem in der Konfiguration aktiviert sein.
|-
|CUSTOMER_OL_ID
|Adresse
|Setzt das Auftraggeber Konto des zu importierenden Belegs
|-
|YOUR_ORDER
|Referenznummer
|Setzt die Referenznummer/Ihre Belegnummer auf Belegebene (falls gefüllt)
|-
|YOUR_TOKEN
|Referenzzeichen
|Setzt das Referenzzeichen/Ihr Zeichen auf Belegebene (falls gefüllt)
|-
|ORDER_MATCHCODE
|Matchcode
|Setzt den Belegmatchcode (falls gefüllt)
|-
|BUSINESS_TRANSACTION_MATCHCODE
|Hauptvorgangsmatchcode
|Setzt den Hauptvorgangsmatchcode (falls gefüllt)
|-
|OL_PROJECT_ID
| -
|keine Verwendung in der Sage
|-
|<USER_XXXXX>
|
|
|}

== ORDER_SUMMARY ==
{| class="wikitable"
!XML-Feldname
!Wert in Sage
!Hinweise über mögliche Werte-Konfigurationen
|-
|TOTAL_ITEM_NUM
| -
|keine Verwendung in der Sage
|-
|TOTAL_AMOUNT
| -
|keine Verwendung in der Sage
|}

== XML-Beispiele ==
[[OmniBelegService:XMLExample 1|Beispiel1: Oxid eSales Bestell-XML]]

[[OmniBelegService:XMLExample 2|Beispiel2: komplexere XML Struktur mit unterschiedlichen Belege-Positionstypen nach einer XSL-Transformation]]

[[OmniBelegService:XSD|XML Schema Definition (XSD)]]

[[OmniBelegService:XMLExample TESTSchema|Beispiel3: TESTSCHEMA inkl. Kommentaren welcher Knoten auf welchem Sage Feld landet.]]

OmniBelegService:XMLExample TESTSchema

2026-04-24T14:09:38Z

MH: Die Seite wurde neu angelegt: „<?xml version="1.0" encoding="utf-8"?> <ORDER>   <ORDER_HEADER>     <CONTROL_INFO>       <GENERATOR_INFO>TEST_GENERATOR_INFO</GENERATOR_INFO>       <GENERATION_DATE>24.04.2026 10:00:00</GENERATION_DATE>     </CONTROL_INFO>     <ORDER_INFO…“

<?xml version="1.0" encoding="utf-8"?> <ORDER>   <ORDER_HEADER>     <CONTROL_INFO>       <GENERATOR_INFO>TEST_GENERATOR_INFO</GENERATOR_INFO>       <GENERATION_DATE>24.04.2026 10:00:00</GENERATION_DATE>     </CONTROL_INFO>     <ORDER_INFO>       <ORDER_PARTIES>         <BUYER_PARTY>           <PARTY>             <ADDRESS>               <NAME>BP_NAME</NAME>               <NAME2>BP_NAME2</NAME2>               <MATCHCODE>BP_MATCHCODE</MATCHCODE>               <STREET>BP_STREET</STREET>               <ZUSATZ>BP_ZUSATZ</ZUSATZ>               <ZIP>12345</ZIP>               <CITY>BP_CITY</CITY>               <COUNTRY>DE</COUNTRY>               <USTID>BP_USTID</USTID>               <SALUTATION>BP_SALUTATION</SALUTATION>               <SALUTATION_LETTER>BP_SALUTATION_LETTER</SALUTATION_LETTER>               <HOMEPAGE>bp.example.invalid</HOMEPAGE>               <CUSTOMER_MASTER_DATA>                 <CUSTOMER_USTID>BP_USTID2</CUSTOMER_USTID>                 <CUSTOMER_GROUP>BP_GROUP</CUSTOMER_GROUP>                 <CUSTOMER_PRICELIST_ID>0</CUSTOMER_PRICELIST_ID>                 <CUSTOMER_PRICELIST_NAME>BP_PLIST</CUSTOMER_PRICELIST_NAME>                 <CUSTOMER_TYPE_OF_TRANSPORT>BP_TRN</CUSTOMER_TYPE_OF_TRANSPORT>                 <TAX_CODE>0</TAX_CODE>                 <ADDRESS_GROUP>BP_AGRP</ADDRESS_GROUP>               </CUSTOMER_MASTER_DATA>               <CONTACT>                 <CONTACT_NAME>BP_CONTACT_NAME</CONTACT_NAME>                 <PHONE type="private">BP_PHONE_PRIVATE</PHONE>                 <PHONE type="mobile">BP_PHONE_MOBILE</PHONE>                 <FAX>BP_FAX</FAX>                 <EMAIL>bp_email@example.invalid</EMAIL>               </CONTACT>               <FIRSTNAME>BP_FIRSTNAME</FIRSTNAME>               <LASTNAME>BP_LASTNAME</LASTNAME>               <KUNDENNUMMER>BP_CUSTOMER_NO</KUNDENNUMMER>               <S4T_KUNDEN_ID>BP_S4T_CUSTOMER_ID</S4T_KUNDEN_ID>               <COMPANY_NAME>BP_COMPANY_NAME</COMPANY_NAME>             </ADDRESS>           </PARTY>         </BUYER_PARTY>         <SHIPMENT_PARTIES>           <DELIVERY_PARTY>             <PARTY>               <ADDRESS>                 <NAME>DP_NAME</NAME>                 <NAME2>DP_NAME2</NAME2>                 <STREET>DP_STREET</STREET>                 <ZUSATZ>DP_ZUSATZ</ZUSATZ>                 <ZIP>54321</ZIP>                 <CITY>DP_CITY</CITY>                 <COUNTRY>DE</COUNTRY>                 <SALUTATION>DP_SALUTATION</SALUTATION>               </ADDRESS>             </PARTY>           </DELIVERY_PARTY>         </SHIPMENT_PARTIES>       </ORDER_PARTIES>       <PAYMENTS>         <PAYMENT>           <ACCOUNT>             <HOLDER>PAYMENT_HOLDER</HOLDER>             <BANK_NAME>PAYMENT_BANK</BANK_NAME>             <BANK_COUNTRY>DE</BANK_COUNTRY>             <BANK_CODE>12345678</BANK_CODE>             <BANK_ACCOUNT>PAYMENT_BANK_ACCOUNT</BANK_ACCOUNT>             <BANK_BIC>BYLADEM1001</BANK_BIC>             <BANK_IBAN>DE02120300000000202051</BANK_IBAN>           </ACCOUNT>           <TRANS_ID>PAYMENT_TRANS_ID</TRANS_ID>           <PAYMENT_STATUS>PAYMENT_STATUS</PAYMENT_STATUS>           <PAYMENT_AMOUNT>123.45</PAYMENT_AMOUNT>         </PAYMENT>       </PAYMENTS>       <PRICE_CURRENCY>EUR</PRICE_CURRENCY>       <BRUTTO_KZ>-1</BRUTTO_KZ>       <DELIVERY_CONDITION>DELIVERY_CONDITION</DELIVERY_CONDITION>       <ORDER_IDENTIFICATION>TESTSCHEMA_ORDER_IDENTIFICATION</ORDER_IDENTIFICATION>       <VDL>STANDARD_VDL</VDL>       <ORDER_ID>TESTSCHEMA_ORDER_ID</ORDER_ID>       <ORDER_PAYMENT_STATUS>ORDER_PAYMENT_STATUS</ORDER_PAYMENT_STATUS>       <ORDER_DATE>24.04.2026 10:15:00</ORDER_DATE>       <ORDER_CHANNEL>TEST_CHANNEL</ORDER_CHANNEL>       <ORDER_ACCOUNT>ORDER_ACCOUNT</ORDER_ACCOUNT>       <ORDER_CUSTOMER_ACCOUNT>ORDER_CUSTOMER_ACCOUNT</ORDER_CUSTOMER_ACCOUNT>       <ORDER_DELIVERYDATE>25.04.2026</ORDER_DELIVERYDATE>       <ORDER_PAYMENT_ID>ORDER_PAYMENT_ID</ORDER_PAYMENT_ID>       <ORDER_STATUS_ID>ORDER_STATUS_ID</ORDER_STATUS_ID>       <ORDER_NOTE>ORDER_NOTE</ORDER_NOTE>       <ORDER_TAX_AREA>MERCHANT</ORDER_TAX_AREA>       <ORDER_COUPON>ORDER_COUPON</ORDER_COUPON>       <ORDER_COUPON_AMOUNT>ORDER_COUPON_AMOUNT</ORDER_COUPON_AMOUNT>       <ORDER_USER>ORDER_USER</ORDER_USER>       <ORDER_HEADER_TEXT>ORDER_HEADER_TEXT</ORDER_HEADER_TEXT>       <ORDER_HEADER_TEXT_HTML>ORDER_HEADER_TEXT_HTML</ORDER_HEADER_TEXT_HTML>       <ORDER_HEADER_TEXT_RTF>ORDER_HEADER_TEXT_RTF</ORDER_HEADER_TEXT_RTF>       <ORDER_FOOTER_TEXT>ORDER_FOOTER_TEXT</ORDER_FOOTER_TEXT>       <ORDER_FOOTER_TEXT_HTML>ORDER_FOOTER_TEXT_HTML</ORDER_FOOTER_TEXT_HTML>       <ORDER_FOOTER_TEXT_RTF>ORDER_FOOTER_TEXT_RTF</ORDER_FOOTER_TEXT_RTF>       <ORDER_TAX_CODE>0</ORDER_TAX_CODE>       <ORDER_LANGUAGE>D</ORDER_LANGUAGE>       <ORDER_TAXEU_COUNTRY>DE</ORDER_TAXEU_COUNTRY>       <ORDER_TAXATIONTYPE>MERCHANT</ORDER_TAXATIONTYPE>       <ORDER_DOCUMENTTYPE>VVA</ORDER_DOCUMENTTYPE>       <ORDER_SAVE_STATUS>2</ORDER_SAVE_STATUS>       <ADDITIONAL_INFORMATION>         <BUSINESS_TRANSACTION_ID>0</BUSINESS_TRANSACTION_ID>         <ORDER_REFERENCE>ORDER_REFERENCE</ORDER_REFERENCE>       </ADDITIONAL_INFORMATION>     </ORDER_INFO>   </ORDER_HEADER>   <ORDER_ITEM_LIST>     <ORDER_ITEM>       <POSTYPE>1</POSTYPE>       <ORDER_POS_ID>ITEM1_ORDER_POS_ID</ORDER_POS_ID>       <STORNIERT>0</STORNIERT>       <LINE_ITEM_ID>1</LINE_ITEM_ID>       <VARIANT_ID>0</VARIANT_ID>       <STORAGE_AREA_NAME>ITEM1_STORAGE_AREA</STORAGE_AREA_NAME>       <ARTICLE_ID>         <SUPPLIER_AID>ITEM1_SUPPLIER_AID</SUPPLIER_AID>         <BUYER_AID>ITEM1_BUYER_AID</BUYER_AID>         <DESCRIPTION_SHORT>ITEM1_DESCRIPTION_SHORT</DESCRIPTION_SHORT>         <DESCRIPTION_SHORT2>ITEM1_DESCRIPTION_SHORT2</DESCRIPTION_SHORT2>         <DESCRIPTION_LONG>ITEM1_DESCRIPTION_LONG</DESCRIPTION_LONG>         <DESCRIPTION_DIMENSION>ITEM1_DESCRIPTION_DIMENSION</DESCRIPTION_DIMENSION>       </ARTICLE_ID>       <QUANTITY>1</QUANTITY>       <ORDER_UNIT>STK</ORDER_UNIT>       <DELIVERYDATE>25.04.2026</DELIVERYDATE>       <ARTICLE_PRICE type="gross_list">         <PRICE_AMOUNT>123.45</PRICE_AMOUNT>         <PRICE_LINE_AMOUNT>123.45</PRICE_LINE_AMOUNT>         <TAX>19</TAX>         <DISCOUNT_AMOUNT>0</DISCOUNT_AMOUNT>       </ARTICLE_PRICE>       <USERFELD1>ITEM1_USERFELD1</USERFELD1>       <ORDER_EXTRA_FIELDS>ITEM1_ORDER_EXTRA_FIELDS</ORDER_EXTRA_FIELDS>     </ORDER_ITEM>   </ORDER_ITEM_LIST>   <ORDER_DISCOUNTS>     <DISCOUNT1>       <DESCRIPTION>DISCOUNT1_DESCRIPTION</DESCRIPTION>       <DISCOUNTPERCENT>0</DISCOUNTPERCENT>       <DISCOUNTVALUE>0</DISCOUNTVALUE>     </DISCOUNT1>     <DISCOUNT2>       <DESCRIPTION>DISCOUNT2_DESCRIPTION</DESCRIPTION>       <DISCOUNTPERCENT>0</DISCOUNTPERCENT>       <DISCOUNTVALUE>0</DISCOUNTVALUE>     </DISCOUNT2>     <DISCOUNT3>       <DESCRIPTION>DISCOUNT3_DESCRIPTION</DESCRIPTION>       <DISCOUNTPERCENT>0</DISCOUNTPERCENT>       <DISCOUNTVALUE>0</DISCOUNTVALUE>     </DISCOUNT3>   </ORDER_DISCOUNTS>   <ORDER_FIELDS>     <SALES_REPRESENTATIVE>SALES_REPRESENTATIVE</SALES_REPRESENTATIVE>     <CUSTOMER_TEMPLATE>CUSTOMER_TEMPLATE</CUSTOMER_TEMPLATE>     <CUSTOMER_OL_ID>D12345</CUSTOMER_OL_ID>     <YOUR_ORDER>TESTSCHEMA_YOUR_ORDER</YOUR_ORDER>     <YOUR_TOKEN>TESTSCHEMA_YOUR_TOKEN</YOUR_TOKEN>     <ORDER_MATCHCODE>TESTSCHEMA_ORDER_MATCHCODE</ORDER_MATCHCODE>     <BUSINESS_TRANSACTION_MATCHCODE>BUSINESS_TRANSACTION_MATCHCODE</BUSINESS_TRANSACTION_MATCHCODE>     <OL_PROJECT_ID>0</OL_PROJECT_ID>     <USER_WEBPORTALID>1</USER_WEBPORTALID>     <USER_eMailAdresse>orderfields_email@example.invalid</USER_eMailAdresse>     <USER_Telefon>USER_TELEFON</USER_Telefon>     <USER_ShopOrderId>TESTSCHEMA_SHOP_ORDER_ID</USER_ShopOrderId>   </ORDER_FIELDS>   <ORDER_SUMMARY>     <TOTAL_ITEM_NUM>1</TOTAL_ITEM_NUM>     <TOTAL_AMOUNT>123.45</TOTAL_AMOUNT>   </ORDER_SUMMARY> </ORDER>

OmniBelegService:Releases Rev 12

2026-04-13T14:44:08Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

*Bei der Durchführung des Setups (Dienst-Update) werden nun nicht mehr die Dateien des Log-Orders geleert.

===== Installationsskripte =====

*Skript 002 wurde optimiert, dass die vorhandene Konfiguration des alten XML-Service AddIns nur dann übernommen wird, wenn dort mindestens 1 Importformat existiert.
*Skript 072 wurde korrigiert, dass die Existenz Prüfung korrekt funktioniert und bei einer erneuten Ausführung nicht in einen Fehler läuft, sollte das dort behandelte Feld ASPZuordnung in den Importformaten bereits vorhanden sein.
*Skript 075 wurde eingeführt, welches den Daten-Missstand bzgl. der fehlenden Prozedur der KtoNummer Ermittlung in den Importformaten glattzieht.
*Skript 076 wurde eingeführt, welches die globale Einstellung "TrimXMLFelder" einführt.
*Skript 077 wurde eingeführt, welches die OmniBelegService_Belege_Adressen Tabelle um das Feld A0_CMD_EU_Country und A0_CMD_Tax_Area erweitert
*Skript 078 wurde eingeführt, welches die Prozedur spOmniBelegService_InsertXMLAdressen um den Parameter A0_CMD_EU_County und A0_CMD_Tax_Area erweitert

==== Dienst ====

===== Auftragsimport =====
* Die Besteuerungsart wird bei einer Kundenanlage nun fest aus dem Vorlage-Kunden übernommen und durch keine XML-Felder mehr übersteuert.
* Das neu eingeführte optionale Feld TAX_AREA in der CUSTOMER_MASTER_DATA übersteuert nun das TAX_AREA Feld bei der Kunden-Vorlagen-Ermittlung, sollte es gefüllt sein.
* Für Beleg-Zuschläge wurde der Input für Sage optimiert, da es in manchen Fällen dazu kam, dass der Belegzuschlag falsch besteuert wurde und daraus abweichende Zuschlagsbeträge entstanden sind.
* Bei der Anlage einer neuen Adresse wird der Wert aus dem XML-Feld "ORDER_LANGUAGE" nun mit berücksichtigt und setzt die Sprache anhand des XML-Wertes.
* Bei der Anlage eines neuen Kunden wird nun ebenfalls das EU Länderkürzel gesetzt. Dabei gelten folgende Regeln: Ist das Feld EU_COUNTRY in der CUSTOMER_MASTER_DATA gefüllt wird dies gesetzt. Alternativ wird standardmäßig das Länderkürzel der Auftraggeber-Adresse gesetzt, wenn es sich um eine EU Bestellung (TAX_AREA = EU) handelt.
* Einführung des Fehlercodes 137 - "''Die Kundennummer-Ermittlungs Prozedur ({Prozedur-Name}) lief in einen technischen Fehler: {Meldung}",'' um die frei konfigurierbare Stelle besser unterscheiden zu können im Kunden-Anlage Prozess.
*Zuschläge werden nun auf maximal 2 Nachkommastellen gerundet, da es bei mehreren Nachkomma-Stellen zu Folgefehler bei der Rechnungsübergabe in das Rechnungswesen gekommen ist.
*Beim Import der XML-Dateien werden sämtliche Werte nun getrimmt (führende und abschließende Leerzeichen entfernt), wenn die globale Einstellung "TrimXMLFelder" aktiv ist, um eine optimierte Datenqualität zu gewährleisten.
*Es wurde ein Fehler korrigiert, dass Benutzerfelder aus den Vorlage-Kunden nicht bei der Neukundenanlage mit übernommen wurden.
*Es wurde ein Fehler bei der XSD Validierung abgefangen, bei dem es im Fehlerfall zu einer sich im Kreis drehenden "Unbekannter Fehler" Meldung kam.
*Die XSD Validierung wurde aufgelockert und lässt nun wieder Benutzerfelder für den Ansprechpartner zu. Die Länge optionaler Feldinhalte wird nun an anderer Stelle geprüft.
*Einführung des FehlerCodes 24 - "''Die Feldlänge des Feldes {Feldname} überschreitet die maximal zulässige Länge von {x} Zeichen''.", um bei Überlängen von XML-Feldinhalten Folgefehler zu vermeiden.
*Bei gefülltem XML Wert ORDER_TAXATIONTYPE werden nun bei abweichendem Inhalt individuelle Besteuerungsarten geprüft und auch entsprechend auf Belegebene gesetzt.
*Die Längenbeschränkung der XSD-Validierung für das Feld ORDER_TAXATIONTYPE wurde von 22 auf 50 Zeichen erhöht, um individuelle Inhalte zu akzeptieren.
*Einführung des FehlerCodes 138 - "''Fehler bei der Ermittlung der BesteuerungsID von '{TaxationType}'''". Wird ausgegeben, wenn bei einem individuellen Wert des XML-Feldes ORDER_TAXATIONTYPE keine Besteuerungsart ermittelt werden konnte.
*Bei einer Kunden-Neuanlage wird nun auch die Versandart im Neukunden gesetzt, sollte diese in der XML gesetzt sein.

===== technische Themen =====

* Es wurde ein Absturz abgefangen, wenn bei Störfällen ein Logfile bereits durch einen anderen Prozess blockiert wurde.
*

==== Konfiguration ====

* Es wurde ein Fehler korrigiert, dass die Prozedur für die Kundennummer-Ermittlung nun auch abgeändert und gespeichert/geladen werden kann und somit dann auch im Dienst angewendet wird.
* die Auswahlmöglichkeiten Auftragsstorno & Direktstorno in der Belegauswahl wurden entfernt, da es keine Standard-Belegarten sind und es teilweise mit anderen Kunden-Individuellen Belegarten Konflikte gab.

==== Standard-BelegMapper ====

* Der Schreibfehler im Kommentar bzgl. zur YOUR_ORDER // Referenznummer wurde korrigiert
* Aufgrund existierender unterschiedlicher XML-Dateistrukturen und um Datenverlust zu vermeiden, wurde das Feld "ZUSATZ" in der Auftraggeber und Lieferadresse dahingehend erweitert, dass die XML Felder "STREET2" oder alternativ "ZUSATZ" dort berücksichtigt werden.
*der Knoten CUSTOMER_MASTER_DATA in der Auftraggeber Adresse wurde um das Feld "EU_COUNTRY" erweitert und wird standardmäßig durch das XML-Feld COUNTRY der Auftraggeber Adresse befüllt, sollte es sich um eine EU Bestellung handeln.
*das Feld ORDER_TAXATIONTYPE wird nun standardmäßig aus dem gleichnamigen XML-Knoten angesteuert.
*das Feld TAX_AREA in CUSTOMER_MASTER_DATA wird nun standardmäßig aus dem Feld CUSTOMER_TAX_AREA der Standard-XML befüllt.
*das BRUTTO_KZ wird nun automatisch auf Netto umgestellt, wenn eine NON_EU Bestellung vorliegt.

==== Nachtrag: 03.03.2025: ====

* Es wurde ein Fehler korrigiert, durch den die NON_EU Besteuerung über das Feld ORDER_TAXATIONTYPE in einen Fehler gelaufen ist und nicht korrekt ausgewertet werden konnte.
* Es wurde ein Fehler in den Autorechnungen korrigiert, bei denen in manchen Szenarien mit Fremdwährungen der Währungskurs gelöscht wurde.
'''11.03.2025:''' Die Version wurde als stable markiert.

'''28.08.2025:''' Es wurde ein Bug identifiziert bei Neu-Installationen. Das initiale Importformat wird nicht korrekt angelegt. (Folgefehler aus der Skript2-Optimierung).

Abhilfe: die Insert-Anweisung aus Skript2 per SQL nochmal manuell ausführen

OmniMDE:Druckerkonfiguration

2026-04-07T06:50:57Z

MH:

{{#invoke:Infobox|ShowInfoBoxOmniMDE}}
{{DISPLAYTITLE:Druckerkonfiguration}}

== Überblick ==
Damit die OmniMDE-Druckfunktionen reibungslos funktionieren, muss der Server, auf dem die MDE-Hintergrunddienste laufen (in der Regel der Sage Application Server), die Drucker über den Systemaccount „Local System“ erreichen können. Das bedeutet, dass die Drucker auf dem Server unabhängig von einzelnen Benutzerprofilen eingebunden werden. Falls der Zugriff über das „Local System“-Konto nicht möglich ist, kann der Windows-Dienst „HTK Service“ so eingestellt werden, dass er unter einem bestimmten Benutzerkonto läuft. Dabei gilt: Der gesamte Dienst, inklusive aller verwendeten Plugins, wird dann über dieses Konto ausgeführt.

== Umstellung des Windows-Dienst-Kontos ==
Möchten Sie den Windows-Dienst von der Standardeinstellung „Local System“ auf ein anderes Benutzerkonto umstellen, gehen Sie bitte wie folgt vor:
# Öffnen Sie den Windows Task-Manager.
# Wechseln Sie zum Reiter „Dienste“ und klicken Sie auf „Dienste öffnen“.
# Suchen Sie in der Liste nach dem „HTK Service“.
# Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie „Eigenschaften“.
# Wechseln Sie im Eigenschaften-Fenster zum Reiter „Anmelden“.
# Wählen Sie anstelle des „Lokalen Systemkontos“ die Option „Dieses Konto“ und geben Sie die gewünschten Benutzerdaten ein.
# Speichern Sie die Einstellungen und starten Sie den HTK-Dienst neu.
Bitte beachten Sie jedoch, dass diese Lösung nur einen Workaround darstellt und im Normalfall immer über den "Local System"-Account gearbeitet werden sollte.

== Testtool zur Druckerüberprüfung ==
Um sicherzustellen, dass alle Drucker korrekt eingebunden sind und vom Windows-Dienst erreicht werden können, stellen wir ein praktisches Testtool zur Verfügung. Dieses Tool zeigt Ihnen, welche Drucker unter welchem Konto sichtbar sind. Bitte beachten Sie, dass das Testtool keinen echten Windows-Dienst simulieren kann und lediglich als erster Anlaufpunkt für einen Test dient.

Das Testtool wird mit einer '''App.config'''-Datei geliefert, in der Sie festlegen können, unter welchem Konto das Tool ausgeführt wird. Wichtige Einstellungen sind:
* '''ImpersonationMode''': Bestimmt, ob das Tool den Zugriff über das Konto „Local System“ oder über ein bestimmtes Benutzerkonto durchführt.
** '''Wert "LocalSystem"''': Das Tool übernimmt temporär die Rechte des „Local System“-Kontos.
** '''Wert "User"''': Es wird ein bestimmtes Benutzerkonto verwendet. Dafür müssen zusätzlich Domain, Benutzername und Passwort angegeben werden.
Wenn Sie hier nur den Standardmodus prüfen wollen, also ob "Local System" die Drucker findet, müssen Sie keine zusätzlichen Einstellungen vornehmen.

== Download ==

v1 nur check:
[https://omniseller.de/downloads/OmniMDE/tools/de.htk.omnimde.printercheck.zip DOWNLOAD (de.htk.omnimde.printercheck.zip)]

v2 inkl. Option zum Testdruck:
[https://omniseller.de/downloads/OmniMDE/tools/de.htk.omnimde.printercheck_v2.zip DOWNLOAD (de.htk.omnimde.printercheck v2.zip)]

ggf. erfordert das Ausführen Administrator-Rechte, sodass das Konsolenprogramm sich als Local-System anmelden kann.

== Tipps ==
Falls spezielle Druckerkonfigurationen benötigt werden – etwa mehrfacher Ausdruck, Schwarz-Weiß-Druck oder Duplexdruck – muss der Drucker direkt mit diesen Einstellungen eingebunden werden. Eine Möglichkeit ist es, eine Kopie des Druckers im System bereitzustellen, die dann ausschließlich für den Druck aus der MDE reserviert ist.

OmniMDE:Releases

2026-04-03T12:04:24Z

MH:

'''Hier finden Sie eine Übersicht der OmniMDE - Releaseversionen und deren Changelog*''' 
{| class="wikitable" style="border-collapse: collapse; width: 54.7986%; height: 276px;"
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px; text-align: center;" | '''Datum'''
| style="width: 10.3265%; height: 23px; text-align: center;" | '''Version Release'''
| style="width: 6.50975%; height: 23px; text-align: center;" | '''Version APP**'''
| style="width: 8.20496%; height: 23px; text-align: center;" | '''QS-Freigabe'''
| style="width: 2.37778%; height: 23px; text-align: center;" | '''Informationen'''
| style="width: 11.8754%; height: 23px; text-align: center;" | '''Sage Version'''
| style="width: 11.8754%; height: 23px; text-align: center;" | '''Android Version'''
| style="width: 7.74334%; height: 23px; text-align: center;" | '''Download ***'''
| style="width: 7.74334%; height: 23px; text-align: center;" | '''APK'''
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''xx.03.2026'''
| style="width: 10.3265%; height: 23px;" | RC12
| style="width: 6.50975%; height: 23px;" | ab. 1.2603.20xxx
| style="width: 8.20496%; height: 23px;" | '''Nein'''
| style="width: 2.37778%; height: 23px;" |
| style="width: 11.8754%; height: 23px;" | Sage 100 '''ab 9.0.9.2''' 
| style="width: 7.74334%; height: 23px;" | ab Android '''10''' bis max. Android '''14'''
| style="width: 7.74334%; height: 23px;" |
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''03.11.2025'''
| style="width: 10.3265%; height: 23px;" | RC11
| style="width: 6.50975%; height: 23px;" | ab. 1.2511.195xx
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R2025_1_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''ab 9.0.8 bis 9.0.9.2''' 
| style="width: 7.74334%; height: 23px;" | ab Android '''10''' bis max. Android '''14'''
| style="width: 7.74334%; height: 23px;" |
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''20.12.2024'''
| style="width: 10.3265%; height: 23px;" | RC10
| style="width: 6.50975%; height: 23px;" | ab. 1.2412.16481
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R2024_12_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''9.0.0 bis 9.0.8.x''' 
| style="width: 7.74334%; height: 23px;" | ab Android '''10''' bis max. Android '''14'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/OMNIMDE_RC10_9062+.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/APK/OmniMDE_RC10_1.2412.16481.apk DOWNLOAD]
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''22.10.2024'''
| style="width: 10.3265%; height: 23px;" | RC9
| style="width: 6.50975%; height: 23px;" | ab. 1.2410.16243
| style="width: 8.20496%; height: 23px;" | '''Nein'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R2024_10_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''9.0.0 bis 9.0.7.3''' (>= 9.0.7 bevorzugt)
| style="width: 7.74334%; height: 23px;" | ab Android '''8'''
| style="width: 7.74334%; height: 23px;" |
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''17.07.2024'''
| style="width: 10.3265%; height: 23px;" | RC8
| style="width: 6.50975%; height: 23px;" | ab. 1.2407.14831
| style="width: 8.20496%; height: 23px;" | '''Nein'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R2024_07_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''9.0.0 bis 9.0.7'''
| style="width: 7.74334%; height: 23px;" | ab Android '''8'''
| style="width: 7.74334%; height: 23px;" |
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''23.09.2022'''
| style="width: 10.3265%; height: 23px;" | RC7
| style="width: 6.50975%; height: 23px;" | ab. 1.2209.10947
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%;" | [https://wiki.htk.de/OmniMDE:Releases_R202209_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.1 bis 9.0.0'''
| style="width: 7.74334%; height: 23px;" | ab Android '''7.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/HTKOmniMDE_R202209RC7_BIN_90.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''05.08.2022'''
| style="width: 10.3265%; height: 23px;" | RC6
| style="width: 6.50975%; height: 23px;" | ab. 1.2208.10692
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R202208_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.1 bis 9.0.0'''
| style="width: 7.74334%; height: 23px;" | ab Android '''7.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/HTKOmniMDE_R202208RC6_BIN_90.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''15.07.2022'''
| style="width: 10.3265%; height: 23px;" | RC5
| style="width: 6.50975%; height: 23px;" | ab. 1.2207.10599
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R202207_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.1 bis 9.0.0'''
| style="width: 7.74334%; height: 23px;" | ab Android '''7.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/HTKOmniMDE_R202207RC5_BIN_90.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''26.04.2022'''
| style="width: 10.3265%; height: 23px;" | RC4
| style="width: 6.50975%; height: 23px;" | ab. 1.2204.10025
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R202204_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.1 bis 9.0.0'''
| style="width: 7.74334%; height: 23px;" | ab Android '''7.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/HTKOmniMDE_R202204RC4_BIN_90.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''15.03.2022'''
| style="width: 10.3265%; height: 23px;" | RC1
| style="width: 6.50975%; height: 23px;" | ab. 1.2203.9736
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R202203_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.1 bis 9.0.0'''
| style="width: 7.74334%; height: 23px;" | ab Android '''5.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/OmniMDE_R202203_RC1_90.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''09.09.2021'''
| style="width: 10.3265%; height: 23px;" | R20210909
| style="width: 6.50975%; height: 23px;" | ab. 1.2108.6855
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | [https://wiki.htk.de/OmniMDE:Releases_R202108_Changelog Changelog]
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.1 bis 9.0.0'''
| style="width: 7.74334%; height: 23px;" | Ab Android '''5.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/OmniMDE_R20210909_90.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''01.04.2021'''
| style="width: 10.3265%; height: 23px;" | R202180031
| style="width: 6.50975%; height: 23px;" |
 
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | -
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.0 bis 9.0.0'''
| style="width: 7.74334%; height: 23px;" | ab Android '''5.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/OmniMDE_R202180031_90.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''04.05.2020'''
| style="width: 10.3265%; height: 23px;" | R150
| style="width: 6.50975%; height: 23px;" |
 
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | -
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.0'''
| style="width: 7.74334%; height: 23px;" | ab Android '''5.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/OmniMDE_R150.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|- style="height: 23px;"
| style="width: 6.70666%; height: 23px;" | '''14.01.2020'''
| style="width: 10.3265%; height: 23px;" | R140
| style="width: 6.50975%; height: 23px;" |
 
| style="width: 8.20496%; height: 23px;" | '''Ja'''
| style="width: 2.37778%; height: 23px;" | -
| style="width: 11.8754%; height: 23px;" | Sage 100 '''8.0'''
| style="width: 7.74334%; height: 23px;" | ab Android '''5.1'''
| style="width: 7.74334%; height: 23px;" | [https://omniseller.de/downloads/OmniMDE/Releases/OmniMDE_R140.zip DOWNLOAD]
| style="width: 7.74334%; height: 23px;" |
|}

''* Changelogs sind ab RC12 erst NACH release einsehbar.'' 
''** kann leicht variieren'' 
''*** Das Passwort der Archivdatei erhalten Sie auf schriftliche Anfrage zugesendet.''

OmniBelegService:Releases Rev 15

2026-03-20T15:07:00Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (Version 9.0.8, Kompatibel ab Sage LiveUpdate Stand 9.0.10) veröffentlicht, die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

==== weiteres: ====
'''02.03.2026 (Version 9.0.15.1):'''
* Es wurde ein Fehler korrigiert, dass DCMs nun auch wieder ausgeführt werden.
'''10.03.2026 (Version 9.0.15.2):'''
* Bei einer Neukundenanlage werden nun auch folgende Felder aus dem Vorlage-Kunden übernommen: ERechnungAusgabe, ERechnungHausbank
* Skript 90 liefert nun auch das Benutzerfeld USER_OBSLSErstellt aus.
* Autolieferscheine:Die Logik aus dem 14er Release wurde noch einmal angepasst. Bei einem erfolgreich erstellten Lieferschein werden nun die Feldwerte LetzterLSVersuch und LetzterLSVersuch Meldung geleert. Zusätzlich wird in die Auftragsbestätigung (und den Lieferschein) das Datum in OBSLSErstellt zurückgeschrieben, damit man erkennen kann wann genau der Lieferschein erstellt wurde.
'''20.03.2026: Diese Version wurde als stable markiert.'''

OmniBelegService:Releases

2026-03-20T15:06:02Z

MH:

{{DISPLAYTITLE:Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive Changelog.

Die Versionsnummern sind wie folgt aufgebaut: [MajorVersion].[MinorVersion].[Revision]

- MajorVersion: Hauptversion der Sage

- MinorVersion: Unterversion der Sage

-Revision: Aktueller Entwicklungsstand der Software. Fortlaufende, sich erhöhende Nummer.

Es werden hier lediglich die Veränderungen zur Vorgänger-Version aufgelistet.

Sollte eine Version den Status "Beta" haben, behält sich HTK noch vor, Änderungen an dieser Version vorzunehmen und ein Update der selben Version zu veröffentlichen. Änderungen sind dann entsprechend noch im Changelog dokumentiert.

Den Entwicklungs-Hinweisen ist Beachtung zu schenken und diese sollen auch bei einem Update auf diese oder höhere Version Folge geleistet werden. Andernfalls könnte der Import nach dem Update nicht mehr wie gewünscht funktionieren.
{{{!}} class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
!Testumgebung und Freigabe (Sage-Version)
! Changelog
! Downloadlink
|-
|9.0.15
| 26.02.2026
|stable
|Erweiterung der AdressenCheck-Prozedur um den Parameter @isEK (dies muss bei einem Update, sofern eine abweichende "AdressenCheck"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 15|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.15.2-Setup.exe download]
|-
|9.0.14
| 02.01.2026
|stable
|
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 14|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.14.1-Setup.exe download]
|-
|9.0.13
| 29.08.2025
|stable
|Sage hat den internen Aufruf für Vorgangsrechnungen mit der 9.0.9 verändert. Ab Sage Version 9.0.9 ist das Modul Autorechnungen mit älteren Versionen des Dienstes inkompatibel.
|9.0.9 (auch kompatibel und freigegeben für 9.0.10)
|[[OmniBelegService:Releases Rev 13|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.13.2-Setup.exe download]
|-
|9.0.12
| 18.02.2025
|stable
|Erweiterung der Prozedur spOmniBelegService_InsertXMLAdressen um die Parameter A0_CMD_EU_Country und A0_CMD_Tax_Area (dies muss bei einem Update, sofern eine abweichende "InsertXMLAdressen"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.7 + 9.0.8
|[[OmniBelegService:Releases Rev 12|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.12-Setup.exe download]
|-
|9.0.11
| 28.08.2024
|stable
|Die Belege-Positionen Insert Prozedur wurde um den Parameter 'UseOLPrice' erweitert. (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.6 + 9.0.7 ( 9.0.7 Release auch kompatibel für 9.0.8)
|[[OmniBelegService:Releases Rev 11|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.11-Setup_OL907.exe download_9.0.7] [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.11-Setup_OL906.exe download_9.0.6]
|-
|9.0.10
| 08.07.2024
||stable
|unterschiedliche Setups für 9.0.6 & 9.0.7
Hinweis Bei Liveupdate auf 9.0.7 sind ältere Versionen höchstwahrscheinlich nicht mehr kompatibel
|9.0.6 + 9.0.7
|[[OmniBelegService:Releases Rev 10|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.10-Setup_OL907.exe download_9.0.7] [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.10-Setup_OL906.exe download_9.0.6]
|-
|9.0.9
| 20.02.2024
|stable
|
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 9|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.9-Setup.exe download]
|-
|9.0.8
| 04.12.2023
||stable
|Überarbeitung der Standard Prozedur ArtikelCheck (wg. Sage Varianten)
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 8|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.8-Setup.exe download]
|-
|9.0.7
|17.08.2023
||stable
|Hinweis: Sage-Version (Liveupdate-Stand) von mind. 9.0.5 benötigt.
|9.0.5
|[[OmniBelegService:Releases Rev 7|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.7-Setup.exe download]
|-
|9.0.6
| 31.07.2023
| -
|Status aufgrund der neuen Version nach kurzem Abstand nicht weiter verfolgt.
|9.0.4
|[[OmniBelegService:Releases Rev 6|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.6-Setup.exe download]
|-
|9.0.5
| 22.05.2023
|stable
| Erweiterung der Prozedur "spOmniBelegService_InsertXMLPosition" um den Parameter "Quantity Unit" (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
| -
|[[OmniBelegService:Releases Rev 5|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.5-Setup.exe download]
|-
|9.0.4
| 27.02.2023
|stable
|
| -
|[[OmniBelegService:Releases Rev 4|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.4-Setup.exe download]
{{!}}-
{{!}} 9.0.3
{{!}} 09.01.2023
{{!}} stable
{{!}}
| -
{{!}}
[[OmniBelegService:Releases Rev 3|changelog]]
{{!}}
[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.3-Setup.exe download ]
{{!}}-
{{!}} 9.0.2
{{!}} 08.12.2022
{{!}} stable
{{!}} 
| -
{{!}} [[OmniBelegService:Releases Rev 2{{!}}changelog]]
{{!}} [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.2-Setup.exe download]
{{!}}-
{{!}} 9.0.1
{{!}} 20.10.2022
{{!}} stable
{{!}}
 
| -
{{!}} [[OmniBelegService:Releases Rev 1{{!}}changelog]]*
{{!}} [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.1-Setup.exe download]
{{!}}}
<nowiki>*</nowiki>=Die erste Version erfasst Erweiterungen/Verbesserungen, welche sich seit dem letzten Beta Release Stand verändert haben. Weitere grundsätzliche Funktionen können entsprechend dem [[OmniBelegService:Handbuch{{!}}Handbuch]] entnommen werden.

OmniBelegService:Releases

2026-03-20T15:05:04Z

MH:

{{DISPLAYTITLE:Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive Changelog.

Die Versionsnummern sind wie folgt aufgebaut: [MajorVersion].[MinorVersion].[Revision]

- MajorVersion: Hauptversion der Sage

- MinorVersion: Unterversion der Sage

-Revision: Aktueller Entwicklungsstand der Software. Fortlaufende, sich erhöhende Nummer.

Es werden hier lediglich die Veränderungen zur Vorgänger-Version aufgelistet.

Sollte eine Version den Status "Beta" haben, behält sich HTK noch vor, Änderungen an dieser Version vorzunehmen und ein Update der selben Version zu veröffentlichen. Änderungen sind dann entsprechend noch im Changelog dokumentiert.

Den Entwicklungs-Hinweisen ist Beachtung zu schenken und diese sollen auch bei einem Update auf diese oder höhere Version Folge geleistet werden. Andernfalls könnte der Import nach dem Update nicht mehr wie gewünscht funktionieren.
{{{!}} class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
!Testumgebung und Freigabe (Sage-Version)
! Changelog
! Downloadlink
|-
|9.0.15
| 26.02.2026
|beta
|Erweiterung der AdressenCheck-Prozedur um den Parameter @isEK (dies muss bei einem Update, sofern eine abweichende "AdressenCheck"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 15|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.15.2-Setup.exe download]
|-
|9.0.14
| 02.01.2026
|stable
|
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 14|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.14.1-Setup.exe download]
|-
|9.0.13
| 29.08.2025
|stable
|Sage hat den internen Aufruf für Vorgangsrechnungen mit der 9.0.9 verändert. Ab Sage Version 9.0.9 ist das Modul Autorechnungen mit älteren Versionen des Dienstes inkompatibel.
|9.0.9 (auch kompatibel und freigegeben für 9.0.10)
|[[OmniBelegService:Releases Rev 13|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.13.2-Setup.exe download]
|-
|9.0.12
| 18.02.2025
|stable
|Erweiterung der Prozedur spOmniBelegService_InsertXMLAdressen um die Parameter A0_CMD_EU_Country und A0_CMD_Tax_Area (dies muss bei einem Update, sofern eine abweichende "InsertXMLAdressen"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.7 + 9.0.8
|[[OmniBelegService:Releases Rev 12|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.12-Setup.exe download]
|-
|9.0.11
| 28.08.2024
|stable
|Die Belege-Positionen Insert Prozedur wurde um den Parameter 'UseOLPrice' erweitert. (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.6 + 9.0.7 ( 9.0.7 Release auch kompatibel für 9.0.8)
|[[OmniBelegService:Releases Rev 11|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.11-Setup_OL907.exe download_9.0.7] [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.11-Setup_OL906.exe download_9.0.6]
|-
|9.0.10
| 08.07.2024
||stable
|unterschiedliche Setups für 9.0.6 & 9.0.7
Hinweis Bei Liveupdate auf 9.0.7 sind ältere Versionen höchstwahrscheinlich nicht mehr kompatibel
|9.0.6 + 9.0.7
|[[OmniBelegService:Releases Rev 10|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.10-Setup_OL907.exe download_9.0.7] [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.10-Setup_OL906.exe download_9.0.6]
|-
|9.0.9
| 20.02.2024
|stable
|
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 9|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.9-Setup.exe download]
|-
|9.0.8
| 04.12.2023
||stable
|Überarbeitung der Standard Prozedur ArtikelCheck (wg. Sage Varianten)
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 8|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.8-Setup.exe download]
|-
|9.0.7
|17.08.2023
||stable
|Hinweis: Sage-Version (Liveupdate-Stand) von mind. 9.0.5 benötigt.
|9.0.5
|[[OmniBelegService:Releases Rev 7|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.7-Setup.exe download]
|-
|9.0.6
| 31.07.2023
| -
|Status aufgrund der neuen Version nach kurzem Abstand nicht weiter verfolgt.
|9.0.4
|[[OmniBelegService:Releases Rev 6|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.6-Setup.exe download]
|-
|9.0.5
| 22.05.2023
|stable
| Erweiterung der Prozedur "spOmniBelegService_InsertXMLPosition" um den Parameter "Quantity Unit" (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
| -
|[[OmniBelegService:Releases Rev 5|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.5-Setup.exe download]
|-
|9.0.4
| 27.02.2023
|stable
|
| -
|[[OmniBelegService:Releases Rev 4|changelog]]
|[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.4-Setup.exe download]
{{!}}-
{{!}} 9.0.3
{{!}} 09.01.2023
{{!}} stable
{{!}}
| -
{{!}}
[[OmniBelegService:Releases Rev 3|changelog]]
{{!}}
[https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.3-Setup.exe download ]
{{!}}-
{{!}} 9.0.2
{{!}} 08.12.2022
{{!}} stable
{{!}} 
| -
{{!}} [[OmniBelegService:Releases Rev 2{{!}}changelog]]
{{!}} [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.2-Setup.exe download]
{{!}}-
{{!}} 9.0.1
{{!}} 20.10.2022
{{!}} stable
{{!}}
 
| -
{{!}} [[OmniBelegService:Releases Rev 1{{!}}changelog]]*
{{!}} [https://omniseller.de/downloads/OmniBelegService/OmniBelegService-9.0.1-Setup.exe download]
{{!}}}
<nowiki>*</nowiki>=Die erste Version erfasst Erweiterungen/Verbesserungen, welche sich seit dem letzten Beta Release Stand verändert haben. Weitere grundsätzliche Funktionen können entsprechend dem [[OmniBelegService:Handbuch{{!}}Handbuch]] entnommen werden.

OmniSeller:OrdersService

2026-03-20T13:08:53Z

MH:

== OmniSeller OrdersService ==
=== Einleitung ===
Die strategische Entwicklung des OmniSellers soll langfristig so umgestaltet werden, dass diverse Übertragungen der Schnittstelle auf mehrere Dienste verteilt wird. 
Dies bietet folgende Vorteile:
*'''Ausfallsicherheit''': Sollten an irgendeiner Stelle Strörungen auftreten existiert nicht direkt ein Stillstand, sondern es sind nur Teilbereiche betroffen. Ebenfalls kann bei Störungen seitens HTK auch einfacher auf andere Microsoft Azure-Instanzen zurückgegriffen und umgestellt werden oder bei Neuerungen/Anpassungen der Kunden einfacher Testinstanzen bereitgestellt werden.
*'''Updates/Wartbarkeit''': Bei notwendigen Updates ist nicht direkt die komplette Schnittstelle betroffen, sondern lediglich Teilbereiche. Dies minimiert die Risiken von Fehlern und erleichtert das Update einzelner Teilbereiche des OmniSellers.
*'''Skalierbarkeit''': Die neuen Dienste werden grundsätzlich für größeren Durchsatz implementiert um dem stetig ansteigenden Datentraffic gerecht zu werden und durch die neue Basis auch grundlegend überarbeitet. Es können damit z.B. in einem Zeitfenster deutlich mehr Bestellungen und Statusmeldungen abgewickelt werden als davor, und das bei weniger Ressourcen-Verbrauch als davor.
Aus diesem Grund ist der OmniSellerOrdersService entstanden der die Bestell-Prozesse von der Bereitstellung der Dateien bis zur Rückmeldung des Status aus dem OmniSellerDataService ablöst.

=== Installation/Update ===
Das Setup ist einfach gestaltet und muss lediglich durchgeklickt werden. Der Dienst erkennt automatisch andere installierte OmniSeller-Dienste und bedient sich an deren Konfiguration (z.B. aktive Portale, Datenbank-Verbindung etc.)
==== Schritt 1 ====
Im Task-Manager prüfen, ob der Dienst bzw. andere OmniSeller Dienste auch auf dem Server installiert sind, auf dem man das Setup ausführen möchte.

[[file:img1753818124185.png|500px|frameless]]

==== Schritt 2 ====
Das Setup mit Admin-Rechten starten und die  Sprache auswählen:

[[file:img1753875244155.png|300px|frameless]]

-> OK drücken

==== Schritt 3 ====
[[file:img1753815292081.png|500px|frameless]]

-> Installieren drücken

==== Schritt 4 ====
Sollte entweder die Konfiguration noch offen sein oder der Dienst im Hintergrund laufen werden diese nun beendet.

[[file:img1753804885272.png|500px|frameless]]

-> weiter klicken

==== Schritt 5 ====
warten bis Installation abgeschlossen ist [[file:img1753849423643.png|500px|frameless]]

==== Schritt 6 ====
[[file:img1753816390316.png|500px|frameless]]

-> Fertigstellen drücken

==== Schritt 7 ====
im TaskManager prüfen, ob der Dienst nach dem Setup auch wieder den Status "wird ausgeführt" hat und somit läuft.

[[file:img1753848527888.png|500px|frameless]]

=== Konfiguration ===
'''Hinweis: Im Standardbetrieb ist es nicht notwendig etwas in der Konfiguration umzustellen.'''

''' '''Nach der Installation kann die Konfiguration über die Windows-Suche "OmnisellerOrdersService-Konfiguration" gefunden werden. 

[[file:img1753704184326.png|300px|frameless]]

Es öffnet sich folgender Dialog: 

[[file:img1753754982652.png|500px|frameless]]
*In den globalen Einstellungen kann lediglich die OmniSeller Azure-Instanz konfiguriert werden. 
*oben rechts ist die Versionsnummer abgebildet.
*durch drücken auf die Daumen können die Funktionen aktiviert bzw. deaktiviert werden.  

=== relevante Microsoft Azure Instanzen & IP-Adressen ===
Die Kommunikation zwischen dem Dienst und den Portalen erfolgt über eine OmniSeller Cloud API.

Standardmäßig liegt hinter dem Dienst folgende Microsoft Azure Instanz: 
*https://omniseller3.azurewebsites.net
*IP-Adresse: 52.232.26.228 (Ziel-Adresse an die der Dienst die Anfragen sendet)
*ausgehender Port: 443
*Die Azure-Instanz hat je nach Auslastung mehrere ausgehende IP-Adressen die dann wiederum auf Seite der Webshops freigegeben sein sollten. Anbei eine Auflistung relevanter IP-Adressen: - 52.166.67.186 - 52.174.41.85 - 52.178.42.82 - 52.174.47.52 - 52.232.26.228 
Als Backup oder für Beta-Tests ist ebenfalls folgende Instanz relevant:
* https://omniseler2.azurewebsites.net
*IP-Adresse: 13.69.68.5
*ausgehender Port: 443
*Die Azure-Instanz hat je nach Auslastung mehrere ausgehende IP-Adressen die dann wiederum auf Seite der Webshops freigegeben sein sollten.  Anbei eine Auflistung relevanter IP-Adressen: - 13.69.68.5 - 13.95.87.96 - 13.95.138.60 - 13.95.138.69 - 13.95.138.205 - 13.95.139.104 - 13.95.140.35 - 13.95.142.254 

=== Releases ===
{| class="wikitable" style="border-collapse: collapse; width: 100%; height: 389px; margin-left: auto; margin-right: auto;"
! style="height: 28px; width: 4.4181%;" | Version
! style="height: 28px; width: 8.24353%;" | Erscheinungsdatum
! style="height: 28px; width: 80.4418%;" | Changelog
! style="height: 28px; width: 6.73491%;" | Download-Link
|-
| style="width: 4.4181%; text-align: center;" | 2.0.1
| style="width: 8.24353%; text-align: center;" | 20.03.2026
| style="width: 80.4418%;" |
*Es wurden Kompatibilitätsfehler behoben und der Dienst wird nun mit dem Setup in die neue Verzeichnis Struktur umgezogen Der Download Link für die 2.0.0 Version wurde entfernt, da das Release instabil ist.
| style="width: 6.73491%;" | [https://www.omniseller.de/downloads/OmniSellerOrdersService/OmniSellerOrdersService_Setup_2.0.1.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; text-align: center; height: 28px;" | 2.0.0
| style="width: 8.24353%; text-align: center; height: 28px;" | 11.03.2026
| style="width: 80.4418%; height: 28px;" |
*Version 2.0.0 macht den Dienst mit der neuen OmniSeller Dienststruktur (CoreService, UploadService, usw.) kompatibel.
*Bei Neuinstallationen ist das Installationsverzeichnis nun auf C:\OmniVersum\Apps eingestellt statt der alten ProgramFiles(x86) Struktur.
| style="width: 6.73491%; height: 28px;" |
|- style="height: 51px;"
| style="width: 4.4181%; text-align: center; height: 51px;" | 1.5.1
| style="width: 8.24353%; text-align: center; height: 51px;" | 19.01.2026
| style="width: 80.4418%; height: 51px;" |
*Es wurde ein Skriptfehler in der Prozedur korrigiert (Nachbesserung Release 1.5.0), dass auf das falsche Benutzerfeld gefiltert wurde und zur Folge hatte, dass bei älteren Anbindungen der Bestellstatus nicht mehr funktioniert hat.
| style="width: 6.73491%; height: 51px;" | [https://www.omniseller.de/downloads/OmniSellerOrdersService/OmniSellerOrdersService_Setup_1.5.1.exe download]
|- style="height: 145px;"
| style="width: 4.4181%; text-align: center; height: 145px;" | 1.5.0
| style="width: 8.24353%; text-align: center; height: 145px;" | 29.12.2025
| style="width: 80.4418%; height: 145px;" |
*Es wurde ein Fehler abgefangen, dass manuell erstellte Belege die durch eine manuelle Eintragung des OrderChannsl aber ohne gesetzte USER_OrderID / USER_OrderIdentification Felder in einen Fehler gelaufen sind und dadurch eine Verarbeitung der anstehenden Statusmeldungen verhindert hat.
*Der Datensatz für Bestellstatus Meldungen wurde um das Feld QuantityInReceipt erweitert und übermittelt die Positionsmengen des aktuellen Belegs. Dies soll den Prozess bei Teillieferungen (bzw. nach längerer Übermittlungspause oder Massen-Rückimporte von TrackingCodes) stabilisieren. 
| style="width: 6.73491%; height: 145px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.5.0.exe download]
|- style="height: 53px;"
| style="width: 4.4181%; text-align: center; height: 53px;" | 1.4.0
| style="width: 8.24353%; text-align: center; height: 53px;" | 04.09.2025
| style="width: 80.4418%; height: 53px;" |
*Es wurde ein Fehler abgefangen, dass Bestellungs-XMLs nicht auf dem System abgelegt werden konnten, wenn Bestellnummern ein "verbotenes" Zeichen (\/:*?""<>|) für Dateinamen beinhalten.
*Es wurde ein Fehler korrigiert, bei dem Status-Rückmeldungen nicht funktioniert haben, wenn in den Zuordnung mehrere Statusmeldungen kommasepariert konfiguriert waren.
| style="width: 6.73491%; height: 53px;" | [https://www.omniseller.de/downloads/OmniSellerOrdersService/OmniSellerOrdersService_Setup_1.4.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; height: 28px; text-align: center;" |
1.3.0
| style="width: 8.24353%; height: 28px; text-align: center;" |
29.07.2025
| style="width: 80.4418%; height: 28px;" |
*Es wurde ein Fehler korrigiert, dass eine Bestellstatus-Meldung mehrfach abgesetzt wurde, wenn im Kundenstamm der Auftraggeber-Adresse mehrere Kontokorrente eingepflegt sind.
*Es wurde ein Fehler korrigiert, bei dem die Versionsnummer des Dienstes in manchen Fällen an den vorgesehenen Stellen nicht ersichtlich war. 
| style="width: 6.73491%; height: 28px;" |
[https://www.omniseller.de/downloads/OmniSellerOrdersService/OmniSellerOrdersService_Setup_1.3.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; height: 28px; text-align: center;" |
1.2.0
| style="width: 8.24353%; height: 28px; text-align: center;" |
09.01.2025
| style="width: 80.4418%; height: 28px;" |
*erstes offizielles Release mit Standardfunktionen Bestelldownload & Bestellstatus
| style="width: 6.73491%; height: 28px;" |
[https://www.omniseller.de/downloads/OmniSellerOrdersService/OmniSellerOrdersService_Setup_1.2.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; text-align: center; height: 28px;" | 1.1.0
| style="width: 8.24353%; text-align: center; height: 28px;" | -
| style="width: 80.4418%; height: 28px;" |
*inoffizielles Beta Release welches bei Pilot-Kunden getestet und nachoptimiert wurde
| style="width: 6.73491%; height: 28px;" | 
|}

OmniSeller:OrdersService

2026-03-11T15:58:39Z

MH: /* Releases */

== OmniSeller OrdersService ==
=== Einleitung ===
Die strategische Entwicklung des OmniSellers soll langfristig so umgestaltet werden, dass diverse Übertragungen der Schnittstelle auf mehrere Dienste verteilt wird. 
Dies bietet folgende Vorteile:
*'''Ausfallsicherheit''': Sollten an irgendeiner Stelle Strörungen auftreten existiert nicht direkt ein Stillstand, sondern es sind nur Teilbereiche betroffen. Ebenfalls kann bei Störungen seitens HTK auch einfacher auf andere Microsoft Azure-Instanzen zurückgegriffen und umgestellt werden oder bei Neuerungen/Anpassungen der Kunden einfacher Testinstanzen bereitgestellt werden.
*'''Updates/Wartbarkeit''': Bei notwendigen Updates ist nicht direkt die komplette Schnittstelle betroffen, sondern lediglich Teilbereiche. Dies minimiert die Risiken von Fehlern und erleichtert das Update einzelner Teilbereiche des OmniSellers.
*'''Skalierbarkeit''': Die neuen Dienste werden grundsätzlich für größeren Durchsatz implementiert um dem stetig ansteigenden Datentraffic gerecht zu werden und durch die neue Basis auch grundlegend überarbeitet. Es können damit z.B. in einem Zeitfenster deutlich mehr Bestellungen und Statusmeldungen abgewickelt werden als davor, und das bei weniger Ressourcen-Verbrauch als davor.
Aus diesem Grund ist der OmniSellerOrdersService entstanden der die Bestell-Prozesse von der Bereitstellung der Dateien bis zur Rückmeldung des Status aus dem OmniSellerDataService ablöst.

=== Installation/Update ===
Das Setup ist einfach gestaltet und muss lediglich durchgeklickt werden. Der Dienst erkennt automatisch andere installierte OmniSeller-Dienste und bedient sich an deren Konfiguration (z.B. aktive Portale, Datenbank-Verbindung etc.)
==== Schritt 1 ====
Im Task-Manager prüfen, ob der Dienst bzw. andere OmniSeller Dienste auch auf dem Server installiert sind, auf dem man das Setup ausführen möchte.

[[file:img1753818124185.png|500px|frameless]]

==== Schritt 2 ====
Das Setup mit Admin-Rechten starten und die  Sprache auswählen:

[[file:img1753875244155.png|300px|frameless]]

-> OK drücken

==== Schritt 3 ====
[[file:img1753815292081.png|500px|frameless]]

-> Installieren drücken

==== Schritt 4 ====
Sollte entweder die Konfiguration noch offen sein oder der Dienst im Hintergrund laufen werden diese nun beendet.

[[file:img1753804885272.png|500px|frameless]]

-> weiter klicken

==== Schritt 5 ====
warten bis Installation abgeschlossen ist [[file:img1753849423643.png|500px|frameless]]

==== Schritt 6 ====
[[file:img1753816390316.png|500px|frameless]]

-> Fertigstellen drücken

==== Schritt 7 ====
im TaskManager prüfen, ob der Dienst nach dem Setup auch wieder den Status "wird ausgeführt" hat und somit läuft.

[[file:img1753848527888.png|500px|frameless]]

=== Konfiguration ===
'''Hinweis: Im Standardbetrieb ist es nicht notwendig etwas in der Konfiguration umzustellen.'''

''' '''Nach der Installation kann die Konfiguration über die Windows-Suche "OmnisellerOrdersService-Konfiguration" gefunden werden. 

[[file:img1753704184326.png|300px|frameless]]

Es öffnet sich folgender Dialog: 

[[file:img1753754982652.png|500px|frameless]]
*In den globalen Einstellungen kann lediglich die OmniSeller Azure-Instanz konfiguriert werden. 
*oben rechts ist die Versionsnummer abgebildet.
*durch drücken auf die Daumen können die Funktionen aktiviert bzw. deaktiviert werden.  

=== relevante Microsoft Azure Instanzen & IP-Adressen ===
Die Kommunikation zwischen dem Dienst und den Portalen erfolgt über eine OmniSeller Cloud API.

Standardmäßig liegt hinter dem Dienst folgende Microsoft Azure Instanz: 
*https://omniseller3.azurewebsites.net
*IP-Adresse: 52.232.26.228 (Ziel-Adresse an die der Dienst die Anfragen sendet)
*ausgehender Port: 443
*Die Azure-Instanz hat je nach Auslastung mehrere ausgehende IP-Adressen die dann wiederum auf Seite der Webshops freigegeben sein sollten. Anbei eine Auflistung relevanter IP-Adressen: - 52.166.67.186 - 52.174.41.85 - 52.178.42.82 - 52.174.47.52 - 52.232.26.228 
Als Backup oder für Beta-Tests ist ebenfalls folgende Instanz relevant:
* https://omniseler2.azurewebsites.net
*IP-Adresse: 13.69.68.5
*ausgehender Port: 443
*Die Azure-Instanz hat je nach Auslastung mehrere ausgehende IP-Adressen die dann wiederum auf Seite der Webshops freigegeben sein sollten.  Anbei eine Auflistung relevanter IP-Adressen: - 13.69.68.5 - 13.95.87.96 - 13.95.138.60 - 13.95.138.69 - 13.95.138.205 - 13.95.139.104 - 13.95.140.35 - 13.95.142.254 

=== Releases ===
{| class="wikitable" style="border-collapse: collapse; width: 100%; height: 389px; margin-left: auto; margin-right: auto;"
! style="height: 28px; width: 4.4181%;" | Version
! style="height: 28px; width: 8.24353%;" | Erscheinungsdatum
! style="height: 28px; width: 80.4418%;" | Changelog
! style="height: 28px; width: 6.73491%;" | Download-Link
|- style="height: 28px;"
| style="width: 4.4181%; text-align: center; height: 28px;" | 2.0.0
| style="width: 8.24353%; text-align: center; height: 28px;" | 11.03.2026
| style="width: 80.4418%; height: 28px;" |

*Version 2.0.0 macht den Dienst mit der neuen OmniSeller Dienststruktur (CoreService, UploadService, usw.) kompatibel.
*Bei Neuinstallationen ist das Installationsverzeichnis nun auf C:\OmniVersum\Apps eingestellt statt der alten ProgramFiles(x86) Struktur.
| style="width: 6.73491%; height: 28px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_2.0.0.exe download]
|- style="height: 51px;"
| style="width: 4.4181%; text-align: center; height: 51px;" | 1.5.1
| style="width: 8.24353%; text-align: center; height: 51px;" | 19.01.2026
| style="width: 80.4418%; height: 51px;" |
*Es wurde ein Skriptfehler in der Prozedur korrigiert (Nachbesserung Release 1.5.0), dass auf das falsche Benutzerfeld gefiltert wurde und zur Folge hatte, dass bei älteren Anbindungen der Bestellstatus nicht mehr funktioniert hat.
| style="width: 6.73491%; height: 51px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.5.1.exe download]
|- style="height: 145px;"
| style="width: 4.4181%; text-align: center; height: 145px;" | 1.5.0
| style="width: 8.24353%; text-align: center; height: 145px;" | 29.12.2025
| style="width: 80.4418%; height: 145px;" |
*Es wurde ein Fehler abgefangen, dass manuell erstellte Belege die durch eine manuelle Eintragung des OrderChannsl aber ohne gesetzte USER_OrderID / USER_OrderIdentification Felder in einen Fehler gelaufen sind und dadurch eine Verarbeitung der anstehenden Statusmeldungen verhindert hat.
*Der Datensatz für Bestellstatus Meldungen wurde um das Feld QuantityInReceipt erweitert und übermittelt die Positionsmengen des aktuellen Belegs. Dies soll den Prozess bei Teillieferungen (bzw. nach längerer Übermittlungspause oder Massen-Rückimporte von TrackingCodes) stabilisieren. 
| style="width: 6.73491%; height: 145px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.5.0.exe download]
|- style="height: 53px;"
| style="width: 4.4181%; text-align: center; height: 53px;" | 1.4.0
| style="width: 8.24353%; text-align: center; height: 53px;" | 04.09.2025
| style="width: 80.4418%; height: 53px;" |
*Es wurde ein Fehler abgefangen, dass Bestellungs-XMLs nicht auf dem System abgelegt werden konnten, wenn Bestellnummern ein "verbotenes" Zeichen (\/:*?""<>|) für Dateinamen beinhalten.
*Es wurde ein Fehler korrigiert, bei dem Status-Rückmeldungen nicht funktioniert haben, wenn in den Zuordnung mehrere Statusmeldungen kommasepariert konfiguriert waren.
| style="width: 6.73491%; height: 53px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.4.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; height: 28px; text-align: center;" |
1.3.0
| style="width: 8.24353%; height: 28px; text-align: center;" |
29.07.2025
| style="width: 80.4418%; height: 28px;" |
*Es wurde ein Fehler korrigiert, dass eine Bestellstatus-Meldung mehrfach abgesetzt wurde, wenn im Kundenstamm der Auftraggeber-Adresse mehrere Kontokorrente eingepflegt sind.
*Es wurde ein Fehler korrigiert, bei dem die Versionsnummer des Dienstes in manchen Fällen an den vorgesehenen Stellen nicht ersichtlich war. 
| style="width: 6.73491%; height: 28px;" |
[http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.3.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; height: 28px; text-align: center;" |
1.2.0
| style="width: 8.24353%; height: 28px; text-align: center;" |
09.01.2025
| style="width: 80.4418%; height: 28px;" |
*erstes offizielles Release mit Standardfunktionen Bestelldownload & Bestellstatus
| style="width: 6.73491%; height: 28px;" |
[http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.2.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; text-align: center; height: 28px;" | 1.1.0
| style="width: 8.24353%; text-align: center; height: 28px;" | -
| style="width: 80.4418%; height: 28px;" |
*inoffizielles Beta Release welches bei Pilot-Kunden getestet und nachoptimiert wurde
| style="width: 6.73491%; height: 28px;" | 
|}

OmniSeller:OrdersService

2026-03-11T15:57:02Z

MH:

== OmniSeller OrdersService ==
=== Einleitung ===
Die strategische Entwicklung des OmniSellers soll langfristig so umgestaltet werden, dass diverse Übertragungen der Schnittstelle auf mehrere Dienste verteilt wird. 
Dies bietet folgende Vorteile:
*'''Ausfallsicherheit''': Sollten an irgendeiner Stelle Strörungen auftreten existiert nicht direkt ein Stillstand, sondern es sind nur Teilbereiche betroffen. Ebenfalls kann bei Störungen seitens HTK auch einfacher auf andere Microsoft Azure-Instanzen zurückgegriffen und umgestellt werden oder bei Neuerungen/Anpassungen der Kunden einfacher Testinstanzen bereitgestellt werden.
*'''Updates/Wartbarkeit''': Bei notwendigen Updates ist nicht direkt die komplette Schnittstelle betroffen, sondern lediglich Teilbereiche. Dies minimiert die Risiken von Fehlern und erleichtert das Update einzelner Teilbereiche des OmniSellers.
*'''Skalierbarkeit''': Die neuen Dienste werden grundsätzlich für größeren Durchsatz implementiert um dem stetig ansteigenden Datentraffic gerecht zu werden und durch die neue Basis auch grundlegend überarbeitet. Es können damit z.B. in einem Zeitfenster deutlich mehr Bestellungen und Statusmeldungen abgewickelt werden als davor, und das bei weniger Ressourcen-Verbrauch als davor.
Aus diesem Grund ist der OmniSellerOrdersService entstanden der die Bestell-Prozesse von der Bereitstellung der Dateien bis zur Rückmeldung des Status aus dem OmniSellerDataService ablöst.

=== Installation/Update ===
Das Setup ist einfach gestaltet und muss lediglich durchgeklickt werden. Der Dienst erkennt automatisch andere installierte OmniSeller-Dienste und bedient sich an deren Konfiguration (z.B. aktive Portale, Datenbank-Verbindung etc.)
==== Schritt 1 ====
Im Task-Manager prüfen, ob der Dienst bzw. andere OmniSeller Dienste auch auf dem Server installiert sind, auf dem man das Setup ausführen möchte.

[[file:img1753818124185.png|500px|frameless]]

==== Schritt 2 ====
Das Setup mit Admin-Rechten starten und die  Sprache auswählen:

[[file:img1753875244155.png|300px|frameless]]

-> OK drücken

==== Schritt 3 ====
[[file:img1753815292081.png|500px|frameless]]

-> Installieren drücken

==== Schritt 4 ====
Sollte entweder die Konfiguration noch offen sein oder der Dienst im Hintergrund laufen werden diese nun beendet.

[[file:img1753804885272.png|500px|frameless]]

-> weiter klicken

==== Schritt 5 ====
warten bis Installation abgeschlossen ist [[file:img1753849423643.png|500px|frameless]]

==== Schritt 6 ====
[[file:img1753816390316.png|500px|frameless]]

-> Fertigstellen drücken

==== Schritt 7 ====
im TaskManager prüfen, ob der Dienst nach dem Setup auch wieder den Status "wird ausgeführt" hat und somit läuft.

[[file:img1753848527888.png|500px|frameless]]

=== Konfiguration ===
'''Hinweis: Im Standardbetrieb ist es nicht notwendig etwas in der Konfiguration umzustellen.'''

''' '''Nach der Installation kann die Konfiguration über die Windows-Suche "OmnisellerOrdersService-Konfiguration" gefunden werden. 

[[file:img1753704184326.png|300px|frameless]]

Es öffnet sich folgender Dialog: 

[[file:img1753754982652.png|500px|frameless]]
*In den globalen Einstellungen kann lediglich die OmniSeller Azure-Instanz konfiguriert werden. 
*oben rechts ist die Versionsnummer abgebildet.
*durch drücken auf die Daumen können die Funktionen aktiviert bzw. deaktiviert werden.  

=== relevante Microsoft Azure Instanzen & IP-Adressen ===
Die Kommunikation zwischen dem Dienst und den Portalen erfolgt über eine OmniSeller Cloud API.

Standardmäßig liegt hinter dem Dienst folgende Microsoft Azure Instanz: 
*https://omniseller3.azurewebsites.net
*IP-Adresse: 52.232.26.228 (Ziel-Adresse an die der Dienst die Anfragen sendet)
*ausgehender Port: 443
*Die Azure-Instanz hat je nach Auslastung mehrere ausgehende IP-Adressen die dann wiederum auf Seite der Webshops freigegeben sein sollten. Anbei eine Auflistung relevanter IP-Adressen: - 52.166.67.186 - 52.174.41.85 - 52.178.42.82 - 52.174.47.52 - 52.232.26.228 
Als Backup oder für Beta-Tests ist ebenfalls folgende Instanz relevant:
* https://omniseler2.azurewebsites.net
*IP-Adresse: 13.69.68.5
*ausgehender Port: 443
*Die Azure-Instanz hat je nach Auslastung mehrere ausgehende IP-Adressen die dann wiederum auf Seite der Webshops freigegeben sein sollten.  Anbei eine Auflistung relevanter IP-Adressen: - 13.69.68.5 - 13.95.87.96 - 13.95.138.60 - 13.95.138.69 - 13.95.138.205 - 13.95.139.104 - 13.95.140.35 - 13.95.142.254 

=== Releases ===
{| class="wikitable" style="border-collapse: collapse; width: 100%; height: 389px; margin-left: auto; margin-right: auto;"
! style="height: 28px; width: 4.4181%;" | Version
! style="height: 28px; width: 8.24353%;" | Erscheinungsdatum
! style="height: 28px; width: 80.4418%;" | Changelog
! style="height: 28px; width: 6.73491%;" | Download-Link
|- style="height: 28px;"
| style="width: 4.4181%; text-align: center; height: 28px;" | 2.0.0
| style="width: 8.24353%; text-align: center; height: 28px;" | 11.03.2026
| style="width: 80.4418%; height: 28px;" |
**Version 2.0 macht den Dienst mit der neuen OmniSeller Dienststruktur (CoreService, UploadService, usw.) kompatibel. 
| style="width: 6.73491%; height: 28px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_2.0.0.exe download]
|- style="height: 51px;"
| style="width: 4.4181%; text-align: center; height: 51px;" | 1.5.1
| style="width: 8.24353%; text-align: center; height: 51px;" | 19.01.2026
| style="width: 80.4418%; height: 51px;" |
*Es wurde ein Skriptfehler in der Prozedur korrigiert (Nachbesserung Release 1.5.0), dass auf das falsche Benutzerfeld gefiltert wurde und zur Folge hatte, dass bei älteren Anbindungen der Bestellstatus nicht mehr funktioniert hat.
| style="width: 6.73491%; height: 51px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.5.1.exe download]
|- style="height: 145px;"
| style="width: 4.4181%; text-align: center; height: 145px;" | 1.5.0
| style="width: 8.24353%; text-align: center; height: 145px;" | 29.12.2025
| style="width: 80.4418%; height: 145px;" |
*Es wurde ein Fehler abgefangen, dass manuell erstellte Belege die durch eine manuelle Eintragung des OrderChannsl aber ohne gesetzte USER_OrderID / USER_OrderIdentification Felder in einen Fehler gelaufen sind und dadurch eine Verarbeitung der anstehenden Statusmeldungen verhindert hat.
*Der Datensatz für Bestellstatus Meldungen wurde um das Feld QuantityInReceipt erweitert und übermittelt die Positionsmengen des aktuellen Belegs. Dies soll den Prozess bei Teillieferungen (bzw. nach längerer Übermittlungspause oder Massen-Rückimporte von TrackingCodes) stabilisieren. 
| style="width: 6.73491%; height: 145px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.5.0.exe download]
|- style="height: 53px;"
| style="width: 4.4181%; text-align: center; height: 53px;" | 1.4.0
| style="width: 8.24353%; text-align: center; height: 53px;" | 04.09.2025
| style="width: 80.4418%; height: 53px;" |
*Es wurde ein Fehler abgefangen, dass Bestellungs-XMLs nicht auf dem System abgelegt werden konnten, wenn Bestellnummern ein "verbotenes" Zeichen (\/:*?""<>|) für Dateinamen beinhalten.
*Es wurde ein Fehler korrigiert, bei dem Status-Rückmeldungen nicht funktioniert haben, wenn in den Zuordnung mehrere Statusmeldungen kommasepariert konfiguriert waren.
| style="width: 6.73491%; height: 53px;" | [http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.4.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; height: 28px; text-align: center;" |
1.3.0
| style="width: 8.24353%; height: 28px; text-align: center;" |
29.07.2025
| style="width: 80.4418%; height: 28px;" |
*Es wurde ein Fehler korrigiert, dass eine Bestellstatus-Meldung mehrfach abgesetzt wurde, wenn im Kundenstamm der Auftraggeber-Adresse mehrere Kontokorrente eingepflegt sind.
*Es wurde ein Fehler korrigiert, bei dem die Versionsnummer des Dienstes in manchen Fällen an den vorgesehenen Stellen nicht ersichtlich war. 
| style="width: 6.73491%; height: 28px;" |
[http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.3.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; height: 28px; text-align: center;" |
1.2.0
| style="width: 8.24353%; height: 28px; text-align: center;" |
09.01.2025
| style="width: 80.4418%; height: 28px;" |
*erstes offizielles Release mit Standardfunktionen Bestelldownload & Bestellstatus
| style="width: 6.73491%; height: 28px;" |
[http://www.omniseller-ftp.de/OmniSellerOrdersService/Releases/OmniSellerOrdersService_Setup_1.2.0.exe download]
|- style="height: 28px;"
| style="width: 4.4181%; text-align: center; height: 28px;" | 1.1.0
| style="width: 8.24353%; text-align: center; height: 28px;" | -
| style="width: 80.4418%; height: 28px;" |
*inoffizielles Beta Release welches bei Pilot-Kunden getestet und nachoptimiert wurde
| style="width: 6.73491%; height: 28px;" | 
|}

OmniBelegService:Releases Rev 15

2026-03-10T16:02:28Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (Version 9.0.8, Kompatibel ab Sage LiveUpdate Stand 9.0.10) veröffentlicht, die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

==== weiteres: ====
'''02.03.2026 (Version 9.0.15.1):'''
* Es wurde ein Fehler korrigiert, dass DCMs nun auch wieder ausgeführt werden.
'''10.03.2026 (Version 9.0.15.2):'''
* Bei einer Neukundenanlage werden nun auch folgende Felder aus dem Vorlage-Kunden übernommen: ERechnungAusgabe, ERechnungHausbank
* Skript 90 liefert nun auch das Benutzerfeld USER_OBSLSErstellt aus.
* Autolieferscheine:Die Logik aus dem 14er Release wurde noch einmal angepasst. Bei einem erfolgreich erstellten Lieferschein werden nun die Feldwerte LetzterLSVersuch und LetzterLSVersuch Meldung geleert. Zusätzlich wird in die Auftragsbestätigung (und den Lieferschein) das Datum in OBSLSErstellt zurückgeschrieben, damit man erkennen kann wann genau der Lieferschein erstellt wurde.

OmniBelegService:Releases

2026-03-10T15:29:48Z

MH:

{{DISPLAYTITLE:Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive Changelog.

Die Versionsnummern sind wie folgt aufgebaut: [MajorVersion].[MinorVersion].[Revision]

- MajorVersion: Hauptversion der Sage

- MinorVersion: Unterversion der Sage

-Revision: Aktueller Entwicklungsstand der Software. Fortlaufende, sich erhöhende Nummer.

Es werden hier lediglich die Veränderungen zur Vorgänger-Version aufgelistet.

Sollte eine Version den Status "Beta" haben, behält sich HTK noch vor, Änderungen an dieser Version vorzunehmen und ein Update der selben Version zu veröffentlichen. Änderungen sind dann entsprechend noch im Changelog dokumentiert.

Den Entwicklungs-Hinweisen ist Beachtung zu schenken und diese sollen auch bei einem Update auf diese oder höhere Version Folge geleistet werden. Andernfalls könnte der Import nach dem Update nicht mehr wie gewünscht funktionieren.
{{{!}} class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
!Testumgebung und Freigabe (Sage-Version)
! Changelog
! Downloadlink
|-
|9.0.15
| 26.02.2026
|beta
|Erweiterung der AdressenCheck-Prozedur um den Parameter @isEK (dies muss bei einem Update, sofern eine abweichende "AdressenCheck"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 15|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.15.2-Setup.exe download]
|-
|9.0.14
| 02.01.2026
|stable
|
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 14|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.14.1-Setup.exe download]
|-
|9.0.13
| 29.08.2025
|stable
|Sage hat den internen Aufruf für Vorgangsrechnungen mit der 9.0.9 verändert. Ab Sage Version 9.0.9 ist das Modul Autorechnungen mit älteren Versionen des Dienstes inkompatibel.
|9.0.9 (auch kompatibel und freigegeben für 9.0.10)
|[[OmniBelegService:Releases Rev 13|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.13.2-Setup.exe download]
|-
|9.0.12
| 18.02.2025
|stable
|Erweiterung der Prozedur spOmniBelegService_InsertXMLAdressen um die Parameter A0_CMD_EU_Country und A0_CMD_Tax_Area (dies muss bei einem Update, sofern eine abweichende "InsertXMLAdressen"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.7 + 9.0.8
|[[OmniBelegService:Releases Rev 12|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.12-Setup.exe download]
|-
|9.0.11
| 28.08.2024
|stable
|Die Belege-Positionen Insert Prozedur wurde um den Parameter 'UseOLPrice' erweitert. (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.6 + 9.0.7 ( 9.0.7 Release auch kompatibel für 9.0.8)
|[[OmniBelegService:Releases Rev 11|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.11-Setup_OL907.exe download_9.0.7] [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.11-Setup_OL906.exe download_9.0.6]
|-
|9.0.10
| 08.07.2024
||stable
|unterschiedliche Setups für 9.0.6 & 9.0.7
Hinweis Bei Liveupdate auf 9.0.7 sind ältere Versionen höchstwahrscheinlich nicht mehr kompatibel
|9.0.6 + 9.0.7
|[[OmniBelegService:Releases Rev 10|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.10-Setup_OL907.exe download_9.0.7] [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.10-Setup_OL906.exe download_9.0.6]
|-
|9.0.9
| 20.02.2024
|stable
|
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 9|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.9-Setup.exe download]
|-
|9.0.8
| 04.12.2023
||stable
|Überarbeitung der Standard Prozedur ArtikelCheck (wg. Sage Varianten)
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 8|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.8-Setup.exe download]
|-
|9.0.7
|17.08.2023
||stable
|Hinweis: Sage-Version (Liveupdate-Stand) von mind. 9.0.5 benötigt.
|9.0.5
|[[OmniBelegService:Releases Rev 7|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.7-Setup.exe download]
|-
|9.0.6
| 31.07.2023
| -
|Status aufgrund der neuen Version nach kurzem Abstand nicht weiter verfolgt.
|9.0.4
|[[OmniBelegService:Releases Rev 6|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.6-Setup.exe download]
|-
|9.0.5
| 22.05.2023
|stable
| Erweiterung der Prozedur "spOmniBelegService_InsertXMLPosition" um den Parameter "Quantity Unit" (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
| -
|[[OmniBelegService:Releases Rev 5|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.5-Setup.exe download]
|-
|9.0.4
| 27.02.2023
|stable
|
| -
|[[OmniBelegService:Releases Rev 4|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.4-Setup.exe download]
{{!}}-
{{!}} 9.0.3
{{!}} 09.01.2023
{{!}} stable
{{!}}
| -
{{!}}
[[OmniBelegService:Releases Rev 3|changelog]]
{{!}}
[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.3-Setup.exe download ]
{{!}}-
{{!}} 9.0.2
{{!}} 08.12.2022
{{!}} stable
{{!}} 
| -
{{!}} [[OmniBelegService:Releases Rev 2{{!}}changelog]]
{{!}} [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.2-Setup.exe download]
{{!}}-
{{!}} 9.0.1
{{!}} 20.10.2022
{{!}} stable
{{!}}
 
| -
{{!}} [[OmniBelegService:Releases Rev 1{{!}}changelog]]*
{{!}} [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.1-Setup.exe download]
{{!}}}
<nowiki>*</nowiki>=Die erste Version erfasst Erweiterungen/Verbesserungen, welche sich seit dem letzten Beta Release Stand verändert haben. Weitere grundsätzliche Funktionen können entsprechend dem [[OmniBelegService:Handbuch{{!}}Handbuch]] entnommen werden.

OmniBelegService:Releases Rev 15

2026-03-10T15:03:29Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (Version 9.0.8, Kompatibel ab Sage LiveUpdate Stand 9.0.10) veröffentlicht, die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

==== weiteres: ====
'''02.03.2026 (Version 9.0.15.1):'''
* Es wurde ein Fehler korrigiert, dass DCMs nun auch wieder ausgeführt werden.
'''10.03.2026 (Version 9.0.15.2):'''
* Bei einer Neukundenanlage werden nun auch folgende Felder aus dem Vorlage-Kunden übernommen: ERechnungAusgabe, ERechnungHausbank, ERechnungGutschriftverfahren, ERechnungUBL
* Skript 90 liefert nun auch das Benutzerfeld USER_OBSLSErstellt aus.
* Autolieferscheine:Die Logik aus dem 14er Release wurde noch einmal angepasst. Bei einem erfolgreich erstellten Lieferschein werden nun die Feldwerte LetzterLSVersuch und LetzterLSVersuch Meldung geleert. Zusätzlich wird in die Auftragsbestätigung (und den Lieferschein) das Datum in OBSLSErstellt zurückgeschrieben, damit man erkennen kann wann genau der Lieferschein erstellt wurde.

OmniBelegService:Releases Rev 15

2026-03-10T15:03:09Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (Version 9.0.8, Kompatibel ab Sage LiveUpdate Stand 9.0.10) veröffentlicht, die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

==== weiteres: ====

* '''02.03.2026 (Version 9.0.15.1):'''
* Es wurde ein Fehler korrigiert, dass DCMs nun auch wieder ausgeführt werden.
* '''10.03.2026 (Version 9.0.15.2):'''
* Bei einer Neukundenanlage werden nun auch folgende Felder aus dem Vorlage-Kunden übernommen: ERechnungAusgabe, ERechnungHausbank, ERechnungGutschriftverfahren, ERechnungUBL
* Skript 90 liefert nun auch das Benutzerfeld USER_OBSLSErstellt aus.
* Autolieferscheine:Die Logik aus dem 14er Release wurde noch einmal angepasst. Bei einem erfolgreich erstellten Lieferschein werden nun die Feldwerte LetzterLSVersuch und LetzterLSVersuch Meldung geleert. Zusätzlich wird in die Auftragsbestätigung (und den Lieferschein) das Datum in OBSLSErstellt zurückgeschrieben, damit man erkennen kann wann genau der Lieferschein erstellt wurde.

OmniBelegService:Releases Rev 15

2026-03-10T14:49:34Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (Version 9.0.8, Kompatibel ab Sage LiveUpdate Stand 9.0.10) veröffentlicht, die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

==== weiteres: ====

* 02.03.2026 (Version 9.0.15.1): Es wurde ein Fehler korrigiert, dass DCMs nun auch wieder ausgeführt werden.
* 10.03.2026 (Version 9.0.15.2): 1. Bei einer Neukundenanlage werden nun auch folgende Felder aus dem Vorlage-Kunden übernommen: ERechnungAusgabe, ERechnungHausbank, ERechnungGutschriftverfahren, ERechnungUBL 2. Skript 90 liefert nun auch das Benutzerfeld USER_OBSLSErstellt aus. 3. Autolieferscheine:Die Logik aus dem 14er Release wurde noch einmal angepasst. Bei einem erfolgreich erstellten Lieferschein werden nun die Feldwerte LetzterLSVersuch und LetzterLSVersuch Meldung geleert. Zusätzlich wird in die Auftragsbestätigung (und den Lieferschein) das Datum in OBSLSErstellt zurückgeschrieben, damit man erkennen kann wann genau der Lieferschein erstellt wurde.

OmniBelegService:Releases

2026-03-02T10:58:09Z

MH:

{{DISPLAYTITLE:Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive Changelog.

Die Versionsnummern sind wie folgt aufgebaut: [MajorVersion].[MinorVersion].[Revision]

- MajorVersion: Hauptversion der Sage

- MinorVersion: Unterversion der Sage

-Revision: Aktueller Entwicklungsstand der Software. Fortlaufende, sich erhöhende Nummer.

Es werden hier lediglich die Veränderungen zur Vorgänger-Version aufgelistet.

Sollte eine Version den Status "Beta" haben, behält sich HTK noch vor, Änderungen an dieser Version vorzunehmen und ein Update der selben Version zu veröffentlichen. Änderungen sind dann entsprechend noch im Changelog dokumentiert.

Den Entwicklungs-Hinweisen ist Beachtung zu schenken und diese sollen auch bei einem Update auf diese oder höhere Version Folge geleistet werden. Andernfalls könnte der Import nach dem Update nicht mehr wie gewünscht funktionieren.
{{{!}} class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
!Testumgebung und Freigabe (Sage-Version)
! Changelog
! Downloadlink
|-
|9.0.15
| 26.02.2026
|beta
|Erweiterung der AdressenCheck-Prozedur um den Parameter @isEK (dies muss bei einem Update, sofern eine abweichende "AdressenCheck"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 15|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.15.1-Setup.exe download]
|-
|9.0.14
| 02.01.2026
|stable
|
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 14|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.14.1-Setup.exe download]
|-
|9.0.13
| 29.08.2025
|stable
|Sage hat den internen Aufruf für Vorgangsrechnungen mit der 9.0.9 verändert. Ab Sage Version 9.0.9 ist das Modul Autorechnungen mit älteren Versionen des Dienstes inkompatibel.
|9.0.9 (auch kompatibel und freigegeben für 9.0.10)
|[[OmniBelegService:Releases Rev 13|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.13.2-Setup.exe download]
|-
|9.0.12
| 18.02.2025
|stable
|Erweiterung der Prozedur spOmniBelegService_InsertXMLAdressen um die Parameter A0_CMD_EU_Country und A0_CMD_Tax_Area (dies muss bei einem Update, sofern eine abweichende "InsertXMLAdressen"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.7 + 9.0.8
|[[OmniBelegService:Releases Rev 12|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.12-Setup.exe download]
|-
|9.0.11
| 28.08.2024
|stable
|Die Belege-Positionen Insert Prozedur wurde um den Parameter 'UseOLPrice' erweitert. (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.6 + 9.0.7 ( 9.0.7 Release auch kompatibel für 9.0.8)
|[[OmniBelegService:Releases Rev 11|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.11-Setup_OL907.exe download_9.0.7] [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.11-Setup_OL906.exe download_9.0.6]
|-
|9.0.10
| 08.07.2024
||stable
|unterschiedliche Setups für 9.0.6 & 9.0.7
Hinweis Bei Liveupdate auf 9.0.7 sind ältere Versionen höchstwahrscheinlich nicht mehr kompatibel
|9.0.6 + 9.0.7
|[[OmniBelegService:Releases Rev 10|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.10-Setup_OL907.exe download_9.0.7] [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.10-Setup_OL906.exe download_9.0.6]
|-
|9.0.9
| 20.02.2024
|stable
|
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 9|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.9-Setup.exe download]
|-
|9.0.8
| 04.12.2023
||stable
|Überarbeitung der Standard Prozedur ArtikelCheck (wg. Sage Varianten)
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 8|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.8-Setup.exe download]
|-
|9.0.7
|17.08.2023
||stable
|Hinweis: Sage-Version (Liveupdate-Stand) von mind. 9.0.5 benötigt.
|9.0.5
|[[OmniBelegService:Releases Rev 7|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.7-Setup.exe download]
|-
|9.0.6
| 31.07.2023
| -
|Status aufgrund der neuen Version nach kurzem Abstand nicht weiter verfolgt.
|9.0.4
|[[OmniBelegService:Releases Rev 6|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.6-Setup.exe download]
|-
|9.0.5
| 22.05.2023
|stable
| Erweiterung der Prozedur "spOmniBelegService_InsertXMLPosition" um den Parameter "Quantity Unit" (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
| -
|[[OmniBelegService:Releases Rev 5|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.5-Setup.exe download]
|-
|9.0.4
| 27.02.2023
|stable
|
| -
|[[OmniBelegService:Releases Rev 4|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.4-Setup.exe download]
{{!}}-
{{!}} 9.0.3
{{!}} 09.01.2023
{{!}} stable
{{!}}
| -
{{!}}
[[OmniBelegService:Releases Rev 3|changelog]]
{{!}}
[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.3-Setup.exe download ]
{{!}}-
{{!}} 9.0.2
{{!}} 08.12.2022
{{!}} stable
{{!}} 
| -
{{!}} [[OmniBelegService:Releases Rev 2{{!}}changelog]]
{{!}} [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.2-Setup.exe download]
{{!}}-
{{!}} 9.0.1
{{!}} 20.10.2022
{{!}} stable
{{!}}
 
| -
{{!}} [[OmniBelegService:Releases Rev 1{{!}}changelog]]*
{{!}} [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.1-Setup.exe download]
{{!}}}
<nowiki>*</nowiki>=Die erste Version erfasst Erweiterungen/Verbesserungen, welche sich seit dem letzten Beta Release Stand verändert haben. Weitere grundsätzliche Funktionen können entsprechend dem [[OmniBelegService:Handbuch{{!}}Handbuch]] entnommen werden.

OmniBelegService:Releases Rev 15

2026-03-02T10:56:52Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (Version 9.0.8, Kompatibel ab Sage LiveUpdate Stand 9.0.10) veröffentlicht, die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

==== weiteres: ====

* 02.03.2026 (Version 9.0.15.1): Es wurde ein Fehler korrigiert, dass DCMs nun auch wieder ausgeführt werden.

OmniBelegService:Releases Rev 15

2026-03-02T10:56:38Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (Version 9.0.8, Kompatibel ab Sage LiveUpdate Stand 9.0.10) veröffentlicht, die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

==== weiteres: ====

* 02.03. (Version 9.0.15.1): Es wurde ein Fehler korrigiert, dass DCMs nun auch wieder ausgeführt werden.

OmniBelegService:Releases Rev 15

2026-03-02T10:56:24Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (Version 9.0.8, Kompatibel ab Sage LiveUpdate Stand 9.0.10) veröffentlicht, die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

==== weiteres: ====

* 02.03. (Version 9.0.15.1) Es wurde ein Fehler korrigiert, dass DCMs nun auch wieder ausgeführt werden.

OmniBelegService:Releases Rev 15

2026-02-26T16:56:51Z

MH:

OmniBelegService:Releases Rev 15

2026-02-26T16:55:50Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten (9.0.8) veröffentlicht die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

OmniBelegService:Releases Rev 15

2026-02-26T16:55:32Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und erstellt die Benutzerfeld USER_OBSLetzterLSVersuch und USER_OBSLetzterLSVersuchMeldung im Datentyp text, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.

==== sonstiges: ====

* Es wurde auch eine neue Version der OmniBelegService Metadaten veröffentlicht die aus dem Log heraus das Öffnen der EK-Belegerfassung & Lieferantenstamm erlaubt wenn EK-Belege importiert wurden. Ebenfalls wurde der Adhoc Filter beim Kundenstamm abgelöst sodass man ohne Umwege auch noch andere Kunden im Kundenstamm auswählen kann.

OmniBelegService:Releases

2026-02-26T16:48:34Z

MH:

{{DISPLAYTITLE:Releases}}

Hier finden Sie eine Auflistung der Release-Stände inklusive Changelog.

Die Versionsnummern sind wie folgt aufgebaut: [MajorVersion].[MinorVersion].[Revision]

- MajorVersion: Hauptversion der Sage

- MinorVersion: Unterversion der Sage

-Revision: Aktueller Entwicklungsstand der Software. Fortlaufende, sich erhöhende Nummer.

Es werden hier lediglich die Veränderungen zur Vorgänger-Version aufgelistet.

Sollte eine Version den Status "Beta" haben, behält sich HTK noch vor, Änderungen an dieser Version vorzunehmen und ein Update der selben Version zu veröffentlichen. Änderungen sind dann entsprechend noch im Changelog dokumentiert.

Den Entwicklungs-Hinweisen ist Beachtung zu schenken und diese sollen auch bei einem Update auf diese oder höhere Version Folge geleistet werden. Andernfalls könnte der Import nach dem Update nicht mehr wie gewünscht funktionieren.
{{{!}} class="wikitable"
! Version
! Erscheinungsdatum
! Status
! Entwicklungs-Hinweis
!Testumgebung und Freigabe (Sage-Version)
! Changelog
! Downloadlink
|-
|9.0.15
| 26.02.2026
|beta
|Erweiterung der AdressenCheck-Prozedur um den Parameter @isEK (dies muss bei einem Update, sofern eine abweichende "AdressenCheck"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 15|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.15.0-Setup.exe download]
|-
|9.0.14
| 02.01.2026
|stable
|
|9.0.9 + 9.0.10
|[[OmniBelegService:Releases Rev 14|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.14.1-Setup.exe download]
|-
|9.0.13
| 29.08.2025
|stable
|Sage hat den internen Aufruf für Vorgangsrechnungen mit der 9.0.9 verändert. Ab Sage Version 9.0.9 ist das Modul Autorechnungen mit älteren Versionen des Dienstes inkompatibel.
|9.0.9 (auch kompatibel und freigegeben für 9.0.10)
|[[OmniBelegService:Releases Rev 13|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.13.2-Setup.exe download]
|-
|9.0.12
| 18.02.2025
|stable
|Erweiterung der Prozedur spOmniBelegService_InsertXMLAdressen um die Parameter A0_CMD_EU_Country und A0_CMD_Tax_Area (dies muss bei einem Update, sofern eine abweichende "InsertXMLAdressen"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.7 + 9.0.8
|[[OmniBelegService:Releases Rev 12|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.12-Setup.exe download]
|-
|9.0.11
| 28.08.2024
|stable
|Die Belege-Positionen Insert Prozedur wurde um den Parameter 'UseOLPrice' erweitert. (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
|9.0.6 + 9.0.7 ( 9.0.7 Release auch kompatibel für 9.0.8)
|[[OmniBelegService:Releases Rev 11|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.11-Setup_OL907.exe download_9.0.7] [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.11-Setup_OL906.exe download_9.0.6]
|-
|9.0.10
| 08.07.2024
||stable
|unterschiedliche Setups für 9.0.6 & 9.0.7
Hinweis Bei Liveupdate auf 9.0.7 sind ältere Versionen höchstwahrscheinlich nicht mehr kompatibel
|9.0.6 + 9.0.7
|[[OmniBelegService:Releases Rev 10|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.10-Setup_OL907.exe download_9.0.7] [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.10-Setup_OL906.exe download_9.0.6]
|-
|9.0.9
| 20.02.2024
|stable
|
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 9|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.9-Setup.exe download]
|-
|9.0.8
| 04.12.2023
||stable
|Überarbeitung der Standard Prozedur ArtikelCheck (wg. Sage Varianten)
|9.0.5 + 9.0.6
|[[OmniBelegService:Releases Rev 8|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.8-Setup.exe download]
|-
|9.0.7
|17.08.2023
||stable
|Hinweis: Sage-Version (Liveupdate-Stand) von mind. 9.0.5 benötigt.
|9.0.5
|[[OmniBelegService:Releases Rev 7|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.7-Setup.exe download]
|-
|9.0.6
| 31.07.2023
| -
|Status aufgrund der neuen Version nach kurzem Abstand nicht weiter verfolgt.
|9.0.4
|[[OmniBelegService:Releases Rev 6|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.6-Setup.exe download]
|-
|9.0.5
| 22.05.2023
|stable
| Erweiterung der Prozedur "spOmniBelegService_InsertXMLPosition" um den Parameter "Quantity Unit" (dies muss bei einem Update, sofern eine abweichende "BelegePositionen-Insert"-Prozedur verwendet wird, nachgezogen werden.)
| -
|[[OmniBelegService:Releases Rev 5|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.5-Setup.exe download]
|-
|9.0.4
| 27.02.2023
|stable
|
| -
|[[OmniBelegService:Releases Rev 4|changelog]]
|[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.4-Setup.exe download]
{{!}}-
{{!}} 9.0.3
{{!}} 09.01.2023
{{!}} stable
{{!}}
| -
{{!}}
[[OmniBelegService:Releases Rev 3|changelog]]
{{!}}
[https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.3-Setup.exe download ]
{{!}}-
{{!}} 9.0.2
{{!}} 08.12.2022
{{!}} stable
{{!}} 
| -
{{!}} [[OmniBelegService:Releases Rev 2{{!}}changelog]]
{{!}} [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.2-Setup.exe download]
{{!}}-
{{!}} 9.0.1
{{!}} 20.10.2022
{{!}} stable
{{!}}
 
| -
{{!}} [[OmniBelegService:Releases Rev 1{{!}}changelog]]*
{{!}} [https://omniseller-ftp.de/OmniBelegService/Releases/OmniBelegService-9.0.1-Setup.exe download]
{{!}}}
<nowiki>*</nowiki>=Die erste Version erfasst Erweiterungen/Verbesserungen, welche sich seit dem letzten Beta Release Stand verändert haben. Weitere grundsätzliche Funktionen können entsprechend dem [[OmniBelegService:Handbuch{{!}}Handbuch]] entnommen werden.

OmniBelegService:Releases Rev 15

2026-02-26T16:47:24Z

MH:

OmniBelegService:Releases Rev 15

2026-02-26T14:30:39Z

MH:

=== Neuerungen, Fehlerbehebungen & Verbesserungen ===

==== Setup ====

===== Installationsskripte =====
*Skript 50: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 77: das Skript fängt nun auch potentielle BD-NULL Value Fehler ab in dem es nun auch einen leeren String als Standardwert definiert.
*Skript 80: Es wurde ein Fehler korrigiert, dass das Skript in einen Fehler gelaufen ist wenn es erneut ausgeführt wurde.
*Skript 85: Die Belegsuche wurde aus dem Code in eine eigene Prozedur ausgelagert und wird nun mit Skript 85 ausgeliefert.
*Skript 86: Erweiterung der Importformat-Konfigurationstabelle um die Spalte "StoredProcBelegCheck"
*Skript 87: Überarbeitung der Kundennummer-Ermittlungsprozedur. Es ist nun möglich, vorhandene Lücken der Kundennummern zu füllen oder auch die erste Nummer eines Nummernkreises zu setzen. Die Ermittlung der Kundennummern orientiert sich nun an den Kundenformat-Einstellungen des Sage Administrators.
*Skript 88: Die AdressenCheck-Prozedur wurde um den Parater @isEK erweitert und prüft nun auch die Adressen der Lieferanten bei einem EK-Import
*Skript 89: legt die globale Einstellung "POS_Texte2RTF" an.
*Skript 90: aktualisiert das ehemalige Skript 83 und ändert das Benutzerfeld USER_OBLetzterLSVersuch auf den Datentyp varchar um, da sonst in der Sage Oberfläche keine Uhrzeit des letzten Lieferschein Versuchs angezeigt wird. Ebenfalls wurde nun die Bezeichnungen der Benutzerfelder vereinheitlicht zu "letzter Versuch (Auto-LS)" & "letzter Versuch Info (Auto-LS)"

==== Konfiguration ====

* Die Prozedur "Beleg-Ermittlung" wurde zur Konfiguration in der Oberfläche im Tab "Prozeduren" hinzugefügt.
* Bei einem neuen Import-Format ist der Standard-Wert das Preset der Kundenanlage nun leer statt 'D'. Ein leeres Preset in der Konfiguration ist nun möglich und die Daten werden dann der Sage-Konfiguration entnommen.
* Bei einem neuen Importformat wird nun standardmäßig der Mandant aus dem Setup vorbelegt, wenn man die Werte von einem vorhandenen Importformat nicht übernimmt.
* Es wurde ein Fehler korrigiert, dass man bei einem neuen Importformat die Datei-Pfade nicht automatisch ergänzen lassen konnte, wenn man die Werte von einem vorhandenen Importformat nicht übernommen hat.
* im Reiter sonstiges kann nun ausgewählt werden, ob EK- statt VK-Belege angelegt werden sollen. Ebenfalls kann man dort nun auch die zu erstellenden EK-Belegart konfigurieren.
* die globale Einstellung "POS_Texte2RTF" wurde hinzugefügt

==== Dienst ====

===== Auftragsimport =====
*Die Felder Telefon, Mobil und Fax werden nun bei einer Adressen-Neuanlage nun ebenfalls auf Adress-Ebene gesetzt und nicht nur im Ansprechpartner.
*Die Ausgabe für FehlerCode 15 (kein Artikel gefunden) wurde optimiert und gibt in der Fehlermeldung nun auch die Sage Variante an.
*Die Ausgabe für FehlerCode 113 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
*Einführung von FehlerCode 139: "Die Anzahl der Gruppenüberschriften(x) ist ungleich der Menge an Zwischensummen(y). Eine Beleganlage ist nicht möglich." Diese Prüfung und der Fehlercode wurden eingeführt, um einen späteren Validierungsfehler des Belegs seitens Sage abzufangen und eine transparente Ausgabe zu ermöglichen.
*der Aufruf der neuen BelegCheck Prozedur wurde implementiert und ebenfalls die Einführung von FehlerCode 140: "Fehler bei der Ausführung der CheckBeleg Prozedur ({Prozedurname}): {Message}", wenn in der konfigurierbaren CheckBeleg Prozedur ein technischer Fehler auftritt. Die Prozedur prüft je nach Input entweder die Verkaufs- oder Einkaufsbelege nach dem jeweiligen Beleg.
*Der HTML Kopf- & Fußtext des Belegs, sowie Lang- & Dimensionstexte der Artikelpositionen (bei gesetzter globaler Einstellung "POS_Texte2RTF") werden nun beim Import (minimalistisch) in RTF konvertiert und abgespeichert, dass das ERP einfache Textelement wie Zeilenumbrüche, '''fett,''' ''kursiv'' oder ''unterstrichen'' erkennt und übernimmt.
*Einführung FehlerCode 54 "Beleg wird laut OrderChannel-Konfiguration ignoriert.", wenn in dem ORDER_CHANNEL Feld "ignore" steht.
*Es können nun mit entsprechender Konfiguration EK-Belege importiert werden.

===== Auto-Lieferscheine/Autorechnungen: =====
* Die Ausgabe für FehlerCode 201 (Mandanten-Login Fehler) wurde optimiert und gibt nun auch eine konkrete Fehlermeldung aus die wir von Sage erhalten.
* Die SQL-Abfrage für die Auto-Lieferscheine wurde leicht angepasst, dass das nun veränderte Datumsformat korrekt ausgewertet werden kann.