Parduotuvei savo platformoje ar bet kuriai CRM. Maždaug valanda darbo: viena HTTPS užklausa, kai užsakymas apmokamas ar sandoris laimimas. Raktą suteikia paskyros savininkas (Kunads → Prisijungimai → Kitos parduotuvės arba Užklausos ir CRM → API).
curl -X POST https://app.kunads.ai/api/import \
-H "Authorization: Bearer kimp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"orders": [{
"id": "1001",
"date": "2026-10-05T14:30:00+03:00",
"value": 59.80,
"currency": "EUR",
"status": "paid",
"email": "buyer@example.com",
"gclid": "Cj0KCQjw…",
"utm_source": "google", "utm_medium": "cpc", "utm_campaign": "brand",
"items": [{"sku": "PB-250", "name": "Peanut butter 250 g", "quantity": 2, "price": 13.80, "cost": 5.60}]
}]}'curl -X POST https://app.kunads.ai/api/import \
-H "Authorization: Bearer kimp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"deals": [{
"id": "D-501",
"date": "2026-10-03",
"value": 4500,
"lead_date": "2026-09-12",
"email": "client@example.com",
"fbclid": "IwAR1x…",
"utm_campaign": "leadform-autumn"
}]}'https://app.kunads.ai/api/import?kind=deal. Užsakymams ?kind=deal nerašykite.Authorization: Bearer kimp_…. Turinys: JSON arba formos laukai, vienas sandoris per užklausą.{"ok": true, …}. Sandoris paskyroje matomas tą pačią dieną.El. paštas arba paspaudimo ID leidžia Kunads grąžinti kiekvieną laimėtą sandorį į Meta ir Google – jos išmoksta, kas iš tikrųjų perka, o ne tik kas užpildo formą.
| Laukas | Reikšmė | |
|---|---|---|
id | privaloma | Jūsų užsakymo ar sandorio numeris. Vėl atsiuntus tą patį id, įrašas atnaujinamas — grąžinimai, būsenos pokyčiai. |
date | privaloma | Kada apmokėta (užsakymai) ar laimėta (sandoriai). ISO 8601; pageidautina nurodyti laiko juostą. |
value | privaloma | Vertė, jei įmanoma, be PVM ir pristatymo — iš jos skaičiuojamas pelnas. |
currency | ISO kodas. Nenurodžius laikoma, kad tai jūsų paskyros valiuta. | |
status | Viskas, kas turi cancel, refund, fail ar lost, išsaugoma kaip 0. | |
email / customer | Leidžia Kunads skaičiuoti grįžtančius klientus. Saugoma tik tam. | |
gclid, fbclid | Apsilankymo paspaudimo id — patikimiausias ryšys tarp pardavimo ir konkrečios reklamos. | |
utm_source, utm_medium, utm_campaign | Kaip atėjo lankytojas, kai paspaudimo id nėra. | |
lead_date | Sandoriai: kada atėjo užklausa, kad Kunads galėtų išmatuoti laiką iki sandorio. | |
items | Užsakymai: eilutės su sku, name, quantity, price ir cost — kiekvieno produkto marža. |
Content-Type: text/csv ir antraštės eilute (?kind=deal sandoriams). Šablonai: užsakymai, sandoriai.{"ok": true, "stored": 120, "skipped": 0}. Neteisingam raktui grąžinama 401; eilutės be id, date ar value praleidžiamos ir suskaičiuojamos.