SelSup Developers

El proyecto de ley de la Unión Europea · API Referencia

Las devoluciones

Los puntos finales de devoluciones, incluidas las rutas exactas, los parámetros, los organismos de solicitud y los esquemas de respuesta expandibles.

3 puntos finales/api/returnEstablesDescripción legible por máquina ↗
{ }

Esta página está respaldada por un contrato independiente editable. Valida las operaciones de escritura con datos de prueba antes de su uso en producción.

/api/return

Flujos de trabajo listos para su uso

Flujos de trabajo listos para su uso

01

Comience con Returnas

Utilice un token API dedicado y valida primero las operaciones de lectura con los datos de prueba.

  1. Mantenga el token en el lado del servidor y envíelo en el encabezado Authorization.
  2. Verifique los parámetros requeridos y amplíe el esquema de solicitud o respuesta.
  3. Manejar el estado HTTP y el campo estable error en errores de aplicación.

Modelo de datos

Estructuras de datos

Los modelos se enumeran una vez aquí y también se pueden ampliar directamente desde los puntos finales que los utilizan.

FileExportColumn5 campos
idinteger · int64

Id.

fileExportIdinteger · int64

Identificación de archivo de exportación.

columnNamestring

Nombre de la columna.

columnOrderinteger · int32

Orden de la columna.

isEnabledboolean

Está habilitado.

TmsTask25 campos
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

- ¿Cómo se llama?

clientIdinteger · int64

Identificación del cliente.

entityIdinteger · int64

Identificación de la entidad.

progressinteger · int32

El progreso.

processedQuantityinteger · int32

Cuantidad procesada.

organizationIdinteger · int64

Identificación de la organización.

priorityinteger · int32

Prioridad.

propertiesstring

Las propiedades.

messagestring

- Mensaje.

messageParamsstring

Mensaje de Params.

createdDatestring · date-time

Creado fecha.

startDatestring · date-time

La fecha de inicio.

finishDatestring · date-time

Fecha de finalización.

urlstring

- ¿Qué quieres?

inputFileUrlstring

Envía el URL del archivo.

retryNumberinteger · int32

- No. - ¿Qué es eso?

userIdinteger · int32

Identificación del usuario.

retryDatestring · date-time

Date de nuevo.

debugboolean

Desarreglo.

forcedStartboolean

El inicio forzado.

servicestring

Servicio.

langstring

Lang.

FindResponseReturnReport1 campos
rowsReturnReport[]

Las filas.

ReturnReport28 campos
idinteger · int64

Id.

orderTypestring

Tipo de orden.

orderBarcodestring

Ordena código de barras.

barcodestring

Código de barras.

productBarcodestring

Código de barras del producto.

articlestring

Artículo.

externalOrderIdstring

Identificación de orden externa.

returnOrderIdstring

Regresa el número de orden.

externalProductIdinteger · int64

Identificación externa del producto.

quantityinteger · int32

La cantidad.

officeIdinteger · int64

Identificación de oficina.

officeAddressstring

Dirección de oficina.

orderIdinteger · int64

El número de orden.

pricenumber · double

El precio.

currencyCodestring

Código de moneda.

orderProductIdinteger · int64

El nombre del producto.

returnDatestring · date-time

Fecha de regreso.

returnReasonNamestring

Regresa el nombre de la razón.

statusstring

Status.

modifyDatestring · date-time

Modifique la fecha.

createdDatestring · date-time

Creado fecha.

uniqueIdstring

Identificación única.

servicestring

Servicio.

productIdinteger · int64

Identificación del producto.

productViewIdinteger · int64

Identificación de la vista del producto.

productModelIdinteger · int64

Identificación del modelo del producto.

clientIdinteger · int64

Identificación del cliente.

organizationIdinteger · int64

Identificación de la organización.

Contrato de error

Cómo se devuelven los errores de aplicación

El código error es idéntico en todas las localizaciones, mientras que el mensaje orientado al usuario es traducido por el servidor.

Exproteccion

Código estable legible por máquina para la lógica de integración.

Exproteccion

Mensaje listo para la pantalla en el idioma del usuario de tokens API.

Exproteccion

Valores interpolados por el servidor en la plantilla de mensaje localizado.

