Data Feeds

Modified on Tue, 26 Nov at 1:37 PM

The Feeds module allows the creation of multiple data feeds, making the current information accessible to external services or users. The information in the Feeds is always updated according to your current data state. This makes it useful for distributing the data to all your partners and channels. Each feed does not add to sales channel count in your subscription plan.


Feed types

  • Products Feeds - extracts products data 
  • Orders Feeds - extracts orders data 
  • Gemstones Feeds - extracts gemstones data


Some examples of product feed use are: 

  • Social channels (Facebook Shopping, Pinterest Products), Google Shopping
  • Distributors and resellers
  • External sales channels without direct integration with Valigara (Macy's, Squarespace, Catawiki, Amazon Handmade, Pinterest, etc.).
  • Sending Orders into external accounting/invoicing/ERP system
  • Distributing Gemstones to Valigara users
  • Learn more applications by asking our Team


In this article


Setting up the feed


To create the feed

  • Go to Channels -> Feeds
  • Click Add new feed
  • Select the Feed type



Basic Feed settings 

  • Feed name - an easily identifiable name for the specific feed.
  • CSV filename - filename. Supported formats: CSV, TSV or XML (RSS/ATOM).
  • The feed content:
    • System Fields - list of system fields and fixed content to include in the feed
      • Add Field - select any Valigara product/model/gemstone field
      • Add Free Field - specify any fixed text/value(s). This text will identically appear in all feed lines
    • Field name in file - name the system field in the feed file according to the destination requirements. 
    • Language - select the Valigara language to use in the feed


Examples

- System field: Retail price -> Field name in the file: price - takes the existing Retail prices as price for Facebook Shopping

- Free Field condition with New value - use free fields for attributes required by Facebook if the specific information is not available in Valigara. New will be included as a default value for all feed lines.



Advanced Feed Settings

  • Enable Advanced mode using the toggle in top right corner for extra parameters:
  • Columns titles - whether to add a header row.
  • CSV delimiter - symbol separating feed's data fields. "," by default, but "| @ # % &" and many other can be used.
  • CSV enclosure - a character used to enclose the field value. 
  • CSV escape char - By default, the escape character is a " (double quote) for CSV-formatted files. 



Add content to the feed


On the Feeds page, click the number under the "Count" column next to relevant feed



  • Clickto open a search page.
  • Products are added to the feed file in two modes. 
    • Static
      • Add specific products to the list.
      • Examples: "Best Sellers", "Spring 2020" , "Popular Rings".
    • Dynamic
      • Define conditions for the products matching to the feed.
      • Valigara will display the updated list of products matching to the feed, each time the feed is accessed.
      • Examples: "Rings $100-$200" , "Ruby jewelry" , "On Etsy.
  • To switch between the modes click "Change mode to" at the top of the pop-up:
    1. Static

      • Use Advanced searchfor additional filtering

      • Check / Uncheck all- selects/unselects all products on page

      • Use "Show X entries" on the right side to see more products

      • Select on all pages - selects all products on all pages

      • Select relevant products and click "Add"

    2. Dynamic

      • Define conditions using filters

      • Switch to Advanced search modefor additional filtering

      • Click "Save products filter parameters"

Remove products from the feed


  1. Static mode
    • On the Feeds page, click on the number under "Products count" next to relevant feed.
      • Search by Type, Collection, Metal or Gemstone to filter specific products
      • To delete all products on the page, use checkbox under "Feeds" to select all and click "Delete Selected"
      • To delete multiple products, select them and click "Delete Selected"
      • To delete a specific single product, click the delete "X" button on the right side
  2. Dynamic mode - Change the conditions to keep only the relevant products/order present in the feed.



More on how to set up, test and troubleshoot


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article