Skip to content

ACTORS-COMCommerce Actors

Markdown

ACTORS-COM

Commerce Actors

Markdown
  • DocumentDraft
  • Product intentProposed

KindActorsProduct areaCommerceRevision1

Read atservices-commerce c8b66a98react-console baf6dae3

Actors

IdActorWhoGoalsCan broadlyRepresented bySurfaces
ACT-COM-001Selling configuration administratorA staff administrator maintains selling configuration and authorizes campaign launch and overrides.Keep sale processing aligned with the customer’s billing and payment choices, Prepare appropriate catalog offerings and prices, Control campaign launch and deliberate usage restorationMaintain Commerce configuration while respecting retained dependencies, Activate or resume campaigns and release usage with a reason, Configure supported recommendation and application-flow registrationscommerce.ordering-profiles.*, commerce.stores.*, commerce.tax-zones.* (admin tier writes)commerce.product-categories.*, commerce.product-listings.*, commerce.merchandise.* (admin tier writes)commerce.pricing-audiences.*, commerce.pricing-schedules.*, commerce.product-purchasing-settings.*, commerce.product-extensions.* (admin tier writes)commerce.promotions.activate, commerce.promotions.override (admin tier)commerce.recommendation-rules.*, commerce.recommendation-journeys.* (admin tier writes)console, api
ACT-COM-002Campaign coordinatorA staff coordinator prepares marketing offers and codes and manages stopping actions without launch authority.Prepare campaigns for authorized activation, Distribute claims with appropriate access and capacityDraft, maintain, duplicate, pause, end and archive offers, Maintain individual codes and request generated batchescommerce.promotions.manage (user tier)commerce.promotions.readconsole
ACT-COM-003Order-taking staffA console staff member prepares quotes and sales for contacts or represented organizations.Explain likely payment before order placement, Prepare staff sales beyond the public catalogPreview permitted buyer, audience and date context, Use staff order authority for products excluded by public-sale guardscommerce.price-quotes.readcommerce.orders.createconsole
ACT-COM-004Configuration and campaign readerA read-only staff member reviews selling configuration and campaign outcomes.Inspect selling arrangements and results without changing configurationRead permitted configuration, claims, redemptions and performance, Assess sample promotion carts without persisting a salecommerce.*.read keys of the catalog resourcescommerce.promotions.readcommerce.recommendation-placements.readconsole
ACT-COM-005Authenticated purchaserA signed-in portal contact requests their applicable offering, files and contextual suggestions.Understand the amount applicable to their qualification, Retrieve digital purchases through grants, Respond to permitted contextual offersBrowse and quote for self or a permitted organization, Use authorized file grants within available capacity, Accept or dismiss permitted presentationscommerce.storefront.readcommerce.price-quotes.readcommerce.downloads.readcommerce.offers.read, commerce.offers.respondportal
ACT-COM-006Public shopperA visitor without authentication inspects the public offering and price estimates.Discover available items and public prices before authenticationBrowse active-store public listings and price presentations, Request public quotes and estimated suggestions without accepting estimatesthe public storefront, quote and offer routes (no permission key)portal
ACT-COM-007Product-selling applicationA participating application supplies product-specific selling context, promotion assessment and recommendation registrations.Use the shared pricing and benefit assessment, Identify the application’s qualifying promotion linesSupply item availability and application adjustments, Assess selling-area part criteria, Declare supported placements and registered response flowsthe participant registry and its manifest (service-to-service, no person)api, job
ACT-COM-008Order Operations StaffStaff who investigate placed-order problems and carry out authorized delivery and financial interventions.Explain outstanding order work., Recover or close failures with an accountable result.Inspect delivery, findings, financial adjustments and reversal enforcement., Use authorized approval, holding, recovery, override, resolution and manual-completion operations., Acknowledge or close findings and handle failed financial or enforcement work.commerce.obligations.read, .approve, .override, .reauthorize, .resolve, .hold, .complete-manuallycommerce.exceptions.*commerce.adjustments.*commerce.enforcements.*console orders.operations.*, orders.obligations.*, orders.adjustments.*, orders.enforcements.*console, api
ACT-COM-009Commerce AdministratorCustomer or Rhythm implementation staff who configure delivery and warehouse behavior and administer historical loading.Maintain deliberate delivery and shipping configuration., Reconcile imported Commerce history.Configure and apply delivery policies., Manage shipping coverage, charging strategies, carrier references and stock places., Validate, apply and reconcile collection imports.commerce.fulfillment-policies.*commerce.shipping-zones.*, commerce.shipping-strategies.*, commerce.carrier-accounts.*commerce.inventory.* (administrator tier)the bulk key of each loaded collectionapi
ACT-COM-010Warehouse StaffStaff who prepare and hand over goods, process physical returns and account for shelf quantities.Dispatch the units belonging to the buyer., Retain accurate physical-stock records.Create and progress shipment and picking work through physical departure., Record authorized receipt, inspection and return disposition., Enter permitted stock movements, transfers and counts.commerce.shipments.read, .create, .update, .handoff (.handover and .cancel are administrator tier)commerce.pick-lists.*commerce.return-receipts.*commerce.inventory.create, .update (administrator tier today)api, console
ACT-COM-011Delivering ApplicationA registered application service responsible for producing the result owed by a sold line.Recognize repeated delivery instructions safely., Retain progress and final delivery outcomes.Handle delivery and post-sale change instructions., Report authorized completion, failure and prerequisite readiness.commerce.obligations.callback (staff-only, held at platform scope by the application’s service identity)api, job
ACT-COM-012AccountingThe financial application that supplies receivable changes and executes Commerce-requested financial steps.Publish financial changes affecting order eligibility., Preserve command identity during financial execution.Send affected-line financial facts., Execute invoicing, memo, credit, application and refund commands.IAM invocation of commerce_financial_factsAccounting’s service functions called by Commercejob
ACT-COM-013Commerce SchedulerBackground execution that dispatches delivery and data jobs and checks Commerce records for stalled or inconsistent work.Progress eligible work automatically., Report conditions requiring staff investigation.Run due dispatch and reconciliation work., Resume work through its owning process and retain detected findings., Expire eligible stock holds.system context with the sweep policiesjob
ACT-COM-014Sales ClerkStaff who assemble customer purchases and coordinate their payment through the console.Prepare a correctly priced customer purchase, Complete payment or terms acceptanceBuild carts for contacts and organizations, Place sales and record a staff purchasing-role override, Take card, check, cash, store-credit or terms tender, Submit customer cancellations, amendments and returnscommerce.checkouts.createcommerce.checkouts.updatecommerce.orders.createcommerce.orders.tendercommerce.orders.readcommerce.cancellations.createcommerce.amendments.createcommerce.returns.createconsole
ACT-COM-015Commerce ReviewerStaff who inspect purchasing and benefit records using read permissions.Explain a customer purchase, Review sales activity and outstanding balancesInspect carts, sales, after-sale documents and benefits, Inspect vendor purchasing and inventory valuecommerce.checkouts.readcommerce.orders.readcommerce.cancellations.readcommerce.amendments.readcommerce.returns.readcommerce.entitlements.readcommerce.purchasing.readcommerce.inventory-costing.readconsole, api
ACT-COM-016Commerce ManagerStaff who administer order interventions, benefit grants and return policies; support attribution uses the recorded support model.Resolve purchases that cannot complete, Record justified exceptionsVoid purchases before acceptance, Approve, refuse or override after-sale requests, Apply promotions after placement, Grant, restore or revoke benefit rights, Maintain return policiescommerce.orders.voidcommerce.cancellations.approvecommerce.cancellations.overridecommerce.amendments.approvecommerce.amendments.overridecommerce.amendments.apply-promotioncommerce.returns.approvecommerce.returns.overridecommerce.return-policies.createcommerce.return-policies.deletecommerce.entitlements.restorecommerce.entitlements.grantcommerce.entitlements.revokeRhythm support identity (rhythm-admin) under Platform's standing Administrator grant (COMM-M2 M2-S2)console
ACT-COM-017Member BuyerA proposed portal purchaser acting for themselves or an organization where they hold the purchasing role; the storefront remains deferred.Complete their purchase and payment, Use the benefits they acquirePrepare and place carts for their purchasing party, Tender their purchases by card, store credit or terms, Request allowed after-sale changes, Inspect and consume their own grantscommerce.checkouts.createcommerce.checkouts.updatecommerce.orders.createcommerce.orders.tendercommerce.orders.readcommerce.entitlements.readportal access, own records onlyportal
ACT-COM-018Product-Owning ApplicationAn application participating in Commerce sales for its product types, including Membership and Commerce’s built-in participants.Use the shared purchasing contract, Fulfill the accepted purchaseDeclare its supported product types, Evaluate and prepare items and secure limited availability, Perform delivery and product-specific reversal or amendmentthe commerce-participant-registration-invoke policy on its deploy rolecommerce.obligations.callback (platform scope)api, job
ACT-COM-019Stock BuyerStaff who acquire vendor stock, record incoming deliveries and maintain acquisition cost.Acquire the stock required for sales, Explain inventory valueMaintain supplier and purchase-order records, Record incoming stock with landed cost, Correct cost layers and select the costing methodcommerce.purchasing.createcommerce.purchasing.updatecommerce.purchasing.deletecommerce.inventory-costing.updateapi

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.