SelSup Developers

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

Calculador

Puntos finales para la calculadora, incluidas las rutas exactas, los parámetros, los organismos de solicitud y los esquemas de respuesta expandibles.

2 puntos finales/api/calculatorEstablesDescripció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/calculator

Flujos de trabajo listos para su uso

Flujos de trabajo listos para su uso

01

Comience con la calculadora

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.

UnitCalculator31 campos
purchasePricenumber · double

Precio de compra.

purchasePercentnumber · double

El porcentaje de compra.

widthinteger · int32

La anchura.

heightinteger · int32

- La altura.

depthinteger · int32

La profundidad.

categoryIdinteger · int64

Identificación de categoría.

servicestring

Servicio.

salePricenumber · double

Precio de venta.

commissionnumber · double

El Parlamento Europeo.

wildberriesFbsBaseCommissionnumber · double

La Comisión de Base de la FBS de Wildberries.

wildberriesFbsPlannedTransferHoursnumber · double

Wildberries FBS planeó horas de traslado.

wildberriesFbsTransferNormHoursnumber · double

Wildberries Fbs traslada horas normales.

wildberriesFbsSpeedCoefficientnumber · double

Coeficiente de velocidad de Fbs de Wildberries.

wildberriesFbsEffectiveCommissionnumber · double

La Comisión efectiva de Wildberries Fbs.

wildberriesFbsTransferHoursSourcestring

Wildberries Fbs traslada horas Fuente.

wildberriesFbsSpeedCoefficientValidFromstring · date

El coeficiente de velocidad de Wildberries Fbs es válido.

wildberriesFbsSpeedCoefficientSourcestring

Wildberries Fbs Fuente del coeficiente de velocidad.

logisticnumber · double

Logística.

warehouseRationumber · double

Ratio de almacén.

logisticRationumber · double

Ratio logístico.

ktrnumber · double

¿Qué pasa?

expensesnumber · double

¿Qué es eso?

newPriceByRubnumber · double

Nuevo precio por rub.

newPriceByMarginalitynumber · double

Nuevo precio por margen.

desiredMarginPercentnumber · double

El porcentaje de margen deseado.

desiredProfitRubnumber · double

El beneficio deseado.

profitnumber · double

- Las ganancias.

markUpnumber · double

Marca hacia arriba.

marginalitynumber · double

La marginalidad.

organizationIdinteger · int64

Identificación de la organización.

taxRatenumber · double

Taxa de impuestos.

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

GET

Los beneficios

/api/calculator/profit
Token con acceso a lectura

Profitos con GET /api/calculator/profit.

Parámetros de consulta

