Золотенков

Пять изменений за август: теперь закупку можно принять, не открывая ее

#новости продукта #закупки #каталог #API #себестоимость
Пять изменений за август: теперь закупку можно принять, не открывая ее

Раз в месяц мы собираем в одном тексте то, что появилось в Золотенков МРП. Пишем для тех, кто каждый день ведет в системе закупки, склад и каталог: тут видно, что теперь делается иначе. Август вышел про мелочи, которые срезают лишние клики, и про одно крупное изменение — публичное API.

Начнем с самого частого случая на складе.

Привезли три коробки ниток. Заказ на них лежит в списке закупок, и все, что нужно сделать, — отметить приход. Раньше это значило открыть заказ, дождаться карточки, найти строки, проставить количество и сохранить. Пять действий ради «да, привезли».

С августа хватает двух.

Ниже — пять изменений, которые доехали до рабочей системы за месяц. Каждое проверено 26 августа в живом Золотенков МРП, а не взято из планов.

Приемка закупки — прямо из строки списка

В списке закупок появилась колонка «Приемка». В ней сразу виден статус заказа: «Не получен», «Частично получен». Нажатие на статус открывает меню из двух пунктов.

«Принять все» закрывает заказ целиком: позиции приходуются в заявленном количестве. «Принять часть…» открывает окно, где количество проставляется построчно. Это случай, когда поставщик привез половину и обещал остальное к пятнице.

Список закупок Золотенков МРП: у заказа ЗП-1040 открыто меню приемки с пунктами «Принять все» и «Принять часть…»

Меню приемки в списке закупок. Заказ на 46 000 ₽ приходуется отсюда — карточку открывать не нужно.

Одна оговорка. Заказы с серийным учетом целиком из списка не принимаются: пункт «Принять все» в них выключен, а подсказка отправляет ввести серии в карточке заказа. Серию нельзя проставить оптом, ее вводят по единице.

Каталог: колонки настраиваются под себя

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

Кнопка «Колонки» над таблицей открывает список «Видимые колонки». Лишнее снимается галочкой.

Каталог товаров: открытый список «Видимые колонки» с галочками у десяти колонок таблицы

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

Мелочь на пять секунд работы. Но таблицу в двадцать позиций читают каждый день, и лишние четыре колонки за месяц набирают свое.

Публичное API: 55 операций и справочник с примерами

Самое крупное изменение месяца. У Золотенков МРП появилось публичное REST API — версия 1.0.0, схема OpenAPI 3.1, 55 операций по 41 адресу.

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

Ключ выпускается в разделе «Настройки → API-ключи». Значение показывается один раз — дальше его хранит ваш сервер. Права выдаются по действию: интеграция, которая только читает остатки, писать в каталог не сможет.

Справочник публичного API Золотенков МРП: версия 1.0.0, OpenAPI 3.1, слева список разделов и ручек, справа пример первого запроса

Справочник на zolotenkov.ru/developers. У каждой ручки своя страница с параметрами и примерами на cURL, Node.js, Python и PHP.

Рядом со справочником — руководство и отдельная страница про подключение ИИ-агентов по MCP. Файл openapi.json скачивается целиком, если ваш разработчик предпочитает генерировать клиент.

Каталог заливается партиями по 200 карточек

Отдельная ручка POST /products/batch заводит до 200 карточек одним запросом.

Смысл не только в скорости. Партия расходует одну единицу строгой квоты записи вместо двухсот. Отказ идет построчно: results[i] отвечает за строку items[i], и одна отклоненная позиция не отменяет заведенные. Заголовок Idempotency-Key обязателен — повтор с тем же ключом и тем же телом вернет прежний ответ и второй партии не создаст.

Страница ручки «Завести партию товаров» в справочнике API: адрес, требуемое право ключа, описание, пример запроса на cURL и пример ответа

Страница групповой загрузки. Справа — готовый запрос и ответ, в котором видно, сколько строк завелось и сколько отклонено.

Тысяча карточек укладывается в пять запросов вместо тысячи.

Калькулятор наценки и маржи

Наценку и маржу путают постоянно, и путаница стоит денег.

Считаем на цифрах. Себестоимость единицы — 420 ₽, цена продажи — 990 ₽. Прибыль с единицы 570 ₽. Наценка при этом 136 %, а маржа 58 %. Числа разные, потому что в первом случае делим на себестоимость, а во втором — на цену продажи. Продавец, который держит в голове «наценка 136 %» и обещает клиенту скидку 40 %, уходит в минус.

Калькулятор наценки и маржи на сайте: себестоимость 420 ₽, цена 990 ₽, прибыль 570 ₽, наценка 136 %, маржа 58 %

Тот же расчет в калькуляторе. Ниже — обратный подбор цены под нужную маржу и точка безубыточности.

Калькулятор лежит на zolotenkov.ru/kalkulyator-natsenki-i-marzhi. Регистрация не нужна, расчет идет в браузере, цифры на сервер не уходят.

Страница доступности сервисов

Последнее изменение — про доверие, а не про функции.

Раньше на вопрос «у вас все работает или это у меня?» отвечала переписка. Теперь отвечает страница status.zolotenkov.ru. На ней видно состояние рабочего места МРП, серверной части, базы данных, сайта и справки.

Страница доступности сервисов Zolotenkov: рабочее место МРП и серверная часть — доступность 100,00 %, среднее время ответа 781 и 710 мс

Наблюдение ведется с 23 августа. На 26 августа доступность обоих сервисов — 100,00 %, среднее время ответа 781 и 710 мс.

Главное в этой странице — где она живет. Проверки идут снаружи, с площадки, не связанной с нашими серверами. Если наш сервер ляжет, страница продолжит работать и покажет красный. Статус-страница на том же сервере, что и сервис, в аварию молчит вместе с ним.

История хранится и переключается на сутки, семь дней, тридцать дней и год. Обещать по ней 99,9 % пока рано: наблюдение идет четыре дня, и честная цифра появится через месяц.

Что дальше

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

Если из перечисленного вам ближе всего приемка из списка — она уже в вашей системе, отдельно включать нечего. Посмотреть, как устроен остальной учет, можно на zolotenkov.ru.

Читайте также

Заказы, производство и закупки в одном месте

Золотенков показывает, каких материалов не хватает на заказ, что докупить и во сколько обходится одно изделие.

Попробовать бесплатно

Free — без срока до 30 артикулов; при 30 начинаются 15 дней без ограничения. После них — до 30 или Pro. Тарифы