SelSup Developers

Flujo de trabajo de extremo a extremo · Guías

Inventario y almacenes

El modelo SKU, las lecturas de stock de almacén, las actualizaciones por SelSup o identificadores externos, y la reconciliación segura.

5 seccionesGuía para desarrolladores
→

El inventario se encuentra a nivel de SKU y de almacén.

Integrar el sistema de gestión de sistemas de gestión y gestión de almacenes

01

Comprender las entidades de inventario

El SKU es la unidad de inventario. Un producto final o tamaño se vincula a un SKU, mientras que el stock de SKU se coloca en un almacén o una celda.

cantidad es la cantidad almacenada, calculadaCuantidad puede incluir cálculos internos y disponibleCuantity es el stock disponible resultante.

SelSup admite inventario basado en cantidad y rastreado individualmente. No combine ambos modelos de contabilidad en un solo flujo de actualización.

Puntos finales API relacionados

GET/api/product/findSe lee en un productoGET/api/warehouse/listLos almacenes de la lista

02

Leer el stock de almacenamiento

Para una reconciliación completa, cargue el stock por almacén, el almaceno, la célula, el tiempo de modificación y cada campo de cantidad utilizado por su cálculo.

Una exportación completa puede ser grande.Usala para la carga inicial y la reconciliación programada en lugar de analizarla después de cada cambio.

Un almacén · cURL
curl 'https://api.selsup.ru/api/wms/stock/all?warehouseId=10129' \
  --header 'Authorization: YOUR_API_TOKEN'

Puntos finales API relacionados

GET/api/wms/stock/allCarga todo el stock del almacénGET/api/wms/stock/findEstancia de búsqueda

03

Actualización utilizando las entidades SelSup

Utilice el skuld de la búsqueda de productos y el identificador de mapas de almacén requerido por el contrato vigente.

actualizaciónInService=false separa la escritura de stock SelSup de la propagación sincrónica del mercado. Cuando se requieren actualizaciones del mercado, maneje la duración y los fallos parciales de forma independiente.

Aplicar una regla consistente en toda la integración para que los diferentes flujos no sobreescriban las existencias con diferentes semánticas.

Batch de actualización · JSON
[
  {
    "stock": 5,
    "serviceWarehouseId": "1234",
    "updateInService": false,
    "withReservedStock": true,
    "skuId": 1044318
  }
]

Puntos finales API relacionados

PUT/api/wms/stockActualización de skuId

04

Actualización por artículo o código de barras

Con la ruta del servicio, SelSup resuelve un producto mapeado por el identificador de servicio o código de barras seleccionado.

No envíe un código de barras y varios identificadores externos juntos sin una prioridad definida.

Actualización del código de barras · JSON
[
  {
    "stock": 5,
    "barcode": "4601234567890",
    "serviceWarehouseId": "OZON-WH-01",
    "updateInService": false,
    "withReservedStock": true
  }
]

Puntos finales API relacionados

PUT/api/wms/stock/{service}Actualización por identificador de servicioGET/api/warehouse/serviceServicios de mapas de almacenes

05

Reconciliación y prevención de la raza

  1. 1

    Propiedad de acciones asignadas

    Decide qué sistema es la fuente de la verdad y qué eventos pueden cambiar el inventario de SelSup.

  2. 2

    Serializa las actualizaciones de SKU

    No envíe valores simultáneos para el mismo skuId y almacén; coda por SKU+almacén.

  3. 3

    Verificar después de un lote

    Lea de nuevo las SKU modificadas y compare el valor esperado con la cantidad disponible utilizando su fórmula de reserva.

  4. 4

    Se aislan errores de mapeo

    Un escudo desconocido, almacén o código de barras ambiguo necesita corrección del diccionario en lugar de un intento infinito.