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

# Artikelverfügbarkeit aktualisieren

> Nutzen Sie die POS-Verfügbarkeits-API, um Artikelbestände per PLU-Code zu aktualisieren und ausverkaufte Artikel in Echtzeit zu synchronisieren.

Aktualisieren Sie den Verfügbarkeitsstatus und die Bestandsmenge für Menüartikel in einem Store. Artikel werden anhand ihres PLU-Codes (Price Look-Up) abgeglichen.

## Anfrage

```bash theme={null}
curl -X POST https://api.storekit.com/pos/availability \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "storeId": "550e8400-e29b-41d4-a716-446655440000",
    "items": [
      {
        "plu": "BURGER-001",
        "isAvailable": true,
        "inventory": 50
      },
      {
        "plu": "FRIES-001",
        "isAvailable": false
      }
    ]
  }'
```

## Request-Body

**storeId** `string` *required*

Die externe Store-ID (UUID-Format). Dies ist die ID, die Sie dem Store bei der Einrichtung Ihrer Integration zugewiesen haben.

**items** `array` *required*

Ein Array von zu aktualisierenden Artikeln. Muss mindestens einen Artikel enthalten.

**Eigenschaften eines Artikels**

**plu** `string` *required*

Der PLU-Code des Menüartikels. Muss mit dem im storekit-Dashboard konfigurierten PLU übereinstimmen.

**isAvailable** `boolean` *required*

Ob der Artikel derzeit für Bestellungen verfügbar ist.

**inventory** `integer`

Der aktuelle Bestand. Muss 0 oder größer sein. Wenn der Bestand 0 erreicht, sollten Sie `isAvailable` auf `false` setzen.

## Antwort

```json Success (200) theme={null}
"ok"
```

```json Store Not Found (404) theme={null}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Not Found"
}
```

```json No Active Menu (404) theme={null}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "No active menu found for this venue"
}
```

```json Invalid Payload (400) theme={null}
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "\"storeId\" must be a valid GUID"
}
```

## Verhalten

* Artikel werden anhand des PLU im aktiven Menü des Stores abgeglichen
* Wird der PLU eines Artikels nicht gefunden, wird er stillschweigend übersprungen (kein Fehler)
* Verfügbarkeitsänderungen werden sofort wirksam
* Der Menü-Cache wird nach Aktualisierungen automatisch invalidiert

## Beispiel: Artikel als ausverkauft markieren

```bash theme={null}
curl -X POST https://api.storekit.com/pos/availability \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "storeId": "550e8400-e29b-41d4-a716-446655440000",
    "items": [
      {
        "plu": "SPECIAL-001",
        "isAvailable": false,
        "inventory": 0
      }
    ]
  }'
```

## Beispiel: Artikel wieder auffüllen

```bash theme={null}
curl -X POST https://api.storekit.com/pos/availability \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "storeId": "550e8400-e29b-41d4-a716-446655440000",
    "items": [
      {
        "plu": "SPECIAL-001",
        "isAvailable": true,
        "inventory": 25
      },
      {
        "plu": "DESSERT-001",
        "isAvailable": true,
        "inventory": 10
      }
    ]
  }'
```


## Related topics

- [Einführung für Entwickler](/docs/de/developers/introduction.md)
- [Stream Bestand & Verfügbarkeit](/docs/de/guides/integrations/pos/stream/stock-and-availability.md)
- [Deliverect Bestand & Verfügbarkeit](/docs/de/guides/integrations/pos/deliverect/stock-and-availability.md)
- [Zonal (Aztec)](/docs/de/guides/integrations/pos/zonal.md)
- [Store-Adresse](/docs/de/guides/store-settings/store-address.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.