...
Eroare ASP.NET Core · Controllere, validare și ProblemDetails

The JSON value could not be converted to System.Decimal. Path: $.pret | LineNumber: 0 | BytePositionInLine: 15.

Pe scurt

System.Text.Json nu poate pune valoarea din JSON în tipul proprietății: de exemplu prețul vine ca "99,50" (cu virgulă) într-un decimal, sau un enum vine ca nume fără JsonStringEnumConverter. Path arată exact câmpul. Trimite formatul corect sau configurează serializatorul să-l accepte.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul vine din System.Text.Json, la deserializarea corpului. Se citește pe bucăți: could not be converted to System.Decimal este tipul destinație; Path: $.pret e calea în JSON ($ = rădăcina, deci proprietatea pret de pe primul nivel); LineNumber și BytePositionInLine dau poziția exactă în corp.

Într-un controller cu [ApiController], eroarea apare în errors sub cheia $.pret, de obicei însoțită de "date": ["The date field is required."] (parametrul a rămas null pentru că deserializarea a eșuat).

Cazuri tipice: număr cu virgulă zecimală ("99,50"), bool scris "da", enum trimis ca nume fără JsonStringEnumConverter, dată într-un format necunoscut, obiect unde se aștepta listă sau invers. ASP.NET Core folosește setările „web” ale serializatorului, care acceptă numere scrise între ghilimele ("99.50"), dar nu și virgula sau textul.

De ce apare: cauzele frecvente

1Număr cu virgulă zecimală

Greșit
C#
// POST {"nume": "Mouse", "pret": "99,50"}
public class ProdusNou { public decimal Pret { get; set; } }
Corect
C#
// POST {"nume": "Mouse", "pret": 99.50}

JSON folosește punctul pentru zecimale. Setările web acceptă și "99.50", dar nu "99,50".

2Enum trimis ca nume

Greșit
C#
// POST {"stare": "Livrata"}
public enum StareComanda { Noua, Livrata }
Corect
C#
builder.Services.AddControllers().AddJsonOptions(o =>
    o.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter()));

Implicit enum-urile sunt numere în JSON. Convertorul acceptă (și scrie) numele valorilor.

3Text în loc de listă

Greșit
C#
// POST {"etichete": "promo"}
public List<string> Etichete { get; set; } = [];
Corect
C#
// POST {"etichete": ["promo"]}

O listă se trimite ca tablou JSON, chiar dacă are un singur element.

Repară tu

Repară eroarea, direct în pagină

Aplicația de curierat trimite starea comenzii ca text ("stare": "Livrata"), iar POST /api/comenzi/5/stare răspunde 400 cu The JSON value could not be converted to StareComanda. Configurează serializatorul controllerelor să accepte enum-urile ca text, ca ambele cereri (text și număr) să primească 200.

Codul care dă eroarea
C#
using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers(); // TODO: enum-uri ca text în JSON
var app = builder.Build();
app.MapControllers();
app.Run();

public enum StareComanda { Noua, Livrata, Anulata }

public class SchimbareStare
{
    public StareComanda Stare { get; set; }
}

[ApiController]
[Route("api/comenzi")]
public class ComenziController : ControllerBase
{
    [HttpPost("{id:int}/stare")]
    public IActionResult SchimbaStarea(int id, SchimbareStare date) => Ok($"Comanda {id}: {date.Stare}");
}
După reparație, programul afișează
POST /api/comenzi/5/stare → 200 OK
Comanda 5: Livrata
POST /api/comenzi/6/stare → 200 OK
Comanda 6: Anulata
Indiciu

AddJsonOptions(o => o.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter())); convertorul e în System.Text.Json.Serialization.

Alte forme ale mesajului

  • The JSON value could not be converted to StareComanda. Path: $.stare | LineNumber: 0 | BytePositionInLine: 30.
  • The JSON value could not be converted to System.Collections.Generic.List`1[System.String]. Path: $.etichete | LineNumber: 0 | BytePositionInLine: 22.
  • The JSON value could not be converted to System.DateTime. Path: $.data | LineNumber: 0 | BytePositionInLine: 20.

Cum o eviți pe viitor

  • Publică un contract clar (OpenAPI) cu tipurile fiecărui câmp.
  • Configurează o singură dată opțiunile JSON (AddJsonOptions), de exemplu enum-urile ca text cu JsonStringEnumConverter.
  • Folosește data în format ISO 8601 (2026-11-04 sau 2026-11-04T10:30:00Z) și punctul pentru zecimale.
  • Testează cu corpuri invalide și verifică 400.

Întrebări frecvente

De ce mai apare și „The date field is required.”?

Deserializarea a eșuat, deci parametrul acțiunii a rămas null. Validarea raportează și asta. Repară prima eroare (cea cu $.), iar a doua dispare.

De ce merge în Minimal APIs, dar nu în controllere (sau invers)?

Cele două au opțiuni JSON separate: ConfigureHttpJsonOptions pentru Minimal APIs și AddJsonOptions pentru controllere. Configurează-le pe cele pe care le folosești.

Erori înrudite

← Toate erorile ASP.NET Core

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață ASP.NET Core de la zero, cu exerciții la fiecare lecție

Curs ASP.NET Core: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.