localMessage utiliza el campo lang del usuario que posee el token API. El lenguaje de documentación y el encabezado Accept-Language no lo cambian; el ruso se utiliza cuando el usuario no tiene un idioma configurado.

RUEl lugar del usuario es ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ESEspañol (es)
{
  "error": "error_brand_already_exists",
  "localMessage": "La marca Base ya existe",
  "params": {
    "name": "Base"
  }
}

Puntos finales

Puntos finales

POST

Descarga

/api/return/download
Token con acceso a escribir

Descarga con POST /api/return/download.

Parámetros de consulta

CampoTipoObligatorioDescripción
productAnalyticField stringBARCODE, COLOR, ARTICLE, BRAND, CATEGORY Campo de análisis de productos.
query string No - ¿Qué quieres decir?
withDuplicate boolean No Con Duplicate.
withBonus boolean No Con Bonus.
byOrgAndService boolean No Por la Org y el Servicio.
byOrderType boolean No Por tipo de orden.
limit integer · int32 No El límite.
page integer · int32 No Página.
sortBy string No Se ha ordenado.
ascending boolean No Ascendiendo.
id integer · int64 No Id.
isMarketPlaceStructure boolean No Es la estructura del mercado.
isDashboard boolean No Es el tablero.
analyticsField stringPRODUCT, MODEL, GROUP, ORGANIZATION, CLIENT, CATEGORY, PRODUCT_VIEW, BRAND, REGION, WAREHOUSE No Campo de análisis.
planDayCount integer · int32 No Cuenta el día del plan.
daysToSupply integer · int32 No Días para el suministro.
plannedSupplyDate string · date-time No Fecha de suministro prevista.
groupByView boolean No Grupo por punto de vista.
warehouses integer[] No Los almacenes.
salesModels string[] No Modelos de ventas.
aggregation stringWAREHOUSE, WAREHOUSE_PRODUCT No La agregación.
columns FileExportColumn[] No Las columnas.
Estructura de los elementos del array FileExportColumn
CampoTipoObligatorioDescripción
id integer · int64 No Id.
fileExportId integer · int64 No Identificación de archivo de exportación.
columnName string No Nombre de la columna.
columnOrder integer · int32 No Orden de la columna.
isEnabled boolean No Está habilitado.
regions string[] No Las regiones.
group boolean No Grupo.
calculationByOrders boolean No Calculo por orden.
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 No Informe de origen.
skipDayWithoutStocks boolean No Salta el día sin acciones.
replaceSetsByComponents boolean No Replace los conjuntos por componentes.
distributeFbsByWarehouse boolean No Distribuye el Fbs por almacén.
distributeFbsStock boolean No Distribuye acciones de la FBS.
ignoreDumping boolean No Ignora el Dumping.
isSaleStructure boolean No Es la estructura de ventas.
isAveragePerOneUnit boolean No Es el promedio por una unidad.
updateDate boolean No Fecha de actualización.
useWeightedGroup boolean No Utilice el grupo ponderado.
isFindirRequest boolean No Es la solicitud de Findir.
brandIds integer[] No Identificación de marca.
categoryIds integer[] No Identificación de categoría.
articles string[] No Artículos.
colors string[] No Los colores.
sizes string[] No Los tamaños.
barcodes string[] No Códigos de barras.
tagIds integer[] No Identificación de marca.
penaltyFrom number · double No El castigo de.
penaltyTo number · double No El castigo para.
logisticsFrom number · double No Desde la Logística.
logisticsTo number · double No Logística a.
marginFrom number · double No Margen de.
marginTo number · double No Margen a.
salesAmountFrom number · double No El importe de las ventas.
salesAmountTo number · double No El importe de las ventas a.
totalSalesAmountFrom number · double No El importe total de las ventas de.
totalSalesAmountTo number · double No El importe total de las ventas a.
grossProfitFrom number · double No Profitos Brutos de.
grossProfitTo number · double No El beneficio bruto para.
taxNds integer · int32 No Los impuestos.
useOsno boolean No Usa a Osno.
period stringDAY, WEEK, MONTH, QUARTER, YEAR, MONTH_3, MONTH_6, END_OF_TARIFF, MONTH_7, MONTH_14, YEAR_2 No El período.
dateFrom string · date-time La fecha de.
dateTo string · date-time La fecha para.
services string[] No Servicios.
categories integer[] No Las categorías.
brands integer[] No Las marcas.
clientOrganizationId integer · int64 No Identificación de la organización del cliente.
organizations integer[] No Las organizaciones.
ids integer[] No - ¿Qué es eso?
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION No Type.
types string[] No Los tipos.
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 No Status.
timeZone integer · int32 No Zona horaria.
previousDateFrom string · date-time No La fecha anterior de.
clientOrganizationIds integer[] No Identificación de la organización del cliente.
ignoreCredit boolean No Ignora el crédito.
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'

