> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/it/developpeur/tutoriel-dacces-au-catalogue/verification-de-la-disponibilite-via-lapi-yoplanning.md).

# Verifica della disponibilità tramite l'API di Yoplanning

**Endpoint: /api/v3.1/teams/\[teamId]/convalida dell'ordine**

Questo metodo API consente di verificare se il contenuto del carrello è ancora disponibile prima di finalizzare l'ordine. È particolarmente utile per evitare situazioni di overbooking nei casi in cui più clienti effettuano prenotazioni contemporaneamente.

***

**Esempio di utilizzo con CURL**

**Punto finale:**

```
/api/v3.1/teams/[teamId]/order-validation
```

**Descrizione:**

Devi inviare lo stesso JSON utilizzato per effettuare un ordine, l'unica differenza è l'URL.

**Esempio :**

```bash
curl -H "Content-Type: application/json" -X POST -d '{
    "external_reference" : "956",
    "items" : [{
        "session_group" : "53071a97-0c2d-4973-89f5-cafd10665b3b",
        "price" : {"amount" : 51.25},
        "client" : {
            "id" : "71ea849f-226c-4302-a433-528179634aa7",
            "first_name" : "John",
            "last_name" : "Doe",
            "email" : "john.doe@gmail.com"
        }
    }],
    "payments" : [{
        "amount" : 51.25,
        "client" : {
            "first_name" : "Framold",
            "last_name" : "Doe",
            "email" : "john.doe@gmail.com"
        }
    }]
}' https://yoplanning.pro/api/v3.1/teams/5a90332e-568f-4980-9859-88a984844a4d/order-validation -H 'Authorization: Token 4504c2cb0d87a93106d4de029f407c86149f2ada'
```

**Risposta in caso di disponibilità:**

```json
{
    "success": true
}
```

**Risposta in caso di indisponibilità:**

```json
{
    "success": false, 
    "unavailable_items": {
        "group_ids": ["2265cac0-cba5-46eb-8095-b89f93e7473f"], 
        "dry_resource_ids": [], 
        "voucher_ids": [], 
        "resources": []
    }
}
```

***

**Suggerimenti per l'uso e best practice**

1. **Controlla prima di finalizzare ogni ordine:** utilizza questo metodo prima di finalizzare un ordine per assicurarti che tutte le risorse necessarie siano ancora disponibili.
2. **Gestione degli errori:** In caso di indisponibilità, fornire un'adeguata gestione degli errori per informare il cliente e offrire alternative.
3. **Automazione:** integra questa verifica in un processo automatizzato per transazioni in tempo reale, soprattutto durante i periodi di elevata attività.

***

**Errori comuni e soluzioni**

1. **Errore 404 non trovato):**
   * **Causa:** Endpoint non valido o ID team errato.
   * **Soluzione:** controlla l'URL e il teamId utilizzato.
2. **Errore 401 (non autorizzato):**
   * **Causa:** Problema di autenticazione.
   * **Soluzione:** controlla il token di autenticazione e assicurati che sia valido e attivo.
3. **Errore 400 (richiesta errata):**
   * **Causa:** Formato JSON non corretto o dati mancanti.
   * **Soluzione:** verifica che il JSON inviato sia formattato correttamente e che siano incluse tutte le informazioni necessarie.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.yoplanning.support/it/developpeur/tutoriel-dacces-au-catalogue/verification-de-la-disponibilite-via-lapi-yoplanning.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.