Песочница для интеграции с учётной системой — API

В админке: API → Тестирование API учётной системы.

Что это

Песочница для интеграции с вашей учётной системой. Здесь собраны все точки, через которые наша система сама стучится к учётной системе: запрашивает цены, проверяет наличие на складе, тянет связки материал↔кромка и т.д. На странице видно, какие endpoint'ы у вас настроены, а какие — нет; каждый можно вживую протестировать с реальным запросом и посмотреть, что вернула учётная система.

Что вы видите

Список точек обращения к учётной системе — карточки с одинаковой структурой:

Название и краткое описание точки.
Что это даёт — простыми словами: какую функциональность включает настройка этого endpoint'а.
Шаги настройки — короткая инструкция: что попросить у вашего программиста учётной системы, какой ключ параметра найти в админке, куда вставить URL.
Текущий URL — если уже настроен. Пусто — значит endpoint не работает.
Кнопка «Тест» — переходит на вкладку с формой реального запроса, показывает request/response.

Доступные точки интеграции

Базовый набор (могут добавляться по мере развития системы):

Получение цен материалов — наша система запрашивает у учётной системы актуальные цены на листовые материалы. Без этой настройки цены берутся из локальной базы и могут отличаться от учётной системы.
Получение цен услуг — то же самое для услуг (обработка, фурнитура).
Проверка наличия на складе — перед запуском заказа в производство система спрашивает у учётной системы, есть ли все нужные материалы. Без этого заказы могут уйти в производство, упасть на «нет материала».
Получение кромки для материала — какая кромка идёт в комплекте с конкретным листовым материалом. Используется при синхронизации номенклатуры; иначе соответствие материал→кромка приходится настраивать вручную.

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

Как настроить

Общий рецепт для каждой точки одинаковый:

Попросить вашего программиста учётной системы создать HTTP-сервис (endpoint) с нужным форматом запроса/ответа. Описание формата — внутри карточки на странице тестирования.
Получить от программиста URL этого сервиса (должен начинаться с https://; локальная учётная система может быть на http://).
Зайти в Параметры → Параметры фирмы, найти параметр с указанным в карточке ключом и вставить URL.
Вернуться на страницу тестирования и нажать «Тест» — сразу видно, отвечает учётная система или нет, и какие данные возвращает.

Тест запроса

На вкладке теста для выбранной точки вы видите:

Endpoint URL — куда полетит запрос.
HTTP-метод (обычно POST).
Заголовки (включая API-Key учётной системы если задан).
Тело запроса — типичный пример, который можно сразу отправить либо подкорректировать (например, подставить реальный code1c существующего товара/заказа).
Кнопку «Отправить» — даёт сырой ответ от учётной системы: код ответа, тело, длительность.

Что важно

Тестовые запросы — реальные: они действительно идут в вашу учётную систему и могут изменять её данные (например, тест «Принять заказ» создаст в учётной системе запись). Будьте аккуратны на проде — сначала тестируйте на staging-версии учётной системы.
Все настройки точек хранятся в производственных параметрах вашей фирмы — менять можно без редеплоя.
В одном из ключей в системе исторически опечатка («avilable» вместо «available») — это не баг, оставлено для совместимости со старыми инсталляциями. Подсказка в карточке предупредит.
Доступ — все админы вашей фирмы.