Unknown top-level item key: total
Codul returnează un item cu un câmp pus lângă json, nu înăuntrul lui, de exemplu { json: {...}, total: 5 }. La nivelul de sus, un item poate avea doar json, binary, pairedItem și câteva chei speciale. Mută câmpul în json: { json: { ...date, total: 5 } }.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul complet: Unknown top-level item key: total [item 0], cu sugestia „Access the properties of an item under .json, e.g. item.json”.
Un item n8n are câteva chei rezervate la nivelul de sus: json (datele), binary (fișierele), pairedItem (legătura cu item-ul de intrare) și error. Orice altă cheie pusă acolo e o greșeală: n8n nu știe ce să facă cu ea și oprește nodul (sau, în versiuni mai vechi și în simulator, o ignoră tăcut, iar câmpul dispare din Output).
Greșeala apare când adaugi un câmp la item în loc de item.json, de exemplu i.total = ... în loc de i.json.total = ..., sau când construiești obiectul și uiți acoladele lui json. Numele din mesaj e exact câmpul pus greșit.
De ce apare: cauzele frecvente
1Câmp adăugat lângă json
return $input.all().map(i => ({ json: i.json, total_tva: i.json.total * 1.19 }));return $input.all().map(i => ({ json: { ...i.json, total_tva: i.json.total * 1.19 } }));...i.json copiază câmpurile existente, iar total_tva intră în același obiect json.
2Câmp setat pe item, nu pe item.json
for (const i of $input.all()) { i.status = 'nou'; }
return $input.all();for (const i of $input.all()) { i.json.status = 'nou'; }
return $input.all();Datele unui item sunt în i.json. i.status adaugă o cheie necunoscută la nivelul de sus.
3Obiect fără json
return [{ nume: 'Ana', json: { email: 'ana@x.ro' } }];return [{ json: { nume: 'Ana', email: 'ana@x.ro' } }];Ori pui totul în json, ori returnezi obiecte simple fără json. Amestecul dă eroarea.
Repară eroarea, direct în pagină
Nodul Total cu TVA (Code) pune total_tva lângă json, așa că n8n dă „Unknown top-level item key: total_tva” (simulatorul îl ignoră și câmpul lipsește din Output). Mută câmpul în json, păstrând și câmpurile existente, și rulează.
Indiciu
Folosește ...i.json ca să copiezi câmpurile existente în obiectul nou.
Reparația
În Total cu TVA:
return $input.all().map(i => ({
json: { ...i.json, total_tva: Math.round(i.json.total * 1.19) }
}));Rezultat: { id: 5002, total: 3499, total_tva: 4164 } și { id: 5003, total: 2597, total_tva: 3090 }.
De ce merge
Cheia total_tva era pusă la nivelul de sus al item-ului, unde n8n acceptă doar chei rezervate (json, binary, pairedItem). Mutată în json împreună cu ...i.json, devine un câmp normal al item-ului, lângă id și total, vizibil în Output și citibil cu $json.total_tva.
Alte forme ale mesajului
Unknown top-level item key: total [item 0]Access the properties of an item under `.json`, e.g. `item.json`
Cum o eviți pe viitor
- În Code, toate câmpurile noi merg în
json:{ json: { ...i.json, nou: x } }. - Când modifici item-urile pe loc, scrie
i.json.camp = .... - Verifică Output-ul: dacă un câmp calculat lipsește, probabil a ajuns lângă
json. - Pentru câmpuri noi simple, nodul Edit Fields cu Include Other Input Fields e mai sigur decât Code.
Întrebări frecvente
De ce simulatorul nu dă eroare, dar câmpul lipsește?
Unele versiuni ignoră cheile necunoscute în loc să oprească nodul. Rezultatul e la fel de greșit: câmpul calculat nu ajunge în date. n8n 1.x oprește nodul ca să observi problema.
Ce chei sunt permise la nivelul de sus?
json, binary, pairedItem, error și câteva chei interne. Pentru datele tale folosește doar json.
Erori înrudite
A 'json' property isn't an object Codul returnează item-uri în care câmpul json nu e un obiect, de exemplu { json: 'Ana' } sau { json: [1, 2] }. În n8n, json trebuie să fie mereu un obiect cu câmpuri: { json: { nume: 'Ana' } }. Pune valoarea într-un câmp cu nume. Code doesn't return items properly Nodul Code (modul Run Once for All Items) trebuie să returneze o listă de obiecte, câte unul pe item, de forma [{ json: {...} }]. Returnezi altceva: un text, un număr, o listă de texte sau nimic. Împachetează fiecare valoare într-un obiect: return lista.map(x => ({ json: { nume: x } })). Paired item data for item from node 'Code' is unavailable Un nod (de obicei Code) a creat item-uri noi fără să spună din ce item provin, iar o expresie de după el folosește $('Nod').item spre un nod de dinainte. Adaugă pairedItem la item-urile returnate de Code sau citește datele direct din item-ul curent. Învață n8n de la zero, cu exerciții la fiecare lecție
Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