Respuesta exitosa

200
Campos de objetos TmsTask
CampoTipoObligatorioDescripción
id integer · int64 No Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION No 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 No Type.
name string No - ¿Cómo se llama?
clientId integer · int64 No Identificación del cliente.
entityId integer · int64 No Identificación de la entidad.
progress integer · int32 No El progreso.
processedQuantity integer · int32 No Cuantidad procesada.
organizationId integer · int64 No Identificación de la organización.
priority integer · int32 No Prioridad.
properties string No Las propiedades.
message string No - Mensaje.
messageParams string No Mensaje de Params.
createdDate string · date-time No Creado fecha.
startDate string · date-time No La fecha de inicio.
finishDate string · date-time No Fecha de finalización.
url string No - ¿Qué quieres?
inputFileUrl string No Envía el URL del archivo.
retryNumber integer · int32 No - No. - ¿Qué es eso?
userId integer · int32 No Identificación del usuario.
retryDate string · date-time No Date de nuevo.
debug boolean No Desarreglo.
forcedStart boolean No El inicio forzado.
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 No Servicio.
lang string No Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Errores5

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_analytics_access_denied
Los datos anal�ticos son confidenciales para el rol SUPPORT

error específico de punto final. Utilice el código estable error_analytics_access_denied en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_organization_not_found
Organización no encontrada

error específico de punto final. Utilice el código estable error_organization_not_found en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

GET

Encuentra

/api/return/find
Token con acceso a lectura

Encontrar usando GET /api/return/find.

Parámetros de consulta

CampoTipoObligatorioDescripción
id integer · int64 No Id.
organizationId integer · int64 No Identificación de la organización.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION No Tipo de orden.
orderBarcode string No Ordena código de barras.
services string[] No Servicios.
barcode string No Código de barras.
productBarcode string No Código de barras del producto.
article string No Artículo.
externalOrderId string No Identificación de orden externa.
returnOrderId string No Regresa el número de orden.
externalProductId integer · int64 No Identificación externa del producto.
officeId integer · int64 No Identificación de oficina.
officeAddress string No Dirección de oficina.
orderId integer · int64 No El número de orden.
orderProductId integer · int64 No El nombre del producto.
returnReasonName string No Regresa el nombre de la razón.
status string No Status.
timeZone integer · int32 No Zona horaria.
modifyDate string · date-time No Modifique la fecha.
dateFrom string · date-time No La fecha de.
dateTo string · date-time No La fecha para.
modifiedDateFrom string · date-time No Fecha de fecha modificada.
modifiedDateTo string · date-time No La fecha modificada para.
limit integer · int32 No El límite.
page integer · int32 No Página.
count boolean No Conde.
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 No Se ha ordenado.
ascending boolean No Ascendiendo.
curl --request GET 'https://api.selsup.ru/api/return/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos FindResponseReturnReport
CampoTipoObligatorioDescripción
rows ReturnReport[] No Las filas.
Estructura de los elementos del array ReturnReport
CampoTipoObligatorioDescripción
id integer · int64 No Id.
orderType string No Tipo de orden.
orderBarcode string No Ordena código de barras.
barcode string No Código de barras.
productBarcode string No Código de barras del producto.
article string No Artículo.
externalOrderId string No Identificación de orden externa.
returnOrderId string No Regresa el número de orden.
externalProductId integer · int64 No Identificación externa del producto.
quantity integer · int32 No La cantidad.
officeId integer · int64 No Identificación de oficina.
officeAddress string No Dirección de oficina.
orderId integer · int64 No El número de orden.
price number · double No El precio.
currencyCode string No Código de moneda.
orderProductId integer · int64 No El nombre del producto.
returnDate string · date-time No Fecha de regreso.
returnReasonName string No Regresa el nombre de la razón.
status string No Status.
modifyDate string · date-time No Modifique la fecha.
createdDate string · date-time No Creado fecha.
uniqueId string No Identificación única.
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 No Servicio.
productId integer · int64 No Identificación del producto.
productViewId integer · int64 No Identificación de la vista del producto.
productModelId integer · int64 No Identificación del modelo del producto.
clientId integer · int64 No Identificación del cliente.
organizationId integer · int64 No Identificación de la organización.
{
  "rows": "string"
}
Errores5

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

