Skip to main content

Recepción y Creación de LPN's

Oracle Warehouse Management Cloud (LogFire) permite registrar y recibir unidades de carga de entrada (Inbound LPNs) dentro de un embarque específico de forma transaccional mediante una petición POST al endpoint de acción /entity/iblpn/receive.

Esta opción puede utilizarse para:

  • Crear e ingresar LPNs (contenedores/tarimas) al inventario en el proceso de recepción de almacén.
  • Asociar códigos de barras de artículos (item_barcode), cantidades y números de lote (batch_nbr) a un contenedor físico específico.
  • Asignar fechas de caducidad (expiry_date) de manera directa al lote y al contenedor recibido.
info

Este proceso se utiliza para la recepción y registro directo (POST) de contenedores de entrada (iblpn) dentro de la estructura transaccional de Oracle WMS Cloud.

Documentación Oficial de Oracle

Para comprender las acciones y parámetros del recurso Inbound LPN en Oracle WMS REST API, puedes consultar la guía oficial de Oracle Cloud: https://docs.oracle.com/en/cloud/saas/warehouse-management/26b/owmre/receive-inbound-lpn.html

Requisito de autorización y seguridad

Para realizar recepciones de contenedores sobre Oracle WMS Cloud, el usuario de la integración requiere permisos de ejecución sobre los servicios de recepción de LogFire (como el rol de integración de servicios web ocswebservice o similar con permisos de recepción y actualización de inventario).

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


1. Flujo​


2. API​

Método: POST

URL: <url_base_wms>/wms/lgfapi/v10/entity/iblpn/receive

Parámetros de Endpoint
  • <url_base_wms>: Debe reemplazarse por el host y ambiente de Oracle WMS Cloud.

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)​

Al tratarse de una petición de tipo POST, se envía un cuerpo de datos (body) en JSON que contiene los datos de cabecera del embarque y contenedor, junto con la lista de artículos y detalles de lote a ingresar.


4.1 Datos Principales del Contenedor (JSON Body)​

CampoTipoRequeridoDescripciónEjemplo
shipment_nbrStringSíNúmero de embarque de entrada al cual se asociará la recepción.OGIP4
container_nbrStringSíIdentificador único del LPN o contenedor físico que se creará/recibirá.70499900000021
item_listArraySíLista de artículos contenidos dentro del LPN.[ ... ]

4.2 Detalle de Artículos (item_list)​

CampoTipoRequeridoDescripciónEjemplo
item_barcodeStringSíCódigo de barras o clave del artículo a recibir en el LPN.LEUP420
qtyNumberSíCantidad de unidades físicas que se ingresan en el contenedor.1
batch_nbrStringOpcionalNúmero de lote de producción asignado a las unidades.GIP27F16M120-02-2026
expiry_dateStringOpcionalFecha de caducidad del producto (Formato YYYY-MM-DD).2026-02-20

5. Ejemplo de Solicitud​

A continuación se muestra el ejemplo de consumo mediante cURL para realizar la recepción del contenedor 70499900000021 asociado al embarque OGIP4:

curl --location 'https://te6.wms.ocs.oraclecloud.com:443/alpura_test/wms/lgfapi/v10/entity/iblpn/receive' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic YWxwd2Vic2VydmljZTpBbHB1cmEwMQ==' \
--data '{
"shipment_nbr": "OGIP4",
"container_nbr": "70499900000021",
"item_list": [
{
"item_barcode": "LEUP420",
"qty": 1,
"batch_nbr": "GIP27F16M120-02-2026",
"expiry_date": "2026-02-20"
}
]
}'
Nota:

Antes de ejecutar el comando curl, se debe reemplazar el valor <url_oracle> por el host de la instancia de Oracle Cloud deseada (DEV, UAT o PROD), según el ambiente en el que se requiera realizar la operación.

Verifique que la URL corresponda al ambiente correcto y que las credenciales utilizadas en el encabezado Authorization tengan los permisos necesarios para crear o actualizar valores en el juego de valores ALP_AREAS.


6. Ejemplo de Respuesta​

{
"success": true,
"response": {
"message": "Contenedor recibido exitosamente.",
"container_nbr": "70499900000021",
"shipment_nbr": "OGIP4",
"status": "Received",
"received_items_count": 1
}
}