SelSup Developers

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

Configuración

Puntos finales para Configuraciones, incluidas rutas exactas, parámetros, cuerpos de solicitud y esquemas de respuesta expandibles.

Puntos finales: 3/api/propertyEstablesDescripció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/property

Flujos de trabajo listos para su uso

Flujos de trabajo listos para su uso

01

Comience con Configuraciones

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.

Property6 campos
organizationIdinteger · int64

Identificación de la organización.

clientIdinteger · int64

Identificación del cliente.

read-only
componentstring

Componente.

namestring

- ¿Cómo se llama?

valuestring

El valor.

valueNamestring

Nombre de valor.

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

PUT

Ponga en posesión

/api/property/
Token con acceso a escribir

Colocar Propiedad usando PUT /api/property/.

Organismo de solicitud

application/json
Campos de objetosProperty
CampoTipoObligatorioDescripción
organizationId integer · int64 No Identificación de la organización.
clientId integer · int64 No Identificación del cliente.
component string No Componente.
name string No - ¿Cómo se llama?
value string No El valor.
valueName string No Nombre de valor.
curl --request PUT 'https://api.selsup.ru/api/property/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "organizationId": 1001,
  "clientId": 1001,
  "component": "string",
  "name": "Example",
  "value": "string",
  "valueName": "Example"
}'

Respuesta exitosa

200

La respuesta no tiene cuerpo.

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_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

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

400error_invalid_currency_source
La fuente de tipo de cambio especificada no es compatible

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

400error_invalid_stock_distribution_rules
Reglas de reparto de existencias no válidas: revise las proporciones de 0 a 1 y los límites.

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

¡Vamos!

/api/property/{organizationId}/{component}
Token con acceso a lectura

Obtenga el uso de GET /api/property/{organizationId}/{component}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
organizationId integer · int64 Sí Identificación de la organización.
component string Sí Componente.
curl --request GET 'https://api.selsup.ru/api/property/1001/string' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
"string"
Errores32

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_base_creating
Su panel está en proceso de creación, espere unos minutos hasta que se complete la creación del panel

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

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

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

400error_cant_receive_stocks
no se pudieron obtener los inventarios

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

400error_client_branding_failed
No se pudo cargar o guardar la configuración de marca.

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

400error_fbs_marking_code_unsupported
Código de marcado Fbs no soportado

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

400error_fulfillment_client_access_denied
Fulfillment client access denied

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

400error_fulfillment_client_contract_required
Acepta el contrato para acceder a las operaciones.

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

400error_fulfillment_request_invalid
Invalidez de la solicitud de cumplimiento

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

400error_header_logo_upload_failed
Could not upload the logo. Please try again.

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

400error_income_not_found
No se encontró el pedido del proveedor nº{id}

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

400error_integration_cell_mapping_invalid
Mapa de células de integración inválido

error específico de punto final. Utilice el código estable error_integration_cell_mapping_invalid 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_no_price_for_order_product
No se especificó el precio para el producto: {name}

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

400error_no_quantity_for_order_product
No se ha especificado la cantidad del producto: {name}

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

400error_order_not_found
Pedido no encontrado

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

400error_organization_create_failed
Ocurrió un problema al crear la organización. Por favor, contacte al soporte

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

400error_organization_exists
La organización ya está creada

error específico de punto final. Utilice el código estable error_organization_exists 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_ozon_fbo_workflow_not_found
No se encontró el flujo Ozon FBO {id}

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

400error_reload
La sesión de autorización ha expirado, actualice la página del navegador. Si la actualización no ayuda, intente eliminar las cookies del sitio

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

400error_settlement_invalid
Invalidez del acuerdo

error específico de punto final. Utilice el código estable error_settlement_invalid 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_supply_not_found
Envío no encontrado: {name}

error específico de punto final. Utilice el código estable error_supply_not_found 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_transport_waybill_invalid
Revise los datos de la carta de porte.

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

400error_transport_waybill_source
La carta de porte no está disponible para este envío o suministro.

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

400error_warehouse_not_found
Almacén no encontrado

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

400error_warehouse_setup_unavailable
Instalación de almacén no disponible

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

GET

Lista de los productos

/api/property/list/{component}
Token con acceso a lectura

Lista con GET /api/property/list/{component}.

Parámetros de trayectoria

CampoTipoObligatorioDescripción
component string Sí Componente.

Parámetros de consulta

CampoTipoObligatorioDescripción
organizationId integer · int64 No Identificación de la organización.
curl --request GET 'https://api.selsup.ru/api/property/list/string' \
  --header 'Authorization: YOUR_API_TOKEN'

Respuesta exitosa

200
Estructura de los elementos del array Property[]
CampoTipoObligatorioDescripción
organizationId integer · int64 No Identificación de la organización.
clientId integer · int64 No Identificación del cliente.
component string No Componente.
name string No - ¿Cómo se llama?
value string No El valor.
valueName string No Nombre de valor.
[
  "string"
]
Errores34

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_bad_request
Formato de solicitud incorrecto

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

400error_base_creating
Su panel está en proceso de creación, espere unos minutos hasta que se complete la creación del panel

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

400error_cabinet_access_denied
No tiene acceso a este espacio de trabajo.

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

400error_cant_extract_tariffs
No se pueden obtener las tarifas. Escriba al soporte

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

400error_container_log_read_failed
Fallo de lectura del registro del contenedor

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

400error_container_log_request_invalid
Invalida solicitud de registro de contenedores

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

400error_empty_first_name
Nombre no especificado

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

400error_empty_last_name
No se especificó el apellido

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

400error_empty_organization_form
forma de organización no especificada

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

400error_empty_organization_inn
No se ha especificado INN de la organización

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

400error_empty_organization_name
No se especificó el nombre de la organización

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

400error_empty_position_name
No se ha especificado el nombre del puesto

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

400error_fulfillment_client_access_denied
Fulfillment client access denied

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

400error_fulfillment_client_contract_required
Acepta el contrato para acceder a las operaciones.

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

400error_fulfillment_document_error
No se pudo generar el documento. Revise los parámetros y el contenido de la operación.

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

400error_fulfillment_request_invalid
Invalidez de la solicitud de cumplimiento

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

400error_income_not_found
No se encontró el pedido del proveedor nº{id}

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

400error_max_page
El número de página no puede ser mayor a 100,000

error específico de punto final. Utilice el código estable error_max_page 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_no_price_for_order_product
No se especificó el precio para el producto: {name}

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

400error_no_quantity_for_order_product
No se ha especificado la cantidad del producto: {name}

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

400error_order_not_found
Pedido no encontrado

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

400error_organization_create_failed
Ocurrió un problema al crear la organización. Por favor, contacte al soporte

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

400error_organization_exists
La organización ya está creada

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

400error_position_exists
Ya existe un puesto con ese nombre

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

400error_reload
La sesión de autorización ha expirado, actualice la página del navegador. Si la actualización no ayuda, intente eliminar las cookies del sitio

error específico de punto final. Utilice el código estable error_reload 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_warehouse_not_found
Almacén no encontrado

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

400error_wrong_crm_token
token del CRM incorrecto

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

400error_wrong_inn
INN de la organización especificado incorrectamente, longitud de 10 o 12 dígitos

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

400error_wrong_version
Versión especificada incorrectamente

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

Authorization

Token para las solicitudes de ensayo

Obtener un token

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.