SelSup Developers

API for integrators

Connect your service to SelSup

Documentation built around developer tasks, with precise contracts, real errors, and integration-ready workflows.

Start in 5 minutes Browse the Brands API →
GET /api/brand/find
curl 'https://api.selsup.ru/api/brand/find?query=Base' \
  --header 'Authorization: YOUR_API_TOKEN'

HTTP/1.1 200 OK
{
  "rows": [{ "brandId": 8124, "name": "Base" }],
  "hasNextPage": false
}
New documentation

All 48 sections and 917 endpoints are available in all 12 SelSup languages. Every section has its own editable contract; Brands remains the editorial quality reference.

Quickstart

Your first request in three steps

A token can access data in your account. Keep it server-side and never ship it in browser JavaScript.

01

Create a dedicated token

Open SelSup integration settings, give the token a clear name, and grant only the permissions it needs.

02

Send Authorization

Add the token without a Bearer prefix to every request.

03

Handle the error code

Use the stable error field for application logic and show localMessage to the user.

Authorization

Authentication

Every endpoint uses https://api.selsup.ru and the Authorization header. Content-Type is required only for requests with a body.

Shell
curl 'https://api.selsup.ru/api/brand/all' \
  --header 'Authorization: YOUR_API_TOKEN'

API Reference

Task-oriented API

Every public controller now has an independent YAML package. Routes, parameters, and schemas are captured, while workflows and application errors can be refined without changing the generator.

{ }

Account and integrations

Endpoints for Account and integrations, including exact routes, parameters, request bodies, and expandable response schemas.

66 endpoints→ { }

Advertising campaigns

Endpoints for Advertising campaigns, including exact routes, parameters, request bodies, and expandable response schemas.

10 endpoints→ { }

Analytics

Endpoints for Analytics, including exact routes, parameters, request bodies, and expandable response schemas.

98 endpoints→ { }

Billing

Endpoints for Billing, including exact routes, parameters, request bodies, and expandable response schemas.

1 endpoints→ { }

Brands

Create and find brands, map them to Ozon and 1C, manage logos, and safely merge duplicates.

9 endpoints→ { }

Calculator

Endpoints for Calculator, including exact routes, parameters, request bodies, and expandable response schemas.

2 endpoints→ { }

Categories

Endpoints for Categories, including exact routes, parameters, request bodies, and expandable response schemas.

20 endpoints→ { }

Competitors

Endpoints for Competitors, including exact routes, parameters, request bodies, and expandable response schemas.

4 endpoints→ { }

Contractors

Endpoints for Contractors, including exact routes, parameters, request bodies, and expandable response schemas.

17 endpoints→ { }

Customers

Endpoints for Customers, including exact routes, parameters, request bodies, and expandable response schemas.

5 endpoints→ { }

Delivery

Endpoints for Delivery, including exact routes, parameters, request bodies, and expandable response schemas.

18 endpoints→ { }

Documents

Endpoints for Documents, including exact routes, parameters, request bodies, and expandable response schemas.

19 endpoints→ { }

Export

Endpoints for Export, including exact routes, parameters, request bodies, and expandable response schemas.

38 endpoints→ { }

FBS orders

Endpoints for FBS orders, including exact routes, parameters, request bodies, and expandable response schemas.

69 endpoints→ { }

Finance

Endpoints for Finance, including exact routes, parameters, request bodies, and expandable response schemas.

25 endpoints→ { }

Financial planning

Endpoints for Financial planning, including exact routes, parameters, request bodies, and expandable response schemas.

5 endpoints→ { }

Hypothesis testing

Endpoints for Hypothesis testing, including exact routes, parameters, request bodies, and expandable response schemas.

5 endpoints→ { }

Import

Endpoints for Import, including exact routes, parameters, request bodies, and expandable response schemas.

31 endpoints→ { }

Inbound

Endpoints for Inbound, including exact routes, parameters, request bodies, and expandable response schemas.

19 endpoints→ { }

Inventory

Endpoints for Inventory, including exact routes, parameters, request bodies, and expandable response schemas.

46 endpoints→ { }

Job

Endpoints for Job, including exact routes, parameters, request bodies, and expandable response schemas.

3 endpoints→ { }

Keywords

Endpoints for Keywords, including exact routes, parameters, request bodies, and expandable response schemas.

12 endpoints→ { }

Knowledge base

Endpoints for Knowledge base, including exact routes, parameters, request bodies, and expandable response schemas.

