{"openapi":"3.1.0","info":{"title":"WHEDA 2027 Project Concept Multifamily Operating Cashflow (2027)","version":"2027.1.0","description":"First-year residential NOI, debt coverage and cash after debt for one 60%-CMI rent cohort with selected annual expenses. Set income_tier=0.6 to route rents into the publisher summary. All omitted expenses, other income and cohorts remain blank/zero. First-loan debt service uses monthly level payments and requires payment_schedule=Must Pay/Hard Debt; reserves reduce NOI. This bounded calculation uses the 2027 Project Concept Multifamily Application; it does not validate rents, complete underwriting, credit eligibility or approval. Catalog calculations, not certification; no WHEDA 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":"Wisconsin Housing and Economic Development Authority (WHEDA)","publisherPageUrl":"https://www.wheda.com/developers-and-property-managers/tax-credits/htc/allocating/2027/2027-program","sourceUrl":"https://www.wheda.com/globalassets/documents/tax-credits/htc/2027/2027-multifamily-application.xlsx","publishedDate":"2026-10-02","dateNotes":"Internal modified date, not a confirmed publication date. Source label: 2027 Project Concept Multifamily Application.","workbookFilename":"2027-multifamily-application.xlsx","workbookSha256":"ce066131c25fb5f9e962809958b5f8ce6b7e620231a0dfccb149331349dd8662","workbookBytes":2618604,"format":"xlsx","licenseClass":"reference-only","rightsNotes":"The publisher's website terms reserve rights in site content. This entry is listed for reference only; downloads go to the publisher's website. It is removed on the publisher's request."},"x-formualizer-VerificationLevel":"scenario-independent-arithmetic","x-formualizer-WorkbookDownload":{"mode":"publisher-redirect","sourceUrl":"https://www.wheda.com/globalassets/documents/tax-credits/htc/2027/2027-multifamily-application.xlsx","sha256":"ce066131c25fb5f9e962809958b5f8ce6b7e620231a0dfccb149331349dd8662","bytes":2618604},"x-formualizer-Flows":[{"id":"quick_operating_cashflow","title":"Single-cohort first-year operating cashflow","kind":"single","inputPorts":["units","monthly_rent","income_tier","vacancy","management","electricity","maintenance","taxes","insurance","annual_reserve","loan_principal","loan_rate","amortization_years","payment_schedule"],"outputPorts":["effective_income","operating_expenses","noi","total_debt_service","cash_after_debt","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_cashflow)","schema":{"type":"string","enum":["quick_operating_cashflow"],"default":"quick_operating_cashflow"}}],"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":["wi-multifamily-application"]}},{"name":"edition","in":"path","required":true,"schema":{"type":"string","enum":["2027"]}}],"responses":{"302":{"description":"Publisher redirect; no workbook bytes in response","headers":{"Location":{"schema":{"type":"string","format":"uri"}},"x-workbook-sha256":{"schema":{"type":"string"},"description":"ce066131c25fb5f9e962809958b5f8ce6b7e620231a0dfccb149331349dd8662"},"x-workbook-bytes":{"schema":{"type":"integer"},"description":"2618604"}}}}}}},"components":{"schemas":{"Inputs":{"type":"object","properties":{"units":{"type":"integer","minimum":0,"description":"Whole units in a single cohort; all other cohorts remain empty. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"monthly_rent":{"type":"number","minimum":0,"description":"USD/unit/month, positive monthly net rent; no utility allowance is added to income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"income_tier":{"type":"number","enum":[0,0.6],"description":"Decimal fraction. Set 0.6 to activate this cohort in the 60% CMI rent summary. Baseline 0 represents blank/unclassified; rent does not flow into income until a recognized tier is selected. This is a routing assumption, not rent-limit validation. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"vacancy":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction 0..1 of gross residential rent deducted for vacancy. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0.07},"management":{"type":"number","minimum":0,"description":"USD/year, positive residential management expense deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"electricity":{"type":"number","minimum":0,"description":"USD/year, positive electricity expense deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"maintenance":{"type":"number","minimum":0,"description":"USD/year, positive maintenance contract expense deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"taxes":{"type":"number","minimum":0,"description":"USD/year, positive real estate and personal property taxes deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"insurance":{"type":"number","minimum":0,"description":"USD/year, positive property/liability insurance deducted from income. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"annual_reserve":{"type":"number","minimum":0,"description":"USD/year, positive annual replacement reserve; publisher deducts this in operating expenses before NOI. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"loan_principal":{"type":"number","minimum":0,"description":"USD, positive first permanent loan principal. Other loans remain zero. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"loan_rate":{"type":"number","minimum":0,"maximum":1,"description":"Decimal fraction annual interest rate; monthly level payments are assumed. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"amortization_years":{"type":"number","minimum":0,"maximum":50,"description":"Years, monthly amortization period; zero retains blank-baseline debt service. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":0},"payment_schedule":{"type":"string","enum":["","Must Pay/Hard Debt"],"description":"Set Must Pay/Hard Debt to activate annual first-loan debt service. Blank baseline produces zero service. All omitted costs, other income and cohorts retain publisher blank/zero defaults.","default":""}},"required":[],"additionalProperties":false},"Outputs":{"type":"object","properties":{"effective_income":{"type":"number","description":"USD/year, residential income after vacancy."},"operating_expenses":{"type":"number","description":"USD/year, selected operating expenses plus replacement reserve."},"noi":{"type":"number","description":"USD/year, income minus operating expenses including reserve."},"total_debt_service":{"type":"number","description":"USD/year, annual debt payments excluding TIF."},"cash_after_debt":{"type":"number","description":"USD/year, NOI minus annual debt; negative is a shortfall."},"dscr":{"type":"number","description":"Ratio, NOI divided by debt rounded to three decimals; publisher returns zero at zero debt."}},"required":["effective_income","operating_expenses","noi","total_debt_service","cash_after_debt","dscr"],"additionalProperties":false}}}}