1. Configuring and Managing B2B Messaging
  2. Line Changes

Line Changes

When a purchase order acknowledgment message with change codes is received, a change order is created. 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.

changePurchaseOrder

ORACLE_1.0_B2B_PURCHASE_ORDER_ACKNOWLEDGMENT_IN

OrderNumber

B2BPurchaseOrderAcknowledgment/OrderNumber

SoldToLegalEntityId

Note: This is populated during processing.

N/A

B2BPurchaseOrderAcknowledgment/AcknowledgmentCode

Note: This value needs to be in the orderChange or orderAccept code list. It's used for processing and it's not mapped.

ChangeOrderDescription

Note: If the AcknowledgmentReason isn't provided in the payload, then it will be set to Change to the Order.

B2BPurchaseOrderAcknowledgment/AcknowledgmentReason

SupplierOrderNumber

B2BPurchaseOrderAcknowledgment/SupplierOrderNumber

Action

Note: When the AcknowledgmentCode is in the lineChange code list, this is set to CHANGE.

N/A

PurchaseOrderEntryLine

LineNumber

B2BPurchaseOrderAcknowledgment/Lines/LineNumber

Quantity

Note: Only positive numeric values will result in an update.

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/OrderQuantity

Price

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/UnitPriceAmount

ChangeReason

Note: If an AcknowledgmentReason isn't provided, then this will be set to Not Provided.

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentReason

Action

Note: When the AcknowledgmentCode is in the lineChange code list, this is set to CHANGE.

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentCode

PurchaseOrderEntryLine/PurchaseOrderEntrySchedule

Note: Schedule is autogenerated.

ScheduleNumber

Note: ScheduleNumber is autogenerated.

N/A

Quantity

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/OrderQuantity

ChangeReason

Note: If the AcknowledgmentReason isn't provided in the payload, then it will be set to Not Provided.

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentReason

PromisedDeliveryDate or PromisedShipDate

Note: If the PromisedDate is provided in the payload and the Buyer Managed Transport isn't selected on the order or if the PromisedDeliveryDate is provided in the payload, then the value is mapped to PromisedDeliveryDate. If the PromisedDate is provided and the Buyer Managed Transport check box is selected on the order, then the value is mapped to PromisedShipDate.

One of these must be provided in the payload:

  • B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/PromisedDate

  • B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/PromisedDeliveryDate

  • B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/PromisedShipDate

Action

Note: When the AcknowledgmentCode is in the lineChange code list, this is set to CHANGE.

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentCode

PurchaseOrderEntryLine/LineFlexfield

N/A

b2bPartNumberCorrection

Note: The SupplierItemNumber is mapped to this flexfield, if the LINECHANGE Acknowledgment contains SupplierItemNumber.

bB2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/SupplierItemNumber

b2bUOMChange

Note: The UnitofMeasureCode is mapped to this flexfield if the LINECHANGE Acknowledgment contains UnitOfMeasureCode.

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/UnitOfMeasureCode

HeaderFlexfield

b2bAckReviewRequired

Note: This flexfield is set to One or more lines have acknowledgment comments if the SupplierItemNumber or the UnitOfMeasureCode is provided in the acknowledgments when the AcknowledgmentCode is in the lineChange code list.

N/A

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 Price field-->
      <n1:SupplierItemNumber>009-009</n1:SupplierItemNumber><!--This value will be populated in the B2B Part Number Correction DFF-->
      <n1:OrderQuantity>8.0</n1:OrderQuantity><!--This value will be populated in the Quantity-->
      <n1:UnitOfMeasureCode>BX</n1:UnitOfMeasureCode><!--This value will be populated in the B2B UOM Change DFF-->
      <n1:PromisedDate>2025-11-17T09:30:47Z</n1:PromisedDate><!--This value will be populated in the Promised Delivery/Ship Date field under the Schedules-->
   </n1:Acknowledgments>
</n1:Lines>