← ALL PLUGINS

Core plugin · artifi-core-cost-allocation

Cost Allocation.

V2.0.0MIT2 COMMANDS

A flexible cost allocation engine supporting two modes: standalone allocations from GL account balances and document-linked allocations traced back to specific bills or invoices. Four allocation methods are available — fixed percentage, by headcount, by revenue, and custom formula. Every allocation enforces balanced debits and credits, prevents double-allocation of the same costs, and creates a full audit trail. Allocations can be voided with automatic reversing entries.

Open on GitHub

01 / Commands · 2

Two commands.
Three procedures.

Both run inside Claude against the governed ledger.

01

/allocate-costs — Create and execute a cost allocation from start to finish. Supports standalone (from GL balances) and document-linked (from a specific bill/invoice). Guides through: entity/period selection, mode choice, source identification, allocation method, preview, and submission.

02

/allocation-preview — Calculate and preview an allocation without submitting. Shows preview table with source and target lines, total debits/credits, and source line account verification. Supports both standalone and document-linked modes.

HIGHLIGHTS

Fixed %, headcount, revenue, or custom formula methods. Double-allocation prevention. Balanced submission validation (DR = CR). Full audit trail with source document linking.

02 / How a run behaves

How a run behaves.
Three procedures, step by step.

STANDALONE ALLOCATION

01
Identify source costs — fetch balance of source account(s) for the allocation period
02
Determine allocation method: fixed percentage, by headcount, by revenue, or custom formula
03
Calculate target splits and show preview table with source and target lines
04
User reviews and confirms the allocation preview
05
Create allocation run and submit balanced debit/credit lines
06
Optionally approve and post the GL journal entry immediately

DOCUMENT-LINKED ALLOCATION

01
Identify source transaction — find the source bill/invoice/JE and show GL lines
02
Check existing allocations — verify account is not already fully allocated
03
Select which line(s) to allocate: all expense lines or specific accounts
04
Determine allocation method and calculate target splits
05
User confirms preview including source document reference
06
Create allocation run with source_transaction_id for full traceability

VOIDING AND CORRECTING

01
Void an existing allocation run
02
System creates reversing GL entry automatically
03
Source account freed up for re-allocation

VALIDATION GATE · 8 CHECKS

Source data exists (account has balance or transaction has allocatable lines). Target accounts exist and are active. Total debits equal total credits (balanced). At least one source line and one target line. For document-linked: source line accounts match source transaction GL lines. For document-linked: account not already fully allocated. User has reviewed and confirmed the preview. Submission succeeds without errors.

REFERENCE DATA · 2 FILES

allocation-methods.mdsubmission-format.md

Fork it

Your procedures,
written down.

Swap the reference files for your policies and run it in Claude. Writes still go through the governed gateway.

hello@ar-ti-fi.com