{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/oneplatform/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Key Concepts","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"key-concepts","__idx":0},"children":["Key Concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page introduces the main One Platform concepts used across customer management, service activation, monitoring, and billing flows."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-concepts","__idx":1},"children":["Core concepts"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Concept"},"children":["Concept"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Organization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operational scope used to manage users, services, and customers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["MyNamirial identity with access to One Platform functions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consumer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entity that can represent a customer, legal entity, partner, or internal unit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contract"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agreement used to activate one or more services for a customer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Business Relation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Link between product, legal entity, customer path, and integrator."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consumption"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usage value recorded for a business relation and product metric."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product Metric"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Definition of what is measured for a product, such as transactions, documents, or volume."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Technical terms such as attributes, counters, and price models are introduced only where they are needed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"customers","__idx":2},"children":["Customers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A customer is an individual or company involved in the buying or selling flow of a Namirial product."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/customer-modularity.36e999f9326dc5c16179f0a2b36b139ac4a19ffdb156f29a85dcc7d111567ba5.d0533b9e.svg","alt":"Customer entity modularity","style":{"border":"1px solid #d0d5dd","borderRadius":"16px","width":"100%"}},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The term includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["direct customers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["indirect customers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["end users"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["resellers"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customer data is organized into these main groups:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data group"},"children":["Data group"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Basic data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Minimum data required for every consumer, such as identifier, name, country, and customer type."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tax information used to define the fiscal status of the customer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Billing data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data required when the customer is billable."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Birth data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Birth information for individual customers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Residence data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Residence information for individual customers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact details"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Emails, PEC addresses, and phone numbers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom data"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product-line-specific metadata and custom attributes."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customer records can represent different commercial roles depending on the relationship with the product or service."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"contracts","__idx":3},"children":["Contracts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A contract is the service activation model for a customer."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/contract-structure.b3e62fc35b8317251dabb6d3c01c2e40826fa9574b07b5153b56f8e49c0c4bc0.d0533b9e.svg","alt":"Contract structure","style":{"border":"1px solid #d0d5dd","borderRadius":"16px","width":"100%"}},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A contract contains the customer context and the services to activate. Each service line can include provisioning data, pricing data, lifecycle state, and the business relation used for metering and billing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contracts are used to support:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["service activation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["digital signing flows"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["product provisioning"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["reporting and billing support"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"consumptions","__idx":4},"children":["Consumptions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A consumption is a set of metric values that represents product usage for a specific business relation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/consumptions-schema.ec596a5a953d7e526ab609a59d5449b66e9eb223e22ceac7fa570503e042d4e4.d0533b9e.svg","alt":"Consumption schema","style":{"border":"1px solid #d0d5dd","borderRadius":"16px","width":"100%"}},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"metrics","__idx":5},"children":["Metrics"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Metrics define what is measured for a product line."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Examples include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["number of documents"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["document size"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["number of transactions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A metric can include a unit of measurement."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"metric-types","__idx":6},"children":["Metric types"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Behavior"},"children":["Behavior"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Incremental"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Values are added to previous consumptions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The latest value replaces the previous total for the same period. Missing totals count as zero."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total persistent"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Similar to total, but keeps using the latest sent consumption until a newer value is available."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"attributes","__idx":7},"children":["Attributes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Attributes describe qualitative dimensions of a consumption."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Business relations answer who made the consumption. Attributes describe what the consumption refers to."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, an Archive product can use attributes to group metrics by document type."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"timestamp-and-datestamp","__idx":8},"children":["Timestamp and datestamp"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Timestamp"]}," identifies when the consumption was made."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Datestamp"]}," identifies the publication date used to group usage by day."]}]}]},"headings":[{"value":"Key Concepts","id":"key-concepts","depth":1},{"value":"Core concepts","id":"core-concepts","depth":2},{"value":"Customers","id":"customers","depth":2},{"value":"Contracts","id":"contracts","depth":2},{"value":"Consumptions","id":"consumptions","depth":2},{"value":"Metrics","id":"metrics","depth":3},{"value":"Metric types","id":"metric-types","depth":3},{"value":"Attributes","id":"attributes","depth":3},{"value":"Timestamp and datestamp","id":"timestamp-and-datestamp","depth":3}],"frontmatter":{"seo":{"title":"Key Concepts"}},"lastModified":"2026-05-14T13:00:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/oneplatform/one-platform-knowledge-center/01-get-started/02-key-concepts/key-concepts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}