Sage 100 – Feldreferenz
Diese Seite führt im Detail auf, welche Felder Workist in den Verkaufsbeleg schreibt und welche Stammdatenfelder Workist aus Ihrer Sage 100 liest. Den Überblick über Einrichtung und Konfiguration finden Sie unter Sage 100 Konnektor.
Was Workist in den Verkaufsbeleg schreibt
Workist übergibt den Beleg als ein Objekt: Kopffelder, darin die Positionen. Aufgeführt sind ausschließlich die Felder, die Workist selbst befüllt. Was Sage 100 beim Anlegen selbst setzt – Belegnummer, Belegjahr, Netto- und Bruttobetrag sowie der Gesamtpreis der Position – steht hier bewusst nicht.
Belegkopf
| Feld | Sage 100 | Hinweis |
|---|---|---|
belegdatum | Belegdatum | Bestelldatum aus dem Dokument. Übernommen ab Version 9 der Erweiterung; ältere Versionen setzen das Tagesdatum |
kennzeichen | Belegtyp | Schlüssel für die Belegart — aus den Belegarten |
a0Konto | Kunde | Die Kundennummer ist ein Pflichtfeld für die Anlage des Belegs |
ansprechpartnerHandle | Ansprechpartner-Nummer | Ansprechpartnernummer des A0Konto |
referenznummer | Ihre Belegnummer | Referenznummer bzw. Ihre Belegnummer |
referenzzeichen | Ihr Zeichen | Ihr Zeichen |
liefertermin | Lieferdatum | Liefertermin für den Beleg |
zKDBezeichnung | Zahlungskondition | Bezeichnung der Zahlungskond — aus den Zahlungskonditionen |
projektnummer | Projektnummer | Projektnummer |
referenzBelegHandle | ReferenzBelegHandle | Bei einer Bestellung mit Angebotsbezug das Angebot (ab Version 9). Sage 100 führt beide Belege dann im selben Vorgang und zeigt das Angebot unter Beleg zu |
lieferbedingung | Lieferbedingung | Lieferbedingung (Incoterm) aus dem Dokument, ab Version 7. Muss in Ihrem Mandanten angelegt sein |
Adressfelder
Sage 100 führt am Verkaufsbeleg drei Adressrollen, erkennbar am Feldpräfix:
| Rolle | Präfix | Wo die Daten herkommen |
|---|---|---|
| Kunde (Auftraggeber) | a0 | Kundenstamm, über a0Konto |
| Lieferadresse | a1 | Lieferanschrift des Kunden – oder Freitext |
| Rechnungsadresse | a2 | Nur bei abweichender Anschrift: bestehendes Konto – oder Freitext |
Die Zuordnung zu einem hinterlegten Konto erfolgt über diese Felder:
| Feld | Sage 100 | Hinweis |
|---|---|---|
a1AdressNummer | Lieferanschrift | Lieferadresse des A0Konto |
a1AnsprechpartnerHandle | Ansprechpartner | Ansprechpartnernummer des A0Konto — aus den Ansprechpartnern der Lieferadresse |
a2Konto | Rechnungsanschrift | Pflichtfeld bei abw. Rechnungsadresse |
a2AnsprechpartnerHandle | Ansprechpartner | aus den Ansprechpartnern der Rechnungsadresse |
Alle übrigen Adressfelder sind in beiden Blöcken gleich aufgebaut und landen in den A1*- bzw.
A2*-Spalten von KHKVKBelege:
| Feld (Liefer- / Rechnungsadresse) | Sage 100 | Hinweis |
|---|---|---|
a1Anrede / a2Anrede | Anrede | |
a1Name1 / a2Name1 | Name | Pflichtfeld bei Freitext Lieferadressenangabe; Steuert Übernahme von sonstigen A1 Feldern; Nur wenn A1AdressNummer nicht verwendet |
a1Name2 / a2Name2 | Namenszusatz | |
a1Zusatz / a2Zusatz | Zusatz | |
a1Strasse / a2Strasse | Straße/Postfach | |
a1Postleitzahl / a2Postleitzahl | Postleitzahl | |
a1Ort / a2Ort | Ort | aus den Orten zu Land und PLZ |
a1Land / a2Land | Land |
Positionen
| Feld | Sage 100 | Hinweis |
|---|---|---|
artikelnummer | Artikel | Die Artikelnummer ist ein Pflichtfeld für die Artikelposition. Das Feld AuspraegungsHandle ist Schlüsselbestandteil zum Artikel (s. Feld AuspraegungsHandle) |
auspraegungsHandle | – | Für eine Artikelvariante wird hier der Schlüssel für die Variante laut Feld AuspraegungID im Artikel benutzt. Falls keine Artikelvariante benutzt wird, so ist das Feld optional oder mit 0 zu füllen |
bezeichnung | Bezeichnung | Artikelbezeichnung |
menge | Menge | Eingabe der Menge. Artikel mit Mengenberechnung (z. B. Länge x Breite x Höhe) werden aktuell nicht unterstützt. Bei Zubehörartikeln werden die zugehörigen Artikel nicht automatisch hinzugefügt |
mengeneinheit | ME | Mengeneinheit - Entweder Basismenge oder Verkaufsmenge — aus den Mengeneinheiten |
einzelpreis | Einzelpreis | Falls das Feld nicht mitgegeben wird, so wird der Wert über die Preisfindung automatisch ermittelt |
rabatt | Rabatt (%) | Eingabe des Positionsrabatts in Prozent |
liefertermin | Liefertermin | Liefertermin |
memo | Memo | Memo - internes Beschreibungsfeld |
Weitere Felder ab Version 9 der Erweiterung
Mit Version 9 der Workist API-Erweiterung nimmt Sage 100 die folgenden Felder zusätzlich an. Speicherstatus und Memo befüllt Workist, wenn die Verbindung auf Version 9 steht. Die übrigen befüllt Workist im Standard nicht – sie lassen sich als kundenspezifische Anpassung nutzen. In älteren Versionen der Erweiterung gibt es sie nicht.
| Feld | Ebene | Sage 100 | Hinweis |
|---|---|---|---|
speicherstatus | Belegkopf | Speicherstatus | 0 = gespeichert (Standard), 1 = geparkt, wenn Belege als Entwurf eingeschaltet ist |
matchcode | Belegkopf | Matchcode | Bis zu 50 Zeichen. Befüllt Workist nicht |
memo | Belegkopf | Memo | Der Hinweistext aus dem Dokument, wenn das Feld im Kanal eingerichtet ist. Das memo der Position (siehe oben) ist davon unabhängig |
kostenstelle | Belegkopf und Position | Kostenstelle | Leer oder eine in Ihrer Sage 100 angelegte Kostenstelle. Befüllt Workist nicht |
kostentraeger | Belegkopf und Position | Kostenträger | Leer oder ein in Ihrer Sage 100 angelegter Kostenträger. Befüllt Workist nicht |
Stammdaten, die Workist liest
Workist liest Stammdaten, um Angaben aus dem eingehenden Dokument gegen Ihr System aufzulösen. Diese Daten werden ausschließlich gelesen und nicht verändert. Aufgeführt ist nur, was Workist im Standard tatsächlich auswertet.
| Stammdaten in Sage 100 | Wird in Workist zu | Verwendete Felder |
|---|---|---|
| Kunden | Kunden | kto, matchcode, name1, name2, lieferStrasse, lieferPLZ, lieferOrt, lieferLand |
| Ansprechpartner | Ansprechpartner | kto, nummer, vorname, nachname, telefon, eMail |
| Lieferanschriften | Lieferadressen | kto, adresse, matchcode, name1, name2, strasse, pLZ, ort, land |
| Projekte | Rahmenverträge | kto, projektnummer, matchcode |
| Offene Angebote (ab Version 9) | Angebote, je Artikelposition | Kopf: belegjahr, belegnummer, belegdatum, a0Empfaenger, belegstatus, gueltigkeitsdauer; Position: position, artikelnummer, bezeichnung1, menge, mengeneinheit – siehe Offene Angebote |
| Artikel | Artikel und Umrechnungsfaktoren | siehe unten |
Artikel
Aus dem Artikelstamm liest Workist gezielt die folgenden Felder:
| Feld in Sage 100 | Verwendung in Workist |
|---|---|
Artikelnummer | Artikelnummer – die führende Kennung für die Zuordnung |
EANNummer | zweite Artikelkennung für die Erkennung |
Bezeichnung1 | Artikelbezeichnung |
Langtext, Bezeichnung2 | ergänzender Text, verbessert die Trefferqualität bei der Erkennung |
IstVerkaufsartikel | steuert, ob der Artikel als aktiv oder inaktiv geführt wird |
KalkulatorischerEK | Preis am Artikel |
Basismengeneinheit, Lagermengeneinheit, Verkaufsmengeneinheit, VerpackungseinheitVK | die zulässigen Bestelleinheiten des Artikels; die Verkaufsmengeneinheit zusätzlich als Verkaufseinheit |
UmrechnungsFaktorLME, UmrechnungsfaktorVK, UmrechnungsfaktorVPVK, UmrechnungsfaktorGP | rechnen die übrigen Einheiten auf die Basismengeneinheit um |
Die vier Mengeneinheiten werden gemeinsam ausgewertet: Sie ergeben die Liste der Einheiten, in denen bestellt werden kann, und über die Umrechnungsfaktoren die Menge in der Basiseinheit. So lässt sich eine Menge aus dem Dokument – etwa „2 Paletten" – in Ihre Basiseinheit übertragen.
Die Schnittstelle stellt darüber hinaus zahlreiche weitere Artikel- und Kundenfelder bereit, etwa Artikelgruppen, Gewichte, Steuerklassen oder die Herstellerartikelnummer. Im Standard werden sie nicht ausgewertet – eine Auswertung wäre eine kundenspezifische Anpassung.