# AllocationConfigurations

Manage charge allocation configurations for split billing

## List Allocation Configurations

 - [GET /allocationConfigurations](https://docs.nelnetpay.com/apis/billing-ledger-service/allocationconfigurations/listallocationconfigurations.md): List all allocation configurations for the authenticated merchant.

Allocation configurations define how charges are split between multiple accounts
(e.g., divorced parents, household + subsidy agency).

## Create Allocation Configuration

 - [POST /allocationConfigurations](https://docs.nelnetpay.com/apis/billing-ledger-service/allocationconfigurations/createallocationconfiguration.md): Create a new allocation configuration with rules.

Important: The total allocation percentage does NOT need to equal 100% at creation time.
This allows for incremental household enrollment. Validation of 100% happens at charge creation time.

Rule Types:
- RESPONSIBLE_PARTY - Split by percentage (e.g., Mom 50%, Dad 50%)
- COVERAGE_TRANSFER - Fixed amount covered (e.g., subsidy covers $25 per charge)
- BILLING_CAP - Maximum amount per period (e.g., subsidy covers up to $400/month)

Processing Order: Rules are processed in priority order (1 = first).
COVERAGE_TRANSFER and BILLING_CAP typically run before RESPONSIBLE_PARTY.

## Get Allocation Configuration Details

 - [GET /allocationConfigurations/{allocationConfigId}](https://docs.nelnetpay.com/apis/billing-ledger-service/allocationconfigurations/getallocationconfiguration.md): Retrieve details of a specific allocation configuration including all rules

## Update Allocation Configuration

 - [PATCH /allocationConfigurations/{allocationConfigId}](https://docs.nelnetpay.com/apis/billing-ledger-service/allocationconfigurations/updateallocationconfiguration.md): Update an allocation configuration (partial update).

Version Tracking: Each update increments the version.
Existing charges and subscriptions retain the version from when they were created.

## Delete Allocation Configuration

 - [DELETE /allocationConfigurations/{allocationConfigId}](https://docs.nelnetpay.com/apis/billing-ledger-service/allocationconfigurations/deleteallocationconfiguration.md): Soft delete an allocation configuration.

Restrictions: Cannot delete if referenced by active subscriptions or unbilled charges.

## Validate Allocation Configuration

 - [POST /allocationConfigurations/{allocationConfigId}/validate](https://docs.nelnetpay.com/apis/billing-ledger-service/allocationconfigurations/validateallocationconfiguration.md): Validate an allocation configuration for a specific billable entity.

Validation Checks:
1. All accounts in allocation rules are associated with the billable entity
2. RESPONSIBLE_PARTY rules total 100% of remaining amount
3. No circular dependencies in rules

Use this before creating charges to catch configuration issues early.