SelSup Developers

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

Campañas publicitarias

Puntos finales para campañas publicitarias, incluidas rutas exactas, parámetros, organismos de solicitud y esquemas de respuesta expansibles.

10 puntos finales/api/campaignEstablesDescripció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/campaign

Flujos de trabajo listos para su uso

Flujos de trabajo listos para su uso

01

Comience a utilizar las campañas publicitarias

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.

CampaignFilter17 campos
limitinteger · int32

El límite.

pageinteger · int32

Página.

countboolean

Conde.

sortBystring

Se ha ordenado.

ascendingboolean

Ascendiendo.

statusstring

Status.

campaignStatusstring

Estatus de la campaña.

typeinteger · int32

Type.

offsetinteger · int32

- No lo puedo hacer.

servicestring

Servicio.

dateTostring · date-time

La fecha para.

dateFromstring · date-time

La fecha de.

isStatCampaignboolean

Es la campaña de Estado.

dateStartstring · date-time

La fecha de inicio.

querystring

- ¿Qué quieres decir?

productExternalIdinteger · int64

Identificación externa del producto.

organizationIdsinteger[]

Identificación de la organización.

CampaignStatExportRequest4 campos
servicestring

Servicio.

organizationIdinteger · int64

Identificación de la organización.

organizationIdsinteger[]

Identificación de la organización.

filterCampaignFilter

El filtro.

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.

Campaign22 campos
idinteger · int64

Id.

externalIdinteger · int64

Identificación externa.

namestring

- ¿Cómo se llama?

campaignNamestring

Nombre de campaña.

typestring

Type.

statusTypestring

Tipo de estado.

productIdinteger · int64

Identificación del producto.

externalProductIdinteger · int64

Identificación externa del producto.

createDatestring · date-time

Crear la fecha.

endDatestring · date-time

Fecha de fin.

startDatestring · date-time

La fecha de inicio.

suminteger · int64

- ¿Qué quieres decir?

writeOffTypestring

Escribir fuera de tipo.

onPauseboolean

En Pausa.

clientIdinteger · int64

Identificación del cliente.

servicestring

Servicio.

categoryIdinteger · int64

Identificación de categoría.

categoryNamestring

Nombre de la categoría.

campaignTypestring

Tipo de campaña.

dateStatImportstring · date-time

Datos de importación de datos.

nmsstring

- No. - ¿Qué quieres decir?

paymentTypestring

Tipo de pago.

WildberriesType32 campos
idinteger · int64

Id.

namestring

- ¿Cómo se llama?

publishedboolean

Publicado.

hasSizeboolean

Tiene tamaño.

monoBoxMinQuantityinteger · int32

Mono caja Min cantidad.

monoTypestring

Tipo mono.

monoMinPriceinteger · int32

Mono Min Price.

hasParentboolean

Tiene padre.

parentIdinteger · int64

Identificación de los padres.

wildberriesIdinteger · int64

Identificación de las jabalíes.

lastSyncDatestring · date-time

Última fecha de sincronización.

notChangedDaysinteger · int32

No cambiaron los días.

commissionnumber · double

El Parlamento Europeo.

fbsCommissionnumber · double

La Comisión del FBI.

fbwCommissionnumber · double

La Comisión de la FBB.

dbsCommissionnumber · double

La Comisión de Seguridad Social.

edbsCommissionnumber · double

La Comisión de Edbs.

cAndCCommissionnumber · double

C y C. La Comisión.

bookingCommissionnumber · double

Comisión de reservas.

logisticPriceinteger · int32

Precio logístico.

storagePricenumber · double

Precio de almacenamiento.

acceptancePricenumber · double

Precio de aceptación.

needDimensionsboolean

Necesitamos las Dimensiones.

purchasePercentAvgnumber · double

El porcentaje de compra Avg.

purchasePercentMinnumber · double

Porcentaje de compra Min.

photoAvginteger · int32

Foto de Avg.

photoMininteger · int32

Foto Min.

drrAvgnumber · double

El Dr. Avg.

drrMinnumber · double

El Dr. Min.

marginAvgnumber · double

Margen Avg.

marginMinnumber · double

Margen Min.

candCCommissionnumber · double

Canda C. Comisión.

CampaignStat4 campos
campaignstring

Campaña.

valuenumber · double

El valor.

organizationIdinteger · int64

Identificación de la organización.

organizationNamestring

Nombre de la organización.

CampaignTotalStats4 campos
clicksCampaignStat[]

- Clices.

viewsCampaignStat[]

Vistas.

expensesCampaignStat[]

¿Qué es eso?

averageCostCampaignStat[]

El costo medio.

FindResponseStatCampaign1 campos
rowsStatCampaign[]

Las filas.

StatCampaign46 campos
limitinteger · int32

El límite.

pageinteger · int32

Página.

countboolean

Conde.

sortBystring

Se ha ordenado.

ascendingboolean

Ascendiendo.

statCampaignIdinteger · int64

Identificación de campaña de estado.

viewsinteger · int32

Vistas.

clicksinteger · int32

- Clices.

ratioClicksViewsnumber · double

Ratio de Clices Vistas.

averageCostnumber · double

El costo medio.

expensesnumber · double

¿Qué es eso?

quantityAddCartinteger · int32

Cuantidad de cartera de adición.

quantityOrdersinteger · int32

Las órdenes de cantidad.

ratioOrdersOfVisitsnumber · double

Ratio de órdenes de visitas.

quantityProductOrdersinteger · int32

Los pedidos de productos en cantidad.

ordersAmountnumber · double

El número de pedidos.

campaignIdinteger · int64

Identificación de campaña.

campaignNamestring

Nombre de campaña.

createDatestring · date-time

Crear la fecha.

servicestring

Servicio.

campaignTypestring

Tipo de campaña.

categoryNamestring

Nombre de la categoría.

externalIdinteger · int64

Identificación externa.

productIdinteger · int64

Identificación del producto.

productViewIdinteger · int64

Identificación de la vista del producto.

datestring · date-time

- ¿Qué?

startDatestring · date-time

La fecha de inicio.

endDatestring · date-time

Fecha de fin.

importDatestring · date-time

Fecha de importación.

uniqueIdstring

Identificación única.

clientIdinteger · int64

Identificación del cliente.

organizationIdinteger · int64

Identificación de la organización.

organizationNamestring

Nombre de la organización.

rowTypestring

Tipo de fila.

quantityBuyoutsnumber · double

Compras de cantidad.

revenuenumber · double

Los ingresos.

profitFactnumber · double

El hecho de las ganancias.

marginFactnumber · double

El hecho de margen.

drrnumber · double

¿Qué es eso?

cpsnumber · double

- Sí, es el CPS.

quantityBuyoutsForecastnumber · double

Previsión de las compras de cantidad.

profitForecastnumber · double

Previsión de ganancias.

marginForecastnumber · double

Previsión de margen.

allowableExpensesnumber · double

Gastos permitidos.

currencystring

El dinero.

unavailableReasonsobject

No hay razones disponibles.

FindResponseCampaign1 campos
rowsCampaign[]

Las filas.

WbBalance3 campos
balanceinteger · int32

El equilibrio.

netinteger · int32

La red.

bonusinteger · int32

- Sí, es un bono.

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

Actualización de la campaña de estado

/api/campaign/updateStatusCampaign
Token con acceso a escribir

Actualizar la campaña de estado usando POST /api/campaign/updateStatusCampaign.

Parámetros de consulta

CampoTipoObligatorioDescripción
campaignId integer · int64 Identificación de campaña.
status stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Status.
organizationId integer · int64 Identificación de la organización.
curl --request POST 'https://api.selsup.ru/api/campaign/updateStatusCampaign?campaignId=1001&status=DELETED&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200

La respuesta no tiene cuerpo.

Errores9

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

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.

400error_prepared_integration_not_found
integración preparada no encontrada

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

400error_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

400error_token_expired_or_revoked
El token API ha sido revocado o introducido incorrectamente. Verifica que la clave API tenga toda la funcionalidad. Genera una nueva clave y reemplázala en SELSUP, ya que las claves tienen un período de vida.

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

400error_wildberries_api
{message}

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

POST

Estadísticas de la campaña de exportación

/api/campaign/stats/xlsx
Token con acceso a escribir

Estadísticas de la campaña de exportación utilizando POST /api/campaign/stats/xlsx.

Organismo de solicitud

application/json
Campos de objetosCampaignStatExportRequest
CampoTipoObligatorioDescripción
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.
organizationId integer · int64 No Identificación de la organización.
organizationIds integer[] No Identificación de la organización.
filter CampaignFilter No El filtro.
Campos de objetos CampaignFilter
CampoTipoObligatorioDescripción
limit integer · int32 No El límite.
page integer · int32 No Página.
count boolean No Conde.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS No Se ha ordenado.
ascending boolean No Ascendiendo.
status string No Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Estatus de la campaña.
type integer · int32 No Type.
offset integer · int32 No - No lo puedo hacer.
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.
dateTo string · date-time No La fecha para.
dateFrom string · date-time No La fecha de.
isStatCampaign boolean No Es la campaña de Estado.
dateStart string · date-time No La fecha de inicio.
query string No - ¿Qué quieres decir?
productExternalId integer · int64 No Identificación externa del producto.
organizationIds integer[] No Identificación de la organización.
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"
}'

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
}
Errores9

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_marketplace
No se ha especificado marketplace

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

400error_no_organization
No se especificó la organización

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

400error_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

400error_unsupported_service
Servicio no compatible

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

400error_user_does_not_have_this_organization
El usuario no tiene acceso a esta organización

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

POST

Crear una campaña

/api/campaign/createCampaign
Token con acceso a escribir

Crear Campaña con POST /api/campaign/createCampaign.

Parámetros de consulta

CampoTipoObligatorioDescripción
organizationId integer · int64 Identificación de la organización.

Organismo de solicitud

application/json
Campos de objetosCampaign
CampoTipoObligatorioDescripción
id integer · int64 No Id.
externalId integer · int64 No Identificación externa.
name string No - ¿Cómo se llama?
campaignName string No Nombre de campaña.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN No Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Tipo de estado.
productId integer · int64 No Identificación del producto.
externalProductId integer · int64 No Identificación externa del producto.
createDate string · date-time No Crear la fecha.
endDate string · date-time No Fecha de fin.
startDate string · date-time No La fecha de inicio.
sum integer · int64 No - ¿Qué quieres decir?
writeOffType stringBALANCE, NET, BONUS No Escribir fuera de tipo.
onPause boolean No En Pausa.
clientId integer · int64 No Identificación del cliente.
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.
categoryId integer · int64 No Identificación de categoría.
categoryName string No Nombre de la categoría.
campaignType string No Tipo de campaña.
dateStatImport string · date-time No Datos de importación de datos.
nms string No - No. - ¿Qué quieres decir?
paymentType string No Tipo de pago.
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"
}'

Respuesta exitosa

200
Campos de objetos Campaign
CampoTipoObligatorioDescripción
id integer · int64 No Id.
externalId integer · int64 No Identificación externa.
name string No - ¿Cómo se llama?
campaignName string No Nombre de campaña.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN No Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Tipo de estado.
productId integer · int64 No Identificación del producto.
externalProductId integer · int64 No Identificación externa del producto.
createDate string · date-time No Crear la fecha.
endDate string · date-time No Fecha de fin.
startDate string · date-time No La fecha de inicio.
sum integer · int64 No - ¿Qué quieres decir?
writeOffType stringBALANCE, NET, BONUS No Escribir fuera de tipo.
onPause boolean No En Pausa.
clientId integer · int64 No Identificación del cliente.
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.
categoryId integer · int64 No Identificación de categoría.
categoryName string No Nombre de la categoría.
campaignType string No Tipo de campaña.
dateStatImport string · date-time No Datos de importación de datos.
nms string No - No. - ¿Qué quieres decir?
paymentType string No Tipo de pago.
{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}
Errores10

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

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.

400error_prepared_integration_not_found
integración preparada no encontrada

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

400error_service_not_supported
Servicio no compatible

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

400error_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

400error_token_expired_or_revoked
El token API ha sido revocado o introducido incorrectamente. Verifica que la clave API tenga toda la funcionalidad. Genera una nueva clave y reemplázala en SELSUP, ya que las claves tienen un período de vida.

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

400error_wildberries_api
{message}

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

GET

Campañas de importación

/api/campaign/updateCampaigns
Token con acceso a lectura

Campañas de importación con GET /api/campaign/updateCampaigns.

Parámetros de consulta

CampoTipoObligatorioDescripción
organizationId integer · int64 Identificación de la organización.
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 Servicio.
curl --request GET 'https://api.selsup.ru/api/campaign/updateCampaigns?organizationId=1001&service=NONE' \
  --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_unsupported_service
Servicio no compatible

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

GET

Recarga las estadísticas de la campaña

/api/campaign/reloadCampaignStats
Token con acceso a lectura

Reload las estadísticas de la campaña utilizando GET /api/campaign/reloadCampaignStats.

Parámetros de consulta

CampoTipoObligatorioDescripción
dateFrom string · date La fecha de.
dateTo string · date La fecha para.
organizationId integer · int64 Identificación de la organización.
isExpensesOnly boolean No Es sólo gastos.
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 Servicio.
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'

Respuesta exitosa

200

La respuesta no tiene cuerpo.

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.

GET

Obtenga temas de las bandas

/api/campaign/getWildberriesSubjects
Token con acceso a lectura

Obtenga los sujetos de Wildberries usando GET /api/campaign/getWildberriesSubjects.

Parámetros de consulta

CampoTipoObligatorioDescripción
query string - ¿Qué quieres decir?
limit integer · int32 El límite.
organizationId integer · int64 Identificación de la organización.
curl --request GET 'https://api.selsup.ru/api/campaign/getWildberriesSubjects?query=string&limit=50&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Estructura de los elementos del array WildberriesType[]
CampoTipoObligatorioDescripción
id integer · int64 No Id.
name string No - ¿Cómo se llama?
published boolean No Publicado.
hasSize boolean No Tiene tamaño.
monoBoxMinQuantity integer · int32 No Mono caja Min cantidad.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Tipo mono.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Tiene padre.
parentId integer · int64 No Identificación de los padres.
wildberriesId integer · int64 No Identificación de las jabalíes.
lastSyncDate string · date-time No Última fecha de sincronización.
notChangedDays integer · int32 No No cambiaron los días.
commission number · double No El Parlamento Europeo.
fbsCommission number · double No La Comisión del FBI.
fbwCommission number · double No La Comisión de la FBB.
dbsCommission number · double No La Comisión de Seguridad Social.
edbsCommission number · double No La Comisión de Edbs.
cAndCCommission number · double No C y C. La Comisión.
bookingCommission number · double No Comisión de reservas.
logisticPrice integer · int32 No Precio logístico.
storagePrice number · double No Precio de almacenamiento.
acceptancePrice number · double No Precio de aceptación.
needDimensions boolean No Necesitamos las Dimensiones.
purchasePercentAvg number · double No El porcentaje de compra Avg.
purchasePercentMin number · double No Porcentaje de compra Min.
photoAvg integer · int32 No Foto de Avg.
photoMin integer · int32 No Foto Min.
drrAvg number · double No El Dr. Avg.
drrMin number · double No El Dr. Min.
marginAvg number · double No Margen Avg.
marginMin number · double No Margen Min.
candCCommission number · double No Canda C. Comisión.
[
  "string"
]
Errores7

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

400error_prepared_integration_not_found
integración preparada no encontrada

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

400error_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

400error_token_expired_or_revoked
El token API ha sido revocado o introducido incorrectamente. Verifica que la clave API tenga toda la funcionalidad. Genera una nueva clave y reemplázala en SELSUP, ya que las claves tienen un período de vida.

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

GET

Obtenga campañas de estadísticas totales

/api/campaign/getTotalStatCampaigns
Token con acceso a lectura

Obtenga las campañas de estadísticas totales utilizando GET /api/campaign/getTotalStatCampaigns.

Parámetros de consulta

CampoTipoObligatorioDescripción
organizationId integer · int64 No Identificación de la organización.
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 Servicio.
status string No Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Estatus de la campaña.
type integer · int32 No Type.
offset integer · int32 No - No lo puedo hacer.
dateTo string · date-time No La fecha para.
dateFrom string · date-time No La fecha de.
isStatCampaign boolean No Es la campaña de Estado.
dateStart string · date-time No La fecha de inicio.
query string No - ¿Qué quieres decir?
productExternalId integer · int64 No Identificación externa del producto.
organizationIds integer[] No Identificación de la organización.
limit integer · int32 No El límite.
page integer · int32 No Página.
count boolean No Conde.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS No Se ha ordenado.
ascending boolean No Ascendiendo.
topN integer · int32 En la parte superior N.
curl --request GET 'https://api.selsup.ru/api/campaign/getTotalStatCampaigns?service=NONE&limit=50&page=1&topN=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos CampaignTotalStats
CampoTipoObligatorioDescripción
clicks CampaignStat[] No - Clices.
Estructura de los elementos del array CampaignStat
CampoTipoObligatorioDescripción
campaign string No Campaña.
value number · double No El valor.
organizationId integer · int64 No Identificación de la organización.
organizationName string No Nombre de la organización.
views CampaignStat[] No Vistas.
Estructura de los elementos del array CampaignStat
CampoTipoObligatorioDescripción
campaign string No Campaña.
value number · double No El valor.
organizationId integer · int64 No Identificación de la organización.
organizationName string No Nombre de la organización.
expenses CampaignStat[] No ¿Qué es eso?
Estructura de los elementos del array CampaignStat
CampoTipoObligatorioDescripción
campaign string No Campaña.
value number · double No El valor.
organizationId integer · int64 No Identificación de la organización.
organizationName string No Nombre de la organización.
averageCost CampaignStat[] No El costo medio.
Estructura de los elementos del array CampaignStat
CampoTipoObligatorioDescripción
campaign string No Campaña.
value number · double No El valor.
organizationId integer · int64 No Identificación de la organización.
organizationName string No Nombre de la organización.
{
  "clicks": "string",
  "views": "string",
  "expenses": "string",
  "averageCost": "string"
}
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.

GET

Obtenga campañas de estadísticas

/api/campaign/getStatCampaigns
Token con acceso a lectura

Obtenga las campañas de estadísticas utilizando GET /api/campaign/getStatCampaigns.

Parámetros de consulta

CampoTipoObligatorioDescripción
organizationId integer · int64 No Identificación de la organización.
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 Servicio.
status string No Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Estatus de la campaña.
type integer · int32 No Type.
offset integer · int32 No - No lo puedo hacer.
dateTo string · date-time No La fecha para.
dateFrom string · date-time No La fecha de.
isStatCampaign boolean No Es la campaña de Estado.
dateStart string · date-time No La fecha de inicio.
query string No - ¿Qué quieres decir?
productExternalId integer · int64 No Identificación externa del producto.
organizationIds integer[] No Identificación de la organización.
limit integer · int32 No El límite.
page integer · int32 No Página.
count boolean No Conde.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS No Se ha ordenado.
ascending boolean No Ascendiendo.
curl --request GET 'https://api.selsup.ru/api/campaign/getStatCampaigns?service=NONE&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos FindResponseStatCampaign
CampoTipoObligatorioDescripción
rows StatCampaign[] No Las filas.
Estructura de los elementos del array StatCampaign
CampoTipoObligatorioDescripción
limit integer · int32 No El límite.
page integer · int32 No Página.
count boolean No Conde.
sortBy string No Se ha ordenado.
ascending boolean No Ascendiendo.
statCampaignId integer · int64 No Identificación de campaña de estado.
views integer · int32 No Vistas.
clicks integer · int32 No - Clices.
ratioClicksViews number · double No Ratio de Clices Vistas.
averageCost number · double No El costo medio.
expenses number · double No ¿Qué es eso?
quantityAddCart integer · int32 No Cuantidad de cartera de adición.
quantityOrders integer · int32 No Las órdenes de cantidad.
ratioOrdersOfVisits number · double No Ratio de órdenes de visitas.
quantityProductOrders integer · int32 No Los pedidos de productos en cantidad.
ordersAmount number · double No El número de pedidos.
campaignId integer · int64 No Identificación de campaña.
campaignName string No Nombre de campaña.
createDate string · date-time No Crear la fecha.
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.
campaignType stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN No Tipo de campaña.
categoryName string No Nombre de la categoría.
externalId integer · int64 No Identificación externa.
productId integer · int64 No Identificación del producto.
productViewId integer · int64 No Identificación de la vista del producto.
date string · date-time No - ¿Qué?
startDate string · date-time No La fecha de inicio.
endDate string · date-time No Fecha de fin.
importDate string · date-time No Fecha de importación.
uniqueId string No Identificación única.
clientId integer · int64 No Identificación del cliente.
organizationId integer · int64 No Identificación de la organización.
organizationName string No Nombre de la organización.
rowType stringCAMPAIGN, UNALLOCATED No Tipo de fila.
quantityBuyouts number · double No Compras de cantidad.
revenue number · double No Los ingresos.
profitFact number · double No El hecho de las ganancias.
marginFact number · double No El hecho de margen.
drr number · double No ¿Qué es eso?
cps number · double No - Sí, es el CPS.
quantityBuyoutsForecast number · double No Previsión de las compras de cantidad.
profitForecast number · double No Previsión de ganancias.
marginForecast number · double No Previsión de margen.
allowableExpenses number · double No Gastos permitidos.
currency string No El dinero.
unavailableReasons object No No hay razones disponibles.
{
  "rows": "string"
}
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.

GET

Obtenga campañas

/api/campaign/getCampaigns
Token con acceso a lectura

Obtenga campañas con GET /api/campaign/getCampaigns.

Parámetros de consulta

CampoTipoObligatorioDescripción
organizationId integer · int64 Identificación de la organización.
status string No Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Estatus de la campaña.
type integer · int32 No Type.
offset integer · int32 No - No lo puedo hacer.
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.
dateTo string · date-time No La fecha para.
dateFrom string · date-time No La fecha de.
isStatCampaign boolean No Es la campaña de Estado.
dateStart string · date-time No La fecha de inicio.
query string No - ¿Qué quieres decir?
productExternalId integer · int64 No Identificación externa del producto.
organizationIds integer[] No Identificación de la organización.
limit integer · int32 No El límite.
page integer · int32 No Página.
count boolean No Conde.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS No Se ha ordenado.
ascending boolean No Ascendiendo.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaigns?organizationId=1001&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos FindResponseCampaign
CampoTipoObligatorioDescripción
rows Campaign[] No Las filas.
Estructura de los elementos del array Campaign
CampoTipoObligatorioDescripción
id integer · int64 No Id.
externalId integer · int64 No Identificación externa.
name string No - ¿Cómo se llama?
campaignName string No Nombre de campaña.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN No Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Tipo de estado.
productId integer · int64 No Identificación del producto.
externalProductId integer · int64 No Identificación externa del producto.
createDate string · date-time No Crear la fecha.
endDate string · date-time No Fecha de fin.
startDate string · date-time No La fecha de inicio.
sum integer · int64 No - ¿Qué quieres decir?
writeOffType stringBALANCE, NET, BONUS No Escribir fuera de tipo.
onPause boolean No En Pausa.
clientId integer · int64 No Identificación del cliente.
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.
categoryId integer · int64 No Identificación de categoría.
categoryName string No Nombre de la categoría.
campaignType string No Tipo de campaña.
dateStatImport string · date-time No Datos de importación de datos.
nms string No - No. - ¿Qué quieres decir?
paymentType string No Tipo de pago.
{
  "rows": "string"
}
Errores4

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_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

Mantenga un equilibrio en la campaña

/api/campaign/getCampaignBalance
Token con acceso a lectura

Obtenga el balance de campaña usando GET /api/campaign/getCampaignBalance.

Parámetros de consulta

CampoTipoObligatorioDescripción
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 Servicio.
organizationId integer · int64 Identificación de la organización.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaignBalance?service=NONE&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos WbBalance
CampoTipoObligatorioDescripción
balance integer · int32 No El equilibrio.
net integer · int32 No La red.
bonus integer · int32 No - Sí, es un bono.
{
  "balance": 1,
  "net": 1,
  "bonus": 1
}
Errores7

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

400error_service_not_supported
Servicio no compatible

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

400error_subscription_expired
Su tarifa ha expirado. Pague la tarifa para continuar usando el servicio.

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

400error_token_expired_or_revoked
El token API ha sido revocado o introducido incorrectamente. Verifica que la clave API tenga toda la funcionalidad. Genera una nueva clave y reemplázala en SELSUP, ya que las claves tienen un período de vida.

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

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.