Skip to main content

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.
info

Este proceso se utiliza únicamente para consulta y verificación de información.

Documentación Oficial de Oracle
Requisito de autorización y configuración

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

CasoEndpoint
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
Campos

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​

HeaderDescripciónValor
Content-TypeIndica que la información enviada y recibida está en formato JSON.application/json
AuthorizationCredenciales 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​

CampoDescripciónEjemplo
OrganizationIdIdentificador interno de la organización/planta de manufactura.300000012345678
OrganizationCodeCódigo de la planta de manufactura en Oracle.MX_PLANT
OrganizationNameNombre completo de la planta de manufactura.PLANTA CUAUTITLAN
WorkOrderIdIdentificador interno de la cabecera de la Orden de Trabajo (PK).300000492817291
WorkOrderNumberNúmero visible asignado a la Orden de Trabajo.WO-902148
WorkOrderDescriptionDescripción de la orden o lote de producción.PRODUCCION LECHE ENTERA 1L
WorkOrderTypeTipo de orden de manufactura.PROCESS
ProcessNameNombre del proceso o receta de producción asignada.PROC_ENVASADO_LECHE_ENTERA
PrimaryProductIdIdentificador del artículo primario generado.100000434556286
ItemNumberCódigo comercial/técnico del producto principal.PTLECH001
DescriptionDescripción detallada del artículo fabricado.LECHE ENTERA ULTRA PASTEURIZADA 1L
PrimaryProductQuantityCantidad planeada a producir del producto primario.15000
PrimaryProductUOMCodeCódigo de la unidad de medida del producto primario.LT
PrimaryProductUnitOfMeasureDescripción de la unidad de medida del producto primario.Litro
BatchQuantityTamaño total planeado del lote.15000
CompletedQuantityCantidad total fabricada y reportada como completada.0
UOMCodeCódigo de la unidad de medida general de la orden.LT
UnitOfMeasureDescripción de la unidad de medida general.Litro
PlannedStartDateFecha y hora programada de inicio de la producción.2026-10-27T08:00:00.000+00:00
PlannedCompletionDateFecha y hora programada de finalización.2026-10-27T18:00:00.000+00:00
ActualStartDateFecha y hora real de inicio de la orden.2026-10-27T08:15:20.000+00:00
ActualCompletionDateFecha y hora real de término de la orden.null
ReleasedDateFecha en la que la orden pasó a estado liberado.2026-10-26T21:00:10.000+00:00
ClosedDateFecha de cierre financiero de la orden.null
CanceledDateFecha en la que la orden fue cancelada (si aplica).null
important

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.

CampoDescripción
WorkOrderIdIdentificador único interno de la Orden de Trabajo a la que pertenece este Flexfield.
__FLEX_ContextCódigo de identificación técnica del contexto asignado al Flexfield descriptivo.
__FLEX_Context_DisplayValueNombre visible en la interfaz para el contexto del Flexfield descriptivo.
aplicacionAplicación, destino o uso específico que se le dará al producto o al proceso en piso.
productionLineLí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.
tipoDeOrdenSubclasificación o categoría interna utilizada para clasificar el tipo de corrida de producción.
mermaTecnicaPorcentaje o cantidad de merma/pérdida estándar permitida o calculada durante el proceso de producción.
origenFuente de procedencia de la materia prima, insumo principal o solicitud del lote.
BACKFLUSHIndicador o bandera que define si el consumo de materiales se realiza por descarga automática (Backflush) al reportar la producción.
contenidoNetoDeclaración de la cantidad de contenido neto o volumen final requerido por unidad de empaque.
info

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​

CampoDescripciónEjemplo
countNúmero de registros retornados en la consulta actual.1
hasMoreIndica si existen más registros disponibles en el servidor.false
limitLímite máximo de registros solicitados por página.25
offsetPosición inicial utilizada para la paginación.0
note

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"
}
]
}