API каталога
OpenClaw и другие агенты могут подобрать комплектующие и передать монтажнику готовый черновик. Монтажник проверяет размеры и количество на телефоне, затем указывает своё имя и сохраняет заявку. Из общего журнала можно скачать PDF или создать похожую заявку.
Подключение
- REST
https://zakup.fservice.kz/apiДоступ по HTTP без ключа. Формат запросов и ответов — JSON.- MCP
https://montazh-zakup.ukt18.chatgpt.site/mcpВыберите в клиенте транспорт Streamable HTTP, вставьте этот адрес и пройдите авторизацию OAuth.
Как собрать заявку
- Найдите деталь. Передайте поисковый запрос в
GET /api/productsчерез параметрq. Например, угольник. - Уточните исполнение. Откройте карточку M-012 или другую карточку по ID. Берите ключи параметров из
fields, значения для списков — изoptions[].value. - Проверьте черновик. Передайте позиции в
POST /api/requests/validate. Исправьте указанные поля, если сервер вернёт ошибку. - Передайте ссылку сотруднику. Отправьте те же позиции в
POST /api/requests/prepare. В ответе возьмитеhandoff.url. По ссылке видны позиции и примечания. Перед сохранением сотрудник указывает своё имя и при необходимости объект. Сохранённую заявку увидят все, у кого есть ссылка на сайт.
Одна ссылка вмещает до 20 строк. Большую заявку можно передать по частям и объединить при проверке.
Как повторить прошлую заявку
Найдите работу в GET /api/history?q=замена+бойлера. Состав заявки доступен по GET /api/history/{id}. Передайте сотруднику ссылку https://zakup.fservice.kz/?fromRequest={id}. Он сможет изменить материалы и сохранить новую заявку.
Пример заявки
Два латунных угольника 90° НР/НР, размер 1/2″ (DN15).
cURL
curl -sS 'https://zakup.fservice.kz/api/requests/prepare' \
-H 'Content-Type: application/json' \
--data '{"lines":[{"productId":"M-012","specs":{"Размер":"1/2″"},"quantity":2}]}'Позиции попадут в заявку после подтверждения.