Consulta de OTs
Oracle Fusion Cloud Manufacturing permite consultar una Orden de Trabajo de Proceso previamente generada junto con sus campos personalizados (DFF), utilizando parámetros de proyección y optimización.
Esta opción puede utilizarse para:
- Verificar que la Orden de Trabajo de Proceso fue generada correctamente.
- Consultar la información de la cabecera de la Orden de Trabajo (fechas, producto principal, lote y cantidades).
- Revisar y extraer los campos descriptivos personalizados (DFF) asociados a la Orden de Trabajo.
- Validar la información registrada posteriormente a su creación, liberación o actualización.
Este proceso se utiliza únicamente para consulta y verificación de información.
En este sitio se encuentra la documentación completa de Oracle:
https://docs.oracle.com/en/cloud/saas/supply-chain-and-manufacturing/25c/fasrp/api-manufacturing-process-work-orders.html
Para utilizar las APIs de Oracle Manufacturing (Process Work Orders), es necesario contar previamente con el rol funcional ORA_WIE_PRODUCTION_SUPERVISOR_JOB (Supervisor de Producción) y tener configurado el Acceso a Datos (Data Access) asignando la correspondiente Planta de Manufactura (Manufacturing Plant) al usuario en la tarea Manage Data Access for Users.
Sin esta autorización y configuración, la API responderá vacía (count: 0) o con error de autorización.
1. Flujo
2. API
Método: GET
| Caso | Endpoint |
|---|---|
| Todas las Órdenes de Proceso (Proyección + DFF): | <url_oracle>/fscmRestApi/resources/11.13.18.05/processWorkOrders?fields=OrganizationId,OrganizationCode,OrganizationName,WorkOrderId,WorkOrderNumber,WorkOrderDescription,WorkOrderType,ProcessName,PrimaryProductId,ItemNumber,Description,PrimaryProductQuantity,PrimaryProductUOMCode,PrimaryProductUnitOfMeasure,BatchQuantity,CompletedQuantity,UOMCode,UnitOfMeasure,PlannedStartDate,PlannedCompletionDate,ActualStartDate,ActualCompletionDate,ReleasedDate,ClosedDate,CanceledDate,ProcessWorkOrderDFF&expand=ProcessWorkOrderDFF&onlyData=true |
| Por Número de Orden: | <url_oracle>/fscmRestApi/resources/11.13.18.05/processWorkOrders?q=WorkOrderNumber=<WorkOrderNumber>&expand=ProcessWorkOrderDFF&onlyData=true |
| Por ID de Orden (PK): | <url_oracle>/fscmRestApi/resources/11.13.18.05/processWorkOrders/<WorkOrderId>?expand=ProcessWorkOrderDFF&onlyData=true |
WorkOrderId: Identificador interno de la cabecera de la Orden de Trabajo de Proceso (PK).
WorkOrderNumber: Número público/visible de la Orden de Trabajo de Oracle.
3. Headers
| Header | Descripción | Valor |
|---|---|---|
Content-Type | Indica que la información enviada y recibida está en formato JSON. | application/json |
Authorization | Credenciales de autenticación HTTP Basic para Oracle Fusion Cloud. | Basic <usuario:contraseña> |
4. Columnas de respuesta
Oracle Fusion Cloud devuelve la información de la Orden de Trabajo de Proceso consultada, incluyendo los datos principales de la cabecera y el objeto de flexfields personalizados asociados.
4.1 Datos de la Orden de Trabajo de Proceso
| Campo | Descripción | Ejemplo |
|---|---|---|
OrganizationId | Identificador interno de la organización/planta de manufactura. | 300000012345678 |
OrganizationCode | Código de la planta de manufactura en Oracle. | MX_PLANT |
OrganizationName | Nombre completo de la planta de manufactura. | PLANTA CUAUTITLAN |
WorkOrderId | Identificador interno de la cabecera de la Orden de Trabajo (PK). | 300000492817291 |
WorkOrderNumber | Número visible asignado a la Orden de Trabajo. | WO-902148 |
WorkOrderDescription | Descripción de la orden o lote de producción. | PRODUCCION LECHE ENTERA 1L |
WorkOrderType | Tipo de orden de manufactura. | PROCESS |
ProcessName | Nombre del proceso o receta de producción asignada. | PROC_ENVASADO_LECHE_ENTERA |
PrimaryProductId | Identificador del artículo primario generado. | 100000434556286 |
ItemNumber | Código comercial/técnico del producto principal. | PTLECH001 |
Description | Descripción detallada del artículo fabricado. | LECHE ENTERA ULTRA PASTEURIZADA 1L |
PrimaryProductQuantity | Cantidad planeada a producir del producto primario. | 15000 |
PrimaryProductUOMCode | Código de la unidad de medida del producto primario. | LT |
PrimaryProductUnitOfMeasure | Descripción de la unidad de medida del producto primario. | Litro |
BatchQuantity | Tamaño total planeado del lote. | 15000 |
CompletedQuantity | Cantidad total fabricada y reportada como completada. | 0 |
UOMCode | Código de la unidad de medida general de la orden. | LT |
UnitOfMeasure | Descripción de la unidad de medida general. | Litro |
PlannedStartDate | Fecha y hora programada de inicio de la producción. | 2026-10-27T08:00:00.000+00:00 |
PlannedCompletionDate | Fecha y hora programada de finalización. | 2026-10-27T18:00:00.000+00:00 |
ActualStartDate | Fecha y hora real de inicio de la orden. | 2026-10-27T08:15:20.000+00:00 |
ActualCompletionDate | Fecha y hora real de término de la orden. | null |
ReleasedDate | Fecha en la que la orden pasó a estado liberado. | 2026-10-26T21:00:10.000+00:00 |
ClosedDate | Fecha de cierre financiero de la orden. | null |
CanceledDate | Fecha en la que la orden fue cancelada (si aplica). | null |
El campo WorkOrderNumber corresponde al número de la Orden de Trabajo y es el principal identificador funcional para el seguimiento en piso de planta.
El campo WorkOrderId corresponde al identificador interno de Oracle utilizado para relacionar la cabecera con sus recursos secundarios (ProcessWorkOrderDFF, operaciones, materiales).
4.2 Datos de Flexfields Personalizados (DFF)
La respuesta incluye la propiedad expandida ProcessWorkOrderDFF, la cual contiene los atributos adicionales y personalizados configurados en Oracle Cloud para la operación de la planta.
| Campo | Descripción |
|---|---|
WorkOrderId | Identificador único interno de la Orden de Trabajo a la que pertenece este Flexfield. |
__FLEX_Context | Código de identificación técnica del contexto asignado al Flexfield descriptivo. |
__FLEX_Context_DisplayValue | Nombre visible en la interfaz para el contexto del Flexfield descriptivo. |
aplicacion | Aplicación, destino o uso específico que se le dará al producto o al proceso en piso. |
productionLine | Línea o banda de producción física asignada para ejecutar la corrida del proceso. |
area | Área operativa, nave industrial o departamento de manufactura donde se procesa la orden. |
tipoDeOrden | Subclasificación o categoría interna utilizada para clasificar el tipo de corrida de producción. |
mermaTecnica | Porcentaje o cantidad de merma/pérdida estándar permitida o calculada durante el proceso de producción. |
origen | Fuente de procedencia de la materia prima, insumo principal o solicitud del lote. |
BACKFLUSH | Indicador o bandera que define si el consumo de materiales se realiza por descarga automática (Backflush) al reportar la producción. |
contenidoNeto | Declaración de la cantidad de contenido neto o volumen final requerido por unidad de empaque. |
La propiedad ProcessWorkOrderDFF permite recuperar los atributos extendidos en la misma respuesta mediante el parámetro expand=ProcessWorkOrderDFF, evitando consultas secundarias por cada orden.
4.3 Datos de control de la respuesta
| Campo | Descripción | Ejemplo |
|---|---|---|
count | Número de registros retornados en la consulta actual. | 1 |
hasMore | Indica si existen más registros disponibles en el servidor. | false |
limit | Límite máximo de registros solicitados por página. | 25 |
offset | Posición inicial utilizada para la paginación. | 0 |
Gracias al parámetro onlyData=true, la respuesta no incluye colecciones pesadas de hipervínculos HATEOAS (links), devolviendo únicamente los datos funcionales y reduciendo el tamaño de transferencia.
5. Ejemplo Solicitud
A continuación se muestran ejemplos de consumo mediante cURL utilizando la selección de campos requeridos y la expansión de sus flexfields descriptivos.
5.1 Ejemplo de Solicitud de Órdenes de Proceso (Proyección + DFF)
curl --location 'https://ejfg-dev1.fa.us6.oraclecloud.com/fscmRestApi/resources/11.13.18.05/processWorkOrders?fields=OrganizationId%2COrganizationCode%2COrganizationName%2CWorkOrderId%2CWorkOrderNumber%2CWorkOrderDescription%2CWorkOrderType%2CProcessName%2CPrimaryProductId%2CItemNumber%2CDescription%2CPrimaryProductQuantity%2CPrimaryProductUOMCode%2CPrimaryProductUnitOfMeasure%2CBatchQuantity%2CCompletedQuantity%2CUOMCode%2CUnitOfMeasure%2CPlannedStartDate%2CPlannedCompletionDate%2CActualStartDate%2CActualCompletionDate%2CReleasedDate%2CClosedDate%2CCanceledDate%2CProcessWorkOrderDFF&expand=ProcessWorkOrderDFF&onlyData=true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic MTU0OTYxMjpDaG9jb3ZhaW5pbGxhMTk=' \
--data ''
5.2 Ejemplo de Solicitud por ID de Orden de Trabajo
curl --location 'https://ejfg-dev1.fa.us6.oraclecloud.com/fscmRestApi/resources/11.13.18.05/processWorkOrders/300000492817291?expand=ProcessWorkOrderDFF&onlyData=true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic MTU0OTYxMjpDaG9jb3ZhaW5pbGxhMTk=' \
--data ''
5.3 Ejemplo de Solicitud por Número de Orden de Trabajo
curl --location 'https://ejfg-dev1.fa.us6.oraclecloud.com/fscmRestApi/resources/11.13.18.05/processWorkOrders/300000492817291?expand=ProcessWorkOrderDFF&onlyData=true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic MTU0OTYxMjpDaG9jb3ZhaW5pbGxhMTk=' \
--data ''
6 Ejemplo de Respuesta
{
"items": [
{
"OrganizationId": 300000216028591,
"OrganizationCode": "GPR",
"OrganizationName": "PLANTA CUAUTITLAN GPR",
"WorkOrderId": 300000237433611,
"WorkOrderNumber": "GPR152",
"WorkOrderDescription": null,
"WorkOrderType": "STANDARD",
"ProcessName": "PROCESO_CRAC070",
"PrimaryProductId": 100000434452242,
"ItemNumber": "CRAC070",
"Description": "CREMA ENT PAST ACIDA 200ML 02/10/2026",
"PrimaryProductQuantity": 400000,
"PrimaryProductUOMCode": "PZ",
"PrimaryProductUnitOfMeasure": "PIEZA",
"BatchQuantity": 400000,
"CompletedQuantity": 348288,
"UOMCode": "PZ",
"UnitOfMeasure": "PIEZA",
"PlannedStartDate": "2025-07-01T12:09:00+00:00",
"PlannedCompletionDate": "2025-07-03T17:29:00.096+00:00",
"ActualStartDate": "2025-07-02T07:05:22+00:00",
"ActualCompletionDate": null,
"ReleasedDate": "2025-07-02T07:05:22+00:00",
"ClosedDate": "2025-07-10T00:50:12.698+00:00",
"CanceledDate": null,
"ProcessWorkOrderDFF": [
{
"WorkOrderId": 300000237433611,
"__FLEX_Context": "MFG_ALP",
"__FLEX_Context_DisplayValue": "MFG_ALP",
"aplicacion": null,
"productionline": "GASTI-4",
"area": "CREMAS",
"tipoDeOrden": "DERIVADOS",
"mermaTecnica": null,
"origen": null,
"BACKFLUSH": null,
"contenidoNeto": null
}
]
},
{
"OrganizationId": 300000216028591,
"OrganizationCode": "GPR",
"OrganizationName": "PLANTA CUAUTITLAN GPR",
"WorkOrderId": 300000237433632,
"WorkOrderNumber": "GPR175",
"WorkOrderDescription": null,
"WorkOrderType": "STANDARD",
"ProcessName": "PROCESO_CRGN055",
"PrimaryProductId": 100000434452251,
"ItemNumber": "CRGN055",
"Description": "CREMA ENT PAST ACIDA 1 PZA 4L",
"PrimaryProductQuantity": 15000,
"PrimaryProductUOMCode": "PZ",
"PrimaryProductUnitOfMeasure": "PIEZA",
"BatchQuantity": 15000,
"CompletedQuantity": 15000,
"UOMCode": "PZ",
"UnitOfMeasure": "PIEZA",
"PlannedStartDate": "2025-07-01T12:30:00+00:00",
"PlannedCompletionDate": "2025-07-01T14:30:00.002+00:00",
"ActualStartDate": "2025-07-02T06:48:06.074+00:00",
"ActualCompletionDate": "2025-07-03T07:20:10+00:00",
"ReleasedDate": "2025-07-02T06:48:06.074+00:00",
"ClosedDate": "2025-07-09T19:22:36.540+00:00",
"CanceledDate": null,
"ProcessWorkOrderDFF": [
{
"WorkOrderId": 300000237433632,
"__FLEX_Context": "MFG_ALP",
"__FLEX_Context_DisplayValue": "MFG_ALP",
"aplicacion": null,
"productionline": "CUBETA",
"area": "CREMAS",
"tipoDeOrden": "DERIVADOS",
"mermaTecnica": null,
"origen": null,
"BACKFLUSH": null,
"contenidoNeto": null
}
]
},
{
"OrganizationId": 300000216028591,
"OrganizationCode": "GPR",
"OrganizationName": "PLANTA CUAUTITLAN GPR",
"WorkOrderId": 300000237433645,
"WorkOrderNumber": "GPR179",
"WorkOrderDescription": null,
"WorkOrderType": "STANDARD",
"ProcessName": "PROCESO_CRSE030",
"PrimaryProductId": 100000434452239,
"ItemNumber": "CRSE030",
"Description": "CREMA SELEC ACIDA 900ML",
"PrimaryProductQuantity": 20000,
"PrimaryProductUOMCode": "PZ",
"PrimaryProductUnitOfMeasure": "PIEZA",
"BatchQuantity": 20000,
"CompletedQuantity": 168,
"UOMCode": "PZ",
"UnitOfMeasure": "PIEZA",
"PlannedStartDate": "2025-07-01T12:30:00+00:00",
"PlannedCompletionDate": "2025-07-01T15:10:00.004+00:00",
"ActualStartDate": "2025-07-02T06:54:25.540+00:00",
"ActualCompletionDate": null,
"ReleasedDate": "2025-07-02T06:54:25.540+00:00",
"ClosedDate": "2025-07-10T23:17:13+00:00",
"CanceledDate": null,
"ProcessWorkOrderDFF": [
{
"WorkOrderId": 300000237433645,
"__FLEX_Context": "MFG_ALP",
"__FLEX_Context_DisplayValue": "MFG_ALP",
"aplicacion": null,
"productionline": "OYSTAR 500",
"area": "CREMAS",
"tipoDeOrden": "DERIVADOS",
"mermaTecnica": null,
"origen": null,
"BACKFLUSH": null,
"contenidoNeto": null
}
]
}
],
"count": 25,
"hasMore": true,
"limit": 25,
"offset": 0,
"links": [
{
"rel": "self",
"href": "https://ejfg-dev1.fa.us6.oraclecloud.com:443/fscmRestApi/resources/11.13.18.05/processWorkOrders",
"name": "processWorkOrders",
"kind": "collection"
}
]
}