SelSup Developers

Public API · API Referencja

Kampania reklamowe

Punkty końcowe kampanii reklamowych, w tym dokładne trasy, parametry, organy żądania i rozszerzalne schematy odpowiedzi.

10 punkty końcowe/api/campaignStabilnyOpis czytelny maszynowo ↗
{ }

Strona ta jest wspierana przez edytowalny samodzielny kontrakt.

/api/campaign

Gotowe do użytkowania przepływy robocze

Gotowe do użytkowania przepływy robocze

Model danych

Struktura danych

Modele są wymienione tutaj raz i mogą być również rozszerzane bezpośrednio z punktów końcowych, które je wykorzystują.

CampaignFilter17 pola
limitinteger · int32

Ogranicz.

pageinteger · int32

Strona.

countboolean

Zgromadzisz.

sortBystring

- Zarejestrowany.

ascendingboolean

Wzniesienie.

statusstring

Status.

campaignStatusstring

Status kampanii.

typeinteger · int32

Type.

offsetinteger · int32

- Nie.

servicestring

- W służbie.

dateTostring · date-time

- W dniu do.

dateFromstring · date-time

- Od daty.

isStatCampaignboolean

To jest Stat Campaign.

dateStartstring · date-time

Data rozpoczęcia.

querystring

- Nie wiem.

productExternalIdinteger · int64

Id zewnętrzny produktu.

organizationIdsinteger[]

Identyfikaty organizacyjne.

CampaignStatExportRequest4 pola
servicestring

- W służbie.

organizationIdinteger · int64

Id organizacyjny.

organizationIdsinteger[]

Identyfikaty organizacyjne.

filterCampaignFilter

Filtr.

TmsTask25 pola
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

- Nazwa.

clientIdinteger · int64

Id klientów.

entityIdinteger · int64

Identyczny.

progressinteger · int32

- Wykonaj postępy.

processedQuantityinteger · int32

Wykorzystana ilość.

organizationIdinteger · int64

Id organizacyjny.

priorityinteger · int32

Priorytet.

propertiesstring

- Właściwości.

messagestring

- Wysyła wiadomość.

messageParamsstring

- Przesłanie Params.

createdDatestring · date-time

Tworzony Termin.

startDatestring · date-time

- Wczoraj.

finishDatestring · date-time

Termin zakończenia.

urlstring

- Url.

inputFileUrlstring

Url pliku wprowadzania.

retryNumberinteger · int32

Powtórny numer prób.

userIdinteger · int32

Id użytkownika.

retryDatestring · date-time

Powtórny wypróbowanie.

debugboolean

Odbudowa.

forcedStartboolean

Wymuszony start.

servicestring

- W służbie.

langstring

Lang.

Campaign22 pola
idinteger · int64

Id.

externalIdinteger · int64

Zewnętrzna identyfikacja.

namestring

- Nazwa.

campaignNamestring

Nazwa kampanii.

typestring

Type.

statusTypestring

Typ stanu.

productIdinteger · int64

Id produktu.

externalProductIdinteger · int64

Zewnętrzna identyfikacja produktu.

createDatestring · date-time

Tworzyć datę.

endDatestring · date-time

Termin końcowy.

startDatestring · date-time

- Wczoraj.

suminteger · int64

- W sumie.

writeOffTypestring

Wyłącz typ.

onPauseboolean

Na Pause.

clientIdinteger · int64

Id klientów.

servicestring

- W służbie.

categoryIdinteger · int64

Kategoria ID.

categoryNamestring

Nazwa kategorii.

campaignTypestring

Typ kampanii.

dateStatImportstring · date-time

Data przywozu statystyki.

nmsstring

- Nie.

paymentTypestring

Typo płatności.

WildberriesType32 pola
idinteger · int64

Id.

namestring

- Nazwa.

publishedboolean

- Opublikowana.

hasSizeboolean

Ma rozmiar.

monoBoxMinQuantityinteger · int32

Mono Box Min Quantity.

monoTypestring

Mono Typ.

