Creación de Pedidos

Esta API permite crear pedidos de venta en Oracle Fusion Cloud Order Management, integrando en una sola petición la información general del pedido, los datos del cliente, las direcciones de facturación y entrega, así como las líneas de productos solicitados.

El proceso recibe la información proveniente del sistema origen, construye la transacción y la envía a Oracle Fusion Cloud para su creación y procesamiento.

La petición contempla los siguientes componentes principales:

Datos generales del pedido: sistema origen, unidad de negocio, cliente, tipo de transacción, fecha de envío y condiciones de pago.
Datos de facturación: información de la cuenta y dirección utilizada para facturar al cliente.
Datos de entrega: cliente, sitio y dirección donde se realizará la entrega.
Líneas del pedido: productos, cantidades y unidades de medida solicitadas.

info

El campo SubmittedFlag permite indicar si el pedido debe enviarse para su procesamiento al momento de ser creado. En el ejemplo documentado se establece como true.

important

La información utilizada para crear el pedido debe corresponder con la configuración existente en Oracle Fusion Cloud, incluyendo la unidad de negocio, cliente, sitios, organización de cumplimiento, tipo de transacción, productos y unidades de medida.

Documentación Oficial de Oracle

En este sitio se encuentra la documentación completa de oracle https://docs.oracle.com/en/cloud/saas/supply-chain-and-manufacturing/25d/fasrp/op-salesordersfororderhub-post.html

Requisito de autorización y configuración

Para utilizar las APIs de Oracle Purchasing, es necesario contar previamente con la autorización del equipo de Oracle y con la configuración correspondiente para la creación de Órdenes de Compra manuales.

Sin esta autorización y configuración, las APIs no podrán utilizarse correctamente.

1. Flujo

2. API

Método: POST

URL: <url_oracle>/fscmRestApi/resources/11.13.18.05/salesOrdersForOrderHub

3. Headers

Header	Descripción	Valor
`Content-Type`	Indica que la información enviada está en formato JSON.	`application/json`
`Authorization`	Credenciales de autenticación HTTP Basic para Oracle Fusion Cloud	`Basic <usuario:contraseña>`

4. Datos Requeridos para generar un pedido

4.1. Datos Generales del Pedido

Campo	Descripción	Ejemplo
`SourceTransactionNumber`	Número de la transacción de origen utilizado para identificar el pedido en el sistema origen.	`0000005`
`SourceTransactionSystem`	Identifica el sistema externo que origina la transacción.	`OPS`
`SourceTransactionId`	Identificador único de la transacción en el sistema origen.	`0000005`
`BusinessUnitName`	Unidad de negocio donde se registra el pedido.	`UN_MACRO_CEDIS`
`BuyingPartyName`	Nombre del cliente que realiza la compra.	`FORTILACTEOS`
`TransactionType`	Tipo de transacción utilizado para crear el pedido.	`GNF GPLP MACROCEDIS FRIOS NAVE 13`
`RequestedShipDate`	Fecha y hora solicitada para el envío.	`2025-06-25T20:49:12+00:00`
`RequestedFulfillmentOrganizationName`	Organización de cumplimiento encargada de surtir el pedido.	`MACRO CEDIS - NAVE 13 FRIOS CAMARA 1`
`PaymentTerms`	Condición de pago asociada al pedido.	`30`
`RequestingBusinessUnitName`	Unidad de negocio que solicita el pedido.	`UN_MACRO_CEDIS`
`SubmittedFlag`	Indica si el pedido se envía para su procesamiento al momento de crearlo.	`true`
`SourceTransactionRevisionNumber`	Número de revisión de la transacción de origen.	`1`

4.2. Configuración de precios, cargos e impuestos

Campo	Descripción	Ejemplo
`FreezePriceFlag`	Indica si el precio debe mantenerse sin modificaciones durante el procesamiento.	`false`
`FreezeShippingChargeFlag`	Indica si el cargo de envío debe mantenerse sin modificaciones.	`false`
`FreezeTaxFlag`	Indica si los impuestos deben mantenerse sin modificaciones.	`false`

4.3. Datos del cliente para facturación

La propiedad billToCustomer contiene la información correspondiente a la dirección utilizada para la facturación.

Campo	Descripción	Ejemplo
`PartyName`	Nombre del cliente.	`FORTILACTEOS`
`AccountNumber`	Número de cuenta del cliente.	`182167`
`Address1`	Dirección del cliente.	`ALVARO OBREGON`
`City`	Ciudad del cliente.	`INDEPENDENCIA`
`State`	Estado o entidad federativa.	`MICH`
`PostalCode`	Código postal.	`60630`
`County`	Municipio o localidad.	`APATZINGAN`
`Province`	Provincia, cuando aplica.	`null`
`Country`	Código del país.	`MX`

4.4 Datos del cliente para entrega

La propiedad shipToCustomer contiene la información correspondiente al sitio y dirección donde se realizará la entrega.

