Skip to main content

Catálogo, niveles de stock y consumo en órdenes de trabajo

Lee partes, tipos de equipo, proveedores, ubicaciones de stock, inventario por ubicación y las partes consumidas en órdenes de trabajo con la Internal Teams API.
Alrededor del flujo de compras se sitúan los datos de referencia y de stock: qué puedes pedir (partes, tipos de equipo), a quién le pides (proveedores), dónde vive (ubicaciones de stock e inventario por ubicación) y a dónde fue (consumo en órdenes de trabajo). Todo eso es de solo lectura a través de la Internal Teams API. Todos los ejemplos asumen:
Cada listado a continuación soporta los parámetros de paginación más filtros de igualdad sobre columnas de la entidad (cualquier otro parámetro de consulta, por ejemplo stockLocationId=42), siempre limitados a tu empresa.
Sincroniza estos hacia tu sistema de compras primero; cualquier otra llamada referencia sus ids.

Ubicaciones de stock e inventario

Las ubicaciones de stock son los almacenes, camiones y bodegas que guardan inventario:
Dos tipos de registro expresan qué se guarda dónde: Partes por ubicación de stock (GET /v1/partners/inventory/parts_per_stock_locations, +/{id}) es un registro por parte por ubicación: cantidades en mano, reservadas y disponibles, ubicación de bin y costos.
Equipo por ubicación de stock (GET /v1/partners/inventory/equipment_per_stock_locations, +/{id}) es un registro por unidad física serializada: número de serie, condición y procedencia. Estas son las unidades que crean los recibos con números de serie. Los recibos son la ruta de escritura al stock por esta API; el lado de lectura aquí es cómo concilias el stock de OpenWrench contra tu ERP.

Partes y equipo usados en órdenes de trabajo

GET /v1/partners/work_order/work_order_parts_equipments/{workOrderId} lista los registros de partes y equipo consumidos en una orden de trabajo: el lado de consumo del libro de inventario.
Los resultados son paginados y aceptan los mismos filtros de igualdad. Para claves de partner cuya empresa proveedora no es una empresa de técnicos internos, los objetos workOrder y location embebidos vuelven enmascarados, con los campos sensibles eliminados.

Patrón de conciliación

Una conciliación nocturna de inventario:
  1. Extrae parts_per_stock_locations por ubicación de stock y compara las cantidades contra tu ERP.
  2. Explica los deltas: recibos registrados ese día (entrada de compras) menos work_order_parts_equipments de órdenes de trabajo completadas ese día (salida de consumo).
  3. Investiga lo que queda: usualmente un recibo perdido, una devolución no registrada (recibo negativo) o consumo registrado contra la orden de trabajo equivocada.