Skip to content
HALOWERK

Finopswerk

ifrs2 net withholding tax settlement ledger

Reconstructs one fully vested IFRS2 statutory net-withholding settlement with excess shares paid in cash to the employee under 33H(b), and the linked tax-authority remittance. From total award Q, total withheld H, measured employee tax C and settlement share FV S it derives statutory shares T = C/S and excess X = H - T. Profile: C>0, T integer, 1<=T<=H<=Q. Excess liability = X*S, remeasurement PL expense = X*S - L, cash to employee = X*S, cash to authority = C.

POST https://finops.halowerk.com/v1/ifrs2-net-withholding-tax-settlement-ledger

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
award_sharesintegerYes
withheld_sharesintegerYes
grant_fv_nintegerYes
settlement_fv_nintegerYes
employee_tax_nintegerYes
opening_cash_award_liability_nintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "award_shares",
    "withheld_shares",
    "grant_fv_n",
    "settlement_fv_n",
    "employee_tax_n",
    "opening_cash_award_liability_n",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "award_shares": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "withheld_shares": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "grant_fv_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "settlement_fv_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "employee_tax_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000000000
    },
    "opening_cash_award_liability_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 35,
      "maxProperties": 35,
      "propertyNames": {
        "enum": [
          "award_shares",
          "withheld_shares",
          "statutory_withheld_shares",
          "excess_withheld_shares",
          "delivered_shares",
          "equity_settled_award_shares",
          "grant_FV",
          "settlement_FV",
          "opening_equity_award_credit",
          "opening_cash_award_liability",
          "opening_cumulative_expense",
          "cash_award_settlement_FV",
          "cash_award_remeasurement_expense",
          "employee_tax_payable_created",
          "cash_to_authority",
          "cash_to_employee",
          "total_cash_paid",
          "signed_cash_change",
          "closing_employee_tax_payable",
          "closing_cash_award_liability",
          "current_settlement_PL_expense",
          "current_direct_equity_debit",
          "closing_award_equity_credit_slice",
          "cumulative_award_expense",
          "current_total_equity_change",
          "opening_award_total_equity_slice",
          "closing_award_total_equity_slice",
          "award_share_gap",
          "tax_value_gap",
          "cash_liability_gap",
          "current_balance_gap",
          "cumulative_equity_cash_gap",
          "journal_debit_total",
          "journal_credit_total",
          "journal_balance_gap"
        ]
      },
      "additionalProperties": {
        "oneOf": [
          {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "n",
              "d"
            ],
            "properties": {
              "n": {
                "type": "string",
                "maxLength": 64,
                "pattern": "^-?(0|[1-9][0-9]*)$"
              },
              "d": {
                "type": "string",
                "maxLength": 64,
                "pattern": "^[1-9][0-9]*$"
              }
            }
          },
          {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "n",
              "d"
            ],
            "properties": {
              "n": {
                "type": "null"
              },
              "d": {
                "type": "null"
              }
            }
          }
        ]
      }
    }
  }
}

Open original schema

Published input example

{
  "award_shares": 100,
  "withheld_shares": 40,
  "grant_fv_n": 2,
  "settlement_fv_n": 10,
  "employee_tax_n": 350,
  "opening_cash_award_liability_n": 20,
  "amount_denominator": 1,
  "report": {
    "award_shares": {
      "n": "100",
      "d": "1"
    },
    "withheld_shares": {
      "n": "40",
      "d": "1"
    },
    "statutory_withheld_shares": {
      "n": "35",
      "d": "1"
    },
    "excess_withheld_shares": {
      "n": "5",
      "d": "1"
    },
    "delivered_shares": {
      "n": "60",
      "d": "1"
    },
    "equity_settled_award_shares": {
      "n": "95",
      "d": "1"
    },
    "grant_FV": {
      "n": "2",
      "d": "1"
    },
    "settlement_FV": {
      "n": "10",
      "d": "1"
    },
    "opening_equity_award_credit": {
      "n": "190",
      "d": "1"
    },
    "opening_cash_award_liability": {
      "n": "20",
      "d": "1"
    },
    "opening_cumulative_expense": {
      "n": "210",
      "d": "1"
    },
    "cash_award_settlement_FV": {
      "n": "50",
      "d": "1"
    },
    "cash_award_remeasurement_expense": {
      "n": "30",
      "d": "1"
    },
    "employee_tax_payable_created": {
      "n": "350",
      "d": "1"
    },
    "cash_to_authority": {
      "n": "350",
      "d": "1"
    },
    "cash_to_employee": {
      "n": "50",
      "d": "1"
    },
    "total_cash_paid": {
      "n": "400",
      "d": "1"
    },
    "signed_cash_change": {
      "n": "-400",
      "d": "1"
    },
    "closing_employee_tax_payable": {
      "n": "0",
      "d": "1"
    },
    "closing_cash_award_liability": {
      "n": "0",
      "d": "1"
    },
    "current_settlement_PL_expense": {
      "n": "30",
      "d": "1"
    },
    "current_direct_equity_debit": {
      "n": "350",
      "d": "1"
    },
    "closing_award_equity_credit_slice": {
      "n": "-160",
      "d": "1"
    },
    "cumulative_award_expense": {
      "n": "240",
      "d": "1"
    },
    "current_total_equity_change": {
      "n": "-380",
      "d": "1"
    },
    "opening_award_total_equity_slice": {
      "n": "-20",
      "d": "1"
    },
    "closing_award_total_equity_slice": {
      "n": "-400",
      "d": "1"
    },
    "award_share_gap": {
      "n": "0",
      "d": "1"
    },
    "tax_value_gap": {
      "n": "0",
      "d": "1"
    },
    "cash_liability_gap": {
      "n": "0",
      "d": "1"
    },
    "current_balance_gap": {
      "n": "0",
      "d": "1"
    },
    "cumulative_equity_cash_gap": {
      "n": "0",
      "d": "1"
    },
    "journal_debit_total": {
      "n": "780",
      "d": "1"
    },
    "journal_credit_total": {
      "n": "780",
      "d": "1"
    },
    "journal_balance_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 โ†’