Schemas

От 1 до 10 детей

Счёт каждому ребёнку: min | full | none (как у одной брони)

Поселить вместе детей семьи, попавших на одну смену

Брони в порядке детей запроса

Ребёнка теперь ведёт другой отдел: бронь остаётся в ваших списках (это ваша продажа), но телефоны родителя и плательщика скрыты

Остаток: total − paid. Отрицательный — переплата

До какой даты внести всю сумму

Ваши метки: до 20 пар «ключ — значение»

Оплачено: все платежи брони, включая ещё не сверенные бухгалтерией

awaiting — место придержано и ждёт минимальный платёж; secured — минимум внесён, место закреплено; unpaid — не оплачена в срок, место вернулось в квоту. Список может пополняться

Цена путёвки

active — действует, cancelled — отменена. Список может пополняться

К оплате всего: цена + трансфер − скидка

Версия записи. Передайте её в If-Match правки или отмены: если бронь успели изменить, ответ будет 412

Путёвка в карточке брони (кратко; полностью — GET /bookings/{id}/voucher).

Номер путёвки: смена-порядковый номер

Причина отмены

Номер записи в вашей CRM. Уникален внутри отдела

До какого момента держится место без минимального платежа

Кто продал бронь в вашей CRM — как вы его прислали

Телефон плательщика, если платит не родитель: на него уходят счета Kaspi. Нет — платит родитель (или контакты скрыты, см. contacts_hidden)

Номер отряда; нет — ещё не назначен

Город из справочника.

Карточка ребёнка; нет — бронь не привязана к семье

Карточка семьи; нет — бронь не привязана к семье

Телефон родителя; нет — контакты скрыты (contacts_hidden)

Номер смены в сезоне

active — действует, cancelled — отменена. Список может пополняться

Нет — бронь без карточки ребёнка (старые записи)

active или cancelled

Версия брони — та же, что в её карточке. Не совпала с вашей — перечитайте бронь

none — не сформирована, generated — сформирована, sent — отправлена. Список может пополняться

Причина отмены — обязательна

Не участвует в проверке. Принимается, чтобы в проверку можно было отправить тот же объект ребёнка, что потом уйдёт в оформление

Не участвует в проверке; принимается по той же причине, что city_id

Тот же код, что вернуло бы оформление: sales_closed, shift_not_open, quota_exhausted, no_quota, duplicate_child, blacklisted, birth_date_implausible. Список может пополняться

Оформление сейчас пройдёт (если за это время место не займут)

Почему нельзя — все причины сразу

Когда ребёнок приехал в лагерь

Когда уехал

Семья ребёнка

Ваши метки: до 20 пар «ключ — значение». Ключ — от 1 до 40 знаков, значение — строка (до 500 знаков), число, true/false или null. Мы их не разбираем: только храним и возвращаем

Нет — дата рождения неизвестна

Номер ребёнка в вашей CRM

Дата рождения — обязательна (birth_date_required): по ней назначается отряд, узнаётся дубль и ребёнок в базе лагеря

Город — из справочника городов

ФИО ребёнка

Номер ребёнка в вашей CRM. null — стереть номер, поле не передано — не менять

Заменяет метки целиком

Номер записи в вашей CRM. Уникален внутри отдела

Счёт Kaspi при оформлении: min — минимальный платёж (по умолчанию, если он у смены задан), full — вся сумма, none — не выставлять

Ваши метки: до 20 пар

Нужен ли трансфер

Кто продал в вашей CRM (до 200 знаков)

Телефон плательщика, если платит не родитель: счета Kaspi уйдут на него

«Поселить вместе» с этими бронями той же смены (ваши брони), не больше 50

Точка посадки — обязательна, если трансфер нужен

Только https://, публичный адрес, без логина и #

Только эти типы событий: любые из Event.type, кроме ping (он приходит только на проверку). Незнакомый тип — отказ bad_event_type. Нет или пусто — все, включая будущие

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

До какой даты внести всю сумму

Срок полной оплаты прошёл, а долг остался

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

awaiting — место придержано до минимального платежа, secured — закреплено. Список может пополняться

К оплате по брони

Что пошло не так (начало ответа вашего сервера или причина сбоя)

Номер события; нет — проверочный ping

Код ответа вашего сервера; нет — ответа не было

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

За что скидка

Сумма скидки в тенге строкой: целое или до двух знаков после точки. Не больше наибольшей скидки смены (max_discount)

За что скидка

Машинный код. Не меняется никогда — по нему ветвится ваша CRM

Текст для человека, по-русски

Номер запроса для обращения в поддержку

Чего касается событие

Номер события — он же место в ленте. Растёт, не повторяется. Повтор доставки узнаётся по нему

