О сервисе PROMANTA

PROMANTA — сервис для складского учёта и управления промокодами. Он помогает компаниям принимать коды от поставщиков, хранить их в едином реестре, отслеживать жизненный цикл — от поступления до реализации и погашения — и интегрироваться с внешними системами через API.

Типичный сценарий: поставщик (фарма, ритейл, партнёр) присылает файл с кодами → вы настраиваете маску импорта → создаёте поступление → коды попадают на «склад» проекта → далее резервируете, реализуете на площадке или фиксируете погашение.

Для кого сервис

PROMANTA подходит командам, которые:

работают с большим объёмом промокодов от разных контрагентов;
импортируют коды из Excel/CSV и архивов с разной структурой файлов;
продают или распределяют коды через маркетплейсы, аптеки, партнёров и другие каналы;
нуждаются в прозрачном учёте: кто поставил код, когда он реализован и использован ли покупателем;
подключают автоматизацию — API для поставщиков и площадок, в перспективе — разбор почты.

Раздел «Промокоды» в веб-приложении

Основная работа ведётся в app.promanta.ru в разделе Промокоды (/promo-codes). Раздел состоит из вкладок:

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

Ключевые сущности

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

Жизненный цикл промокода

После импорта код получает статус available (доступен на складе). Далее возможны переходы:

available — на складе, готов к резерву и реализации;
reserved — временно закреплён за заказом или кампанией;
realized — передан в канал продаж (маркетплейс, аптека, партнёр);
redeemed — активирован конечным покупателем;
также: expired, revoked, blocked — для просроченных, отозванных и заблокированных кодов.

Важно различать: реализация — вы передали код в продажу; погашение — покупатель активировал его у поставщика.

Импорт промокодов

Сервис рассчитан на реальные файлы поставщиков — разные форматы Excel, CSV, архивы (ZIP, RAR, 7z). Маска импорта позволяет:

выбирать нужные листы и пропускать сводные;
маппить колонки по имени или индексу;
обрабатывать коды разных типов: alphanumeric, EAN-13, с префиксами (QUEEN14-* и т.п.);
проверять уникальность и отсекать дубликаты при загрузке.

Объём — до миллиона кодов в год на проект; данные партиционируются по годам для производительности.

API и интеграции

Для автоматизации PROMANTA предоставляет три контура External API на api-external.promanta.ru:

Internal (/v1/internal/*) — для сотрудников и веб-приложения, авторизация JWT; полный CRUD, импорт, операции со складом;
Supplier (/v1/supplier/*) — для систем поставщиков, ключ X-Api-Key; загрузка поступлений, отчёты об использовании;
Platform (/v1/platform/*) — для площадок продаж; резерв, реализация, синхронизация каталога, webhooks.

Все методы — POST с JSON-телом { "meta": {}, "data": {} }. Документация доступна в Swagger и в разделах Wiki по API.

Что получает пользователь

единый реестр промокодов вместо разрозненных файлов и таблиц;
контроль статусов и истории каждого кода;
гибкий импорт под формат каждого поставщика;
учёт реализации по площадкам и отчётность;
готовые API для поставщиков, площадок и внутренней автоматизации.