Skip to content
HALOWERK

Finopswerk

statutory net share withholding bridge

Reconstruct the FULLY VESTED employee-share-award statutory NET-SHARE/TAX-CASH settlement slice: Q fixed one-share awards, W shares withheld, remaining Q-W shares delivered, and employee tax C paid in cash to authority. Caller independently qualifies actual statutory withholding obligation, arrangement otherwise EQUITY-settled without feature, and NO excess withheld shares under AASB2 33E-F/H. C already correctly measured EMPLOYEE tax obligation AND actual cash remitted; kernel does NOT.

POST https://finops.halowerk.com/v1/statutory-net-share-withholding-bridge

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
award_sharesintegerYes
withheld_sharesintegerYes
grant_fv_nintegerYes
settlement_fv_nintegerYes
tax_cash_nintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "award_shares",
    "withheld_shares",
    "grant_fv_n",
    "settlement_fv_n",
    "tax_cash_n",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "award_shares": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "withheld_shares": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "grant_fv_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "settlement_fv_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "tax_cash_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 24,
      "maxProperties": 24,
      "propertyNames": {
        "enum": [
          "award_shares",
          "withheld_shares",
          "delivered_shares",
          "withholding_fraction",
          "grant_fv_per_award",
          "settlement_fv_per_share",
          "cumulative_service_cost",
          "gross_settlement_share_fv",
          "withheld_share_fv",
          "employee_tax_payable_created",
          "tax_cash_paid",
          "signed_cash_change",
          "closing_employee_tax_payable",
          "current_service_expense",
          "current_settlement_PL",
          "withholding_equity_change",
          "modeled_award_equity_credit_after",
          "prior_retained_earnings_expense",
          "total_pretax_equity_change",
          "delivered_grant_value_diagnostic",
          "withheld_grant_value_diagnostic",
          "withheld_fv_change_diagnostic",
          "share_count_gap",
          "cash_equity_gap"
        ]
      },
      "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
          }
        }
      }
    }
  },
  "additionalProperties": false
}

Open original schema

Published input example

{
  "award_shares": 100,
  "withheld_shares": 40,
  "grant_fv_n": 2,
  "settlement_fv_n": 10,
  "tax_cash_n": 400,
  "amount_denominator": 1,
  "report": {
    "award_shares": {
      "n": "100",
      "d": "1"
    },
    "withheld_shares": {
      "n": "40",
      "d": "1"
    },
    "delivered_shares": {
      "n": "60",
      "d": "1"
    },
    "withholding_fraction": {
      "n": "2",
      "d": "5"
    },
    "grant_fv_per_award": {
      "n": "2",
      "d": "1"
    },
    "settlement_fv_per_share": {
      "n": "10",
      "d": "1"
    },
    "cumulative_service_cost": {
      "n": "200",
      "d": "1"
    },
    "gross_settlement_share_fv": {
      "n": "1000",
      "d": "1"
    },
    "withheld_share_fv": {
      "n": "400",
      "d": "1"
    },
    "employee_tax_payable_created": {
      "n": "400",
      "d": "1"
    },
    "tax_cash_paid": {
      "n": "400",
      "d": "1"
    },
    "signed_cash_change": {
      "n": "-400",
      "d": "1"
    },
    "closing_employee_tax_payable": {
      "n": "0",
      "d": "1"
    },
    "current_service_expense": {
      "n": "0",
      "d": "1"
    },
    "current_settlement_PL": {
      "n": "0",
      "d": "1"
    },
    "withholding_equity_change": {
      "n": "-400",
      "d": "1"
    },
    "modeled_award_equity_credit_after": {
      "n": "-200",
      "d": "1"
    },
    "prior_retained_earnings_expense": {
      "n": "-200",
      "d": "1"
    },
    "total_pretax_equity_change": {
      "n": "-400",
      "d": "1"
    },
    "delivered_grant_value_diagnostic": {
      "n": "120",
      "d": "1"
    },
    "withheld_grant_value_diagnostic": {
      "n": "80",
      "d": "1"
    },
    "withheld_fv_change_diagnostic": {
      "n": "320",
      "d": "1"
    },
    "share_count_gap": {
      "n": "0",
      "d": "1"
    },
    "cash_equity_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 โ†’