Summary:
This troubleshooting guide helps associates quickly identify and resolve common issues related to the VMF Engine and Configurator in Xvantage for Associates. It outlines typical problems—such as missing VMF fields, order holds, and configuration mismatches—and provides clear steps to validate configurations, ensure correct data setup, and restore smooth quote and order processing.
Issue 1: VMFs do not appear on VRI page
Resolution:
Verify that the correct vendor, VPN, category, or program exists in the Xvantage for Associates vendor configuration file.
Confirm that the correct country filter is selected.
Make sure the user is logged in with the correct persona.
If the vendor is a stock type (S-Type) vendor, verify that the stock vendor.
VMF fields are enabled in the configuration file.
Issue 2: Optional / Mandatory Mismatch in IMPulse
Resolution:
Verify that the field is listed in the VMF configuration file with the Field Required toggle set up correctly.
Confirm the correct setting (mandatory or optional) is attached to the persona (Associate, Reseller, etc.).
Issue 3: Order Stuck on VMF Hold
Resolution:
Open the Order Status dashboard in X4A, locate the Action required status, and submit the missing data.
Verify the reseller received the email notification requesting the missing data.
Confirm that the VMF Engine and IMPulse validated the missing data and updated the change correctly.
Issue 4: Program VMFs Not Triggering
Resolution:
Confirm that the deal/program ID exists in GDE and is associated with a sub vendor.
Verify the program-level VMFs appear in a configuration file in the engine.
Issue 5: VMF fields appear during order checkout, but not in quotes
Resolution:
Confirm that the VMF fields are set up for quotes in the VMF configuration file.
Verify that the Vendor Program/Category/VPN matches the items in the quote.
Check that the Deal ID is present for bid-level fields.
Issue 5: Order remains on VR hold after submitting VRI in OST
Resolution:
Refresh OST.
Check if the Order Modify confirmation flag arrived from IMPulse.
Open OEM and search for any review reasons attached to the order.
For EDI/XEDI orders, confirm the update reached the VMF Engine.