fluent-oms

Classifies Fluent Commerce OMS operations by risk and guides safe order orchestration decisions.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/MetaFloor-AI/metafloor-scm-plugin-openai --skill fluent-oms-metafloor-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fluent-oms
Source: https://github.com/MetaFloor-AI/metafloor-scm-plugin-openai/tree/main/skills/platforms/oms/fluent-oms
Command: npx skills add https://github.com/MetaFloor-AI/metafloor-scm-plugin-openai --skill fluent-oms-metafloor-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Operating Fluent Order Management (Fluent Commerce) safely is hard because every order, fulfilment, and payment is driven by the Rubix rules engine with at-least-once event delivery, so a wrong commit, capture, or ruleset deploy can double-charge customers, oversell inventory, or re-orchestrate the entire fleet. This Skill gives an AI agent the operator judgment to classify each action as read, reversible write, committing write, or destructive, and to know the edge states and recovery paths before acting. ## Core Features & Use Cases - Risk-classified operation matrix: Maps every Fluent OMS operation family (booking, sourcing, capture, refund, appeasement, ruleset deploy, inventory feed load) to a read / write / destructive gate with the reasoning behind each classification. - Gotcha causal chains: 26 documented failure chains covering ATS vs on-hand, the IQ ledger, event idempotency, auth expiry, split fulfilment, DSV cancels, and inventory feed re-baselining. - Edge states and recovery playbooks: Handles click-and-collect, backorders, advance exchanges, multi-tender payments, escalated fulfilments, and explains what can and cannot be undone. - Use Case: Before releasing a fraud hold or deploying a sourcing ruleset change to a live retailer, the agent consults this Skill, recognizes both as destructive-tier actions, re-reads ATS and gateway state, and pauses for named human approval instead of executing blindly. ## Quick Start Ask the agent whether it is safe to cancel a Fluent OMS order that has already been captured and what steps the cancellation requires.

Frequently Asked Questions about fluent-oms

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely cancel an order in Fluent OMS?

Cancelling a Fluent OMS order is reversible only before picking and capture: void the payment authorization, release the RESERVED inventory quantity, and confirm the gateway void succeeded. After capture or ship, cancellation becomes a refund plus a physical return, which is destructive.

What is the difference between ATS and on-hand inventory in Fluent Commerce?

Available-to-Sell (ATS) is computed on a Virtual Position as Inventory Position stock minus Controls (buffers and exclusions) minus other demand, so it is not raw on-hand. Promising orders off raw on-hand ignores buffers and network demand and causes oversell.

Why did a Fluent OMS order get double-charged or double-reserved?

Fluent events use at-least-once delivery, and a roughly 4-minute execution timeout re-queues an event while the original keeps running, so a book or capture can execute twice. Never blind-retry; read the entity, event status, and gateway state as the idempotency check first.

When should I use Fluent OMS guidance versus Manhattan Active Omni?

Use this Skill only when the OMS is Fluent Commerce, which orchestrates through the Rubix rules engine and events. Manhattan Active Omni uses its own DOM microservices and is covered by the separate manhattan-oms skill; the ruleset and event judgment does not transfer.

Is deploying a ruleset change in Fluent OMS risky?

Yes. Deploying a workflow or ruleset version re-orchestrates every current and future entity of that type, and in-flight entities can strand on removed states. Treat a live deploy as destructive-tier: test in a sandbox retailer and require a named approver.

Why does a Fluent OMS backorder fail to capture payment?

Payment authorizations expire, commonly within days depending on the issuer. A long backorder or pre-order that ships after the auth lapses fails to capture unless the payment ruleset re-authorizes first, so check auth validity before shipping.