Campo	Descripción	Ejemplo
`PartyName`	Nombre del cliente.	`FORTILACTEOS`
`PartyId`	Identificador interno del cliente en Oracle Fusion Cloud.	`300000189584334`
`PartyNumber`	Número de identificación del cliente.	`186484`
`SiteId`	Identificador del sitio de entrega.	`100000476772419`
`Address1`	Dirección de entrega.	`ALVARO OBREGON`
`City`	Ciudad de entrega.	`INDEPENDENCIA`
`County`	Municipio o localidad.	`APATZINGAN`
`PostalCode`	Código postal.	`60630`
`Country`	Código del país.	`MX`
`ContactId`	Identificador del contacto asociado al sitio de entrega.	`null`

4.5 Datos de las líneas

La propiedad lines contiene los productos que forman parte del pedido de venta.

Campo	Descripción	Ejemplo
`SourceTransactionLineId`	Identificador de la línea en el sistema origen.	`1`
`SourceTransactionLineNumber`	Número de línea de la transacción de origen.	`1`
`SourceTransactionScheduleId`	Identificador del calendario de la línea en el sistema origen.	`1`
`SourceScheduleNumber`	Número de calendario de la línea.	`1`
`TransactionCategoryCode`	Código que identifica la categoría de la transacción.	`ORDER`
`TransactionLineType`	Tipo de línea de la transacción.	`Buy`
`ProductNumber`	Número o código del producto solicitado.	`CRAC090`
`OrderedQuantity`	Cantidad solicitada del producto.	`24`
`OrderedUOM`	Unidad de medida utilizada para la cantidad solicitada.	`PIEZA`

5. Respuesta

Oracle Fusion Cloud devuelve información relacionada con el pedido de venta creado como resultado de la petición.

Los campos de identificación y control más importantes son:

Campo	Descripción
`OrderNumber`	Número del pedido de venta generado por Oracle Fusion Cloud.
`OrderHeaderId`	Identificador interno de la cabecera del pedido.
`SourceTransactionNumber`	Número de la transacción proporcionado por el sistema origen.
`SourceTransactionSystem`	Sistema que originó la transacción.
`BusinessUnitName`	Unidad de negocio asociada al pedido.
`BuyingPartyName`	Cliente asociado al pedido.
`RequestedShipDate`	Fecha solicitada para el envío.
`RequestedFulfillmentOrganizationName`	Organización encargada del cumplimiento del pedido.
`lines`	Conjunto de líneas asociadas al pedido de venta.

important

El campo OrderNumber corresponde al número de pedido generado por Oracle Fusion Cloud y permite identificar la transacción posteriormente.

El campo OrderHeaderId corresponde al identificador interno de la cabecera del pedido utilizado por Oracle Fusion Cloud.

6. Ejemplo de Solicitud

El JSON enviado contiene la información general de la transacción, los datos de facturación (billToCustomer), los datos de envío (shipToCustomer) y las líneas de producto correspondientes.

{ 
    "SourceTransactionNumber": "0000005",
    "SourceTransactionSystem": "OPS",
    "SourceTransactionId": "0000005",
    "BusinessUnitName": "UN_MACRO_CEDIS",
    "BuyingPartyName": "FORTILACTEOS",
    "BuyingPartyContactName": null,
    "TransactionType": "GNF GPLP MACROCEDIS FRIOS NAVE 13",
    "RequestedShipDate": "2025-06-25T20:49:12+00:00",
    "RequestedFulfillmentOrganizationName": "MACRO CEDIS - NAVE 13 FRIOS CAMARA 1",
    "PaymentTerms": "30",
    "RequestingBusinessUnitName": "UN_MACRO_CEDIS",
    "FreezePriceFlag": false,
    "FreezeShippingChargeFlag": false,
    "FreezeTaxFlag": false,
    "SubmittedFlag": true,
    "SourceTransactionRevisionNumber": 1,
    "billToCustomer": [ 
        { 
            "PartyName": "FORTILACTEOS",
            "AccountNumber": "182167",
            "Address1": "ALVARO OBREGON",
            "City": "INDEPENDENCIA",
            "State": "MICH",
            "PostalCode": "60630",
            "County": "APATZINGAN",
            "Province": null,
            "Country": "MX"
        }
    ],
    "shipToCustomer": [ 
        { 
            "PartyName": "FORTILACTEOS",
            "PartyId": 300000189584334,
            "PartyNumber": "186484",
            "SiteId": 100000476772419,
            "Address1": "ALVARO OBREGON",
            "City": "INDEPENDENCIA",
            "County": "APATZINGAN",
            "PostalCode": "60630",
            "Country": "MX",
            "ContactId": null
        }
    ],
    "lines": [ 
        { 
            "SourceTransactionLineId": "1",
            "SourceTransactionLineNumber": "1",
            "SourceTransactionScheduleId": "1",
            "SourceScheduleNumber": "1",
            "TransactionCategoryCode": "ORDER",
            "TransactionLineType": "Buy",
            "ProductNumber": "CRAC090",
            "OrderedQuantity": 24,
            "OrderedUOM": "PIEZA"
        }
    ]
}

1. Flujo​

2. API​

3. Headers​

4. Datos Requeridos para generar un pedido​

4.1. Datos Generales del Pedido​

4.2. Configuración de precios, cargos e impuestos​

4.3. Datos del cliente para facturación​

4.4 Datos del cliente para entrega​

4.5 Datos de las líneas​

5. Respuesta​

6. Ejemplo de Solicitud​