Validazione dei campi nelle API di creazione e modifica: documentazione non allineata al comportamento reale

[mariapaolasmnt]

Buongiorno.

Stavo facendo qualche test sulle API di creazione prodotto tramite le API References e ho notato alcune differenze tra quello che è indicato nello schema e quello che succede realmente chiamando l’endpoint.

In particolare, nello Schema della Request Body i campi name e default_vat.value risultano obbligatori (con *), ma facendo alcune prove sembra che non lo siano davvero.

Test 1

Body senza name e senza default_vat.value → 200 OK, prodotto creato correttamente:

{
  "data": {
    "code": "TAVOLO003",
    "net_price": 240,
    "net_cost": 0,
    "measure": "",
    "description": "Tavolo in marmo pregiato",
    "category": "arredamento",
    "in_stock": true,
    "default_vat": {
      "id": 3,
      "description": "Non imponibile art. 123",
      "notes": "IVA non imponibile ai sensi dell'articolo 123, comma 2",
      "is_disabled": false
    }
  }
}

---

Test 2

Body con name e default_vat.value come da schema, ma senza code → 500 Internal Server Error:

{
  "data": {
    "name": "Tavolo di marmo",
    "net_price": 240,
    "net_cost": 0,
    "measure": "",
    "description": "Tavolo in marmo pregiato",
    "category": "arredamento",
    "in_stock": true,
    "default_vat": {
      "id": 3,
      "value": 22,
      "description": "Non imponibile art. 123",
      "notes": "IVA non imponibile ai sensi dell'articolo 123, comma 2",
      "is_disabled": false
    }
  }
}

Da questo secondo test, oltre al tema dei campi obbligatori, mi ha un po’ sorpresa il fatto di ricevere un 500 invece di un 422 con un messaggio di validazione più chiaro. In questo modo è difficile capire subito cosa manca o cosa non va nella request.

Da quello che ho potuto verificare, sembra che il campo realmente necessario per la creazione sia code, mentre name e default_vat.value non risultano effettivamente obbligatori, nonostante quanto indicato nello schema.

---

Avrei quindi due domande:

1. Quali sono i campi effettivamente obbligatori per la creazione (e modifica) delle varie entità?
2. È possibile aggiornare gli schema e gli esempi nelle API References per riflettere il comportamento reale?

Grazie mille

[barcigabri]

Buongiorno @mariapaolasmnt,
Ho verificato nel codice e abbiamo un problema interno. Il campo code è giusto che sia opzionale, va in conflitto con il campo in_stock, se è valorizzato a true deve esserci un codice valido, stiamo procedendo per fare un fix.
Grazie per la segnalazione, rimango a disposizione per altre informazioni e chiarimenti