33 endpoints→ { }

Manufacturers

Endpoints for Manufacturers, including exact routes, parameters, request bodies, and expandable response schemas.

5 endpoints→ { }

Media

Endpoints for Media, including exact routes, parameters, request bodies, and expandable response schemas.

1 endpoints→ { }

MoySklad

Endpoints for MoySklad, including exact routes, parameters, request bodies, and expandable response schemas.

9 endpoints→ { }

Orders

Endpoints for Orders, including exact routes, parameters, request bodies, and expandable response schemas.

44 endpoints→ { }

Packing

Endpoints for Packing, including exact routes, parameters, request bodies, and expandable response schemas.

14 endpoints→ { }

Parameters

Endpoints for Parameters, including exact routes, parameters, request bodies, and expandable response schemas.

5 endpoints→ { }

Photo sessions

Endpoints for Photo sessions, including exact routes, parameters, request bodies, and expandable response schemas.

12 endpoints→ { }

Position

Endpoints for Position, including exact routes, parameters, request bodies, and expandable response schemas.

3 endpoints→ { }

Prices

Endpoints for Prices, including exact routes, parameters, request bodies, and expandable response schemas.

17 endpoints→ { }

Product groups

Endpoints for Product groups, including exact routes, parameters, request bodies, and expandable response schemas.

6 endpoints→ { }

Product marking

Endpoints for Product marking, including exact routes, parameters, request bodies, and expandable response schemas.

28 endpoints→ { }

Product models

Endpoints for Product models, including exact routes, parameters, request bodies, and expandable response schemas.

14 endpoints→ { }

Product tags

Endpoints for Product tags, including exact routes, parameters, request bodies, and expandable response schemas.

9 endpoints→ { }

Products

Endpoints for Products, including exact routes, parameters, request bodies, and expandable response schemas.

39 endpoints→ { }

Promotions

Endpoints for Promotions, including exact routes, parameters, request bodies, and expandable response schemas.

11 endpoints→ { }

Purchase

Endpoints for Purchase, including exact routes, parameters, request bodies, and expandable response schemas.

17 endpoints→ { }

Quality certificates

Endpoints for Quality certificates, including exact routes, parameters, request bodies, and expandable response schemas.

10 endpoints→ { }

Receipt

Endpoints for Receipt, including exact routes, parameters, request bodies, and expandable response schemas.

4 endpoints→ { }

Repricer

Endpoints for Repricer, including exact routes, parameters, request bodies, and expandable response schemas.

15 endpoints→ { }

Returns

Endpoints for Returns, including exact routes, parameters, request bodies, and expandable response schemas.

3 endpoints→ { }

Settings

Endpoints for Settings, including exact routes, parameters, request bodies, and expandable response schemas.

3 endpoints→ { }

Supplies

Endpoints for Supplies, including exact routes, parameters, request bodies, and expandable response schemas.

52 endpoints→ { }

Tasks

Endpoints for Tasks, including exact routes, parameters, request bodies, and expandable response schemas.

3 endpoints→ { }

Warehouses

Endpoints for Warehouses, including exact routes, parameters, request bodies, and expandable response schemas.

35 endpoints→ { }

Webhooks

Endpoints for Webhooks, including exact routes, parameters, request bodies, and expandable response schemas.

3 endpoints→

Guides

Common integration workflows

End-to-end guides combine multiple endpoints and explain call order, safe synchronization, and edge-case handling.

→

Getting started

Authentication, the first request, localized errors, pagination, and a safe production rollout.

4 sections →

Product catalog and cards

Product search, full card retrieval, model creation, brand and category dictionaries, and marketplace parameters.

4 sections →

Orders and incremental synchronization

Creating web-store orders, preventing duplicates, paginated exports, and processing changed orders.

4 sections →

Inventory and warehouses

The SKU model, warehouse stock reads, updates by SelSup or external identifiers, and safe reconciliation.

5 sections →

Webhooks and event-driven integration

Outbound webhook setup, a secure receiver, duplicate protection, and recovery of missed events through the API.

5 sections →

Extensions and custom integrations

Choosing between an external backend service, an embedded React UI, and a server-side marketplace or delivery module.

5 sections

Manual first

Why this is not another Swagger skin

  • Workflows and examples are written from an integrator's point of view.
  • Request and response fields are listed separately, without leakage from shared Java models.
  • Errors come from controllers and services instead of generic 400/500 placeholders.
  • Russian and English content is verified by the same build.