Developer portal

Integration för anslutna säljare

Här finns format, fält och API-exempel för butiker som vill skicka produkter, priser, lagerstatus och passform till Bildelsjakten.

Pull feed

Vi hämtar er JSON- eller CSV-feed via en publik HTTPS-länk.

Push API

Ni kan skicka lager och priser direkt till vårt import-API.

Uppdatering

Anslutna feeds hämtas automatiskt dagligen och kan uppdateras via API däremellan.

Grundkrav

Bäst matchning får vi när feeden innehåller stabil produktidentitet. EAN/GTIN, MPN och OE-nummer är viktigare än själva produktnamnet. Pull-feeds behandlas som hela sortimentet, så produkter som saknas i nästa feed deaktiveras automatiskt.

Publik HTTPS-länk till JSON- eller CSV-feed

Produktnamn, pris, produktlänk och kategori

Stabilt sellerSku/id för varje erbjudande

EAN/GTIN, MPN, artikelnummer eller OE-nummer när det finns

Skick, lagerstatus, fraktpris och produktbild

Bilmodell/passform när feeden har sådan data

JSON-feed

JSON-feeden kan vara ett objekt med `items` eller en ren array med produkter.

{
  "items": [
    {
      "title": "Bromsskiva Bosch fram",
      "category": "Bromsar",
      "price": 799,
      "url": "https://butik.example/produkt/123",
      "image": "https://butik.example/produkt/123.jpg",
      "brand": "Bosch",
      "sellerSku": "BOS-123",
      "condition": "new",
      "availability": "in_stock",
      "ean": "4047024777777",
      "mpn": "0986479123",
      "oemNumbers": ["1K0615301AA"],
      "make": "Volkswagen",
      "model": "Golf",
      "yearFrom": 2008,
      "yearTo": 2013,
      "shipping": 69
    }
  ]
}

CSV-feed och Google Merchant

CSV-feeds kan använda vanliga Google Merchant-fält som `id`, `title`, `product_type`, `price`, `link`, `image_link`, `gtin`, `mpn` och `availability`.

id,title,product_type,price,link,image_link,brand,gtin,mpn,condition,availability,shipping,oem_numbers,make,model
BOS-123,Bromsskiva Bosch fram,Bromsar,799 SEK,https://butik.example/produkt/123,https://butik.example/produkt/123.jpg,Bosch,4047024777777,0986479123,new,in_stock,69 SEK,1K0615301AA,Volkswagen,Golf

Push API

Anslutna säljare får en API-nyckel av Bildelsjakten. Nyckeln ska skickas i JSON-body tillsammans med produkterna.

curl -X POST https://bildelsjakten.com/api/merchant/import \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "DIN_API_NYCKEL",
    "items": [
      {
        "title": "Bromsskiva Bosch fram",
        "category": "Bromsar",
        "price": 799,
        "url": "https://butik.example/produkt/123",
        "sellerSku": "BOS-123",
        "condition": "new",
        "availability": "in_stock"
      }
    ]
  }'

Fältlista

Fält	CSV-alias	Användning
title	title, name	Produktnamn som visas i sökresultatet.
category	category, product_type	Butikens kategori, till exempel Bromsar eller Filter.
price	price, sale_price	Pris i SEK. Valuta/text städas bort vid CSV-import.
url	url, link	Direktlänk till produktsidan hos butiken.
image	image, image_link	Produktbild via HTTPS.
sellerSku	sku, id, seller_sku	Butikens egna stabila artikel-ID.
condition	condition, item_condition	new, used eller refurbished.
ean / gtin	ean, gtin	EAN/GTIN används för att matcha samma del mellan butiker.
mpn / partNumber	mpn, part_number	Tillverkarens artikelnummer eller eftermarknadsnummer.
oemNumbers	oem, oe_numbers	OE/OEM-nummer separerade med komma, semikolon eller pipe.
availability	availability, in_stock	in_stock, out_of_stock, preorder eller backorder.
shipping	shipping, shipping_price	Fraktpris i SEK.
make / model	make, model	Fordonsmärke och modell för passformsfilter.

Redo att ansluta?

Skicka feed-länk eller teknisk kontaktperson så hjälper vi till att validera formatet.

Kontakta integration