OmniBelegService:XMLFormatbeschreibung: Unterschied zwischen den Versionen
MH (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
MH (Diskussion | Beiträge) |
||
(33 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
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 | |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 137: | Zeile 137: | ||
|- | |- | ||
|ORDER_TAX_CODE | |ORDER_TAX_CODE | ||
| | | - | ||
| | |aktuell keine Verwendung | ||
|- | |- | ||
|ORDER_LANGUAGE | |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 | |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 | |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 | |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 | |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 | |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 | |ADDITIONAL_INFORMATION | ||
Zeile 177: | Zeile 188: | ||
===== ADDRESS ===== | ===== ADDRESS ===== | ||
in BUYER_PARTY: | |||
{| class="wikitable" | {| class="wikitable" | ||
!XML-Feldname | !XML-Feldname | ||
Zeile 183: | Zeile 195: | ||
|- | |- | ||
|NAME | |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 | ||
| | |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 | ||
| | |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 | |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 | |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 | |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 | |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 | |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 | |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 | |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 | |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 | |HOMEPAGE | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|CUSTOMER_MASTER_DATA | |CUSTOMER_MASTER_DATA | ||
| - | | - | ||
| | |siehe Detailbereich CUSTOMER_MASTER_DATA | ||
|- | |- | ||
|CONTACT | |CONTACT | ||
| - | | - | ||
| | |siehe Detailbereich CONTACT | ||
|- | |- | ||
|<USER_XXXXX> | |<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. | |||
|} | |} | ||
Zeile 250: | Zeile 341: | ||
|- | |- | ||
|CUSTOMER_USTID | |CUSTOMER_USTID | ||
| | |EUUstID (Kto), | ||
| | EUUmsatzsteuerID | ||
|Setzt bei einem neuen Kunden die UmsatzsteuerID, | |||
Setzt auf Belegebene die EU-UmsatzsteuerID, falls gefüllt. | |||
|- | |- | ||
|CUSTOMER_GROUP | |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 | |CUSTOMER_PRICELIST_ID | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|CUSTOMER_PRICELIST_NAME | |CUSTOMER_PRICELIST_NAME | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|CUSTOMER_TYPE_OF_TRANSPORT | |CUSTOMER_TYPE_OF_TRANSPORT | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|TAX_CODE | |TAX_CODE | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|ADDRESS_GROUP | |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> | |<USER_XXXXX> | ||
| | |Userfelder Konto | ||
| | |Hier können diverse UserFelder für den Kunden (KHKKontokorrent) gesetzt werden. | ||
|} | |} | ||
Zeile 289: | Zeile 392: | ||
|- | |- | ||
|CONTACT_NAME | |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) | |PHONE (type=private) | ||
| | |Telefon (ASP) | ||
| | TelefonPrivat (ASP) | ||
|Setzt bei einer Ansprechpartner-Anlage das Telefon & Telefon (privat) | |||
|- | |- | ||
|PHONE (type=mobile) | |PHONE (type=mobile) | ||
| | |Mobilfunk (ASP) | ||
| | |Setzt bei einer Ansprechpartner-Anlage das Feld "Mobil" | ||
|- | |- | ||
|FAX | |FAX | ||
| | |Telefax (ASP) | ||
| | |Setzt bei einer Ansprechpartner-Anlage das Feld "Fax" | ||
|- | |- | ||
|EMAIL | |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 | |DEPARTMENT | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|GROUP | |GROUP | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|POSITION | |POSITION | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|SALUTATION | |SALUTATION | ||
| | |Anrede (ASP) | ||
| | |Setzt bei einer Ansprechpartner-Anlage das Feld "Anrede" | ||
|- | |- | ||
|SALUTATION_LETTER | |SALUTATION_LETTER | ||
| | |Briefanrede (ASP) | ||
| | |Setzt bei einer Ansprechpartner-Anlage das Feld "Briefanrede" | ||
|- | |- | ||
|<USER_XXXXX> | |<USER_XXXXX> | ||
| | |UserFelder Ansprechpartner | ||
| | |Hier können diverse UserFelder für den Ansprechpartner KHKAnsprechpartner gesetzt werden. | ||
|} | |} | ||
Zeile 341: | Zeile 452: | ||
|- | |- | ||
|ACCOUNT | |ACCOUNT | ||
| | | - | ||
| | |siehe Detailbereich ACCOUNT | ||
|- | |- | ||
|TRANS_ID | |TRANS_ID | ||
| | |USER_TransID | ||
| | |füllt Userfeld | ||
|- | |- | ||
|PAYMENT_STATUS | |PAYMENT_STATUS | ||
| | |USER_Paymentstatus | ||
| | |füllt Userfeld | ||
|- | |- | ||
|PAYMENT_AMOUNT | |PAYMENT_AMOUNT | ||
| | |USER_PaymentAmount | ||
| | |füllt Userfeld | ||
|} | |} | ||
Zeile 364: | Zeile 475: | ||
|- | |- | ||
|HOLDER | |HOLDER | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|BANK_NAME | |BANK_NAME | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|BANK_COUNTRY | |BANK_COUNTRY | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|BANK_CODE | |BANK_CODE | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|BANK_ACCOUNT | |BANK_ACCOUNT | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|BANK_BIC | |BANK_BIC | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|BANK_IBAN | |BANK_IBAN | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|} | |} | ||
Zeile 399: | Zeile 510: | ||
|- | |- | ||
|BUSINESS_TRANSACTION_ID | |BUSINESS_TRANSACTION_ID | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|ORDER_REFERENCE | |ORDER_REFERENCE | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|} | |} | ||
Zeile 416: | Zeile 527: | ||
|- | |- | ||
|POSTYPE | |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 | |ORDER_POS_ID | ||
| | |USER_OrderPosID | ||
| | |füllt Userfeld | ||
|- | |- | ||
|STORNIERT | |STORNIERT | ||
| | |USER_Storniert | ||
| | |füllt Userfeld | ||
|- | |- | ||
|LINE_ITEM_ID | |LINE_ITEM_ID | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage. Wird aber dennoch zur Reihenfolge der Positionen verwendet. | ||
|- | |- | ||
|VARIANT_ID | |VARIANT_ID | ||
| | |AuspraegungID | ||
| | |setzt die AuspraegungID der Position | ||
|- | |- | ||
|STORAGE_AREA_NAME | |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 | |ARTICLE_ID | ||
Zeile 444: | Zeile 563: | ||
|- | |- | ||
|QUANTITY | |QUANTITY | ||
| | |Menge | ||
| | |setzt die Menge der Position | ||
|- | |- | ||
|ORDER_UNIT | |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 | |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 | |ARTICLE_PRICE | ||
Zeile 462: | Zeile 582: | ||
| - | | - | ||
|siehe Detailbereich 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" | |||
|} | |} | ||
Zeile 472: | Zeile 609: | ||
|SUPPLIER_AID | |SUPPLIER_AID | ||
|Artikelnummer | |Artikelnummer | ||
| | |ermittelt anhand des Feldinhalt den Sage Artikel, beim Wert "0" wird anhand der DESCRIPTION_SHORT der Zuschlagsname ermittelt | ||
|- | |- | ||
|BUYER_AID | |BUYER_AID | ||
| | |USER_BuyerAID | ||
| | |füllt Userfeld, meist Verwendet als Referenzfeld für z.B. Marktplatz-Artikelnummer etc. | ||
|- | |- | ||
|DESCRIPTION_SHORT | |DESCRIPTION_SHORT | ||
Zeile 514: | Zeile 651: | ||
|- | |- | ||
|PRICE_AMOUNT | |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 | |PRICE_LINE_AMOUNT | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|TAX | |TAX | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|DISCOUNT_AMOUNT | |DISCOUNT_AMOUNT | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|} | |} | ||
Zeile 537: | Zeile 675: | ||
|- | |- | ||
|BATCHES | |BATCHES | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|- | |- | ||
|SERIAL_NUMBERS | |SERIAL_NUMBERS | ||
| | | - | ||
| | |aktuell keine Verwendung in der Sage | ||
|} | |} | ||
Zeile 554: | Zeile 692: | ||
|DISCOUNT1 | |DISCOUNT1 | ||
|steuert ersten Beleg-Rabatt | |steuert ersten Beleg-Rabatt | ||
| | |siehe Detailbereich "Werte-Felder für Beleg-Rabatte" | ||
|- | |- | ||
|DISCOUNT2 | |DISCOUNT2 | ||
|steuert zweiten Beleg-Rabatt | |steuert zweiten Beleg-Rabatt | ||
| | |siehe Detailbereich "Werte-Felder für Beleg-Rabatte" | ||
|- | |- | ||
|DISCOUNT3 | |DISCOUNT3 | ||
|steuert dritten Beleg-Rabatt | |steuert dritten Beleg-Rabatt | ||
| | |siehe Detailbereich "Werte-Felder für Beleg-Rabatte" | ||
|} | |} | ||
Zeile 572: | Zeile 710: | ||
|- | |- | ||
|DESCRIPTION | |DESCRIPTION | ||
| | |Rabatttext | ||
| | |setzt zu dem jeweiligen Rabatt den Rabatttext | ||
|- | |- | ||
|DISCOUNTPERCENT | |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 | |DISCOUNTVALUE | ||
| | |Rabatt | ||
| | HatAbsolutrabatt | ||
|setzt den Rabatt und definiert, dass der Rabatt ein AbsolutRabatt ist. | |||
|} | |} | ||
Zeile 591: | Zeile 732: | ||
|- | |- | ||
|SALES_REPRESENTATIVE | |SALES_REPRESENTATIVE | ||
| | | Vertreter | ||
| | |(ab Rev10) Setzt die Vertreternummer im Belegfuß. Es findet keine Prüfung statt, ob dieser Vertreter auch existiert. | ||
|- | |- | ||
|CUSTOMER_TEMPLATE | |CUSTOMER_TEMPLATE | ||
| | | - | ||
| | |(ab Rev10) Übersteuert den Vorlagenkunden aus der Konfiguration. Kundenneuanlage muss trotzdem in der Konfiguration aktiviert sein. | ||
|- | |- | ||
|CUSTOMER_OL_ID | |CUSTOMER_OL_ID | ||
| | |Adresse | ||
| | |Setzt das Auftraggeber Konto des zu importierenden Belegs | ||
|- | |- | ||
|YOUR_ORDER | |YOUR_ORDER | ||
| | |Referenznummer | ||
| | |Setzt die Referenznummer/Ihre Belegnummer auf Belegebene (falls gefüllt) | ||
|- | |- | ||
|YOUR_TOKEN | |YOUR_TOKEN | ||
| | |Referenzzeichen | ||
| | |Setzt das Referenzzeichen/Ihr Zeichen auf Belegebene (falls gefüllt) | ||
|- | |- | ||
|ORDER_MATCHCODE | |ORDER_MATCHCODE | ||
| | |Matchcode | ||
| | |Setzt den Belegmatchcode (falls gefüllt) | ||
|- | |- | ||
|BUSINESS_TRANSACTION_MATCHCODE | |BUSINESS_TRANSACTION_MATCHCODE | ||
| | |Hauptvorgangsmatchcode | ||
| | |Setzt den Hauptvorgangsmatchcode (falls gefüllt) | ||
|- | |- | ||
|OL_PROJECT_ID | |OL_PROJECT_ID | ||
| | | - | ||
| | |keine Verwendung in der Sage | ||
|- | |- | ||
|<USER_XXXXX> | |<USER_XXXXX> | ||
Zeile 634: | Zeile 775: | ||
|- | |- | ||
|TOTAL_ITEM_NUM | |TOTAL_ITEM_NUM | ||
| | | - | ||
| | |keine Verwendung in der Sage | ||
|- | |- | ||
|TOTAL_AMOUNT | |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)]] |
Aktuelle Version vom 19. Februar 2025, 10:23 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 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:
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(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 |
|
DESCRIPTION_SHORT2 | Bezeichnung2 |
|
DESCRIPTION_LONG | Langtext |
|
DESCRIPTION_DIMENSION | Dimensionstext |
|
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 |