Creación de Órdenes de Compra

Esta API permite crear una Orden de Compra (OC) en Oracle Fusion Cloud Purchasing, incluyendo tanto la información de la cabecera como las líneas de la orden en una sola solicitud.

La información de la Orden de Compra se envía mediante una petición POST al recurso draftPurchaseOrders.

El proceso permite registrar:

Información de la unidad de negocio.
Comprador responsable.
Moneda.
Condiciones de pago.
Configuración de pago.
Configuración de transporte.
Una o varias líneas de productos o servicios.

Nota

La cabecera y las líneas de la Orden de Compra se pueden enviar dentro de la misma petición mediante la propiedad lines.

Documentación Oficial de Oracle

En este sitio se encuentra la documentación completa de oracle https://docs.oracle.com/en/cloud/saas/procurement/25d/fapra/op-draftpurchaseorders-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/draftPurchaseOrders

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

El body está compuesto por dos secciones principales:

Información de la cabecera de la Orden de Compra.
Información de las líneas mediante la propiedad lines.

{
  "ProcurementBU": "UN_GPLP",
  "RequisitioningBU": "UN_GPLP",
  "Buyer": "CYNTHIA ROSELIA, TELLEZ LEON",
  "DocumentStyleId": 1,
  "CurrencyCode": "MXN",
  "PaymentTerms": "30 DIAS",
  "PayOnReceiptFlag": true,
  "BuyerManagedTransportFlag": false,
  "lines": [
    {
      "LineNumber": 1,
      "LineType": "Bienes",
      "Item": "DIINET0048",
      "Quantity": 10,
      "Price": 20,
      "UOM": "KILOGRAMO"
    },
    {
      "LineNumber": 2,
      "LineType": "Bienes",
      "Item": "DIINET0048",
      "Quantity": 10,
      "Price": 20,
      "UOM": "KILOGRAMO"
    }
  ]
}

5. Campos requeridos para la cabecera

Parámetro	Tipo	Descripción	Ejemplo
`ProcurementBU`	String	Unidad de negocio responsable de la adquisición.	`UN_GPLP`
`RequisitioningBU`	String	Unidad de negocio solicitante.	`UN_GPLP`
`Buyer`	String	Comprador responsable de la Orden de Compra.	`CYNTHIA ROSELIA, TELLEZ LEON`
`DocumentStyleId`	Integer	Identificador del estilo de documento utilizado para la OC.	`1`
`CurrencyCode`	String	Código de moneda utilizado en la Orden de Compra.	`MXN`
`PaymentTerms`	String	Condiciones de pago de la Orden de Compra.	`30 DIAS`
`PayOnReceiptFlag`	Boolean	Indica si el pago se realizará al recibir los bienes o servicios.	`true`
`BuyerManagedTransportFlag`	Boolean	Indica si el transporte será administrado por el comprador.	`false`
`lines`	Array	Colección de líneas que forman parte de la Orden de Compra.	`[...]`

6. Campos requeridos para las líneas

Cada elemento dentro del arreglo lines representa una línea de la Orden de Compra.

Parámetro	Tipo	Descripción	Ejemplo
`LineNumber`	Integer	Número consecutivo de la línea dentro de la OC.	`1`
`LineType`	String	Tipo de línea de la Orden de Compra.	`Bienes`
`Item`	String	Código del artículo que se incluirá en la OC.	`DIINET0048`
`Quantity`	Number	Cantidad solicitada del artículo.	`10`
`Price`	Number	Precio unitario del artículo.	`20`
`UOM`	String	Unidad de medida utilizada para la cantidad.	`KILOGRAMO`

note

Para registrar varias líneas en una misma Orden de Compra, se agregan múltiples objetos dentro del arreglo lines. Cada línea debe contar con su correspondiente LineNumber.

7. Columnas Respuesta

Oracle Fusion Cloud devuelve la información de la Orden de Compra creada.

