Per i collaboratori di Mister Benna

Prenotazioni dal tuo sito

Due modi: il link con il tuo codice (nessun programmatore) oppure l'API (il tuo sito manda la richiesta da solo). In tutti e due i casi la richiesta resta collegata a te per la commissione concordata.

1. Link o pulsante con il tuo codice

Metti nel tuo sito il link https://misterbenna.com/prenota?ref=IL_TUO_CODICE (o il pulsante pronto che ti abbiamo mandato). Il cliente vede il prezzo e prenota su Mister Benna: per 30 giorni la sua prenotazione resta collegata a te.

2. API

Chiave: in ogni chiamata l'intestazione Authorization: Bearer mb_live_…. La chiave è segreta: usala solo dal tuo server, mai nel codice JavaScript della pagina. Se pensi che qualcuno l'abbia vista, chiedici una chiave nuova (la vecchia smette subito di funzionare).

Limiti: 10 richieste nuove al minuto (300 al giorno); 60 letture al minuto. Oltre, risposta 429: riprova poco dopo.

GET /api/v1/cassoni

Misure dei cassoni, altri servizi, materiali e regole (un solo materiale per cassone, ritiro in giornata, strada).

GET /api/v1/prezzo?indirizzo=Via Roma 10, Rivoli&cassaM3=4

Prezzo indicativo per comune (IVA inclusa e IVA esclusa, in centesimi), trasporto compreso. Parametri facoltativi: materiale, giorni. Il prezzo che vale è quello del preventivo confermato dal trasportatore.

POST /api/v1/richieste

Nuova richiesta per un cliente. Mister Benna ricalcola indirizzo, trasportatore e prezzo, poi contatta il cliente per data e prezzo definitivi.

curl -X POST https://misterbenna.com/api/v1/richieste \
  -H "Authorization: Bearer mb_live_LA_TUA_CHIAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "cliente": { "nome": "Mario Rossi", "telefono": "333 123 4567", "email": "mario@esempio.it", "tipo": "privato" },
    "indirizzo": "Via Roma 10, Rivoli",
    "materiale": "pulite",
    "cassaM3": 4,
    "consegnaIl": "2026-10-12",
    "fascia": "8-12",
    "giorni": 7,
    "posizione": "cortile",
    "passaggio": { "larghezza": 3, "altezza": 4 },
    "note": "Citofono Rossi"
  }'

Risposta (201):

{
  "ok": true,
  "codice": "MB-AB12CD34",
  "stato": "ricevuta: stiamo cercando il trasportatore",
  "linkCliente": "https://misterbenna.com/nuova-password?token=…",
  "messaggio": "Richiesta ricevuta. Il cliente può seguirla dal linkCliente…"
}

linkCliente c'è solo se il cliente non aveva un account: mostraglielo, così sceglie la password e segue la richiesta (vale 48 ore). Se aveva già un account la trova nella sua area.

Campo	Obbligatorio	Cosa mettere
cliente.nome	sì	Nome e cognome (o referente).
cliente.telefono	sì	Cellulare italiano: lo usa l'autista. Se ha già un account Mister Benna, la richiesta va lì.
cliente.tipo	no	"privato" (predefinito) o "impresa"; per l'impresa anche ragioneSociale e partitaIva.
cliente.email	no	Per i contatti.
indirizzo	sì	Via, numero civico e comune del cantiere (Piemonte, Lombardia e Liguria).
materiale	no	pulite (predefinito), miste, cartongesso, legno, terra, nonso. Con miste e nonso serve materialeDescrizione.
cassaM3	uno dei due	Cassone: 2, 4, 5, 7, 12 o 17 m³ (altre misure da 1 a 40 m³ solo se un trasportatore della zona le ha, altrimenti su preventivo).
servizio	uno dei due	Altro mezzo (big bag, ribaltabile, ragno…): codici in GET /api/v1/cassoni.
sacchi	no	Solo big bag: quanti sacchi da ritirare (1–60). Il prezzo conta i giri del camion.
viaggi	no	Solo camion senza cassone (ribaltabile, ragno…): quanti viaggi (1–20, predefinito 1).
consegnaIl	sì	Data AAAA-MM-GG, da domani in poi.
fascia	no	"8-12" (predefinita), "13-17" oppure "orario" con orario "09:30".
giorni	no	Giorni di noleggio (predefinito 7). 0 = ritiro in giornata: consegna al mattino, ritiro nel pomeriggio.
posizione	no	cortile (predefinita), cantiere o strada. In strada serve suoloPubblico: "noi" oppure "cliente" con responsabilitaStrada: true.
passaggio	consigliato	Passaggio più stretto in metri: { larghezza, altezza }. Senza, la richiesta va in verifica.
soletta	no	Cantina o garage sotto il punto: no (predefinito), si, nonso.
referente	no	Chi apre il cancello, se non è il cliente: { nome, telefono }.
codici, note	no	Codici del cancello (li vedono solo trasportatore e autista) e note per l'autista.

GET /api/v1/richieste?codice=MB-AB12CD34

Stato delle richieste che hai portato tu (senza codice: le ultime 100), con una frase semplice da mostrare al cliente.

Errori

Risposta { "ok": false, "errore": "…" } in italiano: 400 dati mancanti o sbagliati · 401 chiave mancante o non valida · 403 collaboratore disattivato · 404 non trovato · 422 richiesta non accettata (es. data troppo vicina, materiale non ammesso) · 429 troppe chiamate.