About PROMANTA

PROMANTA is a promo code inventory and management platform. It helps teams receive codes from suppliers, store them in a single registry, track the full lifecycle — from incoming shipment to fulfillment and redemption — and integrate with external systems via API.

Typical flow: a supplier sends a file with codes → you configure an import mask → create an incoming document → codes land in the project warehouse → then you reserve, realize on a sales platform, or record redemption.

Who it is for

PROMANTA is built for teams that:

handle large volumes of promo codes from multiple counterparties;
import codes from Excel/CSV files and archives with different layouts;
sell or distribute codes via marketplaces, pharmacies, partners, and other channels;
need transparent tracking: who supplied a code, when it was fulfilled, and whether the end customer redeemed it;
automate workflows — supplier and platform APIs, with email parsing planned.

Promo Codes section in the web app

Day-to-day work happens in app.promanta.ru under Promo Codes (/promo-codes). Tabs include:

Promo codes — full project registry: search, status filters, manual realize/redeem;
Incoming — shipment documents: file upload, import run, result tracking (manual, API, or email);
Products — product catalog linked to codes;
Suppliers — counterparties that provide codes (details, import masks, API keys);
Platforms — fulfillment channels (marketplaces, partners);
Import settings — file parsing masks: sheets, columns, rules per supplier.

Key entities

Supplier — source counterparty.
Import mask — saved file parsing config for a supplier.
Incoming — one shipment document: file → validation → import with audit trail.
Promo code — inventory unit: code value, supplier, product, status, validity dates.
Platform — channel where a code is fulfilled (sale, campaign, partner).

Promo code lifecycle

After import, a code starts as available. Main statuses:

available — in warehouse, ready for reserve/fulfillment;
reserved — temporarily tied to an order or campaign;
realized — handed to a sales channel;
redeemed — activated by the end customer;
also: expired, revoked, blocked.

Fulfillment (realized) means you passed the code to sales; redemption (redeemed) means the buyer activated it with the supplier.

Import

The service supports real supplier files — Excel, CSV, archives (ZIP, RAR, 7z). Import masks allow sheet selection, column mapping, multiple code formats (alphanumeric, EAN-13, prefixed batches), and duplicate checks. Scale: up to ~1M codes per year per project with yearly partitioning.

API and integrations

PROMANTA exposes three External API contours at api-external.promanta.ru:

Internal (/v1/internal/*) — JWT, full CRUD for staff and the web app;
Supplier (/v1/supplier/*) — X-Api-Key, incoming uploads and usage reports;
Platform (/v1/platform/*) — reserve, realize, catalog sync, webhooks.

All methods are POST with JSON body { "meta": {}, "data": {} }. See Swagger and Wiki API sections for details.