Popular

Documentazione Creso / Docs / 3. Negozi e Storico
icon
CreasyDip
icon
CresoEvo
Gestione Tavoli
Creasy APP - Chiamate API interne
icon
Servizi-Abbonamenti-Giftbox
Naima
Gestione Naima

3. Negozi e Storico

  • 29 views

🔄 Negozi (/tabelle)

Questa chiamata viene utilizzata per recuperare la lista dei negozi della profumeria. Può essere eseguita anche come utente guest.

🔸 Endpoint

POST /tabelle

🔸 Request Body

{
"tipoLista": "neg",
"operazione": "L",
"token": "token_guest_o_autenticato",
"guest": 1
}

  • tipoLista: deve essere "neg" per indicare che si desidera ottenere i negozi.

  • operazione: "L" per eseguire la lettura della lista.

  • token: può essere un token guest o un token utente autenticato.

  • guest: 1 indica che si tratta di una richiesta effettuata da utente non autenticato (guest).

🔸 Response


"status": "OK",
"negozi": [
{
"codice": "001",
"descrizione": "Profumeria Centrale",
"cap": "10123",
"citta": "Torino",
"prov": "TO",
"telefono": null,
"fax": null,
"email": null,
"gmaps": "https://maps.google.com/...",
"whatsapp": "https://wa.me/..."
}
]
}

🔸 Campi restituiti per ciascun negozio

Campo Descrizione
codice Codice identificativo del negozio
descrizione Nome o descrizione del negozio
cap CAP della sede
citta Città in cui si trova il negozio
prov Provincia
telefono Numero di telefono (può essere null)
fax Numero di fax (può essere null)
email Email del negozio (può essere null)
gmaps Link a Google Maps
whatsapp Link per aprire WhatsApp

🧾 Storico Acquisti Utente (/storico)

Questa API restituisce lo storico degli acquisti associati a una fidelity card. È necessario essere autenticati per eseguire questa richiesta.

🔸 Endpoint

POST /storico

🔸 Request Body

{
"fidelity": "codice_fidelity",
"operazione": "R",
"devicetoken": "device_token_guest",
"token": "token_autenticato"
}

  • fidelity: codice della fidelity card dell’utente.

  • operazione: "R" indica la richiesta di lettura.

  • devicetoken: il token ottenuto in fase di pre-autenticazione guest.

  • token: token utente ottenuto dopo l’autenticazione completa.

🔸 Response

{
"status": "OK",
"user":"email_utente",
"vendite": [
{
"uiid": "id_transazione",
"progressivi": "1",
"data": "2025-07-08",
"codprodotto": "ABC123",
"descprodotto": "Crema viso idratante",
"prezzo": "19.90",
"quantita": "1",
"sconto": "10",
"tipo": "A",
"negozio": "Torino Centro",
"promo": "Sì",
"promo_desc": "Promo estiva 10%"
}
]
}

🔸 Campi restituiti per ogni voce in vendite

Campo Descrizione
uiid ID univoco della transazione
progressivi Progressivo della transazione
data Data della transazione (es. YYYY-MM-DD)
codprodotto Codice del prodotto acquistato
descprodotto Descrizione del prodotto
prezzo Prezzo unitario del prodotto
quantita Quantità acquistata
sconto Percentuale di sconto applicata (se presente)
tipo Tipo di movimento (es. “A”)
negozio Negozio in cui è avvenuto l’acquisto
promo Flag che indica se l’acquisto era in promozione
promo_desc Descrizione della promozione