Gestionale eBay
Dashboard gestionale multi-canale per e-commerce con calcolo automatico dei margini
Ruolo: Sviluppo full-stack (backend + frontend)
Stack: PHP 7+, MySQL/MariaDB, JavaScript ES6, jQuery, Bootstrap 4
Tipo di progetto: Applicazione web gestionale (SaaS interno / tool per venditori e-commerce)
Il Problema
Chi vende su più piattaforme (eBay, WooCommerce) affronta un problema molto concreto: capire quanto guadagna davvero su ogni vendita. Il prezzo finale di un prodotto viene eroso da una catena di costi nascosti e variabili — commissioni di categoria, sconti “Top Venditore”, tasse fisse e percentuali, costi di sponsorizzazione, spedizione con supplemento carburante, IVA applicata in punti diversi del calcolo. Gestire tutto questo a mano, per ogni ordine e ogni inserzione, su più canali contemporaneamente, è lento, error-prone e rende difficile capire quali prodotti e quali canali sono davvero redditizi.
Il secondo problema è la frammentazione: ordini eBay da un lato, ordini WooCommerce dall’altro, ognuno con la propria interfaccia, nessuna vista unificata su vendite, prodotti e margini.
La Soluzione
Ho progettato e sviluppato Dashboard, una dashboard gestionale che centralizza vendite, ordini e prodotti provenienti da eBay e WooCommerce in un unico pannello, con un motore di calcolo margini costruito su misura che replica fedelmente la logica di commissioni reale di eBay (classe, sconto Top Venditore, tasse fisse e percentuali, sponsorizzazione, IVA applicata correttamente sui totali) restituendo il guadagno netto in tempo reale, prima ancora di pubblicare un’inserzione.
Funzionalità Principali
Gestione multi-canale Sincronizzazione automatica delle inserzioni eBay e import ordini da WooCommerce via API REST v3, con prefissi automatici (EB- / WC-) per distinguere l’origine di ogni ordine in un unico pannello.
Motore di calcolo guadagno Il cuore del progetto: un sistema che calcola in tempo reale commissioni eBay dinamiche, sponsorizzazione (con arrotondamento per eccesso), costi di spedizione (tariffa base + supplemento carburante + IVA) e margine netto finale — applicando l’IVA nel punto corretto della catena di calcolo, non sui singoli componenti ma sul totale aggregato.
Gestione ordini Import automatico paginato da WooCommerce, import manuale via CSV con parsing e validazione, filtri per stato/data/canale, tracking completo dello storico e sistema di warning/errori durante l’importazione.
Gestione prodotti e inserzioni Catalogo centralizzato con associazione multi-piattaforma dello stesso prodotto, creazione e modifica inserzioni eBay con preview del margine prima della pubblicazione.
Sistema commissioni configurabile Pannello impostazioni con gestione centralizzata delle commissioni eBay, Stripe e PayPal (percentuali e centesimi fissi), così da adattare il sistema a diverse strutture di costo senza toccare il codice.
UI moderna Interfaccia basata su SB Admin 2 (Bootstrap 4), con dark mode, ricerca globale e layout responsive per desktop, tablet e mobile.
Il Motore di Calcolo: come funziona
La parte tecnicamente più delicata del progetto è la formula di calcolo del guadagno, che tiene conto di dove e come viene applicata l’IVA — un dettaglio che, se sbagliato, falsa ogni report di redditività:
- Si sommano i costi eBay al netto di IVA (classe − sconto Top Venditore, tassa %, tassa fissa)
- Si aggiunge la sponsorizzazione (arrotondata per eccesso)
- Si applica l’IVA al totale aggregato, non ai singoli componenti
- Si calcola separatamente il costo di spedizione (tariffa + fuel, poi IVA)
- Il guadagno netto è: prezzo di vendita − costo prodotto (IVA inclusa) − costi eBay (IVA inclusa) − spedizione (IVA inclusa)
Su una vendita di esempio da 100€, con costo prodotto 40€, IVA 22%, classe eBay 12% e sponsorizzazione al 3%, il sistema calcola un margine netto del 23,89% — un dato che prima richiedeva un foglio di calcolo separato per ogni ordine.
Architettura Tecnica
- Backend: PHP 7+ con PDO e prepared statements, pattern MVC-like con separazione netta tra logica e presentazione
- Frontend: JavaScript ES6, jQuery, Bootstrap 4, Select2 per dropdown avanzati con ricerca
- Database: MySQL/MariaDB
- Integrazioni: REST API per WooCommerce, sincronizzazione eBay, chiamate AJAX per le interazioni real-time
- Sicurezza: prepared statements contro SQL injection, sanitizzazione degli input, gestione sicura delle sessioni, validazione degli upload
- Componenti riutilizzabili: header, sidebar e footer condivisi, cache-busting automatico sugli asset
Perché è un progetto interessante
Dashboard non è un semplice CRUD: è un progetto in cui la sfida principale è stata tradurre in codice una logica di business complessa e piena di casi particolari (commissioni a scaglioni, sconti condizionali, arrotondamenti specifici, IVA applicata in punti diversi) mantenendo il calcolo preciso, verificabile e coerente su due flussi paralleli (creazione inserzione e import ordini), oltre a costruire un layer di integrazione affidabile con API esterne (WooCommerce REST, eBay).
