Allocate Expense by Weight

Overview

Perform bounded exact-decimal allocate expense by weight and return the calculation with an audit receipt. Closed inputs, fixed precision, deterministic ordering, and typed failures apply.

You receive exact totals and a compact audit receipt for accounting.allocate_expense_by_weight.

When to use it

Scope

Non-goals

• Does not infer currency conversion, calendar basis, accounting policy, or materiality for accounting.allocate_expense_by_weight.
• Does not mutate a ledger, read files, or process unbounded rows for accounting.allocate_expense_by_weight.

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"accounting.allocate_expense_by_weight","input":{"expense":"100","weights":[{"id":"a","weight":"1"},{"id":"b","weight":"3"}],"rounding":{"mode":"HALF_UP","scale":2}}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("accounting.allocate_expense_by_weight", {"weights":[{"id":"a","weight":"1"},{"id":"b","weight":"3"}],"expense":"100","rounding":{"mode":"HALF_UP","scale":2}});

Errors

Other limits

Limitations

• Does not infer currency conversion, calendar basis, accounting policy, or materiality for accounting.allocate_expense_by_weight.
• Does not mutate a ledger, read files, or process unbounded rows for accounting.allocate_expense_by_weight.
• Inferred policy, conversion, posting, or schedules outside the closed input
• Inputs above the declared bounds for accounting.allocate_expense_by_weight.

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "accounting.allocate_expense_by_weight",
  "input": {
    "weights": [
      {
        "id": "a",
        "weight": "1"
      },
      {
        "id": "b",
        "weight": "3"
      }
    ],
    "expense": "100",
    "rounding": {
      "mode": "HALF_UP",
      "scale": 2
    }
  }
}

Examples

{
  "weights": [
    {
      "id": "a",
      "weight": "1"
    },
    {
      "id": "b",
      "weight": "3"
    }
  ],
  "expense": "100",
  "rounding": {
    "mode": "HALF_UP",
    "scale": 2
  }
}

{
  "allocations": [
    {
      "id": "a",
      "amount": "25.00",
      "exactAmount": "25"
    },
    {
      "id": "b",
      "amount": "75.00",
      "exactAmount": "75"
    }
  ],
  "residual": "0",
  "rounding": {
    "mode": "HALF_UP",
    "scale": 2,
    "point": "final"
  }
}

{
  "weights": [
    {
      "id": "a",
      "weight": "1"
    },
    {
      "id": "b",
      "weight": "1"
    },
    {
      "id": "c",
      "weight": "1"
    }
  ],
  "expense": "0.05",
  "rounding": {
    "mode": "HALF_UP",
    "scale": 2
  }
}

{
  "allocations": [
    {
      "id": "a",
      "amount": "0.02",
      "exactAmount": "0.01666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666667"
    },
    {
      "id": "b",
      "amount": "0.02",
      "exactAmount": "0.01666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666667"
    },
    {
      "id": "c",
      "amount": "0.02",
      "exactAmount": "0.01666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666666667"
    }
  ],
  "residual": "-0.01",
  "rounding": {
    "mode": "HALF_UP",
    "scale": 2,
    "point": "final"
  }
}

Recommended use cases

• Auditable bounded allocate expense by weight
• Exact-decimal fund-accounting controls for accounting.allocate_expense_by_weight.

Avoid for

• Inferred policy, conversion, posting, or schedules outside the closed input
• Inputs above the declared bounds for accounting.allocate_expense_by_weight.

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags