FERROLION В каталог

API каталога

OpenClaw и другие агенты могут подобрать комплектующие и передать монтажнику готовый черновик. Монтажник проверяет размеры и количество на телефоне, затем указывает своё имя и сохраняет заявку. Из общего журнала можно скачать PDF или создать похожую заявку.

Подключение

REST
https://zakup.fservice.kz/apiДоступ по HTTP без ключа. Формат запросов и ответов — JSON.
MCP
https://montazh-zakup.ukt18.chatgpt.site/mcpВыберите в клиенте транспорт Streamable HTTP, вставьте этот адрес и пройдите авторизацию OAuth.

Как собрать заявку

  1. Найдите деталь. Передайте поисковый запрос в GET /api/products через параметр q. Например, угольник.
  2. Уточните исполнение. Откройте карточку M-012 или другую карточку по ID. Берите ключи параметров из fields, значения для списков — из options[].value.
  3. Проверьте черновик. Передайте позиции в POST /api/requests/validate. Исправьте указанные поля, если сервер вернёт ошибку.
  4. Передайте ссылку сотруднику. Отправьте те же позиции в 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}]}'
Позиции попадут в заявку после подтверждения.