Siųskite užsakymus ar laimėtus sandorius į Kunads

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).

Užsakymai

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}]
      }]}'

Laimėti sandoriai

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"
      }]}'

Zapier, Make ar n8n – be programavimo

  1. Kunads: Prijungimai → Užklausos ir CRM → API → Sukurti importo raktą. Nukopijuokite raktą (jis prasideda kimp_).
  2. Trigeris: jūsų CRM „sandoris laimėtas“ (arba „sandoris atnaujintas“ su filtru: būsena – laimėtas). Parduotuvei: „naujas apmokėtas užsakymas“.
  3. Veiksmas: Zapier „Webhooks by Zapier → POST“, Make „HTTP → Make a request“ arba n8n „HTTP Request“ mazgas, adresu https://app.kunads.ai/api/import?kind=deal. Užsakymams ?kind=deal nerašykite.
  4. Antraštė: Authorization: Bearer kimp_…. Turinys: JSON arba formos laukai, vienas sandoris per užklausą.
  5. Laukai: id (sandorio numeris), date (kada laimėtas), value (vertė), email (kliento) ir gclid ar fbclid, jei jūsų užklausos forma juos išsaugo.
  6. Išbandykite: Kunads atsako {"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ą.

Laukai

LaukasReikšmė
idprivalomaJūsų užsakymo ar sandorio numeris. Vėl atsiuntus tą patį id, įrašas atnaujinamas — grąžinimai, būsenos pokyčiai.
dateprivalomaKada apmokėta (užsakymai) ar laimėta (sandoriai). ISO 8601; pageidautina nurodyti laiko juostą.
valueprivalomaVertė, jei įmanoma, be PVM ir pristatymo — iš jos skaičiuojamas pelnas.
currencyISO kodas. Nenurodžius laikoma, kad tai jūsų paskyros valiuta.
statusViskas, kas turi cancel, refund, fail ar lost, išsaugoma kaip 0.
email / customerLeidžia Kunads skaičiuoti grįžtančius klientus. Saugoma tik tam.
gclid, fbclidApsilankymo paspaudimo id — patikimiausias ryšys tarp pardavimo ir konkrečios reklamos.
utm_source, utm_medium, utm_campaignKaip atėjo lankytojas, kai paspaudimo id nėra.
lead_dateSandoriai: kada atėjo užklausa, kad Kunads galėtų išmatuoti laiką iki sandorio.
itemsUžsakymai: eilutės su sku, name, quantity, price ir cost — kiekvieno produkto marža.

Verta žinoti