{
	"openapi": "3.1.0",
	"info": {
		"title": "HOAI-Berechnung von projekt-einfach.de",
		"version": "1.0.0",
		"description": "Honorarberechnung nach HOAI 2021 und 2013 mit derselben Rechenlogik wie der HOAI-Rechner auf https://www.projekt-einfach.de/HOAI-Rechner/. Kostenlos, ohne Anmeldung, es wird keine Berechnung gespeichert. Bis zu 5 Berechnungen nebeneinander: Parameter ohne Nummer gelten für alle, kosten2, zone2, satz2 usw. nur für die jeweilige Berechnung. Höchstens 60 Anfragen pro Stunde und 300 pro Tag je IP-Adresse. Jede Antwort enthält quellenangabe und rechner_link für die Weitergabe des Ergebnisses. Die Berechnung ist eine unverbindliche Orientierung; seit der HOAI 2021 ist das Honorar frei vereinbar."
	},
	"servers": [
		{
			"url": "https://www.projekt-einfach.de"
		}
	],
	"paths": {
		"/HOAI-Rechner/Berechnung/": {
			"get": {
				"operationId": "hoaiBerechnen",
				"summary": "HOAI-Honorar berechnen",
				"description": "Berechnet das Honorar nach HOAI für eine oder mehrere Berechnungen (Beispiel: ?kosten=25000&kosten2=35000&zone=1&satz=100&lph=1-7). Ohne Parameter liefert die Adresse die Beschreibung aller Parameter als JSON, mit leistungen=liste&paragraph=56 alle Teilleistungen eines Leistungsbilds mit Kürzel, Text und Prozentsatz.",
				"parameters": [
					{
						"name": "kosten",
						"in": "query",
						"required": false,
						"description": "Anrechenbare Kosten in Euro netto, zum Beispiel 25000 oder 25000.50. Pflicht für eine Berechnung (für die erste; ohne Nummer gilt der Wert für alle Berechnungen).",
						"schema": {
							"type": "number"
						},
						"example": 25000
					},
					{
						"name": "paragraph",
						"in": "query",
						"required": false,
						"description": "Leistungsbild: 35, 351 (§ 35 Innenräume), 40, 44, 48, 52 oder 56. Standard 56.",
						"schema": {
							"type": "string"
						},
						"example": "56"
					},
					{
						"name": "zone",
						"in": "query",
						"required": false,
						"description": "Honorarzone 1 bis 5 (bei § 56 nur 1 bis 3). Standard 2.",
						"schema": {
							"type": "integer"
						},
						"example": 1
					},
					{
						"name": "satz",
						"in": "query",
						"required": false,
						"description": "Honorarsatz in Prozent zwischen Basishonorarsatz (0) und oberem Honorarsatz (100): 0, 25, 50, 75 oder 100. Standard 50.",
						"schema": {
							"type": "integer",
							"enum": [
								0,
								25,
								50,
								75,
								100
							]
						},
						"example": 100
					},
					{
						"name": "lph",
						"in": "query",
						"required": false,
						"description": "Beauftragte Leistungsphasen mit allen Grundleistungen, zum Beispiel 1-9, 1-8 oder 2,3,5-8. Standard 1-9. Nicht zusammen mit leistungen.",
						"schema": {
							"type": "string"
						},
						"example": "1-7"
					},
					{
						"name": "leistungen",
						"in": "query",
						"required": false,
						"description": "Statt lph einzelne Teilleistungen nach Kürzel, zum Beispiel 1-2,3a-3f,3h,4-8. Mit leistungen=liste alle Teilleistungen eines Leistungsbilds mit Kürzel, Text und Prozentsatz.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "nebenkosten",
						"in": "query",
						"required": false,
						"description": "Nebenkosten in Prozent des Honorars. Standard 0.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "umbau",
						"in": "query",
						"required": false,
						"description": "Umbauzuschlag in Prozent des Honorars. Standard 0.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "fassung",
						"in": "query",
						"required": false,
						"description": "Honorarfassung 2021 oder 2013. Standard 2021.",
						"schema": {
							"type": "integer",
							"enum": [
								2021,
								2013
							]
						}
					},
					{
						"name": "name",
						"in": "query",
						"required": false,
						"description": "Optionale Bezeichnung, höchstens 100 Zeichen.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "prozent",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Eigener Prozentsatz je Teilleistung, zum Beispiel prozent[3c]=8. Besondere Leistungen brauchen immer einen.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "stand",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Leistungsstand in ganzen Prozent je Leistungsphase, Bereich oder Teilleistung, zum Beispiel stand[8]=40, stand[1-7]=100, stand[8a]=10. Für alle Leistungsphasen stand[1-9]=50. Das Genauere gilt.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "kosten2",
						"in": "query",
						"required": false,
						"description": "Anrechenbare Kosten der Berechnung 2 in Euro netto (mehrere Berechnungen nebeneinander, zum Beispiel zum Vergleich). Nummern ohne Lücke.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "zone2",
						"in": "query",
						"required": false,
						"description": "Honorarzone der Berechnung 2, sonst gilt zone.",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "satz2",
						"in": "query",
						"required": false,
						"description": "Honorarsatz der Berechnung 2, sonst gilt satz.",
						"schema": {
							"type": "integer",
							"enum": [
								0,
								25,
								50,
								75,
								100
							]
						}
					},
					{
						"name": "lph2",
						"in": "query",
						"required": false,
						"description": "Leistungsphasen der Berechnung 2, sonst gilt lph.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "leistungen2",
						"in": "query",
						"required": false,
						"description": "Teilleistungen der Berechnung 2, sonst gilt leistungen.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "paragraph2",
						"in": "query",
						"required": false,
						"description": "Leistungsbild der Berechnung 2, sonst gilt paragraph.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "fassung2",
						"in": "query",
						"required": false,
						"description": "Honorarfassung der Berechnung 2, sonst gilt fassung.",
						"schema": {
							"type": "integer",
							"enum": [
								2021,
								2013
							]
						}
					},
					{
						"name": "nebenkosten2",
						"in": "query",
						"required": false,
						"description": "Nebenkosten der Berechnung 2 in Prozent, sonst gilt nebenkosten.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "umbau2",
						"in": "query",
						"required": false,
						"description": "Umbauzuschlag der Berechnung 2 in Prozent, sonst gilt umbau.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "name2",
						"in": "query",
						"required": false,
						"description": "Bezeichnung der Berechnung 2; leer lässt die Bezeichnung weg.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "prozent2",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Eigene Prozentsätze der Berechnung 2, zum Beispiel prozent2[3c]=8.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "stand2",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Leistungsstand der Berechnung 2, zum Beispiel stand2[8]=40.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "kosten3",
						"in": "query",
						"required": false,
						"description": "Anrechenbare Kosten der Berechnung 3 in Euro netto (mehrere Berechnungen nebeneinander, zum Beispiel zum Vergleich). Nummern ohne Lücke.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "zone3",
						"in": "query",
						"required": false,
						"description": "Honorarzone der Berechnung 3, sonst gilt zone.",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "satz3",
						"in": "query",
						"required": false,
						"description": "Honorarsatz der Berechnung 3, sonst gilt satz.",
						"schema": {
							"type": "integer",
							"enum": [
								0,
								25,
								50,
								75,
								100
							]
						}
					},
					{
						"name": "lph3",
						"in": "query",
						"required": false,
						"description": "Leistungsphasen der Berechnung 3, sonst gilt lph.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "leistungen3",
						"in": "query",
						"required": false,
						"description": "Teilleistungen der Berechnung 3, sonst gilt leistungen.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "paragraph3",
						"in": "query",
						"required": false,
						"description": "Leistungsbild der Berechnung 3, sonst gilt paragraph.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "fassung3",
						"in": "query",
						"required": false,
						"description": "Honorarfassung der Berechnung 3, sonst gilt fassung.",
						"schema": {
							"type": "integer",
							"enum": [
								2021,
								2013
							]
						}
					},
					{
						"name": "nebenkosten3",
						"in": "query",
						"required": false,
						"description": "Nebenkosten der Berechnung 3 in Prozent, sonst gilt nebenkosten.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "umbau3",
						"in": "query",
						"required": false,
						"description": "Umbauzuschlag der Berechnung 3 in Prozent, sonst gilt umbau.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "name3",
						"in": "query",
						"required": false,
						"description": "Bezeichnung der Berechnung 3; leer lässt die Bezeichnung weg.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "prozent3",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Eigene Prozentsätze der Berechnung 3, zum Beispiel prozent3[3c]=8.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "stand3",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Leistungsstand der Berechnung 3, zum Beispiel stand3[8]=40.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "kosten4",
						"in": "query",
						"required": false,
						"description": "Anrechenbare Kosten der Berechnung 4 in Euro netto (mehrere Berechnungen nebeneinander, zum Beispiel zum Vergleich). Nummern ohne Lücke.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "zone4",
						"in": "query",
						"required": false,
						"description": "Honorarzone der Berechnung 4, sonst gilt zone.",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "satz4",
						"in": "query",
						"required": false,
						"description": "Honorarsatz der Berechnung 4, sonst gilt satz.",
						"schema": {
							"type": "integer",
							"enum": [
								0,
								25,
								50,
								75,
								100
							]
						}
					},
					{
						"name": "lph4",
						"in": "query",
						"required": false,
						"description": "Leistungsphasen der Berechnung 4, sonst gilt lph.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "leistungen4",
						"in": "query",
						"required": false,
						"description": "Teilleistungen der Berechnung 4, sonst gilt leistungen.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "paragraph4",
						"in": "query",
						"required": false,
						"description": "Leistungsbild der Berechnung 4, sonst gilt paragraph.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "fassung4",
						"in": "query",
						"required": false,
						"description": "Honorarfassung der Berechnung 4, sonst gilt fassung.",
						"schema": {
							"type": "integer",
							"enum": [
								2021,
								2013
							]
						}
					},
					{
						"name": "nebenkosten4",
						"in": "query",
						"required": false,
						"description": "Nebenkosten der Berechnung 4 in Prozent, sonst gilt nebenkosten.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "umbau4",
						"in": "query",
						"required": false,
						"description": "Umbauzuschlag der Berechnung 4 in Prozent, sonst gilt umbau.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "name4",
						"in": "query",
						"required": false,
						"description": "Bezeichnung der Berechnung 4; leer lässt die Bezeichnung weg.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "prozent4",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Eigene Prozentsätze der Berechnung 4, zum Beispiel prozent4[3c]=8.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "stand4",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Leistungsstand der Berechnung 4, zum Beispiel stand4[8]=40.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "kosten5",
						"in": "query",
						"required": false,
						"description": "Anrechenbare Kosten der Berechnung 5 in Euro netto (mehrere Berechnungen nebeneinander, zum Beispiel zum Vergleich). Nummern ohne Lücke.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "zone5",
						"in": "query",
						"required": false,
						"description": "Honorarzone der Berechnung 5, sonst gilt zone.",
						"schema": {
							"type": "integer"
						}
					},
					{
						"name": "satz5",
						"in": "query",
						"required": false,
						"description": "Honorarsatz der Berechnung 5, sonst gilt satz.",
						"schema": {
							"type": "integer",
							"enum": [
								0,
								25,
								50,
								75,
								100
							]
						}
					},
					{
						"name": "lph5",
						"in": "query",
						"required": false,
						"description": "Leistungsphasen der Berechnung 5, sonst gilt lph.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "leistungen5",
						"in": "query",
						"required": false,
						"description": "Teilleistungen der Berechnung 5, sonst gilt leistungen.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "paragraph5",
						"in": "query",
						"required": false,
						"description": "Leistungsbild der Berechnung 5, sonst gilt paragraph.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "fassung5",
						"in": "query",
						"required": false,
						"description": "Honorarfassung der Berechnung 5, sonst gilt fassung.",
						"schema": {
							"type": "integer",
							"enum": [
								2021,
								2013
							]
						}
					},
					{
						"name": "nebenkosten5",
						"in": "query",
						"required": false,
						"description": "Nebenkosten der Berechnung 5 in Prozent, sonst gilt nebenkosten.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "umbau5",
						"in": "query",
						"required": false,
						"description": "Umbauzuschlag der Berechnung 5 in Prozent, sonst gilt umbau.",
						"schema": {
							"type": "number"
						}
					},
					{
						"name": "name5",
						"in": "query",
						"required": false,
						"description": "Bezeichnung der Berechnung 5; leer lässt die Bezeichnung weg.",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "prozent5",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Eigene Prozentsätze der Berechnung 5, zum Beispiel prozent5[3c]=8.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					},
					{
						"name": "stand5",
						"in": "query",
						"required": false,
						"style": "deepObject",
						"explode": true,
						"description": "Leistungsstand der Berechnung 5, zum Beispiel stand5[8]=40.",
						"schema": {
							"type": "object",
							"additionalProperties": {
								"type": "string"
							}
						}
					}
				],
				"responses": {
					"200": {
						"description": "Ergebnis (nur Werte) mit quellenangabe, rechner_link, berechnungen und haftungsausschluss. Ohne Parameter: Beschreibung der Adresse; mit leistungen=liste: Liste der Teilleistungen.",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"properties": {
										"quellenangabe": {
											"type": "string",
											"description": "Fertiger Text mit projekt-einfach.de als Quelle und dem Link zur Berechnung"
										},
										"rechner_link": {
											"type": "string",
											"description": "Öffnet die Berechnungen im HOAI-Rechner zum Prüfen, Anpassen und als PDF"
										},
										"berechnungen": {
											"type": "array",
											"items": {
												"type": "object",
												"properties": {
													"bezeichnung": {
														"type": "string"
													},
													"eingaben": {
														"type": "object"
													},
													"honorartafel": {
														"type": "object",
														"properties": {
															"basishonorarsatz": {
																"type": "number"
															},
															"oberer_honorarsatz": {
																"type": "number"
															},
															"honorar_100_prozent": {
																"type": "number"
															}
														}
													},
													"leistungsphasen": {
														"type": "array",
														"items": {
															"type": "object",
															"properties": {
																"lph": {
																	"type": "integer"
																},
																"prozent": {
																	"type": "number"
																},
																"honorar": {
																	"type": "number"
																},
																"honorar_leistungsstand": {
																	"type": "number"
																},
																"teilleistungen": {
																	"type": "array",
																	"items": {
																		"type": "object"
																	}
																}
															}
														}
													},
													"prozent_summe": {
														"type": "number"
													},
													"honorar": {
														"type": "number"
													},
													"nebenkosten": {
														"type": "number"
													},
													"umbauzuschlag": {
														"type": "number"
													},
													"honorar_gesamt_netto": {
														"type": "number",
														"description": "Honorar mit Nebenkosten und Umbauzuschlag, netto"
													},
													"honorar_leistungsstand": {
														"type": "number"
													},
													"rechner_link": {
														"type": "string",
														"description": "Nur bei verschiedenen Leistungsbildern: Link je Berechnung"
													}
												}
											}
										},
										"hinweise": {
											"type": "array",
											"items": {
												"type": "string"
											}
										},
										"haftungsausschluss": {
											"type": "string"
										}
									}
								}
							}
						}
					},
					"400": {
						"description": "Eingabefehler mit Erklärung in fehler",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"properties": {
										"fehler": {
											"type": "array",
											"items": {
												"type": "string"
											}
										}
									}
								}
							}
						}
					},
					"429": {
						"description": "Begrenzung erreicht, Retry-After beachten"
					}
				}
			}
		}
	}
}
