Canali marketplace nell'OMS

I canali collegano l'OMS a marketplace e negozi online. Da Canali → Marketplace vedi per ciascun collegamento lo stato, la salute della connessione, la readiness del provider e l'ultimo sync.

Creare un canale

Apri Canali e scegli Nuovo canale. Il wizard ha quattro passaggi:

1. Scegli marketplace e nome del canale.
2. Seleziona una connessione esistente oppure inserisci nuove credenziali, che FireFeed salva cifrate.
3. Collega, se serve, un progetto Feed Manager e un export compatibile.
4. Controlla il riepilogo e crea il canale.

La disponibilità dipende dalle capability dichiarate dal provider. Il wizard non rende selezionabile un adapter pianificato o privo della lettura ordini.

Verificare e attivare la connessione

Usa Test dalla lista oppure Test connessione nel dettaglio. Il controllo esegue una chiamata reale al provider e registra esito, latenza e revisione delle credenziali. Se cambi configurazione, il vecchio test non vale per la nuova revisione.

Un canale disattivato può essere riattivato solo con un test riuscito per la revisione corrente nelle ultime 24 ore. La badge Verificata descrive questo controllo tecnico: non è una garanzia che ogni ordine futuro sarà importabile.

Sincronizzare gli ordini

Nel dettaglio premi Sync now per accodare subito un'importazione. La sezione Storia sincronizzazioni mostra le ultime 20 esecuzioni, con stato, durata, numero di ordini letti ed eventuale errore.

Gli ordini sono importati in modo asincrono: dopo il comando può essere necessario attendere il worker e aggiornare la pagina. Un test connessione riuscito non sostituisce il controllo della storia sync.

Collegare il feed

Il collegamento al progetto serve ad associare gli SKU ordinati ai cataloghi e ai fornitori del Feed Manager.

• Per Amazon, E-Price, Leroy Merlin e MediaWorld puoi collegare anche un export dello stesso tipo: il routing è deterministico.
• Per gli altri canali il dettaglio mostra Fallback supplier search: FireFeed usa il progetto, ma non promette un abbinamento deterministico tramite export.

Il canale può importare ordini anche senza progetto; in quel caso le informazioni sui fornitori e sui costi possono restare incomplete.

Webhook WooCommerce e PrestaShop

Per questi due tipi puoi creare un endpoint HMAC per ricevere aggiornamenti ordine in tempo reale. Copia URL e segreto nella configurazione dello shop prima di attivarlo. Il segreto è mostrato una sola volta; durante una rotazione quello precedente resta valido per 15 minuti.

WooCommerce usa gli eventi order.created, order.updated e order.restored. PrestaShop richiede il modulo FireFeed e le intestazioni di firma indicate nella pagina. Il webhook integra il sync, non elimina la necessità di controllare gli errori.

Inventory outbound

Nel dettaglio del canale un amministratore con permesso OMS in scrittura può:

• scegliere i magazzini inclusi e un buffer di sicurezza;
• abilitare la generazione delle intenzioni di pubblicazione;
• creare binding espliciti fra SKU OMS e identità della listing esterna;
• lasciare il flusso in FAKE_ONLY, che calcola e registra senza scrivere al provider.

La quantità ATS è la disponibilità dei magazzini scelti meno il buffer, mai inferiore a zero. FireFeed non presume che lo SKU OMS coincida con l'ID della listing.

Permessi e limiti

La lettura richiede accesso OMS. Creazione, test, attivazione, feed e webhook richiedono il permesso OMS in scrittura; la configurazione inventory richiede anche ruolo ADMIN o OWNER. Le badge di readiness descrivono l'implementazione FireFeed, ma certificazioni, scope e abilitazioni commerciali restano specifici dell'account provider.