Elenco pratiche <dokicasa-practices> beta
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:
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"}'{ "user_token": "dksdk.eyJpdiI6...", "expires_in": 3600, "scope": "practices" }Il token vale un'ora e solo sui tuoi domini abilitati. Apre soltanto queste operazioni:
| Metodo | Percorso | A cosa serve |
|---|---|---|
GET | /api/v3/user/me/services | Elenco delle pratiche |
GET | /api/v3/practices/{id} | Dettaglio di una pratica |
GET | /api/v3/practices/{id}/tasks | Richieste (task) della pratica |
GET | /api/v3/contract/{id}/pdf | PDF di un contratto |
POST | /api/v3/tasks/{task}/comments | Risposta 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.
$token = Http::withToken(env('DOKICASA_API_KEY'))
->acceptJson()
->post('https://app.dokicasa.it/api/v3/sdk/token', ['scope' => 'practices'])
->json('user_token');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
<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
| Attributo | Obbligatorio | Descrizione |
|---|---|---|
user-token | sì | Il token con scope: practices |
heading | no | Titolo sopra l'elenco. Predefinito: Le tue pratiche |
api-base | no | Solo 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
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))
}
})| Evento | detail | Quando |
|---|---|---|
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:
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
| Stato | Messaggio | Cosa fare |
|---|---|---|
401 | Token SDK non valido o scaduto. | Chiedi un nuovo token |
403 | Dominio non abilitato per questo token. | Chiedi a Dokicasa di abilitare il dominio |
403 | Questa operazione non e' disponibile con questo token SDK. | Stai usando il token del form: chiedi un token con scope: practices |
403 | SDK non abilitato: nessun dominio configurato per questo account. | Serve l'attivazione |