FireFeed Docs

Automazioni e Operations

Crea regole deterministiche e intervieni in sicurezza su blocker, outbox ed esiti incerti.

Automazioni reagisce agli eventi OMS con regole controllate. Operations mostra i problemi che richiedono attenzione e gli eventi asincroni scambiati con marketplace e corrieri. Le due pagine servono a scopi diversi: una definisce il comportamento futuro, l'altra aiuta a recuperare ciò che non ha avuto un esito certo.

Creare un'automazione

Scegli Automazioni → Nuova automazione e configura:

  • nome, descrizione, stato attivo e priorità;
  • un trigger fra gli eventi ordine, spedizione, reso, fulfillment, magazzino e inventory;
  • condizioni in modalità Tutte oppure Almeno una;
  • da una a cinque azioni, immediate o ritardate.

I campi e gli operatori sono scelti da un catalogo chiuso. Le stringhe supportano, fra gli altri, uguaglianza, appartenenza, CONTAINS e STARTS_WITH; i numeri anche confronti come GT e LTE; i booleani uguaglianza o disuguaglianza. Un campo assente non soddisfa mai la condizione, nemmeno con NEQ o NOT_IN.

Azioni disponibili

Il branch corrente espone solo tre azioni:

  • SET_ORDER_STATUS, disponibile esclusivamente con trigger order.*;
  • OPEN_BLOCKER, con codice AUTOMATION_*, severità e riepilogo;
  • SEND_WEBHOOK, verso un endpoint outbound attivo della stessa organizzazione.

Non è un motore di script: non esegue codice, query libere o JSONPath arbitrario. Sono ammesse al massimo 10 condizioni, 5 azioni e un ritardo di 30 giorni. La profondità di eventi prodotti da automazioni è limitata per evitare cicli infiniti.

Provare, attivare e leggere le run

Usa Dry run e seleziona un evento recente compatibile. L'anteprima dice se le condizioni combaciano e quali azioni verrebbero pianificate, senza eseguirle.

Dry run senza effetti

La simulazione non cambia stati ordine, non apre blocker e non invia webhook. Verifica il risultato e poi abilita la regola quando sei pronto.

Le regole attive mostrano revisione, numero di attivazioni e ultimo fire. Le esecuzioni recenti riportano evento, stato e azioni. Una modifica concorrente viene rifiutata invece di sovrascrivere una versione più recente. Archivia è definitivo: la regola viene disattivata e non può essere riattivata dall'interfaccia.

Leggere Operations

La pagina ha due sezioni:

  • Blocker aperti: condizioni che richiedono una decisione o una recovery;
  • Outbox recente: eventi asincroni con stato, tentativi ed ultimo errore.

PENDING significa in attesa, SUCCEEDED consegnato al processore e FAILED tentativi esauriti. Per alcune scritture esterne può esistere UNKNOWN: FireFeed sa che la chiamata è iniziata ma non può provare se il provider l'ha applicata.

Intervenire senza duplicare effetti

Per un errore sicuramente non applicato puoi usare Rilancia quando disponibile. Risolto e Ignora chiudono un blocker ordinario ma non inventano l'esito del provider.

Gli esiti incerti hanno procedure dedicate:

  • label carrier: conferma che non è stata creata prima di riabilitare il tentativo;
  • conferma, annullo o ritiro carrier: verifica lo stato sul portale del corriere e scegli applicato o non applicato;
  • spedizione marketplace: verifica il marketplace prima di confermare o ritentare;
  • rimborso: apri il reso e usa la riconciliazione finanziaria dedicata;
  • documento label mancante: passa dalla recovery nella pagina Spedizioni.

UNKNOWN non è FAILED

Non rilanciare una scrittura esterna solo perché la risposta è mancata. Una seconda create, un secondo rimborso o un secondo annullo possono duplicare un effetto già applicato. Prima raccogli evidenza dal provider, poi scegli l'esito corrispondente.

Permessi e limiti

Tutti gli utenti con accesso OMS possono leggere regole, run, blocker e outbox. Creare, modificare, simulare o archiviare automazioni richiede OMS in scrittura e ruolo ADMIN o OWNER. Le recovery rispettano la capability dell'operazione: per esempio un rimborso o un annullo richiede un amministratore, mentre molte azioni operative di spedizione sono disponibili da MEMBER.

La pagina mostra fino a 100 regole, 50 run recenti, 200 blocker aperti e 200 eventi outbox. Non sostituisce il portale del provider quando serve verificare un esito esterno.

In questa pagina