Open Inventory auf eigener Infrastruktur betreiben.

Anwendung · Varianten & Fertigung

Fertigbestand je Variante führen

Jede Variante ist ein eigener Inventareintrag mit eigener Ressourcen-ID, SKU, Barcode und eigenem Bestand. Die Varianten sind mit einem Hauptartikel zu einer Produktfamilie verbunden. So bleiben etwa OpenPaper L Weiß und Schwarz auch nach der Fertigung getrennt buchbar.

1. 1. Varianten und Stücklisten vorbereiten

   Lege die Varianten am Hauptartikel an, verbinde vorhandene Einträge oder erzeuge sie aus Optionsgruppen. Varianten übernehmen die Stückliste des Hauptartikels; abweichende Komponenten legst du in der jeweiligen Variante fest, zum Beispiel einen weißen statt eines schwarzen Rahmens.

2. 2. Zielvariante bauen

   Wähle beim Bauen am Hauptartikel unter „Fertigartikel / Zielvariante“ die gewünschte Variante. Das Formular lädt deren Stückliste und Bestandsdaten. Ein Build von einem weißen Gerät verbraucht dessen Platine und weißen Rahmen und erhöht nur den Fertigbestand der weißen Variante. Komponentenverbrauch und Fertigungszugang werden gemeinsam gebucht oder vollständig zurückgerollt.

3. 3. Fertigartikel ausbuchen

   Öffne den Bestand der verkauften Variante und buche dort den Warenausgang. Nur diese Variante verliert Bestand; die Familiensumme sinkt entsprechend. Platine und Rahmen werden dabei nicht noch einmal abgebucht.

Einzelbestände, Freibestand und Gesamtsumme

Am Hauptartikel siehst du die Varianten mit ihren Einzelbeständen. Die Bestandsansicht zeigt zusätzlich den unzugeordneten Bestand des Hauptartikels und die Summe der Familie. Beispiel nach einem Build der weißen Variante:

Gesamtbestand = Summe aller Variantenbestände + unzugeordneter Bestand

GET /api/v1/resources/{primaryId}/stock liefert family.variants mit quantity je Variante und family.summary mit totalQuantity, variantQuantity und primaryQuantity. resource.quantity bleibt der eigene, unzugeordnete Bestand des Hauptartikels. Zähle ihn nicht erneut zur Familiensumme hinzu. Alle Werte dieser Antwort stammen aus demselben Datenbank-Snapshot. Zum Lesen der Familie brauchst du stock.read-Zugriff auf alle Mitglieder.

Build per API

Ersetze die Platzhalter durch deine Ressourcen-UUIDs und dein API-Token. Verwende für jeden neuen Vorgang einen eigenen Idempotency-Key; bei einer Wiederholung desselben Requests bleibt der Schlüssel gleich. Beim Build ist dieser Header erforderlich.

POST /api/v1/resources/{primaryId}/stock/builds
Authorization: Bearer <API_TOKEN>
Content-Type: application/json
Idempotency-Key: <unique-build-key>

{
  "quantity": 1,
  "outputResourceId": "<whiteVariantId>"
}

outputResourceId muss die aufgerufene Ressource oder eine ihrer direkten Varianten sein. Alternativ kannst du direkt POST /api/v1/resources/{whiteVariantId}/stock/builds mit quantity aufrufen. Für bewusst unzugeordneten Fertigbestand gibst du die ID des Hauptartikels als outputResourceId an.

Bei einem Aufruf über den Hauptartikel kannst du outputResourceId weglassen, wenn componentResourceSelections die stabile Stücklisten-Slot-ID auf die gewählte Komponenten-ID abbildet und die gesamte resultierende Stückliste genau einer Endproduktvariante entspricht. Gewählte Komponenten müssen die jeweilige Stücklistenkomponente oder eine ihrer direkten Varianten sein. Gibt es keinen oder mehrere Treffer, antwortet die API mit HTTP 422; wähle dann die Zielvariante ausdrücklich.

Warenausgang per API

POST /api/v1/resources/{whiteVariantId}/stock/movements
Authorization: Bearer <API_TOKEN>
Content-Type: application/json
Idempotency-Key: <unique-issue-key>

{
  "delta": -1,
  "type": "issue",
  "note": "Order #1234"
}

Die Varianten-ID steht im Ressourcenpfad. Der Request verwendet delta und type; ein zusätzliches variant_id-Feld oder ein separater Legacy-Varianten-Endpunkt wird nicht verwendet. Ein negativer delta-Wert reduziert den Bestand.

Negativbestand folgt der Organisationseinstellung

Ist „Negativbestand erlauben“ ausgeschaltet (allowNegativeStock = false), lehnt die API eine Ausbuchung unter null mit HTTP 409 ab. Ist die Einstellung eingeschaltet, darf Mengenbestand unter null sinken; auch die Familienübersicht zeigt diese negativen Werte. Serialisierte Einheiten benötigen weiterhin konkrete verfügbare Einheiten. Ein bereits negativer Bestand kann bei aktiviertem Schutz durch Zugänge wieder ausgeglichen werden.