Salta ai contenuti

Nuova terminologia delle risorse

Questo articolo illustra la struttura organizzativa e la terminologia delle risorse introdotta con SIGN IT 2026-02-03 e mantenuta in tutte le versioni successive, e come si confronta con le versioni precedenti.

Struttura organizzativa:

Cosa è cambiato in sintesi:

A partire da SIGN IT 2026-02-03, ogni riferimento nei percorsi API, negli schemi, nei parametri e nelle risposte riflette due rinominazioni principali:

ModificaFino a SIGN IT 2025-08-12Da SIGN IT 2026-02-03 in poi
Asset ➜ Organization
Struttura di primo livelloAsset::TENANT rappresenta il fornitore PoS o un esercente che gestisce il proprio sistema PoS.Organization::ACCOUNT la struttura di primo livello in fiskaly. Rappresenta la tua azienda e contiene utenti, organizzazioni, prodotti e fatturazione.
Livello intermedioAsset::GROUP livello intermedio opzionale, utilizzato per raggruppare più risorse Asset di tipo UNIT.Organization::GROUP livello intermedio obbligatorio all’interno di un ACCOUNT, utilizzato per organizzare più UNIT in cluster logici (ad es. un GROUP per paese). Un singolo GROUP per ACCOUNT è sufficiente se non è necessaria un’ulteriore strutturazione.
EsercenteAsset::UNIT rappresenta un esercente (organizzazione gestita, annidata sotto il TENANT o il GROUP, a seconda della struttura)Organization::UNIT rappresenta un esercente / contribuente operante all’interno del GROUP (e del relativo ACCOUNT).
Entity ➜ Taxpayer e Location
Dati del contribuenteEntity::COMPANY / INDIVIDUALTaxpayer::COMPANY / INDIVIDUAL
Rappresenta una particolare UNIT con i relativi dati fiscali del contribuente.
Indirizzo operativoEntity::LOCATIONLocation::BRANCH
Rappresenta l’indirizzo operativo di un locale commerciale o di un esercizio di un soggetto giuridico.

Nota: Quando viene creato un Taxpayer, viene generata automaticamente una Location::HEAD_OFFICE con lo stesso ID. Se l’attività ha un solo indirizzo operativo e questo coincide con la sede legale del contribuente, è possibile collegare il System direttamente all’ID del Taxpayer/HEAD_OFFICE senza creare un BRANCH separato con dati identici. Per maggiori informazioni sulle altre modifiche introdotte con SIGN IT 2026-02-03 consultare: Principali cambiamenti in SIGN IT 2026-02-03

Was this page helpful?