CampoTipoObligatorioDescripción
purchasePrice number · double No Precio de compra.
purchasePercent number · double No El porcentaje de compra.
width integer · int32 No La anchura.
height integer · int32 No - La altura.
depth integer · int32 No La profundidad.
categoryId integer · int64 No Identificación de categoría.
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.
salePrice number · double No Precio de venta.
commission number · double No El Parlamento Europeo.
wildberriesFbsBaseCommission number · double No La Comisión de Base de la FBS de Wildberries.
wildberriesFbsPlannedTransferHours number · double No Wildberries FBS planeó horas de traslado.
wildberriesFbsTransferNormHours number · double No Wildberries Fbs traslada horas normales.
wildberriesFbsSpeedCoefficient number · double No Coeficiente de velocidad de Fbs de Wildberries.
wildberriesFbsEffectiveCommission number · double No La Comisión efectiva de Wildberries Fbs.
wildberriesFbsTransferHoursSource string No Wildberries Fbs traslada horas Fuente.
wildberriesFbsSpeedCoefficientValidFrom string · date No El coeficiente de velocidad de Wildberries Fbs es válido.
wildberriesFbsSpeedCoefficientSource string No Wildberries Fbs Fuente del coeficiente de velocidad.
logistic number · double No Logística.
warehouseRatio number · double No Ratio de almacén.
logisticRatio number · double No Ratio logístico.
ktr number · double No ¿Qué pasa?
expenses number · double No ¿Qué es eso?
newPriceByRub number · double No Nuevo precio por rub.
newPriceByMarginality number · double No Nuevo precio por margen.
desiredMarginPercent number · double No El porcentaje de margen deseado.
desiredProfitRub number · double No El beneficio deseado.
profit number · double No - Las ganancias.
markUp number · double No Marca hacia arriba.
marginality number · double No La marginalidad.
organizationId integer · int64 No Identificación de la organización.
taxRate number · double No Taxa de impuestos.
curl --request GET 'https://api.selsup.ru/api/calculator/profit' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos UnitCalculator
CampoTipoObligatorioDescripción
purchasePrice number · double No Precio de compra.
purchasePercent number · double No El porcentaje de compra.
width integer · int32 No La anchura.
height integer · int32 No - La altura.
depth integer · int32 No La profundidad.
categoryId integer · int64 No Identificación de categoría.
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.
salePrice number · double No Precio de venta.
commission number · double No El Parlamento Europeo.
wildberriesFbsBaseCommission number · double No La Comisión de Base de la FBS de Wildberries.
wildberriesFbsPlannedTransferHours number · double No Wildberries FBS planeó horas de traslado.
wildberriesFbsTransferNormHours number · double No Wildberries Fbs traslada horas normales.
wildberriesFbsSpeedCoefficient number · double No Coeficiente de velocidad de Fbs de Wildberries.
wildberriesFbsEffectiveCommission number · double No La Comisión efectiva de Wildberries Fbs.
wildberriesFbsTransferHoursSource string No Wildberries Fbs traslada horas Fuente.
wildberriesFbsSpeedCoefficientValidFrom string · date No El coeficiente de velocidad de Wildberries Fbs es válido.
wildberriesFbsSpeedCoefficientSource string No Wildberries Fbs Fuente del coeficiente de velocidad.
logistic number · double No Logística.
warehouseRatio number · double No Ratio de almacén.
logisticRatio number · double No Ratio logístico.
ktr number · double No ¿Qué pasa?
expenses number · double No ¿Qué es eso?
newPriceByRub number · double No Nuevo precio por rub.
newPriceByMarginality number · double No Nuevo precio por margen.
desiredMarginPercent number · double No El porcentaje de margen deseado.
desiredProfitRub number · double No El beneficio deseado.
profit number · double No - Las ganancias.
markUp number · double No Marca hacia arriba.
marginality number · double No La marginalidad.
organizationId integer · int64 No Identificación de la organización.
taxRate number · double No Taxa de impuestos.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Errores12

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_category_not_found
Categoría no encontrada

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

400error_depth_not_found
No se ha especificado la profundidad

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

400error_height_not_found
No se ha especificado la altura

error específico de punto final. Utilice el código estable error_height_not_found 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.

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_purchase_percent_not_found
No se ha especificado el porcentaje de compra

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

400error_sale_price_not_found
Precio de venta no especificado

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

400error_service_not_found
No se ha seleccionado marketplace

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

400error_width_not_found
No se ha especificado el ancho

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

GET

Precio

/api/calculator/price
Token con acceso a lectura

Precio con GET /api/calculator/price.

Parámetros de consulta

