Node catalog

These are the node types the editor’s palette offers, with the fields its inspector shows and validates. Each node’s anchor is its type, for example #commerce.policy.

A node’s outputs are the branches it can take. An edge leaves a node from one output (its sourceHandle; none means out), and the edges on the branches a node did not take are skipped, along with any node that only they lead to (see How a run moves through the graph). Field kinds decide how the inspector edits a value and how it is validated: duration is a string like "2 days", logic is a JSON Logic expression, list is a non-empty list of strings, and text fields interpolate {{path}} templates.

Every node also takes two optional settings outside its config: retries (0–10, default 3 unless the node type sets its own) and timeout (default "5 minutes"); see Retries and timeouts.

Triggers

A flow has exactly one trigger. Triggers pass the order through; they mark how the order started.

Manual / API

trigger.manual

Started from the dashboard or POST /api/v1/orders.

• Outputsout

Webhook

trigger.webhook

Started by a signed inbound order (POST /api/v1/webhooks/orders) from a storefront, marketplace, POS or other channel.

• Outputsout

Field	Kind	Default	Notes
source	text	storefront	Source

Inbound email

trigger.email_po

An order, order form or purchase order arrives by email or upload; the document is stored in R2.

• Outputsout

Field	Kind	Default	Notes
mailbox	text	orders@	Mailbox

Schedule

trigger.schedule

Started on a cadence (reorder runs, subscription renewals).

• Outputsout

Field	Kind	Default	Notes
cron	text	0 6 * * *	Cron

Inventory threshold

trigger.inventory_threshold

Started when a SKU falls below its reorder point.

• Outputsout

Commerce

Commerce nodes act on stock, payments, shipments, documents and the other systems an order touches. Every write is made once per step, so a retried step never reserves, charges or ships twice.

Validate order

commerce.validate

Normalises lines, resolves SKUs and the customer, rejects empty orders.

• Outputsout

Price lines

commerce.price

Prices each line through the pricing chain (price books, contract prices, volume tiers, then list price) and computes the subtotal.

• Outputsout

Field	Kind	Default	Notes
useContracts	boolean	true	Contract pricing. Use negotiated prices when the customer has any
usePriceRules	boolean	true	Price books and volume tiers. Use the price-book and volume entries in the back office
basis	select	auto	Price basis. One of auto, chain, cost. auto prices buy-side orders at cost and sell-side orders through the chain

Calculate tax

commerce.tax

Computes tax on the subtotal (mock tax engine).

• Outputsout

Field	Kind	Default	Notes
rate	number	0.08	Rate

Policy check

commerce.policy

Checks order rules: minimum or maximum total, per-SKU limits, business hours, PO boxes, restricted SKUs.

• Outputspassfail

Field	Kind	Default	Notes
rules (required)	json	[{"rule":"min_order_amount","amount":25},{"rule":"max_qty_per_sku","qty":500}]	Rules. min_order_amount, max_order_amount, max_qty_per_sku, business_hours, no_po_box, restricted_skus

Validate address

commerce.address_validate

Checks and normalises the ship-to in order.meta.shipTo. A correction is offered in vars.suggestedAddress.

• Outputsvalidcorrectedinvalid

Credit check

commerce.credit_check

Compares the order total plus open balance with the customer’s credit limit. Guests and consumers have no credit account.

• Outputsokover_limit

Field	Kind	Default	Notes
noAccount	select	over_limit	Without a credit account. One of over_limit, ok. Where orders from guests and customers without credit go

Budget check

commerce.budget_check

Checks a purchase request against the department budget.

• Outputswithinover

Field	Kind	Default	Notes
budget	number	25000	Budget

Reserve inventory

commerce.reserve_inventoryundo

Holds stock for every line. Released automatically if the order later fails.

• Outputsokbackorder
• Undocompensated when the order fails or is cancelled

Field	Kind	Default	Notes
allowBackorder	boolean	false	Allow backorder

Authorize payment

commerce.authorize_paymentundo

Places an authorization hold. Voided automatically if the order later fails.

• Outputsokdeclined
• Undocompensated when the order fails or is cancelled

Field	Kind	Default	Notes
method	select	card	Method. One of card, card_present, wallet, gift_card, cash, ach, terms

Split by seller

commerce.split_by_sellerundo

Splits the order into one part per marketplace seller. Sellers that auto-accept, and the operator’s own lines, are accepted at once; the rest wait for the seller.

