OmniBelegService:XMLFormatbeschreibung

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

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.

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 ist der Default "MERCHANT" (Inland)
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
ORDER_TAXEU_COUNTRY	EULand	setzt das EU Land, falls gefüllt
ORDER_TAXATIONTYPE	Besteuerung	übersteuert die durch ORDER_TAX_AREA ermittelte Besteuerung durch den hier eingetragenen Wert. "steuerfrei", "inland", "EU mit UStID", "EU ohne UstID", "Verbundene Unternehmen", "Export/Import" als mögliche Werte. Sollte das Feld gefüllt sein aber von der Schreibweise auf keinen der Fälle passen wird als Default die Inland Besteuerung 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.)
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:

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, die angelegt wird, falls gefüllt Setzt auf BelegEbene ebenfalls den A0Matchcodefalls 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>

In DELIVERY_PARTY:

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, die angelegt wird, falls gefüllt Setzt auf BelegEbene ebenfalls den A0Matchcodefalls 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

CUSTOMER_MASTER_DATA

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
CUSTOMER_USTID
CUSTOMER_GROUP
CUSTOMER_PRICELIST_ID
CUSTOMER_PRICELIST_NAME
CUSTOMER_TYPE_OF_TRANSPORT
TAX_CODE
ADDRESS_GROUP
<USER_XXXXX>

CONTACT

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
CONTACT_NAME
PHONE (type=private)
PHONE (type=mobile)
FAX
EMAIL
DEPARTMENT
GROUP
POSITION
SALUTATION
SALUTATION_LETTER
<USER_XXXXX>

PAYMENTS

der Knoten PAYMENTS beinhaltet einen Knoten PAYMENT, dieser ist wie folgt aufgebaut:

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
ACCOUNT
TRANS_ID
PAYMENT_STATUS
PAYMENT_AMOUNT

ACCOUNT

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
HOLDER
BANK_NAME
BANK_COUNTRY
BANK_CODE
BANK_ACCOUNT
BANK_BIC
BANK_IBAN

ADDITIONAL_INFORMATION

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
BUSINESS_TRANSACTION_ID
ORDER_REFERENCE

ORDER_ITEM_LIST

ORDER_ITEM

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
POSTYPE
ORDER_POS_ID
STORNIERT
LINE_ITEM_ID
VARIANT_ID
STORAGE_AREA_NAME
ARTICLE_ID	-	siehe Detailbereich ARTICLE_ID
QUANTITY
ORDER_UNIT
DELIVERYDATE
ARTICLE_PRICE	-	siehe Detailbereich ARTICLE_PRICE
ADDITIONAL_INFORMATION	-	siehe Detailbereich ADDITIONAL_INFORMATION

ARTICLE_ID

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
SUPPLIER_AID	Artikelnummer
BUYER_AID
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

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
PRICE_AMOUNT
PRICE_LINE_AMOUNT
TAX
DISCOUNT_AMOUNT

ADDITIONAL_INFORMATION

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
BATCHES
SERIAL_NUMBERS

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.

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
DISCOUNT1	steuert ersten Beleg-Rabatt
DISCOUNT2	steuert zweiten Beleg-Rabatt
DISCOUNT3	steuert dritten Beleg-Rabatt

Werte-Felder für Beleg-Rabatte

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
DESCRIPTION	Name des Beleg-Rabatts
DISCOUNTPERCENT	prozentueller Wert des Beleg-Rabatts
DISCOUNTVALUE	fester Betrag des Beleg-Rabatts

ORDER_FIELDS

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
SALES_REPRESENTATIVE
CUSTOMER_TEMPLATE
CUSTOMER_OL_ID
YOUR_ORDER
YOUR_TOKEN
ORDER_MATCHCODE
BUSINESS_TRANSACTION_MATCHCODE
OL_PROJECT_ID
<USER_XXXXX>

ORDER_SUMMARY

XML-Feldname	Wert in Sage	Hinweise über mögliche Werte-Konfigurationen
TOTAL_ITEM_NUM
TOTAL_AMOUNT