OBS Wiki - Benutzerbeiträge [de]

FRMUP UB AUFTRAVERT

2026-09-22T10:12:11Z

Nimz: Weiterleitung nach OBS/Auftragsbearbeitung/Rahmenverträge erstellt

#REDIRECT [[OBS/Auftragsbearbeitung/Rahmenverträge]]

OBS/Kostenpflichtige Module/Fleet Management/SimpleClicksXML

2026-08-05T15:25:59Z

Nimz: /* Reiter Einstellungen */

{{kostenpflichtige Module}}
[https://www.fleetmanager.eu/ SimpleClicks] ist eine Software der Firma [https://sequisoft.com/#simpleclicks SequiSoft GmbH]. Mit "SimpleClicks XML" unterstützt OBS den Import der Zählerstände aus den XML-Dateien von SimpleClicks. Der direkte Zugriff per SOAP-Schnittstelle wird '''nicht''' unterstützt.
=Maske=
Die Eingabemaske für SimpleClicks XML sieht wie folgt aus:

[[image:Mps_maske_simpleclicksxml.jpg]]
==Kopf==
{|class="wikitable"
|+ Shoppflege / alternative Bezeichnung / Schlagworte
|-
! Feld !! Beschreibung
|- valign="top"
| Nummer|| Nummer der Schnittstelle. Wird automatisch gefüllt und dient zur internen Zuordnung und Identifikation.
|-valign="top"
| Fleet-Management Typ|| Typ der Schnittstelle. Werte für diese Schnittstelle '''docuFORM'''.
|}
==Reiter Einstellungen==
{|class="wikitable"
|+ Definitionen Daten
|-
! Feld !! Beschreibung
|- valign="top"
| Nur{{nb_space}}Vertragsgeräte || Häkchen gesetzt sorgt dafür, dass Daten nur zu Geräten übernommen werden, die einem Vertrag zugeordnet sind.
|- valign="top"
| Gerätestamm{{nb_space}}FM{{nb_hyphen}}Stammnummer{{nb_space}}setzen || Häkchen gesetzt sorgt dafür, dass im Import für gefundene Geräte (Datensatz Gerätestamm) das Häkchen ''FM-Gerät'' und die Schnittstelle als Importschnittstelle gesetzt wird. {{Hinweis|Theoretisch lassen sich Gerätedaten aus mehreren Quellen importieren (z. B. Geräteeigene E-Mails wie ''UTAX E-Mail'' aber gleichzeitig auch per "Managed Print Service"). Mit der Vorgabe einer Schnittstelle im Gerätestamm, werden nur noch Daten über die angegebene Schnittstelle importiert.}}
|- valign="top"
| erweiterte{{nb_space}}Gerätesuche || Die Geräte werden anhand der Seriennummer identifiziert. Standardmäßig muss die in der Datei gelieferte Seriennummer mit der Seriennummer im Gerätestamm übereinstimmen. Es gibt jedoch Lieferanten, bei denen die Seriennummer an verschiedenen Stellen nicht 100% identisch geliefert wird (z. B. mit "0" aufgefüllt vs. ohne "0"). Haben Sie solche Geräte in den Daten kann über diese Option eine erweiterte Suche aktiviert werden. OBS findet so auch Geräte, deren Seriennummern im Vergleich zur gelieferten Seriennummer die vollständige Angabe in eine der beiden Richtungen finden kann. Beispiel: Gerätestamm-Seriennummer: ABCD123456 Seriennummer in Daten:ABCD12345600 Hier stimmt der Anfang der gelieferten Seriennummer vollständig mit der Seriennummer aus dem Gerätestamm überein und würde mit dieser Option gefunden werden.{{Hinweis|Es werden nur eindeutige Treffer verwendet. Sollte z. B. noch eine Seriennummer ABCD1234560 im Gerätestamm existieren, so gäbe es zwei Treffer und das gemeldete Gerät wäre nicht eindeutig zu identifizieren.}}
|- valign="top"
| Zählerstände{{nb_space}}einlesen || Aktiviert im Import die Anlage von Zählerständen.
|}

{|class="wikitable"
|+ Typspezifische Einstellungen
|-
! Feld !! Beschreibung
|- valign="top"
| abw.{{nb_space}}Datei{{nb_hyphen}}Verzeichnis|| Der Import der Dateien erfolgt standardmäßig aus dem OBS-Verzeichnis "SimpleClicks" unter \data\fmimport. In diesem Feld können Sie ein weiteres Verzeichnis anlegen, falls die Dateien auf dem Server bzw. im lokalen Netzwerk vorliegen (z. B. durch den SimpleClicks-Client in dessen Arbeitsverzeichnis). Beim Import zieht OBS sich alle XML-Dateien, die mit "scCounters" beginnen, aus diesem Verzeichnis.{{Hinweis|Die Vorgabe "scCounters" gilt auch für den Import selbst! OBS wird die Dateien also nur verarbeiten, wenn die XML-Dateien mit dieser Bezeichnung beginnen.}}
|}

{|class="wikitable"
|+ Archive
|-
! Feld !! Beschreibung
|- valign="top"
| Archivierte{{nb_space}}Dateien{{nb_space}}löschen|| OBS löscht die die importierten Dateien nicht sofort, sondern legt diese in einem Archiv-Verzeichnis ab. So können später Importe geprüft oder neu ausgeführt werden. Damit dieses Archiv über die Zeit nicht übermäßig viele Dateien vorhält, können Sie hier die Löschbedingung definieren. Folgende Optionen stehen Ihnen zur Verfügung:
*;mit MPS-Zähler
:löscht die Dateien zusammen mit den MPS-Zählerständen. Diese werden standardmäßig nach 3 Jahren gelöscht (einstellbar in den [[OBS/Stammdaten/Programmparameter#E_-_Konfiguartion_Systemeinstellungen|System-Einstellungen]]).
*;maximal x Archive
:hält nur eine feste Anzahl an Archiven vor. Tragen Sie in '''x=''' ein, wie viele Archive beibehalten werden sollen. {{Hinweis|Es werden immer mindestens 5 Archive beibehalten!}}
*;älter als x Wochen
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Wochen zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es werden immer mindestens 2 Wochen beibehalten!}}
*;älter als x Monate
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Monate zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es wird immer mindestens 1 Monat beibehalten!}}
*;älter als x Jahre
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Jahre zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es wird immer mindestens 1 Jahr beibehalten!}}
|}

==Felder für Zählerstandsimport==
Die ''Reiter'' entsprechen den OBS-Zählern. Geben Sie hier im Feld ''Felder'' den jeweiligen Element-Namen ein, welcher für den entsprechenden OBS-Zähler übernommen werden soll. Mehrere Elemente sind mit Komma zu trennen. Die Werte aller angegebenen Elemente werden beim Import addiert.

OBS/Kostenpflichtige Module/Fleet Management/SimpleClicksXML

2026-08-05T12:56:05Z

Nimz: /* Maske */

{{kostenpflichtige Module}}
[https://www.fleetmanager.eu/ SimpleClicks] ist eine Software der Firma [https://sequisoft.com/#simpleclicks SequiSoft GmbH]. Mit "SimpleClicks XML" unterstützt OBS den Import der Zählerstände aus den XML-Dateien von SimpleClicks. Der direkte Zugriff per SOAP-Schnittstelle wird '''nicht''' unterstützt.
=Maske=
Die Eingabemaske für SimpleClicks XML sieht wie folgt aus:

[[image:Mps_maske_simpleclicksxml.jpg]]
==Kopf==
{|class="wikitable"
|+ Shoppflege / alternative Bezeichnung / Schlagworte
|-
! Feld !! Beschreibung
|- valign="top"
| Nummer|| Nummer der Schnittstelle. Wird automatisch gefüllt und dient zur internen Zuordnung und Identifikation.
|-valign="top"
| Fleet-Management Typ|| Typ der Schnittstelle. Werte für diese Schnittstelle '''docuFORM'''.
|}
==Reiter Einstellungen==
{|class="wikitable"
|+ Definitionen Daten
|-
! Feld !! Beschreibung
|- valign="top"
| Nur{{nb_space}}Vertragsgeräte || Häkchen gesetzt sorgt dafür, dass Daten nur zu Geräten übernommen werden, die einem Vertrag zugeordnet sind.
|- valign="top"
| Gerätestamm{{nb_space}}FM{{nb_hyphen}}Stammnummer{{nb_space}}setzen || Häkchen gesetzt sorgt dafür, dass im Import für gefundene Geräte (Datensatz Gerätestamm) das Häkchen ''FM-Gerät'' und die Schnittstelle als Importschnittstelle gesetzt wird. {{Hinweis|Theoretisch lassen sich Gerätedaten aus mehreren Quellen importieren (z. B. Geräteeigene E-Mails wie ''UTAX E-Mail'' aber gleichzeitig auch per "Managed Print Service"). Mit der Vorgabe einer Schnittstelle im Gerätestamm, werden nur noch Daten über die angegebene Schnittstelle importiert.}}
|- valign="top"
| erweiterte{{nb_space}}Gerätesuche || Die Geräte werden anhand der Seriennummer identifiziert. Standardmäßig muss die in der Datei gelieferte Seriennummer mit der Seriennummer im Gerätestamm übereinstimmen. Es gibt jedoch Lieferanten, bei denen die Seriennummer an verschiedenen Stellen nicht 100% identisch geliefert wird (z. B. mit "0" aufgefüllt vs. ohne "0"). Haben Sie solche Geräte in den Daten kann über diese Option eine erweiterte Suche aktiviert werden. OBS findet so auch Geräte, deren Seriennummern im Vergleich zur gelieferten Seriennummer die vollständige Angabe in eine der beiden Richtungen finden kann. Beispiel: Gerätestamm-Seriennummer: ABCD123456 Seriennummer in Daten:ABCD12345600 Hier stimmt der Anfang der gelieferten Seriennummer vollständig mit der Seriennummer aus dem Gerätestamm überein und würde mit dieser Option gefunden werden.{{Hinweis|Es werden nur eindeutige Treffer verwendet. Sollte z. B. noch eine Seriennummer ABCD1234560 im Gerätestamm existieren, so gäbe es zwei Treffer und das gemeldete Gerät wäre nicht eindeutig zu identifizieren.}}
|- valign="top"
| Zählerstände{{nb_space}}einlesen || Aktiviert im Import die Anlage von Zählerständen.
|}

{|class="wikitable"
|+ Typspezifische Einstellungen
|-
! Feld !! Beschreibung
|- valign="top"
| abw.{{nb_space}}Datei{{nb_hyphen}}Verzeichnis|| Der Import der Dateien erfolgt standardmäßig aus dem OBS-Verzeichnis "SimpleClicks" unter \data\fmimport. In diesem Feld können Sie ein weiteres Verzeichnis anlegen, falls die Dateien auf dem Server bzw. im lokalen Netzwerk vorliegen (z. B. durch den SimpleClicks-Client in dessen Arbeitsverzeichnis). Beim Import zieht OBS sich alle XML-Dateien, die mit "scCounters" beginnen, aus diesem Verzeichnis.{{Hinweis|Die Vorgabe "scCounters" gilt auch für den Import selbst! OBS wird die Dateien also nur verarbeiten, wenn die XML-Dateien mit dieser Bezeichnung beginnen.}}
|}

{|class="wikitable"
|+ Archive
|-
! Feld !! Beschreibung
|- valign="top"
| Archivierte{{nb_space}}Dateien{{nb_space}}löschen|| OBS löscht die die importierten Dateien nicht sofort, sondern legt diese in einem Archiv-Verzeichnis ab. So können später Importe geprüft oder neu ausgeführt werden. Damit dieses Archiv über die Zeit nicht übermäßig viele Dateien vorhält, können Sie hier die Löschbedingung definieren.Folgende Optionen stehen Ihnen zur verfügung:
*;mit MPS-Zähler
:löscht die Dateien zusammen mit den MPS-Zählerständen. Diese werden standardmäßig nach 3 Jahren gelöscht (einstellbar in den [[OBS/Stammdaten/Programmparameter#E_-_Konfiguartion_Systemeinstellungen|System-Einstellungen]]).
*;maximal x Archive
:hält nur eine feste Anzahl an Archiven vor. Tragen Sie in '''x=''' ein, wie viele Archive beibehalten werden sollen. {{Hinweis|Es werden immer mindestens 5 Archive beibehalten!}}
*;älter als x Wochen
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Wochen zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es werden immer mindestens 2 Wochen beibehalten!}}
*;älter als x Monate
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Monate zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es wird immer mindestens 1 Monat beibehalten!}}
*;älter als x Jahre
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Jahre zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es wird immer mindestens 1 Jahr beibehalten!}}
|}
==Felder für Zählerstandsimport==
Die ''Reiter'' entsprechen den OBS-Zählern. Geben Sie hier im Feld ''Felder'' den jeweiligen Element-Namen ein, welcher für den entsprechenden OBS-Zähler übernommen werden soll. Mehrere Elemente sind mit Komma zu trennen. Die Werte aller angegebenen Elemente werden beim Import addiert.

Datei:Mps maske simpleclicksxml.jpg

2026-08-05T12:55:54Z

Nimz:

OBS/Kostenpflichtige Module/Fleet Management/SimpleClicksXML

2026-08-05T12:54:18Z

Nimz: /* Stammdaten */

{{kostenpflichtige Module}}
[https://www.fleetmanager.eu/ SimpleClicks] ist eine Software der Firma [https://sequisoft.com/#simpleclicks SequiSoft GmbH]. Mit "SimpleClicks XML" unterstützt OBS den Import der Zählerstände aus den XML-Dateien von SimpleClicks. Der direkte Zugriff per SOAP-Schnittstelle wird '''nicht''' unterstützt.
=Maske=
Die Eingabemaske für SimpleClicks XML sieht wie folgt aus:

[[image:EditSimpleClicksXMLStamm.png]]
==Kopf==
{|class="wikitable"
|+ Shoppflege / alternative Bezeichnung / Schlagworte
|-
! Feld !! Beschreibung
|- valign="top"
| Nummer|| Nummer der Schnittstelle. Wird automatisch gefüllt und dient zur internen Zuordnung und Identifikation.
|-valign="top"
| Fleet-Management Typ|| Typ der Schnittstelle. Werte für diese Schnittstelle '''docuFORM'''.
|}
==Reiter Einstellungen==
{|class="wikitable"
|+ Definitionen Daten
|-
! Feld !! Beschreibung
|- valign="top"
| Nur{{nb_space}}Vertragsgeräte || Häkchen gesetzt sorgt dafür, dass Daten nur zu Geräten übernommen werden, die einem Vertrag zugeordnet sind.
|- valign="top"
| Gerätestamm{{nb_space}}FM{{nb_hyphen}}Stammnummer{{nb_space}}setzen || Häkchen gesetzt sorgt dafür, dass im Import für gefundene Geräte (Datensatz Gerätestamm) das Häkchen ''FM-Gerät'' und die Schnittstelle als Importschnittstelle gesetzt wird. {{Hinweis|Theoretisch lassen sich Gerätedaten aus mehreren Quellen importieren (z. B. Geräteeigene E-Mails wie ''UTAX E-Mail'' aber gleichzeitig auch per "Managed Print Service"). Mit der Vorgabe einer Schnittstelle im Gerätestamm, werden nur noch Daten über die angegebene Schnittstelle importiert.}}
|- valign="top"
| erweiterte{{nb_space}}Gerätesuche || Die Geräte werden anhand der Seriennummer identifiziert. Standardmäßig muss die in der Datei gelieferte Seriennummer mit der Seriennummer im Gerätestamm übereinstimmen. Es gibt jedoch Lieferanten, bei denen die Seriennummer an verschiedenen Stellen nicht 100% identisch geliefert wird (z. B. mit "0" aufgefüllt vs. ohne "0"). Haben Sie solche Geräte in den Daten kann über diese Option eine erweiterte Suche aktiviert werden. OBS findet so auch Geräte, deren Seriennummern im Vergleich zur gelieferten Seriennummer die vollständige Angabe in eine der beiden Richtungen finden kann. Beispiel: Gerätestamm-Seriennummer: ABCD123456 Seriennummer in Daten:ABCD12345600 Hier stimmt der Anfang der gelieferten Seriennummer vollständig mit der Seriennummer aus dem Gerätestamm überein und würde mit dieser Option gefunden werden.{{Hinweis|Es werden nur eindeutige Treffer verwendet. Sollte z. B. noch eine Seriennummer ABCD1234560 im Gerätestamm existieren, so gäbe es zwei Treffer und das gemeldete Gerät wäre nicht eindeutig zu identifizieren.}}
|- valign="top"
| Zählerstände{{nb_space}}einlesen || Aktiviert im Import die Anlage von Zählerständen.
|}

{|class="wikitable"
|+ Typspezifische Einstellungen
|-
! Feld !! Beschreibung
|- valign="top"
| abw.{{nb_space}}Datei{{nb_hyphen}}Verzeichnis|| Der Import der Dateien erfolgt standardmäßig aus dem OBS-Verzeichnis "SimpleClicks" unter \data\fmimport. In diesem Feld können Sie ein weiteres Verzeichnis anlegen, falls die Dateien auf dem Server bzw. im lokalen Netzwerk vorliegen (z. B. durch den SimpleClicks-Client in dessen Arbeitsverzeichnis). Beim Import zieht OBS sich alle XML-Dateien, die mit "scCounters" beginnen, aus diesem Verzeichnis.{{Hinweis|Die Vorgabe "scCounters" gilt auch für den Import selbst! OBS wird die Dateien also nur verarbeiten, wenn die XML-Dateien mit dieser Bezeichnung beginnen.}}
|}

{|class="wikitable"
|+ Archive
|-
! Feld !! Beschreibung
|- valign="top"
| Archivierte{{nb_space}}Dateien{{nb_space}}löschen|| OBS löscht die die importierten Dateien nicht sofort, sondern legt diese in einem Archiv-Verzeichnis ab. So können später Importe geprüft oder neu ausgeführt werden. Damit dieses Archiv über die Zeit nicht übermäßig viele Dateien vorhält, können Sie hier die Löschbedingung definieren.Folgende Optionen stehen Ihnen zur verfügung:
*;mit MPS-Zähler
:löscht die Dateien zusammen mit den MPS-Zählerständen. Diese werden standardmäßig nach 3 Jahren gelöscht (einstellbar in den [[OBS/Stammdaten/Programmparameter#E_-_Konfiguartion_Systemeinstellungen|System-Einstellungen]]).
*;maximal x Archive
:hält nur eine feste Anzahl an Archiven vor. Tragen Sie in '''x=''' ein, wie viele Archive beibehalten werden sollen. {{Hinweis|Es werden immer mindestens 5 Archive beibehalten!}}
*;älter als x Wochen
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Wochen zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es werden immer mindestens 2 Wochen beibehalten!}}
*;älter als x Monate
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Monate zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es wird immer mindestens 1 Monat beibehalten!}}
*;älter als x Jahre
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Jahre zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es wird immer mindestens 1 Jahr beibehalten!}}
|}
==Felder für Zählerstandsimport==
Die ''Reiter'' entsprechen den OBS-Zählern. Geben Sie hier im Feld ''Felder'' den jeweiligen Element-Namen ein, welcher für den entsprechenden OBS-Zähler übernommen werden soll. Mehrere Elemente sind mit Komma zu trennen. Die Werte aller angegebenen Elemente werden beim Import addiert.

OBS/Kostenpflichtige Module/Fleet Management/SimpleClicksXML

2026-08-05T12:54:08Z

Nimz: /* Stammdaten */

{{kostenpflichtige Module}}
[https://www.fleetmanager.eu/ SimpleClicks] ist eine Software der Firma [https://sequisoft.com/#simpleclicks SequiSoft GmbH]. Mit "SimpleClicks XML" unterstützt OBS den Import der Zählerstände aus den XML-Dateien von SimpleClicks. Der direkte Zugriff per SOAP-Schnittstelle wird '''nicht''' unterstützt.
=Stammdaten=
Die Eingabemaske für SimpleClicks XML sieht wie folgt aus:

[[image:EditSimpleClicksXMLStamm.png]]
==Kopf==
{|class="wikitable"
|+ Shoppflege / alternative Bezeichnung / Schlagworte
|-
! Feld !! Beschreibung
|- valign="top"
| Nummer|| Nummer der Schnittstelle. Wird automatisch gefüllt und dient zur internen Zuordnung und Identifikation.
|-valign="top"
| Fleet-Management Typ|| Typ der Schnittstelle. Werte für diese Schnittstelle '''docuFORM'''.
|}
==Reiter Einstellungen==
{|class="wikitable"
|+ Definitionen Daten
|-
! Feld !! Beschreibung
|- valign="top"
| Nur{{nb_space}}Vertragsgeräte || Häkchen gesetzt sorgt dafür, dass Daten nur zu Geräten übernommen werden, die einem Vertrag zugeordnet sind.
|- valign="top"
| Gerätestamm{{nb_space}}FM{{nb_hyphen}}Stammnummer{{nb_space}}setzen || Häkchen gesetzt sorgt dafür, dass im Import für gefundene Geräte (Datensatz Gerätestamm) das Häkchen ''FM-Gerät'' und die Schnittstelle als Importschnittstelle gesetzt wird. {{Hinweis|Theoretisch lassen sich Gerätedaten aus mehreren Quellen importieren (z. B. Geräteeigene E-Mails wie ''UTAX E-Mail'' aber gleichzeitig auch per "Managed Print Service"). Mit der Vorgabe einer Schnittstelle im Gerätestamm, werden nur noch Daten über die angegebene Schnittstelle importiert.}}
|- valign="top"
| erweiterte{{nb_space}}Gerätesuche || Die Geräte werden anhand der Seriennummer identifiziert. Standardmäßig muss die in der Datei gelieferte Seriennummer mit der Seriennummer im Gerätestamm übereinstimmen. Es gibt jedoch Lieferanten, bei denen die Seriennummer an verschiedenen Stellen nicht 100% identisch geliefert wird (z. B. mit "0" aufgefüllt vs. ohne "0"). Haben Sie solche Geräte in den Daten kann über diese Option eine erweiterte Suche aktiviert werden. OBS findet so auch Geräte, deren Seriennummern im Vergleich zur gelieferten Seriennummer die vollständige Angabe in eine der beiden Richtungen finden kann. Beispiel: Gerätestamm-Seriennummer: ABCD123456 Seriennummer in Daten:ABCD12345600 Hier stimmt der Anfang der gelieferten Seriennummer vollständig mit der Seriennummer aus dem Gerätestamm überein und würde mit dieser Option gefunden werden.{{Hinweis|Es werden nur eindeutige Treffer verwendet. Sollte z. B. noch eine Seriennummer ABCD1234560 im Gerätestamm existieren, so gäbe es zwei Treffer und das gemeldete Gerät wäre nicht eindeutig zu identifizieren.}}
|- valign="top"
| Zählerstände{{nb_space}}einlesen || Aktiviert im Import die Anlage von Zählerständen.
|}

{|class="wikitable"
|+ Typspezifische Einstellungen
|-
! Feld !! Beschreibung
|- valign="top"
| abw.{{nb_space}}Datei{{nb_hyphen}}Verzeichnis|| Der Import der Dateien erfolgt standardmäßig aus dem OBS-Verzeichnis "SimpleClicks" unter \data\fmimport. In diesem Feld können Sie ein weiteres Verzeichnis anlegen, falls die Dateien auf dem Server bzw. im lokalen Netzwerk vorliegen (z. B. durch den SimpleClicks-Client in dessen Arbeitsverzeichnis). Beim Import zieht OBS sich alle XML-Dateien, die mit "scCounters" beginnen, aus diesem Verzeichnis.{{Hinweis|Die Vorgabe "scCounters" gilt auch für den Import selbst! OBS wird die Dateien also nur verarbeiten, wenn die XML-Dateien mit dieser Bezeichnung beginnen.}}
|}

{|class="wikitable"
|+ Archive
|-
! Feld !! Beschreibung
|- valign="top"
| Archivierte{{nb_space}}Dateien{{nb_space}}löschen|| OBS löscht die die importierten Dateien nicht sofort, sondern legt diese in einem Archiv-Verzeichnis ab. So können später Importe geprüft oder neu ausgeführt werden. Damit dieses Archiv über die Zeit nicht übermäßig viele Dateien vorhält, können Sie hier die Löschbedingung definieren.Folgende Optionen stehen Ihnen zur verfügung:
*;mit MPS-Zähler
:löscht die Dateien zusammen mit den MPS-Zählerständen. Diese werden standardmäßig nach 3 Jahren gelöscht (einstellbar in den [[OBS/Stammdaten/Programmparameter#E_-_Konfiguartion_Systemeinstellungen|System-Einstellungen]]).
*;maximal x Archive
:hält nur eine feste Anzahl an Archiven vor. Tragen Sie in '''x=''' ein, wie viele Archive beibehalten werden sollen. {{Hinweis|Es werden immer mindestens 5 Archive beibehalten!}}
*;älter als x Wochen
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Wochen zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es werden immer mindestens 2 Wochen beibehalten!}}
*;älter als x Monate
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Monate zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es wird immer mindestens 1 Monat beibehalten!}}
*;älter als x Jahre
:hält eine variable Anzahl an Archiven vor. Die Löschung erfolgt nach Alter der Dateien. Tragen Sie in '''x=''' ein, wie viele Jahre zurück Sie die Dateien vorhalten möchten. {{Hinweis|Es wird immer mindestens 1 Jahr beibehalten!}}
|}
==Felder für Zählerstandsimport==
Die ''Reiter'' entsprechen den OBS-Zählern. Geben Sie hier im Feld ''Felder'' den jeweiligen Element-Namen ein, welcher für den entsprechenden OBS-Zähler übernommen werden soll. Mehrere Elemente sind mit Komma zu trennen. Die Werte aller angegebenen Elemente werden beim Import addiert.

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-29T12:41:31Z

Nimz: /* Weitere Funktionen (Artikel F10) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Artikel{{nb_space}}inaktiv|| Im Artikelstamm ist das Häkchen "Inaktiv" gesetzt. Bei eigenen Artikeln ist dies ebenfalls abhängig von der Pflege-Einstellung (Allgemein und Lagerbezogen).
|-valign="top"
| Nicht{{nb_space}}lieferbar|| Abhängig von der Pflege (Lieferantenbezogen oder eigener Artikel ohne Lieferantenbezug) ist entweder kein oder der Lieferantbezogene EK-Eintrag als "nicht lieferbar" markiert.
|-valign="top"
| Nicht{{nb_space}}für{{nb_space}}Shop{{nb_space}}freigegeben|| Artikel wurde (noch) nicht in die Liste der Shop-Artikel übernommen. Diese Liste erstellt OBS während des Preisexports automatisch auf Basis der Einstellungen in den Shop-Lager und Definitionen eigener Artikel. Sollte ein Artikel fehlen, ist entweder die Übernahme noch nicht ausgeführt wurden oder es fehlt ein benötigter Eintrag in den EK-Lieferanten oder die Freigabe als eigener Artikel.
|-valign="top"
| Kein{{nb_space}}Matching|| Kann passieren, wenn sich z. B. eine Referenznummer wie die Bestellnummer ändert und OBS die Daten nicht mehr miteinander verknüpfen kann.
|-valign="top"
| Vom{{nb_space}}Shop{{nb_space}}als{{nb_space}}fehlend{{nb_space}}gemeldet|| OBS hat für diesen Artikel (Referenz ist Lager + Referenznummer) in der Vergangenheit einen Preis übertragen. Die API hat den Preis jedoch nicht angelegt mit dem Grund, dass der Artikel nicht im Shop vorhanden ist. Der Artikel wird dann für das Lager von der Pflege ausgeschlossen. Ändern z. B. Artikel die Lagerzugehörigkeit (z. B. Zentrallager zu Außenlager) oder Artikel kommen früher über die Artikelpflege ins OBS, kann es zu diesem Problem kommen. Mit {{Key|F6 Check}} können Sie den Status prüfen lassen. Kann der Artikel darüber gefunden werden, aktiviert OBS die pflege wieder.
|-valign="top"
| Menge{{nb_space}}<={{nb_space}}0|| Die Menge muss für eine gülige Definition einen positiven Wert haben.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}0|| Preiseinträge mit 0 werden von der API gelöscht. Entsprechende VK-Preise werden von OBS daher im Vorfeld bereits abgelehnt.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}EK|| Mit der Einstellung '''Export.Preise.Preis.VK.Check''' kann die Ertragsprüfung aktiviert werden. Es werden dann nur noch Preise übertragen, deren VK größer ist als der EK. Einzige Ausnahme sind Preislisten mit dem Häkchen '''Preisgarantie'''. Für diese Preislisten werden VK-Preise immer übertragen, sofern kein anderer Grund (z. B. VK ist 0) zur Ablehnung vorhanden ist.
|}

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz für die Verwendung in {{Key|F6 Check}} oder {{Key|F7 Zurück}}
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|-valign="top"
| {{Key|F7 Zurück}}|| Setzt den aktuellen oder die markierten Preiseinträge zurück, so dass eine erneute Übertragung stattfindet.
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf weitere Funktionen der Liste.
|}

===Weitere Funktionen (Artikel F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A{{nb_space}}Artikelstatus{{nb_space}}Massenprüfung|| Führt die Statusprüfung ({{Key|F6 Check}}) für für eine gewählte Gruppe von Artikeln der Preisliste aus. Gewählt werden kann zwischen:
*Vorhandene
*Fehlende
*Alle
{{Achtung|Diese Funktionalität ist für personenbezogene Preislisten mit wenigen Hundert Artikel gedacht. Bei größeren Preislisten kann die Abfrage entsprechend lange dauern!}}
|-valign="top"
| D{{nb_space}}Datenabgleich{{nb_space}}mit{{nb_space}}brShop24{{nb_space}}API|| Fragt die Preisdaten zur Preisliste über die API ab und zeigt das Ergebnis in Spalte ''D'' mit Kürzeln an. F = Preis fehlt, sollte aber vorhanden sein V = Preis vorhanden, sollte aber gelöscht sein P = Preis ist vorhanden, jedoch abweichend{{Hinweis|Steht aktuell nur Benutzern mit Administratorlevel 9 für Shop-Schnittstellen zur Verfügung!}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preis|| Aufruf der Job-Protokolle für den Preiseintrag.{{Hinweis|Für alte Preisexporte fehlt hier die Verknüpfung in den Protokolldaten. Diese können daher nicht geladen werden.}}
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-29T12:41:14Z

Nimz: /* Weitere Funktionen (Artikel F10) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Artikel{{nb_space}}inaktiv|| Im Artikelstamm ist das Häkchen "Inaktiv" gesetzt. Bei eigenen Artikeln ist dies ebenfalls abhängig von der Pflege-Einstellung (Allgemein und Lagerbezogen).
|-valign="top"
| Nicht{{nb_space}}lieferbar|| Abhängig von der Pflege (Lieferantenbezogen oder eigener Artikel ohne Lieferantenbezug) ist entweder kein oder der Lieferantbezogene EK-Eintrag als "nicht lieferbar" markiert.
|-valign="top"
| Nicht{{nb_space}}für{{nb_space}}Shop{{nb_space}}freigegeben|| Artikel wurde (noch) nicht in die Liste der Shop-Artikel übernommen. Diese Liste erstellt OBS während des Preisexports automatisch auf Basis der Einstellungen in den Shop-Lager und Definitionen eigener Artikel. Sollte ein Artikel fehlen, ist entweder die Übernahme noch nicht ausgeführt wurden oder es fehlt ein benötigter Eintrag in den EK-Lieferanten oder die Freigabe als eigener Artikel.
|-valign="top"
| Kein{{nb_space}}Matching|| Kann passieren, wenn sich z. B. eine Referenznummer wie die Bestellnummer ändert und OBS die Daten nicht mehr miteinander verknüpfen kann.
|-valign="top"
| Vom{{nb_space}}Shop{{nb_space}}als{{nb_space}}fehlend{{nb_space}}gemeldet|| OBS hat für diesen Artikel (Referenz ist Lager + Referenznummer) in der Vergangenheit einen Preis übertragen. Die API hat den Preis jedoch nicht angelegt mit dem Grund, dass der Artikel nicht im Shop vorhanden ist. Der Artikel wird dann für das Lager von der Pflege ausgeschlossen. Ändern z. B. Artikel die Lagerzugehörigkeit (z. B. Zentrallager zu Außenlager) oder Artikel kommen früher über die Artikelpflege ins OBS, kann es zu diesem Problem kommen. Mit {{Key|F6 Check}} können Sie den Status prüfen lassen. Kann der Artikel darüber gefunden werden, aktiviert OBS die pflege wieder.
|-valign="top"
| Menge{{nb_space}}<={{nb_space}}0|| Die Menge muss für eine gülige Definition einen positiven Wert haben.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}0|| Preiseinträge mit 0 werden von der API gelöscht. Entsprechende VK-Preise werden von OBS daher im Vorfeld bereits abgelehnt.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}EK|| Mit der Einstellung '''Export.Preise.Preis.VK.Check''' kann die Ertragsprüfung aktiviert werden. Es werden dann nur noch Preise übertragen, deren VK größer ist als der EK. Einzige Ausnahme sind Preislisten mit dem Häkchen '''Preisgarantie'''. Für diese Preislisten werden VK-Preise immer übertragen, sofern kein anderer Grund (z. B. VK ist 0) zur Ablehnung vorhanden ist.
|}

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz für die Verwendung in {{Key|F6 Check}} oder {{Key|F7 Zurück}}
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|-valign="top"
| {{Key|F7 Zurück}}|| Setzt den aktuellen oder die markierten Preiseinträge zurück, so dass eine erneute Übertragung stattfindet.
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf weitere Funktionen der Liste.
|}

===Weitere Funktionen (Artikel F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A{{nb_space}}Artikelstatus{{nb_space}}Massenprüfung|| Führt die Statusprüfung ({{Key|F6 Check}}) für für eine gewählte Gruppe von Artikeln der Preisliste aus. Gewählt werden kann zwischen:
*Vorhandene
*Fehlende
*Alle
{{Achtung|Diese Funktionalität ist für personenbezogene Preislisten mit wenigen Hundert Artikel gedacht. Bei größeren Preislisten kann die Abfrage entsprechend lange dauern!}}
|-valign="top"
| D{{nb_space}}Datenabgleich{{nb_space}}mit{{nb_space}}brShop24{{nb_space}}API|| Fragt die Preisdaten zur Preisliste über die API ab und zeigt das Ergebnis in Spalte ''D'' mit Kürzeln an. F = Preis fehlt, sollte aber vorhanden sein F = Preis vorhanden, sollte aber gelöscht sein P = Preis ist vorhanden, jedoch abweichend{{Hinweis|Steht aktuell nur Benutzern mit Administratorlevel 9 für Shop-Schnittstellen zur Verfügung!}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preis|| Aufruf der Job-Protokolle für den Preiseintrag.{{Hinweis|Für alte Preisexporte fehlt hier die Verknüpfung in den Protokolldaten. Diese können daher nicht geladen werden.}}
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-29T11:37:49Z

Nimz: /* Tasten und Schaltflächen (Artikel) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Artikel{{nb_space}}inaktiv|| Im Artikelstamm ist das Häkchen "Inaktiv" gesetzt. Bei eigenen Artikeln ist dies ebenfalls abhängig von der Pflege-Einstellung (Allgemein und Lagerbezogen).
|-valign="top"
| Nicht{{nb_space}}lieferbar|| Abhängig von der Pflege (Lieferantenbezogen oder eigener Artikel ohne Lieferantenbezug) ist entweder kein oder der Lieferantbezogene EK-Eintrag als "nicht lieferbar" markiert.
|-valign="top"
| Nicht{{nb_space}}für{{nb_space}}Shop{{nb_space}}freigegeben|| Artikel wurde (noch) nicht in die Liste der Shop-Artikel übernommen. Diese Liste erstellt OBS während des Preisexports automatisch auf Basis der Einstellungen in den Shop-Lager und Definitionen eigener Artikel. Sollte ein Artikel fehlen, ist entweder die Übernahme noch nicht ausgeführt wurden oder es fehlt ein benötigter Eintrag in den EK-Lieferanten oder die Freigabe als eigener Artikel.
|-valign="top"
| Kein{{nb_space}}Matching|| Kann passieren, wenn sich z. B. eine Referenznummer wie die Bestellnummer ändert und OBS die Daten nicht mehr miteinander verknüpfen kann.
|-valign="top"
| Vom{{nb_space}}Shop{{nb_space}}als{{nb_space}}fehlend{{nb_space}}gemeldet|| OBS hat für diesen Artikel (Referenz ist Lager + Referenznummer) in der Vergangenheit einen Preis übertragen. Die API hat den Preis jedoch nicht angelegt mit dem Grund, dass der Artikel nicht im Shop vorhanden ist. Der Artikel wird dann für das Lager von der Pflege ausgeschlossen. Ändern z. B. Artikel die Lagerzugehörigkeit (z. B. Zentrallager zu Außenlager) oder Artikel kommen früher über die Artikelpflege ins OBS, kann es zu diesem Problem kommen. Mit {{Key|F6 Check}} können Sie den Status prüfen lassen. Kann der Artikel darüber gefunden werden, aktiviert OBS die pflege wieder.
|-valign="top"
| Menge{{nb_space}}<={{nb_space}}0|| Die Menge muss für eine gülige Definition einen positiven Wert haben.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}0|| Preiseinträge mit 0 werden von der API gelöscht. Entsprechende VK-Preise werden von OBS daher im Vorfeld bereits abgelehnt.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}EK|| Mit der Einstellung '''Export.Preise.Preis.VK.Check''' kann die Ertragsprüfung aktiviert werden. Es werden dann nur noch Preise übertragen, deren VK größer ist als der EK. Einzige Ausnahme sind Preislisten mit dem Häkchen '''Preisgarantie'''. Für diese Preislisten werden VK-Preise immer übertragen, sofern kein anderer Grund (z. B. VK ist 0) zur Ablehnung vorhanden ist.
|}

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz für die Verwendung in {{Key|F6 Check}} oder {{Key|F7 Zurück}}
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|-valign="top"
| {{Key|F7 Zurück}}|| Setzt den aktuellen oder die markierten Preiseinträge zurück, so dass eine erneute Übertragung stattfindet.
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf weitere Funktionen der Liste.
|}

===Weitere Funktionen (Artikel F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A{{nb_space}}Artikelstatus{{nb_space}}Massenprüfung|| Führt die Statusprüfung aus {{Key|F6 Check}} für alle Artikel der Preisliste aus.{{Achtung|Diese Funktionalität ist für personenbezogene Preislisten mit wenigen Hundert Artikel gedacht. Bei größeren Preislisten kann die Abfrage entsprechend lange dauern!}}
|-valign="top"
| D{{nb_space}}Datenabgleich{{nb_space}}mit{{nb_space}}brShop24{{nb_space}}API|| Fragt die Preisdaten zur Preisliste über die API ab und zeigt das Ergebnis in Spalte ''D'' mit Kürzeln an. F = Preis fehlt, sollte aber vorhanden sein F = Preis vorhanden, sollte aber gelöscht sein P = Preis ist vorhanden, jedoch abweichend{{Hinweis|Steht aktuell nur Benutzern mit Administratorlevel 9 für Shop-Schnittstellen zur Verfügung!}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preis|| Aufruf der Job-Protokolle für den Preiseintrag.{{Hinweis|Für alte Preisexporte fehlt hier die Verknüpfung in den Protokolldaten. Diese können daher nicht geladen werden.}}
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-29T11:37:31Z

Nimz: /* Tasten und Schaltflächen (Artikel) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Artikel{{nb_space}}inaktiv|| Im Artikelstamm ist das Häkchen "Inaktiv" gesetzt. Bei eigenen Artikeln ist dies ebenfalls abhängig von der Pflege-Einstellung (Allgemein und Lagerbezogen).
|-valign="top"
| Nicht{{nb_space}}lieferbar|| Abhängig von der Pflege (Lieferantenbezogen oder eigener Artikel ohne Lieferantenbezug) ist entweder kein oder der Lieferantbezogene EK-Eintrag als "nicht lieferbar" markiert.
|-valign="top"
| Nicht{{nb_space}}für{{nb_space}}Shop{{nb_space}}freigegeben|| Artikel wurde (noch) nicht in die Liste der Shop-Artikel übernommen. Diese Liste erstellt OBS während des Preisexports automatisch auf Basis der Einstellungen in den Shop-Lager und Definitionen eigener Artikel. Sollte ein Artikel fehlen, ist entweder die Übernahme noch nicht ausgeführt wurden oder es fehlt ein benötigter Eintrag in den EK-Lieferanten oder die Freigabe als eigener Artikel.
|-valign="top"
| Kein{{nb_space}}Matching|| Kann passieren, wenn sich z. B. eine Referenznummer wie die Bestellnummer ändert und OBS die Daten nicht mehr miteinander verknüpfen kann.
|-valign="top"
| Vom{{nb_space}}Shop{{nb_space}}als{{nb_space}}fehlend{{nb_space}}gemeldet|| OBS hat für diesen Artikel (Referenz ist Lager + Referenznummer) in der Vergangenheit einen Preis übertragen. Die API hat den Preis jedoch nicht angelegt mit dem Grund, dass der Artikel nicht im Shop vorhanden ist. Der Artikel wird dann für das Lager von der Pflege ausgeschlossen. Ändern z. B. Artikel die Lagerzugehörigkeit (z. B. Zentrallager zu Außenlager) oder Artikel kommen früher über die Artikelpflege ins OBS, kann es zu diesem Problem kommen. Mit {{Key|F6 Check}} können Sie den Status prüfen lassen. Kann der Artikel darüber gefunden werden, aktiviert OBS die pflege wieder.
|-valign="top"
| Menge{{nb_space}}<={{nb_space}}0|| Die Menge muss für eine gülige Definition einen positiven Wert haben.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}0|| Preiseinträge mit 0 werden von der API gelöscht. Entsprechende VK-Preise werden von OBS daher im Vorfeld bereits abgelehnt.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}EK|| Mit der Einstellung '''Export.Preise.Preis.VK.Check''' kann die Ertragsprüfung aktiviert werden. Es werden dann nur noch Preise übertragen, deren VK größer ist als der EK. Einzige Ausnahme sind Preislisten mit dem Häkchen '''Preisgarantie'''. Für diese Preislisten werden VK-Preise immer übertragen, sofern kein anderer Grund (z. B. VK ist 0) zur Ablehnung vorhanden ist.
|}

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz für die Verwendung in {{Key|F6 Check}} oder {{Key|F7 Zurück}}
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|-valign="top"
| {{Key|F7 Zurück}}|| Setzt den aktuellen oder die markierten Preiseinträge zurück, so dass eine erneute Übertragung stattfindet.
| {{Key|F10 Weit.}}|| Zugriff auf weitere Funktionen der Liste.
|}

===Weitere Funktionen (Artikel F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A{{nb_space}}Artikelstatus{{nb_space}}Massenprüfung|| Führt die Statusprüfung aus {{Key|F6 Check}} für alle Artikel der Preisliste aus.{{Achtung|Diese Funktionalität ist für personenbezogene Preislisten mit wenigen Hundert Artikel gedacht. Bei größeren Preislisten kann die Abfrage entsprechend lange dauern!}}
|-valign="top"
| D{{nb_space}}Datenabgleich{{nb_space}}mit{{nb_space}}brShop24{{nb_space}}API|| Fragt die Preisdaten zur Preisliste über die API ab und zeigt das Ergebnis in Spalte ''D'' mit Kürzeln an. F = Preis fehlt, sollte aber vorhanden sein F = Preis vorhanden, sollte aber gelöscht sein P = Preis ist vorhanden, jedoch abweichend{{Hinweis|Steht aktuell nur Benutzern mit Administratorlevel 9 für Shop-Schnittstellen zur Verfügung!}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preis|| Aufruf der Job-Protokolle für den Preiseintrag.{{Hinweis|Für alte Preisexporte fehlt hier die Verknüpfung in den Protokolldaten. Diese können daher nicht geladen werden.}}
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T10:16:29Z

Nimz: /* Tasten und Schaltflächen (Artikel) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Artikel{{nb_space}}inaktiv|| Im Artikelstamm ist das Häkchen "Inaktiv" gesetzt. Bei eigenen Artikeln ist dies ebenfalls abhängig von der Pflege-Einstellung (Allgemein und Lagerbezogen).
|-valign="top"
| Nicht{{nb_space}}lieferbar|| Abhängig von der Pflege (Lieferantenbezogen oder eigener Artikel ohne Lieferantenbezug) ist entweder kein oder der Lieferantbezogene EK-Eintrag als "nicht lieferbar" markiert.
|-valign="top"
| Nicht{{nb_space}}für{{nb_space}}Shop{{nb_space}}freigegeben|| Artikel wurde (noch) nicht in die Liste der Shop-Artikel übernommen. Diese Liste erstellt OBS während des Preisexports automatisch auf Basis der Einstellungen in den Shop-Lager und Definitionen eigener Artikel. Sollte ein Artikel fehlen, ist entweder die Übernahme noch nicht ausgeführt wurden oder es fehlt ein benötigter Eintrag in den EK-Lieferanten oder die Freigabe als eigener Artikel.
|-valign="top"
| Kein{{nb_space}}Matching|| Kann passieren, wenn sich z. B. eine Referenznummer wie die Bestellnummer ändert und OBS die Daten nicht mehr miteinander verknüpfen kann.
|-valign="top"
| Vom{{nb_space}}Shop{{nb_space}}als{{nb_space}}fehlend{{nb_space}}gemeldet|| OBS hat für diesen Artikel (Referenz ist Lager + Referenznummer) in der Vergangenheit einen Preis übertragen. Die API hat den Preis jedoch nicht angelegt mit dem Grund, dass der Artikel nicht im Shop vorhanden ist. Der Artikel wird dann für das Lager von der Pflege ausgeschlossen. Ändern z. B. Artikel die Lagerzugehörigkeit (z. B. Zentrallager zu Außenlager) oder Artikel kommen früher über die Artikelpflege ins OBS, kann es zu diesem Problem kommen. Mit {{Key|F6 Check}} können Sie den Status prüfen lassen. Kann der Artikel darüber gefunden werden, aktiviert OBS die pflege wieder.
|-valign="top"
| Menge{{nb_space}}<={{nb_space}}0|| Die Menge muss für eine gülige Definition einen positiven Wert haben.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}0|| Preiseinträge mit 0 werden von der API gelöscht. Entsprechende VK-Preise werden von OBS daher im Vorfeld bereits abgelehnt.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}EK|| Mit der Einstellung '''Export.Preise.Preis.VK.Check''' kann die Ertragsprüfung aktiviert werden. Es werden dann nur noch Preise übertragen, deren VK größer ist als der EK. Einzige Ausnahme sind Preislisten mit dem Häkchen '''Preisgarantie'''. Für diese Preislisten werden VK-Preise immer übertragen, sofern kein anderer Grund (z. B. VK ist 0) zur Ablehnung vorhanden ist.
|}

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
| {{Key|F10 Weit.}}|| Zugriff auf weitere Funktionen der Liste.
|}

===Weitere Funktionen (Artikel F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A{{nb_space}}Artikelstatus{{nb_space}}Massenprüfung|| Führt die Statusprüfung aus {{Key|F6 Check}} für alle Artikel der Preisliste aus.{{Achtung|Diese Funktionalität ist für personenbezogene Preislisten mit wenigen Hundert Artikel gedacht. Bei größeren Preislisten kann die Abfrage entsprechend lange dauern!}}
|-valign="top"
| D{{nb_space}}Datenabgleich{{nb_space}}mit{{nb_space}}brShop24{{nb_space}}API|| Fragt die Preisdaten zur Preisliste über die API ab und zeigt das Ergebnis in Spalte ''D'' mit Kürzeln an. F = Preis fehlt, sollte aber vorhanden sein F = Preis vorhanden, sollte aber gelöscht sein P = Preis ist vorhanden, jedoch abweichend{{Hinweis|Steht aktuell nur Benutzern mit Administratorlevel 9 für Shop-Schnittstellen zur Verfügung!}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preis|| Aufruf der Job-Protokolle für den Preiseintrag.{{Hinweis|Für alte Preisexporte fehlt hier die Verknüpfung in den Protokolldaten. Diese können daher nicht geladen werden.}}
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T10:00:49Z

Nimz: /* Tasten und Schaltflächen (Artikel) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Artikel{{nb_space}}inaktiv|| Im Artikelstamm ist das Häkchen "Inaktiv" gesetzt. Bei eigenen Artikeln ist dies ebenfalls abhängig von der Pflege-Einstellung (Allgemein und Lagerbezogen).
|-valign="top"
| Nicht{{nb_space}}lieferbar|| Abhängig von der Pflege (Lieferantenbezogen oder eigener Artikel ohne Lieferantenbezug) ist entweder kein oder der Lieferantbezogene EK-Eintrag als "nicht lieferbar" markiert.
|-valign="top"
| Nicht{{nb_space}}für{{nb_space}}Shop{{nb_space}}freigegeben|| Artikel wurde (noch) nicht in die Liste der Shop-Artikel übernommen. Diese Liste erstellt OBS während des Preisexports automatisch auf Basis der Einstellungen in den Shop-Lager und Definitionen eigener Artikel. Sollte ein Artikel fehlen, ist entweder die Übernahme noch nicht ausgeführt wurden oder es fehlt ein benötigter Eintrag in den EK-Lieferanten oder die Freigabe als eigener Artikel.
|-valign="top"
| Kein{{nb_space}}Matching|| Kann passieren, wenn sich z. B. eine Referenznummer wie die Bestellnummer ändert und OBS die Daten nicht mehr miteinander verknüpfen kann.
|-valign="top"
| Vom{{nb_space}}Shop{{nb_space}}als{{nb_space}}fehlend{{nb_space}}gemeldet|| OBS hat für diesen Artikel (Referenz ist Lager + Referenznummer) in der Vergangenheit einen Preis übertragen. Die API hat den Preis jedoch nicht angelegt mit dem Grund, dass der Artikel nicht im Shop vorhanden ist. Der Artikel wird dann für das Lager von der Pflege ausgeschlossen. Ändern z. B. Artikel die Lagerzugehörigkeit (z. B. Zentrallager zu Außenlager) oder Artikel kommen früher über die Artikelpflege ins OBS, kann es zu diesem Problem kommen. Mit {{Key|F6 Check}} können Sie den Status prüfen lassen. Kann der Artikel darüber gefunden werden, aktiviert OBS die pflege wieder.
|-valign="top"
| Menge{{nb_space}}<={{nb_space}}0|| Die Menge muss für eine gülige Definition einen positiven Wert haben.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}0|| Preiseinträge mit 0 werden von der API gelöscht. Entsprechende VK-Preise werden von OBS daher im Vorfeld bereits abgelehnt.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}EK|| Mit der Einstellung '''Export.Preise.Preis.VK.Check''' kann die Ertragsprüfung aktiviert werden. Es werden dann nur noch Preise übertragen, deren VK größer ist als der EK. Einzige Ausnahme sind Preislisten mit dem Häkchen '''Preisgarantie'''. Für diese Preislisten werden VK-Preise immer übertragen, sofern kein anderer Grund (z. B. VK ist 0) zur Ablehnung vorhanden ist.
|}

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
| {{Key|F10 Weit.}}|| Zugriff auf weitere Funktionen der Liste.
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T09:58:22Z

Nimz: /* Liste Artikel zu Preisliste */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Artikel{{nb_space}}inaktiv|| Im Artikelstamm ist das Häkchen "Inaktiv" gesetzt. Bei eigenen Artikeln ist dies ebenfalls abhängig von der Pflege-Einstellung (Allgemein und Lagerbezogen).
|-valign="top"
| Nicht{{nb_space}}lieferbar|| Abhängig von der Pflege (Lieferantenbezogen oder eigener Artikel ohne Lieferantenbezug) ist entweder kein oder der Lieferantbezogene EK-Eintrag als "nicht lieferbar" markiert.
|-valign="top"
| Nicht{{nb_space}}für{{nb_space}}Shop{{nb_space}}freigegeben|| Artikel wurde (noch) nicht in die Liste der Shop-Artikel übernommen. Diese Liste erstellt OBS während des Preisexports automatisch auf Basis der Einstellungen in den Shop-Lager und Definitionen eigener Artikel. Sollte ein Artikel fehlen, ist entweder die Übernahme noch nicht ausgeführt wurden oder es fehlt ein benötigter Eintrag in den EK-Lieferanten oder die Freigabe als eigener Artikel.
|-valign="top"
| Kein{{nb_space}}Matching|| Kann passieren, wenn sich z. B. eine Referenznummer wie die Bestellnummer ändert und OBS die Daten nicht mehr miteinander verknüpfen kann.
|-valign="top"
| Vom{{nb_space}}Shop{{nb_space}}als{{nb_space}}fehlend{{nb_space}}gemeldet|| OBS hat für diesen Artikel (Referenz ist Lager + Referenznummer) in der Vergangenheit einen Preis übertragen. Die API hat den Preis jedoch nicht angelegt mit dem Grund, dass der Artikel nicht im Shop vorhanden ist. Der Artikel wird dann für das Lager von der Pflege ausgeschlossen. Ändern z. B. Artikel die Lagerzugehörigkeit (z. B. Zentrallager zu Außenlager) oder Artikel kommen früher über die Artikelpflege ins OBS, kann es zu diesem Problem kommen. Mit {{Key|F6 Check}} können Sie den Status prüfen lassen. Kann der Artikel darüber gefunden werden, aktiviert OBS die pflege wieder.
|-valign="top"
| Menge{{nb_space}}<={{nb_space}}0|| Die Menge muss für eine gülige Definition einen positiven Wert haben.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}0|| Preiseinträge mit 0 werden von der API gelöscht. Entsprechende VK-Preise werden von OBS daher im Vorfeld bereits abgelehnt.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}EK|| Mit der Einstellung '''Export.Preise.Preis.VK.Check''' kann die Ertragsprüfung aktiviert werden. Es werden dann nur noch Preise übertragen, deren VK größer ist als der EK. Einzige Ausnahme sind Preislisten mit dem Häkchen '''Preisgarantie'''. Für diese Preislisten werden VK-Preise immer übertragen, sofern kein anderer Grund (z. B. VK ist 0) zur Ablehnung vorhanden ist.
|}

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T09:57:02Z

Nimz: /* Spalte Grund */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Artikel{{nb_space}}inaktiv|| Im Artikelstamm ist das Häkchen "Inaktiv" gesetzt. Bei eigenen Artikeln ist dies ebenfalls abhängig von der Pflege-Einstellung (Allgemein und Lagerbezogen).
|-valign="top"
| Nicht{{nb_space}}lieferbar|| Abhängig von der Pflege (Lieferantenbezogen oder eigener Artikel ohne Lieferantenbezug) ist entweder kein oder der Lieferantbezogene EK-Eintrag als "nicht lieferbar" markiert.
|-valign="top"
| Nicht{{nb_space}}für{{nb_space}}Shop{{nb_space}}freigegeben|| Artikel wurde (noch) nicht in die Liste der Shop-Artikel übernommen. Diese Liste erstellt OBS während des Preisexports automatisch auf Basis der Einstellungen in den Shop-Lager und Definitionen eigener Artikel. Sollte ein Artikel fehlen, ist entweder die Übernahme noch nicht ausgeführt wurden oder es fehlt ein benötigter Eintrag in den EK-Lieferanten oder die Freigabe als eigener Artikel.
|-valign="top"
| Kein{{nb_space}}Matching|| Kann passieren, wenn sich z. B. eine Referenznummer wie die Bestellnummer ändert und OBS die Daten nicht mehr miteinander verknüpfen kann.
|-valign="top"
| Vom{{nb_space}}Shop{{nb_space}}als{{nb_space}}fehlend{{nb_space}}gemeldet|| OBS hat für diesen Artikel (Referenz ist Lager + Referenznummer) in der Vergangenheit einen Preis übertragen. Die API hat den Preis jedoch nicht angelegt mit dem Grund, dass der Artikel nicht im Shop vorhanden ist. Der Artikel wird dann für das Lager von der Pflege ausgeschlossen. Ändern z. B. Artikel die Lagerzugehörigkeit (z. B. Zentrallager zu Außenlager) oder Artikel kommen früher über die Artikelpflege ins OBS, kann es zu diesem Problem kommen. Mit F6 können Sie den Status prüfen lassen. Kann der Artikel darüber gefunden werden, aktiviert OBS die pflege wieder.
|-valign="top"
| Menge{{nb_space}}<={{nb_space}}0|| Die Menge muss für eine gülige Definition einen positiven Wert haben.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}0|| Preiseinträge mit 0 werden von der API gelöscht. Entsprechende VK-Preise werden von OBS daher im Vorfeld bereits abgelehnt.
|-valign="top"
| VK{{nb_space}}<={{nb_space}}EK|| Mit der Einstellung '''Export.Preise.Preis.VK.Check''' kann die Ertragsprüfung aktiviert werden. Es werden dann nur noch Preise übertragen, deren VK größer ist als der EK. Einzige Ausnahme sind Preislisten mit dem Häkchen '''Preisgarantie'''. Für diese Preislisten werden VK-Preise immer übertragen, sofern kein anderer Grund (z. B. VK ist 0) zur Ablehnung vorhanden ist.
|}

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T09:32:27Z

Nimz: /* Spalten */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Grund|| Zeigt den [[#Spalte_Grund|Grund]], warum ein Preis nicht exportiert werden kann bzw. konnte.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}

===Spalte Grund===

===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T09:25:57Z

Nimz: /* Analyse-Modus (Preislisten) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}
===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T09:25:22Z

Nimz: /* Preislisten verwalten */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

===Analyse-Modus (Preislisten)===
Der Analyse-Modus zeigt Ihnen in einer eigenen Spalte ''Probleme'' Ursachen an, warum eine Preisliste nicht exportiert wird. Dies kann aktuell umfassen:
{| class="wikitable"
|-
! Problem!! width="800px"|Erklärung
|- valign="top"
| Nicht{{nb_space}}aktiv|| Die Preisliste ist nicht aktiviert (Häkchen in Maske).
|-valign="top"
| Außerhalb{{nb_space}}Gültigkeitszeitraum|| Das aktuelle Datum liegt außerhalb des in der Preisliste definierten Gültigkeitszeitraum (Datum von/bis).
|-valign="top"
| Typ{{nb_space}}enthält{{nb_space}}nicht{{nb_space}}Shop|| Die Preisliste ist auf WaWi und/oder Kasse beschränkt (Auswahlfeld in Preislistenmaske).
|-valign="top"
| Nicht{{nb_space}}der{{nb_space}}Schnittstelle{{nb_space}}zugeordnet|| Die Zuordnung zur Schnittstelle fehlt. Dies kann einfach mit {{Key|Einfg Einf.}} geändert werden.
|-valign="top"
| Keine{{nb_space}}Personenzuordnung|| Es wurden keine Personen(nummern) zur Zuordnung gefunden. Je nach Zuordnung im OBS muss eine der Personennummern im Shop in mindestens einem Benutzer oder einer Kundengruppe vorkommen.
|-valign="top"
| Keine{{nb_space}}Preise{{nb_space}}hinterlegt|| Die Preisliste verfügt über keine gültigen Preiseeinträge für den Export. Sollte Preiseinträge in der Preisliste vorhanden sein, können Sie dies mit dem Analyse-Modus der [[#Liste_Artikel_zu_Preisliste|Artikel-Liste]] ({{Key|F7 Artikel}}) prüfen.
|}
{{Hinweis|Abhängig von der Anzahl der Preislisten kann die Analyse einen Moment dauern, da dies für jede Preisliste ausgeführt wird!}}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}
===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T09:08:41Z

Nimz: /* Tasten und Schaltflächen (Preisliste) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf [[#Weitere_Funktionen_(Preisliste_F10)|weitere Funktionen]] der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}

===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}
===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen

2026-07-27T09:08:01Z

Nimz: /* Tasten und Schaltflächen (Preisliste) */

{{Vorlage:Kostenpflichtige Module}}
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
 
{{Achtung|Es kann vorkommen, dass im Shop mehere Preiseinträge zu einer bestimmten Menge eines Artikels auftauchen. Siehe dazu FAQ [[#brshop24_faq_preis_4|Warum hat der Shop zwei Preiseinträge für einen Artikel?]].}}
=Voraussetzungen=
#[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] sind eingerichtet (über Schnittstellenkonfiguration {{F8}})
#Preissystem im OBS ist auf das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] umgestellt
#Preisliste(n) ist/sind zum Zeitpunkt des Exports gültig. Eingabemaske [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]]:
##Preisliste ist aktiv (Checkbox)
##aktuelles Datum ist innerhalb des Gültigkeitszeitraums (Datum von/bis)
##Gültigkeit enthält "Shop" (Default: "Shop & Kasse & WaWi")
#Preisliste ist für Schnittstelle freigegeben (Häkchen gesetzt unter [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] → {{F10}} → S3)
#Kunden im Shop vorhanden
#Preisliste ist für mindestens einen der Kunden gültig (über Kundennummer in brShop24-Kundengruppe oder brShop24-Benutzer). Siehe dazu auch [[OBS/Preislisten/FAQ_Preislisten|FAQ Preislisten]] "Welche Möglichkeiten der Zuordnung gibt es?".
#[[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] enthalten mindestens einen Artikel aus dem Shop

=Shop-Menü: Preislisten verwalten=
==Preislisten verwalten==
<div><ul>
<li style="display: inline-block;"> [[File:BrShop24_ShpPl.jpg|thumb|none|600px|Preislisten einer Schnittstelle]] </li>
</ul></div>
Die Liste zeigt Ihnen alle [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]], die bei '''bisherigen''' Exporten für die Schnittstelle übernommen wurden und welchen Status diese bei der letzten Übertragung bekommen haben. Aktive [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] werden dabei in schwarz angezeigt. Rote Einträge sind gelöschte [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]]. Außerdem wird wie in der [[OBS/Stammdaten/Artikel:_H2_-_Bildverwaltung|Bildverwaltung]] und [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/A_Texte|externen Artikeltexten]] in Fett die Zuordnung zur Schnittstelle hervorgehoben, indem die Zeile in Fett dargestellt wird.
{{Hinweis|'''"Bisherige Exporte"''' meint alle zuvor ausgeführten Übertragungen von [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] über diese Shop-Schnittstelle. Diese Liste ist als eine Art Historie zu sehen. Sie zeigt nur das Ergebnis der bisherigen Übertragung. Je nach Anpassungen in der [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] (Artikel oder Freigaben) oder Zuordnung zu Kunden kann das Ergebnis nach der nächsten Übertragung anders aussehen. Auch tauchen neue [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] erst in dieser Liste auf, sobald diese einmal über einen Preislistenexport übertragen wurde.}}
===Tasten und Schaltflächen (Preisliste)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F5 Mark}}|| Markiert einen Datensatz
|-valign="top"
| {{Key|F6 Export}}|| Exportiert eine oder alle Preislisten (Auswahl).{{Hinweis|Die initiale Einzelübertragung neuer Preislisten muss über die [[OBS/Kostenpflichtige_Module/Preislisten|Preislistenverwaltung]] erfolgen.}} Auswahl<nowiki>:</nowiki>
*A Alle<nowiki>:</nowiki> vollständige Aktualisierung aller Preislisten im Shop. Dies bezieht auch Preislisten ein, die in der Preislistenverwaltung neu erstellt wurden!
*B akt. Preisliste<nowiki>:</nowiki> Überträgt die aktuell gewählte Preisliste neu. Abhängig von den Einstellungen oder Daten wird hier die Preisliste aktualisiert oder ''gelöscht''(!).
|-valign="top"
| {{Key|F7 Artikel}}|| Zeigt eine [[#Liste_Artikel_zu_Preisliste|Liste]] der zur Preisliste selektierten Artikel u. a. mit Lager, Shop-Artikelnummer, Staffelmenge und Preis.
|-valign="top"
| {{Key|F9 PLV}}|| Öffnet die [[OBS/Kostenpflichtige_Module/Preislisten#Liste|Preislistenverwaltung]]
|-valign="top"
| {{Key|F10 Weit.}}|| Zugriff auf weitere Funktionen der Liste
|-valign="top"
| {{Key|Einfg Einf.}}|| Setzt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|-valign="top"
| {{Key|Entf Lösch.}}|| Entfernt Zuordnung zur aktuellen Schnittstelle für markierte oder aktuelle Preisliste(n).
|}
===Weitere Funktionen (Preisliste F10)===
{| class="wikitable"
|-
! Menüpunkt!! width="800px"|Erklärung
|- valign="top"
| A1{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(shopbezogen)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden nur die in die in der Schnittstelle vorhandenen Preislisten analysiert.
|-valign="top"
| A2{{nb_space}}Analyse{{nb_hyphen}}Modus{{nb_space}}(alle)|| Schaltet den [[#Analyse-Modus|Analyse-Modus]] an bzw. aus. Es werden alle OBS-Preislisten analysiert.
|-valign="top"
| L1{{nb_space}}Preisliste{{nb_space}}leeren|| Leert im Shop die Preisliste. Das bedeutet, dass alle Preiseinträge der Preisliste gelöscht werden. Die Preisliste sollte direkt danach neu exportiert werden.{{Achtung|Dies löscht nicht die Preisliste! Die Preisliste hat im Shop lediglich keine Preiseinträge mehr. Ist ein löschen der Preisliste gewünscht, dann sollte die Shop-Zuordnung entfernt oder die Preisliste anderweitig deaktiviert und anschließend exportiert werden.}}
|-valign="top"
| P{{nb_space}}Job{{nb_hyphen}}Protokolle{{nb_space}}zu{{nb_space}}Preisliste|| Öffnet ie [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen#Liste_Jobs|Protokollliste]] gefiltert nach Job für die Preisliste.
|-valign="top"
| Z1{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Person)|| Übertragen der Preislistenzuordnung einer Person{{Hinweis|Nur verfügbar über die Webshop-Einstellungen von Personen!}}
|-valign="top"
| Z2{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Preisliste)|| Übertragen der Preislistenzuordnung der genannten Preisliste
|-valign="top"
| Z3{{nb_space}}Preislistenzuordnung{{nb_space}}neu{{nb_space}}übertragen{{nb_space}}(Alle)|| Übertragen der Preislistenzuordnung aller Preisliste
|}

==Liste Artikel zu Preisliste==
{{Achtung|Verfügbar ab Version 004840!}}
Zeigt die historischen Preisdaten zur Preisliste, welche über die Schnittstelle verarbeitet wurden.
{{Hinweis|Die Selektion der Preisdaten passiert mit dem Export einer Preisliste. Diese Liste zeigt den Datenstand der letzten Selektion. Die hier angezeigten Preisdaten können daher von den aktuellen Preisen der Preisliste abweichen.}}
===Spalten===
{| class="wikitable"
|-
! Bezeichnung!! width="800px"|Erläuterung
|-valign="top"
| OBS-Art-Nr.|| Zeigt die OBS-Artikelnummer aus Ihrem [[OBS/Stammdaten/Artikel|Artikelstamm]] an
|- valign="top"
| Shop-Art.-Nr.|| Zeigt die Artikelnummer im Shop an unter der dieser Preisdatensatz gepflegt wird.
|-valign="top"
| Lager|| Name des [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Shop-Lagers]]
|-valign="top"
| Bezeichnung|| Artikelbezeichnung; Zeigt Name 1 aus dem Artikel. Bei eigenen Artikeln wird - sofern gesetzt - die alternative Bezeichnung aus den [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Artikel-Shop-Einstellungen]] angezeigt.
|-valign="top"
| Menge|| (Staffel-)Menge des Preisdatensatzes
|-valign="top"
| VK Netto|| Netto-Preis des Preisdatensatzes
|-valign="top"
| Preisstatus|| Je nach status bei der letzten Selektion wird Ihnen hier ''Pflegen'' oder ''Löschen'' angezeigt.
|-valign="top"
| Aktualisiert|| Zeigt das Datum an dem OBS zuletzt den Preis per API in den Shop übertragen hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|-valign="top"
| Gelöscht|| Zeigt das Datum an dem OBS zuletzt den Preis per API aus dem Shop gelöscht hat.{{Hinweis|Wird bei Datensätzen, deren letzte Änderung per API länger zurück liegt, nicht angezeigt, da diese Information im Datensatz selbst erst Version 004721 (November 2024) gespeichert wird.}}
|}
===Hervorhebungen===
{| class="wikitable"
|-
! Stil!! width="800px"|Bedeutung
|-valign="top"
| Kursiv|| Preis hat den Status "Löschen".
|- valign="top"
| Textfarbe Rot|| Artikel ist als "fehlend" markiert. Dies kann z. B. passieren, wenn Artikel im OBS bereits vorhanden sind, aber im Shop zum Zeitpunkt der Preispflege nicht gefunden/identifiziert werden können. OBS ignoriert "fehlende" Artikel im weiteren Verlauf. Sollte der Artikel im Shop vorhanden sein, können Sie mit {{Key|F6 Check}} eine neue Abfrage starten, um den Status zu ändern.
|-valign="top"
| Textfarbe Grau|| Artikel ist inaktiv (Artikelstamm Häkchen "inaktiv").
|-valign="top"
| Textfarbe Grün|| Eigener Artikel ist aktiv.
|}
===Tasten und Schaltflächen (Artikel)===
{| class="wikitable"
|-
! Taste!! width="800px"|Erklärung
|- valign="top"
| {{Key|F4 Sort}}|| Sortierung wechseln. Sortierungen mit dem Zusatz "(nicht gefunden)" zeigen nur die Einträge an, zu denen der Shop bei der letzten Übertragung den Artikel als "nicht gefunden" gemeldet hat.
|-valign="top"
| {{Key|F6 Check}}|| Prüft für den aktuellen Datensatz, ob der zugehörige Artikel im Shop gefunden werden kann. Je nach Pflege Zeitpunkt kann es z.{{nb_space}}B. bei neuen Artikeln passieren, dass OBS einen Preis überträgt, der Artikel aber noch nicht im Shop angelegt wurde. Da OBS dann den Artikel für die weitere Pflege deaktiviert, muss der Artikel auf diese Weise erst wieder freigegeben werden.
|}

=Preisdaten exportieren=
Sie können Preise auf verschiedenen Wegen exportieren. Es werden dabei immer nur die Veränderungen zum letzten Export übertragen. 
Gestartet werden kann der Export auf folgenden Wegen:
*Shop-Menü "B Preislisten verwalten"
:Per {{F6}} starten Sie hier den Export für alle Preislisten
*Preislistenverwaltung
:{{F10}} + S1{{Hinweis|Der Punkt ist erst sichtbar, wenn die Preisliste mindestens einer Shop-Schnittstelle zugeordnet ist.}}
*Personenstamm Webshop-Einstellungen
:{{F8}} für die Übertragung der personenbezogenen Preise. Dieser Punkt öffnet die Shop-Preislisten-Verwaltung mit einem Filter, so dass nur die Preislisten des Kunden angezeigt werden. Auch beim Export werden nur die Preislisten des Kunden übertragen.
{{Hinweis|OBS überträgt die Preise pro Liste "gesammelt" in einem "batch"-Modus. Das heißt es werden mehrere hundert Einträge auf einmal übertragen und vom Shop-Server auf eine Todo-Liste gesetzt. Diese Liste arbeitet der Server relativ zeitnah ab. Es kann daher dazu kommen, dass die Preise nach der Übertragung erst mit einer kurzen Verzögerung im Shop angezeigt werden. Die Verzögerung sollte jedoch nur wenige Minuten betragen.}}

=Wie der Export funktioniert=
Für den Export selbst sind die im Shop vorhandenen Personen interessant. Preislisten im OBS, die nur Kunden zugeordnet sind, die gar nicht im Shop vorkommen, werden nicht exportiert. 
'''Stellen Sie daher für den Export einer Preisliste folgendes sicher:'''
*mindestens ein Kunde, dem die Preisliste im OBS zugeordnet ist, ist im Shop vorhanden.
*die Preisliste ist aktiv und gültig:
**Häkchen in "Preisliste aktiv" ist gesetzt.
**Das aktuelles Datum liegt innerhalb des angegebenen Zeitraums (Datum von/bis) der Preisliste.
**Das Feld "Gültigkeit" enthält den Wert ''Shop''.
**Preisliste ist für die Schnittstelle freigegeben (Preislistenverwaltung {{F10}} + S3)
*Die Preisliste enthält mindestens einen Artikel, der im Shop gepflegt ist. (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
 
Neben den genannten Voraussetzungen gibt es noch zwei Einstellungen, die auf die Übertragung einzelner Preise Auswirkungen haben:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration#Übersicht_aller_Einstellungen_für_brShop24|Konfiguration]] Export.Preise.Preis.VK.Check
:Wenn aktiviert, dann werden die VK-Preise mit den aktuellen EK-Preisen, abhängig der Preislisteneinstellung (aus Preisliste oder EK1 aus Artikelstamm) verglichen und der Preis nur exportiert, wenn VK > EK ist.
*[[OBS/Kostenpflichtige_Module/Preislisten|Preisliste]] Preisgarantie
:Preislisten mit gesetztem Häkchen in ''Preisgarantie'' werden in der Preisprüfung übersprungen.
 
OBS ermittelt lokal die Änderungen zur letzten Übertragung. Dies passiert abhängig von den Übertragungsparameter für alle Preislisten, alle Preislisten einer Person(-ennummer) oder einer einzelnen Preisliste. 
 
Die Preise werden nicht direkt in den Shop geschrieben. Der Shop erhält eine Liste der Preisdaten und legt diese in eine Aufgabenliste, welche dann automatisch abgearbeitet wird.
{{Achtung|Je nach Auslastung des Shop-Systems kann es also einige Minuten dauern, bis die Preise vollständig übernommen wurden.}}
{{Hinweis|Laut Informationen von Büroring werden 0-Preise in der API verworfen. OBS setzt entsprechende Preiseinträge intern auf den Status "löschen" und entfernt die jeweilige Preisstaffel aus dem Shop, sollte sie zuvor mit einem regulären Preis angelegt worden sein.}}
==Priorität und Bestprice-Findung==
Im Unterschied zum VShop gibt es im brShop24 eine Bestprice-Findung wie im OBS (siehe [[OBS/Preislisten/FAQ_Preislisten#preisfindung|FAQ Preislisten "Wie funktioniert die Preisfindung?"]]). Daher findet das Preislistenfeld ''Prio Shop'' in dieser Schnittstelle keine Anwendung. Die Preislisten erhalten im Shop also die gleiche Priorität, wie sie zum Zeitpunkt des Exports im OBS in ''Prio Preisfind.'' eingestellt ist und somit auch in der WaWi Anwendung finden würde.
{{Hinweis|Möglichweise muss die Bestprice-Findung im Shop aktiviert werden.}}

=Häufig gestellt Fragen (FAQ)=
{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_1
|Warum fehlt Preisliste X im Shop?
|Es gibt ein paar Punkte, die es zu Prüfen gilt, wenn eine Preisliste in den Shop übertragen werden soll. Abhängig ist die Übertragung von folgenden Punkten:
#Preisliste ist aktiv und gültig (Datum beachten)
#Preisliste ist für den Shop freigegeben (Gültigkeit enthält "Shop" und Häkchen in Zuordnung ist für die Schnittstelle gesetzt)
#Preisliste ist mindestens einem Kunden im Shop zugeordnet
#Preisliste hat mindestens einen Artikel, der im Shop enthalten ist (siehe auch [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots brShop24]])
Siehe auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Wie_der_Export_funktioniert|Wie der Export funktioniert]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_2
|Warum wird eine Preisliste nicht in den Shop übertragen?
|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, sollte der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechend gepflegt sind.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_3
|Ist es möglich die Artikelpreise automatisiert zu pflegen?
|Ja, dies ist möglich. Weitere Informationen finden Sie im Artikel zu den [[OBS/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|Shop-Automatiken]].
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_4
|Warum hat der Shop zwei Preiseinträge für einen Artikel?
|Der Shop unterscheidet bei den Preisen auch nach der Einheit. Der Preisexport übergibt keine Einheit. Für den Preis übernimmt die API die Standard-Einheit des Artikels im Shop. Sollten Sie zwei Einträge zu einer bestimmten Menge bei einem Artikel mit unterschiedlicher Einheit vorfinden, so bekommen Sie dies über OBS nur bereinigt, indem Sie die Preisliste aus dem Shop nehmen und anschließend wieder anlegen. 
 
Eine Preisliste können Sie aus dem Shop nehmen, indem Sie über das Shop-Menü in die Preislistenverwaltung für den Shop gehen. Suchen Sie die Preisliste und drücken Sie auf dem Datensatz {{Entf}}. Dies nimmt die Shop-Zuordnung aus der Preisliste. Danach exportieren Sie die einzelne Preisliste per {{F6}}. Anschließend drücken Sie {{Einfg}}, um die Shop-Zuordnung wieder zu setzen und exportieren erneut die Preisliste. Der erste Export löscht die Preisliste im Shop und der zweite Export legt die Daten neu an.
}}

{{Vorlage:KlapptextFAQ
|brshop24_faq_preis_5
|Warum wird der Preis eines Artikels nicht in den Shop übertragen?
|Vorraussetzungen, damit Artikelpreise übertragen werden:
#Preisliste muss die Voraussetzungen für den Export erfüllen
#Der Preis selbst muss größer als 0 sein
#Der Artikel muss über ein [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Lager (Shop-Depot)]] mit der Schnittstelle verknüpft sein
#Artikel darf vom Shop nicht als fehlend gemeldet worden sein (betrifft Artikel, die durch Büroring gepflegt werden)
#Eigene Artikel müssen im OBS und für die Schnittstelle aktiv sein
Für eigene Artikel liegt die Pflege des Artikels im Shop bei Ihnen. Das Büroring-Sortiment wird von Büroring im Shop gepflegt. Die Pflege von Preisen für Büroringartikel ist somit abhängig von zwei Faktoren: Zeitpunkte der Pflege/Anlage im Shop und der Zeitpunkt im OBS. Hierzu gab es bereits diverse Meldungen, dass Artikelpreise nicht übertragen wurden, obwohl der Artikel im Shop vorkommt. Da OBS die zu übertragenen Artikel bei [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|entsprechender Einstellung]] über die EK-Informationen des Artikelstamms ermittelt und dann Preise für die "verfügbaren" Artikel übermittelt, muss der Shop zu dem Zeitpunkt den jeweiligen Artikel auch im jeweiligen Lager wiederfinden können. Ist dies nicht der Fall, meldet der Shop den entsprechenden Artikel als "fehlend" und OBS merkt sich diese Rückmeldung. "Fehlende" Artikel werden bei weiteren Exporten ignoriert. Es kann also vorkommen, dass ein Artikel aus OBS im Shop einen Preis bekommen sollte, den der Shop zu dem Zeitpunkt nicht in seinem Sortiment wiedergefunden hat. Sollten Sie zu diesen Artikeln den Preis vermissen, so prüfen Sie bitte die [[#Liste_Artikel_zu_Preisliste|Preisdaten]] zu zur Preisliste (siehe oben Verwaltung Shop-Preislisten {{Key|F7 Artikel}}) oder die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Zuordnung_von_Artikeln|Artikelliste]] des jeweiligen Lagers. "Fehlende" Artikel werden hier rot dargestellt. Sie können außerdem per Sortierung sich nur die fehlenden Artikel anzeigen lassen. Ist der Artikel hier als "fehlend" markiert, so führen Sie auf dem Artikel stehend mit {{Key|F6 Check}} eine erneute Prüfung aus. Wird der Artikel gefunden, erhalten Sie eine entsprechende Rückmeldung und der Status wird geändert.
}}

FRMSHOPPREISLISTEN BRSHOP24

2026-07-27T08:49:37Z

Nimz: Weiterleitungsziel von Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen nach Kostenpflichtige Module/Internet-Shop/brShop24/Preise übertragen#Shop-Menü: Preislisten verwalten geändert

#WEITERLEITUNG [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Shop-Menü:_Preislisten_verwalten]]

OBS/Stammdaten/Verträge/F10 Weitere Funktionen

2026-07-27T07:28:01Z

Nimz: /* Z - Freitext Suche */

{{Vorlage:Stammdaten}}

=F10 Weitere Funktionen=

Hier finden Sie alle weitere Funktionen, die für das Handling von Verträgen notwendig sein können.
==A - Anlegen von Buchungssätzen==
Ein Markieren der relevanten Verträge über {{F5}}''' Mark''' und/oder {{F7}}''' Selekt''' ist erforderlich. Es öffnet sich ein kleines Fenster, in dem Ihnen alle 12 Perioden angezeigt werden, wählen Sie mit {{Return}}die gewünschte aus. Es werden automatisch Buchungssätze für diesen Monat erstellt. Diese Funktion muss für Verträge mit der Zahlungsart 'Überweisung' und 'Abbuchung' ausgeführt werden, damit diese buchführungstechnisch in die offene Periode einfließen, da hier ja keine Rechnung erstellt wird. 

Es ist möglich die Buchungsperiode frei zu wählen (1 Monat im Voraus und mehrere Monate rückwärts zur aktuellen Periode). 

'''Vertrags-Periode''' berücksichtigt das Datum '''Nächste Berechnung''' für Verträge.
Vorbelegung ist hierbei der aktuelle Monat.

Hierbei werden aus den Vertragsangaben Buchungssätze für Fibu, Erlöskonten, Warengruppen und Vertrags Einahmen-Ausgaben erzeugt.

[[Image:Vertrag_Buchungssaetze.png]] 

==B - Geräte für Vertrag==
Im Fenster Geräte für Vertrag werden ihnen alle Geräte, die dem Vertrag hinterlegt wurden, angezeigt. Dieser Liste können Sie neue Geräte hinzufügen oder löschen, Zählerstände für die Geräte eintragen und Reparaturaufträge einsehen. Mehr dazu [[OBS/Weitere Stammdaten/Geräte für Vertrag|hier]]. 
==C - Druckabrechnungen generieren==
Ein Markieren der relevanten Verträge über {{F5}}''' Mark''' und/oder {{F7}}''' Selekt''' ist erforderlich. Für alle Verträge, bei denen ein Zählerstand erfasst worden ist, der noch nicht abgerechnet wurde (Status 01) und das Datum "Berechnung ab" plus dem angegebenen Abrechnungszeitraum nicht in der Zukunft liegt und die Anzahl der Freikopien überschritten wurde,wird eine Druckabechnung generiert , die Sie in der Liste [[OBS/Auftragsbearbeitung/Rechnungen/Rechnungen|Rechnungen]] wiederfinden. 

===Druckabrechnungen auch bei weniger Verbrauch als Freikopien===
Wenn der [[OBS/Stammdaten/Programmparameter|Programmparameter]] '''099 Druckabrechnung mit Verbrauch < Freikopien''' aktiviert wurde, wird auch dann eine Druckabrechnung erzeugt, wenn die Freikopien höher sind als der jeweilige Verbrauch. Andernfalls wird der Zählerstand direkt auf Status 21 gesetzt.

===Mindestbetrag für Druckabrechnungen===
Es kann ein Mindestbetrag für Druckabrechnung festgelegt werden. Wird dieser bei einer Druckabrechnung unterschritten wird '''keine Rechnung''' erstellt. 

Im [[OBS/Stammdaten/Programmparameter|Programmparameter]] '''026''' kann als erster Parameter der Mindestbetrag in € angegeben werden. Als zweiter Parameter kann festgelegt werden, ob Zähler automatisch reduziert werden sollen (J oder N).

Als Beispiel könnte der Wert des Programmparameters 026 wie folgt aussehen:
5,J
Also Mindestbetrag 5€ und Zähler automatisch korrigieren ist aktiviert.

Hat nun ein Vertrag in der Druckabrechnung 2,50€ in der Rechnungssumme dann werden die Zähler (SW,Farbe,Scan,Frei1,Frei2) automatisch um 2,50€ reduziert damit die Rechnung 0€ beträgt.
Der Status der Zählerstände wird automatisch auf "21" gesetzt.
Im Protokoll des Vertrages wird die Minderung der Zähler Protokolliert. 
Das ''Berechnung ab'' Datum des Vertrages wird um eine Druckabrechnungsperiode erhöht.

{{Hinweis|Die gilt nicht für '''Sammelrechnungen''' und '''Druck Zusatzkosten''' werden nur in der aktuellen Rechnungssumme berücksichtigt!}}
===Seiten-EK pro Gerät===
Wenn der Hersteller die Versorgung mit Verbrauchsmaterials für ein oder mehrere Geräte im Vertrag übernimmt, werden Seiten-EK Preise vom Hersteller berechnet. Diese Kosten können den Geräten des Vertrags in der Geräteverwaltung unter {{Key|F10}} → [[OBS/Stammdaten/Weitere_Stammdaten/Ger%C3%A4teverwaltung#S1_-_Ger.C3.A4te-Vertrags_EK_Seitendefinition|S1 - Geräte-Vertrags EK Seitendefinition]] hinterlegt werden (SW,Scan,Farbe,Frei1,Frei2).

Bei der Druckabrechnung wird in den Vertrags-Einnahmen/Ausgaben eine Ausgaben Position erzeugt. Diese enthält alle EK Kosten für (SW,Scan,Farbe,Frei1,Frei2) aller Geräte für diesen Vertrag
[[Image:Vertragseinnahmen SeitenEK Beispiel.png|600px]] 

Zusätzlich werden in den Rechnungspositionen für (SW,Scan,Farbe,Frei1,Frei2) die dazugehörigen EK-Werte eingetragen. Dies ist rein informell. 
[[Image:Poserfassung SeitenEK Beispiel.png|600px]]

==D - Rechnungen generieren (Pauschale)==
Ein Markieren der relevanten Verträge über {{F5}}''' Mark''' und/oder {{F7}}''' Selekt''' ist erforderlich. Es werden automatisch Rechnungen für das Datum 'Nächste Berechnung' generiert, sofern dieses nicht in der Zukunft liegt. 
==E - Zählerstandsabfrage==
Ein Markieren der relevanten Verträge über {{F5}}''' Mark''' und/oder {{F7}}''' Selekt''' ist erforderlich. Über diesen Punkt können Sie die Zählerstände abfragen und verwalten. Näheres dazu finden Sie [[OBS/Häufig gestellte Fragen/Wie funktioniert die Zählerstandsabfrage?|hier]].
==E1 - Zählerstände ohne Verbrauch für Geräte ohne Zählerstand anlegen==
Legt für alle Geräte des aktuellen Vertrages, die keinen aktuellen Zählerstand (Stauts 01) enthalten einen neuen Zählerstand an, bei dem der aktuelle Zählerstand dem vorherigen Zählerstand entspricht. Der Verbaucht ist dann 0, aber der Vertrag kann so abgerechnet werden.

==F1 - Mandatsreferenz==
Hier können die Mandatsreferenznummern für den Vertrag verwaltet werden. Weitere Informationen zu Mandatsreferenzen erhalten Sie unter folgendem Punkt: [[OBS/SEPA_Verfahren_im_OBS#Mandatsreferenzen für Verträge|Mandatsreferenzen für Verträge]] 
==G - Verbrauchsmaterial==
Über diesen Punkt gelangen Sie in die Verbrauchsmaterialliste für den jeweiligen Vertrag. Sie können hier Verbrauchsmaterial über {{Einfg}} aus der Ersatzteilliste des zugehörigen Artikels (Kennung V = Verbrauchsmaterial) hinzufügen oder entfernen. 
Es werden alle Artikel angezeigt, die als Verbrauchsmaterial bei den Artikel der dem Vertrag zugeordneten Geräte hinterlegt wurden. Dies kann im Artikelstamm über [[OBS/Stammdaten/Artikel: U - Ersatzteil- /Verbrauchsmaterial ist enthalten in|T - Ersatzteil-/Verbrauchsmaterial-Liste]] eingestellt werden. 

Wenn das Verbrauchsmaterial hinzugefügt wurde kann über einen Druck auf {{Return}} die Seitenzahl eingestellt werden. Diese besagt, für wieviele Kopien das Verbrauchsmaterial hält. Hierbei ist zu beachten, dass der Verbrauch als Grundwert für Auswertungen mit Bezug zu [[http://wiki.bergau.de/OBS/Stammdaten/Verträge/F3_Vertragsdruck#9._Bewertungsliste_zuviel_verbrauchte_Kopien|Überschusskopien]] verwendet wird. Es sollte also nur bei Tonern hier ein Wert eingetragen werden. Eine Lebensdauer kann in der [[http://wiki.bergau.de/OBS/Stammdaten/Artikel:_U_-_Ersatzteil-_/Verbrauchsmaterial_ist_enthalten_in|Ersatzteilliste]] eingestellt werden.

Standardmäßig werden in dieser Liste nur die aktivierten Verbrauchsmaterialen angezeigt. Mit {{F6}} können Sie Verbrauchsmaterial aktivieren oder deaktivieren. 
Mit {{F9}} können Sie Funktionen für den ausgewählten Artikel bei allen Verträgen durchführen.
*Mit '''Tauschen''' können Sie den Artikel bei allen Verträgen gegen einen anderen austauschen.
*'''Einfügen''' fügt bei allen Verträgen, die den aktuell ausgewählten Artikel beinhalten einen beliebigen hinzu.
*'''Löschen''' löscht den ausgewählten Artikel aus allen Verträgen.

==H - Verbrauchsmaterial über Auftragspositionen==
Hier sehen Sie eine Liste mit allen Auftragspositionen die als Verbrauchsmaterial dem aktuellen Vertrag zugeordnet wurden.
==I-Vertrags-Einnahmen/Ausgaben Excel==
Über diesen Punkt gelangen Sie zu einer umfangreichen Excel Statistik über die Einnahmen und Ausgaben eines Vertrages, dieses Dokument kann auch als Info dem Vertrag hinterlegt werden. 
==J - Kopien für Vertrag==
Über diesen Punkt gelangen Sie zu einer Einnahmen/Ausgaben Statistik dieses Vertrages in Bezug auf die gelieferten Kopien (Verbrauchsmaterial im Auftrag) und die laut den Zählerständen tatsächlich verbrauchten Kopien. 
Die Werte beim Punkt "Wartung" errechnen sich aus den Wartungspauschalen, die für den aktuellen Vertrag erstellt wurden. 
Die Werte beim Punkt "Rechnung" beziehen sich auf die Druckabrechnungen. Falls ein Wert hierbei negativ aufgeführt wird, hat der Kunde weniger Kopien verbrauchst, als er Freikopien zur Verfügung hatte. 
Die Werte beim Punkt "Toner" beziehen sich auf die als Verbrauchsmaterial gebuchten Toner. Entscheident hierbei sind die in der Verbrauchsmaterial eingetragenen Werte für die Seitenanzahl des jeweiligen Toners.

Die Kopienwerte der Toner werden hierbei aus den Kopien-Werten des [[OBS/Stammdaten/Verträge/F10 Weitere Funktionen#G - Verbrauchsmaterial|Verbrauchsmaterial]]<nowiki/>s des Vertrages ermittelt. Soll ein Wert korrigiert werden, muss zunächst im Verbrauchsmaterial der korrekt Wert eingetragen werden. Anschließend können die Werte in der Liste der [[OBS/Stammdaten/Verträge#F6 Positionen|Vertragspositionen]] mit {{Key|F7 Korrekt.}} aktualisiert werden. 
==K - Überprüfe Verträge auf Verbrauchsmaterial und Vertragspositionen==
Es wird geprüft, für welche Verträge noch kein Verbrauchsmaterial angelegt wurde. 
Zudem wird bei Verbrauchsmaterial-Vertragspositionen überprüft, ob es auf dem jeweiligen Vertrag ein Gerät gibt, bei dem das Verbrauchsmaterial als Ersatzteil hinterlegt ist. Ist kein solches Gerät vorhanden kann es bei Vertragsauswertungen dazu kommen, dass der Wert des Verbrauchsmaterials bei der Einzelgerätekontrolle nicht berücksichtigt wird. 

Es kann Vorkommen, dass durch das nachträgliche Ändern der Artikelnummer von Material- oder Auftragspositionen die Verknüpfung zur entsprechenden Vertragsposition nicht mehr korrekt hergestellt werden kann. Dies hat zur Folge, dass diese Position im Vertrag doppelt angelegt wird. Dies kann nur manuell durch das Löschen der doppelten Position behoben werden. Betroffene Vertragspositionen werden bei dieser Überprüfung mit ausgegeben.

==L - Vertrag kopieren==
Kopiert den aktuellen Vertrag und legt diesen als neuen Vertrag an.

==M - QR-Code anzeigen==

==N1 - Eigenschaften==
Hierüber können die [[OBS/Eigenschaften|Eigenschaften]] bearbeitet werden, die dem Vertrag zugeordnet sind.

==N2 - Wiederkehrende Aufgaben==

==N3 - Vertragskalkulation für Angebote==

==N4 - Click-Kalkulation==
Nähere Informationen zu Auswertung '''Click-Kalkulation''' erhalten Sie hier: 
[[OBS/Stammdaten/Verträge/Click-Kalkulation|Click-Kalkulation]]
==N6 - Neue Preise für Vertrag definieren==
Hierüber können Preisänderungen für Verträge geplant und vorbereitet werden. Es ist dann möglich diese Änderungen zu einem beliebigen Zeitpunkt auszuführen. 

===Liste===
[[Image:VertragNeuePreise_Liste.png]] 
In dieser Liste sind die geplanten Preisänderungen sichtbar. Über die Filter kann eingestellt werden, ob nur die Einträge für den aktuell ausgewählten oder für alle Verträge angezeigt werden sollen. Zudem kann ausgewählt werden, ob auch erledigte Preisänderungen (Status 21) angezeigt werden sollen.
===Maske===
Es gibt die Möglichkeit die Werte über feste Beträge oder eine prozentuale Änderung zu ändern.

'''Feste Beträge''' 
Bei Neuanlage werden die Werte aus dem Vertrag vorbelegt. Sie können diese einfach in die gewünschten neuen Beträge ändern. Wenn ein Wert hierbei auf 0 gesetzt wird, wird dies auch so in den Vertrag übernommen. 
[[Image:VertragNeuePreise_MaskeReiter1.png]] 

'''Prozentuale Änderung''' 
Sollen die Änderungen prozentual erfolgen muss das Häkchen '''Prozentwerte aktiv''' aktiviert werden. Auf dem Reiter '''2 Preozentuale Änderung''' können dann die Prozentwerte eingetragen werden um welche die ursprünglichen Preise der jeweiligen Felder erhöht werden sollen. (Beispiel: 100 Prozent bewirkt, dass der Preis sich verdoppelt) 
Hierbei werden nur Werte, die nicht 0 sind, berechnet. 
[[Image:VertragNeuePreise_MaskeReiter2.png]] 

(Tipp:N6 als Vorbelegung fest, wenn sie viele Verträge übernehmen wollen) 
{{Hinweis|Es können nur Werte abgeändert werden die im Originalvertrag ein passendes Erlöskonto besitzen.}}
===Anlagen von Preisänderungseinträgen===
Wenn kein Vertrag markiert ist, kann über den Aufruf von ''N6'' die Liste geöffnet werden und dort mit {{Einfg}} ein Eintrag für den aktuell ausgewählten Vertrag angelegt werden (s. [[OBS/Stammdaten/Verträge/F10_Weitere_Funktionen#Maske|Maske]]).

Es können auch mehrere Verträge markiert werden. Wird dann ''N6'' aufgerufen, können über {{Einfg}} für alle markierten Verträge ein Eintrag angelegt werden. Es gibt nun die Möglichkeit für einen Eintrag prozentuale Änderungen einzutragen und diese auf die anderen Verträge zu kopieren. Dies ist hilfreich wenn die Preise für mehrere Verträge um die gleichen prozentualen Werte geändert werden sollen.

Es müssen hierfür zunächst für einen Vertrag die prozentualen Werte eingetragen werden. Anschließen müssen alle Verträge mit {{F5}} markiert werden, die die selben Preisänderungen erhalten sollen. Nun wählen Sie den Vertrag aus, der die Änderungen enthält (der Cursor der Liste muss auf diesem Vertrag stehen) und drücken {{Key|F7 % Übern.}}. Die Werte für die prozentuale Änderung werden nun auf alle markierten Verträge kopiert.

===Übernahme===
Unter {{F10}} können Einträge markiert werden. Hierbei können auch die Werte innerhalb eines bestimmten Datums markiert werden. Mit {{F5}} können einzelne Einträge markiert oder demarkiert werden.
Mit {{F6}} können die markierten Preisänderungne in die Verträge übernommen werden. Hierbei werden nur Einträge mit Status 01 berücksichtigt. 

Nach Änderung des Vertrages wird im Vertrag unter F8 die Änderung protokolliert. 
[[Image:VertragNeuePreise_InfoSystem.png]] 
===Dokumente===
Sollen automatisch Dokumente (Word/Libre Office) erstellt werden können Sie hierzu das Modul [[OBS/Kostenpflichtige_Module/Dokumenten_Manager#Liste|Dokumenten Manager]] verwenden.

==O - Vertrag/Geräte Einnahmen/Ausgaben (EXCEL)==
Über diesen Punkt können Sie eine Excel Datei mit Informationen zu den Einnahmen und Ausgaben zu allen markierten Verträgen erstellen lassen. Zusätzlich werden alle auf den Verträgen befindlichen Geräten mit angezeigt. Hierbei werden nur Geräte ohne Folgenummer berücksichtigt.

Folgende Daten werden pro Vertrag ausgegeben:
*Vertrag-Nr.
*Kundennummer
*Kundenname
*Mietpauschaleinnahmen
*Wartungspauschaleinnahmen
*ZusKostpauschaleinnahmen
*Pauschaleinnahmen
*Überklickeinnahmen
*Verbrauchskosten(Toner...)
*Technikkosten
*Ersatzteilkosten
*Wartungspauschale / Monat
*Freikopien SW / Monat
*Freikopien Farbe / Monat
*Folgeklickpreis SW
*Folgeklickpreis Farbe
*Mehrkopien SW
*Mehrkopien Farbe
*Mehrkopien Ø SW
*Mehrkopien Ø Farbe
*Mehrkopien SW Gesamt
*Mehrkopien Farbe Gesamt
*Mehrkopien Ø SW Gesamt
*Mehrkopien Ø Farbe Gesamt
*Summe Einnahmen/Ausgaben Gesamt
*Summe Einnahmen/Ausgaben Wartung
*Provisionssatz
*Provision
*Vertreter Vertrag
*Vertreter Person

Pro Gerät werden folgende Daten ausgegeben:
*Vertrags-Nr.
*Kundennummer
*Kundenname
*Gerätebezeichnung
*Seriennummer
*Wartungspauschaleinnahmen Ø SW
*Wartungspauschaleinnahmen Ø Farbe
*Überklickeinnahmen SW
*Überklickeinnahmen Farbe
*Verbrauchskosten Ø SW
*Verbrauchskosten Ø Farbe
*Technikkosten Ø
*Ersatzteilkosten Ø
*Erstellte Kopien SW Ø
*Erstellte Kopien Farbe Ø
*Folgeklickpreis SW
*Folgeklickpreis Farbe
*Summe Einnahmen/Ausgaben Gesamt
*Summe Einnahmen/Ausgaben Wartung
*Vertreter Vertrag
*Vertreter Person

==O1 - Anlagenspiegel (EXCEL)==
Über diesen Punkt kann ein Export der Geräte zu Excel ausgeführt werden. Wenn kein Vertrag markiert wurde, wird der Export für alle Verträge ausgeführt.
Dies kann hilfreich bei der Anlagenbuchaltung sein.

Der Export enthält folgende Daten:
*Gerätenummer
*Artikelnummer des Gerätes
*Bzeichnung 1 des Gerätes
*EK-Preis des Gerätes
*Vertragsnummer
*Vertragsdatum

== P - Protkoll Vorgänge ==
Zeigt ein Protokoll über alle allgemeinen Vertragsvorgänge, also wann zum Beispiel eine Abrechnung erfolgte oder wann eine Rechnung gelöscht wurde. Eine detaillierte Auflistung mit einzelnen Positionen und einer Erklärung der Felder und Typen finden Sie unter [[OBS/Stammdaten/Verträge/F10 Weitere Funktionen#Q - Protokoll des Vertrages|Q - Protokoll des Vertrages]].

== Q - Protokoll des Vertrages ==
Zeigt ein Protkoll für den aktuellen Vertrag.

=== Spalten des Protokolls: ===
{| class="wikitable"
|+
!Spalten
!Beschreibung
|-
|Vorgang
|UID des jeweiligen Vorgangs (zum Beispiel der Erstellung einer Rechnung)
|-
|V-Nr
|Vertragsnummer
|-
|RE-Nr.
|Rechnungsnummer (falls vorhanden)
|-
|Typ
|Art des Protokolleintrages. Folgende Typen gibt es:
{| class="wikitable"
|+
!Typ
!Beschreibung
|-
|D
|Erstellung einer Druckabrechnungsposition
|-
|E
|Fehler (Error)
|-
|L
|Löschen einer Rechnungsposition
|-
|P
|Erstellung einer Pauschalabrechnungsposition
|-
|V
|Vorgang (s. [[OBS/Stammdaten/Verträge/F10 Weitere Funktionen#P - Protkoll Vorgänge|P - Protokoll Vorgänge]])
|-
|Z
|Erstellung einer Zusatzkosten Position bzw. Rechnung
|}
|-
|Text
|Text des Protokolleintrages
|-
|Datum
|Datum des Protokolleintrages
|-
|Zeit
|Zeit des Protokolleintrages
|}

==V - Vertrags-Inventur==
Erfassen der Lagerwerte von Verbrauchsmaterialien bei Ihren Kunden. Nähere Informationen zur Funktionsweise finden Sie [[OBS/Stammdaten/Verträge/Vertragsinventur|hier]].
==W - Markierte Verträge Mehrwertsteuersatz ändern==
Hierüber kann der [[OBS/Stammdaten/Weitere Stammdaten/Mehrwertsteuer|Mehrwetsteuersatz]] der markierten Verträge geändert werden. Es kann dabei ausgewählt werden, ob diese Änderung für die Pauschal-, Druck- und/oder Zusatzkostenabrechnung durchgeführt werden soll.
==W1 - Markierte Verträge Zahlungsart ändern==
Hierüber kann bei allen markierten Verträgen die Zahlungsart (Rechnung, Abbuchung, Überweisung) überschrieben werden.
==W2 - Markierte Verträge Eigenschaft setzen==
Hierüber kann allen markierten Verträgen eine Eigenschaft zugeordnet werden.
==W3 - Markierte Verträge Eigenschaft setzen==
Hierüber kann bei allen markierten Verträgen eine Eigenschaft entfernt werden.
==X - Alle Verträge Seiten Korrigieren==
==Y - Alle Verträge Verbrauchsmaterial korrigieren==
Hier wird die Vertragsstatistik Einahmen/Ausgaben an Hand des aktuell (neu) angegebenen Verbrauchsmaterials, b.z.w. der neu gesetzten Parameter beim Verbrauchsmaterial neu berechnet. 
==Z - Einstellungen==
Einstellungen für das Modul "Vertrag".
{| class="wikitable"
|-
! Einstellung!! Erklärung
|-
| ZählErf.MPS.Ubernahme.KeinePrüfung|| Aktiviert in der Zählerstandsübernahme von MPS-Zählern die Option die Übernahme ohne Prüfungen auszuführen. (Nicht empfohlen!)
|-
| ZählErf.MPS.Ubernahme.Vorb.ZählerWahl|| Definiert für die Zählerstandsübernahme von MPS-Zählern eine Vorbelegung der Zählerstandsprüfung-Auswahl (wenn Alt > Neu). Dies deaktiviert die Auswahl und nimmt diese Einstellung. 0 = Aus/Keine Vorbelegung 1 = Übernahme des alten Zählerstands als neuen Zählerstand 2 = manuelle Eingabe eines neuen Zählerstands 3 = Übernahme überspringen
|}
==Z1 - Freitext Suche==
Es kann nach einem beliebigen Text in der Vertragsübersicht gesucht werden.

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T13:16:25Z

Nimz: /* Properties */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = <nowiki>''</nowiki>)</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = <nowiki>''</nowiki>): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = <nowiki>''</nowiki>; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = <nowiki>''</nowiki>; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = <nowiki>''</nowiki>): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = <nowiki>''</nowiki>; const PsZusatz: string = <nowiki>''</nowiki>)</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = <nowiki>''</nowiki>): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = <nowiki>''</nowiki>; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = <nowiki>''</nowiki>)</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*) Wandelt den übergebenen String in die passende Enummeration für Property (siehe Hinweise in [[#TVorgangPos_Prop_Typ|Typ]]). {{Achtung|Wird ein ungültiger Wert gesetzt, so wird der Typ automatisch auf Position ("0" bzw. ptPosition) gesetzt.}}
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …){{Hinweis|Wird der Typ geändert, so werden die Daten des Positionsobjekts auf die Vorbelegung zurückgesetzt. Zuvor gesetzte Daten werden dabei überschrieben. Nach der Verwendung von <code>NeuePosition</code> sollte der Typ daher als erstes geändert werden, bevor Sie weitere Daten in das Objekt schreiben. Alternativ kann der Positionstyp mit einer Klassenmethode angepasst werden. Diese verfügen über entsprechende Parameter, um relevante Felder für die Position direkt zu setzen. Siehe dazu: [[#TVorgangPos_Meth_Typ_Pos|Typ_Pos]] [[#TVorgangPos_Meth_Typ_Text|Typ_Text]] [[#TVorgangPos_Meth_Typ_Leerzeile|Typ_Leerzeile]] [[#TVorgangPos_Meth_Typ_Zwischensumme|Typ_Zwischensumme]] [[#TVorgangPos_Meth_Typ_ZwischensummeEbene|Typ_ZwischensummeEbene]] [[#TVorgangPos_Meth_Typ_Titelsumme|Typ_Titelsumme]] [[#TVorgangPos_Meth_Typ_TitelsummeEbene|Typ_TitelsummeEbene]] [[#TVorgangPos_Meth_Typ_Titel|Typ_Titel]] [[#TVorgangPos_Meth_Typ_Gewerk|Typ_Gewerk]] [[#TVorgangPos_Meth_Typ_NeueSeite|Typ_NeueSeite]] [[#TVorgangPos_Meth_Typ_Bild|Typ_Bild]]}}
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = <nowiki>''</nowiki>; cG: string = <nowiki>''</nowiki>; cFormat: string = <nowiki>''</nowiki>)</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = <nowiki>''</nowiki>)</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = <nowiki>''</nowiki>): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = <nowiki>''</nowiki>): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = <nowiki>''</nowiki>): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = <nowiki>''</nowiki>): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = <nowiki>''</nowiki>): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = <nowiki>''</nowiki>; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = <nowiki>''</nowiki>; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = <nowiki>''</nowiki>; const cPsZusatz: string = <nowiki>''</nowiki>): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = <nowiki>''</nowiki>): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = <nowiki>''</nowiki>): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T12:11:54Z

Nimz: /* Properties */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = <nowiki>''</nowiki>)</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = <nowiki>''</nowiki>): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = <nowiki>''</nowiki>; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = <nowiki>''</nowiki>; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = <nowiki>''</nowiki>): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = <nowiki>''</nowiki>; const PsZusatz: string = <nowiki>''</nowiki>)</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = <nowiki>''</nowiki>): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = <nowiki>''</nowiki>; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = <nowiki>''</nowiki>)</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*) Wandelt den übergebenen String in die passende Enummeration für Property (siehe Hinweise in [[TVorgangPos_Prop_Typ|Typ]]). {{Achtung|Wird ein ungültiger Wert gesetzt, so wird der Typ automatisch auf Position ("0" bzw. ptPosition) gesetzt.}}
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …){{Hinweis|Wird der Typ geändert, so werden die Daten des Positionsobjekts auf die Vorbelegung zurückgesetzt. Zuvor gesetzte Daten werden dabei überschrieben. Nach der Verwendung von <code>NeuePosition</code> sollte der Typ daher als erstes geändert werden, bevor Sie weitere Daten in das Objekt schreiben. Alternativ kann der Positionstyp mit einer Klassenmethode angepasst werden. Diese verfügen über entsprechende Parameter, um relevante Felder für die Position direkt zu setzen. Siehe dazu: [[#TVorgangPos_Meth_Typ_Pos|Typ_Pos]] [[#TVorgangPos_Meth_Typ_Text|Typ_Text]] [[#TVorgangPos_Meth_Typ_Leerzeile|Typ_Leerzeile]] [[#TVorgangPos_Meth_Typ_Zwischensumme|Typ_Zwischensumme]] [[#TVorgangPos_Meth_Typ_ZwischensummeEbene|Typ_ZwischensummeEbene]] [[#TVorgangPos_Meth_Typ_Titelsumme|Typ_Titelsumme]] [[#TVorgangPos_Meth_Typ_TitelsummeEbene|Typ_TitelsummeEbene]] [[#TVorgangPos_Meth_Typ_Titel|Typ_Titel]] [[#TVorgangPos_Meth_Typ_Gewerk|Typ_Gewerk]] [[#TVorgangPos_Meth_Typ_NeueSeite|Typ_NeueSeite]] [[#TVorgangPos_Meth_Typ_Bild|Typ_Bild]]}}
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = <nowiki>''</nowiki>; cG: string = <nowiki>''</nowiki>; cFormat: string = <nowiki>''</nowiki>)</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = <nowiki>''</nowiki>)</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = <nowiki>''</nowiki>): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = <nowiki>''</nowiki>): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = <nowiki>''</nowiki>): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = <nowiki>''</nowiki>): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = <nowiki>''</nowiki>): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = <nowiki>''</nowiki>; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = <nowiki>''</nowiki>; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = <nowiki>''</nowiki>; const cPsZusatz: string = <nowiki>''</nowiki>): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = <nowiki>''</nowiki>): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = <nowiki>''</nowiki>): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T12:07:27Z

Nimz:

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = <nowiki>''</nowiki>)</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = <nowiki>''</nowiki>): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = <nowiki>''</nowiki>; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = <nowiki>''</nowiki>; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = <nowiki>''</nowiki>): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = <nowiki>''</nowiki>; const PsZusatz: string = <nowiki>''</nowiki>)</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = <nowiki>''</nowiki>): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = <nowiki>''</nowiki>; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = <nowiki>''</nowiki>)</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*) Wandelt den übergebenen String in die passende Enummeration für Property (siehe Hinweise in [[TVorgangPos_Prop_Typ|Typ]]). {{Achtung|Wird ein ungültiger Wert gesetzt, so wird der Typ automatisch auf Position ("0" bzw. ptPosition) gesetzt.}}
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …){{Hinweis|Wird der Typ geändert, so werden die Daten des Positionsobjekts auf die Vorbelegung zurückgesetzt. Zuvor gesetzte Daten werden dabei überschrieben. Nach der Verwendung von <code>NeuePosition</code> sollte der Typ daher als erstes geändert werden, bevor Sie weitere Daten in das Objekt schreiben.}}
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = <nowiki>''</nowiki>)</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = <nowiki>''</nowiki>; cG: string = <nowiki>''</nowiki>; cFormat: string = <nowiki>''</nowiki>)</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = <nowiki>''</nowiki>)</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = <nowiki>''</nowiki>): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = <nowiki>''</nowiki>): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = <nowiki>''</nowiki>): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = <nowiki>''</nowiki>): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = <nowiki>''</nowiki>): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = <nowiki>''</nowiki>; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = <nowiki>''</nowiki>; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = <nowiki>''</nowiki>; const cPsZusatz: string = <nowiki>''</nowiki>): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = <nowiki>''</nowiki>): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = <nowiki>''</nowiki>): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T12:04:34Z

Nimz: /* Methoden */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = '')</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*) Wandelt den übergebenen String in die passende Enummeration für Property (siehe Hinweise in [[TVorgangPos_Prop_Typ|Typ]]). {{Achtung|Wird ein ungültiger Wert gesetzt, so wird der Typ automatisch auf Position ("0" bzw. ptPosition) gesetzt.}}
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …){{Hinweis|Wird der Typ geändert, so werden die Daten des Positionsobjekts auf die Vorbelegung zurückgesetzt. Zuvor gesetzte Daten werden dabei überschrieben. Nach der Verwendung von <code>NeuePosition</code> sollte der Typ daher als erstes geändert werden, bevor Sie weitere Daten in das Objekt schreiben.}}
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T11:59:39Z

Nimz: /* Properties */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = '')</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*) Wandelt den übergebenen String in die passende Enummeration für Property (siehe Hinweise in [[TVorgangPos_Prop_Typ|Typ]]). {{Achtung|Wird ein ungültiger Wert gesetzt, so wird der Typ automatisch auf Position ("0" bzw. ptPosition) gesetzt.}}
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …){{Hinweis|Wird der Typ geändert, so werden die Daten des Positionsobjekts auf die Vorbelegung zurückgesetzt. Zuvor gesetzte Daten werden dabei überschrieben. Nach der Verwendung von <code>NeuePosition</code> sollte der Typ daher als erstes geändert werden, bevor Sie weitere Daten in das Objekt schreiben.}}
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T11:47:36Z

Nimz: /* TVorgangPosOriginal */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = '')</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*)
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …)
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T11:47:17Z

Nimz: /* TVorgangPosParams_AktualisiereDaten */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = '')</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*)
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …)
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T11:46:40Z

Nimz: /* TVorgangPosSummen */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = '')</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{{Achtung|Funktioniert nur im Scriptrunner "Pax"! Aktiver Scriptrunner ist definiert in Programmparameter 444.}}
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*)
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …)
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T11:42:45Z

Nimz:

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>ptPosition</code> || Normale Artikelposition
|- style="vertical-align:top"
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|- style="vertical-align:top"
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|- style="vertical-align:top"
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|- style="vertical-align:top"
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|- style="vertical-align:top"
| 5 || <code>ptTitel</code> || Titelzeile
|- style="vertical-align:top"
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|- style="vertical-align:top"
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|- style="vertical-align:top"
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|- style="vertical-align:top"
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|- style="vertical-align:top"
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|- style="vertical-align:top"
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|- style="vertical-align:top"
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|- style="vertical-align:top"
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|- style="vertical-align:top"
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|- style="vertical-align:top"
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|- style="vertical-align:top"
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|- style="vertical-align:top"
| <code>cUid</code> || String || UID der Ursprungsposition
|- style="vertical-align:top"
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Leert alle Felder des Records
|- style="vertical-align:top"
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|- style="vertical-align:top"
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|- style="vertical-align:top"
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Init(const cVorb: string = '')</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|- style="vertical-align:top"
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|- style="vertical-align:top"
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|- style="vertical-align:top"
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|- style="vertical-align:top"
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|- style="vertical-align:top"
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|- style="vertical-align:top"
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|- style="vertical-align:top"
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cNr</code> || String || Merkmalsnummer
|- style="vertical-align:top"
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|- style="vertical-align:top"
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|- style="vertical-align:top"
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|- style="vertical-align:top"
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|- style="vertical-align:top"
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|- style="vertical-align:top"
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|- style="vertical-align:top"
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|- style="vertical-align:top"
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|- style="vertical-align:top"
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|- style="vertical-align:top"
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|- style="vertical-align:top"
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|- style="vertical-align:top"
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|- style="vertical-align:top"
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|- style="vertical-align:top"
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|- style="vertical-align:top"
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|- style="vertical-align:top"
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|- style="vertical-align:top"
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|- style="vertical-align:top"
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|- style="vertical-align:top"
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|- style="vertical-align:top"
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|- style="vertical-align:top"
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|- style="vertical-align:top"
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|- style="vertical-align:top"
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|- style="vertical-align:top"
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|- style="vertical-align:top"
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|- style="vertical-align:top"
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|- style="vertical-align:top"
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|- style="vertical-align:top"
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|- style="vertical-align:top"
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|- style="vertical-align:top"
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|- style="vertical-align:top"
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|- style="vertical-align:top"
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|- style="vertical-align:top"
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|- style="vertical-align:top"
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|- style="vertical-align:top"
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|- style="vertical-align:top"
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|- style="vertical-align:top"
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|- style="vertical-align:top"
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|- style="vertical-align:top"
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|- style="vertical-align:top"
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|- style="vertical-align:top"
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|- style="vertical-align:top"
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|- style="vertical-align:top"
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|- style="vertical-align:top"
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|- style="vertical-align:top"
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|- style="vertical-align:top"
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|- style="vertical-align:top"
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|- style="vertical-align:top"
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|- style="vertical-align:top"
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|- style="vertical-align:top"
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|- style="vertical-align:top"
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|- style="vertical-align:top"
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|- style="vertical-align:top"
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|- style="vertical-align:top"
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|- style="vertical-align:top"
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|- style="vertical-align:top"
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|- style="vertical-align:top"
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|- style="vertical-align:top"
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|- style="vertical-align:top"
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|- style="vertical-align:top"
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|- style="vertical-align:top"
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|- style="vertical-align:top"
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|- style="vertical-align:top"
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|- style="vertical-align:top"
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|- style="vertical-align:top"
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|- style="vertical-align:top"
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|- style="vertical-align:top"
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|- style="vertical-align:top"
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|- style="vertical-align:top"
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|- style="vertical-align:top"
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|- style="vertical-align:top"
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|- style="vertical-align:top"
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|- style="vertical-align:top"
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|- style="vertical-align:top"
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|- style="vertical-align:top"
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|- style="vertical-align:top"
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|- style="vertical-align:top"
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|- style="vertical-align:top"
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|- style="vertical-align:top"
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|- style="vertical-align:top"
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|- style="vertical-align:top"
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|- style="vertical-align:top"
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|- style="vertical-align:top"
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|- style="vertical-align:top"
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|- style="vertical-align:top"
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|- style="vertical-align:top"
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|- style="vertical-align:top"
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|- style="vertical-align:top"
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|- style="vertical-align:top"
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|- style="vertical-align:top"
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|- style="vertical-align:top"
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|- style="vertical-align:top"
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|- style="vertical-align:top"
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|- style="vertical-align:top"
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|- style="vertical-align:top"
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|- style="vertical-align:top"
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|- style="vertical-align:top"
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|- style="vertical-align:top"
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|- style="vertical-align:top"
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|- style="vertical-align:top"
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|- style="vertical-align:top"
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|- style="vertical-align:top"
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|- style="vertical-align:top"
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|- style="vertical-align:top"
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|- style="vertical-align:top"
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|- style="vertical-align:top"
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|- style="vertical-align:top"
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|- style="vertical-align:top"
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|- style="vertical-align:top"
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|- style="vertical-align:top"
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|- style="vertical-align:top"
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|- style="vertical-align:top"
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|- style="vertical-align:top"
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|- style="vertical-align:top"
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|- style="vertical-align:top"
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|- style="vertical-align:top"
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|- style="vertical-align:top"
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|- style="vertical-align:top"
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|- style="vertical-align:top"
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|- style="vertical-align:top"
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|- style="vertical-align:top"
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|- style="vertical-align:top"
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|- style="vertical-align:top"
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|- style="vertical-align:top"
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|- style="vertical-align:top"
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|- style="vertical-align:top"
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|- style="vertical-align:top"
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|- style="vertical-align:top"
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|- style="vertical-align:top"
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|- style="vertical-align:top"
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|- style="vertical-align:top"
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|- style="vertical-align:top"
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|- style="vertical-align:top"
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|- style="vertical-align:top"
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|- style="vertical-align:top"
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|- style="vertical-align:top"
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|- style="vertical-align:top"
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|- style="vertical-align:top"
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|- style="vertical-align:top"
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|- style="vertical-align:top"
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|- style="vertical-align:top"
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|- style="vertical-align:top"
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|- style="vertical-align:top"
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|- style="vertical-align:top"
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|- style="vertical-align:top"
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|- style="vertical-align:top"
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|- style="vertical-align:top"
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|- style="vertical-align:top"
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|- style="vertical-align:top"
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|- style="vertical-align:top"
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|- style="vertical-align:top"
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|- style="vertical-align:top"
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|- style="vertical-align:top"
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|- style="vertical-align:top"
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|- style="vertical-align:top"
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|- style="vertical-align:top"
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|- style="vertical-align:top"
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|- style="vertical-align:top"
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|- style="vertical-align:top"
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|- style="vertical-align:top"
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|- style="vertical-align:top"
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|- style="vertical-align:top"
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|- style="vertical-align:top"
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|- style="vertical-align:top"
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|- style="vertical-align:top"
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|- style="vertical-align:top"
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|- style="vertical-align:top"
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|- style="vertical-align:top"
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|- style="vertical-align:top"
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|- style="vertical-align:top"
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|- style="vertical-align:top"
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|- style="vertical-align:top"
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|- style="vertical-align:top"
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|- style="vertical-align:top"
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|- style="vertical-align:top"
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|- style="vertical-align:top"
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|- style="vertical-align:top"
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|- style="vertical-align:top"
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|- style="vertical-align:top"
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|- style="vertical-align:top"
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|- style="vertical-align:top"
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|- style="vertical-align:top"
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|- style="vertical-align:top"
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|- style="vertical-align:top"
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|- style="vertical-align:top"
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|- style="vertical-align:top"
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|- style="vertical-align:top"
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|- style="vertical-align:top"
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|- style="vertical-align:top"
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|- style="vertical-align:top"
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|- style="vertical-align:top"
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|- style="vertical-align:top"
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|- style="vertical-align:top"
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|- style="vertical-align:top"
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|- style="vertical-align:top"
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|- style="vertical-align:top"
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|- style="vertical-align:top"
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|- style="vertical-align:top"
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|- style="vertical-align:top"
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|- style="vertical-align:top"
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|- style="vertical-align:top"
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|- style="vertical-align:top"
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|- style="vertical-align:top"
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|- style="vertical-align:top"
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|- style="vertical-align:top"
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|- style="vertical-align:top"
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|- style="vertical-align:top"
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|- style="vertical-align:top"
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|- style="vertical-align:top"
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|- style="vertical-align:top"
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|- style="vertical-align:top"
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|- style="vertical-align:top"
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|- style="vertical-align:top"
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|- style="vertical-align:top"
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|- style="vertical-align:top"
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|- style="vertical-align:top"
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|- style="vertical-align:top"
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|- style="vertical-align:top"
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|- style="vertical-align:top"
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|- style="vertical-align:top"
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|- style="vertical-align:top"
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|- style="vertical-align:top"
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|- style="vertical-align:top"
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|- style="vertical-align:top"
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|- style="vertical-align:top"
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|- style="vertical-align:top"
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|- style="vertical-align:top"
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|- style="vertical-align:top"
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|- style="vertical-align:top"
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|- style="vertical-align:top"
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|- style="vertical-align:top"
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|- style="vertical-align:top"
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|- style="vertical-align:top"
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|- style="vertical-align:top"
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|- style="vertical-align:top"
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|- style="vertical-align:top"
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|- style="vertical-align:top"
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|- style="vertical-align:top"
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|- style="vertical-align:top"
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|- style="vertical-align:top"
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|- style="vertical-align:top"
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|- style="vertical-align:top"
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|- style="vertical-align:top"
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|- style="vertical-align:top"
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|- style="vertical-align:top"
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|- style="vertical-align:top"
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|- style="vertical-align:top"
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|- style="vertical-align:top"
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|- style="vertical-align:top"
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|- style="vertical-align:top"
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|- style="vertical-align:top"
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|- style="vertical-align:top"
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|- style="vertical-align:top"
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|- style="vertical-align:top"
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|- style="vertical-align:top"
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|- style="vertical-align:top"
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|- style="vertical-align:top"
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|- style="vertical-align:top"
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|- style="vertical-align:top"
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|- style="vertical-align:top"
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|- style="vertical-align:top"
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|- style="vertical-align:top"
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|- style="vertical-align:top"
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|- style="vertical-align:top"
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|- style="vertical-align:top"
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|- style="vertical-align:top"
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|- style="vertical-align:top"
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|- style="vertical-align:top"
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|- style="vertical-align:top"
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|- style="vertical-align:top"
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|- style="vertical-align:top"
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|- style="vertical-align:top"
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|- style="vertical-align:top"
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|- style="vertical-align:top"
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|- style="vertical-align:top"
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|- style="vertical-align:top"
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|- style="vertical-align:top"
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|- style="vertical-align:top"
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|- style="vertical-align:top"
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|- style="vertical-align:top"
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|- style="vertical-align:top"
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|- style="vertical-align:top"
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|- style="vertical-align:top"
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|- style="vertical-align:top"
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|- style="vertical-align:top"
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|- style="vertical-align:top"
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|- style="vertical-align:top"
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|- style="vertical-align:top"
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|- style="vertical-align:top"
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|- style="vertical-align:top"
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|- style="vertical-align:top"
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|- style="vertical-align:top"
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|- style="vertical-align:top"
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|- style="vertical-align:top"
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|- style="vertical-align:top"
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|- style="vertical-align:top"
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|- style="vertical-align:top"
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|- style="vertical-align:top"
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|- style="vertical-align:top"
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|- style="vertical-align:top"
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|- style="vertical-align:top"
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|- style="vertical-align:top"
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|- style="vertical-align:top"
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*)
|- style="vertical-align:top"
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …)
|- style="vertical-align:top"
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|- style="vertical-align:top"
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|- style="vertical-align:top"
| <code>destructor Destroy</code> || Gibt die Position frei
|- style="vertical-align:top"
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|- style="vertical-align:top"
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|- style="vertical-align:top"
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|- style="vertical-align:top"
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|- style="vertical-align:top"
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|- style="vertical-align:top"
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|- style="vertical-align:top"
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|- style="vertical-align:top"
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|- style="vertical-align:top"
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|- style="vertical-align:top"
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|- style="vertical-align:top"
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|- style="vertical-align:top"
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|- style="vertical-align:top"
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|- style="vertical-align:top"
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|- style="vertical-align:top"
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|- style="vertical-align:top"
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|- style="vertical-align:top"
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|- style="vertical-align:top"
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|- style="vertical-align:top"
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|- style="vertical-align:top"
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|- style="vertical-align:top"
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|- style="vertical-align:top"
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|- style="vertical-align:top"
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|- style="vertical-align:top"
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|- style="vertical-align:top"
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|- style="vertical-align:top"
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|- style="vertical-align:top"
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|- style="vertical-align:top"
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|- style="vertical-align:top"
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|- style="vertical-align:top"
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|- style="vertical-align:top"
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|- style="vertical-align:top"
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|- style="vertical-align:top"
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|- style="vertical-align:top"
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|- style="vertical-align:top"
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|- style="vertical-align:top"
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|- style="vertical-align:top"
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|- style="vertical-align:top"
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|- style="vertical-align:top"
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|- style="vertical-align:top"
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|- style="vertical-align:top"
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|- style="vertical-align:top"
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|- style="vertical-align:top"
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|- style="vertical-align:top"
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|- style="vertical-align:top"
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|- style="vertical-align:top"
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|- style="vertical-align:top"
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|- style="vertical-align:top"
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|- style="vertical-align:top"
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|- style="vertical-align:top"
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|- style="vertical-align:top"
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|- style="vertical-align:top"
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|- style="vertical-align:top"
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|- style="vertical-align:top"
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|- style="vertical-align:top"
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|- style="vertical-align:top"
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|- style="vertical-align:top"
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|- style="vertical-align:top"
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|- style="vertical-align:top"
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|- style="vertical-align:top"
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|- style="vertical-align:top"
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|- style="vertical-align:top"
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|- style="vertical-align:top"
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|- style="vertical-align:top"
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|- style="vertical-align:top"
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|- style="vertical-align:top"
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|- style="vertical-align:top"
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|- style="vertical-align:top"
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|- style="vertical-align:top"
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|- style="vertical-align:top"
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|- style="vertical-align:top"
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|- style="vertical-align:top"
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|- style="vertical-align:top"
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|- style="vertical-align:top"
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|- style="vertical-align:top"
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T11:20:24Z

Nimz: /* TVorgangPosParams_AktualisiereDaten */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>ptPosition</code> || Normale Artikelposition
|-
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|-
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|-
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|-
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|-
| 5 || <code>ptTitel</code> || Titelzeile
|-
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|-
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|-
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|-
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|-
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|-
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|-
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|-
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|-
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|-
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|-
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|-
| <code>cUid</code> || String || UID der Ursprungsposition
|-
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|-
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|-
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|-
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|-
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|-
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|-
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|-
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|-
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|-
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>cNr</code> || String || Merkmalsnummer
|-
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|-
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|-
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|-
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|-
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|-
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|-
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|-
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|-
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|-
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|-
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|-
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|-
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|-
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|-
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|-
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|-
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|-
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|-
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|-
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|-
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|-
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|-
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|-
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|-
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|-
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|-
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|-
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|-
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|-
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|-
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|-
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|-
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|-
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|-
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|-
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|-
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|-
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|-
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|-
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|-
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|-
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|-
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|-
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|-
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|-
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|-
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|-
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|-
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|-
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|-
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|-
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|-
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|-
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|-
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|-
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|-
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|-
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|-
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|-
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|-
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|-
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|-
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|-
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|-
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|-
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|-
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|-
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|-
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|-
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|-
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|-
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|-
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|-
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|-
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|-
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|-
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|-
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|-
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|-
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|-
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|-
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|-
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|-
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|-
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|-
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|-
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|-
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|-
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|-
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|-
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|-
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|-
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|-
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|-
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|-
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|-
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|-
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|-
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|-
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|-
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|-
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|-
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|-
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|-
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|-
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|-
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|-
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|-
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|-
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|-
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|-
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|-
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|-
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|-
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|-
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|-
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|-
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|-
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|-
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|-
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|-
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|-
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|-
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|-
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|-
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|-
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|-
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|-
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|-
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|-
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|-
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|-
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|-
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|-
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|-
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|-
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|-
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|-
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|-
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|-
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|-
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|-
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|-
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|-
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|-
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|-
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|-
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|-
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|-
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|-
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|-
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|-
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|-
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|-
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|-
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|-
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|-
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|-
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|-
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|-
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|-
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|-
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|-
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|-
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|-
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|-
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|-
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|-
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|-
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|-
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|-
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|-
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|-
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|-
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|-
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|-
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|-
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|-
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|-
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|-
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|-
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|-
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|-
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|-
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|-
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|-
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|-
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|-
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|-
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|-
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|-
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|-
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|-
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|-
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|-
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|-
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|-
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|-
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|-
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|-
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|-
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|-
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|-
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|-
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|-
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|-
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|-
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|-
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|-
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|-
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|-
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|-
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|-
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|-
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|-
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|-
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|-
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|-
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|-
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|-
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|-
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|-
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|-
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|-
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|-
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|-
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|-
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|-
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|-
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|-
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|-
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|-
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|-
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|-
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|-
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|-
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|-
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|-
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|-
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|-
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|-
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|-
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|-
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|-
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|-
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|-
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|-
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|-
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|-
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|-
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|-
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|-
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|-
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|-
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|-
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|-
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|-
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|-
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|-
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|-
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|-
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|-
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|-
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|-
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|-
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|-
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|-
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|-
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|-
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|-
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|-
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|-
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|-
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|-
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|-
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|-
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|-
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|-
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|-
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|-
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|-
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|-
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|-
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|-
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|-
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|-
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|-
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|-
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|-
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|-
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|-
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|-
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|-
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|-
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|-
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|-
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|-
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|-
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|-
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|-
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|-
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|-
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|-
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|-
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|-
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|-
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|-
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|-
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|-
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|-
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|-
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|-
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|-
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|-
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|-
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|-
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|-
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|-
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|-
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|-
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|-
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|-
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|-
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|-
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*)
|-
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …)
|-
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|-
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|-
| <code>destructor Destroy</code> || Gibt die Position frei
|-
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|-
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|-
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|-
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|-
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|-
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|-
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|-
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|-
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|-
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|-
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|-
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|-
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|-
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|-
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|-
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|-
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|-
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|-
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|-
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|-
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|-
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|-
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|-
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|-
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|-
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|-
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|-
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|-
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|-
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|-
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|-
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|-
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|-
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|-
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|-
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|-
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|-
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|-
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|-
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|-
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|-
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|-
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|-
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|-
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|-
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|-
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|-
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|-
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|-
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|-
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|-
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|-
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|-
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|-
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|-
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|-
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|-
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|-
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|-
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|-
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|-
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|-
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|-
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|-
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|-
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|-
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|-
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|-
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|-
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|-
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|-
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|-
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|-
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|-
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|-
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|-
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|-
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|-
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|-
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|-
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|-
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|-
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|-
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|-
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|-
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|-
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|-
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|-
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|-
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|-
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|-
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|-
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|-
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|-
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|-
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|-
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|-
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|-
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|-
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|-
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|-
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|-
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|-
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|-
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|-
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T11:19:25Z

Nimz: /* TVorgangPosOriginal */

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>ptPosition</code> || Normale Artikelposition
|-
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|-
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|-
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|-
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|-
| 5 || <code>ptTitel</code> || Titelzeile
|-
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|-
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|-
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|-
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|-
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|-
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|-
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|-
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|-
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|-
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|-
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|-
| <code>cUid</code> || String || UID der Ursprungsposition
|-
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|-
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|-
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>procedure Init(const cVorb: string = '')</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|-
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|-
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|-
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|-
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|-
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|-
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|-
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|-
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>cNr</code> || String || Merkmalsnummer
|-
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|-
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|-
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|-
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|-
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|-
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|-
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|-
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|-
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|-
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|-
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|-
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|-
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|-
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|-
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|-
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|-
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|-
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|-
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|-
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|-
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|-
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|-
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|-
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|-
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|-
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|-
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|-
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|-
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|-
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|-
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|-
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|-
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|-
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|-
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|-
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|-
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|-
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|-
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|-
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|-
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|-
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|-
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|-
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|-
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|-
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|-
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|-
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|-
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|-
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|-
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|-
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|-
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|-
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|-
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|-
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|-
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|-
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|-
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|-
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|-
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|-
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|-
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|-
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|-
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|-
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|-
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|-
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|-
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|-
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|-
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|-
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|-
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|-
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|-
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|-
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|-
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|-
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|-
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|-
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|-
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|-
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|-
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|-
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|-
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|-
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|-
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|-
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|-
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|-
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|-
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|-
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|-
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|-
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|-
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|-
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|-
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|-
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|-
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|-
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|-
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|-
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|-
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|-
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|-
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|-
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|-
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|-
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|-
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|-
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|-
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|-
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|-
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|-
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|-
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|-
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|-
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|-
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|-
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|-
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|-
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|-
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|-
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|-
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|-
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|-
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|-
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|-
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|-
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|-
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|-
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|-
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|-
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|-
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|-
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|-
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|-
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|-
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|-
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|-
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|-
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|-
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|-
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|-
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|-
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|-
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|-
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|-
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|-
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|-
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|-
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|-
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|-
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|-
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|-
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|-
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|-
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|-
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|-
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|-
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|-
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|-
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|-
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|-
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|-
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|-
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|-
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|-
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|-
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|-
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|-
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|-
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|-
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|-
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|-
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|-
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|-
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|-
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|-
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|-
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|-
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|-
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|-
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|-
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|-
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|-
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|-
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|-
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|-
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|-
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|-
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|-
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|-
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|-
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|-
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|-
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|-
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|-
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|-
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|-
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|-
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|-
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|-
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|-
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|-
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|-
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|-
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|-
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|-
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|-
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|-
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|-
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|-
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|-
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|-
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|-
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|-
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|-
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|-
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|-
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|-
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|-
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|-
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|-
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|-
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|-
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|-
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|-
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|-
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|-
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|-
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|-
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|-
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|-
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|-
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|-
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|-
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|-
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|-
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|-
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|-
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|-
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|-
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|-
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|-
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|-
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|-
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|-
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|-
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|-
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|-
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|-
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|-
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|-
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|-
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|-
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|-
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|-
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|-
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|-
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|-
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|-
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|-
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|-
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|-
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|-
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|-
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|-
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|-
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|-
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|-
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|-
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|-
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|-
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|-
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|-
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|-
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|-
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|-
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|-
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|-
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|-
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|-
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|-
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|-
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|-
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|-
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|-
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|-
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|-
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|-
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|-
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|-
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|-
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|-
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|-
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|-
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|-
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|-
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|-
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|-
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|-
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|-
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|-
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|-
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|-
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|-
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|-
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|-
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|-
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|-
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|-
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|-
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|-
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|-
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|-
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|-
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|-
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|-
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|-
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|-
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|-
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|-
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|-
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|-
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*)
|-
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …)
|-
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|-
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|-
| <code>destructor Destroy</code> || Gibt die Position frei
|-
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|-
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|-
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|-
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|-
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|-
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|-
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|-
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|-
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|-
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|-
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|-
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|-
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|-
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|-
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|-
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|-
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|-
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|-
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|-
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|-
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|-
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|-
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|-
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|-
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|-
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|-
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|-
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|-
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|-
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|-
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|-
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|-
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|-
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|-
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|-
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|-
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|-
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|-
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|-
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|-
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|-
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|-
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|-
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|-
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|-
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|-
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|-
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|-
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|-
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|-
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|-
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|-
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|-
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|-
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|-
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|-
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|-
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|-
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|-
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|-
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|-
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|-
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|-
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|-
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|-
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|-
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|-
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|-
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|-
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|-
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|-
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|-
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|-
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|-
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|-
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|-
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|-
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|-
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|-
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|-
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|-
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|-
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|-
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|-
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|-
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|-
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|-
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|-
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|-
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|-
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|-
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|-
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|-
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|-
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|-
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|-
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|-
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|-
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|-
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|-
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|-
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|-
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|-
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|-
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|-
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T11:17:58Z

Nimz:

{{Makros und Scripting}}
Es gibt für die Generierung von Vorgängen eigene Klassen. Da es zwischen den Vorgängen immer irgendwelche Unterschiede gibt, existiert auch für jeden Vorgangs-Typ eine eigene Klasse. 
 
Übersicht Klassen:
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Angebot|Angebot]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Auftrag|Auftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Reparaturauftrag|Reparaturauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Produktionsauftrag|Produktionsauftrag]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Lieferschein|Lieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Rechnung|Rechnung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Bestellung|Bestellung]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkaufslieferschein|Einkaufslieferschein]]
*[[OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge/Einkauf|Einkauf]]

= Datentypen =

== Enumerationen ==

=== TVB_PosType ===
Positionstyp einer [[#TVorgangPos|TVorgangPos]]. Wird über die Property <code>[[#TVorgangPos_Prop_Typ|Typ]]</code> gelesen/gesetzt.
Die zugehörigen String-Konstanten sind unter [[#Konstanten|Konstanten]] beschrieben.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>ptPosition</code> || Normale Artikelposition
|-
| 1 || <code>ptText</code> || Textzeile / Memorundzeile
|-
| 2 || <code>ptLeerzeile</code> || Leere Trennzeile
|-
| 3 || <code>ptZwischensumme</code> || Zwischensummen-Position
|-
| 4 || <code>ptTitelsumme</code> || Titelsummen-Position
|-
| 5 || <code>ptTitel</code> || Titelzeile
|-
| 6 || <code>ptGewerk</code> || Gewerk-Kopfzeile
|-
| 7 || <code>ptSeitenumbruch</code> || Manueller Seitenumbruch
|-
| 8 || <code>ptBild</code> || Bildposition
|}

=== TVB_MaterMode ===
Steuert den Materialmodus beim Lesen von Positionsdaten.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>mmNone</code> || Kein spezieller Materialmodus
|-
| 1 || <code>mmMD5</code> || Materialprüfung per MD5-Hash
|-
| 2 || <code>mmReadUID</code> || Material-UID direkt lesen
|}

=== TVorgangFehlerTyp ===
Klassifiziert einen Eintrag in der internen Fehlerliste eines [[#TVorgang|TVorgang]].
Wird im Record [[#TVorgangFehler|TVorgangFehler]] verwendet.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>vftOther</code> || Sonstiger Hinweis
|-
| 1 || <code>vftCritical</code> || Kritischer Fehler (blockiert Speichern)
|-
| 2 || <code>vftSaveCheck</code> || Prüfung beim Speichern
|-
| 3 || <code>vftPosInfo</code> || Positionsbezogene Information
|}

=== TVorgangFehlerLoeschenLesen ===
Steuert, welche Fehler nach dem Lesen via <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> aus der Liste gelöscht werden.

{| class="wikitable"
! Wert !! Bezeichner !! Beschreibung
|-
| 0 || <code>vfllNone</code> || Kein Fehler nach dem Lesen löschen
|-
| 1 || <code>vfllAll</code> || Alle Fehler nach dem Lesen löschen
|-
| 2 || <code>vfllSkipCritical</code> || Nur nicht-kritische Fehler löschen (Standard)
|}

== Records ==

=== TVorgangPosOriginal ===
Enthält Referenzinformationen der Ursprungsposition (z. B. bei der Vorgangsübernahme).
Wird über die Property <code>[[#TVorgangPos_Prop_OriginalPos|OriginalPos]]</code> einer [[#TVorgangPos|TVorgangPos]] geliefert.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>rDMS</code> || TDMSType || DMS-Typ des Ursprungsvorgangs
|-
| <code>cNr</code> || String || Vorgangsnummer des Ursprungs
|-
| <code>cUid</code> || String || UID der Ursprungsposition
|-
| <code>cSysUid</code> || String || System-UID der Ursprungsposition
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>procedure Clear</code> || Leert alle Felder des Records
|-
| <code>procedure SetData(const ADMS: TDMSType; qPos: TxFQuery)</code> || Befüllt den Record aus einem Positions-Query
|}

=== TVorgangPosParams_AktualisiereDaten ===
Steuert, welche Datenbereiche bei <code>[[#TVorgangPos_Meth_AktualisiereDaten|AktualisiereDaten]]</code> aktualisiert werden sollen.
Wird über die Property <code>[[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]</code> von [[#TVorgang|TVorgang]] gesetzt.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>lTexte</code> || Boolean || Bezeichnungen/Texte aktualisieren
|-
| <code>lEK</code> || Boolean || Einkaufspreise aktualisieren
|-
| <code>lVK</code> || Boolean || Verkaufspreise aktualisieren
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>procedure Init(const cVorb: string = '')</code> || Initialisiert die Parameter mit Standardwerten; optionaler Vorbelegungsschlüssel
|-
| <code>function Aktualisieren(): boolean</code> || Gibt <code>True</code> zurück, wenn mindestens ein Aktualisierungsschalter gesetzt ist
|}

=== TVorgangPosSummen ===
Speichert Zwischen- und Titelsummen-Beträge je Ebene (1 bis <code>VB_MAX_SummenEbenen</code>).

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>aZw[1..9]</code> || Double || Zwischensummen-Beträge je Ebene
|-
| <code>aTit[1..9]</code> || Double || Titelsummen-Beträge je Ebene
|}

'''Methoden:'''
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>procedure Clear</code> || Setzt alle Summen auf 0
|-
| <code>procedure ClearZw(const nEbene: integer)</code> || Setzt Zwischensumme der Ebene nEbene auf 0
|-
| <code>procedure ClearTit(const nEbene: integer)</code> || Setzt Titelsumme der Ebene nEbene auf 0
|-
| <code>procedure AddZw(const nBetrag: double)</code> || Addiert Betrag zur aktiven Zwischensummen-Ebene
|-
| <code>procedure AddTit(const nBetrag: double)</code> || Addiert Betrag zur aktiven Titelsummen-Ebene
|-
| <code>function ReadZw(const nEbene: integer): double</code> || Liefert den Zwischensummen-Betrag der Ebene
|-
| <code>function ReadTit(const nEbene: integer): double</code> || Liefert den Titelsummen-Betrag der Ebene
|}

=== TVorgangEigenschaft ===
Repräsentiert ein Vorgangsmerkmal (Eigenschaft), das per <code>[[#TVorgang_Meth_EigenschaftSetzen|EigenschaftSetzen]]</code> gesetzt wird.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>cNr</code> || String || Merkmalsnummer
|-
| <code>lMode</code> || Boolean || True = setzen, False = löschen
|}

=== TVorgangFehler ===
Ein Eintrag in der internen Fehlerliste von [[#TVorgang|TVorgang]].
Wird per <code>[[#TVorgang_Meth_leseFehler|leseFehler]]</code> ausgelesen.

{| class="wikitable sortable"
! Feld !! Typ !! Beschreibung
|-
| <code>cTitel</code> || String || Fehlertitel (Kurzbeschreibung)
|-
| <code>cText</code> || String || Fehlertext (Detailbeschreibung)
|-
| <code>eTyp</code> || [[#TVorgangFehlerTyp|TVorgangFehlerTyp]] || Fehlerklassifikation
|}

== Konstanten ==

{| class="wikitable sortable"
! Konstante !! Wert !! Beschreibung
|-
| <code>POSTYP_POS</code> || <code>'0'</code> || Positionstyp normale Artikelposition (entspricht [[#TVB_PosType|ptPosition]])
|-
| <code>POSTYP_TXT</code> || <code>'1'</code> || Positionstyp Textzeile (entspricht [[#TVB_PosType|ptText]])
|-
| <code>POSTYP_ELN</code> || <code>'2'</code> || Positionstyp Leerzeile (entspricht [[#TVB_PosType|ptLeerzeile]])
|-
| <code>POSTYP_ZWS</code> || <code>'3'</code> || Positionstyp Zwischensumme (entspricht [[#TVB_PosType|ptZwischensumme]])
|-
| <code>POSTYP_TIS</code> || <code>'4'</code> || Positionstyp Titelsumme (entspricht [[#TVB_PosType|ptTitelsumme]])
|-
| <code>POSTYP_TIT</code> || <code>'7'</code> || Positionstyp Titel (entspricht [[#TVB_PosType|ptTitel]])
|-
| <code>POSTYP_GEW</code> || <code>'8'</code> || Positionstyp Gewerk (entspricht [[#TVB_PosType|ptGewerk]])
|-
| <code>POSTYP_PBR</code> || <code>'17'</code> || Positionstyp Seitenumbruch (entspricht [[#TVB_PosType|ptSeitenumbruch]])
|-
| <code>POSTYP_PIC</code> || <code>'19'</code> || Positionstyp Bild (entspricht [[#TVB_PosType|ptBild]])
|-
| <code>VB_DEFAULT_BezZwischensumme</code> || <code>'ZWISCHENSUMME :'</code> || Standard-Bezeichnung für Zwischensummen-Positionen
|-
| <code>VB_DEFAULT_BezTitelsumme</code> || <code>'TITELSUMME :'</code> || Standard-Bezeichnung für Titelsummen-Positionen
|-
| <code>VB_MAX_SummenEbenen</code> || <code>9</code> || Maximale Anzahl von Summenebenen (Zwischen- und Titelsummen)
|}

=Basisklassen Vorgangsgenerierung=

== TVorgang ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>oMyDB</code> || TxDB || Lesen/Schreiben || Datenbankverbindung des Vorgangs
|-
| <code>oProtokoll</code> || TStringList || Lesen/Schreiben || Protokoll-Liste (Meldungen/Log)
|-
| <code>lMeldung</code> || Boolean || Lesen/Schreiben || Steuert Anzeige von Benutzer-Meldungen
|-
| <code>lSetPSBemAuto</code> || Boolean || Lesen/Schreiben || Automatische Positionsbemerkung setzen
|-
| <code>cVorgNr</code> || String || Lesen/Schreiben || Vorgangsnummer
|-
| <code>cProjNr</code> || String || Lesen/Schreiben || Projektnummer
|-
| <code>lBrutto</code> || Boolean || Lesen/Schreiben || Brutto-Modus aktiv
|-
| <code>cLanguage</code> || String || Lesen/Schreiben || Sprach-Code (intern, z. B. für Formulare)
|-
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer
|-
| <code>cTyp</code> || String || Lesen/Schreiben || Vorgangstyp-Kürzel
|-
| <code>dVorgDat</code> || TDateTime || Lesen/Schreiben || Vorgangsdatum
|-
| <code>dFaelligDat</code> || TDateTime || Lesen/Schreiben || Fälligkeitsdatum
|-
| <code>dBuchDat</code> || TDateTime || Lesen/Schreiben || Buchungsdatum
|-
| <code>dAufDat</code> || TDateTime || Lesen/Schreiben || Auftragsdatum
|-
| <code>cKdNr</code> || String || Lesen/Schreiben || Kundennummer
|-
| <code>cAnrede</code> || String || Lesen/Schreiben || Anrede des Kunden
|-
| <code>cName</code> || String || Lesen/Schreiben || Name des Kunden
|-
| <code>cVorname</code> || String || Lesen/Schreiben || Vorname des Kunden
|-
| <code>cZusatz1</code> || String || Lesen/Schreiben || Adresszusatz 1
|-
| <code>cZusatz2</code> || String || Lesen/Schreiben || Adresszusatz 2
|-
| <code>cStrasse</code> || String || Lesen/Schreiben || Straße der Lieferadresse
|-
| <code>cPostfach</code> || String || Lesen/Schreiben || Postfach
|-
| <code>cLK</code> || String || Lesen/Schreiben || Länderkennzeichen
|-
| <code>cPLZ</code> || String || Lesen/Schreiben || Postleitzahl
|-
| <code>cOrt</code> || String || Lesen/Schreiben || Ort
|-
| <code>cAngebNr</code> || String || Lesen/Schreiben || Angebotsnummer
|-
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer
|-
| <code>cRechNr</code> || String || Lesen/Schreiben || Rechnungsnummer
|-
| <code>cAuftNr</code> || String || Lesen/Schreiben || Auftragsnummer
|-
| <code>cRepaNr</code> || String || Lesen/Schreiben || Reparaturauftragsnummer
|-
| <code>cEinkaufsNr</code> || String || Lesen/Schreiben || Einkaufsnummer
|-
| <code>cBestellNr</code> || String || Lesen/Schreiben || Bestellnummer
|-
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (globaler Standardtext)
|-
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|-
| <code>cKopftext</code> || String || Lesen/Schreiben || Kopftext des Vorgangs
|-
| <code>cFusstext</code> || String || Lesen/Schreiben || Fußtext des Vorgangs
|-
| <code>nNBetrag</code> || Double || Lesen/Schreiben || Nettobetrag gesamt
|-
| <code>nBBetrag</code> || Double || Lesen/Schreiben || Bruttobetrag gesamt
|-
| <code>nEKBetrag</code> || Double || Lesen/Schreiben || Einkaufsbetrag gesamt
|-
| <code>nRabattBetrag</code> || Double || Lesen/Schreiben || Rabattbetrag gesamt
|-
| <code>nRabattProz</code> || Double || Lesen/Schreiben || Rabattprozentsatz gesamt
|-
| <code>nAnzahlung</code> || Double || Lesen/Schreiben || Anzahlungsbetrag
|-
| <code>nPorto</code> || Double || Lesen/Schreiben || Portokosten
|-
| <code>nVerpackung</code> || Double || Lesen/Schreiben || Verpackungskosten
|-
| <code>lSplitPoVe</code> || Boolean || Lesen/Schreiben || Porto und Verpackung getrennt ausweisen
|-
| <code>cVersand</code> || String || Lesen/Schreiben || Versandart
|-
| <code>cWaehr</code> || String || Lesen/Schreiben || Währungskürzel
|-
| <code>cFormul</code> || String || Lesen/Schreiben || Formularnummer/-kürzel
|-
| <code>cVAnr</code> || String || Lesen/Schreiben || Versandanrede
|-
| <code>cVName1</code> || String || Lesen/Schreiben || Versandname 1
|-
| <code>cVName2</code> || String || Lesen/Schreiben || Versandname 2
|-
| <code>cVZusatz</code> || String || Lesen/Schreiben || Versandadresse Zusatz
|-
| <code>cVStrasse</code> || String || Lesen/Schreiben || Versandstraße
|-
| <code>cVLK</code> || String || Lesen/Schreiben || Versand-Länderkennzeichen
|-
| <code>cVPLZ</code> || String || Lesen/Schreiben || Versand-PLZ
|-
| <code>cVOrt</code> || String || Lesen/Schreiben || Versandort
|-
| <code>cVUID</code> || String || Lesen/Schreiben || Versandadresse UID
|-
| <code>cPrio</code> || String || Lesen/Schreiben || Priorität des Vorgangs
|-
| <code>cAuftNrKd</code> || String || Lesen/Schreiben || Auftrags-/Bestellnummer des Kunden
|-
| <code>cBesteller</code> || String || Lesen/Schreiben || Besteller (Person)
|-
| <code>cSachb</code> || String || Lesen/Schreiben || Sachbearbeiter
|-
| <code>cRabPosJN</code> || String || Lesen/Schreiben || Positionsrabatt anzeigen J/N
|-
| <code>cMWSTJN</code> || String || Lesen/Schreiben || Mehrwertsteuer ausweisen J/N
|-
| <code>cSText1</code> || String || Lesen/Schreiben || Sondertext 1
|-
| <code>cSText2</code> || String || Lesen/Schreiben || Sondertext 2
|-
| <code>cSText3</code> || String || Lesen/Schreiben || Sondertext 3
|-
| <code>cSText4</code> || String || Lesen/Schreiben || Sondertext 4
|-
| <code>cSText5</code> || String || Lesen/Schreiben || Sondertext 5
|-
| <code>cSText6</code> || String || Lesen/Schreiben || Sondertext 6
|-
| <code>cSText7</code> || String || Lesen/Schreiben || Sondertext 7
|-
| <code>cPreisJN</code> || String || Lesen/Schreiben || Preis auf Dokument drucken J/N
|-
| <code>cMwStAbs</code> || String || Lesen/Schreiben || MwSt-Absetzungstext/-Kürzel
|-
| <code>dLiefDat</code> || TDateTime || Lesen/Schreiben || Lieferdatum
|-
| <code>cDeleted</code> || String || Lesen/Schreiben || Gelöscht-Kennzeichen
|-
| <code>dLDat2</code> || TDateTime || Lesen/Schreiben || Zweites Lieferdatum
|-
| <code>cSprache</code> || String || Lesen/Schreiben || Sprache des Vorgangs
|-
| <code>cReEmpf</code> || String || Lesen/Schreiben || Rechnungsempfänger-Nummer
|-
| <code>cReAnrede</code> || String || Lesen/Schreiben || Rechnungsempfänger-Anrede
|-
| <code>cReName</code> || String || Lesen/Schreiben || Rechnungsempfänger-Name
|-
| <code>cReVorname</code> || String || Lesen/Schreiben || Rechnungsempfänger-Vorname
|-
| <code>cReZusatz1</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 1
|-
| <code>cReZusatz2</code> || String || Lesen/Schreiben || Rechnungsempfänger-Adresszusatz 2
|-
| <code>cReStrasse</code> || String || Lesen/Schreiben || Rechnungsempfänger-Straße
|-
| <code>cRePostfach</code> || String || Lesen/Schreiben || Rechnungsempfänger-Postfach
|-
| <code>cReLK</code> || String || Lesen/Schreiben || Rechnungsempfänger-Länderkennzeichen
|-
| <code>cRePLZ</code> || String || Lesen/Schreiben || Rechnungsempfänger-PLZ
|-
| <code>cReOrt</code> || String || Lesen/Schreiben || Rechnungsempfänger-Ort
|-
| <code>cVertreter</code> || String || Lesen/Schreiben || Vertreter-Kürzel
|-
| <code>cVerbucht</code> || String || Lesen/Schreiben || Verbucht-Kennzeichen
|-
| <code>cLager</code> || String || Lesen/Schreiben || Lager-Kürzel
|-
| <code>cRechFrei</code> || String || Lesen/Schreiben || Rechnungsfreigabe-Kennzeichen
|-
| <code>cBonNr</code> || String || Lesen/Schreiben || Bonnummer (Kasse)
|-
| <code>cMandant</code> || String || Lesen/Schreiben || Mandantenkürzel
|-
| <code>nMwStDM</code> || Double || Lesen/Schreiben || MwSt-Betrag in DM (Altwährung)
|-
| <code>nKursDM</code> || Double || Lesen/Schreiben || Wechselkurs DM
|-
| <code>nAbschlag</code> || Double || Lesen/Schreiben || Abschlagsbetrag
|-
| <code>nZBetrag</code> || Double || Lesen/Schreiben || Zahlungsbetrag
|-
| <code>nZSkonto</code> || Double || Lesen/Schreiben || Skonto-Betrag
|-
| <code>dZDatum</code> || TDateTime || Lesen/Schreiben || Zahlungsdatum
|-
| <code>cMemo</code> || String || Lesen/Schreiben || Memofeld des Vorgangs
|-
| <code>nValuta</code> || Integer || Lesen/Schreiben || Valutatage
|-
| <code>cKostenst</code> || String || Lesen/Schreiben || Kostenstelle
|-
| <code>cKostentraeger</code> || String || Lesen/Schreiben || Kostenträger
|-
| <code>cKalkGr</code> || String || Lesen/Schreiben || Kalkulationsgruppe
|-
| <code>cFrachtV</code> || String || Lesen/Schreiben || Frachtart/-vorschrift
|-
| <code>nFrachtK</code> || Double || Lesen/Schreiben || Frachtkosten
|-
| <code>nFrachtG</code> || Integer || Lesen/Schreiben || Frachtgewicht
|-
| <code>cGruppe</code> || String || Lesen/Schreiben || Vorgangsgruppe
|-
| <code>nPosInc</code> || Integer || Lesen/Schreiben || Positionsnummer-Inkrement
|-
| <code>cFiliale</code> || String || Lesen/Schreiben || Filialkürzel
|-
| <code>cRabText</code> || String || Lesen/Schreiben || Rabatttextfeld (kurz)
|-
| <code>cErfasser</code> || String || Lesen/Schreiben || Erfasser des Vorgangs
|-
| <code>nSKFBetrag</code> || Double || Lesen/Schreiben || Skontofähiger Betrag
|-
| <code>lLiefStrecke</code> || Boolean || Lesen/Schreiben || Lieferstreckengeschäft aktiv
|-
| <code>cBetreff</code> || String || Lesen/Schreiben || Betreffzeile
|-
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo (erscheint auf Dokument)
|-
| <code>cLieferLiefNr</code> || String || Lesen/Schreiben || Lieferanten-Lieferscheinnummer
|-
| <code>cRabattText</code> || String || Lesen/Schreiben || Rabatttext (lang)
|-
| <code>cSysUid</code> || String || Lesen/Schreiben || System-UID des Vorgangs
|-
| <code>lLeistPreis2</code> || Boolean || Lesen/Schreiben || Leistungspreis 2 verwenden
|-
| <code>cFunction</code> || String || Lesen/Schreiben || Funktionskürzel (Scripting-Hook)
|-
| <code>lSaveAllowed</code> || Boolean || Lesen/Schreiben || Speichern erlaubt
|-
| <code>lVorgangsSperre</code> || Boolean || Lesen/Schreiben || Vorgang gesperrt
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>DmsTyp</code> || String || Lesen/Schreiben || DMS-Typ des Vorgangs (z. B. AN, AU, LS, RE)
|-
| <code>MainTable</code> || String || Lesen/Schreiben || Haupttabelle des Vorgangs (Datenbankname)
|-
| <code>PosTable</code> || String || Lesen/Schreiben || Positionstabelle des Vorgangs
|-
| <code>cPosFormat</code> || String || Lesen/Schreiben || Positionsnummern-Format
|-
| <code>ParameterPositionsdatenAktualisieren</code> || [[#TVorgangPosParams_AktualisiereDaten|TVorgangPosParams_AktualisiereDaten]] || Lesen/Schreiben || Parameter für Massenaktualisierung von Positionsdaten
|-
| <code>PnPosCnt</code> || Integer || Lesen/Schreiben || Anzahl der Positionen im Vorgang
|-
| <code>PaPositionen[Index]</code> || [[#TVorgangPos|TVorgangPos]] || Lesen/Schreiben || Array der Positionsobjekte (0-basiert)
|-
| <code>PcRabGrPers</code> || String || Nur Lesen || Rabattgruppe der Person (aus Stammdaten ermittelt)
|-
| <code>PcVKdNr</code> || String || Lesen/Schreiben || VK-Kundennummer (alternativ zur cKdNr für Preisfindung)
|-
| <code>nNet1</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 1
|-
| <code>nNet2</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 2
|-
| <code>nNet3</code> || Double || Lesen/Schreiben || Nettobetrag MwSt-Schlüssel 3
|-
| <code>nBrutto1</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 1
|-
| <code>nBrutto2</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 2
|-
| <code>nBrutto3</code> || Double || Lesen/Schreiben || Bruttobetrag MwSt-Schlüssel 3
|-
| <code>nMwSt1</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 1
|-
| <code>nMwSt2</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 2
|-
| <code>nMwSt3</code> || Double || Lesen/Schreiben || MwSt-Betrag Schlüssel 3
|-
| <code>cMwStSchl1</code> || String || Lesen/Schreiben || MwSt-Schlüssel 1
|-
| <code>cMwStSchl2</code> || String || Lesen/Schreiben || MwSt-Schlüssel 2
|-
| <code>cMwStSchl3</code> || String || Lesen/Schreiben || MwSt-Schlüssel 3
|-
| <code>cKeineVersPausch</code> || String || Lesen/Schreiben || Keine Versandpauschale berechnen J/N
|-
| <code>cZahlBed</code> || String || Lesen/Schreiben || Zahlungsbedingung
|-
| <code>lNewVorgang</code> || Boolean || Nur Lesen || Neuer (noch nicht gespeicherter) Vorgang
|-
| <code>cKopfNr</code> || String || Lesen/Schreiben || Kopftextbaustein-Nummer
|-
| <code>cFussNr</code> || String || Lesen/Schreiben || Fußtextbaustein-Nummer
|-
| <code>cLiefStrecke</code> || String || Lesen/Schreiben || Lieferstrecken-Kürzel
|-
| <code>cStatus</code> || String || Lesen/Schreiben || Status des Vorgangs
|-
| <code>cStatM</code> || String || Lesen/Schreiben || Material-Status
|-
| <code>cStatS</code> || String || Lesen/Schreiben || Service-Status
|-
| <code>cStatL</code> || String || Lesen/Schreiben || Lieferstatus
|-
| <code>cStatR</code> || String || Lesen/Schreiben || Rechnungsstatus
|-
| <code>cColStatus</code> || String || Lesen/Schreiben || Farb-/Anzeigestatus (für UI)
|-
| <code>cZustand</code> || String || Lesen/Schreiben || Zustandskenner des Vorgangs
|-
| <code>cArt</code> || String || Lesen/Schreiben || Vorgangsart-Kürzel
|-
| <code>cBonusJN</code> || String || Lesen/Schreiben || Bonus berechnen J/N
|-
| <code>cVersandkostenMBW</code> || String || Lesen/Schreiben || Versandkosten-Mindestbestellwert-Kennzeichen
|-
| <code>cWKNr</code> || String || Lesen/Schreiben || Werbungskosten-Nummer
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>constructor Create(const cUid: string; oxDB: TxDB; cDmsType: string)</code> || Erstellt einen neuen Vorgang mit UID, Datenbankverbindung und DMS-Typ
|-
| <code>destructor Destroy</code> || Gibt den Vorgang und alle Ressourcen frei
|-
| <code>function SemaphoreCreate(cFName: string; lMeldung: boolean = False; cWait: string = ''): boolean</code> || Erstellt eine Datei-Semaphore (Sperrdatei); gibt True zurück wenn erfolgreich
|-
| <code>function SemaphoreInUse(cFName: string): boolean</code> || Prüft ob die Semaphore-Datei bereits in Verwendung ist
|-
| <code>procedure SemaphoreReleaseAll</code> || Gibt alle Semaphoren dieses Vorgangs frei
|-
| <code>procedure SemaphoreRelease(cFName: string)</code> || Gibt eine bestimmte Semaphore frei
|-
| <code>function IstAngebot(): boolean</code> || Gibt True zurück wenn der Vorgang ein Angebot ist
|-
| <code>function IstAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Auftrag ist
|-
| <code>function IstReparaturAuftrag(): boolean</code> || Gibt True zurück wenn der Vorgang ein Reparaturauftrag ist
|-
| <code>function IstLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein Lieferschein ist
|-
| <code>function IstRechnung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Rechnung ist
|-
| <code>function IstBestellung(): boolean</code> || Gibt True zurück wenn der Vorgang eine Bestellung ist
|-
| <code>function IstAnfrage(): boolean</code> || Gibt True zurück wenn der Vorgang eine Anfrage ist
|-
| <code>function IstEKLieferschein(): boolean</code> || Gibt True zurück wenn der Vorgang ein EK-Lieferschein ist
|-
| <code>function IstEinkauf(): boolean</code> || Gibt True zurück wenn der Vorgang ein Einkaufsvorgang ist
|-
| <code>function IstVG_VK(): boolean</code> || Gibt True zurück wenn es sich um einen Verkaufsvorgang handelt
|-
| <code>function IstVG_EK(): boolean</code> || Gibt True zurück wenn es sich um einen Einkaufsvorgang handelt
|-
| <code>function NeuNumLock(): boolean</code> || Sperrt die Neunummerierung (verhindert parallele Vergabe)
|-
| <code>procedure NeuNumLockRelease</code> || Gibt die Neunummerierungssperre wieder frei
|-
| <code>function VorgNeuNum(cFilter: string = ''; lAbweichend: boolean = false): string</code> || Ermittelt und setzt eine neue Vorgangsnummer; gibt die Nummer als String zurück
|-
| <code>function VorgNeuNumBool(cFilter: string = ''; lAbweichend: boolean = false): boolean</code> || Wie VorgNeuNum, gibt True/False zurück (für Fehlerbehandlung)
|-
| <code>function IstVorgNrGueltig(cUID: string = ''): boolean</code> || Prüft ob die aktuelle Vorgangsnummer gültig (eindeutig) ist
|-
| <code>function NeuePositionBase(const cUID: string): [[#TVorgangPos|TVorgangPos]]</code> || Legt eine neue Positionsinstanz an und fügt sie dem Vorgang hinzu
|-
| <code>procedure NeuePositionBaseMS(const cUID: string; oOrgPos: [[#TVorgangPos|TVorgangPos]])</code> || Legt eine neue Position als Multi-Steuer-Folgeposition an
|-
| <code>function LoeschePositionBase(nDel: integer): Boolean</code> || Löscht die Position mit dem angegebenen Index
|-
| <code>procedure VerschiebePositionBase(nPos: integer; nZiel: integer)</code> || Verschiebt Position von Index nPos zu Index nZiel
|-
| <code>function CheckIfNotNull(): Boolean</code> || Prüft ob Pflichtfelder des Vorgangs befüllt sind
|-
| <code>function CheckIfFirstPosOption(): Boolean</code> || Prüft ob die erste Position eine Optionsposition ist
|-
| <code>function IsPosBerechnung(cPosArt: string): boolean</code> || Prüft ob eine Positionsart als Berechnungsposition gilt
|-
| <code>procedure CopyFrom(oSrc: [[#TVorgang|TVorgang]])</code> || Kopiert alle Felder aus einem anderen Vorgang
|-
| <code>procedure KalkAll(lZusatz: boolean = true)</code> || Kalkuliert alle Positionen und Gesamtsummen neu
|-
| <code>procedure Check_Multisteuer(oOrgPos: [[#TVorgangPos|TVorgangPos]]; const cTable, cMUID, cRefNr: string)</code> || Prüft und setzt Multi-Steuer-Verknüpfung für eine Position
|-
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (per UID)
|-
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (per UID)
|-
| <code>procedure fillVersandkostenMBW(const cPsNr: string; const cPsVersand: string = ''; const PsZusatz: string = '')</code> || Berechnet und setzt Versandkosten auf Basis Mindestbestellwert
|-
| <code>procedure FillPersonBase(qPers: TxFQuery)</code> || Befüllt Adressfelder des Vorgangs aus einem Personen-Query
|-
| <code>function FillReEmpf(const AReEmpf: string; const AZahlBed: string = ''): boolean</code> || Setzt Rechnungsempfänger und optionale Zahlungsbedingung
|-
| <code>function SaveRecord(cUID: string = ''; lAlleSpeichern: boolean = false): Boolean</code> || Speichert den Vorgang (abstrakt – muss in abgeleiteter Klasse implementiert werden)
|-
| <code>function ReadVorgangTypBase(cDmsTyp: string; const cNr: string; lPos: boolean = false; lNeg: boolean = false): boolean</code> || Liest einen Vorgang anhand DMS-Typ und Nummer in das Objekt
|-
| <code>function JahrNr(): string</code> || Gibt das Jahr der Vorgangsnummer zurück
|-
| <code>procedure NeuNumPos(const lNurPos: boolean = True)</code> || Nummeriert alle Positionen neu
|-
| <code>function EigenschaftSetzen(const ANr: string; const AMode: boolean): boolean</code> || Setzt oder löscht eine Vorgangseigenschaft (Merkmal) per Nummer
|-
| <code>procedure AdresseLeeren</code> || Leert alle Adressfelder des Vorgangs
|-
| <code>procedure VersandLeeren(lRef: boolean = True)</code> || Leert alle Versandadressfelder
|-
| <code>procedure ReEmpfLeeren(const lNurAdr: boolean = False)</code> || Leert Rechnungsempfänger-Felder (optional nur Adresse)
|-
| <code>procedure DoServiceTouch(cStatus: string = '')</code> || Aktualisiert Service-Zeitstempel und optionalen Status
|-
| <code>function AuswahlParameterPositionsdatenAktualisieren(const cXDataTable: string): boolean</code> || Zeigt Dialog zur Auswahl der Aktualisierungsparameter für Positionsdaten
|-
| <code>function ZusatzkostenAktiv(): boolean</code> || Gibt True zurück wenn Zusatzkostenmodul für diesen Vorgang aktiv ist
|-
| <code>function leseFehler(out rFehler: [[#TVorgangFehler|TVorgangFehler]]; var nIdx: integer; const eLoeschenNachLesen: [[#TVorgangFehlerLoeschenLesen|TVorgangFehlerLoeschenLesen]] = vfllSkipCritical): boolean</code> || Liest den nächsten Fehler aus der internen Fehlerliste
|}

== TVorgangPos ==

=== Variablen ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>nPosIndex</code> || Integer || Lesen/Schreiben || Laufender Index der Position im Positions-Array
|-
| <code>cNr</code> || String || Lesen/Schreiben || Interne Positionsnummer (Datenbankfeld)
|-
| <code>cKundNr</code> || String || Lesen/Schreiben || Kundennummer an der Position
|-
| <code>cAuftragsNr</code> || String || Lesen/Schreiben || Referenz-Auftragsnummer
|-
| <code>cBestellNr</code> || String || Lesen/Schreiben || Referenz-Bestellnummer
|-
| <code>cPosText</code> || String || Lesen/Schreiben || Positionstext (Langtextfeld)
|-
| <code>cLProjNr</code> || String || Lesen/Schreiben || Leistungsprojektnummer
|-
| <code>cLS_azUid</code> || String || Lesen/Schreiben || Lieferschein-Abrechnungszeilen-UID
|-
| <code>cVersandNr</code> || String || Lesen/Schreiben || Versandnummer
|-
| <code>cPosNr</code> || String || Lesen/Schreiben || Positionsnummer (formatiert)
|-
| <code>cPosNr2</code> || String || Lesen/Schreiben || Zweite Positionsnummer (alternativ)
|-
| <code>cPosKas</code> || String || Lesen/Schreiben || Kassier-Positionsnummer
|-
| <code>cLeistungsNr</code> || String || Lesen/Schreiben || Leistungsnummer
|-
| <code>cBezeichnung1</code> || String || Lesen/Schreiben || Bezeichnung Zeile 1
|-
| <code>cBezeichnung2</code> || String || Lesen/Schreiben || Bezeichnung Zeile 2
|-
| <code>nUrMenge</code> || Double || Lesen/Schreiben || Ursprungsmenge (vor Änderungen)
|-
| <code>nLeistFaktor</code> || Double || Lesen/Schreiben || Leistungsfaktor (Multiplikator für Mengenberechnung)
|-
| <code>cEinheit</code> || String || Lesen/Schreiben || Mengeneinheit
|-
| <code>nMengeG</code> || Integer || Lesen/Schreiben || Mengenganz (ganzzahliger Mengenanteil)
|-
| <code>nKolli</code> || Integer || Lesen/Schreiben || Kollianzahl
|-
| <code>cVerpackung</code> || String || Lesen/Schreiben || Verpackungsart/-kürzel
|-
| <code>nInhalt</code> || Double || Lesen/Schreiben || Inhalt pro Verpackungseinheit
|-
| <code>nEPreis</code> || Double || Lesen/Schreiben || Einzelpreis (Netto)
|-
| <code>nBEPreis</code> || Double || Lesen/Schreiben || Brutto-Einzelpreis
|-
| <code>nOBPreis</code> || Double || Lesen/Schreiben || Original-Brutto-Einzelpreis (vor Rabatt)
|-
| <code>nUrPreis</code> || Double || Lesen/Schreiben || Ursprungspreis (Listenpreis VK)
|-
| <code>nUrPreisEK</code> || Double || Lesen/Schreiben || Ursprungspreis Einkauf
|-
| <code>nGPreis</code> || Double || Lesen/Schreiben || Gesamtpreis (Netto)
|-
| <code>nBGPreis</code> || Double || Lesen/Schreiben || Brutto-Gesamtpreis
|-
| <code>nEKPreis</code> || Double || Lesen/Schreiben || Einkaufspreis
|-
| <code>nEKSPreis</code> || Double || Lesen/Schreiben || Einkaufssonderpreis
|-
| <code>cManPreis</code> || String || Lesen/Schreiben || Manueller Preis J/N-Kennzeichen
|-
| <code>nRabatt</code> || Double || Lesen/Schreiben || Gesamtrabatt in Prozent
|-
| <code>nRabatt1</code> || Double || Lesen/Schreiben || Rabatt 1 in Prozent
|-
| <code>cRabArt1</code> || String || Lesen/Schreiben || Rabattart 1 (Herkunftskennzeichen)
|-
| <code>nRabatt2</code> || Double || Lesen/Schreiben || Rabatt 2 in Prozent
|-
| <code>cRabArt2</code> || String || Lesen/Schreiben || Rabattart 2
|-
| <code>nRabatt3</code> || Double || Lesen/Schreiben || Rabatt 3 in Prozent
|-
| <code>cRabArt3</code> || String || Lesen/Schreiben || Rabattart 3
|-
| <code>nRabatt4</code> || Double || Lesen/Schreiben || Rabatt 4 in Prozent
|-
| <code>cRabArt4</code> || String || Lesen/Schreiben || Rabattart 4
|-
| <code>nRabatt5</code> || Double || Lesen/Schreiben || Rabatt 5 in Prozent
|-
| <code>cRabArt5</code> || String || Lesen/Schreiben || Rabattart 5
|-
| <code>nAddSub</code> || Double || Lesen/Schreiben || Additions-/Subtraktionsbetrag (Zuschlag/Abzug absolut)
|-
| <code>cKonto</code> || String || Lesen/Schreiben || Buchungskonto
|-
| <code>cLagNr</code> || String || Lesen/Schreiben || Lagernummer der Position
|-
| <code>cLagONr</code> || String || Lesen/Schreiben || Lager-Ortsnummer
|-
| <code>cVerkaufer</code> || String || Lesen/Schreiben || Verkäuferkürzel
|-
| <code>cStatus</code> || String || Lesen/Schreiben || Positionsstatus
|-
| <code>cAngebotsNr</code> || String || Lesen/Schreiben || Referenz-Angebotsnummer
|-
| <code>cUID</code> || String || Lesen/Schreiben || Eindeutige ID der Position (GUID)
|-
| <code>cMUID</code> || String || Lesen/Schreiben || Multi-Steuer-UID (Verknüpfung bei Multisteuer)
|-
| <code>cRTVon</code> || String || Lesen/Schreiben || Rücktragungs-Referenz (von welcher Position)
|-
| <code>cSpNr</code> || String || Lesen/Schreiben || Speditionsnummer
|-
| <code>cBestellUID</code> || String || Lesen/Schreiben || UID der verknüpften Bestellposition
|-
| <code>cMaterialUID</code> || String || Lesen/Schreiben || UID des verknüpften Materialeintrags
|-
| <code>cEiliUID</code> || String || Lesen/Schreiben || UID der Eillieferungsposition
|-
| <code>cXUID1</code> || String || Lesen/Schreiben || Erweiterungs-UID 1 (freie Verknüpfung)
|-
| <code>cXUID2</code> || String || Lesen/Schreiben || Erweiterungs-UID 2
|-
| <code>cXUID3</code> || String || Lesen/Schreiben || Erweiterungs-UID 3
|-
| <code>cXUID4</code> || String || Lesen/Schreiben || Erweiterungs-UID 4
|-
| <code>cKommentar</code> || String || Lesen/Schreiben || Kommentarfeld der Position
|-
| <code>nProvision</code> || Double || Lesen/Schreiben || Provisionsanteil in Prozent
|-
| <code>cLiefKz</code> || String || Lesen/Schreiben || Lieferkennzeichen
|-
| <code>cProdGr</code> || String || Lesen/Schreiben || Produktgruppe
|-
| <code>nFrachtV</code> || Double || Lesen/Schreiben || Frachtvolumen der Position
|-
| <code>cLSNr</code> || String || Lesen/Schreiben || Lieferscheinnummer der Position
|-
| <code>dLSDatum</code> || TDateTime || Lesen/Schreiben || Lieferscheindatum der Position
|-
| <code>cPosArt</code> || String || Lesen/Schreiben || Positionsart (z. B. N=Normal, O=Optional)
|-
| <code>cSKFJN</code> || String || Lesen/Schreiben || Skontofähig J/N
|-
| <code>cEKHerkunft</code> || String || Lesen/Schreiben || EK-Preisherkunft-Kürzel
|-
| <code>cLiefNr</code> || String || Lesen/Schreiben || Lieferantennummer
|-
| <code>cLagStreck</code> || String || Lesen/Schreiben || Lager-Streckenkennzeichen
|-
| <code>cAufschlag</code> || String || Lesen/Schreiben || Aufschlagskürzel
|-
| <code>nStaffelPreis</code> || Integer || Lesen/Schreiben || Staffelpreisstufe (Index)
|-
| <code>nStaffelmenge</code> || Double || Lesen/Schreiben || Staffelmenge für Preisfindung
|-
| <code>lAktionspreis</code> || Boolean || Lesen/Schreiben || Aktionspreis aktiv
|-
| <code>cAusdruckJN</code> || String || Lesen/Schreiben || Position drucken J/N
|-
| <code>cMemoDruck</code> || String || Lesen/Schreiben || Druckmemo der Position
|-
| <code>cBildUID</code> || String || Lesen/Schreiben || UID des verknüpften Bildes
|-
| <code>cCMPUID</code> || String || Lesen/Schreiben || CMP-Objekt-UID
|-
| <code>cZeit_CMPUID</code> || String || Lesen/Schreiben || Zeiterfassungs-CMP-UID
|-
| <code>cZeit_Text</code> || String || Lesen/Schreiben || Zeiterfassungstext
|-
| <code>cZeit_Mitarb</code> || String || Lesen/Schreiben || Mitarbeiter der Zeiterfassung
|-
| <code>dZeit_Date</code> || TDateTime || Lesen/Schreiben || Datum der Zeiterfassung
|-
| <code>cZeit_NurLei</code> || String || Lesen/Schreiben || Zeiterfassung: nur Leistung J/N
|-
| <code>cKostst</code> || String || Lesen/Schreiben || Kostenstelle der Position
|-
| <code>dAbrechVon</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum von
|-
| <code>dAbrechBis</code> || TDateTime || Lesen/Schreiben || Abrechnungszeitraum bis
|-
| <code>lNeuNum</code> || Boolean || Lesen/Schreiben || Neunummerierung für diese Position ausführen
|-
| <code>cSysUID</code> || String || Lesen/Schreiben || System-UID der Position
|-
| <code>cGeraetNr</code> || String || Lesen/Schreiben || Gerätenummer (für Servicepositionen)
|}

=== Properties ===
{| class="wikitable sortable"
! Name !! Typ !! Zugriff !! Beschreibung
|-
| <code>oMyDB</code> || TxDB || Nur Lesen || Datenbankverbindung (vom Vorgang geerbt)
|-
| <code>ShopNr</code> || String || Nur Lesen || Shop-Nummer (für Mehrshop-Preisfindung)
|-
| <code>cArtikelNr</code> || String || Lesen/Schreiben || Artikelnummer (Zugriff über Property wegen Seiteneffekten)
|-
| <code>PcMWSTSch</code> || String || Lesen/Schreiben || MwSt-Schlüssel (Parameter-Feld)
|-
| <code>PcMengeIn</code> || String || Lesen/Schreiben || Mengeneingabe als String (Parameter)
|-
| <code>PnMengeIn</code> || Double || Lesen/Schreiben || Mengeneingabe als Zahl (Parameter)
|-
| <code>PnMengeInFak</code> || Double || Lesen/Schreiben || Mengeneingabe-Faktor (Parameter)
|-
| <code>PcMemofeld</code> || String || Lesen/Schreiben || Memofeld der Position (Parameter-Feld, Unicode)
|-
| <code>PcMemofeldAnsi</code> || String || Lesen/Schreiben || Memofeld ANSI-Version (Parameter-Feld)
|-
| <code>cPosLaufend</code> || String || Lesen/Schreiben || Laufende Positionsnummer als String
|-
| <code>lVerbrauchsMater</code> || Boolean || Lesen/Schreiben || Verbrauchsmaterial-Kennzeichen
|-
| <code>nMenge</code> || Double || Lesen/Schreiben || Menge der Position (mit Seiteneffekten bei Schreiben)
|-
| <code>cTyp</code> || String || Lesen/Schreiben || Positionstyp als String – siehe [[#Konstanten|Konstanten]] (POSTYP_*)
|-
| <code>Typ</code> || [[#TVB_PosType|TVB_PosType]] || Lesen/Schreiben || Positionstyp als Enum (ptPosition, ptText, ptLeerzeile …)
|-
| <code>OriginalPos</code> || [[#TVorgangPosOriginal|TVorgangPosOriginal]] || Nur Lesen || Ursprungspositionsdaten (DMS-Referenz, Nr, UID, SysUID)
|}

=== Methoden ===
{| class="wikitable"
! Signatur !! Beschreibung
|-
| <code>constructor Create(oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position für den angegebenen Vorgang (veraltet, UID-Variante bevorzugen)
|-
| <code>constructor Create(cUid: string; oxVorgang: [[#TVorgang|TVorgang]]; cPosTbl: string)</code> || Erstellt eine neue Position mit vorgegebener UID
|-
| <code>destructor Destroy</code> || Gibt die Position frei
|-
| <code>procedure PositionsVorbelegung</code> || Befüllt die Position mit Standardwerten aus den Vorgangsdaten
|-
| <code>procedure GenNewUid</code> || Generiert eine neue UID für diese Position
|-
| <code>function CopyPosmenge(cFromUID: string): string</code> || Kopiert Mengen aus einer anderen Position (per UID)
|-
| <code>function CopyPosverp(cFromUID: string): string</code> || Kopiert Verpackungsdaten aus einer anderen Position (per UID)
|-
| <code>procedure CopyFrom(oSrc: [[#TVorgangPos|TVorgangPos]]; lFull: boolean = False)</code> || Kopiert alle Felder aus einer anderen Position; lFull=True kopiert auch interne Felder
|-
| <code>procedure QueryToPos(qTmp: TxFQuery; lReadAsNew: boolean = false)</code> || Befüllt die Position aus einem Datenbankquery (Überladung 1)
|-
| <code>procedure QueryToPos(qTmp: TxFQuery; const cFromTable: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Befüllt die Position aus einem Query mit expliziter Quelltabelle (Überladung 2)
|-
| <code>procedure DBPosToPos(const cFromTable: string; const cSysUid: string; lVerpack: Boolean = False; lUmkehr: boolean = False)</code> || Liest eine Position direkt aus der Datenbank per SysUID
|-
| <code>function FillArtikel(cArtNr: string): boolean</code> || Befüllt die Position mit Artikelstammdaten; gibt True bei Erfolg zurück
|-
| <code>function SetzeLieferant(const cLiefNr: string; lEKNeu: boolean = True; lDefaultEK1: boolean = False): boolean</code> || Setzt den Lieferanten und aktualisiert EK-Preise
|-
| <code>procedure FillLeistung(cLeistNr: string)</code> || Befüllt die Position mit Leistungsstammdaten
|-
| <code>function SumPosBez(const eZielTyp: [[#TVB_PosType|TVB_PosType]]; const cBezVorb: string): string</code> || Gibt die Bezeichnung für eine Summenposition zurück
|-
| <code>procedure Typ_Pos</code> || Setzt den Positionstyp auf &bdquo;normale Position“
|-
| <code>procedure Typ_Text(const cText: string)</code> || Setzt den Positionstyp auf &bdquo;Textzeile“ mit dem angegebenen Text
|-
| <code>procedure Typ_Leerzeile</code> || Setzt den Positionstyp auf &bdquo;Leerzeile“
|-
| <code>procedure Typ_Zwischensumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ (Ebene 1)
|-
| <code>procedure Typ_ZwischensummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Zwischensumme“ der angegebenen Ebene
|-
| <code>procedure Typ_Titelsumme(const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ (Ebene 1)
|-
| <code>procedure Typ_TitelsummeEbene(const nEbene: integer; const cBez: string = '')</code> || Setzt den Positionstyp auf &bdquo;Titelsumme“ der angegebenen Ebene
|-
| <code>procedure Typ_Titel(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Titel“
|-
| <code>procedure Typ_Gewerk(const cBez: string)</code> || Setzt den Positionstyp auf &bdquo;Gewerk“
|-
| <code>procedure Typ_NeueSeite</code> || Setzt den Positionstyp auf &bdquo;Seitenumbruch“
|-
| <code>procedure Typ_Bild(const cBild: string)</code> || Setzt den Positionstyp auf &bdquo;Bild“ mit dem angegebenen Bildpfad/-UID
|-
| <code>procedure UStKorrektur(const dCheckDate: TDateTime)</code> || Korrigiert den Umsatzsteuerschlüssel gemäß Datum (Steuersatzänderungen)
|-
| <code>procedure KalkPos</code> || Kalkuliert Gesamtpreis und abgeleitete Felder dieser Position neu
|-
| <code>function PosNrAllowed(): boolean</code> || Gibt True zurück wenn dieser Positionstyp eine Positionsnummer erhält
|-
| <code>procedure SetPosNr(cP: string; cT: string = ''; cG: string = ''; cFormat: string = '')</code> || Setzt die Positionsnummer aus String-Komponenten (Überladung 1)
|-
| <code>procedure SetPosNr(nP: integer; nT: integer = -1; nG: integer = -1; cFormat: string = '')</code> || Setzt die Positionsnummer aus numerischen Komponenten (Überladung 2)
|-
| <code>function PosLaufend(iPos: integer = 0): string</code> || Gibt die laufende Positionsnummer als formatierten String zurück
|-
| <code>procedure Preisfindung(cShopNr: string = CONST_NO_SHOP)</code> || Führt die Preisfindung für diese Position aus
|-
| <code>function SetOpenBookLieferant(): boolean</code> || Setzt den Open-Book-Lieferanten für diese Position
|-
| <code>procedure AddToMemo(const cText: string; const lNewLine: boolean = False)</code> || Fügt Text zum Memofeld hinzu
|-
| <code>procedure AktualisiereDaten</code> || Aktualisiert Texte, EK- und VK-Preise gemäß [[#TVorgang_Prop_ParameterPositionsdatenAktualisieren|ParameterPositionsdatenAktualisieren]]
|-
| <code>procedure EKCalcMengeIn(var nEkFak: double)</code> || Berechnet den EK-Mengeneingabe-Faktor (Rückgabe per var-Parameter)
|-
| <code>function CanSave(): boolean</code> || Prüft ob diese Position gespeichert werden kann/darf
|-
| <code>procedure qSqlSet(AqSql: TqSql)</code> || Setzt das SQL-Objekt für erweiterte DB-Operationen dieser Position
|}

= Globale Methoden =

{| class="wikitable sortable"
! Signatur !! Beschreibung
|-
| <code>function IstVKVorgang(cMainTable: string): boolean</code> || Gibt True zurück, wenn die Haupttabelle ein VK-Vorgang ist
|-
| <code>function IstVKVorgangPos(cPosTable: string): boolean</code> || Gibt True zurück, wenn die Positionstabelle zu einem VK-Vorgang gehört
|-
| <code>function CopyPosmengeDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsmengen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|-
| <code>function CopyPosverpDB(oMyDB: TxDB; cFromUID: string): string</code> || Kopiert Positionsverpackungen aus einem anderen Vorgang (direkt per Datenbankzugriff)
|-
| <code>function CopyRTFLan(oMyDB: TxDB; cVonTable, cVonRef, cNachTable, cNachRef: String): String</code> || Kopiert RTF-Langtexte zwischen Vorgangs-Positionen
|-
| <code>procedure CopyKalkulationAN2AU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String; fPosmenge: Double)</code> || Kopiert Kalkulation von Angebot nach Auftrag (mit Mengenfaktor)
|-
| <code>procedure CopyKalkulationAU(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Auftragskalkulation zwischen zwei Positionen
|-
| <code>procedure CopyKalkulationAN(oMyDB: TxDB; cANRef1, cANRef2, cAURef1, cAURef2: String)</code> || Kopiert Angebotskalkulation zwischen zwei Positionen
|-
| <code>function PosNrFormatCheck(const cFormat: string): boolean</code> || Prüft, ob ein Positionsnummern-Format gültig ist (Überladung 1)
|-
| <code>function PosNrFormatCheck(oMyDB: TxDB; const cFormat: string): boolean</code> || Prüft Format gegen Datenbankeinstellungen (Überladung 2)
|-
| <code>function PosNrFormatCounts(const cFormat: string; out nG, nT, nP: integer): boolean</code> || Liefert die Stellenzahlen für Gewerk, Titel und Position aus dem Format (Überladung 1)
|-
| <code>function PosNrFormatCounts(oMyDB: TxDB; const cFormat: string; out nG, nT, nP: integer): boolean</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|-
| <code>function PosNrSplit(oMyDB: TxDB; const cFormat, cPosTyp: string; cPosNr: string; out nG, nT, nP: integer): boolean</code> || Zerlegt eine formatierte Positionsnummer in ihre Bestandteile
|-
| <code>function GetVorgangMandant(oMyDB: TxDB; const cTable, cNr: string): string</code> || Gibt den Mandanten-Schlüssel für einen Vorgang zurück
|-
| <code>function GetVorgangTextTB(const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Ermittelt die Textbaustein-Nummer für den angegebenen Positionsmodus
|-
| <code>function GetVorgangTextTBPers(oMyDB: TxDB; const cPsNr: string; const nPMode: integer; out cTB_Nr: string; cFiliale: string = ''): boolean</code> || Wie GetVorgangTextTB, zusätzlich personenbezogen
|-
| <code>function KopfTextPlatzhalter(var cKopfText: string; const cBrief1, cBrief2: string): boolean</code> || Ersetzt Platzhalter im Kopftext durch Briefanredefelder
|-
| <code>function VorgangArt(oMyDB: TxDB; const cDMS, cNr: string): integer</code> || Gibt die Vorgangsart als Integer-Kennziffer zurück
|-
| <code>function VorgangStatus(oMyDB: TxDB; const cDMS, cNr: string): string</code> || Gibt den aktuellen Status eines Vorgangs aus der Datenbank zurück
|-
| <code>function VorgangVerbucht(oMyDB: TxDB; const cDMS, cNr: string): boolean</code> || Gibt True zurück, wenn der Vorgang verbucht ist
|-
| <code>function VorgangUstEnthalten(oMyDB: TxDB; const cDMS, cNr, cUstSchl: string; cFeld: string = ''): boolean</code> || Prüft, ob ein bestimmter USt-Schlüssel im Vorgang verwendet wird
|-
| <code>function PortoVerpackKannSkonto(): boolean</code> || Gibt True zurück, wenn Porto/Verpackung skontofähig ist (laut Systemeinstellung)
|-
| <code>function GetPosBild(oMyDB: TxDB; cArtNr: string; var cBildUID: string): boolean</code> || Ermittelt die Bild-UID eines Artikels für eine Positions-Bildposition
|-
| <code>function VorgangVertreterVorb(oMyDB: TxDB; const cVertreter: string): string</code> || Gibt den vorgebelegten Vertreter-Schlüssel zurück
|-
| <code>function VorgangVertreterPrio(oMyDB: TxDB; const cAktVertreter: string): string</code> || Gibt den Vertreter mit höchster Priorität zurück
|-
| <code>function GenerierePositionskommentar(cUrsprung, cKommentar: String): String</code> || Kombiniert Ursprungs- und Kommentartext zu einem Positions-Kommentar
|-
| <code>function ReplacePlatzhalterReparaturAuftrag(cRAufNr: String; cText: String = ''): String</code> || Ersetzt Platzhalter im Text durch Reparaturauftragsdaten
|-
| <code>function ReplacePlatzhalterPosErfassung(oMyDB: TxDB; const cBuffer, cTable, cNr: string; const lDef: Boolean = False; const lRepa: Boolean = False): String</code> || Ersetzt Platzhalter im Text bei der Positionserfassung
|-
| <code>function LoadPlatzhalterVorgang(oMyDB: TxDB; const cTable, cNr: string; var oPlatzhalter: TPlatzhalterVorgang): Boolean</code> || Lädt Platzhalter-Daten eines Vorgangs aus der Datenbank
|-
| <code>function PlatzhalterVorgang(const cText, cNr: string; const oPlatzhalter: TPlatzhalterVorgang; const lDef: Boolean = false; const lRepa: Boolean = false): string</code> || Ersetzt Platzhalter im Text mit den geladenen Vorgang-Platzhaltern
|-
| <code>function GetPosVorb_ErlKto(oMyDB: TxDB; const cErlJahr, cManNr, cFiliale: string): string</code> || Gibt das Erlöskonto für eine Positionsvorbelegung zurück
|-
| <code>procedure ChangePosPreisFromLeistPreis2(oVorgang: TVorgang)</code> || Wechselt für alle Positionen auf den alternativen Leistungspreis 2
|-
| <code>function Vorgang_ToXMLStr(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): string</code> || Exportiert einen Vorgang als XML-String
|-
| <code>function Vorgang_ToDelArchiv(oMyDB: TxDB; const cTable, cPosTable, cVorgNr: String): Boolean</code> || Verschiebt einen Vorgang ins Löscharchiv
|-
| <code>function Vorgang_ToXMLFile(oMyDB: TxDB; const cFile, cTable, cPosTable, cVorgNr: String): Boolean</code> || Exportiert einen Vorgang in eine XML-Datei
|-
| <code>function XMLFile_ToVorgang(oMyDB: TxDB; const cData: String; var cNewNr, cOldNr: String): Boolean</code> || Importiert einen Vorgang aus einem XML-String/-Datei
|-
| <code>function DelArchivTo_Vorgang(oMyDB: TxDB; const cTabelle, cVorgang: String): String</code> || Stellt einen archivierten Vorgang wieder her
|-
| <code>function Vorgang_Runden_MengeInFak(oMyDB: TxDB; const cTabMain, cTabPos: string; nValue: double): double</code> || Rundet den Mengeneingabe-Faktor gemäß Tabelleneinstellung
|-
| <code>function Vorgang_Rohertrag(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double): String</code> || Berechnet den Rohertrag eines Vorgangs
|-
| <code>function Vorgang_Rohertrag_Ext(oMyDB: TxDB; const cDMSTyp, cVorgNr: String; nNettoBetrag: Double; lSollStunden: Boolean): string</code> || Berechnet den Rohertrag erweitert (mit Sollstunden)
|-
| <code>function VorgangFelder(cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Gibt die aktiven Feldgruppen eines Vorgangstyps als String zurück (Überladung 1)
|-
| <code>function VorgangFelder(oMyDB: TxDB; cTyp: String; lPosition, lArtikel, lMaterial, lAuswertung, lMessen: Boolean; lSchiff: Boolean = False): String</code> || Wie oben, mit Datenbankzugriff (Überladung 2)
|-
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const cTyp, cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft, ob ein Vorgang gesperrt ist (Überladung 1)
|-
| <code>function Vorgang_IstGesperrt(oMyDB: TxDB; const rDMS: TDMSType; const cRef: string; const cFeld: string = 'a_nr'): boolean</code> || Prüft Sperrung per DMS-Typ (Überladung 2)
|-
| <code>function Vorgang_FilterSperrung(oMyDB: TxDB; const cTyp, cRef: string; out cOffen, cGesperrt: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt SQL-Filter-Strings für offene/gesperrte Vorgänge zurück
|-
| <code>function Vorgang_FilterSperrung_Offen(oMyDB: TxDB; const cTyp, cRef: string; out cOffen: string; const cFeld: string = 'a_nr'): boolean</code> || Gibt nur den Filter für offene (nicht gesperrte) Vorgänge zurück
|-
| <code>function Vorgang_UbernahmeMassen(oMyDB: TxDB; const cVonUid, cNachDmsTyp, cNachVorgNr, cNachUid: string): boolean</code> || Massenweise Positionsübernahme zwischen Vorgängen
|-
| <code>function Vorgang_GetMenge(oMyDB: TxDB; const cPosTable, cKeyField, cUID: String; out nUrmenge: Double; const cEigUID: String = ''): Double</code> || Liest die aktuelle und Ursprungsmenge einer Position aus der Datenbank
|-
| <code>function Vorgang_CheckPosTyp(const cTyp: string): boolean</code> || Prüft, ob ein Positionstyp-Schlüssel gültig ist
|-
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxFQuery): boolean</code> || Gibt True zurück, wenn der Vorgang eine Rechnungsempfänger-Adresse hat (Überladung 1)
|-
| <code>function Vorgang_HatReEmpfAdr(qVorgangData: TxQuery): boolean</code> || Wie oben, für TxQuery (Überladung 2)
|-
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxFQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Gibt die anzuzeigende Rechnungsempfänger-Adresse als formatierten Text zurück (Überladung 1)
|-
| <code>function Vorgang_AnzeigeReEmpf(oMyDB: TxDB; qMain: TxQuery; const cMainTable: string; cAdressBez: string = ''; lUseReportLang: boolean = True): string</code> || Wie oben, für TxQuery (Überladung 2)
|-
| <code>function Vorgang_PortoVerpackBerechnet(oMyDB: TxDB; const cDmsVon, cDmsSetzen, cNrSetzen: string): boolean</code> || Prüft, ob Porto/Verpackung bereits berechnet wurde und setzt Kennzeichen
|-
| <code>function VorgangVorb_Waehrung(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardwährungsschlüssel für Vorgangsvorbelegung zurück
|-
| <code>function VorgangVorb_RechKreis(oMyDB: TxDB; const cValue: string = '01'): string</code> || Gibt den Standardrechnungskreis-Schlüssel zurück
|-
| <code>function VorgangVorbPos_VomLager(const nTokenPos: integer; const cLagStreck: string): string</code> || Gibt das Lager/die Strecke für eine Positionsvorbelegung zurück
|-
| <code>function Vorgang_VersandkostenMBW(oMyDB: TxDB; const cDmsTyp: string; const lGen: boolean; const cPsNr: string; const cPsVersand: string = ''; const cPsZusatz: string = ''): string</code> || Berechnet Versandkosten auf Basis des Mindestbestellwerts
|-
| <code>function Vorgang_PdfFile(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cPdfFile: string): boolean</code> || Ermittelt den Pfad zur archivierten PDF-Datei eines Vorgangs
|-
| <code>function Vorgang_PdfAsBase64File(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; out cBase64File: string): boolean</code> || Liefert die PDF-Datei als Base64-kodierten Pfad
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Liefert die PDF in Teilen als Base64 (mit KdNr, Überladung 1)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr, cKdNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 2)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; nPartSize: integer = 0): boolean</code> || Wie oben, ohne KdNr (Überladung 3)
|-
| <code>function Vorgang_PdfAsBase64Parts(oMyDB: TxDB; const cDmsTyp, cNr: string; const nPart: integer; out cBase64: string; out nParts: integer; cPartSize: string): boolean</code> || Wie oben, Teilgröße als String (Überladung 4)
|-
| <code>function Vorgang_PdfAsBase64(oMyDB: TxDB; const cDmsTyp, cNr: string; out cBase64: string): boolean</code> || Liefert die gesamte PDF als Base64-String
|-
| <code>function Vorgang_PosUebernommen(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid: string): TVorgangPosOriginalListe</code> || Gibt eine Liste aller Vorgänge zurück, in die diese Position übernommen wurde
|-
| <code>function Vorgang_GetPosRef(oMyDB: TxDB; const cVonDmsTyp, cVonNr, cPosUid, cRefDmsTypen: string): TVorgangPosOriginalListe</code> || Gibt Referenzen einer Position auf andere DMS-Typen zurück
|-
| <code>function Vorgang_ArtBox(const cDMSTyp: string): string</code> || Gibt die Vorgangsart-Box (Auswahlstring) für einen DMS-Typ zurück
|-
| <code>function Vorgang_SummenEbene(const nEbene: integer): integer</code> || Validiert und normiert eine Summen-Ebene (1..VB_MAX_SummenEbenen)
|-
| <code>function Vorgang_SummenEbeneAusMenge(const nMenge: double): integer</code> || Berechnet die Summenebene aus einem Mengenwert
|-
| <code>function Vorgang_KalkAufschlagPos(const nSatz, nZwSumme, nMengeIn, nMengeInFak, nRabatt: double): double</code> || Berechnet den Aufschlagsbetrag für eine Position
|-
| <code>function Vorgang_SumPosText(const eTyp: [[#TVB_PosType|TVB_PosType]]; const cLanguage: string): string</code> || Gibt den lokalisierten Standardtext für eine Summenposition zurück
|-
| <code>function Vorgang_SumPosTextZw(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Zwischensummen-Positionen zurück
|-
| <code>function Vorgang_SumPosTextTit(cLang: string = ''): string</code> || Gibt den lokalisierten Text für Titelsummen-Positionen zurück
|}

OBS/Makros und Scripting/Allgemeines/Klassen/Vorgänge

2026-06-12T09:36:31Z

Nimz: /* Basis TVorgangPos */

Kostenpflichtige Module/Internet-Shop/brShop24/Kundengruppen verwalten

2026-06-01T09:13:50Z

Nimz:

{{Vorlage:Kostenpflichtige Module}}
Unter den Kundengruppen werden Personen, Benutzer und Adressen zusammengefasst. In den Kundengruppen lassen sich Standardwerte (z. B. Kundennummer oder Kundentyp) für die Benutzer hinterlegen. 
Aufruf: Menü Stammdaten → I Schnittstellen → I - Internet-Shop → Schnittstelle wählen → {{Key|F10 Menü}} → F Kundengruppen
=Liste=
In der Liste sehen Sie alle im OBS gespeicherten Kundengruppen. Initial sollten diese bei der [[Kostenpflichtige_Module/Internet-Shop/brShop24#Umstellung.2FMigration_VShop_4|Migration]] angelegt werden. 
[[image:Shopkdgruppe_liste_br24.jpg]]
==Spalten==
*;Nummer
:Eindeutige Nummer im Shop
*;Kundengruppe
:Name/Bezeichnung der Kundengruppe
*;Kunde
:Kundenreferenz der Kundengruppe (OBS-Personennummer)
*;Info
:Zeigt an, ob es sich bei der Kundengruppe um eine Systemgruppe oder eine Sammelgruppe handelt.{{Hinweis|Für Systemgruppen und Sammelgruppen gelten beim Export besondere Regel. Da diese Gruppe Sammelbecken für verschiedenste Kunden/Benutzer darstellt, ist hier die Anlage von Kostenstellen unterbunden. Auch werden personenbezogene Daten wie Adressen nur auf die jeweiligen Benutzer verteilt, nicht aber auf die vollständige Kundengruppe. Systemgruppen sind überdies spezielle vordefinierte Kundengruppen des Shops und können von OBS aus nicht bearbeitet werden.}}
==Testen und Schaltflächen==
{| class="wikitable"
|-
! Tasten/Schaltflächen!! Erklärung
|-
| {{Key|F6 Import}}|| Import die aktuellen Kundengruppen aus dem Shop.]]
|-
| {{Key|F8 Sort.}}|| [[Kostenpflichtige_Module/Internet-Shop/brShop24/Definition_Sortiment|Sortimentsdefinition]] für die "individuelle Konfiguration" im brShop24. Siehe dazu im Adminbereich des Shops in den Kundengruppen (Kunden) den Reiter "Sortiment". Der Export der Einstellungen erfolgt mit dem Export der Kundengrupen selbst über die Eingabemaske beim Speichern.]]
|-
| {{Key|F9 Sammel}}|| Setzt das Häkchen ''Sammelgruppe'' (siehe Beschreibung [[#Eingabemaske|Eingabemaske]] für das Feld "Sammelgruppe").
|-
| {{Key|Einfg Einf.}}|| Öffnet die Übernahmeliste nach Auswahl des Definitionstypen. Beachten Sie dabei mögliche Beschränkungen beschrieben unter [[#Definitionstypen und Besonderheiten|Definitionstypen und Besonderheiten]]
|-
| {{Key|Entf entf}}|| Entfernt den Datensatz aus der Zurordnung.
|}

=Eingabemaske=
In der Eingabemaske haben Sie je nach Datensatz Zugriff auf die meisten Felder. Für die Standard-Gruppen des Shops wird die Bearbeitung jedoch gesperrt, da diese auch über die API nicht geändert werden dürfen. Für alle weitere Kundengruppen können Sie bis auf die ID alle felder ändern. Die ID wird bei der Übertragung in den Shop automatisch eingetragen. Die Übertragung findet mit dem Speichern der Kundengruppe statt. 
 
{| class="wikitable"
|-
! Feld!! Erklärung
|-
| Kundengruppe|| Name der Kundengruppe
|-
| Eindeutiger{{nb_space}}Bezeichner|| Ein eindeutiger Namen/Bezeichner für den Shop. Dies ist eine Pflichtangabe.{{Hinweis|Es sind nur Buchstaben von A bis Z, Nummern und Minus (-) als Zeichen erlaubt.}}
|-
| Kundentyp|| Standard-Typ für alle Benutzerkonten.
|-
| Qualifikation|| Standard-Qualifikation für alle Benutzerkonten.
|-
| Hauptgruppe|| Angabe der übergeordneten Gruppe. So lassen sich Hierachien in den Kundengruppen anlegen.
|-
| Eigenschaft|| Automatische Zuweisung bei Anlage der Webshop-Einstellungen.{{Achtung|Funktioniert noch nicht!}}
|-
| Personnr.|| Standard-Kundennummer für alle Benutzerkonten.
|-
| Sammelgruppe|| Macht die Kundengruppe zu einer Sammelgruppe für verschiedene Kunden. Wie bei Systemgruppen werden hier bestimmte personenbezogene Daten bei der Übertragung nicht auf die Gruppe verteilt sondern nur im jeweiligen Benutzer zugeordnet (z. B. Adressen).
|}
 
[[image:Shopkdgruppe_edit_br24.jpg]]

Kostenpflichtige Module/Internet-Shop/brShop24

2026-03-16T14:20:56Z

Nimz: /* W Definitionen importieren */

{{Kostenpflichtige Module}}
{{Aktuelles|Die Schnittstelle brShop24 wird 60 Euro monatlich kosten.}}
Der brShop24 wird von der Genossenschaft [https://www.bueroring.de Büroring eG] entwickelt und angeboten. Diese ECommerce-Lösung soll langfristig den bisher angebotenen VShop 4 Pro ablösen. Für die Anbindung an den brShop24 steht Ihnen eine Schnittstelle basierend auf [https://de.wikipedia.org/wiki/GraphQL GraphQL] zur Verfügung.
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
{{Achtung|Die Schnittstellen für VShop 4 Pro und brShop24 sind nicht kompatibel! Sollten Sie sich also für eine Umstellung Ihres VShop 4 Pro auf das neue System brShop24 entscheiden, so muss dies im OBS ebenfalls umgestellt werden! Siehe auch die Punkte [[#Umstellung.2FMigration_VShop_4|Umstellung/Migration VShop 4]] und [[#faq_brshop24_allg_parallelbetrieb|FAQ Parallelbetrieb]].}}
=Funktionsumfang=
{{Achtung|Die hier aufgeführten Funktionen sind unter Vorbehalt in der aktuellen Version von OBS enthalten, da sich die Funktionalitäten in API und OBS noch ändern können.}}
Diese Schnittstelle unterstützt den Im- und Export von Daten wie folgt:
{| class="wikitable"
|-
! Import!! Export
|-
| Auftragsimport (OpenTRANS 1.0)|| Preislisten
|-
| Depots + Partner|| Kundengruppen
|-
| Anreden|| Ansprechpartner (Benutzer und Personen)
|-
| Kundentypen|| Kostenstellen
|-
| Kundenqualifikation|| Adressen (Personenstamm)
|-
| Job-Informationen (Ergebnis/Protokoll Preispflege)|| Shopping-Listen (Meistgekaufte Artikel/Top-Artikel)
|-
| Kundengruppen (Migration)||
|-
| Benutzer (Migration)||
|-
| Kostenstellen (Migration)||
|}
{{Hinweis|Zu Beginn wird es nur Bestelldateien im Format OpenTRANS 1.0 geben. Das neuere Format 2.1 ist aber bereits eingeplant und soll zu einem späteren Zeitpunkt folgen.}}
==Vergleich zur Schnittstelle VShop 4==
Stand: 13.10.2022
{| class="wikitable"
!|
|'''VShop 4'''
|'''brShop24'''
|-
|'''Bestellungen importieren'''
|ja
|ja
|-
|'''Kundendaten abfragen'''
|ja ("Kunde vorhanden?")
|ja ("Kunde vorhanden?" und Migration)
|-
|'''Kundendaten übertragen'''
|ja
|ja
|-
|style="padding-left: 100px"|(Kunden-)Gruppe
|Aus Personennummer (Hauptperson)
|eigene Verwaltung
|-
|style="padding-left: 100px"|Benutzerkonto
|aus Person und Ansprechpartner
|aus Ansprechpartner
|-
|style="padding-left: 100px"|Kostenstellen
|nur als Kostenstelle (mit Budget)
|Kostenstelle (noch ohne Budget; fehlt im Shop bisher) und Versandadresse
|-
|style="padding-left: 100px"|Shopping-Listen
|ja
|ja
|-
|style="padding-left: 100px"|Adressen/Adressbuch
|nein (nur Standardadresse im Benutzerkonto)
|ja
|-
|style="padding-left: 100px"|Anreden
|nein
|Import (Definition/Zuordnung)
|-
|style="padding-left: 100px"|Kundentyp
|nein
|Import (Definition/Zuordnung)
|-
|style="padding-left: 100px"|Kundenqualifikation
|nein
|Import (Definition/Zuordnung)
|-
|'''Artikelvorlage setzen'''
|ja
|nein
|-
|'''Preise übertragen'''
|ja
|ja (nur Preislisten)
|-
|'''Lager'''
|Import (Definition/Zuordnung)
|Import (Definition/Zuordnung)
|-
|'''Partner'''
|Import (Definition/Zuordnung)
|Import (Definition/Zuordnung)
|-
|'''Warengruppen/Kategorien'''
|Import (Definition/Zuordnung)
|nein
|-
|'''Artikel'''
|ja
|ja
|-
|style="padding-left: 100px"|übertragen
|ja
|ja
|-
|style="padding-left: 100px"|Abgleich (eigene Artikel)
|ja
|nein
|-
|'''Sterne'''
|ja
|nein
|-
|'''monatliche Kosten'''
|20 Euro
|60 Euro
|}
{{Hinweis|Für eine Beschreibung der einzelnen Funktionen siehe [[#Erklärungen/Funktionen|Erklärungen/Funktionen]].}}

==Bekannte Probleme==
{{Hinweis|Die hier aufgeführten Probleme sollen einen Überblick zum Stand einzelner Funktionen geben, sollten Sie sich dazu entscheiden mit der Schnittstelle zu arbeiten.}}
{{Achtung|Bei den letzten Tests kam es zu einem Fehler innerhalb der API, durch den die übermittelten Daten nicht korrekt verarbeitet wurden. Der Fehler trat an verschiedenen Stellen auf und konnte nicht reproduziert werden. Aktuell ist dies unter Beobachtung seitens Büroring. Von OBS aus können Sie aktuell die Datenübertragung nur ein zweites Mal ausführen, bis eine Lösung für das Problem gefunden wurde. Bei Preislisten hatte das Problem jedoch noch die Auswirkung, dass die Preislisten danach doppelt vorhanden war (siehe "doppelte Preislisten bei Fehler in Preislistenupdate").}}
===Import Bestellungen===
*;eindeutige Identifikation von Artikeln
:Nach aktuellem Stand wird nur der aktuelle Katalog von Büroring eingespielt. Sollten jedoch auch von anderen Lieferanten Artikel im Shop verkauft werden, kann es bei den Artikelnummern zu "doppelten" Artikeln kommen. Derzeit fehlt noch die Möglichkeit dies beim Import unterscheiden zu können.
*;fehlende Kostenstellen
:In der Auftragsdatei werden nach aktuellem Stand keine Kostenstellen geliefert. Somit kann OBS diese bei der Auftragsgenerierung hinterlegen. ''Die Kostenstellen werden nach Informationen von Büroring jetzt in die openTRANS-Order übernommen (Stand 25.02.2021).''
*;Anzeige in FTP-Eingang
:Bei aktivierter Anzeige von importierten Bestellungen im FTP-Eingang, wird bisher in der Spalte ''Typ'' nichts angezeigt. ''Behoben mit Version 003663 (Info 005482).''

===Personendaten===
*;Export Kostenstellen Budgets
:Die Budgetverwaltung wurde bisher noch nicht im brShop24 umgesetzt und steht daher auch in der API noch nicht zur Verfügung.
*;Anzeige Webshop-Einstellungen
:Die Anzeige des Kundenstatus funktioniert aktuell nur, wenn die Kundennummer auch in einer Kundengruppe steht. ''Behoben mit Version 003591 (Info 005378).''
*;Übertragung Adressen
:Die Adressen werden nicht angelegt, weil der Typ mit einem ungültigen Wert an die API übergeben wird. ''Behoben mit Version 003587 (Info 005365).''
*;Zuordnung Adressen Kundengruppe
:Adressen werden bei Übertragung auch in der Kundengruppe zugeordnet, obwohl es sich um eine System-Gruppe handelt. ''Behoben mit Version 003600.''
*;Zuordnung Adressen Benutzer
:Im Benutzer wird eine übertragene Adresse nicht zugeordnet. ''Behoben mit Version 003665 (Info 005483).''
*;Einfügen neuer Kundengruppen
:Die Datensätze werden im OBS nicht korrekt angelegt und können daher nicht exportiert werden. ''Behoben mit Version 003594 (Infos 005375 und 005393).''
*;Adressen aus Kostenstellen
:Werden bisher nicht übertragen. ''Behoben mit Version 003606 (Info 005398). Adressen aus Kostenstellen werden jetzt als Versandadressen hinterlegt''
*;Zuordnung Kostenstellen
:Kostenstellen werden bei Übertragung auch in der Kundengruppe zugeordnet, wenn es sich um eine System-Gruppe handelt. ''Behoben mit Version 003600. Kostenstellen werden bei Systemgruppen nicht mehr exportiert. Benutzer erhalten einen Hinweis bei Export der Personendaten aus den Webshop-Einstellungen und werden gefragt, ob die Personedaten trotzdem exportiert werden sollen.''
*;Im Shop ist der Adresstyp vertauscht
:Adressen die eigentlich "Postanschrift" haben sollten, bekommen "Postfach Anschrift" und umgekehrt. ''Behoben mit Version 003684 (Info 005494).''
*;Benutzer ist immer Admin
:Die Funktionalität über Eigenschaft 9011 wurde noch nicht übernommen aus der VShop-Schnittstelle übernommen, da sie dort problembehaftet ist. Die Fehlerhafte Übertragung in dieser Schnittstelle wurde somit vorerst vollständig entfernt. ''Behoben mit Version 003735 (Info 005548).''
*;Benutzer wird nicht angelegt
:Während des Exports kommt es zu einem Abbruch im OBS und der Export wird nicht vollständig ausgeführt. ''Behoben mit Version 004061 (Info 005911).''

===Preise/Preislisten===
*;Keine Aktualisierung für Kunden mit Kundennummer im Benutzer
:Preislisten werden nicht erkannt, wenn die Kundennummer nur im Benutzer vorkommt. ''Behoben mit Version 003592 (Info 005384).''
*;doppelte Preislisten bei Fehler in Preislistenupdate
:Tritt in der Aktualisierung der Preislistenkopfdaten ein Fehler auf, so wird die Preisliste ein weitere Mal angelegt. ''Behoben mit Version 003630 (Info 005452).''
*;Keine Aktualisierung der Kopfdaten
:Wurden im OBS Änderungen an den Kopfdaten (Name, Prio, Gültigkeitszeitraum) vorgenommen, konnte es passieren, dass diese nicht in den Shop übertragen wurden. ''Behoben mit Version 003703 (Info 005515).''
*;Preise löschen verlängert die Laufzeit der Preispflege
:Beim Löschen von Preisen könnte es vorkommen, dass sich die zu löschenden Datensätze nicht korrekt aus der Liste genommen wurden, auch wenn der Datensatz aus dem Shop entfernt wurde. Dadurch versucht OBS diese Datensätze bei jedem folgenden Durchlauf der Preispflege zu löschen, was fehlschlägt, da die Datensätze ja schon gelöscht sind. ''Behoben voraussichtlich mit Version 003833 (Info 005664).''
*;Preise werden nicht bei allen Preislisten aktualisiert
:Eine Prüfung war fehlerhaft und konnte die Aktualisierung der Preise für eine Preisliste verhindern. ''Behoben mit Version 003911 (Info 005733).''
*;Preislisten, welche über Preisgruppen einem Kunden zugeordnet sind, werden im Shop nicht in Kundengruppen und Benutzern hinterlegt
:An einer Stelle in der Abfrage der Zuordnungen sind die Nummern für Preisgruppe und Preisliste vertauscht. Der Fehler betrifft eigene Preislisten, welche über Preisgruppen zugeordnet sind. Für die Standard-Preislisten VK1 bis VK9 kommt es nicht zu diesem Fehler, da hier die Nummern identisch sind. ''Behoben mit Version 003959 (Info 005785).''
*;Zuordnungen von Preislisten sind fehlerhaft
:Unter bestimmten Umständen (Löschen ganzer Preislisten oder Kunde ohne verbleibende Preisliste) kann es im OBS zu einem Problem mit der Verwaltung der Zuordnungen im Shop kommen. Zuordnungen können dabei erhalten bleiben oder werden nicht angelegt. ''Behoben mit Version 004012 (Info 005847).''

===Bestellvorlagen/Shoppinglisten===
*;Anzeige im Shop
:Nach aktuellem Stand können die Bestellvorlagen, die es auch schon für den VShop 4 exportiert werden konnten, in den brShop24 übertragen werden. Die Anzeige im Frontend (Ansicht für den Kunden) ist jedoch noch nicht umgesetzt. Sie können aktuell nur über den Admibereich prüfen, ob die Bestellvorlagen im Shop angekommen sind. ''Im Frontend werden die Listen jetzt angezeigt (Stand: 09.11.2021).''
*;Generierung Shoppinglisten
:Durch einen Fehler in der Erkennung des Brüroring Zentrallagers konnte die falsche Lager-ID gezogen werden. Dadurch wurden die Artikel nicht korrekt identifiziert und die Shoppinglisten wurden nicht generiert. ''Behoben vorraussichtlich mit Version 003815 (Info 005654).''
*;Zuordnung Shoppinglisten
:In der Übertragung wurden Shoppinglisten nicht in Benutzern zugeordnet. Dadurch sehen insbesondere bei allgemeinen Kundengruppen (z. B. registrierte Kunden) Benutzer die von OBS für eine Kundennummer erstellten und übertragenen Shoppinglisten nicht. ''Behoben mit Version 003832 (Info 005663).''

===Migration===
*;Auswahl eines vorhandenen Ansprechpartner für Zuordnung zu einem Shop-Benutzer schlägt fehlt
:Die Auswahl verhält sich als würde keine Datensatz ausgewählt werden und setzt daher die Zuordnung nicht. ''Behoben mit Version 004012 (Info 005845).''
*;Aus einem Benutzerkonto kann kein Ansprechpartner angelegt werden
:Es kann bei der Übernahme der Daten zu einem SQL-Fehler im OBS kommen, welcher die Anlage der Daten verhindert. ''Behoben mit Version 004012 (Info 005844).''

=Kosten=
*;Einrichtung
:Sie können die Schnittstelle vom OBS-Support einrichten lassen oder dies selbst erledigen. Informationen zu den nötigen Daten/Angaben für eine Einrichtung finden Sie im nächsten Punkt [[#Installation.2FEinrichtung|Installation/Einrichtung]]. Wenn Sie eine Einrichtung durch den OBS-Support wünschen, wird dies '''einmalig nach Aufwand''' abgerechnet.
*;Nutzung Schnittstelle
:Für den Einsatz wird pro aktiver brShop24-Schnittstelle '''monatlich 60 Euro''' berechnet.

=Installation/Einrichtung=
Für die Einrichtung werden Angaben zur API-Anbindung und FTP-Zugangsdaten für die Abholung der Auftragsdateien benötigt. Außerdem muss OBS für die Preispflege auf das kostenpflichtige [[OBS/Kostenpflichtige_Module/Preislisten|OBS-Modul Preislisten]] umgestellt worden sein.
 
Für eine genaue Auflistung der benötigten Informationen und eine Beschreibung der Einrichtung lesen Sie bitte die Seite zur [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung einer brShop24-Schnittstelle]].

=Mit der Schnittstelle Starten=
==Daten migrieren==
Sofern Sie in der Vergangenheit einen VShop 4 verwendet haben und die Daten vom Büroring in den neuen brShop24 migriert wurden, empfehlen wir nach Abschluss der Einrichtung eine [[Kostenpflichtige_Module/Internet-Shop/brShop24/Migration|Datenmigration im OBS]] durchzuführen (siehe auch [[#Umstellung.2FMigration_VShop_4|Umstellung/Migration VShop 4]]). Dabei werden die vom VShop 4 migrierten Kundendaten aus dem Shop ausgelesen und in OBS importiert. OBS versucht die importierten Daten anschließend mit den Stammdaten zu verknüpfen und erstellt für die Kunden die Webshop-Einstellungen und gibt die Ansprechpartner frei. 
Nach den Kundengruppen und Benutzern werden die Kostenstellen eingelesen und versucht den Einträgen im OBS zuzuordnen. Der Anzeigename (Shop) einer Kostenstelle muss dabei mit der Bezeichnung der Kostenstelle übereinstimmen und innerhalb der Kundengruppe eindeutig sein.
{{Achtung|Die Zuordnung läuft automatisiert und kann einige Minuten in Anspruch nehmen! Sollte der Vorgang abbrechen, können Sie die Migration erneut starten. Die Zuordnung erfolgt nur für Daten, die eindeutig identifiziert werden konnten!}}
 
Außerdem werden die Preislisten aus den im Shop vorhandenen Preislisten ermittelt und für die Schnittstelle freigegeben. Die Preislisten werden stattdessen nach erfolgreicher Zuordnung im Shop geleert und neu befüllt. So sind die Preisdaten auch gleich auf dem aktuellen Stand und für die spätere Aktualisierung sind die Daten im OBS entsprechend vorbereitet.
{{Achtung|Es findet '''keine''' Verknüpfung mit den Preisdaten im OBS statt, da der vollständige Abgleich aller einzelnen Preisdaten zu lange dauern würde!}}

==Datenhoheit==
Es gibt einige spezifische Daten im Shop, die von OBS nicht angefasst werden (dürfen). Das betrifft z. B. die Standard-Kundengruppen des brShop24. Für OBS-Daten hat jedoch OBS die Datenhoheit. Im Shop können Sie dies an den verfügbaren Funktionen (Bild 1) erkennen. Die von OBS gepflegten Daten werden über die API (Bild 2) angelegt und haben bei den Funktionen statt dem Stift-Symbol (Daten bearbeiten) nur ein Auge-Symbol (Daten ansehen).
<gallery widths="200px">
File:Br24_admin_datenoptionen.jpg|Bild 1: Funktionen|alt=Funktionen
File:Br24_admin_letzte_aend.jpg|Bild 2: Letzte Änderung|alt=letzte Änderung
</gallery>

=Umstellung/Migration VShop 4=
Nach aktuellem Stand wird für Kunden mit VShop 4 vom Büroring eine Migration des bestehenden VShop 4 auf den neuen brShop24 durchgeführt. Dabei soll auch gewählt werden können, welche Daten bei der Migration übernommen werden. Wie dies genau aussieht, müssen Sie jedoch mit dem Büroring klären. Es gibt jedoch auch einige Punkte, die Sie bei der Migration für die Umstellung im OBS bedenken müssen.
*;Neue API
:Im Unterschied zum VShop 4 läuft die Schnittstelle zum brShop24 über eine API. OBS dies bringt ein paar Einschränkungen für die migrierten Daten mit sich. Es ist OBS nicht möglich die Daten wiederzufinden, die von OBS zuvor in den VShop 4 übertragen wurden. Wie sich dies auf die Pflege von Daten auswirkt, muss noch in Erfahrung gebracht werden, da im Testsystem keine migrierten Daten zur Verfügung stehen.
*;Besonderheit Preisdaten
:OBS arbeitet in Schnittstelle über eine sogenannte API-ID, also eine Identifikationsnnummer speziell für die neue API. OBS kann nur Preisdaten verändern, die auch über die API in den Shop übertragen wurden. Wir empfehlen daher die Preisdaten möglichst über OBS zu pflegen und nicht migrieren zu lassen.
*;Schnittstelle im OBS
:Die Schnittstelle muss im OBS freigeschaltet und eingerichtet werden (siehe dazu [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung]]). Dies kann bereits vor der Migration geschehen. Bedenken Sie jedoch, dass die Aufträge erst importiert werden können, nachdem die Schnittstelle eingerichtet wurde. Gebe Sie uns also rechtzeitig Bescheid, damit wir die Schnittstelle freigeben können. Die Einrichtung kann auf Wunsch von uns kostenpflichtig übernommen werden.{{Hinweis|Die Freischaltung der Schnittstelle hat auch eine Anpassung des Vertrags zur Folge. Bitte beachten Sie, dass die Schnittstelle brShop24 mit 60 Euro statt 20 Euro berechnet wird.}}
*;Modul Preislisten
:Für den brShop24 wird das Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] für die Pflege von Preisen über die Schnittstelle vorrausgesetzt. Sollten Sie dieses Modul noch nicht nutzen, so müsste dies zuvor eingerichtet werden, wenn Sie Preise aus OBS in den Shop übertragen möchten. Die Einrichtung des Moduls kann mehrere Stunden in Anspruch nehmen. Wir empfehlen die Umstellung vor der Migration durchzuführen, da dies die Arbeitsweise mit Artikelpreisen verändert. Eine Schulung wird ebenfalls empfohlen.
*;Migration Freigaben OBS VShop 4 nach brShop24 (siehe [[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]])
:Über das Shop-Menü können Kundengruppen und Benutzer mit dem OBS-Personenstamm abgeglichen werden. Im Personenstamm werden dann für gefundene Datensätze Webshop-Einstelungen angelegt. Ansprechpartnern, welchen ein Benutzer eindeutig zugeordnet werden konnten, erhalten die Eigenschaft 9013 und die Zuordnung zur Schnittstelle. Sollte die eindeutige Zuordnung ohne Benutzername erfolgt sein, so wird auch der Benutzername im Ansprechpartner hinterlegt. Außerdem werden die Preislisten mit dem Shop abgeglichen, freigegeben und übertragen.{{Hinweis|Es ist nicht möglich die Passwörter auszulesen. Diese können also nicht im Ansprechpartner hinterlegt werden. Sollten Sie zu einem späteren Zeitpunkt die den Benutzer im Shop aktualisieren wollen, müssten diesen zuvor ein Passwort gegeben werden, sollte noch keines vorhanden sein.}}{{Achtung|Damit die Migration auch die Kundendaten verknüpfen kann, muss diese Funktionalität im Shop freigeschaltet sein. Wenden Sie sich hierzu an den Support des Büroring.}}
==Ablauf einer Umstellung==
Für gewöhnlich richtet Büroring zunächst einen Shop zu Testzwecken ein. Sie erhalten danach die API-Daten, mit denen die Schnittstelle eingerichtet werden kann (siehe dazu [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung]]). Sie können jetzt die Schnittstelle testen und wenn Fragen oder Probleme geklärt sind, dem Büroring die Freigabe für den Live-Betrieb erteilen. Der Shop wird daraufhin zurückgesetzt. Dies muss im OBS ebenfalls passieren. Informieren Sie dazu den Support per Ticket oder E-Mail (siehe dazu auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung#Vorwort|Vorwort Einrichtung]]).

=Menü=
==B Preislisten verwalten==
Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Preislisten_verwalten|Preislistenverwaltung der Schnittstelle]]

==F Kundengruppen==
Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|Kundengruppenverwaltung der Schnittstelle]].

==I Bestellvorlagen verwalten==
Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Shoppinglisten_übertragen|Shoplistenverwaltung der Schnittstelle]].

==M Migration==
Startet die [[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]] der Daten. Dabei werden die aktuellen Kudnendaten (Gruppen und Benutzer) eingelesen und im Personestamm, sofern automatisiert möglich, Webshop-Einstellungen angelegt und Ansprechpartner zugeordnet.

==T Jobinformationen==
Die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen|Jobinformationen]] sind ein Protokoll des Shops für die Preispflege-Jobs. Diese werden beim Exportieren der Preise angelegt. Über diesen Menüpunkt können Sie die bisherigen Job-Protokolle einsehen. Beim Einlesen der Jobinformationen werden aufgetretene Fehler verarbeitet.

==U Bestellungen einlesen==
Liest die vorhanden Bestelldateien aus dem Shop-Verzeichnis ein. Für den automatischen Import siehe [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Bestellungen_einlesen|Automatiken: Bestellungen einlesen]].

==W Definitionen importieren==
Über diesen Menüpunkt können Sie alle für relevanten Definitionen aus Ihrem brShop24 zur Vorbereitung der Datenexporte ins OBS importieren. Dies umfasst aktuell folgende Definitionen:
*[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Depots/Lager mit Partner]]
*[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|Anreden]]
*Kundentypen (u. a. B2B, B2C)
*Kundenqualifikation (u. a. neuer Kunden, Stammkunde)
*Artikelbezeichnungsgruppen
*Produkttypen
*Mengeneinheiten
*Artikellieferstatus
*Hersteller
*Marken
*Umsatzsteuerdefinitionen
*Paketdienstleister
*Artikel-Einschluss-Listen
*Artikel-Ausschluss-Listen
*Kataloge
Für den automatischen Import siehe [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Definitionen_importieren|Automatiken: Definitionen importieren]].
{{Hinweis|Diese Definitionen spielen an verschiedenen Stellen eine wichtige Rolle. Sollten Sie die Definitionen noch nicht importiert und vor einem Datenexport zugeordnet haben, funktionert entweder der Datenexport nicht oder es werden Standardwerte verwendet.}}

==X Konfiguration==
Öffnet die [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Konfiguration]] der Schnittstellen. Hier können die Einstellungen der Schnittstelle angepasst werden.{{Hinweis|Um Anpassungen vorzunehmen wird für die meisten Einstellungen ein Level von 3 oder 5 benötigt. Es ist möglich dieses Level anzupassen, auch kann ein Benutzer für die Schnittstelle ein abweichendes Benutzerlevel erhalten. Melden Sie sich bei Bedarf per [[OBS/System/Ticket-System|OBS Ticketsystem]] beim OBS-Support.}}

==Y Testumgebung==
Öffnet eine Testumgebung, um die Anbindung zu testen.

==Z Protokoll==
|Über den Menüpunkt ''Z Protokoll'' des Shops-Menüs erhalten Sie Zugriff auf das Shop-Protokoll. Es werden vorrangig Hinweise zu Fehlern oder Problemen bei Im- und Exporten protokolliert. Über die Konfiguration kann mit Aktivierung des Debugmodus (Schlüssel ''Shop.Debug'') eine erweiterte Protokollierung aktiviert werden. Dafür benötigt ein Benutzer jedoch Administrationsrechte (Level 9) für die Schnittstelle.

=Zuordnungen=
Zuordnungen von Stammdaten wie Lieferanten und Mengeneinheiten nehmen Sie über den Shop-Menüpunkt ''X Konfiguration'' vor. In der Kofigurationsliste gelangen Sie über {{Key|F8 Zuord}} ins Zuordnungsmenü. 
 
Aktuelle Menüpunkte:
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|A Anreden]]
:Liste für im Shop definierte Anreden. Hier können Sie die OBS-Anreden mit den Shop-Anreden verknüpfen. Relevant für den Export von Personen. Ohne Zuordnung werden Personen ohne Anrede exportiert.
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Einheiten#brShop24|E Einheiten]]
:Liste für im Shop definierte Mengeneinheiten. Ordenen Sie hier die im OBS verwendeten Mengeneinheiten zu. {{Hinweis|Relevant für eigene Artikel. Ist eine verwendete OBS-Mengeneinheit nicht zugeordnet, so wird beim Export die Einheit "ST" (Stück) für den jeweiligen Artikel verwendet.}}
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|L Lager und Lagerlieferanten]]
:Definierte Depots und Partner des Shops. Partnern können Sie einem OBS-Lieferanten zuordnen und die Lager entsprechend auf Pflege Büroring oder als eigene Artikel definieren. Relevant für den Export von Preisen, Shoppinglisten (Bestellvorlagen) und eigene Artikel.
*;[[Kostenpflichtige_Module/Internet-Shop/Zusatz/Artikeltausch|T Artikeltausch]]
:Greift beim Auftragsimport. Austauschen bestimmter Referenznummern gegen einen festgeschrieben Artikel z. B. für Pauschalen.

=Erklärungen/Funktionen=
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|Kundengruppen verwalten]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Personen_übertragen|Kunden übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen|Preise übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Eigene_Artikel_übertragen|eigene Artikel übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Shoppinglisten_übertragen|Shoppinglisten übertragen (z. B. Bestellvorlagen)]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen|Jobinformationen]]
*[[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]]
*[[Kostenpflichtige Module/Internet-Shop/brShop24/PDF-Druck Artikellink|PDF-Druck Artikellink]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Definition_Sortiment|Definition Sortiment (individuelle Konfiguration)]]

=Häufig gestellte Fragen (FAQ)=
==API Fehlermeldungen==

{{Vorlage:KlapptextFAQ
|faq_brshop24_fehler_trashed
|Was bedeutet die Meldung "api error: Record with the given unique fields data is trashed with ID 012356!"?
|Werden Datensätze wie ein Benutzer oder ein Artikel bei der jeweiligen Datenübertragung als "neuer Datensatz" erkannt, so übergibt OBS die Daten mit der Bitte/Anweisung um Anlage eines Datensatzes mit diesen Daten. Dies schlägt jedoch mit dieser Fehlermeldung fehl, wenn bereits ein Datensatz mit den gleichen zur eindeutigen Identifizierung verwendeten Daten im Shop mit der angegebenen ID existiert, jedoch in den "Papierkorb" verschoben wurde. Im brShop24 werden Daten nicht unbedingt gleich vollständig gelöscht. Diese Datensätze sind auch über die API nicht zu finden und müssen über den Adminbereich entweder vollständig gelöscht oder aus dem Papierkorb geholt werden.{{Hinweis|Welche Daten eindeutig sein müssen ist abhängig von der Art der Daten. Bei Artikeldaten ist dies z. B. die Lager- bzw. Depot-Identifikationsnummer zusammen mit der Shop-Artikelnummer aus den Artikel-Lagereinstellungen.}}
}}

==Daten Allgemein==
{{Vorlage:KlapptextFAQ
|faq_brshop24_alg_datennichtangezeigt
|Ich habe Daten aus OBS übertragen, diese werden jedoch nicht angezeigt?
|Je nach Art der Daten gelten verschiedene Voraussetzungen. Prüfen Sie daher, ob die Voraussetzungen gegeben sind oder bereits der Export scheitert. Entsprechende Hinweise finden Sie in den Hilfetexten zum jeweiligen Datenexport oder im Protokoll. Sind die Daten im Shop angelegt dort jedoch z. B. über den Adminbereich gelöscht worden, so können die Daten dort wiederhergestellt werden. Prüfen Sie daher auch, ob dies auf die Daten zutrifft. Dazu sei noch angemerkt, dass es im brShop24 zwei Varianten zum Löschen von Daten gibt:
#Soft-Delete d.h. ein Datensatz kann mit einem Löschkennzeichen markiert werden, so dass dieser zur Not auch wieder hergestellt werden kann (ähnlich dem Papierkorb unter Windows). Dies wird so z. B. im Adminbereich angewendet.
#Hard-Delete d.h. der Datensatz wird auch physikalisch vom Datenträger gelöscht, ist somit aus dem System entfernt und kann nicht wieder hergestellt werden. Dies gilt für die API.
}}

{{Vorlage:KlapptextFAQ
|faq_brshop24_alg_apisuperadmin
|Kann ich die Datensätze aus der API im Adminbereich ändern/editieren?
|Standardmäßig wird eine Bearbeitung von Datensätzen, welche per API gepflegt werden, im Shop gesperrt. Sie haben jedoch die Möglichkeit die Bearbeitung in Ihrem Adminbenutzer freizugeben. Die Administratoren finden Sie im Menü des Adminbereichs unter ''Administration'' im Unterpunkt ''Administratoren''. Suchen Sie in der Liste Ihren Benutzer (Benutzername steht oben rechts) und öffnen Sie die Eingabemaske. Im Reiter ''Einstellungen'' setzen Sie dann as Häkchen bei ''API Super-Administrator?''.
{{Hinweis|Da es Daten/Felder gibt, welche OBS nicht über die API pflegen kann. Kann es durchaus sinnvoll sein, dies zu aktivieren. Dies betrifft z. B. Berechtigungen für Kundengruppen wie die Sortimentsfreigabe.}}
}}

==Preise/Preislisten==
Siehe [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Häufig_gestellt_Fragen_(FAQ)|FAQ Preisexport brShop24]].

==Import Auftragsdateien (OpenTRANS)==
{{Vorlage:KlapptextFAQ
|faq_brshop24_imp_auftrag
|Warum wird die Kostenstelle nicht übernommen?
|Die Referenz auf die Kostenestelle muss in der Auftragsdatei im Element COST_CATEGORY_ID enthalten sein. OBS erwartet hier die vollständige Bezeichnung der [[OBS/Stammdaten/Personen#B2_-_Kostenstellen|Kostenstelle]]. Ist die Kostenstelle in der Auftragsdatei nicht enthalten oder die Referenz stimmt mit keiner Kostenstelle überein, so wird im Import keine Kostenstelle übernommen.
}}

==Migration VShop4==
{{Vorlage:KlapptextFAQ
|faq_brshop24_allg_parallelbetrieb
|Können im OBS brShop24 und VShop4 parallel betrieben werden?
|Ja, es ist mögliche beide Shops im OBS zu verwalten. OBS ist in der Lage mehrere Schnittstellen, auch des gleichen Typs, zu verwalten. Die Schnittstellen arbeiten unabhängig voneinander. Nach unseren Informationen ist ein Parallelbetrieb seitens Büroring jedoch nicht gewünscht, da die Daten des VShop 4 nachträglich nicht oder nur mit deutlich größerem Aufwand in den brShop24 migriert werden könnten. Eventuell gehen Ihnen hier also Daten verloren, wenn der VShop4 abgeschaltet wird. Der brShop24 würde nach der Migration also Ihren aktuellen VShop 4 ersetzen. Bei Fragen zu dem Thema wenden Sie sich bitte an den Support des Büroring.
}}

FRMGETSELECTION Y00EOD2AXH

2026-03-16T14:19:11Z

Nimz: Weiterleitungsziel von Kostenpflichtige Module/Internet-Shop/brShop24#Menü nach Kostenpflichtige Module/Internet-Shop/brShop24#W Definitionen importieren geändert

#REDIRECT [[Kostenpflichtige_Module/Internet-Shop/brShop24#W_Definitionen_importieren]]

Kostenpflichtige Module/Internet-Shop/brShop24

2026-03-16T14:18:25Z

Nimz: /* Menü */

{{Kostenpflichtige Module}}
{{Aktuelles|Die Schnittstelle brShop24 wird 60 Euro monatlich kosten.}}
Der brShop24 wird von der Genossenschaft [https://www.bueroring.de Büroring eG] entwickelt und angeboten. Diese ECommerce-Lösung soll langfristig den bisher angebotenen VShop 4 Pro ablösen. Für die Anbindung an den brShop24 steht Ihnen eine Schnittstelle basierend auf [https://de.wikipedia.org/wiki/GraphQL GraphQL] zur Verfügung.
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
{{Achtung|Die Schnittstellen für VShop 4 Pro und brShop24 sind nicht kompatibel! Sollten Sie sich also für eine Umstellung Ihres VShop 4 Pro auf das neue System brShop24 entscheiden, so muss dies im OBS ebenfalls umgestellt werden! Siehe auch die Punkte [[#Umstellung.2FMigration_VShop_4|Umstellung/Migration VShop 4]] und [[#faq_brshop24_allg_parallelbetrieb|FAQ Parallelbetrieb]].}}
=Funktionsumfang=
{{Achtung|Die hier aufgeführten Funktionen sind unter Vorbehalt in der aktuellen Version von OBS enthalten, da sich die Funktionalitäten in API und OBS noch ändern können.}}
Diese Schnittstelle unterstützt den Im- und Export von Daten wie folgt:
{| class="wikitable"
|-
! Import!! Export
|-
| Auftragsimport (OpenTRANS 1.0)|| Preislisten
|-
| Depots + Partner|| Kundengruppen
|-
| Anreden|| Ansprechpartner (Benutzer und Personen)
|-
| Kundentypen|| Kostenstellen
|-
| Kundenqualifikation|| Adressen (Personenstamm)
|-
| Job-Informationen (Ergebnis/Protokoll Preispflege)|| Shopping-Listen (Meistgekaufte Artikel/Top-Artikel)
|-
| Kundengruppen (Migration)||
|-
| Benutzer (Migration)||
|-
| Kostenstellen (Migration)||
|}
{{Hinweis|Zu Beginn wird es nur Bestelldateien im Format OpenTRANS 1.0 geben. Das neuere Format 2.1 ist aber bereits eingeplant und soll zu einem späteren Zeitpunkt folgen.}}
==Vergleich zur Schnittstelle VShop 4==
Stand: 13.10.2022
{| class="wikitable"
!|
|'''VShop 4'''
|'''brShop24'''
|-
|'''Bestellungen importieren'''
|ja
|ja
|-
|'''Kundendaten abfragen'''
|ja ("Kunde vorhanden?")
|ja ("Kunde vorhanden?" und Migration)
|-
|'''Kundendaten übertragen'''
|ja
|ja
|-
|style="padding-left: 100px"|(Kunden-)Gruppe
|Aus Personennummer (Hauptperson)
|eigene Verwaltung
|-
|style="padding-left: 100px"|Benutzerkonto
|aus Person und Ansprechpartner
|aus Ansprechpartner
|-
|style="padding-left: 100px"|Kostenstellen
|nur als Kostenstelle (mit Budget)
|Kostenstelle (noch ohne Budget; fehlt im Shop bisher) und Versandadresse
|-
|style="padding-left: 100px"|Shopping-Listen
|ja
|ja
|-
|style="padding-left: 100px"|Adressen/Adressbuch
|nein (nur Standardadresse im Benutzerkonto)
|ja
|-
|style="padding-left: 100px"|Anreden
|nein
|Import (Definition/Zuordnung)
|-
|style="padding-left: 100px"|Kundentyp
|nein
|Import (Definition/Zuordnung)
|-
|style="padding-left: 100px"|Kundenqualifikation
|nein
|Import (Definition/Zuordnung)
|-
|'''Artikelvorlage setzen'''
|ja
|nein
|-
|'''Preise übertragen'''
|ja
|ja (nur Preislisten)
|-
|'''Lager'''
|Import (Definition/Zuordnung)
|Import (Definition/Zuordnung)
|-
|'''Partner'''
|Import (Definition/Zuordnung)
|Import (Definition/Zuordnung)
|-
|'''Warengruppen/Kategorien'''
|Import (Definition/Zuordnung)
|nein
|-
|'''Artikel'''
|ja
|ja
|-
|style="padding-left: 100px"|übertragen
|ja
|ja
|-
|style="padding-left: 100px"|Abgleich (eigene Artikel)
|ja
|nein
|-
|'''Sterne'''
|ja
|nein
|-
|'''monatliche Kosten'''
|20 Euro
|60 Euro
|}
{{Hinweis|Für eine Beschreibung der einzelnen Funktionen siehe [[#Erklärungen/Funktionen|Erklärungen/Funktionen]].}}

==Bekannte Probleme==
{{Hinweis|Die hier aufgeführten Probleme sollen einen Überblick zum Stand einzelner Funktionen geben, sollten Sie sich dazu entscheiden mit der Schnittstelle zu arbeiten.}}
{{Achtung|Bei den letzten Tests kam es zu einem Fehler innerhalb der API, durch den die übermittelten Daten nicht korrekt verarbeitet wurden. Der Fehler trat an verschiedenen Stellen auf und konnte nicht reproduziert werden. Aktuell ist dies unter Beobachtung seitens Büroring. Von OBS aus können Sie aktuell die Datenübertragung nur ein zweites Mal ausführen, bis eine Lösung für das Problem gefunden wurde. Bei Preislisten hatte das Problem jedoch noch die Auswirkung, dass die Preislisten danach doppelt vorhanden war (siehe "doppelte Preislisten bei Fehler in Preislistenupdate").}}
===Import Bestellungen===
*;eindeutige Identifikation von Artikeln
:Nach aktuellem Stand wird nur der aktuelle Katalog von Büroring eingespielt. Sollten jedoch auch von anderen Lieferanten Artikel im Shop verkauft werden, kann es bei den Artikelnummern zu "doppelten" Artikeln kommen. Derzeit fehlt noch die Möglichkeit dies beim Import unterscheiden zu können.
*;fehlende Kostenstellen
:In der Auftragsdatei werden nach aktuellem Stand keine Kostenstellen geliefert. Somit kann OBS diese bei der Auftragsgenerierung hinterlegen. ''Die Kostenstellen werden nach Informationen von Büroring jetzt in die openTRANS-Order übernommen (Stand 25.02.2021).''
*;Anzeige in FTP-Eingang
:Bei aktivierter Anzeige von importierten Bestellungen im FTP-Eingang, wird bisher in der Spalte ''Typ'' nichts angezeigt. ''Behoben mit Version 003663 (Info 005482).''

===Personendaten===
*;Export Kostenstellen Budgets
:Die Budgetverwaltung wurde bisher noch nicht im brShop24 umgesetzt und steht daher auch in der API noch nicht zur Verfügung.
*;Anzeige Webshop-Einstellungen
:Die Anzeige des Kundenstatus funktioniert aktuell nur, wenn die Kundennummer auch in einer Kundengruppe steht. ''Behoben mit Version 003591 (Info 005378).''
*;Übertragung Adressen
:Die Adressen werden nicht angelegt, weil der Typ mit einem ungültigen Wert an die API übergeben wird. ''Behoben mit Version 003587 (Info 005365).''
*;Zuordnung Adressen Kundengruppe
:Adressen werden bei Übertragung auch in der Kundengruppe zugeordnet, obwohl es sich um eine System-Gruppe handelt. ''Behoben mit Version 003600.''
*;Zuordnung Adressen Benutzer
:Im Benutzer wird eine übertragene Adresse nicht zugeordnet. ''Behoben mit Version 003665 (Info 005483).''
*;Einfügen neuer Kundengruppen
:Die Datensätze werden im OBS nicht korrekt angelegt und können daher nicht exportiert werden. ''Behoben mit Version 003594 (Infos 005375 und 005393).''
*;Adressen aus Kostenstellen
:Werden bisher nicht übertragen. ''Behoben mit Version 003606 (Info 005398). Adressen aus Kostenstellen werden jetzt als Versandadressen hinterlegt''
*;Zuordnung Kostenstellen
:Kostenstellen werden bei Übertragung auch in der Kundengruppe zugeordnet, wenn es sich um eine System-Gruppe handelt. ''Behoben mit Version 003600. Kostenstellen werden bei Systemgruppen nicht mehr exportiert. Benutzer erhalten einen Hinweis bei Export der Personendaten aus den Webshop-Einstellungen und werden gefragt, ob die Personedaten trotzdem exportiert werden sollen.''
*;Im Shop ist der Adresstyp vertauscht
:Adressen die eigentlich "Postanschrift" haben sollten, bekommen "Postfach Anschrift" und umgekehrt. ''Behoben mit Version 003684 (Info 005494).''
*;Benutzer ist immer Admin
:Die Funktionalität über Eigenschaft 9011 wurde noch nicht übernommen aus der VShop-Schnittstelle übernommen, da sie dort problembehaftet ist. Die Fehlerhafte Übertragung in dieser Schnittstelle wurde somit vorerst vollständig entfernt. ''Behoben mit Version 003735 (Info 005548).''
*;Benutzer wird nicht angelegt
:Während des Exports kommt es zu einem Abbruch im OBS und der Export wird nicht vollständig ausgeführt. ''Behoben mit Version 004061 (Info 005911).''

===Preise/Preislisten===
*;Keine Aktualisierung für Kunden mit Kundennummer im Benutzer
:Preislisten werden nicht erkannt, wenn die Kundennummer nur im Benutzer vorkommt. ''Behoben mit Version 003592 (Info 005384).''
*;doppelte Preislisten bei Fehler in Preislistenupdate
:Tritt in der Aktualisierung der Preislistenkopfdaten ein Fehler auf, so wird die Preisliste ein weitere Mal angelegt. ''Behoben mit Version 003630 (Info 005452).''
*;Keine Aktualisierung der Kopfdaten
:Wurden im OBS Änderungen an den Kopfdaten (Name, Prio, Gültigkeitszeitraum) vorgenommen, konnte es passieren, dass diese nicht in den Shop übertragen wurden. ''Behoben mit Version 003703 (Info 005515).''
*;Preise löschen verlängert die Laufzeit der Preispflege
:Beim Löschen von Preisen könnte es vorkommen, dass sich die zu löschenden Datensätze nicht korrekt aus der Liste genommen wurden, auch wenn der Datensatz aus dem Shop entfernt wurde. Dadurch versucht OBS diese Datensätze bei jedem folgenden Durchlauf der Preispflege zu löschen, was fehlschlägt, da die Datensätze ja schon gelöscht sind. ''Behoben voraussichtlich mit Version 003833 (Info 005664).''
*;Preise werden nicht bei allen Preislisten aktualisiert
:Eine Prüfung war fehlerhaft und konnte die Aktualisierung der Preise für eine Preisliste verhindern. ''Behoben mit Version 003911 (Info 005733).''
*;Preislisten, welche über Preisgruppen einem Kunden zugeordnet sind, werden im Shop nicht in Kundengruppen und Benutzern hinterlegt
:An einer Stelle in der Abfrage der Zuordnungen sind die Nummern für Preisgruppe und Preisliste vertauscht. Der Fehler betrifft eigene Preislisten, welche über Preisgruppen zugeordnet sind. Für die Standard-Preislisten VK1 bis VK9 kommt es nicht zu diesem Fehler, da hier die Nummern identisch sind. ''Behoben mit Version 003959 (Info 005785).''
*;Zuordnungen von Preislisten sind fehlerhaft
:Unter bestimmten Umständen (Löschen ganzer Preislisten oder Kunde ohne verbleibende Preisliste) kann es im OBS zu einem Problem mit der Verwaltung der Zuordnungen im Shop kommen. Zuordnungen können dabei erhalten bleiben oder werden nicht angelegt. ''Behoben mit Version 004012 (Info 005847).''

===Bestellvorlagen/Shoppinglisten===
*;Anzeige im Shop
:Nach aktuellem Stand können die Bestellvorlagen, die es auch schon für den VShop 4 exportiert werden konnten, in den brShop24 übertragen werden. Die Anzeige im Frontend (Ansicht für den Kunden) ist jedoch noch nicht umgesetzt. Sie können aktuell nur über den Admibereich prüfen, ob die Bestellvorlagen im Shop angekommen sind. ''Im Frontend werden die Listen jetzt angezeigt (Stand: 09.11.2021).''
*;Generierung Shoppinglisten
:Durch einen Fehler in der Erkennung des Brüroring Zentrallagers konnte die falsche Lager-ID gezogen werden. Dadurch wurden die Artikel nicht korrekt identifiziert und die Shoppinglisten wurden nicht generiert. ''Behoben vorraussichtlich mit Version 003815 (Info 005654).''
*;Zuordnung Shoppinglisten
:In der Übertragung wurden Shoppinglisten nicht in Benutzern zugeordnet. Dadurch sehen insbesondere bei allgemeinen Kundengruppen (z. B. registrierte Kunden) Benutzer die von OBS für eine Kundennummer erstellten und übertragenen Shoppinglisten nicht. ''Behoben mit Version 003832 (Info 005663).''

===Migration===
*;Auswahl eines vorhandenen Ansprechpartner für Zuordnung zu einem Shop-Benutzer schlägt fehlt
:Die Auswahl verhält sich als würde keine Datensatz ausgewählt werden und setzt daher die Zuordnung nicht. ''Behoben mit Version 004012 (Info 005845).''
*;Aus einem Benutzerkonto kann kein Ansprechpartner angelegt werden
:Es kann bei der Übernahme der Daten zu einem SQL-Fehler im OBS kommen, welcher die Anlage der Daten verhindert. ''Behoben mit Version 004012 (Info 005844).''

=Kosten=
*;Einrichtung
:Sie können die Schnittstelle vom OBS-Support einrichten lassen oder dies selbst erledigen. Informationen zu den nötigen Daten/Angaben für eine Einrichtung finden Sie im nächsten Punkt [[#Installation.2FEinrichtung|Installation/Einrichtung]]. Wenn Sie eine Einrichtung durch den OBS-Support wünschen, wird dies '''einmalig nach Aufwand''' abgerechnet.
*;Nutzung Schnittstelle
:Für den Einsatz wird pro aktiver brShop24-Schnittstelle '''monatlich 60 Euro''' berechnet.

=Installation/Einrichtung=
Für die Einrichtung werden Angaben zur API-Anbindung und FTP-Zugangsdaten für die Abholung der Auftragsdateien benötigt. Außerdem muss OBS für die Preispflege auf das kostenpflichtige [[OBS/Kostenpflichtige_Module/Preislisten|OBS-Modul Preislisten]] umgestellt worden sein.
 
Für eine genaue Auflistung der benötigten Informationen und eine Beschreibung der Einrichtung lesen Sie bitte die Seite zur [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung einer brShop24-Schnittstelle]].

=Mit der Schnittstelle Starten=
==Daten migrieren==
Sofern Sie in der Vergangenheit einen VShop 4 verwendet haben und die Daten vom Büroring in den neuen brShop24 migriert wurden, empfehlen wir nach Abschluss der Einrichtung eine [[Kostenpflichtige_Module/Internet-Shop/brShop24/Migration|Datenmigration im OBS]] durchzuführen (siehe auch [[#Umstellung.2FMigration_VShop_4|Umstellung/Migration VShop 4]]). Dabei werden die vom VShop 4 migrierten Kundendaten aus dem Shop ausgelesen und in OBS importiert. OBS versucht die importierten Daten anschließend mit den Stammdaten zu verknüpfen und erstellt für die Kunden die Webshop-Einstellungen und gibt die Ansprechpartner frei. 
Nach den Kundengruppen und Benutzern werden die Kostenstellen eingelesen und versucht den Einträgen im OBS zuzuordnen. Der Anzeigename (Shop) einer Kostenstelle muss dabei mit der Bezeichnung der Kostenstelle übereinstimmen und innerhalb der Kundengruppe eindeutig sein.
{{Achtung|Die Zuordnung läuft automatisiert und kann einige Minuten in Anspruch nehmen! Sollte der Vorgang abbrechen, können Sie die Migration erneut starten. Die Zuordnung erfolgt nur für Daten, die eindeutig identifiziert werden konnten!}}
 
Außerdem werden die Preislisten aus den im Shop vorhandenen Preislisten ermittelt und für die Schnittstelle freigegeben. Die Preislisten werden stattdessen nach erfolgreicher Zuordnung im Shop geleert und neu befüllt. So sind die Preisdaten auch gleich auf dem aktuellen Stand und für die spätere Aktualisierung sind die Daten im OBS entsprechend vorbereitet.
{{Achtung|Es findet '''keine''' Verknüpfung mit den Preisdaten im OBS statt, da der vollständige Abgleich aller einzelnen Preisdaten zu lange dauern würde!}}

==Datenhoheit==
Es gibt einige spezifische Daten im Shop, die von OBS nicht angefasst werden (dürfen). Das betrifft z. B. die Standard-Kundengruppen des brShop24. Für OBS-Daten hat jedoch OBS die Datenhoheit. Im Shop können Sie dies an den verfügbaren Funktionen (Bild 1) erkennen. Die von OBS gepflegten Daten werden über die API (Bild 2) angelegt und haben bei den Funktionen statt dem Stift-Symbol (Daten bearbeiten) nur ein Auge-Symbol (Daten ansehen).
<gallery widths="200px">
File:Br24_admin_datenoptionen.jpg|Bild 1: Funktionen|alt=Funktionen
File:Br24_admin_letzte_aend.jpg|Bild 2: Letzte Änderung|alt=letzte Änderung
</gallery>

=Umstellung/Migration VShop 4=
Nach aktuellem Stand wird für Kunden mit VShop 4 vom Büroring eine Migration des bestehenden VShop 4 auf den neuen brShop24 durchgeführt. Dabei soll auch gewählt werden können, welche Daten bei der Migration übernommen werden. Wie dies genau aussieht, müssen Sie jedoch mit dem Büroring klären. Es gibt jedoch auch einige Punkte, die Sie bei der Migration für die Umstellung im OBS bedenken müssen.
*;Neue API
:Im Unterschied zum VShop 4 läuft die Schnittstelle zum brShop24 über eine API. OBS dies bringt ein paar Einschränkungen für die migrierten Daten mit sich. Es ist OBS nicht möglich die Daten wiederzufinden, die von OBS zuvor in den VShop 4 übertragen wurden. Wie sich dies auf die Pflege von Daten auswirkt, muss noch in Erfahrung gebracht werden, da im Testsystem keine migrierten Daten zur Verfügung stehen.
*;Besonderheit Preisdaten
:OBS arbeitet in Schnittstelle über eine sogenannte API-ID, also eine Identifikationsnnummer speziell für die neue API. OBS kann nur Preisdaten verändern, die auch über die API in den Shop übertragen wurden. Wir empfehlen daher die Preisdaten möglichst über OBS zu pflegen und nicht migrieren zu lassen.
*;Schnittstelle im OBS
:Die Schnittstelle muss im OBS freigeschaltet und eingerichtet werden (siehe dazu [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung]]). Dies kann bereits vor der Migration geschehen. Bedenken Sie jedoch, dass die Aufträge erst importiert werden können, nachdem die Schnittstelle eingerichtet wurde. Gebe Sie uns also rechtzeitig Bescheid, damit wir die Schnittstelle freigeben können. Die Einrichtung kann auf Wunsch von uns kostenpflichtig übernommen werden.{{Hinweis|Die Freischaltung der Schnittstelle hat auch eine Anpassung des Vertrags zur Folge. Bitte beachten Sie, dass die Schnittstelle brShop24 mit 60 Euro statt 20 Euro berechnet wird.}}
*;Modul Preislisten
:Für den brShop24 wird das Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] für die Pflege von Preisen über die Schnittstelle vorrausgesetzt. Sollten Sie dieses Modul noch nicht nutzen, so müsste dies zuvor eingerichtet werden, wenn Sie Preise aus OBS in den Shop übertragen möchten. Die Einrichtung des Moduls kann mehrere Stunden in Anspruch nehmen. Wir empfehlen die Umstellung vor der Migration durchzuführen, da dies die Arbeitsweise mit Artikelpreisen verändert. Eine Schulung wird ebenfalls empfohlen.
*;Migration Freigaben OBS VShop 4 nach brShop24 (siehe [[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]])
:Über das Shop-Menü können Kundengruppen und Benutzer mit dem OBS-Personenstamm abgeglichen werden. Im Personenstamm werden dann für gefundene Datensätze Webshop-Einstelungen angelegt. Ansprechpartnern, welchen ein Benutzer eindeutig zugeordnet werden konnten, erhalten die Eigenschaft 9013 und die Zuordnung zur Schnittstelle. Sollte die eindeutige Zuordnung ohne Benutzername erfolgt sein, so wird auch der Benutzername im Ansprechpartner hinterlegt. Außerdem werden die Preislisten mit dem Shop abgeglichen, freigegeben und übertragen.{{Hinweis|Es ist nicht möglich die Passwörter auszulesen. Diese können also nicht im Ansprechpartner hinterlegt werden. Sollten Sie zu einem späteren Zeitpunkt die den Benutzer im Shop aktualisieren wollen, müssten diesen zuvor ein Passwort gegeben werden, sollte noch keines vorhanden sein.}}{{Achtung|Damit die Migration auch die Kundendaten verknüpfen kann, muss diese Funktionalität im Shop freigeschaltet sein. Wenden Sie sich hierzu an den Support des Büroring.}}
==Ablauf einer Umstellung==
Für gewöhnlich richtet Büroring zunächst einen Shop zu Testzwecken ein. Sie erhalten danach die API-Daten, mit denen die Schnittstelle eingerichtet werden kann (siehe dazu [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung]]). Sie können jetzt die Schnittstelle testen und wenn Fragen oder Probleme geklärt sind, dem Büroring die Freigabe für den Live-Betrieb erteilen. Der Shop wird daraufhin zurückgesetzt. Dies muss im OBS ebenfalls passieren. Informieren Sie dazu den Support per Ticket oder E-Mail (siehe dazu auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung#Vorwort|Vorwort Einrichtung]]).

=Menü=
==B Preislisten verwalten==
Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Preislisten_verwalten|Preislistenverwaltung der Schnittstelle]]

==F Kundengruppen==
Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|Kundengruppenverwaltung der Schnittstelle]].

==I Bestellvorlagen verwalten==
Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Shoppinglisten_übertragen|Shoplistenverwaltung der Schnittstelle]].

==M Migration==
Startet die [[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]] der Daten. Dabei werden die aktuellen Kudnendaten (Gruppen und Benutzer) eingelesen und im Personestamm, sofern automatisiert möglich, Webshop-Einstellungen angelegt und Ansprechpartner zugeordnet.

==T Jobinformationen==
Die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen|Jobinformationen]] sind ein Protokoll des Shops für die Preispflege-Jobs. Diese werden beim Exportieren der Preise angelegt. Über diesen Menüpunkt können Sie die bisherigen Job-Protokolle einsehen. Beim Einlesen der Jobinformationen werden aufgetretene Fehler verarbeitet.

==U Bestellungen einlesen==
Liest die vorhanden Bestelldateien aus dem Shop-Verzeichnis ein. Für den automatischen Import siehe [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Bestellungen_einlesen|Automatiken: Bestellungen einlesen]].

==W Definitionen importieren==
Über diesen Menüpunkt können Sie alle für OBS-Relevanten Definitionen zur Vorbereitung der Datenexporte importieren. Dies umfasst aktuell folgende Definitionen:
*[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Depots/Lager mit Partner]]
*[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|Anreden]]
*Kundentypen (u. a. B2B, B2C)
*Kundenqualifikation (u. a. neuer Kunden, Stammkunde)
*Artikelbezeichnungsgruppen
*Produkttypen
*Mengeneinheiten
*Artikellieferstatus
*Hersteller
*Marken
*Umsatzsteuerdefinitionen
*Paketdienstleister
*Artikel-Einschluss-Listen
*Artikel-Ausschluss-Listen
*Kataloge
Für den automatischen Import siehe [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Definitionen_importieren|Automatiken: Definitionen importieren]].
{{Hinweis|Diese Definitionen spielen an verschiedenen Stellen eine wichtige Rolle. Sollten Sie die Definitionen noch nicht importiert und vor einem Datenexport zugeordnet haben, funktionert entweder der Datenexport nicht oder es werden Standardwerte verwendet.}}

==X Konfiguration==
Öffnet die [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Konfiguration]] der Schnittstellen. Hier können die Einstellungen der Schnittstelle angepasst werden.{{Hinweis|Um Anpassungen vorzunehmen wird für die meisten Einstellungen ein Level von 3 oder 5 benötigt. Es ist möglich dieses Level anzupassen, auch kann ein Benutzer für die Schnittstelle ein abweichendes Benutzerlevel erhalten. Melden Sie sich bei Bedarf per [[OBS/System/Ticket-System|OBS Ticketsystem]] beim OBS-Support.}}

==Y Testumgebung==
Öffnet eine Testumgebung, um die Anbindung zu testen.

==Z Protokoll==
|Über den Menüpunkt ''Z Protokoll'' des Shops-Menüs erhalten Sie Zugriff auf das Shop-Protokoll. Es werden vorrangig Hinweise zu Fehlern oder Problemen bei Im- und Exporten protokolliert. Über die Konfiguration kann mit Aktivierung des Debugmodus (Schlüssel ''Shop.Debug'') eine erweiterte Protokollierung aktiviert werden. Dafür benötigt ein Benutzer jedoch Administrationsrechte (Level 9) für die Schnittstelle.

=Zuordnungen=
Zuordnungen von Stammdaten wie Lieferanten und Mengeneinheiten nehmen Sie über den Shop-Menüpunkt ''X Konfiguration'' vor. In der Kofigurationsliste gelangen Sie über {{Key|F8 Zuord}} ins Zuordnungsmenü. 
 
Aktuelle Menüpunkte:
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|A Anreden]]
:Liste für im Shop definierte Anreden. Hier können Sie die OBS-Anreden mit den Shop-Anreden verknüpfen. Relevant für den Export von Personen. Ohne Zuordnung werden Personen ohne Anrede exportiert.
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Einheiten#brShop24|E Einheiten]]
:Liste für im Shop definierte Mengeneinheiten. Ordenen Sie hier die im OBS verwendeten Mengeneinheiten zu. {{Hinweis|Relevant für eigene Artikel. Ist eine verwendete OBS-Mengeneinheit nicht zugeordnet, so wird beim Export die Einheit "ST" (Stück) für den jeweiligen Artikel verwendet.}}
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|L Lager und Lagerlieferanten]]
:Definierte Depots und Partner des Shops. Partnern können Sie einem OBS-Lieferanten zuordnen und die Lager entsprechend auf Pflege Büroring oder als eigene Artikel definieren. Relevant für den Export von Preisen, Shoppinglisten (Bestellvorlagen) und eigene Artikel.
*;[[Kostenpflichtige_Module/Internet-Shop/Zusatz/Artikeltausch|T Artikeltausch]]
:Greift beim Auftragsimport. Austauschen bestimmter Referenznummern gegen einen festgeschrieben Artikel z. B. für Pauschalen.

=Erklärungen/Funktionen=
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|Kundengruppen verwalten]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Personen_übertragen|Kunden übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen|Preise übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Eigene_Artikel_übertragen|eigene Artikel übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Shoppinglisten_übertragen|Shoppinglisten übertragen (z. B. Bestellvorlagen)]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen|Jobinformationen]]
*[[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]]
*[[Kostenpflichtige Module/Internet-Shop/brShop24/PDF-Druck Artikellink|PDF-Druck Artikellink]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Definition_Sortiment|Definition Sortiment (individuelle Konfiguration)]]

=Häufig gestellte Fragen (FAQ)=
==API Fehlermeldungen==

{{Vorlage:KlapptextFAQ
|faq_brshop24_fehler_trashed
|Was bedeutet die Meldung "api error: Record with the given unique fields data is trashed with ID 012356!"?
|Werden Datensätze wie ein Benutzer oder ein Artikel bei der jeweiligen Datenübertragung als "neuer Datensatz" erkannt, so übergibt OBS die Daten mit der Bitte/Anweisung um Anlage eines Datensatzes mit diesen Daten. Dies schlägt jedoch mit dieser Fehlermeldung fehl, wenn bereits ein Datensatz mit den gleichen zur eindeutigen Identifizierung verwendeten Daten im Shop mit der angegebenen ID existiert, jedoch in den "Papierkorb" verschoben wurde. Im brShop24 werden Daten nicht unbedingt gleich vollständig gelöscht. Diese Datensätze sind auch über die API nicht zu finden und müssen über den Adminbereich entweder vollständig gelöscht oder aus dem Papierkorb geholt werden.{{Hinweis|Welche Daten eindeutig sein müssen ist abhängig von der Art der Daten. Bei Artikeldaten ist dies z. B. die Lager- bzw. Depot-Identifikationsnummer zusammen mit der Shop-Artikelnummer aus den Artikel-Lagereinstellungen.}}
}}

==Daten Allgemein==
{{Vorlage:KlapptextFAQ
|faq_brshop24_alg_datennichtangezeigt
|Ich habe Daten aus OBS übertragen, diese werden jedoch nicht angezeigt?
|Je nach Art der Daten gelten verschiedene Voraussetzungen. Prüfen Sie daher, ob die Voraussetzungen gegeben sind oder bereits der Export scheitert. Entsprechende Hinweise finden Sie in den Hilfetexten zum jeweiligen Datenexport oder im Protokoll. Sind die Daten im Shop angelegt dort jedoch z. B. über den Adminbereich gelöscht worden, so können die Daten dort wiederhergestellt werden. Prüfen Sie daher auch, ob dies auf die Daten zutrifft. Dazu sei noch angemerkt, dass es im brShop24 zwei Varianten zum Löschen von Daten gibt:
#Soft-Delete d.h. ein Datensatz kann mit einem Löschkennzeichen markiert werden, so dass dieser zur Not auch wieder hergestellt werden kann (ähnlich dem Papierkorb unter Windows). Dies wird so z. B. im Adminbereich angewendet.
#Hard-Delete d.h. der Datensatz wird auch physikalisch vom Datenträger gelöscht, ist somit aus dem System entfernt und kann nicht wieder hergestellt werden. Dies gilt für die API.
}}

{{Vorlage:KlapptextFAQ
|faq_brshop24_alg_apisuperadmin
|Kann ich die Datensätze aus der API im Adminbereich ändern/editieren?
|Standardmäßig wird eine Bearbeitung von Datensätzen, welche per API gepflegt werden, im Shop gesperrt. Sie haben jedoch die Möglichkeit die Bearbeitung in Ihrem Adminbenutzer freizugeben. Die Administratoren finden Sie im Menü des Adminbereichs unter ''Administration'' im Unterpunkt ''Administratoren''. Suchen Sie in der Liste Ihren Benutzer (Benutzername steht oben rechts) und öffnen Sie die Eingabemaske. Im Reiter ''Einstellungen'' setzen Sie dann as Häkchen bei ''API Super-Administrator?''.
{{Hinweis|Da es Daten/Felder gibt, welche OBS nicht über die API pflegen kann. Kann es durchaus sinnvoll sein, dies zu aktivieren. Dies betrifft z. B. Berechtigungen für Kundengruppen wie die Sortimentsfreigabe.}}
}}

==Preise/Preislisten==
Siehe [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Häufig_gestellt_Fragen_(FAQ)|FAQ Preisexport brShop24]].

==Import Auftragsdateien (OpenTRANS)==
{{Vorlage:KlapptextFAQ
|faq_brshop24_imp_auftrag
|Warum wird die Kostenstelle nicht übernommen?
|Die Referenz auf die Kostenestelle muss in der Auftragsdatei im Element COST_CATEGORY_ID enthalten sein. OBS erwartet hier die vollständige Bezeichnung der [[OBS/Stammdaten/Personen#B2_-_Kostenstellen|Kostenstelle]]. Ist die Kostenstelle in der Auftragsdatei nicht enthalten oder die Referenz stimmt mit keiner Kostenstelle überein, so wird im Import keine Kostenstelle übernommen.
}}

==Migration VShop4==
{{Vorlage:KlapptextFAQ
|faq_brshop24_allg_parallelbetrieb
|Können im OBS brShop24 und VShop4 parallel betrieben werden?
|Ja, es ist mögliche beide Shops im OBS zu verwalten. OBS ist in der Lage mehrere Schnittstellen, auch des gleichen Typs, zu verwalten. Die Schnittstellen arbeiten unabhängig voneinander. Nach unseren Informationen ist ein Parallelbetrieb seitens Büroring jedoch nicht gewünscht, da die Daten des VShop 4 nachträglich nicht oder nur mit deutlich größerem Aufwand in den brShop24 migriert werden könnten. Eventuell gehen Ihnen hier also Daten verloren, wenn der VShop4 abgeschaltet wird. Der brShop24 würde nach der Migration also Ihren aktuellen VShop 4 ersetzen. Bei Fragen zu dem Thema wenden Sie sich bitte an den Support des Büroring.
}}

FRMGETSELECTION Y00EOD2AXH

2026-03-16T14:14:05Z

Nimz: Weiterleitung nach Kostenpflichtige Module/Internet-Shop/brShop24#Menü erstellt

#REDIRECT [[Kostenpflichtige_Module/Internet-Shop/brShop24#Menü]]

Kostenpflichtige Module/Internet-Shop/brShop24

2026-03-16T14:13:04Z

Nimz: /* Menü */

{{Kostenpflichtige Module}}
{{Aktuelles|Die Schnittstelle brShop24 wird 60 Euro monatlich kosten.}}
Der brShop24 wird von der Genossenschaft [https://www.bueroring.de Büroring eG] entwickelt und angeboten. Diese ECommerce-Lösung soll langfristig den bisher angebotenen VShop 4 Pro ablösen. Für die Anbindung an den brShop24 steht Ihnen eine Schnittstelle basierend auf [https://de.wikipedia.org/wiki/GraphQL GraphQL] zur Verfügung.
{{Achtung|Für die Preisübertragung wird das kostenpflichtige Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] vorausgesetzt!}}
{{Achtung|Die Schnittstellen für VShop 4 Pro und brShop24 sind nicht kompatibel! Sollten Sie sich also für eine Umstellung Ihres VShop 4 Pro auf das neue System brShop24 entscheiden, so muss dies im OBS ebenfalls umgestellt werden! Siehe auch die Punkte [[#Umstellung.2FMigration_VShop_4|Umstellung/Migration VShop 4]] und [[#faq_brshop24_allg_parallelbetrieb|FAQ Parallelbetrieb]].}}
=Funktionsumfang=
{{Achtung|Die hier aufgeführten Funktionen sind unter Vorbehalt in der aktuellen Version von OBS enthalten, da sich die Funktionalitäten in API und OBS noch ändern können.}}
Diese Schnittstelle unterstützt den Im- und Export von Daten wie folgt:
{| class="wikitable"
|-
! Import!! Export
|-
| Auftragsimport (OpenTRANS 1.0)|| Preislisten
|-
| Depots + Partner|| Kundengruppen
|-
| Anreden|| Ansprechpartner (Benutzer und Personen)
|-
| Kundentypen|| Kostenstellen
|-
| Kundenqualifikation|| Adressen (Personenstamm)
|-
| Job-Informationen (Ergebnis/Protokoll Preispflege)|| Shopping-Listen (Meistgekaufte Artikel/Top-Artikel)
|-
| Kundengruppen (Migration)||
|-
| Benutzer (Migration)||
|-
| Kostenstellen (Migration)||
|}
{{Hinweis|Zu Beginn wird es nur Bestelldateien im Format OpenTRANS 1.0 geben. Das neuere Format 2.1 ist aber bereits eingeplant und soll zu einem späteren Zeitpunkt folgen.}}
==Vergleich zur Schnittstelle VShop 4==
Stand: 13.10.2022
{| class="wikitable"
!|
|'''VShop 4'''
|'''brShop24'''
|-
|'''Bestellungen importieren'''
|ja
|ja
|-
|'''Kundendaten abfragen'''
|ja ("Kunde vorhanden?")
|ja ("Kunde vorhanden?" und Migration)
|-
|'''Kundendaten übertragen'''
|ja
|ja
|-
|style="padding-left: 100px"|(Kunden-)Gruppe
|Aus Personennummer (Hauptperson)
|eigene Verwaltung
|-
|style="padding-left: 100px"|Benutzerkonto
|aus Person und Ansprechpartner
|aus Ansprechpartner
|-
|style="padding-left: 100px"|Kostenstellen
|nur als Kostenstelle (mit Budget)
|Kostenstelle (noch ohne Budget; fehlt im Shop bisher) und Versandadresse
|-
|style="padding-left: 100px"|Shopping-Listen
|ja
|ja
|-
|style="padding-left: 100px"|Adressen/Adressbuch
|nein (nur Standardadresse im Benutzerkonto)
|ja
|-
|style="padding-left: 100px"|Anreden
|nein
|Import (Definition/Zuordnung)
|-
|style="padding-left: 100px"|Kundentyp
|nein
|Import (Definition/Zuordnung)
|-
|style="padding-left: 100px"|Kundenqualifikation
|nein
|Import (Definition/Zuordnung)
|-
|'''Artikelvorlage setzen'''
|ja
|nein
|-
|'''Preise übertragen'''
|ja
|ja (nur Preislisten)
|-
|'''Lager'''
|Import (Definition/Zuordnung)
|Import (Definition/Zuordnung)
|-
|'''Partner'''
|Import (Definition/Zuordnung)
|Import (Definition/Zuordnung)
|-
|'''Warengruppen/Kategorien'''
|Import (Definition/Zuordnung)
|nein
|-
|'''Artikel'''
|ja
|ja
|-
|style="padding-left: 100px"|übertragen
|ja
|ja
|-
|style="padding-left: 100px"|Abgleich (eigene Artikel)
|ja
|nein
|-
|'''Sterne'''
|ja
|nein
|-
|'''monatliche Kosten'''
|20 Euro
|60 Euro
|}
{{Hinweis|Für eine Beschreibung der einzelnen Funktionen siehe [[#Erklärungen/Funktionen|Erklärungen/Funktionen]].}}

==Bekannte Probleme==
{{Hinweis|Die hier aufgeführten Probleme sollen einen Überblick zum Stand einzelner Funktionen geben, sollten Sie sich dazu entscheiden mit der Schnittstelle zu arbeiten.}}
{{Achtung|Bei den letzten Tests kam es zu einem Fehler innerhalb der API, durch den die übermittelten Daten nicht korrekt verarbeitet wurden. Der Fehler trat an verschiedenen Stellen auf und konnte nicht reproduziert werden. Aktuell ist dies unter Beobachtung seitens Büroring. Von OBS aus können Sie aktuell die Datenübertragung nur ein zweites Mal ausführen, bis eine Lösung für das Problem gefunden wurde. Bei Preislisten hatte das Problem jedoch noch die Auswirkung, dass die Preislisten danach doppelt vorhanden war (siehe "doppelte Preislisten bei Fehler in Preislistenupdate").}}
===Import Bestellungen===
*;eindeutige Identifikation von Artikeln
:Nach aktuellem Stand wird nur der aktuelle Katalog von Büroring eingespielt. Sollten jedoch auch von anderen Lieferanten Artikel im Shop verkauft werden, kann es bei den Artikelnummern zu "doppelten" Artikeln kommen. Derzeit fehlt noch die Möglichkeit dies beim Import unterscheiden zu können.
*;fehlende Kostenstellen
:In der Auftragsdatei werden nach aktuellem Stand keine Kostenstellen geliefert. Somit kann OBS diese bei der Auftragsgenerierung hinterlegen. ''Die Kostenstellen werden nach Informationen von Büroring jetzt in die openTRANS-Order übernommen (Stand 25.02.2021).''
*;Anzeige in FTP-Eingang
:Bei aktivierter Anzeige von importierten Bestellungen im FTP-Eingang, wird bisher in der Spalte ''Typ'' nichts angezeigt. ''Behoben mit Version 003663 (Info 005482).''

===Personendaten===
*;Export Kostenstellen Budgets
:Die Budgetverwaltung wurde bisher noch nicht im brShop24 umgesetzt und steht daher auch in der API noch nicht zur Verfügung.
*;Anzeige Webshop-Einstellungen
:Die Anzeige des Kundenstatus funktioniert aktuell nur, wenn die Kundennummer auch in einer Kundengruppe steht. ''Behoben mit Version 003591 (Info 005378).''
*;Übertragung Adressen
:Die Adressen werden nicht angelegt, weil der Typ mit einem ungültigen Wert an die API übergeben wird. ''Behoben mit Version 003587 (Info 005365).''
*;Zuordnung Adressen Kundengruppe
:Adressen werden bei Übertragung auch in der Kundengruppe zugeordnet, obwohl es sich um eine System-Gruppe handelt. ''Behoben mit Version 003600.''
*;Zuordnung Adressen Benutzer
:Im Benutzer wird eine übertragene Adresse nicht zugeordnet. ''Behoben mit Version 003665 (Info 005483).''
*;Einfügen neuer Kundengruppen
:Die Datensätze werden im OBS nicht korrekt angelegt und können daher nicht exportiert werden. ''Behoben mit Version 003594 (Infos 005375 und 005393).''
*;Adressen aus Kostenstellen
:Werden bisher nicht übertragen. ''Behoben mit Version 003606 (Info 005398). Adressen aus Kostenstellen werden jetzt als Versandadressen hinterlegt''
*;Zuordnung Kostenstellen
:Kostenstellen werden bei Übertragung auch in der Kundengruppe zugeordnet, wenn es sich um eine System-Gruppe handelt. ''Behoben mit Version 003600. Kostenstellen werden bei Systemgruppen nicht mehr exportiert. Benutzer erhalten einen Hinweis bei Export der Personendaten aus den Webshop-Einstellungen und werden gefragt, ob die Personedaten trotzdem exportiert werden sollen.''
*;Im Shop ist der Adresstyp vertauscht
:Adressen die eigentlich "Postanschrift" haben sollten, bekommen "Postfach Anschrift" und umgekehrt. ''Behoben mit Version 003684 (Info 005494).''
*;Benutzer ist immer Admin
:Die Funktionalität über Eigenschaft 9011 wurde noch nicht übernommen aus der VShop-Schnittstelle übernommen, da sie dort problembehaftet ist. Die Fehlerhafte Übertragung in dieser Schnittstelle wurde somit vorerst vollständig entfernt. ''Behoben mit Version 003735 (Info 005548).''
*;Benutzer wird nicht angelegt
:Während des Exports kommt es zu einem Abbruch im OBS und der Export wird nicht vollständig ausgeführt. ''Behoben mit Version 004061 (Info 005911).''

===Preise/Preislisten===
*;Keine Aktualisierung für Kunden mit Kundennummer im Benutzer
:Preislisten werden nicht erkannt, wenn die Kundennummer nur im Benutzer vorkommt. ''Behoben mit Version 003592 (Info 005384).''
*;doppelte Preislisten bei Fehler in Preislistenupdate
:Tritt in der Aktualisierung der Preislistenkopfdaten ein Fehler auf, so wird die Preisliste ein weitere Mal angelegt. ''Behoben mit Version 003630 (Info 005452).''
*;Keine Aktualisierung der Kopfdaten
:Wurden im OBS Änderungen an den Kopfdaten (Name, Prio, Gültigkeitszeitraum) vorgenommen, konnte es passieren, dass diese nicht in den Shop übertragen wurden. ''Behoben mit Version 003703 (Info 005515).''
*;Preise löschen verlängert die Laufzeit der Preispflege
:Beim Löschen von Preisen könnte es vorkommen, dass sich die zu löschenden Datensätze nicht korrekt aus der Liste genommen wurden, auch wenn der Datensatz aus dem Shop entfernt wurde. Dadurch versucht OBS diese Datensätze bei jedem folgenden Durchlauf der Preispflege zu löschen, was fehlschlägt, da die Datensätze ja schon gelöscht sind. ''Behoben voraussichtlich mit Version 003833 (Info 005664).''
*;Preise werden nicht bei allen Preislisten aktualisiert
:Eine Prüfung war fehlerhaft und konnte die Aktualisierung der Preise für eine Preisliste verhindern. ''Behoben mit Version 003911 (Info 005733).''
*;Preislisten, welche über Preisgruppen einem Kunden zugeordnet sind, werden im Shop nicht in Kundengruppen und Benutzern hinterlegt
:An einer Stelle in der Abfrage der Zuordnungen sind die Nummern für Preisgruppe und Preisliste vertauscht. Der Fehler betrifft eigene Preislisten, welche über Preisgruppen zugeordnet sind. Für die Standard-Preislisten VK1 bis VK9 kommt es nicht zu diesem Fehler, da hier die Nummern identisch sind. ''Behoben mit Version 003959 (Info 005785).''
*;Zuordnungen von Preislisten sind fehlerhaft
:Unter bestimmten Umständen (Löschen ganzer Preislisten oder Kunde ohne verbleibende Preisliste) kann es im OBS zu einem Problem mit der Verwaltung der Zuordnungen im Shop kommen. Zuordnungen können dabei erhalten bleiben oder werden nicht angelegt. ''Behoben mit Version 004012 (Info 005847).''

===Bestellvorlagen/Shoppinglisten===
*;Anzeige im Shop
:Nach aktuellem Stand können die Bestellvorlagen, die es auch schon für den VShop 4 exportiert werden konnten, in den brShop24 übertragen werden. Die Anzeige im Frontend (Ansicht für den Kunden) ist jedoch noch nicht umgesetzt. Sie können aktuell nur über den Admibereich prüfen, ob die Bestellvorlagen im Shop angekommen sind. ''Im Frontend werden die Listen jetzt angezeigt (Stand: 09.11.2021).''
*;Generierung Shoppinglisten
:Durch einen Fehler in der Erkennung des Brüroring Zentrallagers konnte die falsche Lager-ID gezogen werden. Dadurch wurden die Artikel nicht korrekt identifiziert und die Shoppinglisten wurden nicht generiert. ''Behoben vorraussichtlich mit Version 003815 (Info 005654).''
*;Zuordnung Shoppinglisten
:In der Übertragung wurden Shoppinglisten nicht in Benutzern zugeordnet. Dadurch sehen insbesondere bei allgemeinen Kundengruppen (z. B. registrierte Kunden) Benutzer die von OBS für eine Kundennummer erstellten und übertragenen Shoppinglisten nicht. ''Behoben mit Version 003832 (Info 005663).''

===Migration===
*;Auswahl eines vorhandenen Ansprechpartner für Zuordnung zu einem Shop-Benutzer schlägt fehlt
:Die Auswahl verhält sich als würde keine Datensatz ausgewählt werden und setzt daher die Zuordnung nicht. ''Behoben mit Version 004012 (Info 005845).''
*;Aus einem Benutzerkonto kann kein Ansprechpartner angelegt werden
:Es kann bei der Übernahme der Daten zu einem SQL-Fehler im OBS kommen, welcher die Anlage der Daten verhindert. ''Behoben mit Version 004012 (Info 005844).''

=Kosten=
*;Einrichtung
:Sie können die Schnittstelle vom OBS-Support einrichten lassen oder dies selbst erledigen. Informationen zu den nötigen Daten/Angaben für eine Einrichtung finden Sie im nächsten Punkt [[#Installation.2FEinrichtung|Installation/Einrichtung]]. Wenn Sie eine Einrichtung durch den OBS-Support wünschen, wird dies '''einmalig nach Aufwand''' abgerechnet.
*;Nutzung Schnittstelle
:Für den Einsatz wird pro aktiver brShop24-Schnittstelle '''monatlich 60 Euro''' berechnet.

=Installation/Einrichtung=
Für die Einrichtung werden Angaben zur API-Anbindung und FTP-Zugangsdaten für die Abholung der Auftragsdateien benötigt. Außerdem muss OBS für die Preispflege auf das kostenpflichtige [[OBS/Kostenpflichtige_Module/Preislisten|OBS-Modul Preislisten]] umgestellt worden sein.
 
Für eine genaue Auflistung der benötigten Informationen und eine Beschreibung der Einrichtung lesen Sie bitte die Seite zur [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung einer brShop24-Schnittstelle]].

=Mit der Schnittstelle Starten=
==Daten migrieren==
Sofern Sie in der Vergangenheit einen VShop 4 verwendet haben und die Daten vom Büroring in den neuen brShop24 migriert wurden, empfehlen wir nach Abschluss der Einrichtung eine [[Kostenpflichtige_Module/Internet-Shop/brShop24/Migration|Datenmigration im OBS]] durchzuführen (siehe auch [[#Umstellung.2FMigration_VShop_4|Umstellung/Migration VShop 4]]). Dabei werden die vom VShop 4 migrierten Kundendaten aus dem Shop ausgelesen und in OBS importiert. OBS versucht die importierten Daten anschließend mit den Stammdaten zu verknüpfen und erstellt für die Kunden die Webshop-Einstellungen und gibt die Ansprechpartner frei. 
Nach den Kundengruppen und Benutzern werden die Kostenstellen eingelesen und versucht den Einträgen im OBS zuzuordnen. Der Anzeigename (Shop) einer Kostenstelle muss dabei mit der Bezeichnung der Kostenstelle übereinstimmen und innerhalb der Kundengruppe eindeutig sein.
{{Achtung|Die Zuordnung läuft automatisiert und kann einige Minuten in Anspruch nehmen! Sollte der Vorgang abbrechen, können Sie die Migration erneut starten. Die Zuordnung erfolgt nur für Daten, die eindeutig identifiziert werden konnten!}}
 
Außerdem werden die Preislisten aus den im Shop vorhandenen Preislisten ermittelt und für die Schnittstelle freigegeben. Die Preislisten werden stattdessen nach erfolgreicher Zuordnung im Shop geleert und neu befüllt. So sind die Preisdaten auch gleich auf dem aktuellen Stand und für die spätere Aktualisierung sind die Daten im OBS entsprechend vorbereitet.
{{Achtung|Es findet '''keine''' Verknüpfung mit den Preisdaten im OBS statt, da der vollständige Abgleich aller einzelnen Preisdaten zu lange dauern würde!}}

==Datenhoheit==
Es gibt einige spezifische Daten im Shop, die von OBS nicht angefasst werden (dürfen). Das betrifft z. B. die Standard-Kundengruppen des brShop24. Für OBS-Daten hat jedoch OBS die Datenhoheit. Im Shop können Sie dies an den verfügbaren Funktionen (Bild 1) erkennen. Die von OBS gepflegten Daten werden über die API (Bild 2) angelegt und haben bei den Funktionen statt dem Stift-Symbol (Daten bearbeiten) nur ein Auge-Symbol (Daten ansehen).
<gallery widths="200px">
File:Br24_admin_datenoptionen.jpg|Bild 1: Funktionen|alt=Funktionen
File:Br24_admin_letzte_aend.jpg|Bild 2: Letzte Änderung|alt=letzte Änderung
</gallery>

=Umstellung/Migration VShop 4=
Nach aktuellem Stand wird für Kunden mit VShop 4 vom Büroring eine Migration des bestehenden VShop 4 auf den neuen brShop24 durchgeführt. Dabei soll auch gewählt werden können, welche Daten bei der Migration übernommen werden. Wie dies genau aussieht, müssen Sie jedoch mit dem Büroring klären. Es gibt jedoch auch einige Punkte, die Sie bei der Migration für die Umstellung im OBS bedenken müssen.
*;Neue API
:Im Unterschied zum VShop 4 läuft die Schnittstelle zum brShop24 über eine API. OBS dies bringt ein paar Einschränkungen für die migrierten Daten mit sich. Es ist OBS nicht möglich die Daten wiederzufinden, die von OBS zuvor in den VShop 4 übertragen wurden. Wie sich dies auf die Pflege von Daten auswirkt, muss noch in Erfahrung gebracht werden, da im Testsystem keine migrierten Daten zur Verfügung stehen.
*;Besonderheit Preisdaten
:OBS arbeitet in Schnittstelle über eine sogenannte API-ID, also eine Identifikationsnnummer speziell für die neue API. OBS kann nur Preisdaten verändern, die auch über die API in den Shop übertragen wurden. Wir empfehlen daher die Preisdaten möglichst über OBS zu pflegen und nicht migrieren zu lassen.
*;Schnittstelle im OBS
:Die Schnittstelle muss im OBS freigeschaltet und eingerichtet werden (siehe dazu [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung]]). Dies kann bereits vor der Migration geschehen. Bedenken Sie jedoch, dass die Aufträge erst importiert werden können, nachdem die Schnittstelle eingerichtet wurde. Gebe Sie uns also rechtzeitig Bescheid, damit wir die Schnittstelle freigeben können. Die Einrichtung kann auf Wunsch von uns kostenpflichtig übernommen werden.{{Hinweis|Die Freischaltung der Schnittstelle hat auch eine Anpassung des Vertrags zur Folge. Bitte beachten Sie, dass die Schnittstelle brShop24 mit 60 Euro statt 20 Euro berechnet wird.}}
*;Modul Preislisten
:Für den brShop24 wird das Modul [[OBS/Kostenpflichtige_Module/Preislisten|Preislisten]] für die Pflege von Preisen über die Schnittstelle vorrausgesetzt. Sollten Sie dieses Modul noch nicht nutzen, so müsste dies zuvor eingerichtet werden, wenn Sie Preise aus OBS in den Shop übertragen möchten. Die Einrichtung des Moduls kann mehrere Stunden in Anspruch nehmen. Wir empfehlen die Umstellung vor der Migration durchzuführen, da dies die Arbeitsweise mit Artikelpreisen verändert. Eine Schulung wird ebenfalls empfohlen.
*;Migration Freigaben OBS VShop 4 nach brShop24 (siehe [[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]])
:Über das Shop-Menü können Kundengruppen und Benutzer mit dem OBS-Personenstamm abgeglichen werden. Im Personenstamm werden dann für gefundene Datensätze Webshop-Einstelungen angelegt. Ansprechpartnern, welchen ein Benutzer eindeutig zugeordnet werden konnten, erhalten die Eigenschaft 9013 und die Zuordnung zur Schnittstelle. Sollte die eindeutige Zuordnung ohne Benutzername erfolgt sein, so wird auch der Benutzername im Ansprechpartner hinterlegt. Außerdem werden die Preislisten mit dem Shop abgeglichen, freigegeben und übertragen.{{Hinweis|Es ist nicht möglich die Passwörter auszulesen. Diese können also nicht im Ansprechpartner hinterlegt werden. Sollten Sie zu einem späteren Zeitpunkt die den Benutzer im Shop aktualisieren wollen, müssten diesen zuvor ein Passwort gegeben werden, sollte noch keines vorhanden sein.}}{{Achtung|Damit die Migration auch die Kundendaten verknüpfen kann, muss diese Funktionalität im Shop freigeschaltet sein. Wenden Sie sich hierzu an den Support des Büroring.}}
==Ablauf einer Umstellung==
Für gewöhnlich richtet Büroring zunächst einen Shop zu Testzwecken ein. Sie erhalten danach die API-Daten, mit denen die Schnittstelle eingerichtet werden kann (siehe dazu [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung|Einrichtung]]). Sie können jetzt die Schnittstelle testen und wenn Fragen oder Probleme geklärt sind, dem Büroring die Freigabe für den Live-Betrieb erteilen. Der Shop wird daraufhin zurückgesetzt. Dies muss im OBS ebenfalls passieren. Informieren Sie dazu den Support per Ticket oder E-Mail (siehe dazu auch [[Kostenpflichtige_Module/Internet-Shop/brShop24/Einrichtung#Vorwort|Vorwort Einrichtung]]).

=Menü=

{{Vorlage:KlapptextFAQ
|menu_b
|B Preislisten verwalten
|Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Preislisten_verwalten|Preislistenverwaltung der Schnittstelle]].
}}

{{Vorlage:KlapptextFAQ
|menu_f
|F Kundengruppen
|Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|Kundengruppenverwaltung der Schnittstelle]].
}}

{{Vorlage:KlapptextFAQ
|menu_i
|I Bestellvorlagen verwalten
|Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Shoppinglisten_übertragen|Shoplistenverwaltung der Schnittstelle]].
}}

{{Vorlage:KlapptextFAQ
|menu_m
|M Migration
|Startet die [[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]] der Daten. Dabei werden die aktuellen Kudnendaten (Gruppen und Benutzer) eingelesen und im Personestamm, sofern automatisiert möglich, Webshop-Einstellungen angelegt und Ansprechpartner zugeordnet.
}}

{{Vorlage:KlapptextFAQ
|menu_t
|T Jobinformationen
|Die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen|Jobinformationen]] sind ein Protokoll des Shops für die Preispflege-Jobs. Diese werden beim Exportieren der Preise angelegt. Über diesen Menüpunkt können Sie die bisherigen Job-Protokolle einsehen. Beim Einlesen der Jobinformationen werden aufgetretene Fehler verarbeitet.
}}

{{Vorlage:KlapptextFAQ
|menu_u
|U Bestellungen einlesen
|Liest die vorhanden Bestelldateien aus dem Shop-Verzeichnis ein. Für den automatischen Import siehe [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Bestellungen_einlesen|Automatiken: Bestellungen einlesen]].
}}

{{Vorlage:KlapptextFAQ
|menu_w
|W Definitionen importieren
|Über diesen Menüpunkt können Sie alle für OBS-Relevanten Definitionen zur Vorbereitung der Datenexporte importieren. Dies umfasst aktuell folgende Definitionen:
*[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Depots/Lager mit Partner]]
*[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|Anreden]]
*Kundentypen (u. a. B2B, B2C)
*Kundenqualifikation (u. a. neuer Kunden, Stammkunde)
*Artikelbezeichnungsgruppen
*Produkttypen
*Mengeneinheiten
*Artikellieferstatus
*Hersteller
*Marken
*Umsatzsteuerdefinitionen
*Paketdienstleister
*Artikel-Einschluss-Listen
*Artikel-Ausschluss-Listen
*Kataloge
Für den automatischen Import siehe [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Definitionen_importieren|Automatiken: Definitionen importieren]].
{{Hinweis|Diese Definitionen spielen an verschiedenen Stellen eine wichtige Rolle. Sollten Sie die Definitionen noch nicht importiert und vor einem Datenexport zugeordnet haben, funktionert entweder der Datenexport nicht oder es werden Standardwerte verwendet.}}
}}

{{Vorlage:KlapptextFAQ
|menu_x
|X Konfiguration
|Öffnet die [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Konfiguration]] der Schnittstellen. Hier können die Einstellungen der Schnittstelle angepasst werden.{{Hinweis|Um Anpassungen vorzunehmen wird für die meisten Einstellungen ein Level von 3 oder 5 benötigt. Es ist möglich dieses Level anzupassen, auch kann ein Benutzer für die Schnittstelle ein abweichendes Benutzerlevel erhalten. Melden Sie sich bei Bedarf per [[OBS/System/Ticket-System|OBS Ticketsystem]] beim OBS-Support.}}
}}

{{Vorlage:KlapptextFAQ
|menu_y
|Y Testumgebung
|Öffnet eine Testumgebung, um die Anbindung zu testen.
}}

{{Vorlage:KlapptextFAQ
|menu_z
|Z Protokoll
|Über den Menüpunkt ''Z Protokoll'' des Shops-Menüs erhalten Sie Zugriff auf das Shop-Protokoll. Es werden vorrangig Hinweise zu Fehlern oder Problemen bei Im- und Exporten protokolliert. Über die Konfiguration kann mit Aktivierung des Debugmodus (Schlüssel ''Shop.Debug'') eine erweiterte Protokollierung aktiviert werden. Dafür benötigt ein Benutzer jedoch Administrationsrechte (Level 9) für die Schnittstelle.
}}

=Zuordnungen=
Zuordnungen von Stammdaten wie Lieferanten und Mengeneinheiten nehmen Sie über den Shop-Menüpunkt ''X Konfiguration'' vor. In der Kofigurationsliste gelangen Sie über {{Key|F8 Zuord}} ins Zuordnungsmenü. 
 
Aktuelle Menüpunkte:
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|A Anreden]]
:Liste für im Shop definierte Anreden. Hier können Sie die OBS-Anreden mit den Shop-Anreden verknüpfen. Relevant für den Export von Personen. Ohne Zuordnung werden Personen ohne Anrede exportiert.
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Einheiten#brShop24|E Einheiten]]
:Liste für im Shop definierte Mengeneinheiten. Ordenen Sie hier die im OBS verwendeten Mengeneinheiten zu. {{Hinweis|Relevant für eigene Artikel. Ist eine verwendete OBS-Mengeneinheit nicht zugeordnet, so wird beim Export die Einheit "ST" (Stück) für den jeweiligen Artikel verwendet.}}
*;[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|L Lager und Lagerlieferanten]]
:Definierte Depots und Partner des Shops. Partnern können Sie einem OBS-Lieferanten zuordnen und die Lager entsprechend auf Pflege Büroring oder als eigene Artikel definieren. Relevant für den Export von Preisen, Shoppinglisten (Bestellvorlagen) und eigene Artikel.
*;[[Kostenpflichtige_Module/Internet-Shop/Zusatz/Artikeltausch|T Artikeltausch]]
:Greift beim Auftragsimport. Austauschen bestimmter Referenznummern gegen einen festgeschrieben Artikel z. B. für Pauschalen.

=Erklärungen/Funktionen=
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Kundengruppen_verwalten|Kundengruppen verwalten]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Personen_übertragen|Kunden übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen|Preise übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Eigene_Artikel_übertragen|eigene Artikel übertragen]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Shoppinglisten_übertragen|Shoppinglisten übertragen (z. B. Bestellvorlagen)]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Jobinformationen|Jobinformationen]]
*[[Kostenpflichtige Module/Internet-Shop/brShop24/Migration|Migration]]
*[[Kostenpflichtige Module/Internet-Shop/brShop24/PDF-Druck Artikellink|PDF-Druck Artikellink]]
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Definition_Sortiment|Definition Sortiment (individuelle Konfiguration)]]

=Häufig gestellte Fragen (FAQ)=
==API Fehlermeldungen==

{{Vorlage:KlapptextFAQ
|faq_brshop24_fehler_trashed
|Was bedeutet die Meldung "api error: Record with the given unique fields data is trashed with ID 012356!"?
|Werden Datensätze wie ein Benutzer oder ein Artikel bei der jeweiligen Datenübertragung als "neuer Datensatz" erkannt, so übergibt OBS die Daten mit der Bitte/Anweisung um Anlage eines Datensatzes mit diesen Daten. Dies schlägt jedoch mit dieser Fehlermeldung fehl, wenn bereits ein Datensatz mit den gleichen zur eindeutigen Identifizierung verwendeten Daten im Shop mit der angegebenen ID existiert, jedoch in den "Papierkorb" verschoben wurde. Im brShop24 werden Daten nicht unbedingt gleich vollständig gelöscht. Diese Datensätze sind auch über die API nicht zu finden und müssen über den Adminbereich entweder vollständig gelöscht oder aus dem Papierkorb geholt werden.{{Hinweis|Welche Daten eindeutig sein müssen ist abhängig von der Art der Daten. Bei Artikeldaten ist dies z. B. die Lager- bzw. Depot-Identifikationsnummer zusammen mit der Shop-Artikelnummer aus den Artikel-Lagereinstellungen.}}
}}

==Daten Allgemein==
{{Vorlage:KlapptextFAQ
|faq_brshop24_alg_datennichtangezeigt
|Ich habe Daten aus OBS übertragen, diese werden jedoch nicht angezeigt?
|Je nach Art der Daten gelten verschiedene Voraussetzungen. Prüfen Sie daher, ob die Voraussetzungen gegeben sind oder bereits der Export scheitert. Entsprechende Hinweise finden Sie in den Hilfetexten zum jeweiligen Datenexport oder im Protokoll. Sind die Daten im Shop angelegt dort jedoch z. B. über den Adminbereich gelöscht worden, so können die Daten dort wiederhergestellt werden. Prüfen Sie daher auch, ob dies auf die Daten zutrifft. Dazu sei noch angemerkt, dass es im brShop24 zwei Varianten zum Löschen von Daten gibt:
#Soft-Delete d.h. ein Datensatz kann mit einem Löschkennzeichen markiert werden, so dass dieser zur Not auch wieder hergestellt werden kann (ähnlich dem Papierkorb unter Windows). Dies wird so z. B. im Adminbereich angewendet.
#Hard-Delete d.h. der Datensatz wird auch physikalisch vom Datenträger gelöscht, ist somit aus dem System entfernt und kann nicht wieder hergestellt werden. Dies gilt für die API.
}}

{{Vorlage:KlapptextFAQ
|faq_brshop24_alg_apisuperadmin
|Kann ich die Datensätze aus der API im Adminbereich ändern/editieren?
|Standardmäßig wird eine Bearbeitung von Datensätzen, welche per API gepflegt werden, im Shop gesperrt. Sie haben jedoch die Möglichkeit die Bearbeitung in Ihrem Adminbenutzer freizugeben. Die Administratoren finden Sie im Menü des Adminbereichs unter ''Administration'' im Unterpunkt ''Administratoren''. Suchen Sie in der Liste Ihren Benutzer (Benutzername steht oben rechts) und öffnen Sie die Eingabemaske. Im Reiter ''Einstellungen'' setzen Sie dann as Häkchen bei ''API Super-Administrator?''.
{{Hinweis|Da es Daten/Felder gibt, welche OBS nicht über die API pflegen kann. Kann es durchaus sinnvoll sein, dies zu aktivieren. Dies betrifft z. B. Berechtigungen für Kundengruppen wie die Sortimentsfreigabe.}}
}}

==Preise/Preislisten==
Siehe [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Häufig_gestellt_Fragen_(FAQ)|FAQ Preisexport brShop24]].

==Import Auftragsdateien (OpenTRANS)==
{{Vorlage:KlapptextFAQ
|faq_brshop24_imp_auftrag
|Warum wird die Kostenstelle nicht übernommen?
|Die Referenz auf die Kostenestelle muss in der Auftragsdatei im Element COST_CATEGORY_ID enthalten sein. OBS erwartet hier die vollständige Bezeichnung der [[OBS/Stammdaten/Personen#B2_-_Kostenstellen|Kostenstelle]]. Ist die Kostenstelle in der Auftragsdatei nicht enthalten oder die Referenz stimmt mit keiner Kostenstelle überein, so wird im Import keine Kostenstelle übernommen.
}}

==Migration VShop4==
{{Vorlage:KlapptextFAQ
|faq_brshop24_allg_parallelbetrieb
|Können im OBS brShop24 und VShop4 parallel betrieben werden?
|Ja, es ist mögliche beide Shops im OBS zu verwalten. OBS ist in der Lage mehrere Schnittstellen, auch des gleichen Typs, zu verwalten. Die Schnittstellen arbeiten unabhängig voneinander. Nach unseren Informationen ist ein Parallelbetrieb seitens Büroring jedoch nicht gewünscht, da die Daten des VShop 4 nachträglich nicht oder nur mit deutlich größerem Aufwand in den brShop24 migriert werden könnten. Eventuell gehen Ihnen hier also Daten verloren, wenn der VShop4 abgeschaltet wird. Der brShop24 würde nach der Migration also Ihren aktuellen VShop 4 ersetzen. Bei Fragen zu dem Thema wenden Sie sich bitte an den Support des Büroring.
}}

OBS/Stammdaten/Artikel/Registerkarte: Shop/Einstellungsliste

2025-11-25T11:19:34Z

Nimz: /* Tasten und Schaltflächen */

{{Vorlage:Stammdaten}}
Die Liste der Shopeinstellung dient der Anlage und Verwaltung schnittstellenspezifischer Einstellungen.
=Liste=
[[Datei:U_webshopeinstellungen_artikel.jpg]]

{| class="wikitable"
|+ Spalten der Tabelle Shopeinstellungen
|-
! Spalte !! Beschreibung
|-
| Nummer || Nummer der Shop-Schnittstelle
|-
| Bezeichnung || Vergebene Bezeichnung für die Schnittstelle
|-
| Typ || Typ/Art der Schnittstelle
|-
| Pflege || aktuelle Pflege-Einstellung in den Webshop-Einstellungen
|}
==Tasten und Schaltflächen==
{| class="wikitable"
! Taste !! Beschreibung
|-
| {{Key|F4{{nb_space}}Sort}} || Änderung der Sortierung
|-
| {{Key|F6{{nb_space}}Meta}} || Sie werden zunächst gefragt, ob Metadaten für alle Schnittstellen erstellt werden sollen. Bei Auswahl ''Nein'' werden Metadaten nur für die aktuelle Schnittstelle erstellt/geändert. Anschließend öffnet sich die Maske [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/D_Metadaten_generieren|Artikel Metadaten generieren]].
|-
| {{Key|F7{{nb_space}}Text}} || Öffnet die Maske [[OBS/Stammdaten/Artikel:_Liste_Externe-Artikeltexte/Textgenerierung|Textgenerierung]]. Hier können Sie mit verschiedenen Platzhaltern einen Text für den artikel erstellen lassen. {{Hinweis|Nur verfügbar für Modified-Schnittstellen.}}
|-
| {{Key|F10{{nb_space}}Weit.}} || Öffnet die weiteren Funktionen der Liste 
*[[#Z_Prüfsumme_zurücksetzen|Z Prüfsumme zurücksetzen]]
|-
| {{Key|F11{{nb_space}}Aktua.}} || Aktualisiert die Anzeige. Dies passiert automatisch alle 30 Sekunden, sollten Sie nicht manuell {{F11}} drücken.
|-
| {{Key|Ret{{nb_space}}Ändern}} || {{Return}} öffnet die [[OBS/Stammdaten/Artikel/Registerkarte:_Shop/Einstellungsliste/Artikelauswahl|Einstellungsmaske]].{{Hinweis|Die Maske kann abweichen, da die enthaltenen Felder zum Teil schnittstellenabhängig sind! Für spezifische Informationen zu einer Schnittstlle siehe:
*[[Kostenpflichtige_Module/Internet-Shop/brShop24/Eigene_Artikel_übertragen#Shop-Einstellungen|Maske brShop24]]}}
|-
| {{Key|Einfg{{nb_space}}einf.}} || {{Einfg}} öffnet eine Auswahl hinterlegter Shop-Schnittstellen, welche noch nicht dem Artikel hinterlegt sind und zu denen Webshopeinstellungen gepflegt werden können. Wählen Sie die gewünschte Schnittstelle mit Return aus. Sollten Sie bereits Schnittstellen gepflegt haben, werden Sie anschließend gefragt, ob verschiedene Einstellungsdaten einer anderen Schnittstelle übernommen werden sollen.
|}

=Weitere Funktionen=
==Z Prüfsumme zurücksetzen==
Damit OBS nicht laufend Artikeldaten überträgt, wird nach einer erfolgreichen Übertragung eine Prüfsumme vermerkt. Diese kann mit dieser Funktion manuell zurückgesetzt werden.

OBS/Stammdaten/Artikel/Registerkarte: Shop/Einstellungsliste

2025-11-25T11:16:12Z

Nimz: /* Tasten und Schaltflächen */

{{Vorlage:Stammdaten}}
Die Liste der Shopeinstellung dient der Anlage und Verwaltung schnittstellenspezifischer Einstellungen.
=Liste=
[[Datei:U_webshopeinstellungen_artikel.jpg]]

{| class="wikitable"
|+ Spalten der Tabelle Shopeinstellungen
|-
! Spalte !! Beschreibung
|-
| Nummer || Nummer der Shop-Schnittstelle
|-
| Bezeichnung || Vergebene Bezeichnung für die Schnittstelle
|-
| Typ || Typ/Art der Schnittstelle
|-
| Pflege || aktuelle Pflege-Einstellung in den Webshop-Einstellungen
|}
==Tasten und Schaltflächen==
{| class="wikitable"
! Taste !! Beschreibung
|-
| {{Key|F4{{nb_space}}Sort}} || Änderung der Sortierung
|-
| {{Key|F6{{nb_space}}Meta}} || Sie werden zunächst gefragt, ob Metadaten für alle Schnittstellen erstellt werden sollen. Bei Auswahl ''Nein'' werden Metadaten nur für die aktuelle Schnittstelle erstellt/geändert. Anschließend öffnet sich die Maske [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/D_Metadaten_generieren|Artikel Metadaten generieren]].
|-
| {{Key|F7{{nb_space}}Text}} || Öffnet die Maske [[OBS/Stammdaten/Artikel:_Liste_Externe-Artikeltexte/Textgenerierung|Textgenerierung]]. Hier können Sie mit verschiedenen Platzhaltern einen Text für den artikel erstellen lassen. {{Hinweis|Nur verfügbar für Modified-Schnittstellen.}}
|-
| {{Key|F10{{nb_space}}Weit.}} || Öffnet die weiteren Funktionen der Liste 
*[[#Z_Prüfsumme_zurücksetzen|Z Prüfsumme zurücksetzen]]
|-
| {{Key|F11{{nb_space}}Aktua.}} || Aktualisiert die Anzeige. Dies passiert automatisch alle 30 Sekunden, sollten Sie nicht manuell {{F11}} drücken.
|-
| {{Key|Ret{{nb_space}}Ändern}} || {{Return}} öffnet die Einstellungsmaske.
|-
| {{Key|Einfg{{nb_space}}einf.}} || {{Einfg}} öffnet eine Auswahl hinterlegter Shop-Schnittstellen, welche noch nicht dem Artikel hinterlegt sind und zu denen Webshopeinstellungen gepflegt werden können. Wählen Sie die gewünschte Schnittstelle mit Return aus. Sollten Sie bereits Schnittstellen gepflegt haben, werden Sie anschließend gefragt, ob verschiedene Einstellungsdaten einer anderen Schnittstelle übernommen werden sollen.
|}

=Weitere Funktionen=
==Z Prüfsumme zurücksetzen==
Damit OBS nicht laufend Artikeldaten überträgt, wird nach einer erfolgreichen Übertragung eine Prüfsumme vermerkt. Diese kann mit dieser Funktion manuell zurückgesetzt werden.

OBS/Stammdaten/Artikel/Registerkarte: Shop/Einstellungsliste

2025-11-25T11:14:13Z

Nimz:

{{Vorlage:Stammdaten}}
Die Liste der Shopeinstellung dient der Anlage und Verwaltung schnittstellenspezifischer Einstellungen.
=Liste=
[[Datei:U_webshopeinstellungen_artikel.jpg]]

{| class="wikitable"
|+ Spalten der Tabelle Shopeinstellungen
|-
! Spalte !! Beschreibung
|-
| Nummer || Nummer der Shop-Schnittstelle
|-
| Bezeichnung || Vergebene Bezeichnung für die Schnittstelle
|-
| Typ || Typ/Art der Schnittstelle
|-
| Pflege || aktuelle Pflege-Einstellung in den Webshop-Einstellungen
|}
==Tasten und Schaltflächen==
{| class="wikitable"
! Taste !! Beschreibung
|-
| {{Key|F4 Sort}} || Änderung der Sortierung
|-
| {{Key|F6 Meta}} || Sie werden zunächst gefragt, ob Metadaten für alle Schnittstellen erstellt werden sollen. Bei Auswahl ''Nein'' werden Metadaten nur für die aktuelle Schnittstelle erstellt/geändert. Anschließend öffnet sich die Maske [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege/D_Metadaten_generieren|Artikel Metadaten generieren]].
|-
| {{Key|F7 Text}} || Öffnet die Maske [[OBS/Stammdaten/Artikel:_Liste_Externe-Artikeltexte/Textgenerierung|Textgenerierung]]. Hier können Sie mit verschiedenen Platzhaltern einen Text für den artikel erstellen lassen. {{Hinweis|Nur verfügbar für Modified-Schnittstellen.}}
|-
| {{Key|F10 Weit.}} || Öffnet die weiteren Funktionen der Liste 
*[[#Z_Prüfsumme_zurücksetzen|Z Prüfsumme zurücksetzen]]
|-
| {{Key|F11 Aktua.}} || Aktualisiert die Anzeige. Dies passiert automatisch alle 30 Sekunden, sollten Sie nicht manuell {{F11}} drücken.
|-
| {{Key|Ret Ändern}} || {{Return}} öffnet die Einstellungsmaske.
|-
| {{Key|Einfg einf.}} || {{Einfg}} öffnet eine Auswahl hinterlegter Shop-Schnittstellen, welche noch nicht dem Artikel hinterlegt sind und zu denen Webshopeinstellungen gepflegt werden können. Wählen Sie die gewünschte Schnittstelle mit Return aus. Sollten Sie bereits Schnittstellen gepflegt haben, werden Sie anschließend gefragt, ob verschiedene Einstellungsdaten einer anderen Schnittstelle übernommen werden sollen.
|}

=Weitere Funktionen=
==Z Prüfsumme zurücksetzen==
Damit OBS nicht laufend Artikeldaten überträgt, wird nach einer erfolgreichen Übertragung eine Prüfsumme vermerkt. Diese kann mit dieser Funktion manuell zurückgesetzt werden.

OBS/Stammdaten/Artikel/Eingabemaske

2025-11-25T10:51:54Z

Nimz: /* Registerkarte: 5 Shop */

{{Vorlage:Stammdaten}}

=Registerkarte: 1 Allgemeine Artikelstammdaten=
[[Image:ArtikelRegisterkarte 1.PNG]] 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Allgemeine Artikelstammdaten
|-
! Feld !! Beschreibung
|-
| Art-Nr || Dies ist die eindeutige Identifikationsnummer des Artikel in Ihrem Artikelstamm. Bei der Anlage eines neuen Artikels müssen Sie die eingegeben Artikelnummer mit {{Return}} bestätigen, bevor Sie die anderen Felder verwenden können. Welche Zeichen für Artikelnummern verwendet werden können richtet sich nach der Einstellung des Programmparameters ''0293''. Nachdem die Nummer eingegeben wurde kann diese über die Maske nicht mehr geändert werden. Dies ist nur in der Liste unter {{Key|F10 Weitere}} über die Funktion [[OBS/Artikel/F10_Weitere_Funktionen1#X1_-_Artikel_verschmelzen/Artikelnummer_%C3%A4ndern|Artikelnummer ändern]] möglich.
|-
| Suchbegriff || Der Suchbegriff wird automatisch aus Bezeichnung 1 generiert, kann aber auch eigenständig eingegeben werden.
|-
| Herst-Art-Nr || Die Herst-Art-Nr. unter der dieser Artikel beim Hersteller geführt wird
|-
| Bezeichnung 1 & 2 || geben Sie hier eine möglichst genaue Artikelbezeichnung ein.
|-
| Warengruppe || Wählen Sie hier die Warengruppe aus, in die der Artikel gehört.
|-
| U-Warengruppe || Wählen Sie hier die Unterwarengruppe, in die der Artikel gehört.
|-
| Erlöskonto || Wählen Sie hier das Konto aus, auf welchem die Erlöse dieses Artikels gutgeschrieben werden.
|-
| Einheit || Wählen Sie hier die Einheit aus, in der der Artikel gemessen wird.
|-
| EClass ||
|-
| Bemerkung || Diese steht als freier Text zur Verfügung. 
|-
| Mengeneinheit || Hier wird die Definition des Artikels als solcher angeben, z.B. ,1 Stück' oder ein Artikel entspricht einem 5er Pack also ,5 Stück' oder 1 Kasten Selter mit ,12 Flaschen'. Mit diesem Feld wird gerechnet! Die Staffelpreise müssen bzgl. der Mengeneinheit ausmultipliziert angegeben werden, z.B. bei einer Staffel 3 eines Artikels mit Mengeneinheit 100 ergibt das eine Staffel für Menge 300. Bei richtiger Einstellung in der Artikelpflege werden die Staffeln automatisch richtig übernommen. 
|-
| Mengenkennzeichen || ( Z Zehn / H Hundert /T Tausend) gibt an, wie viele Untereinheiten eine Mengeneinheit beinhaltet, z.B. 1 Packung Briefumschläge enthält 100 einzelne Briefumschläge. Es dient nur der besseren Verständnis und wird nicht zur Berechnung herangezogen. 
|-
| EAN-Nummer || Tragen Sie hier die EAN-Nummer Ihres Artikels ein, Sie können den EAN-Code auch mit einem Hand-Scanner einlesen. Wenn Sie in der Kasse diesen EAN-Code wieder einlesen, wird der Artikel automatisch erkannt. 
|-
| Lagerort || dient zum Auffinden des Artikels, auf der ''Registerkarte: Umsatzstatistik und Anderes'' kann noch eine genauere '''''Lagerpos.nr''''' eingetragen werden.
|-
| Positionsvorb. || Gibt die vorbelegte Menge dieses Artikels in den Positionen an. 
|-
| Anlagedatum || beinhaltet das Datum, an dem der Artikel in den Artikelstamm eingefügt wurde und wird automatisch gesetzt. 
|-
| Durchschnittlicher EK-Preis || Dies ist eine berechnete Größe, die beim Verbuchen von Einkaufsrechnungen immer wieder neu gesetzt wird. 
|-
| Letzer Umsatz || Dies ist das Datum, an dem zuletzt eine Rechnung zu diesem Artikel erzeugt wurde. 
|-
| Verpackung || Dieses Feld gibt an, wie viele Artikel zusammen geliefert werden, z.B. ein Karton Briefumschläge enthält 10 Packungen Briefumschläge. Diese Angabe dient nur zur reinen Information, d.h. hiermit werden keine Berechnungen durchgeführt. 
|-
| Alternative Artikelnummer || Dieses Feld ist ein Informationsfeld für eine andere Artikelnummer, die für diesen Artikel verwendet wird (z.B. eine interne Artikelnummer). Über Programmparameter ist einstellbar, ob der Artikel über die alternative Artikelnummer gesucht werden kann und ob die alternative Artikelnummer in der Positionserfassung benutzt werden kann. 
Hier können sie folgende Angaben machen: 
|-
| Bestand || Hier wird der aktuelle Bestand angezeigt. 
|-
| Meldebestand || Lagerbestand sollte nicht unter diese Menge fallen (wird für Hinweise u. Auswertung genutzt) 
|-
| Maximaler Bestand || Bis zu dieser Menge sollte das Lager aufgefüllt werden (wird für Hinweise u. Auswertung genutzt) 
|-
| Preisfokus ||
|-
| Automatik für Inaktiv || Wenn aktiviert setzt die Artikelpflege den Artikelzustand auf ''inaktiv'' wenn der Artikel bei keinem Lieferanten mehr lieferbar ist und keinen Lagerbestand hat. {{Hinweis|Hierzu muss der Programmparameter 0644 aktijviert sein.}}
|-
| Artikel ohne Bestandspflege || standardmäßig auf ''' Nein''', d.h. Artikel wird mit Bestandsdaten geführt''' 
|-
| Produktionsartikel || standardmäßig auf '''Nein''', d.h. Artikel wird '''nicht''' innerhalb des Untenehmens hergestellt''' 
|-
| Stückliste = Optionsliste || standardmäßig auf '''Nein''', d.h. der zusammengesetzte Artikel aus anderen Artikeln gilt '''nicht''' als Artikel in verschiedenen Ausführungen 
|-
| Kein Skonto || auf diesen Artikel wird kein Skonto gewährt 
|-
| Lagerartikel || dieser Artikel wird im Lager vorgehalten 
|-
| Inaktiv || dieser Artikel kann/soll nicht nehr verwendet werden, ''empfohlene Vorgehensweise, wenn Artikel aus dem Sortiment genommen werden soll, besser als den Artikel zu löschen, da ältere Daten noch auf diesen Artikel zurückgreifen''
|}

==VK-Preise 1-9 Tabelle:==
Die '''linke untere Seite der Regsiterkarte: Allgemeine Artikelstammdaten''' sieht wie folgt aus: 

[[Image:Artikel_Registerkarte_teil_3.PNG]] 

Die Bedeutung dieser Tabelle ist abhängig davon, ob mit Preissystem oder Rabattsystem (PP 305 Rabattgruppe=Ja, Preisgruppe =Nein) gearbeitet wird. Ist das '''Preissystem''' aktiviert, so wird einem Kunden entsprechend seiner Preis-/Rabattgruppe, der zugehörige VK zugewiesen, z.B. steht der Kunde auf Gruppe 2 so wird der VK2 benutzt. Ist das '''Rabattsystem''' aktiviert, so wird aus dieser Tabelle nur der VK1 benutzt. Es wird entsprechend der Gruppe des Kunden der zugehörige Rabatt (siehe [[OBS/Stammdaten/Registerkarte: Umsatzstatistiken + Anderes|Registerkarte: Umsatzstatistik und Anderes]]) der zugehörige Rabatt auf den VK1 gewährt, z.B. bei Gruppe2 der Rabatt2. 
''Hinweis: In der Praxis bietet es sich an, nicht bei den einzelnen Artikeln verschiedene Rabatte zu definieren, sondern die Rabatte für die Warengruppen festzulegen.'' 

Hier können Sie sehen, was die einzelnen Felder bedeuten: [[OBS/Weitere Stammdaten/F9 VK-Preise 1-9|Artikel VK-Preise 1-9]] 
Mit {{Return}} oder {{F9}} können Sie die Tabelle bearbeiten.

Es gibt auch die Möglichkeit die Preise mit {{F7}} zu kalkulieren. Näheres hierzu finden Sie unter [[OBS/Stammdaten/Artikel/Eingabemaske#F7_Kalk| F7 Kalkulation]].

==Lieferanten Tabelle:==
In der Lieferantentabelle im unteren Bereich sehen Sie die Lieferanten des aktuellen Artikels mit den entsprechenden Preisen. 

[[Image:Artikel_LieferantenTabelle.PNG]] 

Durch einen Doppelklick oder {{Return}} auf die Tabelle oder {{Key|F10 EK}} lassen sich die [[OBS/Weitere Stammdaten/F10 EK Lieferanten für Artikel|Lieferanten für den Artikel]] bearbeiten, d.h. es können Lieferanten geändert, eingefügt oder gelöscht werden.

=Registerkarte: 2 Umsatzstatistiken und Anderes=

[[Image:Artikel Registerkarte 2.PNG]] 

Im oberen Teil der Eingabemaske werden Ihnen zur Information die '''Artikelnummer''', der '''Suchbegriff ''' und die '''Hersteller-Artikelnummer''' des Artikels angezeigt. Sie können diese Daten hier nicht verändern. 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Umsatzstatistiken und Anderes
|-
! Feld !! Beschreibung
|-
| Artikelnr Folgeartikel || Ein weiterer Artikel, der normalerweise immer zusammen mit dem aktuellen Artikel ausgeliefert wird. Dieser Folgeartikel darf nicht identisch mit dem Artikel sein.
|-
| Aufgelaufener Umsatz || In diesem Block wird der Umsatz des laufenden Monats, Quartals, Jahres, des Vorjahres und der Einkauf im laufenden Jahr in Euro und in Stück angezeigt. Diese Werte werden automatisch von OBS beim Verbuchen gesetzt und können nicht verändert werden.
|-
| Periodenumsätze || Öffnet [[OBS/Stammdaten/Periodenumsatz|Periodenumsätze]]
|-
| Einstellungen für Sprache 2 || Dieser Teil der Registerkarte ist für den Handel mit dem Ausland.
{| class="wikitable"
|+ Einstellungen für Sprache 2
|-
| Bez. 1 und Bez. 2|| Hier können Sie die Bezeichnung des Artikels für die Fremdsprache einstellen.
|-
| Erlöskonto für Ausland und EU || Oft sollen die Erlöse, die durch Verkauf ins Ausland bzw. in die EU erwirtschaftet werden, auf ein separates Erlöskonto gebucht werden. Hier kann nun mit {{Raute}} die entsprechende Kontonummer eingetragen werden.
|-
| Mengeneinheit || Hier kann die gewünschte Mengeneinheit des Artikels für die Fremdsprache eingestellt werden.
|}
|-
| Gerät || Handelt es sich bei dem Artikel um ein Gerät, das in der [[OBS/Weitere Stammdaten/Geräteverwaltung|Geräteverwaltung]] als solches geführt werden soll, damit ggf. Verträge und Reparaturaufträge zu diesem Gerät erfasst werden können, so muss der Schalter '''Gerät = JA''' gesetzt werden.
|-
| Art || Die Geräteart muss ausgewählt werden, wenn es sich bei dem Artikel um ein Gerät handelt.
|-
| Garantiezeit || Es kann die Garantiezeit in Anzahl Monate eingegeben werden.
|-
| Serien-Nr Verwaltung || Spätestens bei der Auftragsbearbeitung muss jedem Gerät eine Seriennummer zugewiesen werden (per Grundeinstellung änderbar)
|-
| Gutscheinartikel || Hierüber kann einstellt werden ob es sich bei dem Artikel um einen [[OBS/Häufig gestellte Fragen/Gutscheinverwaltung|Gutschein]] handelt. Hiebei kann unterschieden werden, ob die Gutscheinnummer beim Verkaufen eines Gutscheinartikels automatisch (Generierung) oder manuell (Vorgefertigt), durch Eingabe des Kassieres, erstellt werden soll.
|-
| Inventurgruppe || Um die Inventur ein wenig zu strukturieren, es ist ratsam, die Artikel in Inventurgruppenzu gliedern, um so entsprechend Inventurlisten für Artikel zu erstellen, die zusammen gezählt werden sollen.
|-
| Lag.pos.nr || Zur schnelleren Auffindung des Artikels kann eine Lager Positionsnummer zusätzlich zum Lagerort von Registerblatt 1 angegeben werden. 
|-
| Mindest-VK-Menge || Gibt die mindestens zu verkaufende Menge an. 
|-
| Provisionssatz || Gibt die Provision an, die beim Verkauf dieses Artikels erzielt werden kann. 
|-
| Poskennz. || Sie können Ihrem Artikel ein Positionskennzeichen zuordnen, das automatisch in alle Aufträge, Rechnungen, etc. übernommen wird, wenn dieser Artikel eingefügt wird. 
|-
| Mindest-VK-Menge ||
|-
| WA ||
|-
| G - Faktor || Geben Sie hier den Faktor zum Umrechnen von der Mengeneinheit auf die G-Mengeneinheit ein. 
|-
| G - Mengeneinheit || Wählen Sie hier eine Mengeneinheit wie z.B. "%", "Stück" oder "Kg" für den Artikel aus. Die G-Menge dient dem Kunden zum Vergleichen verschiedener Artikel. Sie können so z.B. bei allen Artikeln den Preis für 1 Kg angeben. 
|-
| Hersteller Name || Gibt den Namen des Herstellers an. 
|-
| Umsatzmenge || ''gewünschter Sollwert'' für den Umsatz
|-
| Rabatt || 'Möchten Sie auf diesen Artikel generell keinen Rabatt gewähren (auch wenn auf die entsprechende Warengruppe ein Rabatt gewährt wird oder ein personenbezogener Rabatt exsitiert), dann tragen Sie ein "N" ein. Ist das Preissystem auf "Rabattsystem" gestellt (Programmparameter 0305 auf JA), erscheinen folgende Zusatzfelder: [[Image:Artikel_Registerkarte_Rabattsystem_ja.PNG]] Hier können Sie bei einem Artikel zusätzliche Informationen eingestellen: '''Rabatt: '''' Ist hier ein "N" eingeragen, werden auch die Werte in den Feldern "Rabatt 1-5" ignoriert, gehen jedoch nicht verloren, um sie später gegebenenfalls wieder zu aktivieren. '''Rabatt 1,2,3,... (%): '''Sie können pro Artikel verschiedene Rabattgruppen definieren. Je nachdem, welcher Rabattkategorie ein Kunde angehört, wird ihm in der Auftragsabwicklung automatisch der entsprechende Rabatt in eine Position übernommen und kann dort individuell geändert werden. Die Grundlage zur Berechnung des Rabattes ist hierbei der '''erste VK-Netto''' Preis; die folgenden Preise werden ignoriert. Ein Rabatt, der der Warengruppe dieses Artikels zugewiesen wurde, wird durch diese Felder überschrieben. 
|-
| Lohnansatz || Hier können Lohnstunden hinterlegt werden.
|-
| Masch.-ansatz || Bei Maschinenansatz können die Maschinenstunden hinterlegt werden.
|-
| Hadelsgew. || Handelsgewicht des Artikels
|-
| Absatz - Menge || "tatsächlicher Istwert" für den Umsatz
|-
| Übernahme Bezeichnung und Langtext aus Pflege || Bei Aktivierung werden die Bezeichnungen der einzelnen Artikel aus der Artikelpflege übernommen.
|-
| Multi-Steuer || s. [[OBS/Stammdaten/Artikel/Weitere Funktionen/Multisteuer|Multisteuer]]
|-
| MwST-Schlüssel || Mehrwertsteuer-Schlüssel des Artikels
|-
| VSt-Schlüssel || Vorsteuer-Schlüssel des Artikels
|-
| TSE-Geschäftsfall
|}

=Registerkarte: 3 Langtext=

[[Image:Artikel_Registerkarte_Langtext.PNG]] 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Langtext
|-
! Feld !! Beschreibung
|-
| Langtext || Langtexte dienen zur genaueren Beschreibung eines Artikels und werden automatisch bei Angeboten, Aufträgen, etc. in die Positionserfassung übernommen. Dies kann jedoch deaktiviert werden (s. ''Keine Übernahme des Langtextes in Positionen'').
|-
| Suchtexte || Sie können einem Artikel verschiedene Suchtexte hinzufügen, um Artikel über die OBS Suchfunktion leichter zu finden. 
|-
| Preislistenkalkulationsschalter 1-3 ||
|-
| Erfasst von || Hier wird der Sachbearbeiter angezeigt, der den Artikel angelegt hat.
|-
| Pos-art || Hiermit kann vorbelegt werden mit welcher Pos-Art ein Artikel in einem Vorgang angelegt wird. Dies kann z.B. hilfreich sein, wenn man einen Artikel standardmäßig auf ''ohne Berechnung'' in Aufträgen einfügen möchte.
|-
| Keine Übernahme des Langtextes in Positionen aus Artikel / Externe Texte ||
{| class="wikitable"
|-
| Artikel || Wenn aktiviert wird der Langtext nicht automatisch in die Positionen von Vorgängen (Angebote, Aufträge, etc.) übernommen.
|-
| Externe Texte ||
|}
|-
| Umrechnungsfaktor Material ||
|-
| Kostenstellenfaktor ||
|-
| Bruttogewicht ||
|-
| Volumen ||
|-
| Gefahrgutfaktor nach Beförder.-kat. ||
|-
| KanBan ||
|}

=Registerkarte: 4 Mengenberechnung=

=Registerkarte: 5 Shop=
Der Reiter 5 ist visueller Natur und zeigt Ihnen die gepflegten Webshop-Einstellungen des Artikels an. Mit Doppelklick oder {{Return}} öffnet die [[OBS/Stammdaten/Registerkarte: Shop/Einstellungsliste|Liste der Webshop-Einstellungen.]]. Dort können Sie vorhandene Einstellungen bearbeiten oder neue hinzufügen. 
Die Webshop-Einstellungen umfassen Daten wie eine alternative Artikelbezeichnung für den Shop, Bilder oder Langtext.
{{Hinweis|Unter den weiteren Funktionen ({{Key|[[OBS/Artikel/F10_Weitere_Funktionen1|F10 Weit.]]}}) des Artikelstamms finden sich alternative Zugänge zu den Listen und Daten von Shoptexten, Bildern und Varianten. Diese wurden lediglich in einem Reiter in der Maske zusammengefasst, damit die Shopdaten zu einem Artikel übersichtlicher und einfacher zu pflegen sind. In den weiteren Funktionen sind diese unter [[OBS/Stammdaten/Artikel:_H3_-_Shoppflege|H3 Shoppflege (Bilder/Texte/Textvarianten)]] und [[OBS/Stammdaten/Artikel:_O2_-_Preis-Varianten|O2 – Preis Varianten]] zu finden.}}
 
[[Image:Ue_artikel_r5_shop.jpg]] 

{| class="wikitable"
|+ Spalten der Tabelle Shopeinstellungen
|-
! Spalte !! Beschreibung
|-
| Nummer || Nummer der Shop-Schnittstelle
|-
| Bezeichnung || Vergebene Bezeichnung für die Schnittstelle
|-
| Typ || Typ/Art der Schnittstelle
|-
| Pflege || aktuelle Pflege-Einstellung in den Webshop-Einstellungen
|}

=Tasten und Schaltflächen=

=={{F5}} EAN-Nr==
Mit dieser Funktion können Sie in der Eingabemaske zu dem jeweiligen Artikel eine EAN (European Article Number) generieren.

=={{F6}} In PL==
Mit {{F6}} können Sie sich alle personenbezogenen Preise für diesen Artikel anzeigen lassen. Es öffnet sich das folgende Fenster: 

[[Image:Personenbezogene_Preise.PNG]] 

Mit {{Einfg}} können Sie für weitere Personen Preise hinterlegen. Das sich öffnende Fenster sieht wie folgt aus: 

[[Image:Personenbezogene_Preise_Eingabe.PNG]] 

Wählen Sie hiermit der {{Raute}}-Taste im Feld "Personennummer" die gewünschte Person aus, tragen Sie den Preis ein und sichern Sie mit {{F2}} Ihre Eingabe. Wenn Sie diesen Artikel nun in einem Auftrag für eine dieser Personen einfügen, wird der hinterlegte Preis automatisch eingefügt. [[Category:html]]
=={{F7}} Kalk==

Durch Klick auf {{F7}} in der Eingabemaske öffnet sich folgendes Fenster: 

[[Image:Artikel_kalkulieren.PNG]] 

Im linken Feld wird ihnen der Einkaufspreis (EK1) angezeigt. Die drei Spalten rechts daneben Zeigen Ihnen den '''Netto-Verkaufspreis''', den '''Brutto-Verkaufspreis''', den '''Erlös in Prozent''' und den '''Soll Erlös in Prozent'''. Jede Zeile steht für einen Verkaufspreis (VK1 - VK9). Immer wenn sie in einem Feld eine Änderung vornehmen, wird für die anderen beiden Felder derselben Spalte der entsprechende Wert automatisch errechnet. 
Wenn sie den Einkaufspreis ändern, wird in jeder Zeile, bei der sie in der entsprechenden Checkbox ein Häkchen gemacht haben, der '''Verkaufspreis''' neu errechnet. In allen Zeilen bei denen kein Häkchen gesetzt wurde, wird der '''Erlös''' neu errechnet.
Die Spalte Erlös Soll in Prozent dient der Funktion [[AusArtikelPreisanpassungSollanpassung|Preisanpassung über Sollanpassung]]. Hier können Sie den Soll-Erlös in Prozent eintragen. 
Durch '''Brutto führend''' kann eingestellt werden, dass der Bruttopreis nicht vom Nettopreis aus errechnet wird. Dies ist notwendig, da es sonst durch Rundungen nicht möglich ist, bestimmte Bruttopreise einzugeben. Näheres hierzu finden Sie auch unter: [[OBS/Stammdaten/OBS/Stammdaten/Brutto und Netto|Brutto und Netto in OBS]].
Wenn Sie mit der {{F2}}-Taste Ihre Eingabe sichern, werden die kalkulierten Preise automatisch in die richtigen Felder eingetragen.[[Category:html]]

=={{F8}} EAN==
Öffnet die [[OBS/Stammdaten/Artikel/F8 EAN-Verwaltung|EAN-Verwaltung]] gefiltert mit Einträgen nur für den aktuellen Artikel.

=={{F9}} VK==
In dieser Übersicht werden die '''VK1-VK9 ''' tabellarisch dargestellt. Wenn in dieser Spalte einen Brutto-Verkaufspreis angegeben wird, so wird der Netto - Verkaufspreis automatisch, entsprechend dem Mehrwertsteuersatz, angepaßt. 
*'''VK-Netto '''
*'''VK-Brutto '''
*'''Erlös in % '''- prozentualer Roherlös
*'''Erlös in € '''- der Roherlös, der bleibt, wenn der Einkaufspreis vom Netto-Verkaufspreis abgezogen wird
*''' Bedingung ''' - dient der reinen Information für den Anwender

Diese Tabelle sieht wie folgt aus: 

[[Image:F9_VK-Preise_1-9.PNG]] 

Sichern Sie mit {{F2}} Ihre Angaben.[[Category:html]]

=={{F10}} EK==
Öffnet die Liste der [[OBS/Stammdaten/Artikel/F10 EK Lieferanten für Artikel|Lieferanten für den aktuellen Artikel]]

OBS/Stammdaten/Artikel/Registerkarte: Shop

2025-11-25T10:47:26Z

Nimz: Weiterleitung nach OBS/Stammdaten/Artikel/Eingabemaske#Registerkarte: 5 Shop erstellt

#REDIRECT [[OBS/Stammdaten/Artikel/Eingabemaske#Registerkarte:_5_Shop]]

OBS/Stammdaten/Artikel/Eingabemaske

2025-11-25T10:46:16Z

Nimz: /* Registerkarte: 5 Shop */

{{Vorlage:Stammdaten}}

=Registerkarte: 1 Allgemeine Artikelstammdaten=
[[Image:ArtikelRegisterkarte 1.PNG]] 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Allgemeine Artikelstammdaten
|-
! Feld !! Beschreibung
|-
| Art-Nr || Dies ist die eindeutige Identifikationsnummer des Artikel in Ihrem Artikelstamm. Bei der Anlage eines neuen Artikels müssen Sie die eingegeben Artikelnummer mit {{Return}} bestätigen, bevor Sie die anderen Felder verwenden können. Welche Zeichen für Artikelnummern verwendet werden können richtet sich nach der Einstellung des Programmparameters ''0293''. Nachdem die Nummer eingegeben wurde kann diese über die Maske nicht mehr geändert werden. Dies ist nur in der Liste unter {{Key|F10 Weitere}} über die Funktion [[OBS/Artikel/F10_Weitere_Funktionen1#X1_-_Artikel_verschmelzen/Artikelnummer_%C3%A4ndern|Artikelnummer ändern]] möglich.
|-
| Suchbegriff || Der Suchbegriff wird automatisch aus Bezeichnung 1 generiert, kann aber auch eigenständig eingegeben werden.
|-
| Herst-Art-Nr || Die Herst-Art-Nr. unter der dieser Artikel beim Hersteller geführt wird
|-
| Bezeichnung 1 & 2 || geben Sie hier eine möglichst genaue Artikelbezeichnung ein.
|-
| Warengruppe || Wählen Sie hier die Warengruppe aus, in die der Artikel gehört.
|-
| U-Warengruppe || Wählen Sie hier die Unterwarengruppe, in die der Artikel gehört.
|-
| Erlöskonto || Wählen Sie hier das Konto aus, auf welchem die Erlöse dieses Artikels gutgeschrieben werden.
|-
| Einheit || Wählen Sie hier die Einheit aus, in der der Artikel gemessen wird.
|-
| EClass ||
|-
| Bemerkung || Diese steht als freier Text zur Verfügung. 
|-
| Mengeneinheit || Hier wird die Definition des Artikels als solcher angeben, z.B. ,1 Stück' oder ein Artikel entspricht einem 5er Pack also ,5 Stück' oder 1 Kasten Selter mit ,12 Flaschen'. Mit diesem Feld wird gerechnet! Die Staffelpreise müssen bzgl. der Mengeneinheit ausmultipliziert angegeben werden, z.B. bei einer Staffel 3 eines Artikels mit Mengeneinheit 100 ergibt das eine Staffel für Menge 300. Bei richtiger Einstellung in der Artikelpflege werden die Staffeln automatisch richtig übernommen. 
|-
| Mengenkennzeichen || ( Z Zehn / H Hundert /T Tausend) gibt an, wie viele Untereinheiten eine Mengeneinheit beinhaltet, z.B. 1 Packung Briefumschläge enthält 100 einzelne Briefumschläge. Es dient nur der besseren Verständnis und wird nicht zur Berechnung herangezogen. 
|-
| EAN-Nummer || Tragen Sie hier die EAN-Nummer Ihres Artikels ein, Sie können den EAN-Code auch mit einem Hand-Scanner einlesen. Wenn Sie in der Kasse diesen EAN-Code wieder einlesen, wird der Artikel automatisch erkannt. 
|-
| Lagerort || dient zum Auffinden des Artikels, auf der ''Registerkarte: Umsatzstatistik und Anderes'' kann noch eine genauere '''''Lagerpos.nr''''' eingetragen werden.
|-
| Positionsvorb. || Gibt die vorbelegte Menge dieses Artikels in den Positionen an. 
|-
| Anlagedatum || beinhaltet das Datum, an dem der Artikel in den Artikelstamm eingefügt wurde und wird automatisch gesetzt. 
|-
| Durchschnittlicher EK-Preis || Dies ist eine berechnete Größe, die beim Verbuchen von Einkaufsrechnungen immer wieder neu gesetzt wird. 
|-
| Letzer Umsatz || Dies ist das Datum, an dem zuletzt eine Rechnung zu diesem Artikel erzeugt wurde. 
|-
| Verpackung || Dieses Feld gibt an, wie viele Artikel zusammen geliefert werden, z.B. ein Karton Briefumschläge enthält 10 Packungen Briefumschläge. Diese Angabe dient nur zur reinen Information, d.h. hiermit werden keine Berechnungen durchgeführt. 
|-
| Alternative Artikelnummer || Dieses Feld ist ein Informationsfeld für eine andere Artikelnummer, die für diesen Artikel verwendet wird (z.B. eine interne Artikelnummer). Über Programmparameter ist einstellbar, ob der Artikel über die alternative Artikelnummer gesucht werden kann und ob die alternative Artikelnummer in der Positionserfassung benutzt werden kann. 
Hier können sie folgende Angaben machen: 
|-
| Bestand || Hier wird der aktuelle Bestand angezeigt. 
|-
| Meldebestand || Lagerbestand sollte nicht unter diese Menge fallen (wird für Hinweise u. Auswertung genutzt) 
|-
| Maximaler Bestand || Bis zu dieser Menge sollte das Lager aufgefüllt werden (wird für Hinweise u. Auswertung genutzt) 
|-
| Preisfokus ||
|-
| Automatik für Inaktiv || Wenn aktiviert setzt die Artikelpflege den Artikelzustand auf ''inaktiv'' wenn der Artikel bei keinem Lieferanten mehr lieferbar ist und keinen Lagerbestand hat. {{Hinweis|Hierzu muss der Programmparameter 0644 aktijviert sein.}}
|-
| Artikel ohne Bestandspflege || standardmäßig auf ''' Nein''', d.h. Artikel wird mit Bestandsdaten geführt''' 
|-
| Produktionsartikel || standardmäßig auf '''Nein''', d.h. Artikel wird '''nicht''' innerhalb des Untenehmens hergestellt''' 
|-
| Stückliste = Optionsliste || standardmäßig auf '''Nein''', d.h. der zusammengesetzte Artikel aus anderen Artikeln gilt '''nicht''' als Artikel in verschiedenen Ausführungen 
|-
| Kein Skonto || auf diesen Artikel wird kein Skonto gewährt 
|-
| Lagerartikel || dieser Artikel wird im Lager vorgehalten 
|-
| Inaktiv || dieser Artikel kann/soll nicht nehr verwendet werden, ''empfohlene Vorgehensweise, wenn Artikel aus dem Sortiment genommen werden soll, besser als den Artikel zu löschen, da ältere Daten noch auf diesen Artikel zurückgreifen''
|}

==VK-Preise 1-9 Tabelle:==
Die '''linke untere Seite der Regsiterkarte: Allgemeine Artikelstammdaten''' sieht wie folgt aus: 

[[Image:Artikel_Registerkarte_teil_3.PNG]] 

Die Bedeutung dieser Tabelle ist abhängig davon, ob mit Preissystem oder Rabattsystem (PP 305 Rabattgruppe=Ja, Preisgruppe =Nein) gearbeitet wird. Ist das '''Preissystem''' aktiviert, so wird einem Kunden entsprechend seiner Preis-/Rabattgruppe, der zugehörige VK zugewiesen, z.B. steht der Kunde auf Gruppe 2 so wird der VK2 benutzt. Ist das '''Rabattsystem''' aktiviert, so wird aus dieser Tabelle nur der VK1 benutzt. Es wird entsprechend der Gruppe des Kunden der zugehörige Rabatt (siehe [[OBS/Stammdaten/Registerkarte: Umsatzstatistiken + Anderes|Registerkarte: Umsatzstatistik und Anderes]]) der zugehörige Rabatt auf den VK1 gewährt, z.B. bei Gruppe2 der Rabatt2. 
''Hinweis: In der Praxis bietet es sich an, nicht bei den einzelnen Artikeln verschiedene Rabatte zu definieren, sondern die Rabatte für die Warengruppen festzulegen.'' 

Hier können Sie sehen, was die einzelnen Felder bedeuten: [[OBS/Weitere Stammdaten/F9 VK-Preise 1-9|Artikel VK-Preise 1-9]] 
Mit {{Return}} oder {{F9}} können Sie die Tabelle bearbeiten.

Es gibt auch die Möglichkeit die Preise mit {{F7}} zu kalkulieren. Näheres hierzu finden Sie unter [[OBS/Stammdaten/Artikel/Eingabemaske#F7_Kalk| F7 Kalkulation]].

==Lieferanten Tabelle:==
In der Lieferantentabelle im unteren Bereich sehen Sie die Lieferanten des aktuellen Artikels mit den entsprechenden Preisen. 

[[Image:Artikel_LieferantenTabelle.PNG]] 

Durch einen Doppelklick oder {{Return}} auf die Tabelle oder {{Key|F10 EK}} lassen sich die [[OBS/Weitere Stammdaten/F10 EK Lieferanten für Artikel|Lieferanten für den Artikel]] bearbeiten, d.h. es können Lieferanten geändert, eingefügt oder gelöscht werden.

=Registerkarte: 2 Umsatzstatistiken und Anderes=

[[Image:Artikel Registerkarte 2.PNG]] 

Im oberen Teil der Eingabemaske werden Ihnen zur Information die '''Artikelnummer''', der '''Suchbegriff ''' und die '''Hersteller-Artikelnummer''' des Artikels angezeigt. Sie können diese Daten hier nicht verändern. 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Umsatzstatistiken und Anderes
|-
! Feld !! Beschreibung
|-
| Artikelnr Folgeartikel || Ein weiterer Artikel, der normalerweise immer zusammen mit dem aktuellen Artikel ausgeliefert wird. Dieser Folgeartikel darf nicht identisch mit dem Artikel sein.
|-
| Aufgelaufener Umsatz || In diesem Block wird der Umsatz des laufenden Monats, Quartals, Jahres, des Vorjahres und der Einkauf im laufenden Jahr in Euro und in Stück angezeigt. Diese Werte werden automatisch von OBS beim Verbuchen gesetzt und können nicht verändert werden.
|-
| Periodenumsätze || Öffnet [[OBS/Stammdaten/Periodenumsatz|Periodenumsätze]]
|-
| Einstellungen für Sprache 2 || Dieser Teil der Registerkarte ist für den Handel mit dem Ausland.
{| class="wikitable"
|+ Einstellungen für Sprache 2
|-
| Bez. 1 und Bez. 2|| Hier können Sie die Bezeichnung des Artikels für die Fremdsprache einstellen.
|-
| Erlöskonto für Ausland und EU || Oft sollen die Erlöse, die durch Verkauf ins Ausland bzw. in die EU erwirtschaftet werden, auf ein separates Erlöskonto gebucht werden. Hier kann nun mit {{Raute}} die entsprechende Kontonummer eingetragen werden.
|-
| Mengeneinheit || Hier kann die gewünschte Mengeneinheit des Artikels für die Fremdsprache eingestellt werden.
|}
|-
| Gerät || Handelt es sich bei dem Artikel um ein Gerät, das in der [[OBS/Weitere Stammdaten/Geräteverwaltung|Geräteverwaltung]] als solches geführt werden soll, damit ggf. Verträge und Reparaturaufträge zu diesem Gerät erfasst werden können, so muss der Schalter '''Gerät = JA''' gesetzt werden.
|-
| Art || Die Geräteart muss ausgewählt werden, wenn es sich bei dem Artikel um ein Gerät handelt.
|-
| Garantiezeit || Es kann die Garantiezeit in Anzahl Monate eingegeben werden.
|-
| Serien-Nr Verwaltung || Spätestens bei der Auftragsbearbeitung muss jedem Gerät eine Seriennummer zugewiesen werden (per Grundeinstellung änderbar)
|-
| Gutscheinartikel || Hierüber kann einstellt werden ob es sich bei dem Artikel um einen [[OBS/Häufig gestellte Fragen/Gutscheinverwaltung|Gutschein]] handelt. Hiebei kann unterschieden werden, ob die Gutscheinnummer beim Verkaufen eines Gutscheinartikels automatisch (Generierung) oder manuell (Vorgefertigt), durch Eingabe des Kassieres, erstellt werden soll.
|-
| Inventurgruppe || Um die Inventur ein wenig zu strukturieren, es ist ratsam, die Artikel in Inventurgruppenzu gliedern, um so entsprechend Inventurlisten für Artikel zu erstellen, die zusammen gezählt werden sollen.
|-
| Lag.pos.nr || Zur schnelleren Auffindung des Artikels kann eine Lager Positionsnummer zusätzlich zum Lagerort von Registerblatt 1 angegeben werden. 
|-
| Mindest-VK-Menge || Gibt die mindestens zu verkaufende Menge an. 
|-
| Provisionssatz || Gibt die Provision an, die beim Verkauf dieses Artikels erzielt werden kann. 
|-
| Poskennz. || Sie können Ihrem Artikel ein Positionskennzeichen zuordnen, das automatisch in alle Aufträge, Rechnungen, etc. übernommen wird, wenn dieser Artikel eingefügt wird. 
|-
| Mindest-VK-Menge ||
|-
| WA ||
|-
| G - Faktor || Geben Sie hier den Faktor zum Umrechnen von der Mengeneinheit auf die G-Mengeneinheit ein. 
|-
| G - Mengeneinheit || Wählen Sie hier eine Mengeneinheit wie z.B. "%", "Stück" oder "Kg" für den Artikel aus. Die G-Menge dient dem Kunden zum Vergleichen verschiedener Artikel. Sie können so z.B. bei allen Artikeln den Preis für 1 Kg angeben. 
|-
| Hersteller Name || Gibt den Namen des Herstellers an. 
|-
| Umsatzmenge || ''gewünschter Sollwert'' für den Umsatz
|-
| Rabatt || 'Möchten Sie auf diesen Artikel generell keinen Rabatt gewähren (auch wenn auf die entsprechende Warengruppe ein Rabatt gewährt wird oder ein personenbezogener Rabatt exsitiert), dann tragen Sie ein "N" ein. Ist das Preissystem auf "Rabattsystem" gestellt (Programmparameter 0305 auf JA), erscheinen folgende Zusatzfelder: [[Image:Artikel_Registerkarte_Rabattsystem_ja.PNG]] Hier können Sie bei einem Artikel zusätzliche Informationen eingestellen: '''Rabatt: '''' Ist hier ein "N" eingeragen, werden auch die Werte in den Feldern "Rabatt 1-5" ignoriert, gehen jedoch nicht verloren, um sie später gegebenenfalls wieder zu aktivieren. '''Rabatt 1,2,3,... (%): '''Sie können pro Artikel verschiedene Rabattgruppen definieren. Je nachdem, welcher Rabattkategorie ein Kunde angehört, wird ihm in der Auftragsabwicklung automatisch der entsprechende Rabatt in eine Position übernommen und kann dort individuell geändert werden. Die Grundlage zur Berechnung des Rabattes ist hierbei der '''erste VK-Netto''' Preis; die folgenden Preise werden ignoriert. Ein Rabatt, der der Warengruppe dieses Artikels zugewiesen wurde, wird durch diese Felder überschrieben. 
|-
| Lohnansatz || Hier können Lohnstunden hinterlegt werden.
|-
| Masch.-ansatz || Bei Maschinenansatz können die Maschinenstunden hinterlegt werden.
|-
| Hadelsgew. || Handelsgewicht des Artikels
|-
| Absatz - Menge || "tatsächlicher Istwert" für den Umsatz
|-
| Übernahme Bezeichnung und Langtext aus Pflege || Bei Aktivierung werden die Bezeichnungen der einzelnen Artikel aus der Artikelpflege übernommen.
|-
| Multi-Steuer || s. [[OBS/Stammdaten/Artikel/Weitere Funktionen/Multisteuer|Multisteuer]]
|-
| MwST-Schlüssel || Mehrwertsteuer-Schlüssel des Artikels
|-
| VSt-Schlüssel || Vorsteuer-Schlüssel des Artikels
|-
| TSE-Geschäftsfall
|}

=Registerkarte: 3 Langtext=

[[Image:Artikel_Registerkarte_Langtext.PNG]] 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Langtext
|-
! Feld !! Beschreibung
|-
| Langtext || Langtexte dienen zur genaueren Beschreibung eines Artikels und werden automatisch bei Angeboten, Aufträgen, etc. in die Positionserfassung übernommen. Dies kann jedoch deaktiviert werden (s. ''Keine Übernahme des Langtextes in Positionen'').
|-
| Suchtexte || Sie können einem Artikel verschiedene Suchtexte hinzufügen, um Artikel über die OBS Suchfunktion leichter zu finden. 
|-
| Preislistenkalkulationsschalter 1-3 ||
|-
| Erfasst von || Hier wird der Sachbearbeiter angezeigt, der den Artikel angelegt hat.
|-
| Pos-art || Hiermit kann vorbelegt werden mit welcher Pos-Art ein Artikel in einem Vorgang angelegt wird. Dies kann z.B. hilfreich sein, wenn man einen Artikel standardmäßig auf ''ohne Berechnung'' in Aufträgen einfügen möchte.
|-
| Keine Übernahme des Langtextes in Positionen aus Artikel / Externe Texte ||
{| class="wikitable"
|-
| Artikel || Wenn aktiviert wird der Langtext nicht automatisch in die Positionen von Vorgängen (Angebote, Aufträge, etc.) übernommen.
|-
| Externe Texte ||
|}
|-
| Umrechnungsfaktor Material ||
|-
| Kostenstellenfaktor ||
|-
| Bruttogewicht ||
|-
| Volumen ||
|-
| Gefahrgutfaktor nach Beförder.-kat. ||
|-
| KanBan ||
|}

=Registerkarte: 4 Mengenberechnung=

=Registerkarte: 5 Shop=
Der Reiter 5 ist visueller Natur und zeigt Ihnen die gepflegten Webshop-Einstellungen des Artikels an. Mit Doppelklick oder {{Return}} öffnet die Liste der Webshop-Einstellungen. Dort können Sie vorhandene Einstellungen bearbeiten oder neue hinzufügen. 
[[Image:Ue_artikel_r5_shop.jpg]] 

{| class="wikitable"
|+ Spalten der Tabelle Shopeinstellungen
|-
! Spalte !! Beschreibung
|-
| Nummer || Nummer der Shop-Schnittstelle
|-
| Bezeichnung || Vergebene Bezeichnung für die Schnittstelle
|-
| Typ || Typ/Art der Schnittstelle
|-
| Pflege || aktuelle Pflege-Einstellung in den Webshop-Einstellungen
|}

=Tasten und Schaltflächen=

=={{F5}} EAN-Nr==
Mit dieser Funktion können Sie in der Eingabemaske zu dem jeweiligen Artikel eine EAN (European Article Number) generieren.

=={{F6}} In PL==
Mit {{F6}} können Sie sich alle personenbezogenen Preise für diesen Artikel anzeigen lassen. Es öffnet sich das folgende Fenster: 

[[Image:Personenbezogene_Preise.PNG]] 

Mit {{Einfg}} können Sie für weitere Personen Preise hinterlegen. Das sich öffnende Fenster sieht wie folgt aus: 

[[Image:Personenbezogene_Preise_Eingabe.PNG]] 

Wählen Sie hiermit der {{Raute}}-Taste im Feld "Personennummer" die gewünschte Person aus, tragen Sie den Preis ein und sichern Sie mit {{F2}} Ihre Eingabe. Wenn Sie diesen Artikel nun in einem Auftrag für eine dieser Personen einfügen, wird der hinterlegte Preis automatisch eingefügt. [[Category:html]]
=={{F7}} Kalk==

Durch Klick auf {{F7}} in der Eingabemaske öffnet sich folgendes Fenster: 

[[Image:Artikel_kalkulieren.PNG]] 

Im linken Feld wird ihnen der Einkaufspreis (EK1) angezeigt. Die drei Spalten rechts daneben Zeigen Ihnen den '''Netto-Verkaufspreis''', den '''Brutto-Verkaufspreis''', den '''Erlös in Prozent''' und den '''Soll Erlös in Prozent'''. Jede Zeile steht für einen Verkaufspreis (VK1 - VK9). Immer wenn sie in einem Feld eine Änderung vornehmen, wird für die anderen beiden Felder derselben Spalte der entsprechende Wert automatisch errechnet. 
Wenn sie den Einkaufspreis ändern, wird in jeder Zeile, bei der sie in der entsprechenden Checkbox ein Häkchen gemacht haben, der '''Verkaufspreis''' neu errechnet. In allen Zeilen bei denen kein Häkchen gesetzt wurde, wird der '''Erlös''' neu errechnet.
Die Spalte Erlös Soll in Prozent dient der Funktion [[AusArtikelPreisanpassungSollanpassung|Preisanpassung über Sollanpassung]]. Hier können Sie den Soll-Erlös in Prozent eintragen. 
Durch '''Brutto führend''' kann eingestellt werden, dass der Bruttopreis nicht vom Nettopreis aus errechnet wird. Dies ist notwendig, da es sonst durch Rundungen nicht möglich ist, bestimmte Bruttopreise einzugeben. Näheres hierzu finden Sie auch unter: [[OBS/Stammdaten/OBS/Stammdaten/Brutto und Netto|Brutto und Netto in OBS]].
Wenn Sie mit der {{F2}}-Taste Ihre Eingabe sichern, werden die kalkulierten Preise automatisch in die richtigen Felder eingetragen.[[Category:html]]

=={{F8}} EAN==
Öffnet die [[OBS/Stammdaten/Artikel/F8 EAN-Verwaltung|EAN-Verwaltung]] gefiltert mit Einträgen nur für den aktuellen Artikel.

=={{F9}} VK==
In dieser Übersicht werden die '''VK1-VK9 ''' tabellarisch dargestellt. Wenn in dieser Spalte einen Brutto-Verkaufspreis angegeben wird, so wird der Netto - Verkaufspreis automatisch, entsprechend dem Mehrwertsteuersatz, angepaßt. 
*'''VK-Netto '''
*'''VK-Brutto '''
*'''Erlös in % '''- prozentualer Roherlös
*'''Erlös in € '''- der Roherlös, der bleibt, wenn der Einkaufspreis vom Netto-Verkaufspreis abgezogen wird
*''' Bedingung ''' - dient der reinen Information für den Anwender

Diese Tabelle sieht wie folgt aus: 

[[Image:F9_VK-Preise_1-9.PNG]] 

Sichern Sie mit {{F2}} Ihre Angaben.[[Category:html]]

=={{F10}} EK==
Öffnet die Liste der [[OBS/Stammdaten/Artikel/F10 EK Lieferanten für Artikel|Lieferanten für den aktuellen Artikel]]

Datei:Ue artikel r5 shop.jpg

2025-11-25T10:36:23Z

Nimz:

Datei:U webshopeinstellungen artikel.jpg

2025-11-25T10:36:08Z

Nimz:

OBS/Stammdaten/Artikel/Eingabemaske

2025-11-25T10:06:16Z

Nimz: /* Registerkarte: 5 Shopt Langtext */

{{Vorlage:Stammdaten}}

=Registerkarte: 1 Allgemeine Artikelstammdaten=
[[Image:ArtikelRegisterkarte 1.PNG]] 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Allgemeine Artikelstammdaten
|-
! Feld !! Beschreibung
|-
| Art-Nr || Dies ist die eindeutige Identifikationsnummer des Artikel in Ihrem Artikelstamm. Bei der Anlage eines neuen Artikels müssen Sie die eingegeben Artikelnummer mit {{Return}} bestätigen, bevor Sie die anderen Felder verwenden können. Welche Zeichen für Artikelnummern verwendet werden können richtet sich nach der Einstellung des Programmparameters ''0293''. Nachdem die Nummer eingegeben wurde kann diese über die Maske nicht mehr geändert werden. Dies ist nur in der Liste unter {{Key|F10 Weitere}} über die Funktion [[OBS/Artikel/F10_Weitere_Funktionen1#X1_-_Artikel_verschmelzen/Artikelnummer_%C3%A4ndern|Artikelnummer ändern]] möglich.
|-
| Suchbegriff || Der Suchbegriff wird automatisch aus Bezeichnung 1 generiert, kann aber auch eigenständig eingegeben werden.
|-
| Herst-Art-Nr || Die Herst-Art-Nr. unter der dieser Artikel beim Hersteller geführt wird
|-
| Bezeichnung 1 & 2 || geben Sie hier eine möglichst genaue Artikelbezeichnung ein.
|-
| Warengruppe || Wählen Sie hier die Warengruppe aus, in die der Artikel gehört.
|-
| U-Warengruppe || Wählen Sie hier die Unterwarengruppe, in die der Artikel gehört.
|-
| Erlöskonto || Wählen Sie hier das Konto aus, auf welchem die Erlöse dieses Artikels gutgeschrieben werden.
|-
| Einheit || Wählen Sie hier die Einheit aus, in der der Artikel gemessen wird.
|-
| EClass ||
|-
| Bemerkung || Diese steht als freier Text zur Verfügung. 
|-
| Mengeneinheit || Hier wird die Definition des Artikels als solcher angeben, z.B. ,1 Stück' oder ein Artikel entspricht einem 5er Pack also ,5 Stück' oder 1 Kasten Selter mit ,12 Flaschen'. Mit diesem Feld wird gerechnet! Die Staffelpreise müssen bzgl. der Mengeneinheit ausmultipliziert angegeben werden, z.B. bei einer Staffel 3 eines Artikels mit Mengeneinheit 100 ergibt das eine Staffel für Menge 300. Bei richtiger Einstellung in der Artikelpflege werden die Staffeln automatisch richtig übernommen. 
|-
| Mengenkennzeichen || ( Z Zehn / H Hundert /T Tausend) gibt an, wie viele Untereinheiten eine Mengeneinheit beinhaltet, z.B. 1 Packung Briefumschläge enthält 100 einzelne Briefumschläge. Es dient nur der besseren Verständnis und wird nicht zur Berechnung herangezogen. 
|-
| EAN-Nummer || Tragen Sie hier die EAN-Nummer Ihres Artikels ein, Sie können den EAN-Code auch mit einem Hand-Scanner einlesen. Wenn Sie in der Kasse diesen EAN-Code wieder einlesen, wird der Artikel automatisch erkannt. 
|-
| Lagerort || dient zum Auffinden des Artikels, auf der ''Registerkarte: Umsatzstatistik und Anderes'' kann noch eine genauere '''''Lagerpos.nr''''' eingetragen werden.
|-
| Positionsvorb. || Gibt die vorbelegte Menge dieses Artikels in den Positionen an. 
|-
| Anlagedatum || beinhaltet das Datum, an dem der Artikel in den Artikelstamm eingefügt wurde und wird automatisch gesetzt. 
|-
| Durchschnittlicher EK-Preis || Dies ist eine berechnete Größe, die beim Verbuchen von Einkaufsrechnungen immer wieder neu gesetzt wird. 
|-
| Letzer Umsatz || Dies ist das Datum, an dem zuletzt eine Rechnung zu diesem Artikel erzeugt wurde. 
|-
| Verpackung || Dieses Feld gibt an, wie viele Artikel zusammen geliefert werden, z.B. ein Karton Briefumschläge enthält 10 Packungen Briefumschläge. Diese Angabe dient nur zur reinen Information, d.h. hiermit werden keine Berechnungen durchgeführt. 
|-
| Alternative Artikelnummer || Dieses Feld ist ein Informationsfeld für eine andere Artikelnummer, die für diesen Artikel verwendet wird (z.B. eine interne Artikelnummer). Über Programmparameter ist einstellbar, ob der Artikel über die alternative Artikelnummer gesucht werden kann und ob die alternative Artikelnummer in der Positionserfassung benutzt werden kann. 
Hier können sie folgende Angaben machen: 
|-
| Bestand || Hier wird der aktuelle Bestand angezeigt. 
|-
| Meldebestand || Lagerbestand sollte nicht unter diese Menge fallen (wird für Hinweise u. Auswertung genutzt) 
|-
| Maximaler Bestand || Bis zu dieser Menge sollte das Lager aufgefüllt werden (wird für Hinweise u. Auswertung genutzt) 
|-
| Preisfokus ||
|-
| Automatik für Inaktiv || Wenn aktiviert setzt die Artikelpflege den Artikelzustand auf ''inaktiv'' wenn der Artikel bei keinem Lieferanten mehr lieferbar ist und keinen Lagerbestand hat. {{Hinweis|Hierzu muss der Programmparameter 0644 aktijviert sein.}}
|-
| Artikel ohne Bestandspflege || standardmäßig auf ''' Nein''', d.h. Artikel wird mit Bestandsdaten geführt''' 
|-
| Produktionsartikel || standardmäßig auf '''Nein''', d.h. Artikel wird '''nicht''' innerhalb des Untenehmens hergestellt''' 
|-
| Stückliste = Optionsliste || standardmäßig auf '''Nein''', d.h. der zusammengesetzte Artikel aus anderen Artikeln gilt '''nicht''' als Artikel in verschiedenen Ausführungen 
|-
| Kein Skonto || auf diesen Artikel wird kein Skonto gewährt 
|-
| Lagerartikel || dieser Artikel wird im Lager vorgehalten 
|-
| Inaktiv || dieser Artikel kann/soll nicht nehr verwendet werden, ''empfohlene Vorgehensweise, wenn Artikel aus dem Sortiment genommen werden soll, besser als den Artikel zu löschen, da ältere Daten noch auf diesen Artikel zurückgreifen''
|}

==VK-Preise 1-9 Tabelle:==
Die '''linke untere Seite der Regsiterkarte: Allgemeine Artikelstammdaten''' sieht wie folgt aus: 

[[Image:Artikel_Registerkarte_teil_3.PNG]] 

Die Bedeutung dieser Tabelle ist abhängig davon, ob mit Preissystem oder Rabattsystem (PP 305 Rabattgruppe=Ja, Preisgruppe =Nein) gearbeitet wird. Ist das '''Preissystem''' aktiviert, so wird einem Kunden entsprechend seiner Preis-/Rabattgruppe, der zugehörige VK zugewiesen, z.B. steht der Kunde auf Gruppe 2 so wird der VK2 benutzt. Ist das '''Rabattsystem''' aktiviert, so wird aus dieser Tabelle nur der VK1 benutzt. Es wird entsprechend der Gruppe des Kunden der zugehörige Rabatt (siehe [[OBS/Stammdaten/Registerkarte: Umsatzstatistiken + Anderes|Registerkarte: Umsatzstatistik und Anderes]]) der zugehörige Rabatt auf den VK1 gewährt, z.B. bei Gruppe2 der Rabatt2. 
''Hinweis: In der Praxis bietet es sich an, nicht bei den einzelnen Artikeln verschiedene Rabatte zu definieren, sondern die Rabatte für die Warengruppen festzulegen.'' 

Hier können Sie sehen, was die einzelnen Felder bedeuten: [[OBS/Weitere Stammdaten/F9 VK-Preise 1-9|Artikel VK-Preise 1-9]] 
Mit {{Return}} oder {{F9}} können Sie die Tabelle bearbeiten.

Es gibt auch die Möglichkeit die Preise mit {{F7}} zu kalkulieren. Näheres hierzu finden Sie unter [[OBS/Stammdaten/Artikel/Eingabemaske#F7_Kalk| F7 Kalkulation]].

==Lieferanten Tabelle:==
In der Lieferantentabelle im unteren Bereich sehen Sie die Lieferanten des aktuellen Artikels mit den entsprechenden Preisen. 

[[Image:Artikel_LieferantenTabelle.PNG]] 

Durch einen Doppelklick oder {{Return}} auf die Tabelle oder {{Key|F10 EK}} lassen sich die [[OBS/Weitere Stammdaten/F10 EK Lieferanten für Artikel|Lieferanten für den Artikel]] bearbeiten, d.h. es können Lieferanten geändert, eingefügt oder gelöscht werden.

=Registerkarte: 2 Umsatzstatistiken und Anderes=

[[Image:Artikel Registerkarte 2.PNG]] 

Im oberen Teil der Eingabemaske werden Ihnen zur Information die '''Artikelnummer''', der '''Suchbegriff ''' und die '''Hersteller-Artikelnummer''' des Artikels angezeigt. Sie können diese Daten hier nicht verändern. 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Umsatzstatistiken und Anderes
|-
! Feld !! Beschreibung
|-
| Artikelnr Folgeartikel || Ein weiterer Artikel, der normalerweise immer zusammen mit dem aktuellen Artikel ausgeliefert wird. Dieser Folgeartikel darf nicht identisch mit dem Artikel sein.
|-
| Aufgelaufener Umsatz || In diesem Block wird der Umsatz des laufenden Monats, Quartals, Jahres, des Vorjahres und der Einkauf im laufenden Jahr in Euro und in Stück angezeigt. Diese Werte werden automatisch von OBS beim Verbuchen gesetzt und können nicht verändert werden.
|-
| Periodenumsätze || Öffnet [[OBS/Stammdaten/Periodenumsatz|Periodenumsätze]]
|-
| Einstellungen für Sprache 2 || Dieser Teil der Registerkarte ist für den Handel mit dem Ausland.
{| class="wikitable"
|+ Einstellungen für Sprache 2
|-
| Bez. 1 und Bez. 2|| Hier können Sie die Bezeichnung des Artikels für die Fremdsprache einstellen.
|-
| Erlöskonto für Ausland und EU || Oft sollen die Erlöse, die durch Verkauf ins Ausland bzw. in die EU erwirtschaftet werden, auf ein separates Erlöskonto gebucht werden. Hier kann nun mit {{Raute}} die entsprechende Kontonummer eingetragen werden.
|-
| Mengeneinheit || Hier kann die gewünschte Mengeneinheit des Artikels für die Fremdsprache eingestellt werden.
|}
|-
| Gerät || Handelt es sich bei dem Artikel um ein Gerät, das in der [[OBS/Weitere Stammdaten/Geräteverwaltung|Geräteverwaltung]] als solches geführt werden soll, damit ggf. Verträge und Reparaturaufträge zu diesem Gerät erfasst werden können, so muss der Schalter '''Gerät = JA''' gesetzt werden.
|-
| Art || Die Geräteart muss ausgewählt werden, wenn es sich bei dem Artikel um ein Gerät handelt.
|-
| Garantiezeit || Es kann die Garantiezeit in Anzahl Monate eingegeben werden.
|-
| Serien-Nr Verwaltung || Spätestens bei der Auftragsbearbeitung muss jedem Gerät eine Seriennummer zugewiesen werden (per Grundeinstellung änderbar)
|-
| Gutscheinartikel || Hierüber kann einstellt werden ob es sich bei dem Artikel um einen [[OBS/Häufig gestellte Fragen/Gutscheinverwaltung|Gutschein]] handelt. Hiebei kann unterschieden werden, ob die Gutscheinnummer beim Verkaufen eines Gutscheinartikels automatisch (Generierung) oder manuell (Vorgefertigt), durch Eingabe des Kassieres, erstellt werden soll.
|-
| Inventurgruppe || Um die Inventur ein wenig zu strukturieren, es ist ratsam, die Artikel in Inventurgruppenzu gliedern, um so entsprechend Inventurlisten für Artikel zu erstellen, die zusammen gezählt werden sollen.
|-
| Lag.pos.nr || Zur schnelleren Auffindung des Artikels kann eine Lager Positionsnummer zusätzlich zum Lagerort von Registerblatt 1 angegeben werden. 
|-
| Mindest-VK-Menge || Gibt die mindestens zu verkaufende Menge an. 
|-
| Provisionssatz || Gibt die Provision an, die beim Verkauf dieses Artikels erzielt werden kann. 
|-
| Poskennz. || Sie können Ihrem Artikel ein Positionskennzeichen zuordnen, das automatisch in alle Aufträge, Rechnungen, etc. übernommen wird, wenn dieser Artikel eingefügt wird. 
|-
| Mindest-VK-Menge ||
|-
| WA ||
|-
| G - Faktor || Geben Sie hier den Faktor zum Umrechnen von der Mengeneinheit auf die G-Mengeneinheit ein. 
|-
| G - Mengeneinheit || Wählen Sie hier eine Mengeneinheit wie z.B. "%", "Stück" oder "Kg" für den Artikel aus. Die G-Menge dient dem Kunden zum Vergleichen verschiedener Artikel. Sie können so z.B. bei allen Artikeln den Preis für 1 Kg angeben. 
|-
| Hersteller Name || Gibt den Namen des Herstellers an. 
|-
| Umsatzmenge || ''gewünschter Sollwert'' für den Umsatz
|-
| Rabatt || 'Möchten Sie auf diesen Artikel generell keinen Rabatt gewähren (auch wenn auf die entsprechende Warengruppe ein Rabatt gewährt wird oder ein personenbezogener Rabatt exsitiert), dann tragen Sie ein "N" ein. Ist das Preissystem auf "Rabattsystem" gestellt (Programmparameter 0305 auf JA), erscheinen folgende Zusatzfelder: [[Image:Artikel_Registerkarte_Rabattsystem_ja.PNG]] Hier können Sie bei einem Artikel zusätzliche Informationen eingestellen: '''Rabatt: '''' Ist hier ein "N" eingeragen, werden auch die Werte in den Feldern "Rabatt 1-5" ignoriert, gehen jedoch nicht verloren, um sie später gegebenenfalls wieder zu aktivieren. '''Rabatt 1,2,3,... (%): '''Sie können pro Artikel verschiedene Rabattgruppen definieren. Je nachdem, welcher Rabattkategorie ein Kunde angehört, wird ihm in der Auftragsabwicklung automatisch der entsprechende Rabatt in eine Position übernommen und kann dort individuell geändert werden. Die Grundlage zur Berechnung des Rabattes ist hierbei der '''erste VK-Netto''' Preis; die folgenden Preise werden ignoriert. Ein Rabatt, der der Warengruppe dieses Artikels zugewiesen wurde, wird durch diese Felder überschrieben. 
|-
| Lohnansatz || Hier können Lohnstunden hinterlegt werden.
|-
| Masch.-ansatz || Bei Maschinenansatz können die Maschinenstunden hinterlegt werden.
|-
| Hadelsgew. || Handelsgewicht des Artikels
|-
| Absatz - Menge || "tatsächlicher Istwert" für den Umsatz
|-
| Übernahme Bezeichnung und Langtext aus Pflege || Bei Aktivierung werden die Bezeichnungen der einzelnen Artikel aus der Artikelpflege übernommen.
|-
| Multi-Steuer || s. [[OBS/Stammdaten/Artikel/Weitere Funktionen/Multisteuer|Multisteuer]]
|-
| MwST-Schlüssel || Mehrwertsteuer-Schlüssel des Artikels
|-
| VSt-Schlüssel || Vorsteuer-Schlüssel des Artikels
|-
| TSE-Geschäftsfall
|}

=Registerkarte: 3 Langtext=

[[Image:Artikel_Registerkarte_Langtext.PNG]] 

{| class="wikitable"
|+ Felder der Artikelmaske Registerkarte: Langtext
|-
! Feld !! Beschreibung
|-
| Langtext || Langtexte dienen zur genaueren Beschreibung eines Artikels und werden automatisch bei Angeboten, Aufträgen, etc. in die Positionserfassung übernommen. Dies kann jedoch deaktiviert werden (s. ''Keine Übernahme des Langtextes in Positionen'').
|-
| Suchtexte || Sie können einem Artikel verschiedene Suchtexte hinzufügen, um Artikel über die OBS Suchfunktion leichter zu finden. 
|-
| Preislistenkalkulationsschalter 1-3 ||
|-
| Erfasst von || Hier wird der Sachbearbeiter angezeigt, der den Artikel angelegt hat.
|-
| Pos-art || Hiermit kann vorbelegt werden mit welcher Pos-Art ein Artikel in einem Vorgang angelegt wird. Dies kann z.B. hilfreich sein, wenn man einen Artikel standardmäßig auf ''ohne Berechnung'' in Aufträgen einfügen möchte.
|-
| Keine Übernahme des Langtextes in Positionen aus Artikel / Externe Texte ||
{| class="wikitable"
|-
| Artikel || Wenn aktiviert wird der Langtext nicht automatisch in die Positionen von Vorgängen (Angebote, Aufträge, etc.) übernommen.
|-
| Externe Texte ||
|}
|-
| Umrechnungsfaktor Material ||
|-
| Kostenstellenfaktor ||
|-
| Bruttogewicht ||
|-
| Volumen ||
|-
| Gefahrgutfaktor nach Beförder.-kat. ||
|-
| KanBan ||
|}

=Registerkarte: 4 Mengenberechnung=

=Registerkarte: 5 Shop=

=Tasten und Schaltflächen=

=={{F5}} EAN-Nr==
Mit dieser Funktion können Sie in der Eingabemaske zu dem jeweiligen Artikel eine EAN (European Article Number) generieren.

=={{F6}} In PL==
Mit {{F6}} können Sie sich alle personenbezogenen Preise für diesen Artikel anzeigen lassen. Es öffnet sich das folgende Fenster: 

[[Image:Personenbezogene_Preise.PNG]] 

Mit {{Einfg}} können Sie für weitere Personen Preise hinterlegen. Das sich öffnende Fenster sieht wie folgt aus: 

[[Image:Personenbezogene_Preise_Eingabe.PNG]] 

Wählen Sie hiermit der {{Raute}}-Taste im Feld "Personennummer" die gewünschte Person aus, tragen Sie den Preis ein und sichern Sie mit {{F2}} Ihre Eingabe. Wenn Sie diesen Artikel nun in einem Auftrag für eine dieser Personen einfügen, wird der hinterlegte Preis automatisch eingefügt. [[Category:html]]
=={{F7}} Kalk==

Durch Klick auf {{F7}} in der Eingabemaske öffnet sich folgendes Fenster: 

[[Image:Artikel_kalkulieren.PNG]] 

Im linken Feld wird ihnen der Einkaufspreis (EK1) angezeigt. Die drei Spalten rechts daneben Zeigen Ihnen den '''Netto-Verkaufspreis''', den '''Brutto-Verkaufspreis''', den '''Erlös in Prozent''' und den '''Soll Erlös in Prozent'''. Jede Zeile steht für einen Verkaufspreis (VK1 - VK9). Immer wenn sie in einem Feld eine Änderung vornehmen, wird für die anderen beiden Felder derselben Spalte der entsprechende Wert automatisch errechnet. 
Wenn sie den Einkaufspreis ändern, wird in jeder Zeile, bei der sie in der entsprechenden Checkbox ein Häkchen gemacht haben, der '''Verkaufspreis''' neu errechnet. In allen Zeilen bei denen kein Häkchen gesetzt wurde, wird der '''Erlös''' neu errechnet.
Die Spalte Erlös Soll in Prozent dient der Funktion [[AusArtikelPreisanpassungSollanpassung|Preisanpassung über Sollanpassung]]. Hier können Sie den Soll-Erlös in Prozent eintragen. 
Durch '''Brutto führend''' kann eingestellt werden, dass der Bruttopreis nicht vom Nettopreis aus errechnet wird. Dies ist notwendig, da es sonst durch Rundungen nicht möglich ist, bestimmte Bruttopreise einzugeben. Näheres hierzu finden Sie auch unter: [[OBS/Stammdaten/OBS/Stammdaten/Brutto und Netto|Brutto und Netto in OBS]].
Wenn Sie mit der {{F2}}-Taste Ihre Eingabe sichern, werden die kalkulierten Preise automatisch in die richtigen Felder eingetragen.[[Category:html]]

=={{F8}} EAN==
Öffnet die [[OBS/Stammdaten/Artikel/F8 EAN-Verwaltung|EAN-Verwaltung]] gefiltert mit Einträgen nur für den aktuellen Artikel.

=={{F9}} VK==
In dieser Übersicht werden die '''VK1-VK9 ''' tabellarisch dargestellt. Wenn in dieser Spalte einen Brutto-Verkaufspreis angegeben wird, so wird der Netto - Verkaufspreis automatisch, entsprechend dem Mehrwertsteuersatz, angepaßt. 
*'''VK-Netto '''
*'''VK-Brutto '''
*'''Erlös in % '''- prozentualer Roherlös
*'''Erlös in € '''- der Roherlös, der bleibt, wenn der Einkaufspreis vom Netto-Verkaufspreis abgezogen wird
*''' Bedingung ''' - dient der reinen Information für den Anwender

Diese Tabelle sieht wie folgt aus: 

[[Image:F9_VK-Preise_1-9.PNG]] 

Sichern Sie mit {{F2}} Ihre Angaben.[[Category:html]]

=={{F10}} EK==
Öffnet die Liste der [[OBS/Stammdaten/Artikel/F10 EK Lieferanten für Artikel|Lieferanten für den aktuellen Artikel]]

OBS/Widgets/Position-Infobaum

2025-11-18T10:55:14Z

Nimz: /* Der Infobaum */

{{Widgets}}
Dieses Widget zeigt die direkten Vorgangsreferenzierungen einer Position an. Per Doppelklick können Sie den jeweiligen angezeigten Vorgang aufrufen.
=Der Infobaum=
Als Wurzel sehen Sie den aktuellen Vorgang zu dem die Positionserfassung geöffnet ist. Daunter sehen Sie dann die Vorgänge, welche über die Position, auf der Sie stehen, identifiert werden können. 
'''Beispiel''': 
Sie stehen in einem Auftrag auf einer Position, welche in drei Teilmengen geliefert und anhließen komplett berechnet wurde. Im Widget sehen Sie dann die drei Lieferscheine und die Rechnung. 
[[Image:widposinfobaum_beispiel.jpg]]

=Aktivierung und Einstellungen=
Auf die Pflege Ihrer Widgets greifen Sie über die Benutzerpflege zu. Diese finden Sie unter: 
'''System'''→'''K Benutzerpflege'''→Benutzer auswählen→{{F10}}→'''C - Allgemeine Widgets'''
==Aktivieren==
In der Liste ''Widgets für Benutzer'' drücken Sie {{Key|Einfg Einf.}}. Anschließend suchen Sie das Widget 177 '''Position-Infobaum''' und markieren den Eintrag mit {{Key|F5 Mark}}. Übernehmen Sie das Widget mit {{Key|F2 Speich.}}. 
Sie gelangen in die Liste ''Widgets für Benutzer'' zurück. Standardmäßig ist die Anzeige aktiviert und Docking rechtsseitig eingestellt. Dies können Sie in den Einstellungen ({{Return}}) ändern.
==Einstellungen/Parameter==
In der Liste ''Widgets für Benutzer'' drücken Sie {{Return}} um die Einstellungen zum Widget öffnen. Folgende Parameter können Sie hier konfigurieren:
{| class="wikitable"
|-
!Pos!! Parameter!! Beschreibung
|-
| 02 || Anzeige aktiv || Anzeige aktivieren(J)/deaktivieren(N) per {{Return}}.
|-
| 03 || Docking Links=0/Rechts=1/Oben=2/Unten=3 || Einstellung für das Docking des Widgets an die Positionserfassung. Standard: 1
|}
[[Kategorie:OBS/Widgets]]