monoMinPriceinteger · int32

Mono Min Price.

hasParentboolean

Ma rodzica.

parentIdinteger · int64

Idę rodzica.

wildberriesIdinteger · int64

Id Wildberries.

lastSyncDatestring · date-time

Ostatnia data synchronizacji.

notChangedDaysinteger · int32

Nie zmienił się dzień.

commissionnumber · double

Komisja.

fbsCommissionnumber · double

Komisja FBI.

fbwCommissionnumber · double

Komisja FBI.

dbsCommissionnumber · double

Komisja DBS.

edbsCommissionnumber · double

Komisja Edbs.

cAndCCommissionnumber · double

C i CKomisy.

bookingCommissionnumber · double

Komisja Rezerwacyjna.

logisticPriceinteger · int32

Logistyczna cena.

storagePricenumber · double

Cena magazynowania.

acceptancePricenumber · double

Cena akceptacji.

needDimensionsboolean

Potrzebuję wymiarów.

purchasePercentAvgnumber · double

% zakupu Avg.

purchasePercentMinnumber · double

Kupna procent min.

photoAvginteger · int32

Zdjęcie Avg.

photoMininteger · int32

Zdjęcie Min.

drrAvgnumber · double

Doktor Avg.

drrMinnumber · double

Dr Min.

marginAvgnumber · double

Margin Avg.

marginMinnumber · double

Margin Min.

candCCommissionnumber · double

C. Komisja.

CampaignStat4 pola
campaignstring

Kampania.

valuenumber · double

Wartość.

organizationIdinteger · int64

Id organizacyjny.

organizationNamestring

Nazwa organizacji.

CampaignTotalStats4 pola
clicksCampaignStat[]

- Klika.

viewsCampaignStat[]

Widoki.

expensesCampaignStat[]

- Wydaje się.

averageCostCampaignStat[]

Średni koszt.

FindResponseStatCampaign1 pola
rowsStatCampaign[]

Rzędy.

StatCampaign46 pola
limitinteger · int32

Ogranicz.

pageinteger · int32

Strona.

countboolean

Zgromadzisz.

sortBystring

- Zarejestrowany.

ascendingboolean

Wzniesienie.

statCampaignIdinteger · int64

Stat Campaign ID.

viewsinteger · int32

Widoki.

clicksinteger · int32

- Klika.

ratioClicksViewsnumber · double

Wskaźnik kliknięć.

averageCostnumber · double

Średni koszt.

expensesnumber · double

- Wydaje się.

quantityAddCartinteger · int32

Kwota dodania koszyka.

quantityOrdersinteger · int32

Zamówienia ilościowe.

ratioOrdersOfVisitsnumber · double

Odsetek kolejności wizyt.

quantityProductOrdersinteger · int32

Zamówienia na ilość produktu.

ordersAmountnumber · double

Liczba zamówień.

campaignIdinteger · int64

Id kampania.

campaignNamestring

Nazwa kampanii.

createDatestring · date-time

Tworzyć datę.

servicestring

- W służbie.

campaignTypestring

Typ kampanii.

categoryNamestring

Nazwa kategorii.

externalIdinteger · int64

Zewnętrzna identyfikacja.

productIdinteger · int64

Id produktu.

productViewIdinteger · int64

Id widoku produktu.

datestring · date-time

- Spotkanie.

startDatestring · date-time

- Wczoraj.

endDatestring · date-time

Termin końcowy.

importDatestring · date-time

Data przywozu.

uniqueIdstring

Unikalny numer.

clientIdinteger · int64

Id klientów.

organizationIdinteger · int64

Id organizacyjny.

organizationNamestring

Nazwa organizacji.

rowTypestring

Typ rzędu.

quantityBuyoutsnumber · double

Wyroby ilościowe.

revenuenumber · double

- Dochodzenie.

profitFactnumber · double

Fakt zysku.

marginFactnumber · double

Fakty marżowe.

drrnumber · double

- Dr.

cpsnumber · double

- Policjant.

