API - Documentazione tecnica per la gestione e l'invio delle LEAD

Questo Web Service permette ai clienti autorizzati di inviare richieste di preventivo per traslochi per privati o traslochi per aziende. Le richieste devono essere inviate in formato JSON con un token di autenticazione personale.

URL del WS

L'URL del servizio, insieme al token di autenticazione personale, verrà fornito al momento dell'attivazione dell'accesso al Web Service.

Metodo HTTP e Header obbligatori

Il Web Service accetta richieste POST con i seguenti header:

• Content-Type: application/json
• X-API-Key: {il tuo token personale}

Autenticazione

Ogni cliente riceve un token unico. Il WS verifica:

• Token presente nell'header X-API-Key
• Token attivo nel database

Se il token non è presente o non è valido, viene restituito un errore JSON:

{
"status": "error",
"error": "Token mancante"
}

oppure

{
  "status": "error",
  "error": "Token non presente nei nostri sistemi"
}

Struttura JSON per traslochi per privati

Campi obbligatori:

• tipo_preventivo: deve essere "P"
• tipologia
  Valori ammessi

  Valori ammessi per il campo "tipologia" del preventivo per traslochi per privati:

  trasloco-appartamento

  trasloco-monolocale-o-bilocale

  trasloco-casa-indipendente

  trasloco-casa-indipendente-659

  trasloco-villa

  trasloco-mobili-singoli

  trasloco-con-smontaggio-e-rimontaggio-mobili

  trasloco-con-deposito-mobili

  trasloco-con-piattaforma-aerea

  trasloco-con-imballaggio-professionale

  piccoli-traslochi

  trasloco-internazionale-per-privati

  sgombero-cantine--solai-e-garage

  trasporto-motocicli-e-scooter

  trasloco-casseforti-domestiche

  trasloco-opere-d-arte-e-oggetti-fragili

  trasloco-pianoforti-e-strumenti-musicali

  trasloco-per-studenti-o-trasfertisti
• cosa_trasloco
  Valori ammessi

  Valori ammessi per il campo "cosa_trasloco":

  tutto

  statue-e-quadri

  mobili
• n_colli
  Valori ammessi

  Valori ammessi per il campo "n_colli":

  1-stanza

  2-stanze

  3-stanze

  4-stanze

  5-stanze-o-piu

  trasloco-di-meno-di-10-scatole

  trasloco-parziale

  trasloco-totale-ufficio
• servizi_aggiuntivi
  Valori ammessi

  Valori ammessi per il campo "servizi_aggiuntivi":

  deposito-temporaneo-o-a-lungo-termine

  imballaggio-completo

  trasporto-di-oggetti-particolari
• paese_ritiro
• localita_ritiro
• paese_consegna
• localita_consegna
• tipo_richiedente
• nome
• cognome
• azienda (se tipo_richiedente non è 'privato')
• email

Campi opzionali:

• note, note_interne, quando_trasloco, termine_ricezione_preventivi
• Dati richiedente: telefono

Esempio di invio CURL (traslochi per privati)

curl -X POST https://www.preventivipertraslochi.it/services/ws_ppt_preventivi.php \
-H "Content-Type: application/json" \
-H "X-API-Key: b04b3b9a5452fa02f2d8ce8f15d72ec8b25cd3820754ed9fa857047da1a877aa" \
-d '{
  "tipo_preventivo": "P",
  "tipologia": "trasporto-appartamento",
  "cosa_trasloco": "tutto",
  "paese_ritiro": "Italia",
  "localita_ritiro": "Milano",
  "paese_consegna": "Spagna",
  "localita_consegna": "Madrid",
  "n_colli": "trasloco-totale-ufficio",
  "servizi_aggiuntivi": "deposito-temporaneo-o-a-lungo-termine",
  "note": "Test da WS",
  "note_interne": "Note visualizzabili sono in area riservata",
  "quando_trasloco": "20 dicembre 2025",
  "termine_ricezione_preventivi": "10 dicembre 2025",
  "tipo_richiedente": "azienda",
  "nome": "Mario",
  "cognome": "Rossi",
  "azienda": "Company S.p.a.",
  "telefono": "123456798",
  "email": "email@email.it"
}'

Risposta JSON

Successo:

