OmniBelegService:XMLFormatbeschreibung: Unterschied zwischen den Versionen

Aus HTK Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Zeile 98: Zeile 98:
|ORDER_TAX_AREA
|ORDER_TAX_AREA
|Besteuerung
|Besteuerung
|steuert u.A. die Besteuerung in der Sage. Auswahl "MERCHANT" (Inland), "EU" und "NONEU". Bei abweichendem Inhalt ist der Default "MERCHANT" (Inland)
|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
|ORDER_COUPON
Zeile 151: Zeile 151:
|ORDER_TAXATIONTYPE
|ORDER_TAXATIONTYPE
|Besteuerung
|Besteuerung
|übersteuert die durch ORDER_TAX_AREA ermittelte Besteuerung durch den hier eingetragenen Wert.
|ü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.
"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 als Default die Inland Besteuerung gesetzt.
 
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 dann auf Belegebene gesetzt.
|-
|-
|ORDER_DOCUMENTTYPE
|ORDER_DOCUMENTTYPE
Zeile 374: Zeile 375:
|EULand(Kto)
|EULand(Kto)
|setzt bei einer Kunden-Neuanlage im Kunden das EU Land, falls gefüllt
|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>
|<USER_XXXXX>

Version vom 19. Februar 2025, 10:18 Uhr


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 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, falls gefüllt
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 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:

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:

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
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
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:

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
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

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

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

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
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

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

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.

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

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

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

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

Beispiel1: Oxid eSales Bestell-XML

Beispiel2: komplexere XML Struktur mit unterschiedlichen Belege-Positionstypen nach einer XSL-Transformation

XML Schema Definition (XSD)