20 — API JSON simulate

Versione 2.1.1

Scopo

Questa sezione espone contratti JSON simulati per collegare progressivamente APP Cliente, APP Negozio, Scanner/POS, Dashboard Admin, vendite e VDN_SCAMBIO_DATI al Database Centrale.

Documentazione endpoint Verifica API JSON Percorso guidato

Health check

GET /api/v1/health

Stato applicazione e versione DB

Cliente

GET /api/v1/clienti/<id_cliente>

Anagrafica Cliente e QR

Punti Cliente

GET /api/v1/clienti/<id_cliente>/punti

Saldo e ultimi movimenti Punti

Negozio

GET /api/v1/negozi/<id_negozio>

Scheda Negozio sintetica

Credito Negozio

GET /api/v1/negozi/<id_negozio>/credito

Saldo, soglia e stato Credito

Coupon/Omaggi

GET /api/v1/coupon

Coupon attivi con filtri simulati

Prodotti/Servizi

GET /api/v1/prodotti-servizi

Catalogo paginato vendibile online/offline

Vendita offline

POST /api/v1/vendite/offline

Registrazione vendita offline simulata da APP Scanner/POS

Vendita online

POST /api/v1/vendite/online

Registrazione ordine online simulato

VDN_SCAMBIO_DATI

GET /api/v1/scambio-dati/stato

Stato cartelle e messaggi scambio dati

Dashboard KPI

GET /api/v1/dashboard/kpi

KPI sintetici per Admin/Sede