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
bB2BPurchaseOrderAcknowledgment/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>