quantityBuyoutsForecastnumber · double

Prognoza ilościowa.

profitForecastnumber · double

Prognoza zysków.

marginForecastnumber · double

Prognoza marży.

allowableExpensesnumber · double

Dozwolone wydatki.

currencystring

Walutę.

unavailableReasonsobject

Nie ma przyczyn.

FindResponseCampaign1 pola
rowsCampaign[]

Rzędy.

WbBalance3 pola
balanceinteger · int32

Równowaga.

netinteger · int32

- Sieć.

bonusinteger · int32

- Bonus.

Umowa o błędzie

W jaki sposób można zwrócić błędy w aplikacji

Kod error jest identyczny w każdym miejscu, podczas gdy wiadomość skierowana do użytkownika jest tłumaczona przez serwer.

error

Stabilny kod czytelny maszynowo do logiki integracyjnej.

localMessage

Przesłanie gotowe do wyświetlania w języku użytkownika tokenu API.

params

Wartości interpołowane przez serwer w szablonie lokalizowanej wiadomości.

localMessage wykorzystuje pole lang użytkownika, który posiada token API. Język dokumentacji i nagłówek Accept-Language nie zmieniają go; rosyjski jest używany, gdy użytkujący nie ma konfigurowanego języka.

RULokalizacja użytkownika jest ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
PLPolski (pl)
{
  "error": "error_brand_already_exists",
  "localMessage": "Marka Base już istnieje",
  "params": {
    "name": "Base"
  }
}

Punkty końcowe

Punkty końcowe

POST

Aktualnianie kampanii stanu

/api/campaign/updateStatusCampaign
Token z dostępem do pisania

Aktualnianie kampanii stanu używając POST /api/campaign/updateStatusCampaign.

Parametry zapytania

PoleTypWymaganeOpis
campaignId integer · int64 Tak Id kampania.
status stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Tak Status.
organizationId integer · int64 Tak Id organizacyjny.
curl --request POST 'https://api.selsup.ru/api/campaign/updateStatusCampaign?campaignId=1001&status=DELETED&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200

Odpowiedź nie ma ciała.

Władze9

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_client
Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_organization_not_found
Nie znaleziono organizacji

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_organization_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_prepared_integration_not_found
przygotowana integracja nie znaleziona

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_prepared_integration_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired
Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_token_expired_or_revoked
Token API został odwołany lub wprowadzony nieprawidłowo. Sprawdź, czy klucz API ma pełną funkcjonalność. Wygeneruj nowy klucz i zastąp w SELSUP, ponieważ klucze mają okres ważności.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_token_expired_or_revoked; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_wildberries_api
{message}

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_wildberries_api; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

POST

Statystyki kampanii eksportowej

/api/campaign/stats/xlsx
Token z dostępem do pisania

Statystyki kampanii eksportowej za pomocą POST /api/campaign/stats/xlsx.

Organ wnioskujący

application/json
Połączenia obiektuCampaignStatExportRequest
PoleTypWymaganeOpis
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
organizationId integer · int64 Nie Id organizacyjny.
organizationIds integer[] Nie Identyfikaty organizacyjne.
filter CampaignFilter Nie Filtr.
Połączenia obiektu CampaignFilter
PoleTypWymaganeOpis
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
count boolean Nie Zgromadzisz.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
status string Nie Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Nie Status kampanii.
type integer · int32 Nie Type.
offset integer · int32 Nie - Nie.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
dateTo string · date-time Nie - W dniu do.
dateFrom string · date-time Nie - Od daty.
isStatCampaign boolean Nie To jest Stat Campaign.
dateStart string · date-time Nie Data rozpoczęcia.
query string Nie - Nie wiem.
productExternalId integer · int64 Nie Id zewnętrzny produktu.
organizationIds integer[] Nie Identyfikaty organizacyjne.
curl --request POST 'https://api.selsup.ru/api/campaign/stats/xlsx' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "organizationId": 1001,
  "organizationIds": "string",
  "filter": "string"
}'

Odpowiedź udana