CampoTipoObligatorioDescripción
purchasePrice number · double No Precio de compra.
purchasePercent number · double No El porcentaje de compra.
width integer · int32 No La anchura.
height integer · int32 No - La altura.
depth integer · int32 No La profundidad.
categoryId integer · int64 No Identificación de categoría.
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.
salePrice number · double No Precio de venta.
commission number · double No El Parlamento Europeo.
wildberriesFbsBaseCommission number · double No La Comisión de Base de la FBS de Wildberries.
wildberriesFbsPlannedTransferHours number · double No Wildberries FBS planeó horas de traslado.
wildberriesFbsTransferNormHours number · double No Wildberries Fbs traslada horas normales.
wildberriesFbsSpeedCoefficient number · double No Coeficiente de velocidad de Fbs de Wildberries.
wildberriesFbsEffectiveCommission number · double No La Comisión efectiva de Wildberries Fbs.
wildberriesFbsTransferHoursSource string No Wildberries Fbs traslada horas Fuente.
wildberriesFbsSpeedCoefficientValidFrom string · date No El coeficiente de velocidad de Wildberries Fbs es válido.
wildberriesFbsSpeedCoefficientSource string No Wildberries Fbs Fuente del coeficiente de velocidad.
logistic number · double No Logística.
warehouseRatio number · double No Ratio de almacén.
logisticRatio number · double No Ratio logístico.
ktr number · double No ¿Qué pasa?
expenses number · double No ¿Qué es eso?
newPriceByRub number · double No Nuevo precio por rub.
newPriceByMarginality number · double No Nuevo precio por margen.
desiredMarginPercent number · double No El porcentaje de margen deseado.
desiredProfitRub number · double No El beneficio deseado.
profit number · double No - Las ganancias.
markUp number · double No Marca hacia arriba.
marginality number · double No La marginalidad.
organizationId integer · int64 No Identificación de la organización.
taxRate number · double No Taxa de impuestos.
curl --request GET 'https://api.selsup.ru/api/calculator/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Campos de objetos UnitCalculator
CampoTipoObligatorioDescripción
purchasePrice number · double No Precio de compra.
purchasePercent number · double No El porcentaje de compra.
width integer · int32 No La anchura.
height integer · int32 No - La altura.
depth integer · int32 No La profundidad.
categoryId integer · int64 No Identificación de categoría.
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.
salePrice number · double No Precio de venta.
commission number · double No El Parlamento Europeo.
wildberriesFbsBaseCommission number · double No La Comisión de Base de la FBS de Wildberries.
wildberriesFbsPlannedTransferHours number · double No Wildberries FBS planeó horas de traslado.
wildberriesFbsTransferNormHours number · double No Wildberries Fbs traslada horas normales.
wildberriesFbsSpeedCoefficient number · double No Coeficiente de velocidad de Fbs de Wildberries.
wildberriesFbsEffectiveCommission number · double No La Comisión efectiva de Wildberries Fbs.
wildberriesFbsTransferHoursSource string No Wildberries Fbs traslada horas Fuente.
wildberriesFbsSpeedCoefficientValidFrom string · date No El coeficiente de velocidad de Wildberries Fbs es válido.
wildberriesFbsSpeedCoefficientSource string No Wildberries Fbs Fuente del coeficiente de velocidad.
logistic number · double No Logística.
warehouseRatio number · double No Ratio de almacén.
logisticRatio number · double No Ratio logístico.
ktr number · double No ¿Qué pasa?
expenses number · double No ¿Qué es eso?
newPriceByRub number · double No Nuevo precio por rub.
newPriceByMarginality number · double No Nuevo precio por margen.
desiredMarginPercent number · double No El porcentaje de margen deseado.
desiredProfitRub number · double No El beneficio deseado.
profit number · double No - Las ganancias.
markUp number · double No Marca hacia arriba.
marginality number · double No La marginalidad.
organizationId integer · int64 No Identificación de la organización.
taxRate number · double No Taxa de impuestos.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Errores12

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_category_not_found
Categoría no encontrada

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

400error_depth_not_found
No se ha especificado la profundidad

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

400error_fill_purchase_price
No hay precio de compra

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

400error_height_not_found
No se ha especificado la altura

error específico de punto final. Utilice el código estable error_height_not_found 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.

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_purchase_percent_not_found
No se ha especificado el porcentaje de compra

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

400error_service_not_found
No se ha seleccionado marketplace

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

400error_width_not_found
No se ha especificado el ancho

error específico de punto final. Utilice el código estable error_width_not_found 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.