@epilot/sdk 2.11.4 → 2.11.6

package/docs/billing.md

@@ -37,26 +37,54 @@ const { data } = await billingClient.getBillingEvents(...)
 - [`updateContractEntity`](#updatecontractentity)
 - [`deleteContractEntity`](#deletecontractentity)
 
+**Pricing Information**
+- [`getContractPricingInformation`](#getcontractpricinginformation)
+- [`getBillingAccountPricingInformation`](#getbillingaccountpricinginformation)
+
+**Configuration History**
+- [`getContractConfigurationHistory`](#getcontractconfigurationhistory)
+- [`getBillingAccountConfigurationHistory`](#getbillingaccountconfigurationhistory)
+
 **Balance**
 - [`getCustomerBalance`](#getcustomerbalance)
 
 **Schemas**
+- [`Error`](#error)
 - [`BaseEntity`](#baseentity)
 - [`EntityId`](#entityid)
 - [`EntitySlug`](#entityslug)
 - [`EntityRelationItem`](#entityrelationitem)
 - [`BaseBillingEvent`](#basebillingevent)
+- [`BillingEvent`](#billingevent)
+- [`BillingEventUpdate`](#billingeventupdate)
 - [`InstallmentEvent`](#installmentevent)
+- [`PaymentEvent`](#paymentevent)
 - [`ReimbursementEvent`](#reimbursementevent)
-- [`BillingEvent`](#billingevent)
+- [`DunningFeeEvent`](#dunningfeeevent)
+- [`InvoiceEvent`](#invoiceevent)
+- [`FinalBillEvent`](#finalbillevent)
+- [`BonusEvent`](#bonusevent)
+- [`CorrectionEvent`](#correctionevent)
+- [`CustomEvent`](#customevent)
 - [`Contract`](#contract)
 - [`ContractItem`](#contractitem)
+- [`InstallmentAmountValue`](#installmentamountvalue)
+- [`PriceContext`](#pricecontext)
+- [`DynamicTariffPriceContext`](#dynamictariffpricecontext)
+- [`ConfigurationHistoryContext`](#configurationhistorycontext)
+- [`ConfigurationHistoryRow`](#configurationhistoryrow)
+- [`ConfigurationHistoryResponse`](#configurationhistoryresponse)
+- [`PricingInformationBalance`](#pricinginformationbalance)
+- [`ContractPricingSchedule`](#contractpricingschedule)
+- [`ContractPricingInformation`](#contractpricinginformation)
+- [`BillingAccountPricingInformation`](#billingaccountpricinginformation)
 - [`Balance`](#balance)
 - [`Currency`](#currency)
 
 ### `getBillingEvents`
 
-Get and filter billing events such as installments and reimbursements.
+Retrieve and filter billing events (Buchungssätze) such as installments (Abschlagszahlungen),
+payments (Zahlungseingänge), and reimbursements (Rückerstattungen).
 
 `GET /v1/billing/events`
 
@@ -65,6 +93,7 @@ const { data } = await client.getBillingEvents({
   from: 1,
   size: 1,
   entity_id: ['...'],
+  contact_id: 'example',
   event_type: 'example',
   date_after: 'example',
   date_before: 'example',
@@ -76,30 +105,18 @@ const { data } = await client.getBillingEvents({
 
 ```json
 {
-  "hits": 0,
+  "hits": 42,
   "results": [
     {
-      "billing_amount": 10050,
-      "billing_amount_decimal": "100.50",
-      "billing_currency": "EUR",
-      "external_id": "d4fb2a4e-3f74-4fc4-8fba-6fdaaaa3b08e",
-      "contract": {
-        "$relation": [
-          {
-            "entity_id": "f589786b-3024-43cd-9cb3-5a3c953f2896"
-          }
-        ]
-      },
-      "_id": "5da0a718-c822-403d-9f5d-20d4584e0528",
-      "_title": "string",
-      "_org": "string",
-      "_schema": "contact",
-      "_tags": ["string"],
-      "_created_at": "string",
-      "_updated_at": "string",
       "type": "installment",
-      "due_date": "1970-01-01T00:00:00.000Z",
-      "paid_date": "1970-01-01T00:00:00.000Z"
+      "direction": "debit",
+      "note": "July power & gas installment payment",
+      "status": "open",
+      "booking_date": "2025-07-10",
+      "due_date": "2025-07-10",
+      "billing_amount": 5000,
+      "billing_amount_decimal": "50.00",
+      "billing_currency": "EUR"
     }
   ]
 }
@@ -111,7 +128,8 @@ const { data } = await client.getBillingEvents({
 
 ### `createBillingEvent`
 
-Create a new billing event.
+Create a new billing event (Buchungssatz) such as an installment (Abschlagszahlung),
+payment (Zahlungseingang), or reimbursement (Rückerstattung).
 
 `POST /v1/billing/events`
 
@@ -119,27 +137,15 @@ Create a new billing event.
 const { data } = await client.createBillingEvent(
   null,
   {
-    billing_amount: 10050,
-    billing_amount_decimal: '100.50',
-    billing_currency: 'EUR',
-    external_id: 'd4fb2a4e-3f74-4fc4-8fba-6fdaaaa3b08e',
-    contract: {
-      $relation: [
-        {
-          entity_id: 'f589786b-3024-43cd-9cb3-5a3c953f2896'
-        }
-      ]
-    },
-    _id: '5da0a718-c822-403d-9f5d-20d4584e0528',
-    _title: 'string',
-    _org: 'string',
-    _schema: 'contact',
-    _tags: ['string'],
-    _created_at: 'string',
-    _updated_at: 'string',
     type: 'installment',
-    due_date: '1970-01-01T00:00:00.000Z',
-    paid_date: '1970-01-01T00:00:00.000Z'
+    direction: 'debit',
+    note: 'July power & gas installment payment',
+    status: 'open',
+    booking_date: '2025-07-10',
+    due_date: '2025-07-10',
+    billing_amount: 5000,
+    billing_amount_decimal: '50.00',
+    billing_currency: 'EUR'
   },
 )
 ```
@@ -149,27 +155,15 @@ const { data } = await client.createBillingEvent(
 
 ```json
 {
-  "billing_amount": 10050,
-  "billing_amount_decimal": "100.50",
-  "billing_currency": "EUR",
-  "external_id": "d4fb2a4e-3f74-4fc4-8fba-6fdaaaa3b08e",
-  "contract": {
-    "$relation": [
-      {
-        "entity_id": "f589786b-3024-43cd-9cb3-5a3c953f2896"
-      }
-    ]
-  },
-  "_id": "5da0a718-c822-403d-9f5d-20d4584e0528",
-  "_title": "string",
-  "_org": "string",
-  "_schema": "contact",
-  "_tags": ["string"],
-  "_created_at": "string",
-  "_updated_at": "string",
   "type": "installment",
-  "due_date": "1970-01-01T00:00:00.000Z",
-  "paid_date": "1970-01-01T00:00:00.000Z"
+  "direction": "debit",
+  "note": "July power & gas installment payment",
+  "status": "open",
+  "booking_date": "2025-07-10",
+  "due_date": "2025-07-10",
+  "billing_amount": 5000,
+  "billing_amount_decimal": "50.00",
+  "billing_currency": "EUR"
 }
 ```
 
@@ -179,7 +173,7 @@ const { data } = await client.createBillingEvent(
 
 ### `getBillingEvent`
 
-Get a single billing event by ID.
+Retrieve a single billing event (Buchungssatz) by its unique ID.
 
 `GET /v1/billing/events/{id}`
 
@@ -194,27 +188,15 @@ const { data } = await client.getBillingEvent({
 
 ```json
 {
-  "billing_amount": 10050,
-  "billing_amount_decimal": "100.50",
-  "billing_currency": "EUR",
-  "external_id": "d4fb2a4e-3f74-4fc4-8fba-6fdaaaa3b08e",
-  "contract": {
-    "$relation": [
-      {
-        "entity_id": "f589786b-3024-43cd-9cb3-5a3c953f2896"
-      }
-    ]
-  },
-  "_id": "5da0a718-c822-403d-9f5d-20d4584e0528",
-  "_title": "string",
-  "_org": "string",
-  "_schema": "contact",
-  "_tags": ["string"],
-  "_created_at": "string",
-  "_updated_at": "string",
   "type": "installment",
-  "due_date": "1970-01-01T00:00:00.000Z",
-  "paid_date": "1970-01-01T00:00:00.000Z"
+  "direction": "debit",
+  "note": "July power & gas installment payment",
+  "status": "open",
+  "booking_date": "2025-07-10",
+  "due_date": "2025-07-10",
+  "billing_amount": 5000,
+  "billing_amount_decimal": "50.00",
+  "billing_currency": "EUR"
 }
 ```
 
@@ -224,7 +206,7 @@ const { data } = await client.getBillingEvent({
 
 ### `updateBillingEvent`
 
-Update an existing billing event.
+Update an existing billing event (Buchungssatz).
 
 `PATCH /v1/billing/events/{id}`
 
@@ -234,10 +216,12 @@ const { data } = await client.updateBillingEvent(
     id: '123e4567-e89b-12d3-a456-426614174000',
   },
   {
-    billing_amount: 10050,
-    billing_amount_decimal: '100.50',
+    type: 'installment',
+    direction: 'debit',
+    billing_amount: 10000,
+    billing_amount_decimal: '100.00',
     billing_currency: 'EUR',
-    external_id: 'd4fb2a4e-3f74-4fc4-8fba-6fdaaaa3b08e',
+    external_id: 'SAP-54321',
     contract: {
       $relation: [
         {
@@ -245,16 +229,24 @@ const { data } = await client.updateBillingEvent(
         }
       ]
     },
-    _id: '5da0a718-c822-403d-9f5d-20d4584e0528',
-    _title: 'string',
-    _org: 'string',
-    _schema: 'contact',
-    _tags: ['string'],
-    _created_at: 'string',
-    _updated_at: 'string',
-    type: 'installment',
-    due_date: '1970-01-01T00:00:00.000Z',
-    paid_date: '1970-01-01T00:00:00.000Z'
+    booking_date: '2025-06-15',
+    due_date: '2025-06-30',
+    paid_date: '2025-06-15T10:00:00Z',
+    status: 'closed',
+    related_event: 'd4fb2a4e-3f74-4fc4-8fba-6fdaaaa3b08e',
+    external_link: {
+      href: 'https://billing.example.com/invoices/12345',
+      title: 'Invoice 12345'
+    },
+    attachments: {
+      $relation: [
+        {
+          entity_id: 'f589786b-3024-43cd-9cb3-5a3c953f2896'
+        }
+      ]
+    },
+    note: 'Teilzahlung für Abschlag Juni',
+    internal_note: 'Rückmeldung von SAP: Betrag aus Zahlungsavis 2025-06-14 übernommen'
   },
 )
 ```
@@ -264,27 +256,15 @@ const { data } = await client.updateBillingEvent(
 
 ```json
 {
-  "billing_amount": 10050,
-  "billing_amount_decimal": "100.50",
-  "billing_currency": "EUR",
-  "external_id": "d4fb2a4e-3f74-4fc4-8fba-6fdaaaa3b08e",
-  "contract": {
-    "$relation": [
-      {
-        "entity_id": "f589786b-3024-43cd-9cb3-5a3c953f2896"
-      }
-    ]
-  },
-  "_id": "5da0a718-c822-403d-9f5d-20d4584e0528",
-  "_title": "string",
-  "_org": "string",
-  "_schema": "contact",
-  "_tags": ["string"],
-  "_created_at": "string",
-  "_updated_at": "string",
   "type": "installment",
-  "due_date": "1970-01-01T00:00:00.000Z",
-  "paid_date": "1970-01-01T00:00:00.000Z"
+  "direction": "debit",
+  "note": "July power & gas installment payment",
+  "status": "open",
+  "booking_date": "2025-07-10",
+  "due_date": "2025-07-10",
+  "billing_amount": 5000,
+  "billing_amount_decimal": "50.00",
+  "billing_currency": "EUR"
 }
 ```
 
@@ -294,7 +274,7 @@ const { data } = await client.updateBillingEvent(
 
 ### `deleteBillingEvent`
 
-Delete an existing billing event.
+Delete an existing billing event (Buchungssatz).
 
 `DELETE /v1/billing/events/{id}`
 
@@ -308,7 +288,7 @@ const { data } = await client.deleteBillingEvent({
 
 ### `getBillingEventByExternalId`
 
-Get a single billing event by External ID.
+Retrieve a billing event (Buchungssatz) by its external system identifier.
 
 `GET /v1/billing/external/{external_id}`
 
@@ -323,27 +303,15 @@ const { data } = await client.getBillingEventByExternalId({
 
 ```json
 {
-  "billing_amount": 10050,
-  "billing_amount_decimal": "100.50",
-  "billing_currency": "EUR",
-  "external_id": "d4fb2a4e-3f74-4fc4-8fba-6fdaaaa3b08e",
-  "contract": {
-    "$relation": [
-      {
-        "entity_id": "f589786b-3024-43cd-9cb3-5a3c953f2896"
-      }
-    ]
-  },
-  "_id": "5da0a718-c822-403d-9f5d-20d4584e0528",
-  "_title": "string",
-  "_org": "string",
-  "_schema": "contact",
-  "_tags": ["string"],
-  "_created_at": "string",
-  "_updated_at": "string",
   "type": "installment",
-  "due_date": "1970-01-01T00:00:00.000Z",
-  "paid_date": "1970-01-01T00:00:00.000Z"
+  "direction": "debit",
+  "note": "July power & gas installment payment",
+  "status": "open",
+  "booking_date": "2025-07-10",
+  "due_date": "2025-07-10",
+  "billing_amount": 5000,
+  "billing_amount_decimal": "50.00",
+  "billing_currency": "EUR"
 }
 ```
 
@@ -353,7 +321,7 @@ const { data } = await client.getBillingEventByExternalId({
 
 ### `createContractEntity`
 
-Create a new contract entity.
+Create a new contract entity (Vertrag) for billing purposes.
 
 `POST /v1/billing/contracts`
 
@@ -362,32 +330,32 @@ const { data } = await client.createContractEntity(
   null,
   {
     _id: '5da0a718-c822-403d-9f5d-20d4584e0528',
-    _title: 'string',
-    _org: 'string',
-    _schema: 'contact',
-    _tags: ['string'],
-    _created_at: 'string',
-    _updated_at: 'string',
-    contract_name: 'Grid Contract',
-    contract_number: '12345',
-    status: 'approved',
-    description: 'This contract is for the supply of widgets.',
-    account_number: '67890',
+    _title: 'Abschlagszahlung Juli 2025',
+    _org: '123456',
+    _schema: 'billing_event',
+    _tags: ['billing', 'energy'],
+    _created_at: '2025-06-15T10:30:00Z',
+    _updated_at: '2025-06-15T14:45:00Z',
+    contract_name: 'Stromvertrag Haushalt',
+    contract_number: 'STR-2025-001234',
+    status: 'active',
+    description: 'Haushaltsstrom-Tarif mit 24 Monaten Preisgarantie',
+    account_number: 'KD-67890',
     branch: 'power',
-    billing_address: '123 Main St, Anytown',
-    delivery_address: '456 Elm St, Anytown',
-    additional_addresses: '789 Oak St, Anytown',
-    termination_date: '2022-01-01',
-    termination_reason: 'Non-payment',
+    billing_address: 'Musterstraße 123, 50667 Köln',
+    delivery_address: 'Musterstraße 123, 50667 Köln',
+    additional_addresses: 'Postfach 456, 50668 Köln',
+    termination_date: '2025-12-31',
+    termination_reason: 'Kundenkündigung',
     billing_period: 'monthly',
     billing_duration_amount: 30,
-    renewal_duration_amount: 365,
-    renewal_duration_unit: 'years',
+    renewal_duration_amount: 12,
+    renewal_duration_unit: 'months',
     notice_time_amount: 30,
     notice_time_unit: 'months',
-    start_date: '2021-01-01',
-    billing_due_day: 2,
-    installment_amount: 10050,
+    start_date: '2025-01-01',
+    billing_due_day: 15,
+    installment_amount: 8500,
     balance: 8990,
     balance_currency: 'EUR'
   },
@@ -400,32 +368,32 @@ const { data } = await client.createContractEntity(
 ```json
 {
   "_id": "5da0a718-c822-403d-9f5d-20d4584e0528",
-  "_title": "string",
-  "_org": "string",
-  "_schema": "contact",
-  "_tags": ["string"],
-  "_created_at": "string",
-  "_updated_at": "string",
-  "contract_name": "Grid Contract",
-  "contract_number": "12345",
-  "status": "approved",
-  "description": "This contract is for the supply of widgets.",
-  "account_number": "67890",
+  "_title": "Abschlagszahlung Juli 2025",
+  "_org": "123456",
+  "_schema": "billing_event",
+  "_tags": ["billing", "energy"],
+  "_created_at": "2025-06-15T10:30:00Z",
+  "_updated_at": "2025-06-15T14:45:00Z",
+  "contract_name": "Stromvertrag Haushalt",
+  "contract_number": "STR-2025-001234",
+  "status": "active",
+  "description": "Haushaltsstrom-Tarif mit 24 Monaten Preisgarantie",
+  "account_number": "KD-67890",
   "branch": "power",
-  "billing_address": "123 Main St, Anytown",
-  "delivery_address": "456 Elm St, Anytown",
-  "additional_addresses": "789 Oak St, Anytown",
-  "termination_date": "2022-01-01",
-  "termination_reason": "Non-payment",
+  "billing_address": "Musterstraße 123, 50667 Köln",
+  "delivery_address": "Musterstraße 123, 50667 Köln",
+  "additional_addresses": "Postfach 456, 50668 Köln",
+  "termination_date": "2025-12-31",
+  "termination_reason": "Kundenkündigung",
   "billing_period": "monthly",
   "billing_duration_amount": 30,
-  "renewal_duration_amount": 365,
-  "renewal_duration_unit": "years",
+  "renewal_duration_amount": 12,
+  "renewal_duration_unit": "months",
   "notice_time_amount": 30,
   "notice_time_unit": "months",
-  "start_date": "2021-01-01",
-  "billing_due_day": 2,
-  "installment_amount": 10050,
+  "start_date": "2025-01-01",
+  "billing_due_day": 15,
+  "installment_amount": 8500,
   "balance": 8990,
   "balance_currency": "EUR"
 }
@@ -437,7 +405,7 @@ const { data } = await client.createContractEntity(
 
 ### `updateContractEntity`
 
-Update an existing contract entity.
+Update an existing contract entity (Vertrag).
 
 `PATCH /v1/billing/contracts/{id}`
 
@@ -448,32 +416,32 @@ const { data } = await client.updateContractEntity(
   },
   {
     _id: '5da0a718-c822-403d-9f5d-20d4584e0528',
-    _title: 'string',
-    _org: 'string',
-    _schema: 'contact',
-    _tags: ['string'],
-    _created_at: 'string',
-    _updated_at: 'string',
-    contract_name: 'Grid Contract',
-    contract_number: '12345',
-    status: 'approved',
-    description: 'This contract is for the supply of widgets.',
-    account_number: '67890',
+    _title: 'Abschlagszahlung Juli 2025',
+    _org: '123456',
+    _schema: 'billing_event',
+    _tags: ['billing', 'energy'],
+    _created_at: '2025-06-15T10:30:00Z',
+    _updated_at: '2025-06-15T14:45:00Z',
+    contract_name: 'Stromvertrag Haushalt',
+    contract_number: 'STR-2025-001234',
+    status: 'active',
+    description: 'Haushaltsstrom-Tarif mit 24 Monaten Preisgarantie',
+    account_number: 'KD-67890',
     branch: 'power',
-    billing_address: '123 Main St, Anytown',
-    delivery_address: '456 Elm St, Anytown',
-    additional_addresses: '789 Oak St, Anytown',
-    termination_date: '2022-01-01',
-    termination_reason: 'Non-payment',
+    billing_address: 'Musterstraße 123, 50667 Köln',
+    delivery_address: 'Musterstraße 123, 50667 Köln',
+    additional_addresses: 'Postfach 456, 50668 Köln',
+    termination_date: '2025-12-31',
+    termination_reason: 'Kundenkündigung',
     billing_period: 'monthly',
     billing_duration_amount: 30,
-    renewal_duration_amount: 365,
-    renewal_duration_unit: 'years',
+    renewal_duration_amount: 12,
+    renewal_duration_unit: 'months',
     notice_time_amount: 30,
     notice_time_unit: 'months',
-    start_date: '2021-01-01',
-    billing_due_day: 2,
-    installment_amount: 10050,
+    start_date: '2025-01-01',
+    billing_due_day: 15,
+    installment_amount: 8500,
     balance: 8990,
     balance_currency: 'EUR'
   },
@@ -486,32 +454,32 @@ const { data } = await client.updateContractEntity(
 ```json
 {
   "_id": "5da0a718-c822-403d-9f5d-20d4584e0528",
-  "_title": "string",
-  "_org": "string",
-  "_schema": "contact",
-  "_tags": ["string"],
-  "_created_at": "string",
-  "_updated_at": "string",
-  "contract_name": "Grid Contract",
-  "contract_number": "12345",
-  "status": "approved",
-  "description": "This contract is for the supply of widgets.",
-  "account_number": "67890",
+  "_title": "Abschlagszahlung Juli 2025",
+  "_org": "123456",
+  "_schema": "billing_event",
+  "_tags": ["billing", "energy"],
+  "_created_at": "2025-06-15T10:30:00Z",
+  "_updated_at": "2025-06-15T14:45:00Z",
+  "contract_name": "Stromvertrag Haushalt",
+  "contract_number": "STR-2025-001234",
+  "status": "active",
+  "description": "Haushaltsstrom-Tarif mit 24 Monaten Preisgarantie",
+  "account_number": "KD-67890",
   "branch": "power",
-  "billing_address": "123 Main St, Anytown",
-  "delivery_address": "456 Elm St, Anytown",
-  "additional_addresses": "789 Oak St, Anytown",
-  "termination_date": "2022-01-01",
-  "termination_reason": "Non-payment",
+  "billing_address": "Musterstraße 123, 50667 Köln",
+  "delivery_address": "Musterstraße 123, 50667 Köln",
+  "additional_addresses": "Postfach 456, 50668 Köln",
+  "termination_date": "2025-12-31",
+  "termination_reason": "Kundenkündigung",
   "billing_period": "monthly",
   "billing_duration_amount": 30,
-  "renewal_duration_amount": 365,
-  "renewal_duration_unit": "years",
+  "renewal_duration_amount": 12,
+  "renewal_duration_unit": "months",
   "notice_time_amount": 30,
   "notice_time_unit": "months",
-  "start_date": "2021-01-01",
-  "billing_due_day": 2,
-  "installment_amount": 10050,
+  "start_date": "2025-01-01",
+  "billing_due_day": 15,
+  "installment_amount": 8500,
   "balance": 8990,
   "balance_currency": "EUR"
 }
@@ -523,7 +491,7 @@ const { data } = await client.updateContractEntity(
 
 ### `deleteContractEntity`
 
-Delete an existing contract entity.
+Delete an existing contract entity (Vertrag).
 
 `DELETE /v1/billing/contracts/{id}`
 
@@ -535,9 +503,384 @@ const { data } = await client.deleteContractEntity({
 
 ---
 
+### `getContractPricingInformation`
+
+Get current pricing information and recent configuration history for a Contract.
+
+`GET /v1/billing/contracts/{id}/pricing_information`
+
+```ts
+const { data } = await client.getContractPricingInformation({
+  id: '123e4567-e89b-12d3-a456-426614174000',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "entity_type": "contract",
+  "entity_id": "string",
+  "title": "string",
+  "current_installment_amount": {
+    "amount": 10050,
+    "amount_decimal": "100.50",
+    "currency": "EUR"
+  },
+  "context": {
+    "base_price": {
+      "price_id": "string",
+      "price_title": "string",
+      "pricing_model": "string",
+      "unit_amount_gross_decimal": "string",
+      "unit_amount_net_decimal": "string",
+      "before_discount_unit_amount_gross_decimal": "string",
+      "before_discount_unit_amount_net_decimal": "string",
+      "unit_discount_amount_decimal": "string",
+      "unit_discount_amount_net_decimal": "string",
+      "currency": "EUR",
+      "billing_period": "string",
+      "unit": "string",
+      "has_discount": true,
+      "is_dynamic_tariff": true,
+      "dynamic_tariff": {}
+    },
+    "working_price": {
+      "price_id": "string",
+      "price_title": "string",
+      "pricing_model": "string",
+      "unit_amount_gross_decimal": "string",
+      "unit_amount_net_decimal": "string",
+      "before_discount_unit_amount_gross_decimal": "string",
+      "before_discount_unit_amount_net_decimal": "string",
+      "unit_discount_amount_decimal": "string",
+      "unit_discount_amount_net_decimal": "string",
+      "currency": "EUR",
+      "billing_period": "string",
+      "unit": "string",
+      "has_discount": true,
+      "is_dynamic_tariff": true,
+      "dynamic_tariff": {}
+    }
+  },
+  "balance": {
+    "amount": 8990,
+    "amount_decimal": "89.90",
+    "currency": "EUR"
+  },
+  "schedule": {
+    "billing_due_day": 0,
+    "billing_period": "weekly",
+    "installments_per_year": 0,
+    "inferred": true
+  },
+  "pending_installment_change": true,
+  "history": [
+    {
+      "event_id": "string",
+      "org_id": "string",
+      "entity_type": "contract",
+      "entity_id": "string",
+      "change_type": "installment_amount_changed",
+      "schema_version": 1,
+      "effective_at": "1970-01-01T00:00:00.000Z",
+      "changed_at": "1970-01-01T00:00:00.000Z",
+      "created_at": "1970-01-01T00:00:00.000Z",
+      "source": "portal",
+      "source_label": "string",
+      "source_system": "string",
+      "source_reference": "string",
+      "previous_value": {},
+      "new_value": {},
+      "context": {}
+    }
+  ]
+}
+```
+
+</details>
+
+---
+
+### `getBillingAccountPricingInformation`
+
+Get current pricing information for the active Contracts linked to a Billing Account.
+
+`GET /v1/billing/billing_accounts/{id}/pricing_information`
+
+```ts
+const { data } = await client.getBillingAccountPricingInformation({
+  id: '123e4567-e89b-12d3-a456-426614174000',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "entity_type": "billing_account",
+  "entity_id": "string",
+  "title": "string",
+  "balance": {
+    "amount": 8990,
+    "amount_decimal": "89.90",
+    "currency": "EUR"
+  },
+  "contracts": [
+    {
+      "entity_type": "contract",
+      "entity_id": "string",
+      "title": "string",
+      "current_installment_amount": {},
+      "context": {},
+      "balance": {},
+      "schedule": {},
+      "pending_installment_change": true,
+      "history": []
+    }
+  ]
+}
+```
+
+</details>
+
+---
+
+### `getContractConfigurationHistory`
+
+Get billing configuration history for a Contract.
+
+`GET /v1/billing/contracts/{id}/configuration_history`
+
+```ts
+const { data } = await client.getContractConfigurationHistory({
+  id: '123e4567-e89b-12d3-a456-426614174000',
+  change_type: 'example',
+  from: 1,
+  size: 1,
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "history": [
+    {
+      "event_id": "string",
+      "org_id": "string",
+      "entity_type": "contract",
+      "entity_id": "string",
+      "change_type": "installment_amount_changed",
+      "schema_version": 1,
+      "effective_at": "1970-01-01T00:00:00.000Z",
+      "changed_at": "1970-01-01T00:00:00.000Z",
+      "created_at": "1970-01-01T00:00:00.000Z",
+      "source": "portal",
+      "source_label": "string",
+      "source_system": "string",
+      "source_reference": "string",
+      "previous_value": {
+        "amount": 10050,
+        "amount_decimal": "100.50",
+        "currency": "EUR"
+      },
+      "new_value": {
+        "amount": 10050,
+        "amount_decimal": "100.50",
+        "currency": "EUR"
+      },
+      "context": {
+        "base_price": {
+          "price_id": "string",
+          "price_title": "string",
+          "pricing_model": "string",
+          "unit_amount_gross_decimal": "string",
+          "unit_amount_net_decimal": "string",
+          "before_discount_unit_amount_gross_decimal": "string",
+          "before_discount_unit_amount_net_decimal": "string",
+          "unit_discount_amount_decimal": "string",
+          "unit_discount_amount_net_decimal": "string",
+          "currency": "EUR",
+          "billing_period": "string",
+          "unit": "string",
+          "has_discount": true,
+          "is_dynamic_tariff": true,
+          "dynamic_tariff": {
+            "mode": "string",
+            "interval": "string",
+            "average_price_decimal": "string",
+            "markup_amount_decimal": "string",
+            "markup_amount_net_decimal": "string",
+            "markup_amount_gross_decimal": "string",
+            "market_price_decimal": "string",
+            "market_price_currency": "EUR",
+            "market": "string",
+            "bidding_zone": "string",
+            "timestamp": "string"
+          }
+        },
+        "working_price": {
+          "price_id": "string",
+          "price_title": "string",
+          "pricing_model": "string",
+          "unit_amount_gross_decimal": "string",
+          "unit_amount_net_decimal": "string",
+          "before_discount_unit_amount_gross_decimal": "string",
+          "before_discount_unit_amount_net_decimal": "string",
+          "unit_discount_amount_decimal": "string",
+          "unit_discount_amount_net_decimal": "string",
+          "currency": "EUR",
+          "billing_period": "string",
+          "unit": "string",
+          "has_discount": true,
+          "is_dynamic_tariff": true,
+          "dynamic_tariff": {
+            "mode": "string",
+            "interval": "string",
+            "average_price_decimal": "string",
+            "markup_amount_decimal": "string",
+            "markup_amount_net_decimal": "string",
+            "markup_amount_gross_decimal": "string",
+            "market_price_decimal": "string",
+            "market_price_currency": "EUR",
+            "market": "string",
+            "bidding_zone": "string",
+            "timestamp": "string"
+          }
+        }
+      }
+    }
+  ],
+  "total": 0
+}
+```
+
+</details>
+
+---
+
+### `getBillingAccountConfigurationHistory`
+
+Get merged billing configuration history for active Contracts linked to a Billing Account.
+
+`GET /v1/billing/billing_accounts/{id}/configuration_history`
+
+```ts
+const { data } = await client.getBillingAccountConfigurationHistory({
+  id: '123e4567-e89b-12d3-a456-426614174000',
+  change_type: 'example',
+  from: 1,
+  size: 1,
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "history": [
+    {
+      "event_id": "string",
+      "org_id": "string",
+      "entity_type": "contract",
+      "entity_id": "string",
+      "change_type": "installment_amount_changed",
+      "schema_version": 1,
+      "effective_at": "1970-01-01T00:00:00.000Z",
+      "changed_at": "1970-01-01T00:00:00.000Z",
+      "created_at": "1970-01-01T00:00:00.000Z",
+      "source": "portal",
+      "source_label": "string",
+      "source_system": "string",
+      "source_reference": "string",
+      "previous_value": {
+        "amount": 10050,
+        "amount_decimal": "100.50",
+        "currency": "EUR"
+      },
+      "new_value": {
+        "amount": 10050,
+        "amount_decimal": "100.50",
+        "currency": "EUR"
+      },
+      "context": {
+        "base_price": {
+          "price_id": "string",
+          "price_title": "string",
+          "pricing_model": "string",
+          "unit_amount_gross_decimal": "string",
+          "unit_amount_net_decimal": "string",
+          "before_discount_unit_amount_gross_decimal": "string",
+          "before_discount_unit_amount_net_decimal": "string",
+          "unit_discount_amount_decimal": "string",
+          "unit_discount_amount_net_decimal": "string",
+          "currency": "EUR",
+          "billing_period": "string",
+          "unit": "string",
+          "has_discount": true,
+          "is_dynamic_tariff": true,
+          "dynamic_tariff": {
+            "mode": "string",
+            "interval": "string",
+            "average_price_decimal": "string",
+            "markup_amount_decimal": "string",
+            "markup_amount_net_decimal": "string",
+            "markup_amount_gross_decimal": "string",
+            "market_price_decimal": "string",
+            "market_price_currency": "EUR",
+            "market": "string",
+            "bidding_zone": "string",
+            "timestamp": "string"
+          }
+        },
+        "working_price": {
+          "price_id": "string",
+          "price_title": "string",
+          "pricing_model": "string",
+          "unit_amount_gross_decimal": "string",
+          "unit_amount_net_decimal": "string",
+          "before_discount_unit_amount_gross_decimal": "string",
+          "before_discount_unit_amount_net_decimal": "string",
+          "unit_discount_amount_decimal": "string",
+          "unit_discount_amount_net_decimal": "string",
+          "currency": "EUR",
+          "billing_period": "string",
+          "unit": "string",
+          "has_discount": true,
+          "is_dynamic_tariff": true,
+          "dynamic_tariff": {
+            "mode": "string",
+            "interval": "string",
+            "average_price_decimal": "string",
+            "markup_amount_decimal": "string",
+            "markup_amount_net_decimal": "string",
+            "markup_amount_gross_decimal": "string",
+            "market_price_decimal": "string",
+            "market_price_currency": "EUR",
+            "market": "string",
+            "bidding_zone": "string",
+            "timestamp": "string"
+          }
+        }
+      }
+    }
+  ],
+  "total": 0
+}
+```
+
+</details>
+
+---
+
 ### `getCustomerBalance`
 
-Get total balance across all contracts and orders of a customer entity.
+Retrieve the total balance (Kontostand) across all contracts and orders for a customer.
 
 `GET /v1/billing/customers/{id}/balance`
 
@@ -564,23 +907,36 @@ const { data } = await client.getCustomerBalance({
 
 ## Schemas
 
+### `Error`
+
+Standard error response format
+
+```ts
+type Error = {
+  error: string
+  message: string
+}
+```
+
 ### `BaseEntity`
 
+Base schema for all epilot entities with common system fields
+
 ```ts
 type BaseEntity = {
   _id?: string
   _title?: string
   _org?: string
-  _schema?: "contact" | "contract" | "file" | "order" | "opportunity" | "product" | "price" | "meter" | "meter_counter" | "billing_event"
+  _schema?: string
   _tags?: string[]
-  _created_at?: string
-  _updated_at?: string
+  _created_at?: string // date-time
+  _updated_at?: string // date-time
 }
 ```
 
 ### `EntityId`
 
-Entity ID
+Unique entity identifier (UUID format)
 
 ```ts
 type EntityId = string
@@ -588,14 +944,16 @@ type EntityId = string
 
 ### `EntitySlug`
 
-URL-friendly identifier for the entity schema
+URL-friendly identifier for the entity schema (Schema-Slug)
 
 ```ts
-type EntitySlug = "contact" | "contract" | "file" | "order" | "opportunity" | "product" | "price" | "meter" | "meter_counter" | "billing_event"
+type EntitySlug = string
 ```
 
 ### `EntityRelationItem`
 
+Reference to a related entity
+
 ```ts
 type EntityRelationItem = {
   entity_id?: string
@@ -604,26 +962,22 @@ type EntityRelationItem = {
 
 ### `BaseBillingEvent`
 
-A base billing event to be inherited by all billing events.
+Represents a single financial transaction entry (Buchungssatz) in the billing ledger.
+Each entry is either a debit or a credit, following double-entry accounting principles.
+Common types include Abschlagszahlung (installment), Zahlungseingang (payment), Rückerstattung (reimbursement), etc.
+
 
 ```ts
 type BaseBillingEvent = {
   _id?: string
   _title?: string
   _org?: string
-  _schema?: "contact" | "contract" | "file" | "order" | "opportunity" | "product" | "price" | "meter" | "meter_counter" | "billing_event"
+  _schema?: string
   _tags?: string[]
-  _created_at?: string
-  _updated_at?: string
-}
-```
-
-### `InstallmentEvent`
-
-An entity that describes an installment billing event.
-
-```ts
-type InstallmentEvent = {
+  _created_at?: string // date-time
+  _updated_at?: string // date-time
+  type: string
+  direction?: "debit" | "credit"
   billing_amount: number
   billing_amount_decimal: string
   billing_currency: string
@@ -633,76 +987,220 @@ type InstallmentEvent = {
       entity_id?: { ... }
     }>
   }
-  type: "installment"
-  due_date: string // date-time
+  booking_date: string // date
+  due_date?: string // date
   paid_date?: string // date-time
-}
-```
-
-### `ReimbursementEvent`
-
-An entity that describes a reimbursement billing event.
-
-```ts
-type ReimbursementEvent = {
-  billing_amount: number
-  billing_amount_decimal: string
-  billing_currency: string
-  external_id?: string
-  contract: {
+  status?: "closed" | "open"
+  related_event?: string
+  external_link?: {
+    href?: string // uri
+    title?: string
+  }
+  attachments?: {
     $relation?: Array<{
       entity_id?: { ... }
     }>
   }
-  type: "reimbursement"
-  paid_date?: string // date-time
+  note?: string
+  internal_note?: string
 }
 ```
 
 ### `BillingEvent`
 
-An entity that describes a billing event such as a future installment or a reimbursement back to the customer.
+Collection of supported billing event types (Buchungsarten).
+Each type represents a different kind of financial transaction
+that affects the customer's balance.
+
 
 ```ts
 type BillingEvent = {
-  billing_amount: number
-  billing_amount_decimal: string
-  billing_currency: string
+  type?: "installment"
+} | {
+  type?: "payment"
+} | {
+  type?: "reimbursement"
+} | {
+  type?: "dunning_fee"
+} | {
+  type?: "invoice"
+} | {
+  type?: "final_bill"
+} | {
+  type?: "bonus"
+} | {
+  type?: "correction"
+} | {
+  type?: string
+}
+```
+
+### `BillingEventUpdate`
+
+Fields to update on an existing billing event.
+
+```ts
+type BillingEventUpdate = {
+  type?: string
+  direction?: "debit" | "credit"
+  billing_amount?: number
+  billing_amount_decimal?: string
+  billing_currency?: string
   external_id?: string
-  contract: {
+  contract?: {
     $relation?: Array<{
       entity_id?: { ... }
     }>
   }
-  type: "installment"
-  due_date: string // date-time
+  booking_date?: string // date
+  due_date?: string // date
   paid_date?: string // date-time
-} | {
-  billing_amount: number
-  billing_amount_decimal: string
-  billing_currency: string
-  external_id?: string
-  contract: {
+  status?: "closed" | "open"
+  related_event?: string
+  external_link?: {
+    href?: string // uri
+    title?: string
+  }
+  attachments?: {
     $relation?: Array<{
       entity_id?: { ... }
     }>
   }
-  type: "reimbursement"
-  paid_date?: string // date-time
+  note?: string
+  internal_note?: string
+}
+```
+
+### `InstallmentEvent`
+
+Installment billing event (Abschlagszahlung).
+Represents a scheduled partial payment that the customer owes,
+typically billed monthly for utilities like electricity or gas.
+
+
+```ts
+type InstallmentEvent = {
+  type?: "installment"
+}
+```
+
+### `PaymentEvent`
+
+Payment received event (Zahlungseingang).
+Represents money received from the customer, reducing their balance.
+This is a credit transaction.
+
+
+```ts
+type PaymentEvent = {
+  type?: "payment"
+}
+```
+
+### `ReimbursementEvent`
+
+Reimbursement event (Rückerstattung).
+Represents a refund to the customer, typically after overpayment
+or billing correction. This is a credit transaction.
+
+
+```ts
+type ReimbursementEvent = {
+  type?: "reimbursement"
+}
+```
+
+### `DunningFeeEvent`
+
+Dunning fee event (Mahngebühr).
+Represents a late payment fee charged to the customer
+after a payment reminder has been sent. This is a debit transaction.
+
+
+```ts
+type DunningFeeEvent = {
+  type?: "dunning_fee"
+}
+```
+
+### `InvoiceEvent`
+
+```ts
+type InvoiceEvent = {
+  type?: "invoice"
+}
+```
+
+### `FinalBillEvent`
+
+Final bill event (Endabrechnung/Schlussrechnung).
+Represents the final settlement when a contract ends,
+accounting for actual consumption vs. paid installments.
+Can be either debit (customer owes more) or credit (customer overpaid).
+
+
+```ts
+type FinalBillEvent = {
+  type?: "final_bill"
+}
+```
+
+### `BonusEvent`
+
+Bonus/credit event (Gutschrift/Bonus).
+Represents a promotional credit or bonus applied to the customer's account,
+such as welcome bonuses or loyalty rewards. This is a credit transaction.
+
+
+```ts
+type BonusEvent = {
+  type?: "bonus"
+}
+```
+
+### `CorrectionEvent`
+
+Correction event (Korrekturbuchung).
+Represents an adjustment to a previous billing entry,
+such as correcting an overcharge or undercharge.
+Can be either debit or credit depending on the correction.
+
+
+```ts
+type CorrectionEvent = {
+  type?: "correction"
+}
+```
+
+### `CustomEvent`
+
+Custom billing event (Benutzerdefinierte Buchung).
+Allows for organization-specific billing event types not covered
+by the standard types. Use a descriptive type name.
+
+
+```ts
+type CustomEvent = {
+  type?: string
 }
 ```
 
 ### `Contract`
 
+Represents a customer contract (Vertrag) for billing purposes.
+Contracts are the parent entities for billing events and contain
+billing configuration such as installment amounts and billing cycles.
+
+
 ```ts
 type Contract = {
   _id?: string
   _title?: string
   _org?: string
-  _schema?: "contact" | "contract" | "file" | "order" | "opportunity" | "product" | "price" | "meter" | "meter_counter" | "billing_event"
+  _schema?: string
   _tags?: string[]
-  _created_at?: string
-  _updated_at?: string
+  _created_at?: string // date-time
+  _updated_at?: string // date-time
   contract_name?: string
   contract_number?: string
   status?: "draft" | "in_approval_process" | "approved" | "active" | "deactivated" | "revoked" | "terminated" | "expired"
@@ -712,7 +1210,7 @@ type Contract = {
   billing_address?: string
   delivery_address?: string
   additional_addresses?: string
-  termination_date?: string
+  termination_date?: string // date
   termination_reason?: string
   billing_period?: "weekly" | "monthly" | "every_quarter" | "every_6_months" | "yearly"
   billing_duration_amount?: number
@@ -720,7 +1218,7 @@ type Contract = {
   renewal_duration_unit?: "weeks" | "months" | "years"
   notice_time_amount?: number
   notice_time_unit?: "weeks" | "months" | "years"
-  start_date?: string
+  start_date?: string // date
   billing_due_day?: number
   installment_amount?: number
   balance?: number
@@ -730,15 +1228,17 @@ type Contract = {
 
 ### `ContractItem`
 
+Contract entity with all required system fields populated
+
 ```ts
 type ContractItem = {
   _id?: string
   _title?: string
   _org?: string
-  _schema?: "contact" | "contract" | "file" | "order" | "opportunity" | "product" | "price" | "meter" | "meter_counter" | "billing_event"
+  _schema?: string
   _tags?: string[]
-  _created_at?: string
-  _updated_at?: string
+  _created_at?: string // date-time
+  _updated_at?: string // date-time
   contract_name?: string
   contract_number?: string
   status?: "draft" | "in_approval_process" | "approved" | "active" | "deactivated" | "revoked" | "terminated" | "expired"
@@ -748,7 +1248,7 @@ type ContractItem = {
   billing_address?: string
   delivery_address?: string
   additional_addresses?: string
-  termination_date?: string
+  termination_date?: string // date
   termination_reason?: string
   billing_period?: "weekly" | "monthly" | "every_quarter" | "every_6_months" | "yearly"
   billing_duration_amount?: number
@@ -756,7 +1256,7 @@ type ContractItem = {
   renewal_duration_unit?: "weeks" | "months" | "years"
   notice_time_amount?: number
   notice_time_unit?: "weeks" | "months" | "years"
-  start_date?: string
+  start_date?: string // date
   billing_due_day?: number
   installment_amount?: number
   balance?: number
@@ -764,8 +1264,414 @@ type ContractItem = {
 }
 ```
 
+### `InstallmentAmountValue`
+
+```ts
+type InstallmentAmountValue = {
+  amount?: number
+  amount_decimal?: string
+  currency?: string
+}
+```
+
+### `PriceContext`
+
+```ts
+type PriceContext = {
+  price_id?: string
+  price_title?: string
+  pricing_model?: string
+  unit_amount_gross_decimal?: string
+  unit_amount_net_decimal?: string
+  before_discount_unit_amount_gross_decimal?: string
+  before_discount_unit_amount_net_decimal?: string
+  unit_discount_amount_decimal?: string
+  unit_discount_amount_net_decimal?: string
+  currency?: string
+  billing_period?: string
+  unit?: string
+  has_discount?: boolean
+  is_dynamic_tariff?: boolean
+  dynamic_tariff?: {
+    mode?: string
+    interval?: string
+    average_price_decimal?: string
+    markup_amount_decimal?: string
+    markup_amount_net_decimal?: string
+    markup_amount_gross_decimal?: string
+    market_price_decimal?: string
+    market_price_currency?: string
+    market?: string
+    bidding_zone?: string
+    timestamp?: string
+  }
+}
+```
+
+### `DynamicTariffPriceContext`
+
+```ts
+type DynamicTariffPriceContext = {
+  mode?: string
+  interval?: string
+  average_price_decimal?: string
+  markup_amount_decimal?: string
+  markup_amount_net_decimal?: string
+  markup_amount_gross_decimal?: string
+  market_price_decimal?: string
+  market_price_currency?: string
+  market?: string
+  bidding_zone?: string
+  timestamp?: string
+}
+```
+
+### `ConfigurationHistoryContext`
+
+```ts
+type ConfigurationHistoryContext = {
+  base_price?: {
+    price_id?: string
+    price_title?: string
+    pricing_model?: string
+    unit_amount_gross_decimal?: string
+    unit_amount_net_decimal?: string
+    before_discount_unit_amount_gross_decimal?: string
+    before_discount_unit_amount_net_decimal?: string
+    unit_discount_amount_decimal?: string
+    unit_discount_amount_net_decimal?: string
+    currency?: string
+    billing_period?: string
+    unit?: string
+    has_discount?: boolean
+    is_dynamic_tariff?: boolean
+    dynamic_tariff?: {
+      mode?: { ... }
+      interval?: { ... }
+      average_price_decimal?: { ... }
+      markup_amount_decimal?: { ... }
+      markup_amount_net_decimal?: { ... }
+      markup_amount_gross_decimal?: { ... }
+      market_price_decimal?: { ... }
+      market_price_currency?: { ... }
+      market?: { ... }
+      bidding_zone?: { ... }
+      timestamp?: { ... }
+    }
+  }
+  working_price?: {
+    price_id?: string
+    price_title?: string
+    pricing_model?: string
+    unit_amount_gross_decimal?: string
+    unit_amount_net_decimal?: string
+    before_discount_unit_amount_gross_decimal?: string
+    before_discount_unit_amount_net_decimal?: string
+    unit_discount_amount_decimal?: string
+    unit_discount_amount_net_decimal?: string
+    currency?: string
+    billing_period?: string
+    unit?: string
+    has_discount?: boolean
+    is_dynamic_tariff?: boolean
+    dynamic_tariff?: {
+      mode?: { ... }
+      interval?: { ... }
+      average_price_decimal?: { ... }
+      markup_amount_decimal?: { ... }
+      markup_amount_net_decimal?: { ... }
+      markup_amount_gross_decimal?: { ... }
+      market_price_decimal?: { ... }
+      market_price_currency?: { ... }
+      market?: { ... }
+      bidding_zone?: { ... }
+      timestamp?: { ... }
+    }
+  }
+}
+```
+
+### `ConfigurationHistoryRow`
+
+```ts
+type ConfigurationHistoryRow = {
+  event_id: string
+  org_id: string
+  entity_type: "contract" | "billing_account"
+  entity_id: string
+  change_type: "installment_amount_changed"
+  schema_version: number
+  effective_at?: string // date-time
+  changed_at: string // date-time
+  created_at: string // date-time
+  source: "portal" | "epilot" | "erp" | "system" | "api" | "external" | "journey" | "automation" | "unknown"
+  source_label?: string
+  source_system?: string
+  source_reference?: string
+  previous_value?: {
+    amount?: number
+    amount_decimal?: string
+    currency?: string
+  }
+  new_value: {
+    amount?: number
+    amount_decimal?: string
+    currency?: string
+  }
+  context?: {
+    base_price?: {
+      price_id?: { ... }
+      price_title?: { ... }
+      pricing_model?: { ... }
+      unit_amount_gross_decimal?: { ... }
+      unit_amount_net_decimal?: { ... }
+      before_discount_unit_amount_gross_decimal?: { ... }
+      before_discount_unit_amount_net_decimal?: { ... }
+      unit_discount_amount_decimal?: { ... }
+      unit_discount_amount_net_decimal?: { ... }
+      currency?: { ... }
+      billing_period?: { ... }
+      unit?: { ... }
+      has_discount?: { ... }
+      is_dynamic_tariff?: { ... }
+      dynamic_tariff?: { ... }
+    }
+    working_price?: {
+      price_id?: { ... }
+      price_title?: { ... }
+      pricing_model?: { ... }
+      unit_amount_gross_decimal?: { ... }
+      unit_amount_net_decimal?: { ... }
+      before_discount_unit_amount_gross_decimal?: { ... }
+      before_discount_unit_amount_net_decimal?: { ... }
+      unit_discount_amount_decimal?: { ... }
+      unit_discount_amount_net_decimal?: { ... }
+      currency?: { ... }
+      billing_period?: { ... }
+      unit?: { ... }
+      has_discount?: { ... }
+      is_dynamic_tariff?: { ... }
+      dynamic_tariff?: { ... }
+    }
+  }
+}
+```
+
+### `ConfigurationHistoryResponse`
+
+```ts
+type ConfigurationHistoryResponse = {
+  history: Array<{
+    event_id: string
+    org_id: string
+    entity_type: "contract" | "billing_account"
+    entity_id: string
+    change_type: "installment_amount_changed"
+    schema_version: number
+    effective_at?: string // date-time
+    changed_at: string // date-time
+    created_at: string // date-time
+    source: "portal" | "epilot" | "erp" | "system" | "api" | "external" | "journey" | "automation" | "unknown"
+    source_label?: string
+    source_system?: string
+    source_reference?: string
+    previous_value?: {
+      amount?: { ... }
+      amount_decimal?: { ... }
+      currency?: { ... }
+    }
+    new_value: {
+      amount?: { ... }
+      amount_decimal?: { ... }
+      currency?: { ... }
+    }
+    context?: {
+      base_price?: { ... }
+      working_price?: { ... }
+    }
+  }>
+  total: number
+}
+```
+
+### `PricingInformationBalance`
+
+```ts
+type PricingInformationBalance = {
+  amount?: number
+  amount_decimal?: string
+  currency?: string
+}
+```
+
+### `ContractPricingSchedule`
+
+```ts
+type ContractPricingSchedule = {
+  billing_due_day?: number
+  billing_period?: "weekly" | "monthly" | "every_quarter" | "every_6_months" | "yearly"
+  installments_per_year?: number
+  inferred: boolean
+}
+```
+
+### `ContractPricingInformation`
+
+```ts
+type ContractPricingInformation = {
+  entity_type: "contract"
+  entity_id: string
+  title?: string
+  current_installment_amount?: {
+    amount?: number
+    amount_decimal?: string
+    currency?: string
+  }
+  context?: {
+    base_price?: {
+      price_id?: { ... }
+      price_title?: { ... }
+      pricing_model?: { ... }
+      unit_amount_gross_decimal?: { ... }
+      unit_amount_net_decimal?: { ... }
+      before_discount_unit_amount_gross_decimal?: { ... }
+      before_discount_unit_amount_net_decimal?: { ... }
+      unit_discount_amount_decimal?: { ... }
+      unit_discount_amount_net_decimal?: { ... }
+      currency?: { ... }
+      billing_period?: { ... }
+      unit?: { ... }
+      has_discount?: { ... }
+      is_dynamic_tariff?: { ... }
+      dynamic_tariff?: { ... }
+    }
+    working_price?: {
+      price_id?: { ... }
+      price_title?: { ... }
+      pricing_model?: { ... }
+      unit_amount_gross_decimal?: { ... }
+      unit_amount_net_decimal?: { ... }
+      before_discount_unit_amount_gross_decimal?: { ... }
+      before_discount_unit_amount_net_decimal?: { ... }
+      unit_discount_amount_decimal?: { ... }
+      unit_discount_amount_net_decimal?: { ... }
+      currency?: { ... }
+      billing_period?: { ... }
+      unit?: { ... }
+      has_discount?: { ... }
+      is_dynamic_tariff?: { ... }
+      dynamic_tariff?: { ... }
+    }
+  }
+  balance?: {
+    amount?: number
+    amount_decimal?: string
+    currency?: string
+  }
+  schedule?: {
+    billing_due_day?: number
+    billing_period?: "weekly" | "monthly" | "every_quarter" | "every_6_months" | "yearly"
+    installments_per_year?: number
+    inferred: boolean
+  }
+  pending_installment_change?: boolean
+  history: Array<{
+    event_id: string
+    org_id: string
+    entity_type: "contract" | "billing_account"
+    entity_id: string
+    change_type: "installment_amount_changed"
+    schema_version: number
+    effective_at?: string // date-time
+    changed_at: string // date-time
+    created_at: string // date-time
+    source: "portal" | "epilot" | "erp" | "system" | "api" | "external" | "journey" | "automation" | "unknown"
+    source_label?: string
+    source_system?: string
+    source_reference?: string
+    previous_value?: {
+      amount?: { ... }
+      amount_decimal?: { ... }
+      currency?: { ... }
+    }
+    new_value: {
+      amount?: { ... }
+      amount_decimal?: { ... }
+      currency?: { ... }
+    }
+    context?: {
+      base_price?: { ... }
+      working_price?: { ... }
+    }
+  }>
+}
+```
+
+### `BillingAccountPricingInformation`
+
+```ts
+type BillingAccountPricingInformation = {
+  entity_type: "billing_account"
+  entity_id: string
+  title?: string
+  balance?: {
+    amount?: number
+    amount_decimal?: string
+    currency?: string
+  }
+  contracts: Array<{
+    entity_type: "contract"
+    entity_id: string
+    title?: string
+    current_installment_amount?: {
+      amount?: { ... }
+      amount_decimal?: { ... }
+      currency?: { ... }
+    }
+    context?: {
+      base_price?: { ... }
+      working_price?: { ... }
+    }
+    balance?: {
+      amount?: { ... }
+      amount_decimal?: { ... }
+      currency?: { ... }
+    }
+    schedule?: {
+      billing_due_day?: { ... }
+      billing_period?: { ... }
+      installments_per_year?: { ... }
+      inferred: { ... }
+    }
+    pending_installment_change?: boolean
+    history: Array<{
+      event_id: { ... }
+      org_id: { ... }
+      entity_type: { ... }
+      entity_id: { ... }
+      change_type: { ... }
+      schema_version: { ... }
+      effective_at?: { ... }
+      changed_at: { ... }
+      created_at: { ... }
+      source: { ... }
+      source_label?: { ... }
+      source_system?: { ... }
+      source_reference?: { ... }
+      previous_value?: { ... }
+      new_value: { ... }
+      context?: { ... }
+    }>
+  }>
+}
+```
+
 ### `Balance`
 
+Customer balance summary (Kontostandübersicht).
+Represents the aggregated balance across all contracts and orders for a customer.
+
+
 ```ts
 type Balance = {
   balance?: number
@@ -776,7 +1682,9 @@ type Balance = {
 
 ### `Currency`
 
-Currency code in ISO 4217 format
+Currency code in ISO 4217 format (Währungscode).
+Common values: EUR (Euro), CHF (Swiss Franc)
+
 
 ```ts
 type Currency = string