200
Połączenia obiektu TmsTask
PoleTypWymaganeOpis
id integer · int64 Nie Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Nie Status.
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Nie Type.
name string Nie - Nazwa.
clientId integer · int64 Nie Id klientów.
entityId integer · int64 Nie Identyczny.
progress integer · int32 Nie - Wykonaj postępy.
processedQuantity integer · int32 Nie Wykorzystana ilość.
organizationId integer · int64 Nie Id organizacyjny.
priority integer · int32 Nie Priorytet.
properties string Nie - Właściwości.
message string Nie - Wysyła wiadomość.
messageParams string Nie - Przesłanie Params.
createdDate string · date-time Nie Tworzony Termin.
startDate string · date-time Nie - Wczoraj.
finishDate string · date-time Nie Termin zakończenia.
url string Nie - Url.
inputFileUrl string Nie Url pliku wprowadzania.
retryNumber integer · int32 Nie Powtórny numer prób.
userId integer · int32 Nie Id użytkownika.
retryDate string · date-time Nie Powtórny wypróbowanie.
debug boolean Nie Odbudowa.
forcedStart boolean Nie Wymuszony start.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
lang string Nie Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Władze9

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_analytics_access_denied
Dane analityczne są poufne dla roli SUPPORT

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_analytics_access_denied; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_marketplace
Nie podano marketplace'u

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_marketplace; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_organization
Nie określono organizacji

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_organization; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired
Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_unsupported_service
Usługa nie jest obsługiwana

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_unsupported_service; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_user_does_not_have_this_organization
Użytkownik nie ma dostępu do tej organizacji

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_user_does_not_have_this_organization; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

POST

Stwórz kampanię

/api/campaign/createCampaign
Token z dostępem do pisania

Tworzenie kampanii za pomocą POST /api/campaign/createCampaign.

Parametry zapytania

PoleTypWymaganeOpis
organizationId integer · int64 Tak Id organizacyjny.

Organ wnioskujący

application/json
Połączenia obiektuCampaign
PoleTypWymaganeOpis
id integer · int64 Nie Id.
externalId integer · int64 Nie Zewnętrzna identyfikacja.
name string Nie - Nazwa.
campaignName string Nie Nazwa kampanii.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Nie Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Nie Typ stanu.
productId integer · int64 Nie Id produktu.
externalProductId integer · int64 Nie Zewnętrzna identyfikacja produktu.
createDate string · date-time Nie Tworzyć datę.
endDate string · date-time Nie Termin końcowy.
startDate string · date-time Nie - Wczoraj.
sum integer · int64 Nie - W sumie.
writeOffType stringBALANCE, NET, BONUS Nie Wyłącz typ.
onPause boolean Nie Na Pause.
clientId integer · int64 Nie Id klientów.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
categoryId integer · int64 Nie Kategoria ID.
categoryName string Nie Nazwa kategorii.
campaignType string Nie Typ kampanii.
dateStatImport string · date-time Nie Data przywozu statystyki.
nms string Nie - Nie.
paymentType string Nie Typo płatności.
curl --request POST 'https://api.selsup.ru/api/campaign/createCampaign?organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}'

Odpowiedź udana

