Skip to content
← Back to Index

actors/{actor}/numbering/* ​

Base configuration for entity number series. Sets the default prefix and the per-prefix seed (start number) for a series. For the concepts behind number series, see Number Series.

Path ​

actors/{actor}/numbering/{...scope}

The {...scope} segment identifies the series within the actor:

ActorScopeExample leaf
orderorderactors/order/numbering/order
order → invoiceinvoiceactors/order/numbering/invoice
order → deliverydeliveryactors/order/numbering/delivery
paymentpaymentactors/payment/numbering/payment
ticket (typed){typeKey}actors/ticket/numbering/claim
asset (typed){typeKey}actors/asset/numbering/{typeKey}

For typed actors (asset, ticket) the scope is the type key.

Properties ​

PropertyTypeDescription
defaultPrefixstringDefault prefix for the series. Only honored for typeless entities (order, invoice, delivery, payment). On typed actors it raises a warning.
seedsobjectMap of prefix → start number. Each value must be a positive number. Seeds are global per series and are never channel-overridable.

Prefixes must match a-z only and may optionally end with one of _ . -. Seeds default to 1000 when not configured.

Example ​

yaml
uri: /registry/actors/order/numbering/order
spec:
  value:
    defaultPrefix: O
    seeds:
      O: 1000

A typed actor configuring only seeds (the prefix comes from the type spec):

yaml
uri: /registry/actors/ticket/numbering/claim
spec:
  value:
    seeds:
      CLAIM: 5000

© 2026 Hantera AB. Org. no.: 559242-9582