Actualizar la cantidad real usada de un recurso de inventario

put

https://app.fracttal.com/api/wo_resources_real_qty_used/

Este servicio web permite ajustar la cantidad real usada (real_qty_used) de un recurso de inventario de una tarea de orden de trabajo, de forma independiente a la cantidad entregada. Funciona tanto para almacenes integrados como no integrados, siempre que el recurso ya tenga una entrega registrada y el nuevo valor sea menor o igual a la cantidad entregada.

Al aplicar el cambio, el costo total del recurso se recalcula como real_qty_used × costo unitario. La cantidad entregada, el costo unitario y el stock del almacén no se modifican.

Parámetros de entrada

Parámetro	Tipo	Requerido	Descripción
`code_warehouse`	texto	Sí	Código del almacén desde el cual se entregó el recurso.
`code_item`	texto	Sí	Código del ítem (repuesto o herramienta) asociado al recurso de la tarea.
`output_order`	texto	Sí	Folio de la orden de salida con la que se entregó el recurso en el almacén.
`real_qty_used`	número	Sí	Nueva cantidad real usada. Debe ser mayor o igual a `0` y menor o igual a la cantidad entregada. Admite decimales.

Reglas de uso

El recurso debe tener una entrega previa registrada (cantidad entregada mayor a 0).

El recurso se identifica por la combinación de code_warehouse, code_item y output_order.

En almacenes integrados con la opción de cantidades en cero por integración externa activa, el ajuste manual de la cantidad real usada no está permitido y la solicitud se rechaza con CHECK_WAREHOUSES_MODULE_CONFIGURATION. Esta validación tiene prioridad sobre la comparación contra la cantidad entregada.

Si dos solicitudes sobre el mismo recurso llegan casi al mismo tiempo, prevalece la última en procesarse.

El token debe tener permiso de edición sobre este servicio. De lo contrario, la API responde 401.

Parámetros de salida

Parámetro	Tipo	Descripción
`success`	booleano	`true` si la cantidad real usada se actualizó correctamente.
`message`	texto	Código de resultado. `200` si la operación fue exitosa.
`data`	array	`null` en caso de éxito. En caso de error, contiene un objeto con el campo `ERROR` que describe la causa.
`total`	entero	`1` si se actualizó el recurso. `0` en caso de error.

Errores

Código	Causa
`400`	`REAL_QTY_CANT_BE_MAJOR_THAN_DELIVERED_QTY`: `real_qty_used` es negativo o mayor a la cantidad entregada.
`400`	`CHECK_WAREHOUSES_MODULE_CONFIGURATION`: el almacén es integrado y tiene activa la opción de cantidades en cero por integración externa. Revise la configuración del módulo Almacenes.
`404`	Falta alguno de los campos obligatorios (`code_warehouse`, `code_item`, `output_order` o `real_qty_used`).
`404`	El almacén, el ítem o la orden de salida indicados no existen, o la combinación no corresponde a un recurso válido.
`404`	El recurso no tiene una entrega previa registrada.
`401`	Token inválido (`INVALID_TOKEN`) o sin permiso sobre el servicio (`UNAUTHORIZED_ENDPOINT`).

Nota sobre los códigos de error
Este servicio devuelve message: "404" cuando falta un campo obligatorio, cuando no se encuentra el almacén, el ítem o la orden de salida, y cuando el recurso no tiene una entrega previa. Las validaciones sobre el valor de real_qty_used y sobre la configuración del almacén devuelven message: "400".

Ejemplo

Request body

{
  "code_warehouse": "ALM-001",
  "code_item": "REP-0045",
  "output_order": "12",
  "real_qty_used": 7
}

Response `200`

{
  "success": true,
  "message": "200",
  "data": null,
  "total": 1
}

Response — Cantidad mayor a la entregada (`400`)

{
  "success": false,
  "message": "400",
  "data": [
    {
      "ERROR": "REAL_QTY_CANT_BE_MAJOR_THAN_DELIVERED_QTY"
    }
  ],
  "total": 0
}

Response — Almacén integrado con ajuste manual no permitido (`400`)

{
  "success": false,
  "message": "400",
  "data": [
    {
      "ERROR": "CHECK_WAREHOUSES_MODULE_CONFIGURATION"
    }
  ],
  "total": 0
}

Response — Recurso sin entrega previa (`404`)

{
  "success": false,
  "message": "404",
  "data": [
    {
      "ERROR": "A previous delivery (qty_delivered > 0) is required before adjusting real_qty_used"
    }
  ],
  "total": 0
}

Response — Campo obligatorio ausente (`404`)

{
  "success": false,
  "message": "404",
  "data": [
    {
      "ERROR": "output_order is required"
    }
  ],
  "total": 0
}

OpenAPI definition

{
  "openapi": "3.1.0",
  "info": {
    "title": "wo_resources_real_qty_used",
    "version": "1-Es"
  },
  "servers": [
    { "url": "https://app.fracttal.com/api/wo_resources_real_qty_used" }
  ],
  "security": [{}],
  "paths": {
    "/": {
      "put": {
        "summary": "Actualizar la cantidad real usada de un recurso de inventario",
        "description": "",
        "operationId": "actualizar-la-cantidad-real-usada-de-un-recurso-de-inventario",
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}

Language

Loading…