{
  "openapi": "3.0.3",
  "info": {
    "title": "ForEDU – wycena szkolenia zamkniętego (MS Excel i analiza danych)",
    "version": "1.0.0",
    "description": "Wycena szkoleń zamkniętych z MS Excel (i analizy danych) U KLIENTA – trener dojeżdża z ForEDU w Łodzi; sprzęt (laptopy) zapewnia ForEDU; każde szkolenie (jedna grupa) trwa 16 h dydaktycznych przez 2 dni, 9:00–16:00.\nQuote for closed MS Excel (and data analysis) training AT THE CLIENT'S LOCATION – trainer travels from ForEDU in Łódź; ForEDU provides laptops; each training (one group) is 16 teaching hours over 2 days, 9:00–16:00.\n\nOrientacyjna cena szkolenia zamkniętego z MS Excel i analizy danych dla 1, 2, 3 i 4 grup z rozbiciem na składowe (szkolenia, dodatkowe osoby, dojazd trenera z hotelem, projektor). Kwoty w PLN brutto, VAT ZW. Wiążąca wycena i zamówienie wyłącznie przez https://www.foredu.pl/zapisy/zapisz.php.\n\nIndicative price of ForEDU closed in-company MS Excel & data analysis training for 1-4 groups, broken down into components. Amounts in PLN gross, VAT exempt. Binding quote and orders only via https://www.foredu.pl/zapisy/zapisz.php.\n\nWszystkie kwoty (suma_zl) to CENA ŁĄCZNA ZA CAŁĄ GRUPĘ (w sumie), nie za osobę; cena na uczestnika to osobne pole pochodne. Wycena liczona tak samo i z tych samych danych co formularz zapisz.php (ten sam cennik, baza kodów i wzór dojazdu) – dla tego samego kodu, liczby grup, osób i organizacji dnia daje tę samą kwotę (przy trasach >200 km przyjęto kolejne dni pn–pt; terminy z przerwą na weekend mogą podnieść dojazd).\nAll amounts (suma_zl) are the TOTAL price for the whole group(s), not per person; per-participant price is a separate derived field. Calculated exactly like the order form zapisz.php (same price list, postal-code base and travel formula) – same result for the same code, groups, participants and day organisation (for >200 km consecutive Mon–Fri days are assumed; dates split by a weekend may raise travel).",
    "contact": {
      "name": "ForEDU szkolenia komputerowe",
      "email": "biuro@foredu.pl",
      "url": "https://www.foredu.pl/kontakt/"
    }
  },
  "servers": [
    {
      "url": "https://www.foredu.pl"
    }
  ],
  "paths": {
    "/wycena/": {
      "get": {
        "operationId": "wycenaSzkolenia",
        "summary": "Wycena dla kodu pocztowego / price quote for a Polish postal code",
        "description": "Bez parametru kod zwraca przykłady (sala ForEDU w Łodzi, Warszawa 00-002, Kraków 30-001, Gdańsk 80-001). Without kod returns examples.",
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "json"
              ]
            },
            "description": "Ustaw json, aby dostać JSON (bez tego strona HTML) / set to json"
          },
          {
            "name": "kod",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "30-001"
            },
            "description": "Kod pocztowy miejsca szkolenia; liczy się dokładnie 5 cyfr (30001, 30-001, 30 001) / Polish postal code, 5 digits"
          },
          {
            "name": "osoby",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 30,
              "default": 8
            },
            "description": "Osób w grupie / participants per group"
          },
          {
            "name": "projektor",
            "in": "query",
            "schema": {
              "type": "integer",
              "enum": [
                0,
                1
              ],
              "default": 0
            },
            "description": "1 = projektor ForEDU (+300 zł) / add projector"
          },
          {
            "name": "rytm",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1dzien",
                "2dzien"
              ],
              "default": "1dzien"
            },
            "description": "1 grupa dziennie (2 dni na grupę) lub 2 grupy dziennie (4 dni po 4 h) / one or two groups per day"
          }
        ],
        "responses": {
          "200": {
            "description": "Wycena (ok=true) albo błąd (ok=false, blad=postal_code_not_found | invalid_postal_code, z przykładami) / quote or error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Odpowiedz"
                },
                "example": {
                  "ok": true,
                  "waluta": "PLN",
                  "wycena": {
                    "kod_pocztowy": "30-001",
                    "miejscowosci": [
                      "Kraków"
                    ],
                    "warianty": [
                      {
                        "liczba_grup": 1,
                        "osob_w_grupie": 8,
                        "liczba_uczestnikow": 8,
                        "liczba_dni": 2,
                        "godzin_dydaktycznych": 16,
                        "cena_szkolen_zl": 2800,
                        "doplata_za_dodatkowe_osoby_zl": 0,
                        "dojazd_trenera_zl": 1130,
                        "projektor_zl": 0,
                        "suma_zl": 3930,
                        "cena_za_jedno_szkolenie_zl": 3930,
                        "cena_za_uczestnika_zl": 491,
                        "cena_za_godzine_szkoleniowa_zl": 246,
                        "zakres_ceny": "cena łączna za całą grupę / total for whole group(s)"
                      }
                    ]
                  },
                  "price_scope": "total_for_whole_group(s)"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Wariant": {
        "type": "object",
        "properties": {
          "liczba_grup": {
            "type": "integer",
            "description": "Liczba grup / number of groups (1 grupa = jedno szkolenie: 2 dni × 9:00–16:00 = 16 h dydaktycznych)"
          },
          "osob_w_grupie": {
            "type": "integer",
            "description": "Osób w grupie / participants per group"
          },
          "liczba_uczestnikow": {
            "type": "integer",
            "description": "Łącznie uczestników / total participants"
          },
          "liczba_dni": {
            "type": "integer",
            "description": "Liczba dni cyklu / total training days"
          },
          "godzin_dydaktycznych": {
            "type": "integer",
            "description": "Godziny dydaktyczne / teaching hours"
          },
          "cena_szkolen_zl": {
            "type": "integer",
            "description": "Cena szkoleń wg cennika grup [PLN] / training price"
          },
          "doplata_za_dodatkowe_osoby_zl": {
            "type": "integer",
            "description": "Dopłata za osoby ponad 8 w grupie [PLN] / surcharge for extra participants"
          },
          "dojazd_trenera_zl": {
            "type": "integer",
            "description": "Dojazd trenera z Łodzi, z hotelem gdy dotyczy [PLN] / trainer travel incl. hotel"
          },
          "projektor_zl": {
            "type": "integer",
            "description": "Projektor ForEDU [PLN] / projector"
          },
          "suma_zl": {
            "type": "integer",
            "description": "CENA ŁĄCZNA ZA CAŁĄ GRUPĘ (wszystkie grupy wariantu, w sumie), brutto VAT ZW [PLN] – nie za osobę / TOTAL price for the whole group(s), gross, VAT exempt – not per person"
          },
          "cena_za_jedno_szkolenie_zl": {
            "type": "integer",
            "description": "Suma / liczba grup [PLN] / total per course"
          },
          "cena_za_uczestnika_zl": {
            "type": "integer",
            "description": "Pole pochodne: cena łączna / liczba uczestników [PLN] (cena za osobę) / derived: total / participants (price per person)"
          },
          "cena_za_godzine_szkoleniowa_zl": {
            "type": "integer",
            "description": "Suma / godziny dydaktyczne [PLN] / total per teaching hour"
          },
          "zakres_ceny": {
            "type": "string",
            "description": "Zakres ceny: łączna za całą grupę / price scope: total for whole group(s)"
          }
        }
      },
      "Lokalizacja": {
        "type": "object",
        "properties": {
          "kod_pocztowy": {
            "type": "string",
            "nullable": true,
            "description": "Kod pocztowy NN-NNN (null = sala ForEDU w Łodzi) / postal code"
          },
          "miejsce": {
            "type": "string",
            "description": "Opis miejsca / place"
          },
          "miejscowosci": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Miejscowości przypisane do kodu / localities for the postal code"
          },
          "warianty": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Wariant"
            },
            "description": "Warianty dla 1, 2, 3 i 4 grup / variants for 1-4 groups"
          }
        }
      },
      "Odpowiedz": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean"
          },
          "blad": {
            "type": "string",
            "enum": [
              "postal_code_not_found",
              "invalid_postal_code"
            ]
          },
          "komunikat": {
            "type": "string",
            "description": "Komunikat dla użytkownika (z telefonem i e-mailem biura) / user message"
          },
          "waluta": {
            "type": "string",
            "example": "PLN"
          },
          "vat": {
            "type": "string"
          },
          "parametry": {
            "type": "object"
          },
          "wycena": {
            "$ref": "#/components/schemas/Lokalizacja"
          },
          "przyklady": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Lokalizacja"
            }
          },
          "szkolenie": {
            "type": "object",
            "description": "Opis szkolenia i zasady cennika / course description and pricing rules"
          },
          "pola": {
            "type": "object",
            "description": "Opisy pól PL/EN / field descriptions"
          },
          "zamowienie": {
            "type": "object",
            "description": "Gdzie złożyć wiążące zamówienie / where to place a binding order"
          },
          "kontakt": {
            "type": "object"
          },
          "price_scope": {
            "type": "string",
            "enum": [
              "total_for_whole_group(s)"
            ],
            "description": "Kwoty są łączne za całą grupę, nie za osobę / amounts are totals for the whole group(s)"
          },
          "zakres_ceny": {
            "type": "object",
            "description": "Wyjaśnienie zakresu ceny PL/EN / price scope explanation"
          },
          "consistency": {
            "type": "object",
            "description": "Zgodność z formularzem zapisz.php (ten sam cennik, baza i wzór) PL/EN / consistency with the order form"
          },
          "zakres_oferty": {
            "type": "string",
            "description": "Zakres oferty: szkolenie MS Excel u klienta, laptopy ForEDU, 16 h / 2 dni 9:00–16:00 (PL)"
          },
          "scope": {
            "type": "string",
            "description": "Offer scope: MS Excel training at client's site, laptops provided, 16 h / 2 days 9:00–16:00 (EN)"
          },
          "cennik_na_dzien": {
            "type": "string",
            "format": "date",
            "description": "Data, na którą obowiązuje cennik (zawsze bieżąca data serwera, czas polski) / price list valid as of (current server date, Europe/Warsaw)"
          }
        }
      }
    }
  }
}