Item Substitution

If the acknowledgment has an acknowledgment code value that's in the lineItemChange code list, the item number in the SupplierItemNumber field is processed as an item substitution. The descriptive flexfields on the PO header and PO line are updated. If a UnitPriceAmount is received in addition to the SupplierItemNumber, the price will be updated on the PO line.

This table displays the data mapping for item substitution.

Oracle-1-0-B2B-Purchase-Order-Acknowlegment-In-V2	changePurchaseOrder
B2BPurchaseOrderAcknowledgment/OrderNumber	OrderNumber
	SoldToLegalEntityId This is populated during processing.
B2BPurchaseOrderAcknowledgment/AcknowledgmentCode This value needs to be in the orderAccept or orderChange code list. It is used for processing.	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
N/A	ChangeOrderInitiatingParty Set to SUPPLIER.
	PurchaseOrderEntryLine
B2BPurchaseOrderAcknowledgment/Lines/LineNumber	LineNumber
B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentReason	ChangeReason If the AcknowledgmentReason isn't provided in the payload, then this is set to Not Provided.
B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentCode	Action When the AcknowledgmentCode value is in the lineItemChange code list, this is set to CHANGE.
B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/UnitPriceAmount	Price Only non negative decimal numbers are accepted.
	PurchaseOrderEntryLine/LineFlexfield
B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/SupplierItemNumber	b2bSubstituteSupplierItemNum When the acknowledgment code value is in the lineItemChange code list, the SupplierItemNumber is mapped to this descriptive flexfield.
	HeaderFlexfield
N/A	b2bAckReviewRequired When the acknowledgment code value is in the lineItemChange code list, this descriptive flexfield is set to One or more lines have acknowledgment comments.

Sample Payload

Here's a sample payload for item substitution:

<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>ITEMSUBSTITUTION</n1:AcknowledgmentCode>
            <n1:AcknowledgmentReason>Line 1-Item Substitution</n1:AcknowledgmentReason><!--This value will be populated in the Change Reason field-->
             <n1:SupplierItemNumber>456-005</n1:SupplierItemNumber><!--This value will be populated in the B2B Substitute Supplier Item descriptive flexfield-->
             <n1:UnitPriceAmount>6</n1:UnitPriceAmount><!--This value will be populated in the Price field-->
   </n1:Acknowledgments>
</n1:Lines>