Skip to content

Elenco pratiche <dokicasa-practices> beta ​

Integra con un assistente AI
Scarica o copia il prompt di integrazione per Elenco pratiche SDK e incollalo in Claude Code, Cursor o Copilot: contiene auth, esempi end-to-end e checklist.
Apri

Con questo componente mostri nel tuo sito l'elenco delle pratiche del tuo account, come nell'area riservata Dokicasa. Il tuo cliente apre una pratica, ne vede lo stato, scarica i documenti e risponde alle richieste di Dokicasa senza lasciare il tuo sito.

Beta: attivazione su richiesta

Usa la stessa attivazione del form: se hai già i domini abilitati per il form, funziona anche l'elenco.

Cosa mostra ​

  • Elenco delle pratiche: nome, servizio, data, stato e avanzamento degli step. Ci sono tre filtri: Tutte, Richiedono un tuo intervento e In lavorazione. In più ci sono la ricerca (per nome, immobile, locatore o conduttore) e le pagine.
  • Dettaglio di una pratica: gli step con il loro stato e i documenti da scaricare, cioè i PDF dei contratti e gli allegati di chiusura.
  • Richieste da completare: i task che Dokicasa assegna al tuo account, con la risposta e gli allegati. Dopo l'invio la richiesta passa in Inviati, in verifica finché il backoffice non la chiude.

Mostra solo le pratiche dell'account a cui appartiene la API key, cioè le stesse che restituisce GET /api/v3/user/me/services. Non crea, non modifica e non cancella pratiche.

1. Il token ​

Come per il form, il tuo server chiede un token breve con la tua API key e lo passa alla pagina. Cambia solo lo scope:

bash
curl -X POST https://app.dokicasa.it/api/v3/sdk/token \
  -H 'Authorization: Bearer LA_TUA_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"scope": "practices"}'
json
{ "user_token": "dksdk.eyJpdiI6...", "expires_in": 3600, "scope": "practices" }

Il token vale un'ora e solo sui tuoi domini abilitati. Apre soltanto queste operazioni:

MetodoPercorsoA cosa serve
GET/api/v3/user/me/servicesElenco delle pratiche
GET/api/v3/practices/{id}Dettaglio di una pratica
GET/api/v3/practices/{id}/tasksRichieste (task) della pratica
GET/api/v3/contract/{id}/pdfPDF di un contratto
POST/api/v3/tasks/{task}/commentsRisposta a una richiesta

Il token del form non apre l'elenco, e il token dell'elenco non apre il form. Se nella stessa pagina ti servono tutti e due, chiedi due token.

Non chiamare questo endpoint dal browser

Altrimenti la tua API key finisce nella pagina, e con quella chiunque può operare sul tuo account.

php
$token = Http::withToken(env('DOKICASA_API_KEY'))
    ->acceptJson()
    ->post('https://app.dokicasa.it/api/v3/sdk/token', ['scope' => 'practices'])
    ->json('user_token');
js
const res = await fetch('https://app.dokicasa.it/api/v3/sdk/token', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DOKICASA_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ scope: 'practices' }),
})
const { user_token } = await res.json()

2. Il componente nella pagina ​

html
<script src="https://app.dokicasa.it/contract-form-v2-sdk/practices-v1.js"></script>

<dokicasa-practices user-token="dksdk.eyJpdiI6..."></dokicasa-practices>

Mostra l'elenco solo agli utenti che hanno fatto l'accesso al tuo sito: chi vede la pagina vede tutte le pratiche del tuo account.

Attributi ​

AttributoObbligatorioDescrizione
user-tokensìIl token con scope: practices
headingnoTitolo sopra l'elenco. Predefinito: Le tue pratiche
api-basenoSolo per lo staging: https://testing.dokicasa.it/api

Quando il token scade puoi sostituirlo senza ricaricare la pagina: aggiorna l'attributo user-token e il componente ricarica i dati.

Eventi ​

js
const el = document.querySelector('dokicasa-practices')
el.addEventListener('error', (e) => {
  if (e.detail.status === 401) {
    // token scaduto: chiedine uno nuovo al tuo server
    fetch('/mio-server/dokicasa-token').then((r) => r.json())
      .then(({ user_token }) => el.setAttribute('user-token', user_token))
  }
})
EventodetailQuando
load{ total, page }Elenco caricato
open{ practiceId, name }Apertura di una pratica
task-replied{ practiceId, taskId }Risposta a una richiesta inviata
error{ message, status }Errore di una chiamata. 401: token scaduto o non valido. 403: dominio non abilitato o operazione non consentita

Colori e font ​

Sono le stesse variabili del form:

css
dokicasa-practices {
  --primary: #7a1fa2;
  --primary-600: #5e1680;
  --primary-50: #f3e5f7;
  --secondary: #ff6f00;
  --secondary-600: #e65f00;
  font-family: 'Il tuo font', sans-serif;
}

L'elenco completo delle variabili è nella guida del form. Il componente è isolato con lo Shadow DOM: il CSS del tuo sito non lo modifica.

Errori ​

StatoMessaggioCosa fare
401Token SDK non valido o scaduto.Chiedi un nuovo token
403Dominio non abilitato per questo token.Chiedi a Dokicasa di abilitare il dominio
403Questa operazione non e' disponibile con questo token SDK.Stai usando il token del form: chiedi un token con scope: practices
403SDK non abilitato: nessun dominio configurato per questo account.Serve l'attivazione