> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Native Warenwirtschaft

> Verwalten Sie Apothekenprodukte, Lagerorte, Chargen und Wareneingänge in RxScale.

# Native Warenwirtschaft

Die native Warenwirtschaft in RxScale trennt Produktidentität, physischen Bestand und
Verfügbarkeit für Verkaufskanäle. Produkte werden innerhalb einer Apothekengruppe geteilt,
während Bestand immer zu einem Lagerort einer konkreten Apotheke gehört.

<Note>
  Die native Warenwirtschaft ist Teil des Pharmacy-Suite-Abonnements. Sie ist optional und ändert
  weder Ihre Shop-Verfügbarkeit noch Ihre Auftragsabwicklung, solange Sie sie nicht aktivieren.
</Note>

## Produkte

Ein Produkt der Apothekengruppe beschreibt den Artikel, den die Apotheke abgibt. Es kann
Kennungen wie PZN, Produktname, Darreichungsform und Einheit sowie Markierungen für
verschreibungspflichtige Produkte, Cannabis, Kühlkette, Chargenpflicht und BtM enthalten.

## Lagerorte

Jede Apotheke hat mindestens einen Lagerort, in der Regel die Offizin. Weitere Lagerorte für
Back-Stock oder Kühlkette können bei Bedarf ergänzt werden. Physischer Bestand gehört immer zu
einem Lagerort; der Bestand einer Apotheke ist die Summe ihrer Lagerorte.

## Wareneingang

Der Wareneingang bringt Bestand in einen Lagerort. RxScale speichert Lagerort, Produkt,
Chargennummer, Verfalldatum, Menge, eine optionale Lieferantenreferenz, einen optionalen
Einkaufspreis und die verantwortliche Person.

<Note>
  Produkte mit Chargenpflicht müssen mit Chargennummer und Verfalldatum eingebucht werden. Ist auf
  der Packung nur Monat und Jahr aufgedruckt, speichert RxScale das Verfalldatum als den letzten Tag
  dieses Monats, damit dieselbe Charge stets einer einzigen Charge zugeordnet wird.
</Note>

## Bestandsverlauf

Jeder Wareneingang erzeugt eine Bestandsbewegung. Bewegungen sind unveränderlich, damit
Bestandsänderungen später nachvollziehbar bleiben und nie unbemerkt überschrieben werden.

## Verfügbarkeitspuffer

Physischer Bestand ist nicht immer identisch mit der Online-Verfügbarkeit. Für jedes Produkt kann
eine Apotheke eine Verfügbarkeitsrichtlinie hinterlegen, die einen Sicherheitspuffer zurückhält,
sodass der Shop nur Bestand oberhalb dieses Puffers anzeigt. Die online verkäufliche Menge ergibt
sich aus dem Lagerbestand, abzüglich bereits durch offene Aufträge reservierter Mengen, abzüglich
des Sicherheitspuffers, und wird nie negativ.

Wenn eine Apotheke zum Beispiel 20 Packungen auf Lager hat und einen Sicherheitspuffer von 5 setzt,
gibt RxScale höchstens 15 Packungen frei. Optional lässt sich zusätzlich eine maximale
Verkaufsmenge festlegen, um die Freigabe weiter zu begrenzen, oder ein Produkt als nicht verfügbar
markieren, um es vollständig zurückzuhalten.

<Note>
  Sicherheitspuffer sind produktspezifisch. Eine Apotheke kann für knapp verfügbare Produkte einen
  höheren Puffer verwenden und für normale Ware keinen Puffer setzen. Puffer können außerdem für einen
  bestimmten Verkaufskanal (Organisation oder Shop) überschrieben werden, wenn ein Kanal andere
  Grenzen als die Standardvorgabe benötigt.
</Note>

## Reservierungen

Wenn eine Bestellposition eine bestätigte Produktzuordnung hat, kann RxScale geeignete Chargen vor
der Abgabe reservieren. Eine Reservierung hält Bestand für diese Bestellung zurück, reduziert den
physischen Bestand aber noch nicht — die tatsächliche Ausbuchung erfolgt erst bei der Kommissionier-
oder Versandbestätigung.

Reservierungen folgen dem First-Expiry-First-Out-Prinzip (FEFO): RxScale wählt zuerst die Chargen mit
dem nächstgelegenen Verfallsdatum und überspringt abgelaufene, gesperrte oder zurückgerufene Chargen.
Kühlkettenprodukte werden ausschließlich aus Kühlkettenlagern reserviert. Reicht eine Charge nicht
für die volle Menge, wird die Reservierung automatisch auf mehrere Chargen aufgeteilt.

Die reservierte Menge wird aus der Bestellposition abgeleitet — die bestellte Menge multipliziert mit
der Menge pro Einheit der Zuordnung — und entspricht damit immer der tatsächlich bestellten Menge.
Kann eine Position nicht vollständig reserviert werden, wird sie gekennzeichnet: `out_of_stock`, wenn
nicht genügend verkaufsfähiger Bestand vorhanden ist, oder `batch_blocked_or_expired`, wenn Bestand
nur in abgelaufenen, gesperrten oder zurückgerufenen Chargen vorhanden ist.

Wird eine reservierte Bestellung storniert, wird ihre Reservierung freigegeben und der
zurückgehaltene Bestand automatisch zurückgebucht — eine Stornierung lässt niemals Bestand
verwaisen. Wird eine Reservierung für dieselbe Position erneut ausgeführt, wird zuerst die vorherige
Reservierung freigegeben, sodass eine Position nie doppelt reserviert wird.

## Abgabe

Die Abgabe wandelt eine gehaltene Reservierung bei der Kommissionier- oder Versandbestätigung in eine
tatsächliche Bestandsausbuchung um. RxScale reduziert sowohl den physischen als auch den reservierten
Bestand der betroffenen Chargen, schreibt eine unveränderliche Ausbuchungsbewegung und erstellt einen
zuordenbaren Abgabenachweis. Der Nachweis speichert die für die Aushändigung verantwortliche Apotheke,
die Person, die die Abgabe bestätigt hat, den Zeitstempel, die ausgebuchte Charge und Menge sowie die
verwendete Signaturmethode (`paper`, `aes` oder `qes`). Bei einer qualifizierten elektronischen
Signatur verweist der Nachweis zusätzlich auf die zugrunde liegende Signaturanfrage.

Die abgegebene Menge wird aus der Reservierung der Position selbst übernommen, niemals aus der Anfrage
— RxScale bucht genau das aus, was die Position noch hält. Vor der Ausbuchung prüft RxScale jede
betroffene Charge erneut: Ist eine Charge zwischen Reservierung und Abgabe gesperrt, zurückgerufen oder
abgelaufen, wird die Abgabe verweigert und der Bestand bleibt reserviert. So wird verhindert, dass
kompromittierter Bestand oder Bestand mit Kühlkettenunterbrechung jemals ausgehändigt wird.

Die Abgabe kann auf mehrere Sendungen aufgeteilt werden. Jede Sendung erstellt ihren eigenen
Abgabenachweis und bucht nur die von ihr versendeten Chargen aus; die Bestellposition wird erst dann
als abgegeben markiert, wenn ihre vollständige Menge ausgehändigt wurde. Abgabenachweise sind wie alle
Bestandsbewegungen unveränderlich: Eine Korrektur wird als neuer Ausgleichseintrag erfasst, niemals als
direkte Änderung.