• Outputsacceptedawaiting
• Undocompensated when the order fails or is cancelled

Seller response

commerce.seller_accept

Records a seller’s accept or reject from a seller.responded event, or rejects every seller still pending. Once none is pending, a partial acceptance drops the rejected sellers’ lines.

• Outputsacceptedpartialrejectedpending

Field	Kind	Default	Notes
decision	select	from_event	Decision. One of from_event, expire_pending. from_event reads vars.seller_responded { sellerId, decision, reason? }

Seller payouts

commerce.payoutundo

Schedules a payout to each accepted seller: their lines, less the commission and their share of refunds.

• Outputsout
• Undocompensated when the order fails or is cancelled

Route fulfillment

commerce.route_fulfillment

Decides where the physical lines come from: central stock or a store that ships, the pickup store, or the till’s store for carry-out. Digital lines also take the digital branch, so a mixed cart takes two.

• Outputsshippickupcarry_outdigitalunavailable

Field	Kind	Default	Notes
method	select	from_order	Method. One of from_order, ship, pickup, carry_out. from_order uses order.fulfillment.method, or ship

Ready for pickup

commerce.pickup_readyundo

Stages the held stock at the pickup store and issues a pickup code.

• Outputsout
• Undocompensated when the order fails or is cancelled

Hand over

commerce.handover

The customer has the goods: a pickup is collected or a carry-out sale leaves the store, and held stock is consumed. Returns go through the return steps.

• Outputsout

Deliver digital goods

commerce.deliver_digitalundo

Issues a code (licence key, download or gift card) per unit of each digital line.

• Outputsout
• Undocompensated when the order fails or is cancelled

Capture payment

commerce.capture_payment

Captures a previous authorization, up to the order total; anything left on the authorization is released.

• Outputsokfailed

Charge

commerce.charge

Charges the stored payment method (subscription renewal).

• Outputsokfailed
• Retries0 by default

Refund

commerce.refund

Refunds captured or charged money, all of it or an amount computed from the context.

• Outputsokfailed

Field	Kind	Default	Notes
amount	logic		Amount (expression). Empty refunds everything still refundable
reason	text	Customer return	Reason

Generate invoice

commerce.invoiceundo

Renders the invoice to R2 with the configured payment terms. Unpaid invoices for business customers go on their account, and come off it if the order fails.

• Outputsout
• Undocompensated when the order fails or is cancelled

Field	Kind	Default	Notes
terms	select	due_on_receipt	Terms. One of due_on_receipt, net_15, net_30, net_60
onAccount	boolean	true	Bill to account. Add unpaid business invoices to the customer’s balance

Generate PO

commerce.generate_po

Renders a purchase order for the supplier to R2.

• Outputsout

Field	Kind	Default	Notes
supplier	text	{{vars.supplier}}	Supplier

Create shipment

commerce.shipundo

Buys a label and books the carrier. Cancelled automatically if the order fails.

• Outputsout
• Undocompensated when the order fails or is cancelled

Field	Kind	Default	Notes
carrier	select	ups	Carrier. One of ups, fedex, dhl, freight

Return label

commerce.return_label

Issues a prepaid return label (an RMA) and sends it to the customer.

• Outputsout

Field	Kind	Default	Notes
carrier	select	ups	Carrier. One of ups, fedex, dhl, freight

3-way match

commerce.three_way_match

Matches the PO, the goods receipt and the supplier invoice.

• Outputsmatchmismatch

Field	Kind	Default	Notes
tolerance	number	0.02	Tolerance

Pay supplier

commerce.pay_supplier

Schedules the supplier payment.

• Outputsout

Restock

commerce.restock

Adds received or returned quantities to on-hand inventory.

• Outputsout

Field	Kind	Default	Notes
lines	logic		Lines (expression). A list of { sku, qty }; empty restocks every order line. Capped at the ordered quantity.

ERP sync

commerce.erp_sync

Posts the order to the ERP (mock).

• Outputsout

Field	Kind	Default	Notes
system	text	netsuite	System

Notify

commerce.notify

Sends a message to the customer (or a guest’s contact email), a supplier, the marketplace sellers still to answer (else those who accepted) or the team.

• Outputsout

Field	Kind	Default	Notes
to	select	customer	To. One of customer, supplier, seller, team
subject	text	Order {{order.id}} update	Subject
body	textarea	""	Body

Control

Condition

control.condition

Branches on a JSON Logic expression over the run context.

• Outputstruefalse

