{"openapi":"3.1.0","info":{"title":"PHFA 2025 Core Application Operating Underwriting (2025)","version":"2025.1.0","description":"Pennsylvania Housing Finance Agency application operating budget and first-two-year proforma sensitivities. Catalog calculations, not certification; no PHFA endorsement. selectCells reads at most 256 cells per request (including repeated cells). For licenseClass reference-only, cellOverrides, selectCells and trace may address only declared fio.yaml input/output port cells; trace traversal stops at that boundary. Verification level: scenario-independent-arithmetic.","x-formualizer-Provenance":{"publisher":"Pennsylvania Housing Finance Agency (PHFA)","publisherPageUrl":"https://www.phfa.org/mhp/developers/housingapplication.aspx","sourceUrl":"https://www.phfa.org/files/mf_application/core_application.zip","publishedDate":"2024-12-06","workbookFilename":"core_application-vba-free.xlsx","workbookSha256":"8b442662c95ae9fd4b41488e29b3d27a506e8998c4b050bf7270343b2d3ac3ec","workbookBytes":310350,"format":"xlsx","licenseClass":"reference-only","upstreamArtifact":{"sourceUrl":"https://www.phfa.org/files/mf_application/core_application.zip","workbookFilename":"core_application.zip","workbookSha256":"60a4467472d7cd68ade1dc673c4a81c4570df1e7fc668e6f6775e03421d4d013","workbookBytes":316259,"format":"zip"},"archiveMember":{"memberPath":"core_application.xlsm","workbookSha256":"6a8b172e705cada6d835a9dbfa7375c57802496df55a500ea84a1036a72f9097","workbookBytes":399707,"format":"xlsm"},"originalWorkbookFilename":"core_application.xlsm","originalWorkbookSha256":"6a8b172e705cada6d835a9dbfa7375c57802496df55a500ea84a1036a72f9097","originalWorkbookBytes":399707,"sourceArchiveSha256":"60a4467472d7cd68ade1dc673c4a81c4570df1e7fc668e6f6775e03421d4d013","derivativeNotes":"Remove VBA project, its workbook relationship and content-type override; change workbook main content type to xlsx; preserve all other uncompressed part bytes. No formula or cache edits.","dateNotes":"The date is the workbook's modified timestamp, not a confirmed publication date."},"x-formualizer-VerificationLevel":"scenario-independent-arithmetic","x-formualizer-WorkbookDownload":{"mode":"publisher-redirect","sourceUrl":"https://www.phfa.org/files/mf_application/core_application.zip","sha256":"8b442662c95ae9fd4b41488e29b3d27a506e8998c4b050bf7270343b2d3ac3ec","bytes":310350,"upstreamArtifact":{"sourceUrl":"https://www.phfa.org/files/mf_application/core_application.zip","workbookFilename":"core_application.zip","workbookSha256":"60a4467472d7cd68ade1dc673c4a81c4570df1e7fc668e6f6775e03421d4d013","workbookBytes":316259,"format":"zip"}},"x-formualizer-Flows":[{"id":"quick_operating_budget","title":"Quick annual operating budget","kind":"single","inputPorts":["gross_residential","gross_commercial","residential_vacancy","commercial_vacancy_amount","laundry","management","electricity","maintenance_contracts","office_salaries","real_estate_tax","insurance","replacement_reserve","primary_debt","pennhomes_debt"],"outputPorts":["effective_gross_income","operating_disbursements","budget_noi","budget_dscr","secondary_cashflow"]},{"id":"full_underwriting_budget_proforma","title":"Full annual budget and first two proforma years","kind":"single","inputPorts":["gross_residential","gross_commercial","other_rental","residential_vacancy","commercial_vacancy_amount","laundry","advertising","office_telephone","management","legal","audit","misc_admin","fuel_oil","electricity","water","gas","sewer","maintenance_supplies","maintenance_contracts","rubbish","security","repairs","elevator","hvac","grounds","painting","vehicles","misc_maintenance","office_salaries","manager_salaries","employee_free_rent","maintenance_salaries","payroll_tax","workers_comp","benefits","real_estate_tax","insurance","misc_tax","supportive_services","replacement_reserve","investor_fee","broadband","other_expense","primary_debt","service_fee","credit_enhancement","other_service_fee","pennhomes_debt","secondary_other_1","secondary_other_2","residential_growth","commercial_growth","expense_growth","proforma_residential_vacancy","proforma_commercial_vacancy"],"outputPorts":["effective_gross_income","operating_disbursements","budget_noi","primary_debt_total","initial_cashflow","budget_dscr","secondary_cashflow","year1_noi","year1_dscr","year1_secondary_cashflow","year2_noi","year2_secondary_cashflow","year2_dscr"]}]},"paths":{"/evaluate":{"post":{"operationId":"evaluateWorkbook","parameters":[{"name":"tablePort","in":"query","description":"Table input port receiving NDJSON rows or Arrow IPC; omit for scenario envelopes","schema":{"type":"string","enum":[]}},{"name":"flow","in":"query","description":"Named input/output flow (default: quick_operating_budget)","schema":{"type":"string","enum":["quick_operating_budget","full_underwriting_budget_proforma"],"default":"quick_operating_budget"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"inputs":{"$ref":"#/components/schemas/Inputs"}},"required":["inputs"]}},"application/x-ndjson":{"schema":{"type":"string","description":"Table rows with tablePort, otherwise scenario envelopes"}},"application/vnd.apache.arrow.stream":{"schema":{"type":"string","format":"binary"}},"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"Workbook outputs","content":{"application/json":{"schema":{"type":"object","properties":{"outputs":{"$ref":"#/components/schemas/Outputs"}}}},"application/x-ndjson":{"schema":{"type":"string","description":"Scenario results, one JSON envelope per line"}}}}}}},"/evaluate-batch":{"post":{"operationId":"evaluateWorkbookBatch","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scenarios":{"type":"array","items":{"type":"object","properties":{"id":{},"inputs":{"$ref":"#/components/schemas/Inputs"}},"required":["inputs"]}}},"required":["scenarios"]}},"application/x-ndjson":{"schema":{"type":"string","description":"Scenario envelopes, one per line"}}}},"responses":{"200":{"description":"Scenario results (including per-scenario errors)","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{},"outputs":{"$ref":"#/components/schemas/Outputs"},"error":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"application/x-ndjson":{"schema":{"type":"string"}}}}}}},"/ports":{"get":{"operationId":"describePorts","responses":{"200":{"description":"Workbook manifest and ports","content":{"application/json":{"schema":{"type":"object","properties":{"manifest":{"type":"object"},"ports":{"type":"array","items":{"type":"object"}}}}}}}}}},"/types.d.ts":{"get":{"operationId":"typeDeclarations","responses":{"200":{"description":"TypeScript Inputs, Outputs and Client declarations","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/models/{slug}/{edition}/workbook.xlsx":{"get":{"summary":"Download catalog workbook or follow publisher redirect","description":"Download mode: publisher-redirect. Reference-only workbooks redirect to the publisher. The sha256 and bytes metadata pin the catalog file, which may be a sanitized derivative. When present, upstreamArtifact separately pins the publisher file. fio.yaml remains downloadable.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","enum":["phfa-core-application"]}},{"name":"edition","in":"path","required":true,"schema":{"type":"string","enum":["2025"]}}],"responses":{"302":{"description":"Publisher redirect; no workbook bytes in response","headers":{"Location":{"schema":{"type":"string","format":"uri"}},"x-workbook-sha256":{"schema":{"type":"string"},"description":"8b442662c95ae9fd4b41488e29b3d27a506e8998c4b050bf7270343b2d3ac3ec"},"x-workbook-bytes":{"schema":{"type":"integer"},"description":"310350"}}}}}}},"components":{"schemas":{"Inputs":{"type":"object","properties":{"gross_residential":{"type":"number","minimum":0,"description":"USD/year, positive gross residential income entered directly; independent of unit rent-roll entries. Publisher baseline 0.","default":0},"gross_commercial":{"type":"number","minimum":0,"description":"USD/year, positive gross commercial income. Publisher baseline 0.","default":0},"other_rental":{"type":"number","minimum":0,"description":"USD/year, positive other rental income. Publisher baseline 0.","default":0},"residential_vacancy":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1, residential vacancy deduction applied to gross residential. Publisher baseline 0.05.","default":0.05},"commercial_vacancy_amount":{"type":"number","minimum":0,"description":"USD/year, positive commercial vacancy deduction; independent of the separate proforma commercial vacancy fraction. Publisher baseline 0.","default":0},"laundry":{"type":"number","minimum":0,"description":"USD/year, positive laundry income. Publisher baseline 0.","default":0},"advertising":{"type":"number","minimum":0,"description":"USD/year, positive advertising operating disbursement deducted from income. Publisher baseline 0.","default":0},"office_telephone":{"type":"number","minimum":0,"description":"USD/year, positive office telephone operating disbursement deducted from income. Publisher baseline 0.","default":0},"management":{"type":"number","minimum":0,"description":"USD/year, positive management operating disbursement deducted from income. Publisher baseline 0.","default":0},"legal":{"type":"number","minimum":0,"description":"USD/year, positive legal operating disbursement deducted from income. Publisher baseline 0.","default":0},"audit":{"type":"number","minimum":0,"description":"USD/year, positive audit operating disbursement deducted from income. Publisher baseline 0.","default":0},"misc_admin":{"type":"number","minimum":0,"description":"USD/year, positive misc admin operating disbursement deducted from income. Publisher baseline 0.","default":0},"fuel_oil":{"type":"number","minimum":0,"description":"USD/year, positive fuel oil operating disbursement deducted from income. Publisher baseline 0.","default":0},"electricity":{"type":"number","minimum":0,"description":"USD/year, positive electricity operating disbursement deducted from income. Publisher baseline 0.","default":0},"water":{"type":"number","minimum":0,"description":"USD/year, positive water operating disbursement deducted from income. Publisher baseline 0.","default":0},"gas":{"type":"number","minimum":0,"description":"USD/year, positive gas operating disbursement deducted from income. Publisher baseline 0.","default":0},"sewer":{"type":"number","minimum":0,"description":"USD/year, positive sewer operating disbursement deducted from income. Publisher baseline 0.","default":0},"maintenance_supplies":{"type":"number","minimum":0,"description":"USD/year, positive maintenance supplies operating disbursement deducted from income. Publisher baseline 0.","default":0},"maintenance_contracts":{"type":"number","minimum":0,"description":"USD/year, positive maintenance contracts operating disbursement deducted from income. Publisher baseline 0.","default":0},"rubbish":{"type":"number","minimum":0,"description":"USD/year, positive rubbish operating disbursement deducted from income. Publisher baseline 0.","default":0},"security":{"type":"number","minimum":0,"description":"USD/year, positive security operating disbursement deducted from income. Publisher baseline 0.","default":0},"repairs":{"type":"number","minimum":0,"description":"USD/year, positive repairs operating disbursement deducted from income. Publisher baseline 0.","default":0},"elevator":{"type":"number","minimum":0,"description":"USD/year, positive elevator operating disbursement deducted from income. Publisher baseline 0.","default":0},"hvac":{"type":"number","minimum":0,"description":"USD/year, positive hvac operating disbursement deducted from income. Publisher baseline 0.","default":0},"grounds":{"type":"number","minimum":0,"description":"USD/year, positive grounds operating disbursement deducted from income. Publisher baseline 0.","default":0},"painting":{"type":"number","minimum":0,"description":"USD/year, positive painting operating disbursement deducted from income. Publisher baseline 0.","default":0},"vehicles":{"type":"number","minimum":0,"description":"USD/year, positive vehicles operating disbursement deducted from income. Publisher baseline 0.","default":0},"misc_maintenance":{"type":"number","minimum":0,"description":"USD/year, positive misc maintenance operating disbursement deducted from income. Publisher baseline 0.","default":0},"office_salaries":{"type":"number","minimum":0,"description":"USD/year, positive office salaries operating disbursement deducted from income. Publisher baseline 0.","default":0},"manager_salaries":{"type":"number","minimum":0,"description":"USD/year, positive manager salaries operating disbursement deducted from income. Publisher baseline 0.","default":0},"employee_free_rent":{"type":"number","minimum":0,"description":"USD/year, positive employee free rent operating disbursement deducted from income. Publisher baseline 0.","default":0},"maintenance_salaries":{"type":"number","minimum":0,"description":"USD/year, positive maintenance salaries operating disbursement deducted from income. Publisher baseline 0.","default":0},"payroll_tax":{"type":"number","minimum":0,"description":"USD/year, positive payroll tax operating disbursement deducted from income. Publisher baseline 0.","default":0},"workers_comp":{"type":"number","minimum":0,"description":"USD/year, positive workers comp operating disbursement deducted from income. Publisher baseline 0.","default":0},"benefits":{"type":"number","minimum":0,"description":"USD/year, positive benefits operating disbursement deducted from income. Publisher baseline 0.","default":0},"real_estate_tax":{"type":"number","minimum":0,"description":"USD/year, positive real estate tax operating disbursement deducted from income. Publisher baseline 0.","default":0},"insurance":{"type":"number","minimum":0,"description":"USD/year, positive insurance operating disbursement deducted from income. Publisher baseline 0.","default":0},"misc_tax":{"type":"number","minimum":0,"description":"USD/year, positive misc tax operating disbursement deducted from income. Publisher baseline 0.","default":0},"supportive_services":{"type":"number","minimum":0,"description":"USD/year, positive supportive services operating disbursement deducted from income. Publisher baseline 0.","default":0},"replacement_reserve":{"type":"number","minimum":0,"description":"USD/year, positive replacement reserve operating disbursement deducted from income; reserve is included in publisher NOI. Publisher baseline 0.","default":0},"investor_fee":{"type":"number","minimum":0,"description":"USD/year, positive investor fee operating disbursement deducted from income. Publisher baseline 0.","default":0},"broadband":{"type":"number","minimum":0,"description":"USD/year, positive broadband operating disbursement deducted from income. Publisher baseline 0.","default":0},"other_expense":{"type":"number","minimum":0,"description":"USD/year, positive other expense operating disbursement deducted from income. Publisher baseline 0.","default":0},"primary_debt":{"type":"number","minimum":0,"description":"USD/year, positive primary debt service disbursement deducted after NOI. Publisher baseline 0.","default":0},"service_fee":{"type":"number","minimum":0,"description":"USD/year, positive service fee debt/service disbursement deducted after NOI. Publisher baseline 0.","default":0},"credit_enhancement":{"type":"number","minimum":0,"description":"USD/year, positive credit enhancement debt/service disbursement deducted after NOI. Publisher baseline 0.","default":0},"other_service_fee":{"type":"number","minimum":0,"description":"USD/year, positive other service fee debt/service disbursement deducted after NOI. Publisher baseline 0.","default":0},"pennhomes_debt":{"type":"number","minimum":0,"description":"USD/year, positive PennHOMES secondary debt service disbursement deducted after NOI. Publisher baseline 0.","default":0},"secondary_other_1":{"type":"number","minimum":0,"description":"USD/year, positive secondary other 1 debt/service disbursement deducted after NOI. Publisher baseline 0.","default":0},"secondary_other_2":{"type":"number","minimum":0,"description":"USD/year, positive secondary other 2 debt/service disbursement deducted after NOI. Publisher baseline 0.","default":0},"residential_growth":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1 per year, residential/laundry and management-fee escalation. Publisher baseline 0.02.","default":0.02},"commercial_growth":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1 per year, commercial/other rental escalation. Publisher baseline 0.02.","default":0.02},"expense_growth":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1 per year, operating expense escalation excluding management and replacement reserve. Publisher baseline 0.03.","default":0.03},"proforma_residential_vacancy":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1, independent proforma residential vacancy control; set alongside budget vacancy to align. Publisher baseline 0.05.","default":0.05},"proforma_commercial_vacancy":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1, independent proforma commercial vacancy control; does not update budget commercial vacancy amount. Publisher baseline 0.1.","default":0.1}},"required":[],"additionalProperties":false},"Outputs":{"type":"object","properties":{"effective_gross_income":{"type":"number","description":"USD/year after budget vacancy plus laundry"},"operating_disbursements":{"type":"number","description":"USD/year positive, includes replacement reserve and investor fees"},"budget_noi":{"type":"number","description":"USD/year, effective income less all operating disbursements"},"primary_debt_total":{"type":"number","description":"USD/year positive primary debt and service fees"},"initial_cashflow":{"type":"number","description":"USD/year signed cash after primary debt"},"budget_dscr":{"type":"number","description":"Ratio NOI / total primary debt; publisher returns zero if denominator zero"},"secondary_cashflow":{"type":"number","description":"USD/year signed cash after primary and secondary debt"},"year1_noi":{"type":"number","description":"USD/year, first 12-month proforma NOI using independent proforma vacancy controls"},"year1_dscr":{"type":"number","description":"Ratio first-year NOI / total primary debt; publisher returns zero if primary_debt alone is zero"},"year1_secondary_cashflow":{"type":"number","description":"USD/year signed first-year cash after all debt"},"year2_noi":{"type":"number","description":"USD/year second-year NOI; replacement reserve grows by fixed 3 percent regardless of expense_growth"},"year2_secondary_cashflow":{"type":"number","description":"USD/year signed second-year cash after all debt"},"year2_dscr":{"type":"number","description":"Ratio second-year NOI / total primary debt; publisher returns zero if primary_debt alone is zero"}},"required":["effective_gross_income","operating_disbursements","budget_noi","primary_debt_total","initial_cashflow","budget_dscr","secondary_cashflow","year1_noi","year1_dscr","year1_secondary_cashflow","year2_noi","year2_secondary_cashflow","year2_dscr"],"additionalProperties":false}}}}