https://api.nexscope.ai/mp/ozon/sellerProductsEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/mp/ozon/sellerProducts |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
sellerId | string | obligatorio | ID del vendedor de Ozon (cadena numérica), consistente con el ID del vendedor en la lista de productos/lista de vendedores |
startDate | string | opcional | Fecha de inicio de las estadísticas `YYYY-MM-DD`; último ayer |
endDate | string | opcional | Fecha de finalización de las estadísticas `YYYY-MM-DD`; último ayer |
page | integer | opcional | Número de página, a partir de 1 |
pageSize | integer | opcional | Número de líneas por página, 1-100 Ejemplo: 100 |
sortField | string | opcional | Nombre de la columna de clasificación (snake_case), como por ejemplo `sales`, `revenue`, `final_price`, `balance`, `rating` |
sortDirection | string | opcional | `asc` / `desc` |
currency | string | opcional | Código de moneda, como `USD` Ejemplo: RUB |
currencyRate | integer | opcional | Tipo de cambio personalizado (con moneda no predeterminada) |
includeFbs | boolean | opcional | Indica si se deben incluir datos de FBS |
filters | array | opcional | Lista numérica de filtros, cada elemento es `{field, op, value, value2?}`, multicondición Y |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (42 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | Código de retorno, `"200"` éxito |
msg | string | opcional | Mensaje; el éxito es `ok` |
total | integer | opcional | Número total de visitas del vendedor |
products | array | opcional | Lista de productos |
columns | array | opcional | Definición de la columna de render |
costTime | integer | opcional | Tiempo de interfaz (millisegundos) |
costToken | integer | opcional | Cantidad de token consumido |
type | string | opcional | tipo de respuesta |
productId | integer | opcional | SKU ID |
title | string | opcional | Nombre del producto (ruso) |
brand | string | opcional | marca |
brandId | integer | opcional | ID de marca |
sellerName | string | opcional | Nombre del vendedor |
sellerId | integer | opcional | ID del vendedor |
category | string | opcional | Categoría ruta (ruso, `/` separados) |
nicheName | string | opcional | Ruta de pista (ruso) |
nicheId | integer | opcional | ID de pista |
country | string | opcional | País de venta, Ozon Hengwei `RU` |
firstDate | string | opcional | Fecha de lanzamiento (`yyyy-MM-dd`) |
imageUrl | string | opcional | Imagen principal URL |
productPageUrl | string | opcional | Página del producto URL |
price | number | opcional | Precio de venta actual |
oldPrice | number | opcional | Precio original antes del descuento |
ozonCardPrice | number | opcional | Precio de la tarjeta Ozon |
currency | string | opcional | Signatura de la moneda (`₽` / `$` / `€`) |
rating | number | opcional | Calificación, 0-5 |
reviewCount | integer | opcional | Número de comentarios |
balance | integer | opcional | Inventario actual (piezas) |
balanceFbs | integer | opcional | Inventario de FBS (número de artículos enviados por el vendedor) |
frozenStocks | integer | opcional | Inventario de movimientos lentos |
warehousesCount | integer | opcional | Número de posiciones de FBO |
isFbs | boolean | opcional | Si se debe enviar por FBS |
salesPerDay | number | opcional | Volumen medio de ventas diarias (piezas/día) |
monthlySalesUnits | integer | opcional | Volumen de ventas durante el período estadístico (piezas) |
monthlySalesRevenue | number | opcional | Ventas durante el período estadístico |
lostProfit | number | opcional | Ventas perdidas (causadas por existencias, etc.) |
daysInSite | integer | opcional | Número de días de venta (período estadístico, incluidos los días de venta) |
daysInStock | integer | opcional | días en stock |
turnoverDays | number | opcional | Días de vuelta (el más pequeño, el más rápido) |
position | integer | opcional | Ranking dentro de la dimensión de consulta actual (este punto final es el vendedor) |
categoryPosition | integer | opcional | Clasificación dentro de la categoría |
revenueSharePercent | number | opcional | La relación de ventas de este SKU en la dimensión actual de la consulta, 0-100 |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.