Дата проверки публичных коллекций: 31.07.2026. Наличие метода в документации не доказывает, что он доступен в production и используется сайтом.
| Коллекция | Объём на 31.07 | Основные разделы |
|---|---|---|
| TS API Global | 38 запросов | Person, Contact, Partner, Goods, Orders, Balance, Warehouses, Statistics, Authorization, Countries |
| TS API РФ | 64 запроса | Person, ContactNumber, Partner, PartnerForeign, Goods, Orders, Balance, Warehouses, Statistics, Catalog, Authorization |
| ERP → сайт | 9 примеров | Заказ, пользователь, компания, bind/unbind |
В RF-коллекции документированы дополнительные операции: плательщики/получатели, иностранные партнёры, резервы, доставка, удалённая корзина старого сайта, PayKeeper и параметры каталога. Это не означает, что все они активны на каждом RF/KZ-контуре.
Локальная спецификация уточняет:
POST multipart/form-data;| Метод | Назначение | Ключевые поля |
|---|---|---|
/api/erp/order/update |
Обновить статус заказа | orderId, status, userEmail |
/api/erp/user/update |
Обновить имя и контакты | старый userEmail, новые email/phone, ФИО, коды подтверждения |
/api/erp/company/update |
Добавить/обновить компанию | partnerId + payerId как составной ключ, название, реквизиты, банки, адрес |
/api/erp/company/bind |
Привязать пользователя | partnerId, payerId, userEmail |
/api/erp/company/unbind |
Отвязать пользователя | partnerId, payerId, userEmail |
Смена email и телефона двухшаговая: первый ответ может потребовать confirm_email, confirm_phone или оба кода; затем запрос повторяется с кодом. В публичной Postman-коллекции два телефонных примера названы одинаково — их нужно переименовать.
| Поток | Содержание | Известное состояние |
|---|---|---|
catalog.json |
Карточки, категории, кроссы, имена | Для Global должен содержать только TT/TT Pro; в июле наблюдались откаты к мультибрендовой выгрузке |
forthcomings.json |
Ожидаемые поступления и ценовые поля | На RF поля «резерва без отмены» опубликованы 11.03.2026 |
/goods/stock2 |
Массовые остатки | Разделён с валютами для RF/KZ в конце 2025; использование нужно подтвердить по конфигурации |
/goods/currencies |
Курсы валют | Вынесен из старой выгрузки остатков |
| синхронизация категорий/товаров | Каталог и поиск | В разных ТЗ упоминаются 30 минут и час; текущее cron-расписание нужно снять с production |
Исторические частоты из старых ТЗ не следует считать текущим SLA без проверки job-конфигурации.
| Область | Метод/поля | Статус |
|---|---|---|
| Резерв без отмены | POST /goods/reservation: price, flag, comment |
API RF опубликовано 11.03.2026 |
| Получение резервов | GET /goods/reservations/{partnerId}: price, flag |
API RF опубликовано 11.03.2026 |
| Запрет отмены | DELETE /goods/reservation отказывает для неотменяемого резерва |
API RF опубликовано 11.03.2026 |
| Корзина партнёра | /api/erp/basket/add принимает partnerId |
Требование ТЗ №7; production не подтверждён |
| Global MOQ/USQ | Поля в карточке/остатке и признак склада | В июне наблюдалось, что массовый endpoint их не отдавал; финальный контракт нужно проверить |
| Global checkout | Создание заказа без обязательного receiver | Изменение подтверждено в июневском тесте |
| Global взаиморасчёты | Номер документа и description/comment в операции | Требовование; точный JSON-контракт нужно закрепить |
| Доставка RF/KZ | Группа складов в адресах, ТК и курьере | Требовование ТЗ №12; выкатка не доказана |
Для каждого метода нужны: владелец и потребитель, окружения и base URL, request/response schema, обязательность полей, коды ошибок, авторизация, тайм-ауты, retry, идемпотентность, версия, дата изменения и санитизированный тестовый пример.