Entre los datos principales de la respuesta se encuentran:

Campo	Descripción	Ejemplo
`POHeaderId`	Identificador interno de la cabecera de la Orden de Compra.	`300000482229200`
`OrderNumber`	Número de la Orden de Compra generado por Oracle.	`190155224`
`StatusCode`	Código del estado de la Orden de Compra.	`INCOMPLETE`
`Status`	Descripción del estado de la Orden de Compra.	`Incompleta`
`ProcurementBU`	Unidad de negocio de compras.	`UN_GPLP`
`RequisitioningBU`	Unidad de negocio solicitante.	`UN_GPLP`
`Buyer`	Comprador asignado.	`CYNTHIA ROSELIA, TELLEZ LEON`
`CurrencyCode`	Moneda de la Orden de Compra.	`MXN`
`PaymentTerms`	Condiciones de pago.	`30 DIAS`
`CreationDate`	Fecha y hora de creación.	`2026-08-24T19:57:06.001+00:00`

important

El campo OrderNumber corresponde al número de la Orden de Compra generado por Oracle y permite identificar la OC posteriormente.

El campo POHeaderId corresponde al identificador interno utilizado por Oracle para la cabecera de la Orden de Compra.

8. Ejemplo Solicitud

curl --location 'https://ejfg-dev2.fa.us6.oraclecloud.com/fscmRestApi/resources/11.13.18.05/draftPurchaseOrders' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--header 'Cookie: ak_bmsc=D8BA31B193AC3236939A451B6E726AA4~000000000000000000000000000000~YAAQrifIFza9OjWgAQAAi9rhOgD5kCLA6udS2ANiHd/Wz/LrVrDFwZPZxRIYlpHbFpHbQn0NJ7eRVB+mXwVPiX0j3vWwII7dig9NndshQMWXevfTHZMenSQNaJywWYRymQB4UxqgzAKyzx3z242ViCQNA1WTAtr/itTvPED5QYAAdPCeXULwxGpR7w3FRyQY1v2uijAbGmVix+pVvzd65OMG/XG7cSwW5rXP/scQxFuIZAaaEoWDz4zB4+KpC/SzZaegFcCgwF2h8X3FUkXDqxELXypCvXKc19O8xOrZ1j9bviLpcz4rAlSNPKLJzWvq5mE91iJppdSZi3kz0XtIrZ8FLO32XsxG7rWHowHcjBeeEn1ETHu8QRF1GQMtCR+v+P8UnrIZyroSmFUO64EdgKIm4lnG45eLIVjpH+6l+u2JPOmkJ0BYyS8MYpC0w9lfCiuqrYxaP31YWnvKgKh8xGA=' \
--data '{
	 "ProcurementBU": "UN_GPLP",
    "RequisitioningBU": "UN_GPLP",
    "Buyer":  "CYNTHIA ROSELIA, TELLEZ LEON",
    "DocumentStyleId": 1,
    "CurrencyCode": "MXN",
    "PaymentTerms": "30 DIAS",
    "PayOnReceiptFlag": true,
    "BuyerManagedTransportFlag": false,
    "lines": [
    {
      "LineNumber": 1,
      "LineType": "Bienes",
      "Item": "DIINET0048",
      "Quantity": 10,
	  "Price": 20,
	  "UOM": "KILOGRAMO"
    },
    {
      "LineNumber": 2,
      "LineType": "Bienes",
      "Item": "DIINET0048",
      "Quantity": 10,
	  "Price": 20,
	  "UOM": "KILOGRAMO"
    }
  ]
}'

9. Ejemplo Respuesta

