1. Configuring and Managing B2B Messaging
  2. Item Substitution

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>