I tuoi dati

Consegne e calendario

Dove consegni, a che costo, in quali giorni e fasce, e quando sei chiuso.

A che cosa serve nella conversazione

Dall'indirizzo del cliente l'assistente trova la zona (per località o codice postale), dice il costo della consegna e la soglia per averla gratis, e propone solo le fasce di quella zona, col tuo preavviso. In un giorno di chiusura lo dice con la tua nota («Natale: non consegniamo») e salta al primo giorno aperto.

Il calendario completo aggiunge: le festività nazionali del tuo paese con un clic (Pasqua e Pasquetta calcolate ogni anno); chiusure ogni anno (--12-24) o rispetto a Pasqua (easter+1); «chiuso dalle 14» in un giorno; la chiusura di una sola zona o di una sola località; l'ora dopo la quale non si consegna in giornata; la fine più tarda di una fascia; quanti ordini accetta una fascia (una fascia piena non si propone più).

Esempio

Cliente: Mi portate la spesa domani pomeriggio?

Assistente: Domani nella tua zona consegniamo in queste fasce: • 15:00-17:00 • 17:00-19:00 Quale preferisci? La consegna costa €4,50, gratis sopra €60,00.

Zona «centro»: costo 4,50, soglia 60,00, fasce del pomeriggio. Esempio illustrativo, coi prodotti del modello e un negozio inventato.

Che cosa succede se manca

  • Senza zone l'assistente non sa se consegni all'indirizzo («zona non nota») e non sa dire il costo.
  • Senza fasce non può proporre un orario di consegna.
  • Senza chiusure può promettere una consegna in un giorno di festa.
  • Senza soglia la consegna non è mai gratuita.
  • Senza ora limite può proporre una fascia stasera, se il preavviso lo permette.
  • Senza festività ricorrenti scrivi ogni data a mano, ogni anno (e Pasquetta si dimentica facilmente).

I campi

Obbligatorio: senza, il prodotto non si vende come il cliente se l'aspetta. Consigliato: senza, c'è un ripiego dichiarato, ma l'esperienza è più povera. Facoltativo: un miglioramento.

  • date_or_ruleobbligatorio
    Colonna nel file
    Data o regola
    Tipo
    testo
    Esempio
    easter+1 · --08-15 · 2026-12-24
    Regola
    una data (AAAA-MM-GG o GG/MM/AAAA); ogni anno: --MM-GG o GG/MM; Pasqua: easter; Pasquetta: easter+1 (easter+N, easter-N fino a 70 giorni)
  • scopeconsigliato
    Colonna nel file
    Dove
    Tipo
    testo
    Esempio
    all · locality:Borgo Prova
    Regola
    vuoto o all = tutto il negozio; zone:<codice della zona>; locality:<località come scritta nella zona>
  • kindconsigliato
    Colonna nel file
    Tipo
    Tipo
    testo
    Esempio
    full · partial
    Regola
    full = chiuso tutto il giorno; partial = chiuso dalle ore indicate
  • from_timeconsigliato
    Colonna nel file
    Dalle ore
    Tipo
    testo
    Esempio
    14:00
    Regola
    HH:MM, solo per partial: le fasce che iniziano da quest’ora in poi non si consegnano
  • noteobbligatorio
    Colonna nel file
    Nota per il cliente
    Tipo
    testo
    Esempio
    Pasquetta · Ferragosto · Vigilia: consegne solo al mattino
    Regola
    max 200 caratteri, nella lingua del negozio: l’assistente la dice al cliente

Zone, fasce e preavviso (pagina Consegne)

  • zoneobbligatorio
    Tipo
    codice
    Esempio
    centro
    Regola
    Minuscole, cifre e trattini; attiva o no.
  • localitiesobbligatorio
    Tipo
    elenco
    Esempio
    Borgo Prova
    Regola
    Fino a 200 per zona; una località in due zone attive è rifiutata.
  • postal_prefixesfacoltativo
    Tipo
    elenco
    Esempio
    07100
    Regola
    Codici postali o prefissi (da 2 a 10 caratteri); un codice in una sola zona attiva.
  • delivery_costobbligatorio
    Tipo
    importo
    Esempio
    4.50
    Regola
    Nella valuta del negozio.
  • free_thresholdconsigliato
    Tipo
    importo
    Esempio
    60.00
    Regola
    Mai sotto il costo della consegna.
  • windowsobbligatorio
    Tipo
    giorno, dalle, alle
    Esempio
    Mon 15:00-17:00
    Regola
    Per zona; inizio prima della fine; «Copia su tutti i giorni feriali».
  • lead_hoursobbligatorio
    Tipo
    ore
    Esempio
    2
    Regola
    Da 0 a 168: la prima fascia deve iniziare almeno tante ore dopo l'ordine.
  • closuresconsigliato
    Tipo
    data e nota
    Esempio
    2026-12-25 · Natale
    Regola
    La nota la legge il cliente.
  • same_day_cutoffconsigliato
    Tipo
    HH:MM
    Esempio
    17:00
    Regola
    Calendario completo: dopo quest'ora nessuna fascia in giornata.
  • latest_slot_endfacoltativo
    Tipo
    HH:MM
    Esempio
    21:00
    Regola
    Calendario completo: nessuna fascia che finisce dopo quest'ora.
  • capacityfacoltativo
    Tipo
    ordini per fascia
    Esempio
    12
    Regola
    Calendario completo: una fascia piena non si propone più.

Scarica il modello

La prima riga è l'intestazione; la seconda (con # in testa) descrive ogni colonna; le tre righe d'esempio cominciano anch'esse con # e non si importano. I nomi delle colonne si riconoscono in tutte e sei le lingue e col nome del campo.

Errori frequenti e il loro messaggio

  • COMUNE_IN_DUE_ZONE

    «Lo stesso comune è in due zone attive. Lascialo in una sola.»

    Che cosa fare: Ogni località sta in una sola zona attiva.

  • CODICE_IN_DUE_ZONE

    «Lo stesso codice postale è in due zone attive. Lascialo in una sola.»

    Che cosa fare: Ogni codice postale sta in una sola zona attiva.

  • SOGLIA_SOTTO_IL_COSTO

    «La soglia per la consegna gratuita non può essere più bassa del costo della consegna.»

    Che cosa fare: Alza la soglia o lasciala vuota.

  • ZONA_SCONOSCIUTA

    «Una fascia oraria è legata a una zona che non c'è più. Scegli una zona dall'elenco.»

    Che cosa fare: Sposta la fascia su una zona che c'è.

Come mandarli

  • Dal portaleIn parte

    Oggi: Consegne → zone con località e codici postali, costo e soglia, giorni e fasce, preavviso, chiusure per data con la nota per il cliente, e l'anteprima dei prossimi giorni. In arrivo: il calendario completo (festività nazionali, chiusure ricorrenti e parziali, per zona o località, ora limite, fine più tarda, capienza) e il file delle chiusure.

  • Dall'APINon disponibile

    Le consegne si impostano solo dal portale.

Disponibilità misurata sul servizio vivo il 30 ottobre 2026.

Documentazione dell'API