FireFeed Docs

Panoramica

Feed Manager e OMS, dalla qualità del catalogo alla gestione operativa dell'ordine.

FireFeed è una piattaforma commerce composta da due applicazioni coordinate:

  • il Feed Manager prepara, trasforma e distribuisce i dati prodotto;
  • l'OMS acquisisce gli ordini dai canali e governa il lavoro successivo: cliente, evasione, stock, spedizione, reso e riconciliazione operativa.

Le due aree condividono organizzazioni, utenti, progetti, connessioni e lo stesso modello di autorizzazione. Mantengono però responsabilità distinte: il catalogo resta nel Feed Manager, mentre l'OMS tratta l'ordine e i movimenti che ne derivano.

Il problema risolto

Un retailer o un brand deve normalmente coordinare fonti prodotto eterogenee, regole diverse per ciascun canale e operazioni post-vendita distribuite tra marketplace, magazzino e corrieri. Script ad-hoc e fogli di calcolo rendono difficile capire quale dato sia stato pubblicato, dove si trovi un ordine e se un effetto esterno sia stato applicato davvero.

FireFeed riunisce questi flussi in una piattaforma multi-tenant, con configurazione visuale, esecuzioni osservabili e operazioni asincrone recuperabili.

Due piani, una piattaforma

AreaResponsabilità
Feed ManagerImport da file, HTTP e connessioni; schema e mapping; merge; regole no-code; export e pubblicazione sui canali; pianificazione, run e log in tempo reale.
OMSConnessioni commerce; sincronizzazione ordini; anagrafica cliente; conferma ed evasione; picking e packing; inventario, trasferimenti, inventari e documenti PZ/WZ/MM; spedizioni ed etichette; resi e rimborsi; automazioni e operations console.

Un ciclo tipico attraversa entrambe le aree:

  1. le sorgenti alimentano un progetto Feed Manager;
  2. mapping, merge e regole producono il catalogo adatto a ciascun canale;
  3. gli export pubblicano o consegnano il feed;
  4. l'OMS importa gli ordini dalle connessioni abilitate;
  5. operatori e automazioni gestiscono evasione, stock, spedizione e reso;
  6. outbox e blocker rendono visibili gli effetti esterni falliti, ambigui o da riconciliare.

Confini del prodotto

  • FireFeed non è un PIM: non sostituisce authoring, approvazioni editoriali o traduzioni del prodotto.
  • FireFeed non è un ERP fiscale: i documenti di magazzino PZ, WZ e MM sono registrazioni operative, non fatture o documenti fiscali.
  • L'OMS non duplica il catalogo del Feed Manager: conserva i riferimenti necessari a ordini, righe, stock e fulfillment.
  • Il rollout dei provider è intenzionalmente controllato. Una connessione è utilizzabile solo se implementazione, readiness, entitlement, feature flag e capability richieste sono tutte compatibili con il tenant.
  • Gli effetti verso marketplace e corrieri non sono trattati come semplici chiamate HTTP: gli eventi importanti passano da una outbox persistente e, quando l'esito remoto è ambiguo, richiedono riconciliazione esplicita.

Il perimetro provider corrente è orientato al mercato italiano. Un provider presente nel codice può essere ready, controlled, beta o blocked: la presenza nel selettore non equivale quindi a disponibilità generale.

Lessico essenziale

  • Un progetto è un dataset prodotto, per esempio “Catalogo IT” o “Catalogo Outlet”.
  • Un import è una sorgente che alimenta un progetto.
  • Un export è una destinazione che riceve i dati del progetto, eventualmente filtrati e trasformati.
  • Una pipeline run è un'esecuzione end-to-end di import, merge, regole ed export.
  • Un canale OMS è una connessione commerce configurata per acquisire ordini e, in base alle capability, pubblicare stock, spedizioni o rimborsi.
  • Un tenant OMS è lo schema dati isolato della company attiva.
  • Una outbox registra un effetto esterno da consegnare in modo affidabile.
  • Un blocker è un caso che non può essere risolto con un retry cieco e richiede un'azione o una decisione operativa.

Continua con Concetti chiave, Pipeline, Architettura OMS e Stato & roadmap.

In questa pagina