Cenu Depo

Ühenda oma hinnad Cenu Depoga

Sinu hindu ja soodustusi näevad ostjad, kes juba võrdlevad hindu 25 poes. Andmeid saad jagada voo või API kaudu ja ühendamine on tasuta.

25poodi rakenduses
87 000+hinnad uuenevad igal ööl
15 000+toodet, mida ostjad jälgivad

Mida sinu pood saab

Ühendamine on tasuta. Sinu hinnad ilmuvad just seal, kus ostjad otsustavad, millisesse poodi minna.

Koht võrdluses

Sinu hinnad ilmuvad otsingus, tootelehel, ostunimekirjas ja odavaimate poodide nimekirjas, suurte kettide kõrval.

Ostjad saavad teada sinu soodustustest

Kui toode, mida ostja jälgib, sinu poes odavneb, saab ta telefoni teavituse.

Tõelised allahindlused paistavad silma

Võrdleme allahindlust madalaima hinnaga 30 päeva jooksul enne soodustust. Tõeline allahindlus saab rohelise märgi ja ostjad näevad seda kohe.

Kuidas oma andmed ühendada

Viise on kaks. Mõlemal juhul tuvastame tooted vöötkoodi (EAN) järgi, nii et sinu hind läheb õigele tootele.

Andmevoog Lihtsaim

Avalda oma tootenimekiri JSON-, CSV- või XML-vormingus mõnel veebiaadressil. Loeme seda igal ööl ja uuendame hindu. Programmeerimist pole vaja, kui sinu e-pood juba loob sellise faili (näiteks Google Shoppingu voo).

  • Ükskõik milline kolmest vormingust
  • Uuendatakse igal ööl
  • Juurdepääsu saab kaitsta võtmega

API Reaalajas

Saada hinnad kohe, kui need muutuvad: HTTPS POST-päring JSON-vormingus. Kasulik, kui hinnad muutuvad päeva jooksul või soodustus algab kindlal kellaajal. Isikliku võtme anname kokkuleppel.

  • Muudatused rakenduses mõne minutiga
  • Saata võib ainult muutunud hinnad
  • Iga rea olek vastuses

Andmevorming ja API

Arendajatele: väljad, näide, päring ja vastused.

Väljad

eankohustuslikVöötkood (EAN-13, EAN-8 või GTIN). Selle järgi seotakse toode kataloogiga.
namekohustuslikToote nimi nii, nagu ostjad seda näevad.
pricekohustuslikTavahind eurodes koos käibemaksuga, näiteks 1.38.
sale_priceSoodushind, kui see on olemas.
sale_start, sale_endSoodustuse esimene ja viimane päev, näiteks 2026-11-08.
card_onlytrue, kui soodushind kehtib ainult kliendikaardiga.
size, unitPakendi suurus ja ühik (g, kg, ml, l, gab), et arvutada kilogrammi või liitri hind.
online_onlytrue, kui hind kehtib ainult e-poes.
url, image_urlLink tootele sinu e-poes ja selle pilt.

Näide

// Üks kirje.
// Voos või API päringus: massiivis "items".
{
  "ean": "4750000000000",
  "name": "Biezpiens 9% 170 g",
  "price": 1.38,
  "sale_price": 0.99,
  "sale_start": "2026-11-02",
  "sale_end": "2026-11-08",
  "card_only": false,
  "size": 170,
  "unit": "g",
  "url": "https://sinu-pood.lv/biezpiens-170g"
}

Pole formaadis kindel? Saada meile fail või link, mis sul juba on: enamasti saame selle lugeda sellisena, nagu see on. Voos sobivad ka Google Shoppingu väljad (gtin, title, sale_price_effective_date).

API päring

POSThttps://cenudepo.lv/api/partners/v1/prices/
Võti päises Authorization: BearerKuni 5000 kirjet (10 MB) päringu kohtaKuni 30 päringut minutis

Päring ja vastus

curl -X POST https://cenudepo.lv/api/partners/v1/prices/ \
  -H "Authorization: Bearer cdp_teie_voti" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"ean": "4750000000000",
       "name": "Biezpiens 9% 170 g", "price": 1.38}]}'

// Vastus: igal kirjel on oma olek
{
  "ok": true,
  "mode": "live",
  "counts": { "received": 1, "applied": 1,
              "unmatched": 0, "invalid": 0 },
  "items": [{ "ean": "4750000000000",
              "status": "applied" }]
}

Olekud vastuses

appliedHind on salvestatud ja näha rakenduses.
unchangedHind oli juba sama; märkisime, et see kehtib endiselt.
scheduledSoodustus algab hiljem: praegu on näha tavahind ja soodushind hakkab kehtima kuupäeval sale_start.
stagedÜlevaatuse etapp: hind on salvestatud ja seotud ning ilmub rakendusse pärast ülevaatust.
unmatchedSeda EAN-i kataloogis veel pole. Kirje on salvestatud ja hind ilmub kohe, kui toode lisatakse.
invalidKirjes on viga; põhjus on väljal message.

GET https://cenudepo.lv/api/partners/v1/status/ sama võtmega näitab sinu andmete kokkuvõtet, viimaseid päringuid ja EAN-koode, mida kataloogis veel pole.

Esimesest e-kirjast hindadeni rakenduses

  1. Võta ühendustRäägi meile oma poest ja sellest, kuidas sul on kõige lihtsam andmeid jagada.
  2. NäidisSaada voo link või mõned kirjed. API jaoks saad võtme.
  3. ÜlevaatusAlguses andmeid ainult kontrollitakse: seome tooted EAN-i järgi ja saadame sulle aruande selle kohta, mis leiti ja mida tuleb täpsustada.
  4. Hinnad rakendusesSinu pood ilmub võrdlusse ja hinnad uuenevad iseenesest.

Korduma kippuvad küsimused

Kas ühendamine maksab midagi?

Ei. Sinu hindade lisamine võrdlusse on tasuta.

Miks on vaja EAN-vöötkoodi?

Vöötkood tuvastab sama toote igas poes. Ilma selleta ei saa sinu hinda teiste poodide hindadega usaldusväärselt võrrelda.

Kui tihti hindu uuendatakse?

Loeme andmevoogu igal ööl. API kaudu ilmuvad muudatused rakendusse mõne minuti jooksul.

Mis siis, kui hind rakenduses on vale?

Kirjuta meile aadressil azsoftwarehub@gmail.com ja me parandame selle. Ühendatud poodide hinnad tulevad otse sinu andmetest, nii et vigu on vähem.

Ühenda oma pood

Kirjuta meile ja lepime kokku kõige mugavama viisi andmete jagamiseks.