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.
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.
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
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
<url_base_wms>: Debe reemplazarse por el host y ambiente de Oracle WMS Cloud.
3. Headers
| Header | Descripción | Valor |
|---|---|---|
Content-Type | Indica que la información enviada en el cuerpo está en formato JSON. | application/json |
Authorization | Credenciales 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)
| Campo | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
shipment_nbr | String | Sí | Número de embarque de entrada al cual se asociará la recepción. | OGIP4 |
container_nbr | String | Sí | Identificador único del LPN o contenedor físico que se creará/recibirá. | 70499900000021 |
item_list | Array | Sí | Lista de artículos contenidos dentro del LPN. | [ ... ] |
4.2 Detalle de Artículos (item_list)
| Campo | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
item_barcode | String | Sí | Código de barras o clave del artículo a recibir en el LPN. | LEUP420 |
qty | Number | Sí | Cantidad de unidades físicas que se ingresan en el contenedor. | 1 |
batch_nbr | String | Opcional | Número de lote de producción asignado a las unidades. | GIP27F16M120-02-2026 |
expiry_date | String | Opcional | Fecha 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"
}
]
}'
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
}
}