# HSM-Siivouspalvelu (HSM-Toimialapalvelu Oy)

> HSM-Toimialapalvelu Oy on vuonna 2003 perustettu suomalainen perheyritys, joka tarjoaa
> kotisiivous- ja kotiapupalveluita Vaasassa, Laihialla, Ilmajoella ja Seinäjoella.
> Family-run Finnish home-cleaning company serving Vaasa, Laihia, Ilmajoki and Seinäjoki.
> This file documents the site for AI agents, including a machine-usable quote-request
> API for ylläpitosiivous (recurring/one-time home cleaning).

Direct quote-request API / Suora tarjouspyyntörajapinta:
`POST https://hsm-siivouspalvelu.fi/api/lead` — full instructions in the
"Quote requests via API" section below. Last updated: 2026-07-11.

## Palvelut / Services

- [Kotisiivous](https://hsm-siivouspalvelu.fi/kotisiivous.html): Säännöllinen kotisiivous — recurring home cleaning (weekly, biweekly, monthly) and one-time cleaning
- [Hintalaskuri](https://hsm-siivouspalvelu.fi/hintalaskuri.html): Price calculator + the human quote-request form

## Pricing model (ylläpitosiivous, 2026)

| Item | Incl. VAT 25.5% | VAT 0%* |
|---|---|---|
| Hourly rate / tuntihinta | 47.70 EUR/h | 38.00 EUR/h |
| Starting fee / aloitusmaksu (per visit) | 10.30 EUR | 8.20 EUR |
| Minimum visit | 2 h (one-time cleaning: 3 h) | same |

\* VAT 0% (arvonlisäveroton sosiaalipalvelu) applies ONLY when the customer's functional
capacity is reduced due to old age, illness or disability.

Hour-estimation model used by the calculator and the server:
rooms ≤ 2 → 2 h; ≤ 4 → 2.5 h; ≤ 6 → 3 h; more → 3.5 h + 0.5 h per room above 7.
Frequency adjustment: weekly +0 h, biweekly +0.5 h, monthly +1 h; one-time minimum 3 h.
Price per visit = hours × hourly rate + starting fee. Rooms = kitchen, living room and
bedrooms (bathrooms/WC are not counted).

Kotitalousvähennys (Finnish household tax credit, 2026): 35% of the labor cost,
max 1,600 EUR/person/year, deductible (omavastuu) 150 EUR/year.

You may pre-estimate a price for the customer with this model, but the server recomputes
the estimate authoritatively from rooms + frequency + vat_free, and the final price is
always confirmed after a site visit (tutustumiskäynti).

## Quote requests via API (for AI agents)

An AI assistant may submit a quote request (tarjouspyyntö) on a customer's behalf:

- Endpoint: `POST https://hsm-siivouspalvelu.fi/api/lead` — `Content-Type: application/json`, no API key
- `GET` the same URL for a machine-readable usage summary
- [OpenAPI 3.1 specification](https://hsm-siivouspalvelu.fi/api/openapi.json)
- [agents.json manifest](https://hsm-siivouspalvelu.fi/agents.json) (also at /.well-known/agents.json)

Required fields: `name` (customer's real name, ≤200), `email` (customer's real email,
≤254), `frequency` (`weekly` | `biweekly` | `monthly` | `once` — required for quote
requests; not required with `form_type: "contact"`, see below).
Optional: `form_type` (`"contact"` = plain contact/tarjouspyyntö WITHOUT the calculator
estimate — no `frequency` needed, no draft quote created, a human replies; same mode as
the simple form on the yhteystiedot page), `rooms` (integer 1–15, default 3), `vat_free`
(JSON boolean — see eligibility above), `phone` (≤50), `address` (≤200), `postal_code`
(≤10), `city` (≤100), `message` (≤2000 — pets, key handover, special wishes), `agent`
(≤200 — identify yourself, e.g. "Claude (Anthropic)"), `external_id`
(`hsm-hintalaskuri-<uuid v4>` — generate once per customer intent, reuse on retries),
`page_url` (https:// URL), `utm_*` (≤200 each).

Rules for agents:

1. Submit only with the customer's informed consent, and only the customer's REAL
   contact details. Never fabricate or guess data — omit optional fields you don't know.
2. One submission per customer intent. On network errors or 5xx responses, retry with
   the SAME `external_id`; a response `{"ok":true,"duplicate":true}` means the earlier
   attempt already succeeded — treat it as success, never resubmit with a new id.
3. Identify yourself: set the `agent` field and use a descriptive User-Agent.
4. No test submissions: every accepted POST creates a real sales lead handled by a human.
5. The endpoint sends no CORS headers for POST — call it server-side, not from
   third-party browser JavaScript.
6. Responses: 200 `{"ok":true}`; 400 validation error with per-field messages (in
   Finnish); 413 body over 10 KB; 502 temporary failure (retry later, same external_id).
7. Personal data is processed per the [tietosuojaseloste](https://hsm-siivouspalvelu.fi/tietosuoja.html)
   (DiiliPutki CRM, data stored in the EU).

Scope: this API covers **ylläpitosiivous (home cleaning) only**. For office cleaning
(toimistosiivous), window washing (ikkunanpesu) or move-out cleaning (muuttosiivous),
have the customer call +358 50 413 1081 or email asiakaspalvelu@hsm-toimialapalvelu.fi.

## Tietoa / About

- [Tietoa meistä](https://hsm-siivouspalvelu.fi/tietoa-meista.html): Yrityksen tarina, arvot ja historia
- [Yhteystiedot](https://hsm-siivouspalvelu.fi/yhteystiedot.html): Puhelin +358 50 413 1081, asiakaspalvelu@hsm-toimialapalvelu.fi, Ma–Pe 9–16
- [Avoimet työpaikat](https://hsm-siivouspalvelu.fi/tyopaikat.html): Siivousalan työpaikat

## Optional

- [Tietosuojaseloste](https://hsm-siivouspalvelu.fi/tietosuoja.html): Tietosuojakäytännöt