Skip to content
HALOWERK

Finopswerk

contract acquisition cost recovery ledger

Reconstructs one incremental contract-acquisition cost asset over three equal service years. A caller-established recoverable commission is capitalized at inception; a separate non-incremental cost is expensed immediately. Each year the asset is amortized over the remaining years, then compared with remaining expected consideration minus directly related unexpensed remaining costs. Returns 23 exact scalars. Reversal only where the caller sets reversal_permitted.

POST https://finops.halowerk.com/v1/contract-acquisition-cost-recovery-ledger

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
eligible_commission_nintegerYes
other_acquisition_cost_nintegerYes
remaining_consideration_narrayYes
remaining_direct_cost_narrayYes
reversal_permittedarrayYes
capture_indexintegerYes
captured_consideration_domain_narrayYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "properties": {
    "eligible_commission_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "other_acquisition_cost_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "remaining_consideration_n": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      }
    },
    "remaining_direct_cost_n": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      }
    },
    "reversal_permitted": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "type": "boolean"
      }
    },
    "capture_index": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1
    },
    "captured_consideration_domain_n": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      }
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 23,
      "maxProperties": 23,
      "propertyNames": {
        "enum": [
          "initial_capitalized_cost",
          "initial_expensed_cost",
          "amortization_0",
          "amortization_1",
          "amortization_2",
          "net_recovery_threshold_0",
          "net_recovery_threshold_1",
          "net_recovery_threshold_2",
          "impairment_loss_0",
          "impairment_loss_1",
          "impairment_loss_2",
          "reversal_gain_0",
          "reversal_gain_1",
          "reversal_gain_2",
          "closing_asset_0",
          "closing_asset_1",
          "closing_asset_2",
          "cumulative_PL_expense_0",
          "cumulative_PL_expense_1",
          "cumulative_PL_expense_2",
          "cost_bridge_gap_0",
          "cost_bridge_gap_1",
          "cost_bridge_gap_2"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "n",
          "d"
        ],
        "properties": {
          "n": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 64
          },
          "d": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 64
          }
        }
      }
    }
  },
  "required": [
    "eligible_commission_n",
    "other_acquisition_cost_n",
    "remaining_consideration_n",
    "remaining_direct_cost_n",
    "reversal_permitted",
    "capture_index",
    "captured_consideration_domain_n",
    "amount_denominator",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "eligible_commission_n": 7,
  "other_acquisition_cost_n": 2,
  "remaining_consideration_n": [
    2,
    4,
    0
  ],
  "remaining_direct_cost_n": [
    1,
    0,
    0
  ],
  "reversal_permitted": [
    false,
    true,
    false
  ],
  "capture_index": 0,
  "captured_consideration_domain_n": [
    2
  ],
  "amount_denominator": 3,
  "report": {
    "initial_capitalized_cost": {
      "n": "7",
      "d": "3"
    },
    "initial_expensed_cost": {
      "n": "2",
      "d": "3"
    },
    "amortization_0": {
      "n": "7",
      "d": "9"
    },
    "amortization_1": {
      "n": "1",
      "d": "6"
    },
    "amortization_2": {
      "n": "7",
      "d": "9"
    },
    "net_recovery_threshold_0": {
      "n": "1",
      "d": "3"
    },
    "net_recovery_threshold_1": {
      "n": "4",
      "d": "3"
    },
    "net_recovery_threshold_2": {
      "n": "0",
      "d": "1"
    },
    "impairment_loss_0": {
      "n": "11",
      "d": "9"
    },
    "impairment_loss_1": {
      "n": "0",
      "d": "1"
    },
    "impairment_loss_2": {
      "n": "0",
      "d": "1"
    },
    "reversal_gain_0": {
      "n": "0",
      "d": "1"
    },
    "reversal_gain_1": {
      "n": "11",
      "d": "18"
    },
    "reversal_gain_2": {
      "n": "0",
      "d": "1"
    },
    "closing_asset_0": {
      "n": "1",
      "d": "3"
    },
    "closing_asset_1": {
      "n": "7",
      "d": "9"
    },
    "closing_asset_2": {
      "n": "0",
      "d": "1"
    },
    "cumulative_PL_expense_0": {
      "n": "8",
      "d": "3"
    },
    "cumulative_PL_expense_1": {
      "n": "20",
      "d": "9"
    },
    "cumulative_PL_expense_2": {
      "n": "3",
      "d": "1"
    },
    "cost_bridge_gap_0": {
      "n": "0",
      "d": "1"
    },
    "cost_bridge_gap_1": {
      "n": "0",
      "d": "1"
    },
    "cost_bridge_gap_2": {
      "n": "0",
      "d": "1"
    }
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’