Cova Promotions V2 Integration with Buddi

⚠️ ATTENTION COVA USERS: Promotions (Classic) Ended August 6, 2025 ⚠️

All Buddi x Cova retailers have now been migrated to the New Hub Promotions (V2).

'Dollar Amount Off' and 'Percentage Off' discounts created in the New Hub Promotions will automatically sync into Buddi.

If you encounter sync issues or notice discrepancies, please contact us.

For help setting up discounts in Promotions Hub, please contact Cova directly.

Overview

This document explains how Cova's new Promotions V2 feature integrates with Buddi. The primary goal of this integration is to streamline promotion management for retailers by automatically syncing promotions created in Cova directly into the Buddi platform. This eliminates the need to duplicate promotion setup across both systems.
 

How it Works

When a retailer creates a promotion using Cova's Promotions Hub (their V2 system), Buddi will automatically detect and display that promotion to customers.

• Automatic Sync: Promotions created, updated, or deleted in Cova Promotions Hub will be reflected in Buddi without manual intervention. A promotion may not appear immediately as menus sync at a predetermined time interval (e.g. 15 minutes, etc). You can either force sync your menu or wait until the next sync cycle completes.
   
• No Duplication: Retailers only need to manage their promotions within the Cova Promotions Hub.
   
• If a product is discounted with two different promotions we will only display the most recently created promotion.
   

Supported Promotion Types

Initially, Buddi's integration with Cova Promotions V2 supports the most common discount types:

• Dollar Amount Off ($ Off): e.g., $5 off a specific product or category
• Percentage Off (% Off): e.g., 10% off all edibles

Important: At this time, Bundling (e.g., buy product A + product B for a special price) and BOGO (Buy One, Get One) promotions created in Cova Promotions V2 are not supported and will not appear in Buddi.

Important Considerations

• V1 vs. V2 Exclusivity: Retailers must use either Cova's older Promotions system (V1) or the new Promotions Hub (V2). They cannot use both simultaneously for Buddi integration.
  
  
• Date & Time Restrictions: Buddi fully respects the start and end dates/times set for promotions in Cova.
   
• Time Zone Conversion: Buddi automatically converts the promotion times from UTC (as provided by Cova) to the retailer's local time zone. This ensures promotions start and end accurately according to the store's operating hours.
  
  
• Day of Week Restrictions: If a promotion in Cova is configured to run only on specific days (e.g., "Weekend Sale" active only Saturday & Sunday), Buddi will enforce this and only show the promotion on those designated days.
  
  
• Promotions Prioritized by Date: If a product is part of two different promotions, the most recently updated promotion will take precedence.
  
  
• Product Sale Prices Take Priority: Individual products where a sale price was applied through the catalog take priority over promotional pricing. 
  
  
• Large or Complex Classification Structures: If your Cova Product Tree contains a large number of categories or multiple nested sub-categories (aka 'Classifications'), they may need to be mapped in our system. This ensures promotions will capture all applicable products. Please send a category mapping request to support@buddi.io.
  

• Selecting Classifications in Cova: When creating a promotion using Classification as the 'Criteria', select the most specific sub-categories relevant to the promotion rather than only the broad parent category (aka a folder with a specific group of Classifications).
  • In some setups, choosing only a parent category may exclude certain sub-categories from receiving the discount.
  • e.g. If the criteria is to include all flower products, you would select all specific Classifications in the broad category, not the folder itself:
    
  • If you encounter issues with having some products show applicable discounts, please reach out to our support team for further assistance. It may have to do with how Classifications are syncing into Buddi.

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