{
    "POHeaderId": 300000482238418,
    "OrderNumber": "190155229",
    "Description": null,
    "DocumentStyleId": 1,
    "DocumentStyle": "Orden de compra",
    "StatusCode": "INCOMPLETE",
    "Status": "Incompleta",
    "ProcurementBUId": 300000191219461,
    "ProcurementBU": "UN_GPLP",
    "RequisitioningBUId": 300000191219461,
    "RequisitioningBU": "UN_GPLP",
    "BuyerId": 300000008125793,
    "Buyer": "CYNTHIA ROSELIA, TELLEZ LEON",
    "BuyerEmail": "cynthia.tellez@alpura.com",
    "CurrencyCode": "MXN",
    "Currency": "Peso Mexicano",
    "ConversionRateTypeCode": null,
    "ConversionRateType": null,
    "ConversionRateDate": null,
    "ConversionRate": null,
    "SupplierId": null,
    "Supplier": null,
    "SupplierSiteId": null,
    "SupplierSite": null,
    "SupplierCommunicationMethod": null,
    "SupplierFax": null,
    "SupplierOrder": null,
    "SupplierEmailAddress": null,
    "SoldToLegalEntityId": 300000189878388,
    "SoldToLegalEntity": "GANADEROS PRODUCTORES DE LECHE PURA",
    "BillToBUId": null,
    "BillToBU": null,
    "BillToLocationId": null,
    "BillToLocation": null,
    "BillToLocationInternalCode": null,
    "DefaultShipToLocationId": null,
    "DefaultShipToLocation": null,
    "DefaultShipToLocationInternalCode": null,
    "MasterContractId": null,
    "MasterContractNumber": null,
    "MasterContractTypeId": null,
    "MasterContractType": null,
    "RequiredAcknowledgmentCode": null,
    "RequiredAcknowledgment": null,
    "AcknowledgmentDueDate": null,
    "AcknowledgmentWithinDays": null,
    "BuyerManagedTransportFlag": false,
    "RequiresSignatureFlag": false,
    "PendingSignatureFlag": null,
    "PaymentTermsId": 300000189975106,
    "PaymentTerms": "30 DIAS",
    "FOBCode": null,
    "FOB": null,
    "FreightTermsCode": null,
    "FreightTerms": null,
    "SupplierContactId": null,
    "SupplierContact": null,
    "NoteToSupplier": null,
    "NoteToReceiver": null,
    "CarrierId": null,
    "Carrier": null,
    "ModeOfTransportCode": null,
    "ModeOfTransport": null,
    "ServiceLevelCode": null,
    "ServiceLevel": null,
    "ConfirmingOrderFlag": false,
    "PayOnReceiptFlag": false,
    "DocumentCreationMethod": "PO_REST_SERVICE",
    "ConfiguredItemFlag": false,
    "ShippingMethod": null,
    "DefaultTaxationCountryCode": "MX",
    "DefaultTaxationCountry": "México",
    "FirstPartyRegistrationId": null,
    "FirstPartyRegistrationNumber": null,
    "ThirdPartyRegistrationId": null,
    "ThirdPartyRegistrationNumber": null,
    "DocumentFiscalClassificationId": null,
    "DocumentFiscalClassificationCode": null,
    "DocumentFiscalClassification": null,
    "BudgetaryControlEnabledFlag": true,
    "CancelFlag": null,
    "ChangeOrderNumber": null,
    "ChangeOrderInitiatingParty": null,
    "ChangeOrderDescription": null,
    "ChangeOrderStatusCode": null,
    "ChangeOrderStatus": null,
    "ChangeOrderTypeCode": null,
    "ChangeOrderType": null,
    "ChangeRequestedBy": null,
    "ContractTermsExistFlag": null,
    "DuplicatedFromHeaderId": null,
    "FundsStatus": null,
    "FundsStatusCode": null,
    "ImportSourceCode": null,
    "ProcurementCardId": null,
    "ReferenceNumber": null,
    "LastUpdateDate": "2026-08-25T22:09:36.617+00:00",
    "LastUpdatedBy": "134422",
    "CreationDate": "2026-08-25T22:09:36.001+00:00",
    "CreatedBy": "134422",
    "VersionId": null,
    "SupplierCCEmailAddress": null,
    "SupplierBCCEmailAddress": null,
    "OverridingApproverId": null,
    "OverridingApprover": null,
    "OverrideB2BCommunicationFlag": false,
    "hasPOlineswithMultipleDistributionsFlag": false,
    "hasReceivedOrInvoicedSchedulesFlag": false,
    "AdditionalContactEmail": null,
    "SpecialHandlingType": null,
    "SpecialHandlingTypeCode": null,
    "ChecklistId": null,
    "Checklist": null,
    "ChecklistNumber": null,
    "NoteToAuthorizer": null,
    "RecoverableTax": 0,
    "NonRecoverableTax": 0,
    "RecoverableInclusiveTax": 0,
    "NonRecoverableInclusiveTax": 0,
    "CreditAmount": 0,
    "DiscountAmount": 0.00,
    "OrderedAmountBeforeAdjustments": 0.00,
    "OkcContractNumber": null,
    "OkcContractId": null,
    "lines": [
        {
            "POLineId": 300000482238420,
            "LineNumber": 1,
            "POHeaderId": 300000482238418,
            "OrderNumber": "190155229",
            "LineTypeId": 1,
            "LineType": "Bienes",
            "ItemId": 100000434556286,
            "Item": "DIINET0048",
            "ItemRevision": null,
            "CategoryId": 300000192302607,
            "CategoryCode": "ESTABILIZANTE_Y_EMULSIFICANTE",
            "Category": "ESTABILIZANTE_Y_EMULSIFICANTE",
            "Description": "RECODAN 226",
            "Amount": null,
            "Quantity": 10,
            "BasePrice": 20,
            "DiscountType": null,
            "Discount": null,
            "DiscountReason": null,
            "Price": 20,
            "UOMCode": "KG",
            "UOM": "KILOGRAMO",
            "PricingUOMCode": "KG",
            "PricingUOM": "KILOGRAMO",
            "CurrencyCode": "MXN",
            "Currency": "Peso Mexicano",
            "BaseModelId": null,
            "BaseModel": null,
            "BaseModelPrice": null,
            "CancelDate": null,
            "CancelFlag": false,
            "CancelReason": null,
            "CancelledBy": null,
            "ChangeAcceptedFlag": null,
            "ConfiguredItemFlag": false,
            "ConsignmentLineFlag": null,
            "SourceAgreementId": null,
            "SourceAgreementNumber": null,
            "SourceAgreementLineId": null,
            "SourceAgreementLine": null,
            "SourceAgreementTypeCode": null,
            "SourceAgreementType": null,
            "SourceAgreementProcurementBUId": null,
            "SourceAgreementProcurementBU": null,
            "ResponseLine": null,
            "Response": null,
            "NegotiationId": null,
            "Negotiation": null,
            "NegotiationLine": null,
            "FundsStatusCode": null,
            "FundsStatus": null,
            "ManualPriceChangeFlag": null,
            "NegotiatedFlag": false,
            "NoteToSupplier": null,
            "ReasonForChange": null,
            "SupplierConfigurationId": null,
            "SupplierItem": null,
            "OptionsPrice": null,
            "UNNumberCode": null,
            "UNNumberId": null,
            "UNNumber": null,
            "UNNumberDescription": null,
            "HazardClassCode": null,
            "HazardClassId": null,
            "HazardClass": null,
            "WorkOrderProduct": null,
            "SecondaryUOMCode": null,
            "SecondaryUOM": null,
            "SecondaryQuantity": null,
            "TaxableFlag": null,
            "ReferenceNumber": null,
            "CancelUnfulfilledDemandFlag": null,
            "CreationDate": "2026-08-25T22:09:36.157+00:00",
            "CreatedBy": "134422",
            "LastUpdateDate": "2026-08-25T22:09:36.464+00:00",
            "LastUpdatedBy": "134422",
            "MaximumRetainageAmount": null,
            "Manufacturer": null,
            "ManufacturerPartNumber": null,
            "CreditFlag": false,
            "RecoverableTax": 0,
            "NonRecoverableTax": 0,
            "RecoverableInclusiveTax": 0,
            "NonRecoverableInclusiveTax": 0,
            "links": []
        },
        {
            "POLineId": 300000482238421,
            "LineNumber": 2,
            "POHeaderId": 300000482238418,
            "OrderNumber": "190155229",
            "LineTypeId": 1,
            "LineType": "Bienes",
            "ItemId": 100000434556286,
            "Item": "DIINET0048",
            "ItemRevision": null,
            "CategoryId": 300000192302607,
            "CategoryCode": "ESTABILIZANTE_Y_EMULSIFICANTE",
            "Category": "ESTABILIZANTE_Y_EMULSIFICANTE",
            "Description": "RECODAN 226",
            "Amount": null,
            "Quantity": 10,
            "BasePrice": 20,
            "DiscountType": null,
            "Discount": null,
            "DiscountReason": null,
            "Price": 20,
            "UOMCode": "KG",
            "UOM": "KILOGRAMO",
            "PricingUOMCode": "KG",
            "PricingUOM": "KILOGRAMO",
            "CurrencyCode": "MXN",
            "Currency": "Peso Mexicano",
            "BaseModelId": null,
            "BaseModel": null,
            "BaseModelPrice": null,
            "CancelDate": null,
            "CancelFlag": false,
            "CancelReason": null,
            "CancelledBy": null,
            "ChangeAcceptedFlag": null,
            "ConfiguredItemFlag": false,
            "ConsignmentLineFlag": null,
            "SourceAgreementId": null,
            "SourceAgreementNumber": null,
            "SourceAgreementLineId": null,
            "SourceAgreementLine": null,
            "SourceAgreementTypeCode": null,
            "SourceAgreementType": null,
            "SourceAgreementProcurementBUId": null,
            "SourceAgreementProcurementBU": null,
            "ResponseLine": null,
            "Response": null,
            "NegotiationId": null,
            "Negotiation": null,
            "NegotiationLine": null,
            "FundsStatusCode": null,
            "FundsStatus": null,
            "ManualPriceChangeFlag": null,
            "NegotiatedFlag": false,
            "NoteToSupplier": null,
            "ReasonForChange": null,
            "SupplierConfigurationId": null,
            "SupplierItem": null,
            "OptionsPrice": null,
            "UNNumberCode": null,
            "UNNumberId": null,
            "UNNumber": null,
            "UNNumberDescription": null,
            "HazardClassCode": null,
            "HazardClassId": null,
            "HazardClass": null,
            "WorkOrderProduct": null,
            "SecondaryUOMCode": null,
            "SecondaryUOM": null,
            "SecondaryQuantity": null,
            "TaxableFlag": null,
            "ReferenceNumber": null,
            "CancelUnfulfilledDemandFlag": null,
            "CreationDate": "2026-08-25T22:09:36.352+00:00",
            "CreatedBy": "134422",
            "LastUpdateDate": "2026-08-25T22:09:36.473+00:00",
            "LastUpdatedBy": "134422",
            "MaximumRetainageAmount": null,
            "Manufacturer": null,
            "ManufacturerPartNumber": null,
            "CreditFlag": false,
            "RecoverableTax": 0,
            "NonRecoverableTax": 0,
            "RecoverableInclusiveTax": 0,
            "NonRecoverableInclusiveTax": 0,
            "links": []
        }
    ],
    "links": []
}

1. Flujo​

2. API​

3. Headers​

4. Body​

5. Campos requeridos para la cabecera​

6. Campos requeridos para las líneas​

7. Columnas Respuesta​

8. Ejemplo Solicitud​

9. Ejemplo Respuesta​