Setup stages for the XML product feed:
1) Input your account information into the Account settings page:
Onbuy API Keys, Frequency and Stay in winning time
2) Input your feed setup into the Feed settings page:
Feed url (See our support document below on setting up the Feed XML file)
Feed frequency – how often you would like to update the data from the feed, normally once per day
Clear stock – Before updating the stock, prices and products would you like to set the onbuy listings to 0 stock? This will be helpful if products do not appear in the feed, they will be marked out of stock.
Mode- Set if you would like the price/quantities updated in Basic Mode, or use Advanced mode to create new product matches in the Onbuy Catalog. Also tick “Create Listings” to enable this
Minimum and maximum onbuy price % from feed – From the price shown in the feed what should the system set as the maximum and the minimum for repricing. Example Minimum 90% of the price in the feed and Maximum at 105% of the price in the feed.
Retry new listing creation frequency – How often should the system try to recreate the new listings. Normally set at 1 day or 1 week.
Important note: You will need to open a support ticket to request Onbuy approve your permissions to upload new products directly to their API. They will perform a quality check on the products you upload initially through the system so we would suggest loading a sample of 5-10 products to begin with. Ensure they have comprehensive product information and images to have the best chance of passing the checks.
3) Categories mapping
This will show a list of the categories found in your XML feed file.
Download the Unmapped Categories from the CSV.
Find category matches from the Onbuy Allowed Categories Tabs. Insert the Onbuy Category name (Not Category ID) into Column B of the template.
Save and upload using the “Upload CSV” button at the top
The results of the import will be shown on the page, if errors please fix and upload again
4) Once this is complete you are ready to activate the feed. Go to the Manage products tab and select Begin Sync.
5) To check on the status of the feed upload and any errors, visit Manage Products and click Download Last Feed Status. We suggest allowing an hour for Onbuy to provide a valid response to the initial product upload, the file will just shown “Unknown” or “No Data” until it receives a response from Onbuy.
Feed setup: Please find below the step by step process for setting up the XML feed with the CTX feed plugin for WordPress/WooCommerce:
The format for the XML feed should include the fields below, using the Field title for the tag:
| Casual Field Name | Field title for XML Tags (Priority Order) | Required |
| SKU | g:sku, g:mpn | Yes (Group) |
| UPC | g:gtin, g:upc, g:ean | Yes (Group) |
| Product Name | g:title | Yes |
| Title | g:title | Yes |
| Description | g:description | Yes |
| Summary Points | Derived from g:description | Yes |
| Price | g:price | Yes |
| Sale Price | g:sale_price | No |
| Quantity | g:quantity | Yes |
| Availability | g:availability | Yes |
| Brand | g:brand | Yes |
| Condition | g:condition | Yes |
| Product URL | link | Yes |
| Default Image | g:image_link | Yes |
| Additional Images | g:additional_image_link | No |
| Category | g:product_type | Yes |
