Technical Reference: Cova Promotions API (Developer Docs)

The following information is provided as a technical reference for Cova and Buddi integration support. Retailers do not need this information to configure promotions.

Technical Details (API Information)

For informational purposes, Buddi fetches promotion data from Cova using a specific API endpoint structure.

• Base URL Structure:

  https://api.covasoft.net/Promotions/v1/Companies/{CompanyID}/ConditionCapabilities/{ConditionBits}/PromotionTypeCapabilities/{PromotionBits}/Promotions
  
  

• {CompanyID}: The unique identifier for the retailer's company in Cova.
  
  

• {ConditionBits} (Static Value: 16496): This tells Cova which promotion conditions Buddi can understand and support. The value 16496 represents a combination of supported conditions like product classifications, catalog IDs, etc. Buddi uses this static value to filter for compatible promotions.
  
  

• {PromotionBits} (Static Value: 1536): This tells Cova which promotion types Buddi supports. The value 1536 represents the combination of "Dollar Off" (512) and "Percentage Off" (1024). Buddi uses this static value to fetch only these specific types of promotions.
  
  

• Example Full URL:

  https://api.covasoft.net/Promotions/v1/Companies/YOUR_COMPANY_ID/ConditionCapabilities/16496/PromotionTypeCapabilities/1536/Promotions

Resources

• Cova Promotions API Documentation (PDF): https://api.covasoft.net/Content/pdf/Promotions.pdf (Examples at the end may be helpful)

• Cova Promotions API Reference: https://api.covasoft.net/Documentation/Api/GET-v1-Companies-companyId-ConditionCapabilities-condBits-PromotionTypeCapabilities-proBits-Promotions