CashbouCashbou

Product import

Technical requirements for importing products from external shops

Minimum technical requirements for connecting a merchant e-shop to the Cashbou marketplace (XML clickout mode).

Integration model (MVP)

The buyer clicks through from the marketplace to the merchant's shop and completes the order with the seller. Cashbou operates the marketplace and awards cashback after conversion is confirmed.

  • Checkout: merchant clickout (the seller is the merchant, not Cashbou).
  • Listing fee (1 CP per day per active advertised product): temporarily disabled until more buyers are on the marketplace.
  • Cashback (XML clickout): 5% (credited after confirmed order).
  • CP settlement: once daily on the next day (T+1).

XML feed requirements

  • Feed URL over HTTP/HTTPS (no interactive login).
  • Product ID, product name, product URL, image.
  • Valid price > 0 and currency.
  • Availability (in-stock / out-of-stock or equivalent).
  • Product category and ideally EAN/GTIN for deduplication.

Minimum technical checklist

Required fields (products are not published without them)

  • Product ID (ITEM_ID / PRODUCT_ID / id).
  • Product name (PRODUCTNAME / NAME / name).
  • Product URL (URL / PRODUCT_URL / link) with HTTP/HTTPS.
  • Main image (IMGURL / IMAGE / image_link).
  • Price incl. VAT (PRICE_VAT / PRICE / price) greater than 0.
  • Availability (AVAILABILITY / STOCK / availability).
  • Category (CATEGORYTEXT / CATEGORY / product_type).

Recommended fields (higher catalogue quality)

  • EAN / GTIN.
  • Brand (BRAND / MANUFACTURER).
  • Description (DESCRIPTION).
  • Alternative images (IMGURL_ALTERNATIVE).
  • Variant parameters (PARAM).

Import validation

A product is not published if basic feed rules fail.

  • Missing required field (ID, name, URL, image, price, category).
  • Invalid price (zero, negative, or non-numeric).
  • Invalid URL (not HTTP/HTTPS).
  • Category not mapped to internal taxonomy.
  • Out-of-stock (product stays inactive).

Field alias mapping (MVP)

  • id: ITEM_ID | PRODUCT_ID | id
  • name: PRODUCTNAME | NAME | name
  • price: PRICE_VAT | PRICE | price
  • url: URL | PRODUCT_URL | link
  • image: IMGURL | IMAGE | image_link
  • availability: AVAILABILITY | STOCK | availability
  • category: CATEGORYTEXT | CATEGORY | product_type
  • ean: EAN | GTIN | UPC

Conversion confirmation for cashback

A click alone does not create cashback. Cashback is credited after the merchant confirms the order (S2S postback or order export).

  • Required: clickId, orderId, status, orderTotal, currency, occurredAt.
  • Recommended statuses: created, paid/completed, cancelled/refunded.
  • Idempotency: orderId + status must not create duplicate credit.

Import bridge vs. Heureka

Partially similar for the product catalogue (XML product feed). Cashbou additionally handles CP economics, cashback workflow, and daily CP billing for active products.

In short: the product feed can work like Heureka, but operations (cashback, attribution, CP settlement, CP blocks) are Cashbou-specific.

Quick checklist: Shoptet / WooCommerce

Tip: If the merchant has no XML feed, they can use Add product to Marketplace (manual) in the profile and enter products with up to 5 photos.

Shoptet

  1. Enable an XML product feed (Heureka / comparison shopping) in the shop admin.
  2. Copy the public feed URL (HTTPS preferred).
  3. In Cashbou open Merchant profile → Marketplace feed onboarding.
  4. Set Feed URL, choose Heureka XML, click Test feed.
  5. After a successful test, Save configuration and Run import now.

WooCommerce

  1. Install a plugin for XML product export (Heureka/Google feed or custom XML).
  2. Ensure the feed includes ID, name, URL, image, price, availability, category.
  3. Publish the feed at a URL without interactive login.
  4. In Cashbou set Feed URL and feed type (Heureka XML or Custom XML).
  5. Click Test feed, then Save configuration and Run import now.