> ## 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.

# Beschikbaarheid van items bijwerken

> Gebruik de POS availability API om voorraadniveaus van menu-items op PLU-code bij te werken en items als uitverkocht te markeren, realtime tussen systemen.

Werk de beschikbaarheid en voorraad van menu-items in een store bij. Items worden gematcht op basis van hun PLU (Price Look-Up) code.

## Verzoek

```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*

De externe store-ID (UUID-formaat). Dit is de ID die je aan de store hebt toegewezen bij het opzetten van je integratie.

**items** `array` *required*

Een array met items om bij te werken. Moet minstens één item bevatten.

**Item-eigenschappen**

**plu** `string` *required*

De PLU-code van het menu-item. Moet overeenkomen met de PLU die is geconfigureerd in het storekit-dashboard.

**isAvailable** `boolean` *required*

Of het item momenteel beschikbaar is om te bestellen.

**inventory** `integer`

De huidige voorraadstand. Moet 0 of hoger zijn. Als de voorraad op 0 komt, overweeg dan `isAvailable` op `false` te zetten.

## Response

```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"
}
```

## Gedrag

* Items worden op PLU gematcht binnen het actieve menu van de store
* Als de PLU van een item niet gevonden wordt, wordt het stilzwijgend overgeslagen (er wordt geen fout teruggegeven)
* Wijzigingen in beschikbaarheid zijn direct van kracht
* De menu-cache wordt na updates automatisch ongeldig gemaakt

## Voorbeeld: items als uitverkocht markeren

```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
      }
    ]
  }'
```

## Voorbeeld: items terug op voorraad zetten

```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

- [Introductie voor ontwikkelaars](/docs/nl/developers/introduction.md)
- [Beschikbaarheid en snoozing](/docs/nl/guides/menu/availability-snoozing.md)
- [Lightspeed voorraad & beschikbaarheid](/docs/nl/guides/integrations/pos/lightspeed/stock-and-availability.md)
- [Beschikbaarheid van kortingen beperken](/docs/nl/guides/discounts/limiting-availability.md)
- [Stream voorraad en beschikbaarheid](/docs/nl/guides/integrations/pos/stream/stock-and-availability.md)


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