a1-yandex-kitlisted

# A1 Yandex KIT Skills ## Communication Before producing any user-facing message, read and apply [`references/merchant-communication.md`](references/merchant-communication.md) completely. Yandex KIT (kit.yandex.ru, beta) is Yandex's e-commerce store builder — effectively a Russian Shopify. Its REST API is a server-to-server layer for syncing catalog, stocks and prices and for managing orders between a merchant's backend and the platform. The official docs are in Russian; the full OpenAPI spec (160 operations) is bundled with this skill in `data/kit_v1.json.gz` and searchable offline with the scripts below. ## API essentials - **Base URL**: `https://api.kit.yandex.net`, every path is prefixed with `/v1/`. - **Auth**: `Authorization: Bearer <token>` (plain HTTP Bearer, not OAuth). The token is generated in the merchant cabinet: **Settings → API → Generate token** — it is shown **only once**, store it securely and generate a new one if lost. - **Rate limit**: 3 requests per second per store, no quota headers. Exceeding it returns code `LIMIT_EXCEEDED` with **HTTP 400 (not 429)** — throttle client-side and detect the error by its `code`, not by the status. - **Error contract**: every error is JSON `{"code", "message", "trace_id"}`. Codes: `AUTHENTICATION_ERROR` (401), `FORBIDDEN_ERROR` (403), `VALIDATION_ERROR` (400), `LIMIT_EXCEEDED` (400), `UNSUPPORTED_MEDIA_TYPE` (415), `NOT_FOUND` (404), `CONFLICT` (409), `UNKNOWN_ERROR` (500). Quote `trace_id` when contact