Field	Kind	Default	Notes
expression (required)	logic	{">":[{"var":"order.total"},1000]}	Expression

Approval

control.approvalwaits

Waits for a person to approve or reject. Escalates when the timeout passes.

• Outputsapprovedrejectedescalated
• Waitsfor a person or an event

Field	Kind	Default	Notes
title	text	Approve order {{order.id}}	Title
assignee	text	manager	Assignee
timeout	duration	2 days	Escalate after

Wait for event

control.wait_eventwaits

Waits for an external event (payment received, supplier ack, goods received).

• Outputsreceivedtimeout
• Waitsfor a person or an event

Field	Kind	Default	Notes
event (required)	text	payment.received	Event
timeout	duration	30 days	Timeout

Wait

control.wait

Sleeps for a duration, or until a timestamp computed from the context.

• Outputsout

Field	Kind	Default	Notes
duration	duration	1 day	Duration
until	logic		Until (expression). Epoch ms; overrides duration

Set variables

control.set

Assigns run variables from JSON Logic expressions.

• Outputsout

Field	Kind	Default	Notes
assign	json	{"cycle":{"+":[{"var":"vars.cycle"},1]}}	Assignments. { name: expression }

Loop

control.loop

Repeats its body while the condition holds, up to a limit. Connect the end of the body back to the “next” input.

• Outputsbodydone
• Loopaccepts a next back-edge

Field	Kind	Default	Notes
while	logic	true	While
maxIterations	number	12	Max iterations

Continue as new

control.continue_as_new

Ends this run and starts a fresh one on the same flow, carrying the variables forward.

• Outputsnone: ends the run

End

control.end

Finishes the order. “declined” is a policy or approval no; “failed” rolls back every compensable step.

• Outputsnone: ends the run

Field	Kind	Default	Notes
outcome	select	completed	Outcome. One of completed, declined, cancelled, failed
reason	text	""	Reason

AI

Each AI node has a schema-checked model call and a heuristic fallback; see AI nodes and the assistant.

Extract order

ai.extract

Reads an emailed order, order form or purchase order and extracts the customer, reference and line items.

• Outputsout

Classify

ai.classify

Assigns one label from a list (spend category, urgency, intent).

• Outputsout

Field	Kind	Default	Notes
labels	list	["it_hardware","software","office_supplies","services","travel"]	Labels
into	text	category	Store as var

Risk score

ai.risk_score

Scores fraud and credit risk from 0 to 100; branches above the threshold.

• Outputslowhigh

Field	Kind	Default	Notes
threshold	number	70	High risk at

Demand forecast

ai.forecast

Suggests reorder quantities for SKUs at or below their reorder point.

• Outputsout

Field	Kind	Default	Notes
horizonDays	number	30	Horizon (days)

Summarize

ai.summarize

Writes a short summary of the order so far into a variable.

• Outputsout

Field	Kind	Default	Notes
into	text	summary	Store as var

Agent router

ai.router

An LLM reads the order and context, then chooses exactly one route. Each route is an output.

• Outputsone per entry in Routes

Field	Kind	Default	Notes
instructions	textarea	Decide how to handle this order.	Instructions
routes	list	["auto_approve","needs_approval","ask_customer"]	Routes

Assess

ai.assess

A multimodal decision model reads the order (and any images) and returns a probability for every option of every question. Branches on one question.

• Outputsone per entry in Routes

Field	Kind	Default	Notes
questions	json	{"route":{"type":"choice","instructions":"How should this order be handled?","criteria":{"auto_approve":"Routine order from a known customer, nothing unusual","needs_approval":"Large, unusual or risky; a person should review it","ask_customer":"Missing or ambiguous details the customer must clarify"}},"urgent":{"type":"noul","instructions":"Is this order time-sensitive?"},"damage":{"type":"score","instructions":"If photos are attached, how damaged is the item?","criteria":["No damage","Cosmetic","Functional","Destroyed"]}}	Questions. Question id → { type: noul | choice | score, instructions, criteria }. 1 to 64.
branchOn	text	route	Branch on. A yes/no or choice question id. Empty: one output.
minConfidence	number	0	Unsure below. Confidence 0–1. Above 0 adds an “unsure” output.
state	select	order_and_context	State. One of order, order_and_context
images	list	[]	Images. Up to 4: R2 keys, https or data URLs, or {{paths}} to them (e.g. {{order.meta.photos}}).
into	text	assessment	Store as var