400error_analytics_access_denied
Los datos anal�ticos son confidenciales para el rol SUPPORT

error específico de punto final. Utilice el código estable error_analytics_access_denied en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

400error_no_client
Cliente no encontrado o fue eliminado. Escriba al soporte

error específico de punto final. Utilice el código estable error_no_client en la lógica de la aplicación; localMessage contiene la traducción mostrada anteriormente.

GET

Regresar el archivo

/api/return/file
Token con acceso a lectura

Regresa el archivo utilizando GET /api/return/file.

Parámetros de consulta

CampoTipoObligatorioDescripción
id integer · int64 No Id.
organizationId integer · int64 No Identificación de la organización.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION No Tipo de orden.
orderBarcode string No Ordena código de barras.
services string[] No Servicios.
barcode string No Código de barras.
productBarcode string No Código de barras del producto.
article string No Artículo.
externalOrderId string No Identificación de orden externa.
returnOrderId string No Regresa el número de orden.
externalProductId integer · int64 No Identificación externa del producto.
officeId integer · int64 No Identificación de oficina.
officeAddress string No Dirección de oficina.
orderId integer · int64 No El número de orden.
orderProductId integer · int64 No El nombre del producto.
returnReasonName string No Regresa el nombre de la razón.
status string No Status.
timeZone integer · int32 No Zona horaria.
modifyDate string · date-time No Modifique la fecha.
dateFrom string · date-time No La fecha de.
dateTo string · date-time No La fecha para.
modifiedDateFrom string · date-time No Fecha de fecha modificada.
modifiedDateTo string · date-time No La fecha modificada para.
limit integer · int32 No El límite.
page integer · int32 No Página.
count boolean No Conde.
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 No Se ha ordenado.
ascending boolean No Ascendiendo.
curl --request GET 'https://api.selsup.ru/api/return/file?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos TmsTask
CampoTipoObligatorioDescripción
id integer · int64 No Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION No 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 No Type.
name string No - ¿Cómo se llama?
clientId integer · int64 No Identificación del cliente.
entityId integer · int64 No Identificación de la entidad.
progress integer · int32 No El progreso.
processedQuantity integer · int32 No Cuantidad procesada.
organizationId integer · int64 No Identificación de la organización.
priority integer · int32 No Prioridad.
properties string No Las propiedades.
message string No - Mensaje.
messageParams string No Mensaje de Params.
createdDate string · date-time No Creado fecha.
startDate string · date-time No La fecha de inicio.
finishDate string · date-time No Fecha de finalización.
url string No - ¿Qué quieres?
inputFileUrl string No Envía el URL del archivo.
retryNumber integer · int32 No - No. - ¿Qué es eso?
userId integer · int32 No Identificación del usuario.
retryDate string · date-time No Date de nuevo.
debug boolean No Desarreglo.
forcedStart boolean No El inicio forzado.
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 No Servicio.
lang string No Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Errores3

Los errores de aplicación se devuelven normalmente como JSON con error, localMessage y params. Cómo se devuelven los errores de aplicación ↑

401auth_required
Se requiere la autenticación

Authorization está faltando, vacío o contiene un token inválido.

400error_access_denied
Acceso denegado

El token existe, pero su papel no puede realizar esta operación.

500error_unknown
Ocurrió un error desconocido. Si el problema persiste, escriba al servicio de soporte

Fallo interno: ahorra tiempo en la solicitud y apoyo de contacto; no vuelva a intentar una mutación ciegamente.

Authorization

Token para las solicitudes de ensayo

El token se queda en el localStorage de este navegador y se envía solo en el encabezado Authorization de las solicitudes a api.selsup.ru.

Probar

Parámetros reales de la solicitud

Respuesta en vivo API

Envía una solicitud para ver la respuesta SelSup.