Regole commerciali

A che cosa serve nella conversazione

Che cosa succede se manca

• Senza ordine minimo si accetta qualunque importo.
• Senza coordinate bancarie il bonifico non si può offrire.
• Senza sconti e codici amici non si applica nessuno sconto e un codice scritto dal cliente non vale.
• Senza finestra di modifica vale quella di serie: modifiche fino a 2 ore prima della consegna.
• Senza extra per i colli pesanti casse e sacchi viaggiano senza costi in più.

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.

Scarica il modello

• regole.json d'esempioregole.json
• Schema di regole.jsonregole.schema.json

Errori frequenti e il loro messaggio

• 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.

• COORDINATE_BANCARIE_ASSENTI

  «Per offrire il bonifico servono prima le coordinate del conto del negozio.»

  Che cosa fare: Compila intestatario e IBAN, poi aggiungi il bonifico.

• IBAN_NON_VALIDO

  «Le cifre di controllo dell'IBAN non tornano.»(spiegazione di questa guida: Core restituisce il codice)

  Che cosa fare: Ricopialo dalla banca: spazi e minuscole vanno bene.

• GRADINI_NON_IN_ORDINE

  «I gradini di fedeltà vanno dal periodo più corto al più lungo.»(spiegazione di questa guida: Core restituisce il codice)

  Che cosa fare: Ordinali per giorni crescenti.

• VERSIONE_CAMBIATA

  «Qualcuno ha cambiato le regole nel frattempo. Ricarica la pagina e ripeti la modifica.»

  Che cosa fare: Manda based_on_version uguale alla versione attuale.

Come mandarli

• Dal portaleIn parte

  Oggi: Regole del negozio → ordine minimo, metodi di pagamento, costo e soglia per zona, versioni e anteprima. In arrivo: coordinate bancarie, sconti, codici amici, extra per i colli pesanti, finestra di modifica, avancassa, promemoria.

• Dall'APIIn arrivo

  GET/PUT /v1/rules e POST /v1/rules/preview esistono; i permessi rules:read e rules:write non si possono ancora dare a una chiave dal portale.

• Documento JSONIn arrivo

  regole.json: lo stesso documento, da scaricare e ricaricare (per chi gestisce più negozi).

Disponibilità misurata sul servizio vivo il 30 ottobre 2026.

curl -X PUT "https://oxjqgjbiltoviwldailg.supabase.co/functions/v1/core-api/v1/rules" \
  -H "Authorization: Bearer $GAI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: regole-2026-11-02" \
  -d '{"based_on_version":3,"min_order_amount":"25.00","payment_methods":["cash","card_pos"],"zones":[{"zone_slug":"centro","delivery_cost":"4.50","free_threshold":"60.00"}],"order_edit_window_hours":3}'

const risposta = await fetch("https://oxjqgjbiltoviwldailg.supabase.co/functions/v1/core-api/v1/rules", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.GAI_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    based_on_version: 3,
    min_order_amount: "25.00",
    payment_methods: ["cash", "card_pos"],
    zones: [{ zone_slug: "centro", delivery_cost: "4.50", free_threshold: "60.00" }],
    order_edit_window_hours: 3,
  }),
});
console.log(risposta.status, await risposta.json());

Documentazione dell'API