200
Połączenia obiektu Campaign
PoleTypWymaganeOpis
id integer · int64 Nie Id.
externalId integer · int64 Nie Zewnętrzna identyfikacja.
name string Nie - Nazwa.
campaignName string Nie Nazwa kampanii.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Nie Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Nie Typ stanu.
productId integer · int64 Nie Id produktu.
externalProductId integer · int64 Nie Zewnętrzna identyfikacja produktu.
createDate string · date-time Nie Tworzyć datę.
endDate string · date-time Nie Termin końcowy.
startDate string · date-time Nie - Wczoraj.
sum integer · int64 Nie - W sumie.
writeOffType stringBALANCE, NET, BONUS Nie Wyłącz typ.
onPause boolean Nie Na Pause.
clientId integer · int64 Nie Id klientów.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
categoryId integer · int64 Nie Kategoria ID.
categoryName string Nie Nazwa kategorii.
campaignType string Nie Typ kampanii.
dateStatImport string · date-time Nie Data przywozu statystyki.
nms string Nie - Nie.
paymentType string Nie Typo płatności.
{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}
Władze10

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_client
Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_organization_not_found
Nie znaleziono organizacji

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_organization_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_prepared_integration_not_found
przygotowana integracja nie znaleziona

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_prepared_integration_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_service_not_supported
Usługa nie jest obsługiwana

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_service_not_supported; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired
Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_token_expired_or_revoked
Token API został odwołany lub wprowadzony nieprawidłowo. Sprawdź, czy klucz API ma pełną funkcjonalność. Wygeneruj nowy klucz i zastąp w SELSUP, ponieważ klucze mają okres ważności.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_token_expired_or_revoked; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_wildberries_api
{message}

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_wildberries_api; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Kampania importowa

/api/campaign/updateCampaigns
Token z dostępem do odczytu

Kampania importowe używające GET /api/campaign/updateCampaigns.

Parametry zapytania

PoleTypWymaganeOpis
organizationId integer · int64 Tak Id organizacyjny.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Tak - W służbie.
curl --request GET 'https://api.selsup.ru/api/campaign/updateCampaigns?organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu TmsTask
PoleTypWymaganeOpis
id integer · int64 Nie Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Nie Status.
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Nie Type.
name string Nie - Nazwa.
clientId integer · int64 Nie Id klientów.
entityId integer · int64 Nie Identyczny.
progress integer · int32 Nie - Wykonaj postępy.
processedQuantity integer · int32 Nie Wykorzystana ilość.
organizationId integer · int64 Nie Id organizacyjny.
priority integer · int32 Nie Priorytet.
properties string Nie - Właściwości.
message string Nie - Wysyła wiadomość.
messageParams string Nie - Przesłanie Params.
createdDate string · date-time Nie Tworzony Termin.
startDate string · date-time Nie - Wczoraj.
finishDate string · date-time Nie Termin zakończenia.
url string Nie - Url.
inputFileUrl string Nie Url pliku wprowadzania.
retryNumber integer · int32 Nie Powtórny numer prób.
userId integer · int32 Nie Id użytkownika.
retryDate string · date-time Nie Powtórny wypróbowanie.
debug boolean Nie Odbudowa.
forcedStart boolean Nie Wymuszony start.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
lang string Nie Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Władze5

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_analytics_access_denied
Dane analityczne są poufne dla roli SUPPORT

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_analytics_access_denied; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_unsupported_service
Usługa nie jest obsługiwana

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_unsupported_service; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Statystyki kampanii

/api/campaign/reloadCampaignStats
Token z dostępem do odczytu

Przeładowanie statystyk kampanii za pomocą GET /api/campaign/reloadCampaignStats.

Parametry zapytania

PoleTypWymaganeOpis
dateFrom string · date Tak - Od daty.
dateTo string · date Tak - W dniu do.
organizationId integer · int64 Tak Id organizacyjny.
isExpensesOnly boolean Nie Tylko wydatki.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Tak - W służbie.
curl --request GET 'https://api.selsup.ru/api/campaign/reloadCampaignStats?dateFrom=2026-01-15&dateTo=2026-01-15&organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200

Odpowiedź nie ma ciała.

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

GET

Zdobądź tematykę

/api/campaign/getWildberriesSubjects
Token z dostępem do odczytu

Uzyskaj poddany Wildberries używając GET /api/campaign/getWildberriesSubjects.

Parametry zapytania