Тип события. Сейчас бывают: booking.created, booking.updated, booking.cancelled, booking.restored, booking.moved, booking.hold_expired, booking.secured, booking.removed, invoice.queued, invoice.issued, invoice.paid, invoice.cancelled, invoice.expired, invoice.error, invoice.mismatch, payment.received, payment.refunded, payment.verified, payment.updated, refund_request.created, refund_request.approved, refund_request.rejected, refund_request.cancelled, refund_request.done, refund_request.failed, voucher.ready, voucher.sent, child.checked_in, child.checked_out, child.added, child.removed, shift.seats_changed, shift.status_changed, client.merged, child.merged, kaspi.operations.synced (только главному отделу); ping — только проверка вебхука (POST /webhooks/{id}/test). Список открытый и пополняется: незнакомый тип пропустите, а не падайте

Подробности, которых нет в самой записи. Сейчас бывают: booking.moved — {"from_shift_id": "12"} (с какой смены); client.merged — {"into_id": "812"} (в какую семью слита); kaspi.operations.synced — {"date_from": "2026-06-14", "date_to": "2026-06-14", "count": 37} (за какие дни загружена выписка и сколько в ней операций за эти дни); ping — {"message": "…"}. У остальных — null. Поля только добавляются

Текущий вид записи — тот же, что вернул бы GET по ней, по entity.type: booking — Booking, invoice — Invoice, payment — Payment, refund_request — RefundRequest, child — Child, parent — Family, shift — Shift. null, если запись вам больше не видна (ребёнок ушёл в другой отдел) или у сущности нет вида (ping)

booking, invoice, payment, refund_request, child, parent, shift; webhook — у ping; kaspi_sync — у kaspi.operations.synced (номер загрузки выписки). Список может пополняться

Есть ещё события после этой порции — запросите сразу, не дожидаясь

Передать в after следующего запроса. Совпадает с последним номером в items; если событий не было — с вашим after

Ваши брони детей этой семьи, свежие первыми

Только ваши дети. Брат или сестра, которых ведёт другой отдел, здесь не показываются

Согласие на рассылки

Номера карточек, слитых в эту (дубли семьи). Запрос по старому номеру отвечает этой карточкой

Ваши метки: до 20 пар «ключ — значение». Ключ — от 1 до 40 знаков, значение — строка (до 500 знаков), число, true/false или null. Мы их не разбираем: только храним и возвращаем

Основной телефон, +7XXXXXXXXXX. Ключ узнавания семьи: через API не меняется, второй номер — в extra_phones

Семью ведёт и другой отдел: общие данные семьи скрыты и не правятся

Версия записи для If-Match при правке

Город из справочника.

Номер семьи в вашей CRM

Счёт этому ребёнку; нет — общий invoice запроса

Ваши метки: до 20 пар «ключ — значение». Ключ — от 1 до 40 знаков, значение — строка (до 500 знаков), число, true/false или null. Мы их не разбираем: только храним и возвращаем

Город родителя; null — стереть

Номер семьи в вашей CRM. null — стереть номер, поле не передано — не менять

Вторые номера семьи — заменяют список целиком. Номер, записанный за другой семьёй, не принимается (phone_taken). ФИО, город, согласие и вторые номера семьи, которую ведёт и другой отдел (shared), не правятся (family_shared)

Заменяет метки целиком

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

День оплаты по календарю лагеря (дата, без времени)

prepayment, payment, refund. Список может пополняться

Сверен бухгалтерией

Строки, переданные этому заданию (сейчас или раньше). Проводите только их: остальные ведёт система лагеря или уже взяло другое задание

Номер задания пачки: латиница, цифры и ._:-, до 100 знаков, начинается с буквы или цифры

Ключи строк, не больше 100

Поле брони: child.full_name, parent.phone, discount.amount… Список может пополняться

Новое значение; null — стёрто. Вид — как у old

Прежнее значение; null — не было. Вид — как у поля в брони: строка, число, true/false, метки (объект); денежные поля (price, transfer.fee, discount.amount) — Money {"amount": "119000.00", "currency": "KZT"}

create, update, cancel, restore, copy, ext_ref, voucher_sent… Список может пополняться

Ваше подключение (по имени) или «Лагерь» — для всех сотрудников лагеря и фоновых задач

Что изменилось

Передать в cursor, чтобы получить следующую порцию. Нет — дальше ничего нет

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

Отмену попросили, счёт ещё гасится в Kaspi. Пока это так, его всё ещё можно оплатить

Чем станет оплата: prepayment — предоплата, payment — оплата

Текст, который плательщик видит в Kaspi рядом с суммой

queued — ждёт отправки в Kaspi, issued — у плательщика в Kaspi, paid — оплачен, expired — не оплачен в срок, cancelled — отменён, error — не выставлен, mismatch — Kaspi сообщил о другой сумме, лагерь проверяет. Список может пополняться

