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

# Aggiornare la disponibilità degli articoli

> Usa l'API di disponibilità POS per aggiornare le giacenze degli articoli via codice PLU, contrassegnare esauriti e sincronizzare l'inventario in tempo reale.

Aggiorna lo stato di disponibilità e la quantità di inventario degli articoli del menu in un negozio. Gli articoli vengono identificati tramite il loro codice PLU (Price Look-Up).

## Richiesta

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

## Corpo della richiesta

**storeId** `string` *required*

L'ID esterno del negozio (formato UUID). È l'ID che hai assegnato al negozio quando hai configurato la tua integrazione.

**items** `array` *required*

Un array di articoli da aggiornare. Deve contenere almeno un articolo.

**Proprietà dell'articolo**

**plu** `string` *required*

Il codice PLU dell'articolo del menu. Deve corrispondere al PLU configurato nella dashboard storekit.

**isAvailable** `boolean` *required*

Indica se l'articolo è attualmente disponibile per l'ordinazione.

**inventory** `integer`

La quantità di inventario attuale. Deve essere 0 o superiore. Quando l'inventario raggiunge 0, considera di impostare `isAvailable` su `false`.

## Risposta

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

## Comportamento

* Gli articoli vengono abbinati tramite PLU all'interno del menu attivo del negozio
* Se il PLU di un articolo non viene trovato, viene ignorato in modo silenzioso (nessun errore restituito)
* Le modifiche di disponibilità hanno effetto immediato
* La cache del menu viene invalidata automaticamente dopo gli aggiornamenti

## Esempio: contrassegnare articoli come esauriti

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

## Esempio: rifornire articoli

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

- [Introduzione per sviluppatori](/docs/it/developers/introduction.md)
- [Scorte e disponibilità Stream](/docs/it/guides/integrations/pos/stream/stock-and-availability.md)
- [Limitare la disponibilità degli sconti](/docs/it/guides/discounts/limiting-availability.md)
- [Stock e disponibilità Deliverect](/docs/it/guides/integrations/pos/deliverect/stock-and-availability.md)
- [Disponibilità e sospensione](/docs/it/guides/menu/availability-snoozing.md)


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