PoleTypWymaganeOpis
query string Tak - Nie wiem.
limit integer · int32 Tak Ogranicz.
organizationId integer · int64 Tak Id organizacyjny.
curl --request GET 'https://api.selsup.ru/api/campaign/getWildberriesSubjects?query=string&limit=50&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Struktura pozycji zestawu WildberriesType[]
PoleTypWymaganeOpis
id integer · int64 Nie Id.
name string Nie - Nazwa.
published boolean Nie - Opublikowana.
hasSize boolean Nie Ma rozmiar.
monoBoxMinQuantity integer · int32 Nie Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Nie Mono Typ.
monoMinPrice integer · int32 Nie Mono Min Price.
hasParent boolean Nie Ma rodzica.
parentId integer · int64 Nie Idę rodzica.
wildberriesId integer · int64 Nie Id Wildberries.
lastSyncDate string · date-time Nie Ostatnia data synchronizacji.
notChangedDays integer · int32 Nie Nie zmienił się dzień.
commission number · double Nie Komisja.
fbsCommission number · double Nie Komisja FBI.
fbwCommission number · double Nie Komisja FBI.
dbsCommission number · double Nie Komisja DBS.
edbsCommission number · double Nie Komisja Edbs.
cAndCCommission number · double Nie C i CKomisy.
bookingCommission number · double Nie Komisja Rezerwacyjna.
logisticPrice integer · int32 Nie Logistyczna cena.
storagePrice number · double Nie Cena magazynowania.
acceptancePrice number · double Nie Cena akceptacji.
needDimensions boolean Nie Potrzebuję wymiarów.
purchasePercentAvg number · double Nie % zakupu Avg.
purchasePercentMin number · double Nie Kupna procent min.
photoAvg integer · int32 Nie Zdjęcie Avg.
photoMin integer · int32 Nie Zdjęcie Min.
drrAvg number · double Nie Doktor Avg.
drrMin number · double Nie Dr Min.
marginAvg number · double Nie Margin Avg.
marginMin number · double Nie Margin Min.
candCCommission number · double Nie C. Komisja.
[
  "string"
]
Władze7

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_organization_not_found
Nie znaleziono organizacji

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_organization_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_prepared_integration_not_found
przygotowana integracja nie znaleziona

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_prepared_integration_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired
Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_token_expired_or_revoked
Token API został odwołany lub wprowadzony nieprawidłowo. Sprawdź, czy klucz API ma pełną funkcjonalność. Wygeneruj nowy klucz i zastąp w SELSUP, ponieważ klucze mają okres ważności.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_token_expired_or_revoked; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Uzyskaj całkowite statystyczne kampanie

/api/campaign/getTotalStatCampaigns
Token z dostępem do odczytu

Uzyskaj ogólne staty kampanii za pomocą GET /api/campaign/getTotalStatCampaigns.

Parametry zapytania

PoleTypWymaganeOpis
organizationId integer · int64 Nie Id organizacyjny.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Tak - W służbie.
status string Nie Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Nie Status kampanii.
type integer · int32 Nie Type.
offset integer · int32 Nie - Nie.
dateTo string · date-time Nie - W dniu do.
dateFrom string · date-time Nie - Od daty.
isStatCampaign boolean Nie To jest Stat Campaign.
dateStart string · date-time Nie Data rozpoczęcia.
query string Nie - Nie wiem.
productExternalId integer · int64 Nie Id zewnętrzny produktu.
organizationIds integer[] Nie Identyfikaty organizacyjne.
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
count boolean Nie Zgromadzisz.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
topN integer · int32 Tak Górna N.
curl --request GET 'https://api.selsup.ru/api/campaign/getTotalStatCampaigns?service=NONE&limit=50&page=1&topN=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu CampaignTotalStats
PoleTypWymaganeOpis
clicks CampaignStat[] Nie - Klika.
Struktura pozycji zestawu CampaignStat
PoleTypWymaganeOpis
campaign string Nie Kampania.
value number · double Nie Wartość.
organizationId integer · int64 Nie Id organizacyjny.
organizationName string Nie Nazwa organizacji.
views CampaignStat[] Nie Widoki.
Struktura pozycji zestawu CampaignStat
PoleTypWymaganeOpis
campaign string Nie Kampania.
value number · double Nie Wartość.
organizationId integer · int64 Nie Id organizacyjny.
organizationName string Nie Nazwa organizacji.
expenses CampaignStat[] Nie - Wydaje się.
Struktura pozycji zestawu CampaignStat
PoleTypWymaganeOpis
campaign string Nie Kampania.
value number · double Nie Wartość.
organizationId integer · int64 Nie Id organizacyjny.
organizationName string Nie Nazwa organizacji.
averageCost CampaignStat[] Nie Średni koszt.
Struktura pozycji zestawu CampaignStat
PoleTypWymaganeOpis
campaign string Nie Kampania.
value number · double Nie Wartość.
organizationId integer · int64 Nie Id organizacyjny.
organizationName string Nie Nazwa organizacji.
{
  "clicks": "string",
  "views": "string",
  "expenses": "string",
  "averageCost": "string"
}
Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

