For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/mobile/commerce.md (or send Accept: text/markdown).
Commerce su mobile
Gestisci prodotti e ordini del negozio per il workspace.
Prodotti
GET e POST su /api/mobile/commerce/products elencano e creano prodotti — solo owner e admin. Un nuovo prodotto inizia come draft; i prezzi entrano come stringhe e si conservano in centesimi con precisione di due decimali, e il tracciamento delle scorte è opzionale. I prodotti non vengono mai eliminati: archived è lo stato di rimozione, e PATCH aggiorna campi e stato — draft, active, archived — insieme.
Gli ordini avanzano solo in avanti
GET /api/mobile/commerce/orders elenca gli ordini; sono creati dal checkout del negozio, mai dall'app. PATCH fa avanzare lo stato solo in avanti — pending a paid a fulfilled — con cancelled consentito prima del pagamento e refunded dopo. L'annullamento ripristina le scorte tracciate nella stessa transazione, e una transizione non valida è un no-op silenzioso anziché un errore che l'utente deve chiudere.
Verifica e risoluzione dei problemi
Vendi tramite il checkout pubblico, fai avanzare l'ordine su mobile e conferma che le scorte tornano quando un ordine pending viene annullato. I membri sotto admin non possono proprio raggiungere la superficie — verifica che la vedano come non disponibile anziché vuota.