Версия записи: меняется при каждом изменении счёта

Что пошло не так или чего счёт ждёт. Нет — всё в порядке

Платёж, созданный оплатой этого счёта

Телефон плательщика, на который ушёл счёт. Пусто, если ребёнок перешёл в другой отдел: контакты семьи вам больше не показываются

Машинный код. Список может пополняться

Текст для человека

Сумма нового счёта

Всегда replacing

Счёт, который гасится. Новый придёт событием invoice.queued

Сумма. Поступление — плюсом, возврат и прочий расход — минусом

День операции по календарю лагеря (Asia/Almaty)

Номер операции в Kaspi

payment — поступление, refund — возврат, other — прочее (в том числе неудавшаяся операция). Список может пополняться

qr — оплата по QR, remote — счёт на телефон, unknown — не определён. Список может пополняться

Время операции

Бронь этого счёта

Комиссия Kaspi, если Kaspi её назвал

Счёт Kaspi лагеря, оплатой которого стала операция

Юрлицо кассы, в выписке которой операция (у лагеря несколько касс Kaspi Pay — у каждой своё юрлицо и свой счёт зачисления). Нет — операция загружена до появления касс

Платёж, созданный оплатой счёта (только у payment)

Передать в cursor, чтобы получить следующую порцию

До какого времени выписка загружена полностью. Операции позже могут ещё дозагрузиться; null — выписка ещё ни разу не загружалась целиком

Короткое имя, как его видят в лагере

БИН (ТОО) или ИИН (ИП), если записан

ИИК (IBAN) счёта, на который зачислены деньги, если записан

Полное юридическое название, если записано

Организация в 1С, куда проводить эти деньги (Ref_Key или БИН), если записана в лагере

Новых броней отделом в минуту

Одновременных запросов

Счетов Kaspi на одну бронь в час

Чтений в секунду

Записей в секунду

Подключение, к которому выпущен ключ

Права ключа: read, bookings, invoices, webhooks

Сумма с двумя знаками после точки

Валюта, ISO 4217. Сейчас всегда KZT

Смена, на которую переносится ребёнок

На что выставить: min — минимальный платёж, которым закрепляется место (сколько его ещё не внесено); full — весь остаток; amount — своя сумма из поля amount

Сумма для kind = amount: тенге строкой, не больше остатка брони. Только целые тенге: "50000" или "50000.00"; дробная часть — отказ fractional_amount

Заменить незакрытый счёт брони новым (документ 17 §6: плательщик просит счёт на другую сумму). Без этого при живом счёте — отказ invoice_live

Сколько вернуть: тенге строкой, только целые ("30000" или "30000.00"), не больше остатка оплаты за вычетом прежних и ждущих возвратов (refund_exceeds_refundable)

Оплата брони по счёту Kaspi (Payment.id). Оплата другим способом возвращается только лагерем — отказ refund_not_kaspi_invoice

Почему возвращаем — увидит тот, кто решает. 1–500 знаков

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

Передать в cursor, чтобы получить следующую порцию

ФИО родителя

Телефон родителя, любой записью: «8 701…», «+7 701…»

Правка ребёнка в брони.

Номер записи в вашей CRM. null — стереть номер, поле не передано — не менять

Заменяет метки целиком

Пустая строка — снять

Телефон плательщика; пустая строка — платит родитель

false — отключить, true — включить (сбрасывает счёт неудач)

Типы событий, как у CreateWebhook.event_types. Пустой список — все типы

Сумма. Возврат — отрицательной суммой

Банк, как его записал лагерь

Юрлицо лагеря, на которое пришли деньги. У оплаты счёта Kaspi — юрлицо кассы, через которую счёт выставлен (у лагеря их несколько, и касса переключается). Возврат делается с этого же юрлица

День оплаты по календарю лагеря (дата, без времени)

Откуда платёж: kaspi_invoice — оплата счёта Kaspi, manual — внесён лагерем. Список может пополняться

prepayment — предоплата, payment — оплата, refund — возврат. Список может пополняться

Сверен бухгалтерией лагеря с выпиской банка. Остаток по брони уменьшает и несверенный платёж

Версия записи: меняется при каждом изменении платежа

Счёт Kaspi, оплатой которого создан платёж

Как заплатили: kaspi_transfer — перевод на Kaspi лагеря, bank_transfer — банковский перевод, cash — наличные, kaspi_invoice — счёт Kaspi. null — не указано (записи до этого поля). Список может пополняться

Строка выписки банка, с которой бухгалтерия лагеря сверила платёж. Есть только у сверенного (verified) платежа

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

До какой даты внести всю сумму

Минимальный платёж: им бронируется место, на него уйдёт счёт при оформлении. Ноль — бронь без предоплаты

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