GET

Zbierz kampanie statystyczne

/api/campaign/getStatCampaigns
Token z dostępem do odczytu

Uzyskaj kampanii stat za pomocą GET /api/campaign/getStatCampaigns.

Parametry zapytania

PoleTypWymaganeOpis
organizationId integer · int64 Nie Id organizacyjny.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Tak - W służbie.
status string Nie Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Nie Status kampanii.
type integer · int32 Nie Type.
offset integer · int32 Nie - Nie.
dateTo string · date-time Nie - W dniu do.
dateFrom string · date-time Nie - Od daty.
isStatCampaign boolean Nie To jest Stat Campaign.
dateStart string · date-time Nie Data rozpoczęcia.
query string Nie - Nie wiem.
productExternalId integer · int64 Nie Id zewnętrzny produktu.
organizationIds integer[] Nie Identyfikaty organizacyjne.
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
count boolean Nie Zgromadzisz.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
curl --request GET 'https://api.selsup.ru/api/campaign/getStatCampaigns?service=NONE&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu FindResponseStatCampaign
PoleTypWymaganeOpis
rows StatCampaign[] Nie Rzędy.
Struktura pozycji zestawu StatCampaign
PoleTypWymaganeOpis
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
count boolean Nie Zgromadzisz.
sortBy string Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
statCampaignId integer · int64 Nie Stat Campaign ID.
views integer · int32 Nie Widoki.
clicks integer · int32 Nie - Klika.
ratioClicksViews number · double Nie Wskaźnik kliknięć.
averageCost number · double Nie Średni koszt.
expenses number · double Nie - Wydaje się.
quantityAddCart integer · int32 Nie Kwota dodania koszyka.
quantityOrders integer · int32 Nie Zamówienia ilościowe.
ratioOrdersOfVisits number · double Nie Odsetek kolejności wizyt.
quantityProductOrders integer · int32 Nie Zamówienia na ilość produktu.
ordersAmount number · double Nie Liczba zamówień.
campaignId integer · int64 Nie Id kampania.
campaignName string Nie Nazwa kampanii.
createDate string · date-time Nie Tworzyć datę.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
campaignType stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Nie Typ kampanii.
categoryName string Nie Nazwa kategorii.
externalId integer · int64 Nie Zewnętrzna identyfikacja.
productId integer · int64 Nie Id produktu.
productViewId integer · int64 Nie Id widoku produktu.
date string · date-time Nie - Spotkanie.
startDate string · date-time Nie - Wczoraj.
endDate string · date-time Nie Termin końcowy.
importDate string · date-time Nie Data przywozu.
uniqueId string Nie Unikalny numer.
clientId integer · int64 Nie Id klientów.
organizationId integer · int64 Nie Id organizacyjny.
organizationName string Nie Nazwa organizacji.
rowType stringCAMPAIGN, UNALLOCATED Nie Typ rzędu.
quantityBuyouts number · double Nie Wyroby ilościowe.
revenue number · double Nie - Dochodzenie.
profitFact number · double Nie Fakt zysku.
marginFact number · double Nie Fakty marżowe.
drr number · double Nie - Dr.
cps number · double Nie - Policjant.
quantityBuyoutsForecast number · double Nie Prognoza ilościowa.
profitForecast number · double Nie Prognoza zysków.
marginForecast number · double Nie Prognoza marży.
allowableExpenses number · double Nie Dozwolone wydatki.
currency string Nie Walutę.
unavailableReasons object Nie Nie ma przyczyn.
{
  "rows": "string"
}
Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

