metering customer

Author: Guaris

app/_includes/konnect/metering-and-billing/assigned-subjects.md

@@ -0,0 +1,12 @@
+### Assigned subjects
+
+Billable events ingested into OpenMeter always include a `subject`.  
+Subjects represent usage-producing entities within your system.
+
+A customer can have **one or many** subjects assigned, allowing you to group usage and billing.
+
+Example scenario:
+
+* A customer has multiple departments producing usage:  
+  * `department1`  
+  * `department2`

app/metering-and-billing/customer.md

@@ -0,0 +1,82 @@
+---
+title: "Customer"
+content_type: reference
+description: "Learn how Customers work in {{site.konnect_short_name}} Metering and Billing and how they access features."
+layout: reference
+products:
+  - metering-and-billing
+tools:
+    - konnect-api
+works_on:
+  - konnect
+breadcrumbs:
+  - /metering-and-billing/
+related_resources:
+  - text: "{{site.konnect_short_name}} Metering and Billing"
+    url: /metering-and-billing/
+  - text: "Subjects"
+    url: /metering-and-billing/subjects/
+---
+
+## What is a customer?
+
+Customers represent individuals or organizations that subscribe to plans and gain access to features.  
+You can create and manage customers using the API or the Konnect dashboard.
+{% mermaid %}
+flowchart TB
+    %% Left side
+    Customer[Customer]
+    Subject[Subject]
+    UsageEventsLeft[Usage Events]
+
+    Customer -->|1:n| Subject
+    Subject -->|1:n| UsageEventsLeft
+
+    %% Right side
+    ACME[ACME Inc.]
+    Dept1[Department 1]
+    Dept2[Department 2]
+    UsageEvents1[Usage Events]
+    UsageEvents2[Usage Events]
+
+    ACME --> Dept1
+    ACME --> Dept2
+
+    Dept1 --> UsageEvents1
+    Dept2 --> UsageEvents2
+{% endmermaid %}
+
+## Create a customer
+
+When onboarding a customer, you must provide the following information in the request:
+
+{% table %}
+columns:
+  - title: Name
+    key: name
+  - title: Description
+    key: description
+rows:
+  - name: "Name"
+    description: "The name of the customer, for example: `ACME, Inc.`"
+  - name: "Assigned Subject"
+    description: "The [subject](/metering-and-billing/subjects/) associated with the customer."
+{% endtable %}
+
+
+```ts
+const customer = await openmeter.customers.create({
+  name: 'ACME, Inc.',
+  usageAttribution: { subjects: ['my-identifier'] },
+});
+```
+
+{% include_cached /konnect/metering-and-billing/assigned-subjects.md %}
+
+## Schema
+
+[Insert Schema here](https://openmeter.io/docs/api/cloud#tag/customers)
+
+## Set up a Customer
+
+CRUD a subject here

app/metering-and-billing/subjects.md

@@ -58,6 +58,8 @@ For example:
 
 For more information, see **subject assignment** in the Metering and Billing documentation.
 
+{% include_cached /konnect/metering-and-billing/assigned-subjects.md %}
+
 ## Data ingestion
 
 When shipping data to {{site.konnect_short_name}} you must include the subject within the payload: 
@@ -74,6 +76,11 @@ When shipping data to {{site.konnect_short_name}} you must include the subject w
 }
 ```
 
+### One subject during beta
+
+During the billing beta, customers are limited to **one subject**.  
+Support for multiple subjects will be available in the future.
+
 
 ## Schema