SelSup Developers

Public API · API Referencja

Zwroty

Pozycje końcowe dotyczące zwrotu, w tym dokładne trasy, parametry, organy żądania i rozszerzalne schematy odpowiedzi.

3 punkty końcowe/api/returnStabilnyOpis czytelny maszynowo ↗
{ }

Strona ta jest wspierana przez edytowalny samodzielny kontrakt.

/api/return

Gotowe do użytkowania przepływy robocze

Gotowe do użytkowania przepływy robocze

01

Zacznij używać zwrotów

Użyj dedykowanego tokena API i najpierw sprawdź operacje odczytu z danymi testowymi.

  1. Trzymaj token z serwera i wysłać go w nagłówku Authorization.
  2. Sprawdź wymagane parametry i poszerz schemat żądania lub odpowiedzi.
  3. Zrób z statusem HTTP i stabilnym pole error w przypadku błędów aplikacyjnych.

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ą.

FileExportColumn5 pola
idinteger · int64

Id.

fileExportIdinteger · int64

Idekcja wywozu.

columnNamestring

Nazwa kolumny.

columnOrderinteger · int32

Kolumna.

isEnabledboolean

Jest włączona.

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.

FindResponseReturnReport1 pola
rowsReturnReport[]

Rzędy.

ReturnReport28 pola
idinteger · int64

Id.

orderTypestring

Typ zamówienia.

orderBarcodestring

Zamówić kod kreskowy.

barcodestring

Kod kreskowy.

productBarcodestring

Kod kreskowy produktu.

articlestring

Artykuł.

externalOrderIdstring

Id zewnętrznego zamówienia.

returnOrderIdstring

Oddajcie dowód zamówienia.

externalProductIdinteger · int64

Zewnętrzna identyfikacja produktu.

quantityinteger · int32

- W ilości.

officeIdinteger · int64

Identyfikacja biura.

officeAddressstring

Adres biura.

orderIdinteger · int64

Identyfikacja zamówienia.

pricenumber · double

- Cena.

currencyCodestring

Kod walutowy.

orderProductIdinteger · int64

Id produktu zamówienia.

returnDatestring · date-time

Data powrotu.

returnReasonNamestring

Powrót przyczyny.

statusstring

Status.

modifyDatestring · date-time

Zmiana daty.

createdDatestring · date-time

Tworzony Termin.

uniqueIdstring

Unikalny numer.

servicestring

- W służbie.

productIdinteger · int64

Id produktu.

productViewIdinteger · int64

Id widoku produktu.

productModelIdinteger · int64

Id produktu

clientIdinteger · int64

Id klientów.

organizationIdinteger · int64

Id organizacyjny.

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

Pobierz

/api/return/download
Token z dostępem do pisania

Załatw używając POST /api/return/download.

Parametry zapytania