{
  "status": "success",
  "message": "Dati ricevuti correttamente"
}

Errore campi obbligatori mancanti:

{
  "status": "error",
  "message": "Campi obbligatori mancanti: paese_ritiro, localita_ritiro"
}

Struttura JSON per traslochi per aziende

Campi obbligatori:

• tipo_preventivo: deve essere "A"
• tipologia
  Valori ammessi

  Valori ammessi per il campo "tipologia" del preventivo per traslochi per aziende:

  trasloco-mobili-singoli

  trasloco-con-deposito-mobili

  piccoli-traslochi

  trasloco-con-smontaggio-e-rimontaggio-mobili

  trasloco-con-piattaforma-aerea

  trasloco-archivi-e-documenti-cartacei

  trasloco-con-imballaggio-professionale

  trasloco-casseforti-e-armadi-blindati

  facchinaggio-interno-e-movimentazione-carichi

  sgombero-e-smaltimento-arredi-ufficio

  trasloco-uffici-fuori-orario

  trasloco-negozi-e-attivita-commerciali

  trasloco-laboratori-e-macchinari

  trasloco-postazioni-it-e-server

  trasloco-internazionale
• cosa_trasloco
  Valori ammessi

  Valori ammessi per il campo "cosa_trasloco":

  tutto

  statue-e-quadri

  mobili
• n_colli
  Valori ammessi

  Valori ammessi per il campo "n_colli":

  1-stanza

  2-stanze

  3-stanze

  4-stanze

  5-stanze-o-piu

  trasloco-di-meno-di-10-scatole

  trasloco-parziale

  trasloco-totale-ufficio
• servizi_aggiuntivi
  Valori ammessi

  Valori ammessi per il campo "servizi_aggiuntivi":

  inventario-e-catalogazione-beni

  etichettatura-e-tracciamento

  archiviazione-e-ricollocazione-documenti

  distruzione-certificata-documenti

  gestione-server--pc-e-infrastruttura-it
• paese_ritiro
• localita_ritiro
• paese_consegna
• localita_consegna
• tipo_richiedente
• nome
• cognome
• azienda (se tipo_richiedente non è 'privato')
• email

Campi opzionali:

• note
• note_interne
• Dati richiedente: telefono

Esempio di invio CURL (traslochi per aziende)

curl -X POST https://www.preventivipertraslochi.it/services/ws_ppt_preventivi.php \
-H "Content-Type: application/json" \
-H "X-API-Key: b04b3b9a5452fa02f2d8ce8f15d72ec8b25cd3820754ed9fa857047da1a877aa" \
-d '{
  "tipo_preventivo": "A",
  "tipologia": "trasloco-mobili-singoli",
  "cosa_trasloco": "tutto",
  "paese_ritiro": "Italia",
  "localita_ritiro": "Milano",
  "paese_consegna": "Spagna",
  "localita_consegna": "Madrid",
  "n_colli": "trasloco-totale-ufficio",
  "servizi_aggiuntivi": "deposito-temporaneo-o-a-lungo-termine",
  "note": "Test da WS",
  "note_interne": "Note visualizzabili sono in area riservata",
  "quando_trasloco": "20 dicembre 2025",
  "termine_ricezione_preventivi": "10 dicembre 2025",
  "tipo_richiedente": "azienda",
  "nome": "Mario",
  "cognome": "Rossi",
  "azienda": "Company S.p.a.",
  "telefono": "123456798",
  "email": "email@email.it"
}'

Risposta JSON

Successo:

{
  "status": "success",
  "message": "Dati ricevuti correttamente"
}

Errore campi obbligatori mancanti:

{
  "status": "error",
  "message": "Campi obbligatori mancanti: paese_ritiro, localita_ritiro"
}

Risposta JSON

Successo:

{
  "status": "success",
  "message": "Dati ricevuti correttamente"
}

Errore campi obbligatori mancanti:

{
  "status": "error",
  "message": "Campi obbligatori mancanti: n_colli, tipologia"
}

Note di sicurezza

• Il token deve essere sempre trasmesso via HTTPS
• Ogni cliente ha un token unico e revocabile (all'attivazione del servizio ogni cliente riceverà un token univoco)
• Non salvare il token nei log pubblici
• Utilizzare solo richieste POST con Content-Type: application/json