...
Eroare n8n · Items, nodul Code și transformări

Unknown top-level item key: total

Pe scurt

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

Greșit
JSON
return $input.all().map(i => ({ json: i.json, total_tva: i.json.total * 1.19 }));
Corect
JSON
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

Greșit
JSON
for (const i of $input.all()) { i.status = 'nou'; }
return $input.all();
Corect
JSON
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

Greșit
JSON
return [{ nume: 'Ana', json: { email: 'ana@x.ro' } }];
Corect
JSON
return [{ json: { nume: 'Ana', email: 'ana@x.ro' } }];

Ori pui totul în json, ori returnezi obiecte simple fără json. Amestecul dă eroarea.

Repară tu

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.

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

← Toate erorile n8n

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ță 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.