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:
| Modifica | Fino a SIGN IT 2025-08-12 | Da SIGN IT 2026-02-03 in poi |
| Asset ➜ Organization | ||
| Struttura di primo livello |
Asset::TENANTrappresenta il fornitore PoS o un esercente che gestisce il proprio sistema PoS. |
Organization::ACCOUNTla struttura di primo livello in fiskaly. Rappresenta la tua azienda e contiene utenti, organizzazioni, prodotti e fatturazione. |
| Livello intermedio |
Asset::GROUPlivello intermedio opzionale, utilizzato per raggruppare più risorse Asset di tipo UNIT. |
Organization::GROUPlivello 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. |
| Esercente |
Asset::UNITrappresenta un esercente (organizzazione gestita, annidata sotto il TENANT o il GROUP, a seconda della struttura) |
Organization::UNITrappresenta un esercente / contribuente operante all'interno del GROUP (e del relativo ACCOUNT). |
| Entity ➜ Taxpayer e Location | ||
| Dati del contribuente |
Entity::COMPANY / INDIVIDUAL |
Taxpayer::COMPANY / INDIVIDUAL |
Rappresenta una particolare UNIT con i relativi dati fiscali del contribuente. | ||
| Indirizzo operativo |
Entity::LOCATION |
Location::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