# 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](/docs/data-exchange/connectors/sage-100.md).

## 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](/docs/data-exchange/connectors/sage-100-installation.md#downloads); ältere Versionen setzen das Tagesdatum |
| `kennzeichen` | Belegtyp | Schlüssel für die Belegart — aus den [Belegarten](/docs/data-exchange/connectors/sage-100.md#belegart) |
| `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](/docs/data-exchange/connectors/sage-100.md#bestellungen-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](/docs/data-exchange/connectors/sage-100.md#version-der-workist-api-erweiterung). 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](/docs/data-exchange/connectors/sage-100-installation.md#downloads) 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](/docs/data-exchange/connectors/sage-100.md#belege-als-entwurf) eingeschaltet ist |
| `matchcode` | Belegkopf | Matchcode | Bis zu 50 Zeichen. Befüllt Workist nicht |
| `memo` | Belegkopf | Memo | Der [Hinweistext](/docs/data-exchange/connectors/sage-100.md#hinweistext-als-belegmemo) 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](/docs/master-data/quotes.md), je Artikelposition | Kopf: `belegjahr`, `belegnummer`, `belegdatum`, `a0Empfaenger`, `belegstatus`, `gueltigkeitsdauer`; Position: `position`, `artikelnummer`, `bezeichnung1`, `menge`, `mengeneinheit` – siehe [Offene Angebote](/docs/data-exchange/connectors/sage-100.md#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.

:::note Weitere Felder auf Anfrage
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.
:::