Skip to main content

Devolución de LPN's

Oracle Warehouse Management Cloud (LogFire) permite realizar la baja o el consumo directo del inventario asociado a un contenedor de entrada (Inbound LPN) mediante una petición POST al endpoint de acción /entity/iblpn/<id>/direct_consume/.

Esta opción puede utilizarse para:

  • Registrar la merma, pérdida o desecho de inventario contenido dentro de un LPN de forma inmediata.
  • Registrar consumos rápidos de materia prima o producto terminado sin necesidad de tareas de picking complejas.
  • Ajustar diferencias físicas detectadas durante auditorías de inventario asignando un código de razón específico.
info

Este proceso se utiliza para el salida definitiva del inventario (POST) de un contenedor existente en la estructura de Oracle WMS Cloud.

Documentación Oficial de Oracle

Para comprender las políticas de ajuste y las acciones sobre contenedores en la API REST de LogFire, puedes consultar la guía oficial de Oracle Cloud: https://docs.oracle.com/en/cloud/saas/warehouse-management/26b/owmre/consume-inbound-lpn.html

Requisito de autorización y seguridad

Para realizar transacciones de consumo directo sobre contenedores, el usuario de la integración requiere permisos de edición de inventario y registro de mermas en LogFire (como el rol de integración de servicios web ocswebservice o perfiles autorizados para realizar ajustes de inventario).

De lo contrario, la API responderá con un error de autorización 401 Unauthorized o 403 Forbidden.


1. Flujo​


2. API​

Método: POST

URL: <url_wms>/wms/lgfapi/v10/entity/iblpn/<id>/direct_consume/

Parámetros de Endpoint y Operación
  • <url_wms>: Debe reemplazarse por el host y ambiente de Oracle WMS Cloud (ej. https://te6.wms.ocs.oraclecloud.com:443/alpura_test para pruebas o el dominio correspondiente a producción).
  • <id>: Identificador numérico interno único en el sistema para el LPN (iblpn) que se desea consumir directamente del inventario (ej. 83421).

3. Headers​

HeaderDescripciónValor
Content-TypeIndica que la información enviada en el cuerpo está en formato JSON.application/json
AuthorizationCredenciales de autenticación HTTP Basic para Oracle WMS Cloud.Basic <usuario:contraseña>

4. Columnas de entrada (Request)​

La solicitud se envía con el método POST enviando el ID del LPN en la ruta (path) y un cuerpo JSON con las reglas operativas para la baja del inventario:

  • options: Contiene la justificación de negocio (código de razón) y parámetros de control de tiempo del contenedor.

4.1 Parámetros de Ruta (Obligatorios)​

ParámetroTipoDescripciónEjemplo
idNumber (Path)ID interno único generado por Oracle para el LPN que se dará de baja.83421

4.2 Opciones de Consumo Directo (options)​

CampoTipoRequeridoDescripciónEjemplo
reason_codeStringSíCódigo de razón registrado en WMS que justifica la salida o merma del contenedor (ej. REV para revisión o merma).REV
num_days_iblpn_lost_for_consumeIntegerSíNúmero de días que el LPN puede haber estado en estatus de perdido antes de ser elegible para el consumo directo.0

5. Ejemplo de Solicitud​

A continuación se muestra el ejemplo de consumo mediante cURL para realizar la baja directa del LPN con ID interno 83421:

curl --location 'https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/iblpn/83421/direct_consume/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic YWxwd2Vic2VydmljZTpBbHB1cmEwMQ==' \
--data '{
"options": {
"reason_code": "REV",
"num_days_iblpn_lost_for_consume": 0
}
}'
Nota:

Antes de ejecutar el comando curl, verifique que: El identificador del contenedor (83421) exista en el ambiente de alpura_test y se encuentre en un estado físico que permita su consumo directo (ej. no debe estar ya consumido, embarcado o bloqueado de forma restrictiva).

El código de razón (reason_code: "REV") esté previamente dado de alta y activo en el catálogo de códigos de razón de tu instancia de WMS.

El parámetro num_days_iblpn_lost_for_consume en 0 indica que no se requiere validación de días transcurridos para proceder con la transacción de baja inmediata.


6. Ejemplo de Respuesta​

6.1 Respuesta Exitosa (200 OK)​

{
"success": true,
"response": {
"message": "Consumo directo del contenedor realizado con éxito.",
"iblpn_id": 83421,
"reason_code": "REV",
"status": "Consumed"
}
}

6.2 Respuesta con Error (400 Bad Request / 404 Not Found)​

Si el LPN ya no cuenta con inventario disponible o el código de razón no es válido:

{
"success": false,
"response": {
"message": "Falló el consumo directo del contenedor.",
"errors": [
{
"key": "reason_code",
"msg": "El código de razón 'REV' no está parametrizado en la instalación."
}
]
}
}