Skip to content
HALOWERK

Finopswerk

dealer finance lease residual bridge

Reconciles a manufacturer/dealer finance lessor sale and its two-period net investment with a retained unguaranteed residual. The caller supplies cost/book C, two end-of-period payments P1/P2, unguaranteed residual V and rate r, and qualifies the finance-lease classification and that implicit and market rate equal r. Initial NI=PV payments+PV residual; sales revenue=PV payments; cost of sale=C-PV residual; selling profit/loss=NI-C. Not an appraisal or rate solver.

POST https://finops.halowerk.com/v1/dealer-finance-lease-residual-bridge

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
cost_nintegerYes
payments_narrayYes
residual_nintegerYes
rate_bpintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "cost_n",
    "payments_n",
    "residual_n",
    "rate_bp",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "cost_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "payments_n": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      }
    },
    "residual_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "rate_bp": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 22,
      "maxProperties": 22,
      "propertyNames": {
        "enum": [
          "book_cost",
          "period_rate",
          "payment1",
          "payment2",
          "unguaranteed_residual",
          "PV_payments",
          "PV_residual",
          "initial_net_investment",
          "sales_revenue",
          "cost_of_sales",
          "selling_profit",
          "interest1",
          "closing_NI1",
          "interest2",
          "closing_NI2",
          "total_interest",
          "total_customer_cash",
          "retained_residual_after_cash",
          "cumulative_PL_slice",
          "initial_balance_gap",
          "terminal_gap",
          "total_return_gap"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "required": [
          "n",
          "d"
        ],
        "propertyNames": {
          "enum": [
            "n",
            "d"
          ]
        },
        "additionalProperties": {
          "type": [
            "string",
            "null"
          ],
          "minLength": 1,
          "maxLength": 64
        }
      }
    }
  },
  "additionalProperties": false
}

Open original schema

Published input example

{
  "cost_n": 70,
  "payments_n": [
    50,
    55
  ],
  "residual_n": 11,
  "rate_bp": 1000,
  "amount_denominator": 1,
  "report": {
    "book_cost": {
      "n": "70",
      "d": "1"
    },
    "period_rate": {
      "n": "1",
      "d": "10"
    },
    "payment1": {
      "n": "50",
      "d": "1"
    },
    "payment2": {
      "n": "55",
      "d": "1"
    },
    "unguaranteed_residual": {
      "n": "11",
      "d": "1"
    },
    "PV_payments": {
      "n": "1000",
      "d": "11"
    },
    "PV_residual": {
      "n": "100",
      "d": "11"
    },
    "initial_net_investment": {
      "n": "100",
      "d": "1"
    },
    "sales_revenue": {
      "n": "1000",
      "d": "11"
    },
    "cost_of_sales": {
      "n": "670",
      "d": "11"
    },
    "selling_profit": {
      "n": "30",
      "d": "1"
    },
    "interest1": {
      "n": "10",
      "d": "1"
    },
    "closing_NI1": {
      "n": "60",
      "d": "1"
    },
    "interest2": {
      "n": "6",
      "d": "1"
    },
    "closing_NI2": {
      "n": "11",
      "d": "1"
    },
    "total_interest": {
      "n": "16",
      "d": "1"
    },
    "total_customer_cash": {
      "n": "105",
      "d": "1"
    },
    "retained_residual_after_cash": {
      "n": "11",
      "d": "1"
    },
    "cumulative_PL_slice": {
      "n": "46",
      "d": "1"
    },
    "initial_balance_gap": {
      "n": "0",
      "d": "1"
    },
    "terminal_gap": {
      "n": "0",
      "d": "1"
    },
    "total_return_gap": {
      "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 โ†’