GET

Zbierz kampanie

/api/campaign/getCampaigns
Token z dostępem do odczytu

Uzyskaj kampanie za pomocą GET /api/campaign/getCampaigns.

Parametry zapytania

PoleTypWymaganeOpis
organizationId integer · int64 Tak Id organizacyjny.
status string Nie Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Nie Status kampanii.
type integer · int32 Nie Type.
offset integer · int32 Nie - Nie.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
dateTo string · date-time Nie - W dniu do.
dateFrom string · date-time Nie - Od daty.
isStatCampaign boolean Nie To jest Stat Campaign.
dateStart string · date-time Nie Data rozpoczęcia.
query string Nie - Nie wiem.
productExternalId integer · int64 Nie Id zewnętrzny produktu.
organizationIds integer[] Nie Identyfikaty organizacyjne.
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
count boolean Nie Zgromadzisz.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaigns?organizationId=1001&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu FindResponseCampaign
PoleTypWymaganeOpis
rows Campaign[] Nie Rzędy.
Struktura pozycji zestawu Campaign
PoleTypWymaganeOpis
id integer · int64 Nie Id.
externalId integer · int64 Nie Zewnętrzna identyfikacja.
name string Nie - Nazwa.
campaignName string Nie Nazwa kampanii.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Nie Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Nie Typ stanu.
productId integer · int64 Nie Id produktu.
externalProductId integer · int64 Nie Zewnętrzna identyfikacja produktu.
createDate string · date-time Nie Tworzyć datę.
endDate string · date-time Nie Termin końcowy.
startDate string · date-time Nie - Wczoraj.
sum integer · int64 Nie - W sumie.
writeOffType stringBALANCE, NET, BONUS Nie Wyłącz typ.
onPause boolean Nie Na Pause.
clientId integer · int64 Nie Id klientów.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Nie - W służbie.
categoryId integer · int64 Nie Kategoria ID.
categoryName string Nie Nazwa kategorii.
campaignType string Nie Typ kampanii.
dateStatImport string · date-time Nie Data przywozu statystyki.
nms string Nie - Nie.
paymentType string Nie Typo płatności.
{
  "rows": "string"
}
Władze4

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_no_client
Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Zbilansować kampanii

/api/campaign/getCampaignBalance
Token z dostępem do odczytu

Uzyskaj równowagę kampanii za pomocą GET /api/campaign/getCampaignBalance.

Parametry zapytania

PoleTypWymaganeOpis
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Tak - W służbie.
organizationId integer · int64 Tak Id organizacyjny.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaignBalance?service=NONE&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu WbBalance
PoleTypWymaganeOpis
balance integer · int32 Nie Równowaga.
net integer · int32 Nie - Sieć.
bonus integer · int32 Nie - Bonus.
{
  "balance": 1,
  "net": 1,
  "bonus": 1
}
Władze7

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_organization_not_found
Nie znaleziono organizacji

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_organization_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_service_not_supported
Usługa nie jest obsługiwana

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_service_not_supported; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_subscription_expired
Twój okres obowiązywania taryfy wygasł. Opłać taryfę, aby kontynuować korzystanie z serwisu.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_subscription_expired; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_token_expired_or_revoked
Token API został odwołany lub wprowadzony nieprawidłowo. Sprawdź, czy klucz API ma pełną funkcjonalność. Wygeneruj nowy klucz i zastąp w SELSUP, ponieważ klucze mają okres ważności.

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_token_expired_or_revoked; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

Authorization

Token do wniosków o badania

Token pozostaje w lokalnym magazynie przeglądarki i jest wysyłany tylko w nagłówku Authorization z wniosków na api.selsup.ru.

Wypróbuj

Prawdziwe parametry żądania

Odpowiedź API

Wyślij wniosek o zapoznanie się z odpowiedzią SelSup.