Line Changes

When a purchase order acknowledgment message with change codes is received, a supplier initiated change order is created.

This table explains data mapping of the purchase order acknowledgment message to the payload of the changePurchaseOrder service.

Oracle-1-0-B2B-Purchase-Order-Acknowledgment-In-V2	changePurchaseOrder
B2BPurchaseOrderAcknowledgment/OrderNumber	OrderNumber
	SoldToLegalEntityId This is populated during processing.
`B2BPurchaseOrderAcknowledgment/AcknowledgmentCode` This value needs to be in the orderChange or orderAccept code list. It's used for processing and it's not mapped.	N/A
`B2BPurchaseOrderAcknowledgment/AcknowledgmentReason`	ChangeOrderDescription If the `AcknowledgmentReason` isn't provided in the payload, then it will be set to Change to the Order.
B2BPurchaseOrderAcknowledgment/SupplierOrderNumber	SupplierOrderNumber
	Action When the `AcknowledgmentCode` is in the lineChange code list, this is set to CHANGE.
	PurchaseOrderEntryLine
B2BPurchaseOrderAcknowledgment/Lines/LineNumber	LineNumber
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/OrderQuantity`	Quantity Only positive numeric values will result in an update.
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/UnitPriceAmount`	Price If a `UnitPriceAmount` is received with an `AcknowledgmentCode` in the lineChange code list and with an `AcknowledgmentCode` in the linePriceChange for the same line, the `UnitPriceAmount` with the linePriceChange takes precedence and is mapped.
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentReason`	ChangeReason If an `AcknowledgmentReason` isn't provided, then this will be set to Not Provided.
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentCode`	Action When the `AcknowledgmentCode` value is in the lineChange code list, this is set to CHANGE.
	PurchaseOrderEntryLine/PurchaseOrderEntrySchedule Schedule is autogenerated.
	ScheduleNumber ScheduleNumber is autogenerated.
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/OrderQuantity`	Quantity
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentReason`	ChangeReason If the `AcknowledgmentReason` isn't provided in the payload, then it will be set to Not Provided.
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/PromisedDeliveryDate` or `B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/PromisedShipDate`	`PromisedDeliveryDate` or `PromisedShipDate` If the `PromisedDeliveryDate` is provided in the payload and the Buyer Managed Transport isn't selected on the order, then the value is mapped to `PromisedDeliveryDate`. If the `PromisedShipDate` is provided and the Buyer Managed Transport check box is selected on the order, then the value is mapped to `PromisedShipDate`.
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentCode`	Action When the `AcknowledgmentCode` is in the lineChange code list, this is set to CHANGE.
	PurchaseOrderEntryLine/LineFlexfield
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/SupplierItemNumber`	`SupplierItemNumber` or `b2bPartNumberCorrection` If the LINECHANGE Acknowledgment contains `SupplierItemNumber`, it is mapped as follows: If the featureCorrect the Supplier Item Number on Purchase Orders is enabled, the supplier item number is updated on the PO line, otherwise the `SupplierItemNumber` is mapped to the descriptive flexfield, B2BPartNumberCorrection
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/UnitOfMeasureCode`	b2bUOMChange The `UnitofMeasureCode` is mapped to this flexfield if the LINECHANGE Acknowledgment contains `UnitOfMeasureCode`.
	b2bProvidedDateNote If the `AcknowledgmentCode` value is in the lineChange code list and includes a `PromisedDeliveryDate` and the Buyer Managed Transport checkbox is selected on the PO, this field is set to Promised Delivery Date Provided. If the `AcknowledgmentCode` value is in the lineChange code list and includes a `PromisedShipDate` and the Buyer Managed Transport checkbox is not selected on the PO, this field is set to Promised Ship Date Provided.
`B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/PromisedDeliveryDate` or `B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/PromisedShipDate`	b2bProvidedDate If the `PromisedDeliveryDate` is provided in the payload and the Buyer Managed Transport checkbox is selected on the PO this field is set to `PromisedDeliveryDate`. If the `PromisedShipDate` is provided in the payload and the Buyer Managed Transport checkbox is not selected on the PO this field is set to `PromisedShipDate`.
	HeaderFlexfield
N/A	b2bAckReviewRequired This descriptive flexfield is set to One or more lines have acknowledgment comments, if any of the following conditions are met: If the `SupplierItemNumber` is provided in the acknowledgments when the `AcknowledgmentCode` is in the lineChange code list and the feature Correct the Supplier Item Number on Purchase Orders isn't enabled or if the `UnitOfMeasureCode` is provided. If the `PromisedDeliveryDate` is provided in the payload and the Buyer Managed Transport checkbox is selected on the PO. If the `PromisedShipDate` is provided in the payload and the Buyer Managed Transport checkbox is not selected on the PO.

Sample Payload

Here's a sample payload for a line change:

<n1:Lines>
   <n1:LineNumber>1</n1:LineNumber>
   <n1:SupplierItemNumber>2D72PT65X</n1:SupplierItemNumber>
   <n1:CustomerItemNumber>1087162</n1:CustomerItemNumber>
   <n1:OrderQuantity>100.0</n1:OrderQuantity>
   <n1:UnitOfMeasureCode>BX</n1:UnitOfMeasureCode>
   <n1:UnitPriceAmount>69.75</n1:UnitPriceAmount>
   <n1:Acknowledgments>
      <n1:AcknowledgmentCode>LINECHANGE</n1:AcknowledgmentCode> <!--LINECHANGE can process: Price, Part Number Correction, UOM, Qty, Date changes-->
      <n1:AcknowledgmentReason>Line 1-Price, Part Number, Quantity, UOM, Date Changes</n1:AcknowledgmentReason><!--This value will be populated in the Change Reason field-->
      <n1:UnitPriceAmount>10.25</n1:UnitPriceAmount> <!--This value will be populated in the Price field-->
      <n1:SupplierItemNumber>009-009</n1:SupplierItemNumber> <!--This value will be populated in the Supplier Item field if the Correct the Supplier Item Number on Purchase Orders feature is enabled. If not, this value will  be populated in

             the b2bPartNumberCorrection descriptive flexfield -->
      <n1:OrderQuantity>8.0</n1:OrderQuantity> <!--This value will be populated in the Quantity field-->
      <n1:UnitOfMeasureCode>BX</n1:UnitOfMeasureCode> <!--This value will be populated in the b2bUOMChange descriptive flexfield-->
      <n1:PromisedDeliveryDate>2025-11-17T09:30:47Z</n1:PromisedDeliveryDate> <!-- If the Buyer Managed Transport flag is false, this value will be populated in the Promised Delivery Date field under the PO Schedules-->
   </n1:Acknowledgments>
</n1:Lines>