PSH — PROMIUM Software Help

<script>
  window.PSH_CONFIG = {
    projectId: 'TUO_PSH_PROJECT_ID',
    lang: 'it',
    theme: 'light',          // 'light' | 'dark' | 'auto'
    position: 'right',       // posizione pannello help
    triggerIcon: 'circle',   // icona trigger help
    aiEnabled: true          // abilita chatbot AI nel pannello
  };
</script>
<script src="https://cdn.promiumai.com/psh/v1/sdk.js" async></script>

// PSH si inizializza automaticamente se PSH_CONFIG è definito.
// Per inizializzazione programmatica:
window.PSH.init({
  projectId: 'TUO_PSH_PROJECT_ID',
  lang: 'it',
  theme: 'auto',
  onReady: () => console.log('PSH pronto'),
  onHelpOpen: (screen, field) => {
    console.log(`Help aperto: schermata=${screen}, campo=${field}`);
  }
});

<!-- Tooltip su un label di form -->
<label for="codice-fiscale"
       data-psh-field="anagrafica.codice_fiscale">
  Codice Fiscale
</label>
<input id="codice-fiscale" type="text" />

<!-- Tooltip su una sezione dell'interfaccia -->
<section data-psh-screen="ordini.nuovo_ordine">
  <h2>Nuovo Ordine</h2>
  <!-- ... -->
</section>

<!-- Tooltip su un campo tabella -->
<th data-psh-field="report.margine_lordo">
  Margine Lordo
</th>

// Apri il pannello sulla schermata corrente
PSH.openPanel();

// Apri il pannello su una schermata specifica
PSH.openPanel({ screen: 'ordini.nuovo_ordine' });

// Apri il pannello con ricerca pre-compilata
PSH.openPanel({ query: 'come inserire un ordine ricorrente' });

// Chiudi il pannello
PSH.closePanel();

// Setta la schermata corrente (navigazione SPA)
PSH.setScreen('clienti.dettaglio_cliente');

// Invia evento custom all'AI (contestualizza le risposte)
PSH.setContext({
  userId: '12345',
  userRole: 'admin',
  currentRecord: 'ordine-#00123'
});

{
  "id": "anagrafica.codice_fiscale",
  "title": "Codice Fiscale",
  "tooltip": "Il codice fiscale del cliente. Per persone fisiche: 16 caratteri alfanumerici.",
  "description": "Il codice fiscale identifica univocamente ogni persona fisica o giuridica in Italia...",
  "example": "RSSMRA80A01H501W",
  "related": [
    "anagrafica.partita_iva",
    "anagrafica.tipo_soggetto"
  ],
  "video_url": null,
  "tags": ["anagrafica", "fiscale", "obbligatorio"],
  "updated_at": "2026-06-01T10:00:00Z"
}

screens:
  anagrafica:
    title: "Gestione Anagrafica"
    description: "Sezione per la gestione dei dati anagrafici di clienti e fornitori."
    fields:
      codice_fiscale:
        tooltip: "Codice fiscale del soggetto. 16 caratteri per persone fisiche."
        description: "Obbligatorio per soggetti italiani. Usato per la fatturazione elettronica."
        example: "RSSMRA80A01H501W"
      partita_iva:
        tooltip: "Partita IVA aziendale. 11 cifre numeriche."
        description: "Obbligatoria per persone giuridiche. Formato: IT + 11 cifre."
        example: "IT12345678901"

  ordini:
    title: "Gestione Ordini"
    fields:
      data_consegna:
        tooltip: "Data di consegna prevista. Non può essere precedente alla data odierna."
      tipo_spedizione:
        tooltip: "Modalità di spedizione: Standard (3-5gg), Express (24h), Ritiro in sede."

// Recupera il contenuto di help per un campo specifico
const res = await fetch(
  'https://api.promiumai.com/api/v1/psh/TUO_PSH_PROJECT_ID/content/anagrafica.codice_fiscale',
  { headers: { 'Authorization': 'Bearer TUO_API_KEY' } }
);
const content = await res.json();
console.log(content.tooltip);
console.log(content.description);