PoleTypWymaganeOpis
productAnalyticField stringBARCODE, COLOR, ARTICLE, BRAND, CATEGORY Tak Poło analityczne produktów.
query string Nie - Nie wiem.
withDuplicate boolean Nie Z Duplicatem.
withBonus boolean Nie Z Bonusem.
byOrgAndService boolean Nie /Z organizacji i służby.
byOrderType boolean Nie /Po rodzaju zamówienia.
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
sortBy string Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
id integer · int64 Nie Id.
isMarketPlaceStructure boolean Nie To struktura rynku.
isDashboard boolean Nie To jest Dashboard.
analyticsField stringPRODUCT, MODEL, GROUP, ORGANIZATION, CLIENT, CATEGORY, PRODUCT_VIEW, BRAND, REGION, WAREHOUSE Nie /Płaszcz analityczny.
planDayCount integer · int32 Nie Plan dnia.
daysToSupply integer · int32 Nie Dni do zaopatrzenia.
plannedSupplyDate string · date-time Nie Planowana data dostawy.
groupByView boolean Nie Grupa po widoku.
warehouses integer[] Nie Składki.
salesModels string[] Nie Modele sprzedaży.
aggregation stringWAREHOUSE, WAREHOUSE_PRODUCT Nie - Aggregacja.
columns FileExportColumn[] Nie Kolumny.
Struktura pozycji zestawu FileExportColumn
PoleTypWymaganeOpis
id integer · int64 Nie Id.
fileExportId integer · int64 Nie Idekcja wywozu.
columnName string Nie Nazwa kolumny.
columnOrder integer · int32 Nie Kolumna.
isEnabled boolean Nie Jest włączona.
regions string[] Nie Regiony.
group boolean Nie Grupa.
calculationByOrders boolean Nie Kalkulacja na rozkaz.
sourceReport stringDEFAULT, ORDER, SALES, PROFIT, OZON, YANDEX_MARKET, WB_REALIZATION_FILE, WB_DETAILED_REPORT_FILE, OZON_REALIZATION_FILE, OZON_REALIZATION_FILE_NEW, OZON_COMPENSATIONS_FILE, OZON_SERVICES_FILE, OZON_CASH_FLOW_STATEMENT, WB_CAMPAIGN, SBER_MEGA_MARKET_FILES, YANDEX_MARKET_FILE_DETAILS, WB_RETURNS_REPORT, OWN_DELIVERY, OZON_CAMPAIGN_SKU_REPORT, WB_PAID_STORAGE, YANDEX_MARKET_NETTING, OZON_CPO_SKU_REPORT, UZUM, UZUM_EXPENSES, DEFECT_WRITE_OFF, LOCAL_ORDER, EXTERNAL_CAMPAIGN Nie Raport źródła.
skipDayWithoutStocks boolean Nie Przejmij dzień bez akcji.
replaceSetsByComponents boolean Nie Zastąpić zestawy za składniki.
distributeFbsByWarehouse boolean Nie Rozdzielają FBS według magazynu.
distributeFbsStock boolean Nie - Rozdzielają akcje FBI.
ignoreDumping boolean Nie Ignoruj dumpingu.
isSaleStructure boolean Nie To struktura sprzedaży.
isAveragePerOneUnit boolean Nie Jest średnia na jedną jednostkę.
updateDate boolean Nie Datę aktualizacji.
useWeightedGroup boolean Nie Użyj grupy ważonej.
isFindirRequest boolean Nie To jest Findir Request.
brandIds integer[] Nie - Tożsamości marki.
categoryIds integer[] Nie Identyfikaty kategorii.
articles string[] Nie Artykuły.
colors string[] Nie Kolory.
sizes string[] Nie Rozmiary.
barcodes string[] Nie Kody kreskowe.
tagIds integer[] Nie - Znajdźcie identyfikator.
penaltyFrom number · double Nie - Z kary.
penaltyTo number · double Nie Kary do.
logisticsFrom number · double Nie Logistyka z.
logisticsTo number · double Nie Logistyka do.
marginFrom number · double Nie Margin From.
marginTo number · double Nie Margin To.
salesAmountFrom number · double Nie Wysokość sprzedaży
salesAmountTo number · double Nie Do kwoty sprzedaży.
totalSalesAmountFrom number · double Nie Źródło:
totalSalesAmountTo number · double Nie Źródło:
grossProfitFrom number · double Nie Z tego dochodu.
grossProfitTo number · double Nie Do brutto zysku.
taxNds integer · int32 Nie Podatkowe.
useOsno boolean Nie Użyj Osno.
period stringDAY, WEEK, MONTH, QUARTER, YEAR, MONTH_3, MONTH_6, END_OF_TARIFF, MONTH_7, MONTH_14, YEAR_2 Nie Okres.
dateFrom string · date-time Tak - Od daty.
dateTo string · date-time Tak - W dniu do.
services string[] Nie - Usługi.
categories integer[] Nie Kategorie.
brands integer[] Nie Brandy.
clientOrganizationId integer · int64 Nie Id organizacji klienta.
organizations integer[] Nie Organizacje.
ids integer[] Nie - Identyfikaty.
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Nie Type.
types string[] Nie Typy.
status stringCREATED, REVOKING, REVOKED, ORDER_CREATED, CARDS_CREATED, BOX_BARCODES, IMAGES_UPLOADED, INVOICE_UPLOADED, READY_TO_SUPPLY, SUPPLIED, FINISHED, COLLECTED, SEND, DELIVERY, REFUND, COLLECTING, PACKING, PAYMENT_REQUIRED, CANCELED, CONTROVERSIAL, OVERDUE, READY_FOR_PICKUP, WAITING_SUPPLY, PICK_UP_REFUND, REFUND_RECEIVED, DELETED, RESTORE, PRODUCTION_CONFIRMED Nie Status.
timeZone integer · int32 Nie Strefa czasowa.
previousDateFrom string · date-time Nie Poprzednia data.
clientOrganizationIds integer[] Nie Identyfikaty organizacji klientów.
ignoreCredit boolean Nie Ignoruj kredyt.
curl --request POST 'https://api.selsup.ru/api/return/download?productAnalyticField=BARCODE&limit=50&page=1&dateFrom=2026-01-15T12%3A00%3A00Z&dateTo=2026-01-15T12%3A00%3A00Z' \
  --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_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.

GET

Znajdź

/api/return/find
Token z dostępem do odczytu

Znajdź używając GET /api/return/find.

Parametry zapytania

