Troubleshooting product visibility in CPQ Cart

Troubleshooting product visibility in CPQ Cart

Context: producten zijn niet zichtbaar in de CPQ cart

Je hebt een CPQ solution gebouwd en je hebt je commerciële producten geconfigureerd binnen de EPC. Maar als je de cart bekijkt zijn er geen producten zichtbaar of beschikbaar. Wat nu? Er kunnen een aantal dingen aan de hand zijn, waardoor de producten niet zichtbaar zijn in de CPQ cart.

Het probleem: waar kan het aan liggen?

Het vakje ‘Orderable’ is voor dit product niet gemarkeerd als ’true’.

De oplossing:

• Ga naar je Vlocity Product Designer
• Zoek je product op 
• Ga naar General Properties 
• Check of het vakje Orderable is aangeklikt
• Zo niet, vink het vakje aan en sla je aanpassing op. 

De ‘Product Status’ is niet actief

De oplossing:

• Ga naar je Vlocity Product Designer.
• Zoek je product op. 
• Ga naar General Properties.
• Check of het vakje Status op Active staat.
• Zo niet, vink het vakje Active aan in de keuzelijst en sla je aanpassing op.

Het vakje ‘Active’ is niet geselecteerd voor dit product

De oplossing:

• Ga naar je Vlocity Product Designer.
• Zoek je product op.
• Kijk onder Effectivity of  het vakje Active is aangevinkt.
• Zo niet, vink het vakje Active aan en sla je aanpassing op.

Het product heeft een verkeerde verkoopdatum

De oplossing:

Let op: de producten binnen de EPC hebben een begin- en eind verkoop datum.

• Ga naar je Vlocity Product Designer.
• Zoek je product op.
• Kijk onder Effectivity of het vakje Selling Start Date leeg is, of dat de datum in het verleden ligt.
• Zo niet, maak het vakje leef of selecteer een datum die in het verleden ligt. 
• Hetzelfde geld voor de einddatum. Zorg dat de datum in de toekomst ligt als dit vakje is ingevuld.
• Sla je aanpassingen op.   

Het product heeft een Context Rule die het product verbergt

De oplossing:

• Ga naar je Vlocity Product Designer.
• Zoek je product op. 
• Ga door alle Context Rules heen; klik op de details van de Rules van het (oude) Product Console. Gebruik het oude Product Console, want de nieuwe Product Designer laat soms niet alle Rules goed zien. 
• Check alle Conditions, de makkelijkste manier om te verifiëren of de context rule het probleem is, is om de rule tijdelijk te verwijderen. Als het product dan verschijnt, weet je dat je even de tijd moet nemen om door de context rules heen te spitten. 
• Je kunt ook de context rules uitzetten met de CPQ Configuration setting: ContextRulesEnabled.

Er staat geen prijs voor dit product in de prijslijst

De oplossing:

Let op: Een product zonder prijs is niet zichtbaar in de CPQ cart. 

• Ga naar Vlocity Product Designer.
• Zoek het product op. 
• Check of er voor dat product waarden zijn ingevuld onder de “pricing” tab. 
• Zorg dat er altijd een waarde is ingevuld, zelfs al is dit nul. Dit geld ook als je een setup hebt met attribute pricing of dergelijke.

Er zijn onvoldoende Maintenance jobs uitgevoerd

De oplossing:

We raden je aan altijd een Maintenance job uit te voeren nadat je een product configuratie hebt aangepast. Dan weet je zeker dat de product cache en de product hierarchy goed zijn afgesteld staan voor gebruik in de CPQ Cart.

• Ga naar de app launcher en zoek Vlocity CMT Administration op.
• Ga naar “Maintenance Jobs” en voer de volgende taken uit in deze volgorde:

• 1. PRODUCT HIERARCHY MAINTENANCE
  2. CLEAR MANAGED PLATFORM CACHE
  3. REFRESH PLATFORM CACHE (FULL)

Zorg dat iedere taak is afgerond voor je een nieuwe start. Dit kan soms een tijdje duren omdat ze als Async jobs worden uitgevoerd. De voortgang kan ook worden gecheckt in Setup met keyword Apex Jobs.

Als je merkt dat je deze taken vaak moet doen, af als je ze wilt integreren in je development of je CI/CD workflow, kan je ze automatiseren en als Apex scripts runnen:

// Run jobs for hierarchy and cache

for (Pricebook2 pricebook : [SELECT Id FROM Pricebook2]) {

 //https://docs.vlocity.com/en/Refresh-Platform-Cache.html

 vlocity_cmt.CMTAdminJobService.startProductHierarchyMaintenanceJob(pricebook.Id);

}

Je kunt ze zelfs als post-Deploy stap runnen in de Vlocity Build Tool: (https://github.com/vlocityinc/vlocity_build)

Tot slot

Hopelijk helpen deze tips je bij het configureren van je EPC en CPQ. Ik weet dat deze problemen echt lastig kunnen zijn om op te lossen, maar je producten zijn nu in ieder geval weer zichtbaar in CPQ cart.

Ik post regelmatig Technische Deep Dives. Abonneer je vandaag en mis geen enkele CaseNine Technical DeepDive aflevering.