Concetti chiave

Il vocabolario di BASE9 spiegato in modo semplice. Sono i termini che ricorrono in tutto il manuale e nell'API Reference.

Ambiente (tenant)

Lo spazio dati dedicato e isolato del partner. Tutto ciò che si crea — clienti, contratti, agenti — vive dentro il proprio ambiente e non è visibile agli altri. Ogni Chiave API e ogni accesso sono legati a un ambiente.

Cliente

L'anagrafica di chi riceve la fornitura. BASE9 distingue tre tipologie:

• Azienda (persona giuridica),
• Persona fisica,
• Ditta individuale.

A seconda della tipologia cambiano i dati richiesti (es. partita IVA per le aziende, codice fiscale per le persone fisiche).

Punto di fornitura (POD / PDR)

Il luogo fisico in cui l'energia viene erogata, identificato da un codice univoco:

• POD per l'energia elettrica,
• PDR per il gas.

Un cliente può avere più punti di fornitura. Il punto è un'entità "fisica" e stabile; ciò che cambia nel tempo è chi lo intesta.

Intestazione

Il legame, valido in un certo periodo, tra un punto di fornitura e il cliente che lo intesta. Quando subentra un nuovo cliente (voltura) o cambia fornitore (switching), si apre una nuova intestazione e si chiude la precedente: la storia resta tracciata.

Contratto e offerta

• Il contratto raccoglie le condizioni sottoscritte dal cliente.
• L'offerta commerciale è l'insieme delle condizioni economiche applicate a un punto di fornitura.

BASE9 distingue i modelli di offerta riutilizzabili (cataloghi) dalle istanze effettivamente applicate a un cliente/punto.

Rete agenti

La struttura commerciale: gli agenti (con anagrafica simile ai clienti) e i loro livelli gerarchici. Un agente può avere più referenti superiori, e la struttura è storicizzata (si sa com'era in ogni momento). Sui contratti viene "congelata" la catena di agenti che ha portato la vendita, base per il calcolo delle provvigioni.

Accesso: Chiave API e Area riservata

I due canali con cui si entra in BASE9. Spiegati per intero in Accessi:

• Chiave API — per i sistemi del partner.
• Area riservata — per le persone (agenti, clienti).

Convenzioni trasversali

BASE9 applica regole uniformi a tutte le funzioni:

• Risposte in formato coerente (ogni risultato è "imbustato" allo stesso modo).
• Errori strutturati, con un codice stabile e un messaggio leggibile.
• Date in formato standard internazionale.
• Elenchi paginati: i risultati lunghi si scorrono "a pagine".

Il dettaglio tecnico di queste convenzioni è nell'API Reference. Qui basti sapere che sono le stesse per ogni funzione: imparate una volta, valgono ovunque.