К оплате всего

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

Сколько часов держится место без минимального платежа; нет — предоплата не нужна

Точка посадки: у сезона с ценами по городам цена трансфера своя у каждого города. При одной цене на всех можно не указывать

Отправить заново всё ПОСЛЕ этого номера события. Номер меньше доставленного — повтор, больше — пропуск

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

Подана вашим подключением (а не сотрудником лагеря)

Счёт Kaspi этой оплаты

Оплата по счёту Kaspi, которую возвращают

requested — ждёт решения лагеря; approved — одобрена, возврат выполняется; sending — отправлен в Kaspi; needs_check — Kaspi не ответил, лагерь проверяет вручную; done — деньги возвращены плательщику; failed — Kaspi отказал, денег не ушло; rejected — лагерь отклонил (причина в reject_reason); cancelled — отозвана автором. Список может пополняться

Версия записи: меняется при каждом изменении заявки

Платёж-возврат, записанный по выполненному возврату (done)

Причина отказа лагеря (только у rejected)

Свободно

Квота отдела на смену; 0 — квоты нет, оформить нельзя

Занято активными бронями отдела (включая ждущие предоплату)

Возрастные границы отрядов. Пусто — сетка ещё не задана

До какой даты внести всю сумму: автоматический счёт на остаток уходит в этот день

Минимальный платёж, которым бронируется место. Ноль — бронь без предоплаты

Номер смены в сезоне

Можно ли сейчас оформить бронь: смена открыта и окно продаж не закрылось

Цена путёвки

Когда закрываются продажи

Места в квоте вашего отдела

draft — готовится, open — продажи открыты, closed — продажи закрыты, departed — смена идёт, finished — завершена. Список может пополняться

Цена трансфера. При ценах по городам — самая низкая из них (цена «от»); сами цены — в transfer_prices

Цены трансфера по точкам посадки. Пусто — одна цена transfer_price на все точки. Точки, которой здесь нет, на смену не возят

Наибольшая скидка без администратора; нет — без ограничения

Активных обычных броней

Долг: продано минус оплачено

Номер смены в сезоне

Оплачено по ним (все платежи, и ещё не сверенные бухгалтерией)

Квота отдела на смену

Продано: сумма к оплате по активным броням

Занято активными бронями отдела (как в GET /shifts)

Ключ строки выписки (тот, что прислан в keys)

camp — строку ведёт система лагеря, accounting — бухгалтерия. Список может пополняться: незнакомое значение не проводите

Платежи лагеря, с которыми сверена строка (у linked)

pending — ждёт проверки; linked — сверена с платежами; organization — оплата организации; not_ours — не оплата путёвки; internal — перевод между своими счетами; outgoing — списание. Список может пополняться

Задание пачки, которому строка уже передана (handover)

ИИК счетов лагеря (ТОО, ИП), без пробелов, верхним регистром. Поступление на такой счёт, которого CRM не видела, — выписку не загрузили в CRM

Только строки, известные CRM; незнакомые ключи в ответ не попадают

День строки в выписке банка

Ключ строки выписки — тот же, что у разборщика выписок бухгалтерии

ИИК счёта лагеря, на который пришли деньги

Адрес ответил 2xx

Код ответа; нет — ответа не было (DNS, соединение, сертификат, время)

Все брони связи, включая эту

Номер связи «вместе»

С кем поселить: ваши брони той же смены, не больше 50

Записка: «одна компания», «просила бабушка»

Цена трансфера в этой брони

Нужен ли трансфер

Точка посадки

Деньги: сумма строкой с двумя знаками и валютой. Строкой, а не числом — дробные числа в чужих языках теряют копейки.

До какого времени держалось место

Сколько просили внести, чтобы закрепить место

Телефоны — пока ребёнок в вашем отделе (docs: «Ваша база»)

Номер путёвки

Файл можно скачать (GET /bookings/{id}/voucher.pdf)

none — не выпущена, generated — выпущена, sent — отмечена отправленной семье. Список может пополняться

Ссылка на скачивание PDF без ключа, живёт 10 минут (pdf_url_expires_at). Приходит только в GET /bookings/{id}/voucher. null — ссылки нет (путёвка не выпущена или файл собирается для вашего отдела на лету) — тогда скачайте GET /bookings/{id}/voucher.pdf. Ссылку не храните: за новой — снова GET /bookings/{id}/voucher

До какого момента действует pdf_url

Номер последнего доставленного события

false — отключён (вами или после трёх суток неудач)

Какие типы событий слать (см. Event.type). Пусто — все

Неудачных попыток подряд

Почему отключён

С какого момента адрес не принимает события подряд

Когда следующая попытка после неудачи

Секрет подписи whsec_…. Только в ответе на создание и смену секрета — сохраните его сразу: больше его не покажут