Skip to main content

Nodes & Connections

Flow Builder graphs are made from nodes and edges. Nodes are the modules that collect, transform, branch, schedule, price, or complete work. Edges are the typed connections that pass a user path or data between them.

Connected Service Flow nodes on the SRVZr canvas
The canvas shows the complete path and the relationships between nodes.

The required flow shape​

The core user path starts with a User node and ends at the flow’s domain endpoint:

User → page/entity → collection → logic/pricing → outcome → endpoint

For a Service Flow, that usually means User → Service Page → Work Order Form → … → Service. The page node is the link to the published Service experience; it is not the same thing as the final Service endpoint.

Every connection should answer two questions:

  1. Does the user path continue? The next node must be reachable when the previous node completes.
  2. Does the next node receive the data it needs? A calculator, conditional, splitter, quote, or checkout must receive the relevant variable channel from upstream.

Connection channels​

Edges are typed. The UI uses different colors to make those channels legible on the canvas:

ChannelWhat it carriesTypical use
User flowThe customer’s path through the experienceUser → form → pricing → checkout
Work orderWork-order contextA form or work-order node feeding another node
InformationEntity or contextual informationService, rental, event, or account context
PaymentPrice and payment dataCalculator → Quote → Checkout
Servo typesThe supported robot typesServo Types → Servo in a Stint Flow
PoliciesThe policies a servo should followPolicies → Servo

An edge can be visually close to another edge while still carrying a different channel. When a node appears configured but does not run, check that the incoming edge is connected to the correct input handle, not only that a line is visible.

Complete node reference​

Entry, entity, and endpoint nodes​

NodeWhat it doesWhere it is used
UserThe person entering the flow. Every user flow needs one.All flow types
SRVZrRepresents the business/account context behind a flow.Services, rentals, events
YouRepresents the flow owner or preset maker.All flow types
Service PageThe published page customers arrive on. Connect it to the Service record.Service
Rental PageThe published page renters arrive on.Rental
Stint PageThe work page workers arrive on.Stint
Event PageThe event page attendees arrive on.Event
ServiceThe service being requested; the terminal endpoint for a service flow.Service
RentalThe rental being booked; the terminal endpoint for a rental flow.Rental
StintThe stint the worker takes; the terminal endpoint for a stint flow.Stint
ServoThe robot that performs the work.Stint

Collection and context nodes​

NodeWhat it doesImportant configuration
Work Order FormCollects job details through a published form.Select a published form; it must receive input from the user flow and continue to another node.
BankReads stored data from a selected bank and exposes it downstream.Choose the bank and field in the node editor.
TiersLets the customer choose among options such as Standard, Priority, and Same day.Add tiers with names, descriptions, and prices.
SchedulingCollects a date, time, or range.Choose date/date-time/range mode, slots, working days, and booking limits.
Pickup LocationCollects a renter-entered pickup address.Rental flows only.

Logic and transformation nodes​

NodeWhat it doesImportant configuration
CalculatorComputes a total from upstream values.Fixed, tiered, expression, distance, or function pricing; currency, rounding, adjustments, and result variable.
ConditionalSplits the path into True and False branches using a comparison.Variable, type, operator, comparison value, and optional script. Both outputs need a safe continuation.
SplitterSplits the path into multiple cases using one variable, like a switch statement.Switch variable and at least one case; every case output must be connected.
Rental RulesApplies rental terms or weekday restrictions.Define the rules the renter must agree to.
Timing & PricingPrices a rental by billing period and duration limits.Unit price, hourly/daily/weekly/monthly period, minimum and maximum units.

Payment and fulfillment nodes​

NodeWhat it doesImportant configuration
QuotePresents the calculated line items before payment.Connect pricing data and configure the quote/invoice presentation.
CheckoutCollects payment using the selected methods and terms.Payment methods, pay-in-full/deposit/pay-later terms, line items, and invoice template.
Servo TypesDeclares which robot types can execute a Stint.Select at least one supported servo type and connect it to Servo.
PoliciesSelects the rules a servo follows while doing the work.Choose a saved policy or policy template.

A Service Flow, node by node​

The built-in Quote & Pay pattern illustrates the intended order:

  1. User , starts the experience.
  2. Service Page , identifies the published service page.
  3. Job Details , collects the request form.
  4. Service Level , collects a tier choice.
  5. Price , turns the selected tier into a total.
  6. Pick a Time , collects the desired booking time.
  7. Quote , presents the priced result.
  8. Checkout , collects payment.
  9. Service , completes the service path.

The Calculator also has a payment-data edge into Quote. That second connection is why the quote can display a calculated line item even though the main user path enters it from Scheduling.

Node configuration and variables​

Nodes publish values for downstream nodes. A variable is only available after the node that produces it has run in the user path. For example:

  • a Work Order Form can publish customer/job fields;
  • Tiers can publish the selected tier;
  • a Calculator can publish serviceTotal;
  • a Conditional can read an upstream value and choose a branch;
  • Quote and Checkout can read payment data from pricing nodes.

If a Conditional or Splitter says a variable is unavailable, move the source node earlier in the path or choose a variable that the current path actually produces.

Read the graph as an execution path

The left-to-right position is a useful visual convention, but the edges are the source of truth. A node can be drawn nearby and still be disconnected; always follow the handles when debugging a flow.