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. Only flexfields on the purchase order header and purchase order line are updated.

This table displays the data mapping for item substitution.

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 orderAccept or orderChange code list. It is used for processing

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

ChangeOrderInitiatingParty

Note: Set to SUPPLIER.

N/A

PurchaseOrderEntryLine

LineNumber

B2BPurchaseOrderAcknowledgment/Lines/LineNumber

ChangeReason

Note: If the AcknowledgmentReason isn't provided in the payload, then this is set to Not Provided.

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentReason

Action

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

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/AcknowledgmentCode

PurchaseOrderEntryLine/LineFlexfield

N/A

b2bSubstituteSupplierItemNum

Note: When the acknowledgment code value is in the lineItemChange code list, this SupplierItemNumber is mapped to this flexfield.

B2BPurchaseOrderAcknowledgment/Lines/Acknowledgments/SupplierItemNumber

HeaderFlexfield

b2bAckReviewRequired

Note: When the acknowledgment code value is in the lineItemChange code list, this flexfield is set to One or more lines have acknowledgment comments.

N/A

Sample Payload

Here's a sample payload for item substitution:

<n1:Lines>
   <n1:LineNumber>1</n1:LineNumber>
   <n1:SupplierItemNumber>594-379</n1:SupplierItemNumber>
   <n1:CustomerItemNumber>544-589</n1:CustomerItemNumber>
   <n1:OrderQuantity>10</n1:OrderQuantity>
   <n1:UnitOfMeasureCode>EA</n1:UnitOfMeasureCode>
   <n1:UnitPriceAmount>7</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>005-005</n1:SupplierItemNumber><!--This value will be populated in the B2B Substitute Supplier Item DFF-->
   </n1:Acknowledgments>
</n1:Lines>