PoleTypWymaganeOpis
id integer · int64 Nie Id.
organizationId integer · int64 Nie Id organizacyjny.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Nie Typ zamówienia.
orderBarcode string Nie Zamówić kod kreskowy.
services string[] Nie - Usługi.
barcode string Nie Kod kreskowy.
productBarcode string Nie Kod kreskowy produktu.
article string Nie Artykuł.
externalOrderId string Nie Id zewnętrznego zamówienia.
returnOrderId string Nie Oddajcie dowód zamówienia.
externalProductId integer · int64 Nie Zewnętrzna identyfikacja produktu.
officeId integer · int64 Nie Identyfikacja biura.
officeAddress string Nie Adres biura.
orderId integer · int64 Nie Identyfikacja zamówienia.
orderProductId integer · int64 Nie Id produktu zamówienia.
returnReasonName string Nie Powrót przyczyny.
status string Nie Status.
timeZone integer · int32 Nie Strefa czasowa.
modifyDate string · date-time Nie Zmiana daty.
dateFrom string · date-time Nie - Od daty.
dateTo string · date-time Nie - W dniu do.
modifiedDateFrom string · date-time Nie Zmieniona data z.
modifiedDateTo string · date-time Nie Zmiana daty do.
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
count boolean Nie Zgromadzisz.
sortBy stringID, ORDER_TYPE, ORDER_BARCODE, BARCODE, PRODUCT_BARCODE, ARTICLE, EXTERNAL_ORDER_ID, RETURN_ORDER_ID, EXTERNAL_PRODUCT_ID, QUANTITY, OFFICE_ID, OFFICE_ADDRESS, ORDER_ID, PRICE, CURRENCY_CODE, SERVICE_ID, ORGANIZATION_ID, CREATED_DATE, RETURN_DATE, RETURN_REASON_NAME, STATUS, MODIFY_DATE Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
curl --request GET 'https://api.selsup.ru/api/return/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu FindResponseReturnReport
PoleTypWymaganeOpis
rows ReturnReport[] Nie Rzędy.
Struktura pozycji zestawu ReturnReport
PoleTypWymaganeOpis
id integer · int64 Nie Id.
orderType string Nie Typ zamówienia.
orderBarcode string Nie Zamówić kod kreskowy.
barcode string Nie Kod kreskowy.
productBarcode string Nie Kod kreskowy produktu.
article string Nie Artykuł.
externalOrderId string Nie Id zewnętrznego zamówienia.
returnOrderId string Nie Oddajcie dowód zamówienia.
externalProductId integer · int64 Nie Zewnętrzna identyfikacja produktu.
quantity integer · int32 Nie - W ilości.
officeId integer · int64 Nie Identyfikacja biura.
officeAddress string Nie Adres biura.
orderId integer · int64 Nie Identyfikacja zamówienia.
price number · double Nie - Cena.
currencyCode string Nie Kod walutowy.
orderProductId integer · int64 Nie Id produktu zamówienia.
returnDate string · date-time Nie Data powrotu.
returnReasonName string Nie Powrót przyczyny.
status string Nie Status.
modifyDate string · date-time Nie Zmiana daty.
createdDate string · date-time Nie Tworzony Termin.
uniqueId string Nie Unikalny numer.
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.
productId integer · int64 Nie Id produktu.
productViewId integer · int64 Nie Id widoku produktu.
productModelId integer · int64 Nie Id produktu
clientId integer · int64 Nie Id klientów.
organizationId integer · int64 Nie Id organizacyjny.
{
  "rows": "string"
}
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_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

Wraca plik

/api/return/file
Token z dostępem do odczytu

Wraca plik używając GET /api/return/file.

Parametry zapytania

PoleTypWymaganeOpis
id integer · int64 Nie Id.
organizationId integer · int64 Nie Id organizacyjny.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Nie Typ zamówienia.
orderBarcode string Nie Zamówić kod kreskowy.
services string[] Nie - Usługi.
barcode string Nie Kod kreskowy.
productBarcode string Nie Kod kreskowy produktu.
article string Nie Artykuł.
externalOrderId string Nie Id zewnętrznego zamówienia.
returnOrderId string Nie Oddajcie dowód zamówienia.
externalProductId integer · int64 Nie Zewnętrzna identyfikacja produktu.
officeId integer · int64 Nie Identyfikacja biura.
officeAddress string Nie Adres biura.
orderId integer · int64 Nie Identyfikacja zamówienia.
orderProductId integer · int64 Nie Id produktu zamówienia.
returnReasonName string Nie Powrót przyczyny.
status string Nie Status.
timeZone integer · int32 Nie Strefa czasowa.
modifyDate string · date-time Nie Zmiana daty.
dateFrom string · date-time Nie - Od daty.
dateTo string · date-time Nie - W dniu do.
modifiedDateFrom string · date-time Nie Zmieniona data z.
modifiedDateTo string · date-time Nie Zmiana daty do.
limit integer · int32 Nie Ogranicz.
page integer · int32 Nie Strona.
count boolean Nie Zgromadzisz.
sortBy stringID, ORDER_TYPE, ORDER_BARCODE, BARCODE, PRODUCT_BARCODE, ARTICLE, EXTERNAL_ORDER_ID, RETURN_ORDER_ID, EXTERNAL_PRODUCT_ID, QUANTITY, OFFICE_ID, OFFICE_ADDRESS, ORDER_ID, PRICE, CURRENCY_CODE, SERVICE_ID, ORGANIZATION_ID, CREATED_DATE, RETURN_DATE, RETURN_REASON_NAME, STATUS, MODIFY_DATE Nie - Zarejestrowany.
ascending boolean Nie Wzniesienie.
curl --request GET 'https://api.selsup.ru/api/return/file?limit=50&page=1' \
  --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ł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.

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.