Geliştiriciler için

İşlemde API

İşlerinizi ve müşterilerinizi kendi yazılımınıza, muhasebe ya da e-ticaret sisteminize bağlayın. Okuyun, iş ve müşteri açın, durum değiştirin, ödeme kaydedin; olup biteni webhook'la anında alın.

Hemen başlayın Örneklere bakın

Adres: /api/v1
Kimlik: x-api-key
Sınır: Dakikada 600
Paket: İşletme

İstek

GET /api/v1/jobs/1047

x-api-key: isl_••••••••

Cevap200

{  "number": 1047,  "status": { "label": "Teslime hazır" },  "customer": { "name": "Nur Özkan" },  "trackingUrl": "…/t/U7WX42A8"}

Kendi sisteminize,
birkaç satırda.

Başlarken

Panelde Ayarlar → API sayfasından bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir; güvenli bir yerde saklayın.
Anahtarı sunucunuzda ISLEMDE_API_KEY ortam değişkenine koyun.
Her isteğe x-api-key başlığıyla ekleyin. İlk isteğiniz, teslime hazır işler:

curl "https://islemde.app/api/v1/jobs?status=ready" \
  -H "x-api-key: $ISLEMDE_API_KEY"

Dilinizi bir kez seçin; sayfadaki bütün örnekler o dilde açılır.

Kimlik doğrulama

Anahtarı x-api-key başlığında ya da Authorization: Bearer isl_… olarak gönderin. Anahtarlar isl_ ile başlar ve işletmenin bütün işlerine ve müşterilerine erişir.

Anahtarı tarayıcıda, mobil uygulamada ya da herkese açık bir depoda tutmayın; her zaman kendi sunucunuzdan istek atın. Sızdığını düşünürseniz Ayarlar → API sayfasından iptal edin, o an çalışmayı bırakır.

Okuma ve yazma

Anahtarı oluştururken yetkisini seçersiniz. Yalnızca okuma (varsayılan) anahtarı listeleri ve kayıtları okur, hiçbir şeyi değiştiremez. Okuma ve yazma anahtarı ayrıca iş ve müşteri açar, düzeltir, durum değiştirir, not ekler ve ödeme kaydeder. Yazma yetkisi olmayan bir anahtarla yazmaya çalışırsanız 403 insufficient_scope gelir. Yetkiler sonradan değişmez; gerekirse yeni bir anahtar oluşturun.

Yazmalar paneldekiyle aynı kurallardan geçer: aynı doğrulamalar, işlem hakkı, müşteriye giden SMS ve e-postalar, iş geçmişi ve webhook'lar. Geçmişte yapan olarak anahtarın adı görünür, örn. API · Muhasebe. Hesap salt okunurken (ödeme alınamadı ya da deneme bitti) yazmalar kapalıdır, okuma sürer.

Yazma yetkili bir anahtarla açılan her iş işlem hakkınızdan düşer ve müşteriye SMS gidebilir. Denemelerinizi gerçek müşteri numaralarıyla yapmayın.

Hazır istemci

Aşağıdaki örnekler bu küçük yardımcıyı kullanır: biri tek istek atar ve hatada anlaşılır bir mesajla durur, öbürü bir listenin bütün sayfalarını sırayla getirir. Projenize bir kez ekleyin. JavaScript ve C# için ek paket gerekmez; Python'da requests, PHP'de Guzzle yeterli.

// islemde.js · Node 18 ve üzeri, ek paket gerekmez
const BASE = "https://islemde.app/api/v1";

export async function islemde(path, params = {}) {
  const url = new URL(BASE + path);
  for (const [name, value] of Object.entries(params)) {
    if (value != null) url.searchParams.set(name, value);
  }
  const res = await fetch(url, {
    headers: { "x-api-key": process.env.ISLEMDE_API_KEY },
  });
  const body = await res.json();
  if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
  return body;
}

// Listenin bütün sayfalarını sırayla getirir:
// for await (const job of all("/jobs")) { … }
export async function* all(path, params = {}) {
  let cursor;
  while (cursor !== null) {
    const page = await islemde(path, { ...params, cursor });
    yield* page.data;
    cursor = page.nextCursor;
  }
}

Sayfalama

Liste uçları en fazla limit kayıt (varsayılan 25, en çok 100) ve bir nextCursor döner. Sonraki sayfa için onu cursor olarak gönderin; son sayfada null gelir. Siz okurken yeni iş açılsa da sayfalar kaymaz; aynı kaydı iki kez almazsınız.

Hazır istemciyle döngüyü siz yazmazsınız; kayıtlar tek tek gelir, sayfalar arka planda çekilir:

# İlk sayfa
curl "https://islemde.app/api/v1/jobs?state=all&limit=100" \
  -H "x-api-key: $ISLEMDE_API_KEY"

# Sonraki sayfa: cevaptaki nextCursor ile
curl "https://islemde.app/api/v1/jobs?state=all&limit=100&cursor=1046" \
  -H "x-api-key: $ISLEMDE_API_KEY"

Güvenli tekrar deneme

Ağ koptuğunda isteğin bize ulaşıp ulaşmadığını bilemezsiniz. POST isteklerine her yeni işlem için benzersiz bir Idempotency-Key başlığı ekleyin (örn. bir UUID); tekrar denerken aynı değeri gönderin. 24 saat içinde aynı anahtar ve aynı gövdeyle gelen istek ikinci kez kayıt açmaz, ilk başarılı cevabı idempotent-replayed: true başlığıyla geri alırsınız.

Aynı anahtarı başka bir gövdeyle gönderirseniz 422 idempotency_key_reused gelir.
İlk istek hâlâ işleniyorsa 409 idempotency_in_progress gelir; biraz sonra tekrar deneyin. Bizim tarafımızda yarıda kalıp hiç cevap verilmeyen bir isteğin anahtarı 10 dakika sonra yeniden kullanılabilir.
Yalnızca başarılı cevaplar saklanır: hata aldıysanız düzeltip aynı anahtarla yeniden gönderebilirsiniz. Anahtarlar işletmeye özeldir.

curl -X POST "https://islemde.app/api/v1/jobs" \
  -H "x-api-key: $ISLEMDE_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "customer": {
    "name": "Emre Kaya",
    "phone": "0544 111 22 33"
  },
  "item": {
    "category": "Telefon",
    "brand": "Samsung",
    "model": "Galaxy S23"
  },
  "problem": "Şarj olmuyor.",
  "priority": "normal"
}'

Hatalar

Hatalar HTTP durum koduyla ve hep aynı biçimde gelir. code değişmez, programınız ona bakabilir; message Türkçe ve okunabilirdir, kullanıcıya ya da kayda yazabilirsiniz.

Cevap

{
  "error": {
    "code": "invalid_api_key",
    "message": "API anahtarı geçersiz, süresi dolmuş ya da iptal edilmiş."
  }
}

Gövdesi hatalı bir istekte issues hangi alanın neden reddedildiğini söyler; path iç içe alanları noktayla ayırır. Tanımadığımız alanlar da reddedilir, böylece yazım hataları sessizce kaybolmaz.

Cevap

{
  "error": {
    "code": "invalid_input",
    "message": "Gönderilen bilgilerde hata var.",
    "issues": [
      {
        "path": "customer.phone",
        "message": "Geçerli bir telefon numarası girin."
      },
      {
        "path": "problem",
        "message": "Sorunu kısaca yazın."
      }
    ]
  }
}

Durum	Kod	Anlamı
400	`invalid_input`	Parametre ya da gövde hatalı; issues hangi alanın neden reddedildiğini söyler.
400	`invalid_json`	Gövde geçerli bir JSON değil.
400	`invalid_idempotency_key`	Idempotency-Key biçimi hatalı.
401	`missing_api_key`	Anahtar gönderilmedi.
401	`invalid_api_key`	Anahtar yanlış, süresi dolmuş ya da iptal edilmiş.
403	`plan_feature_locked`	İşletmenin paketinde API yok.
403	`insufficient_scope`	Anahtar yalnızca okuyabilir.
403	`workspace_restricted`	Ödeme alınamadığı için hesap salt okunur; yazma kapalı.
403	`trial_expired`	Deneme süresi bitti; hesap salt okunur, yazma kapalı.
403	`plan_required`	İşletme için önce bir paket seçilmesi gerekiyor; yazma kapalı.
403	`trial_limit_reached`	Deneme süresindeki iş hakkı doldu; yeni iş açılamaz.
403	`overage_cap_reached`	Bu ayki ek kullanım sınırına ulaşıldı; yeni iş açılamaz.
403	`subscription_canceled`	Abonelik sona erdi; hesap salt okunur, yazma kapalı.
403	`forbidden`	Anahtarın bu kayda erişimi yok.
404	`not_found`	Böyle bir kayıt yok.
409	`conflict`	Kayıt az önce değişti ya da istek şu an yerine getirilemiyor; güncel hâli alıp tekrar deneyin.
409	`phone_in_use`	Telefon başka bir müşteriye kayıtlı.
409	`idempotency_in_progress`	Aynı Idempotency-Key ile gönderilen istek hâlâ işleniyor.
409	`refund_exceeds_paid`	İade, iş için alınan ödemeden (eksi önceki iadeler) fazla.
413	`payload_too_large`	Gövde 64 KB'tan büyük.
422	`idempotency_key_reused`	Idempotency-Key son 24 saatte başka bir gövdeyle kullanıldı.
429	`rate_limited`	Dakikalık istek ya da yazma sınırını geçtiniz; Retry-After kadar saniye bekleyin.
500	`internal_error`	Bizde bir sorun oldu; kaydı tuttuk.

Sınırlar

Her anahtar dakikada 600 istek yapabilir; bunların en fazla 120 tanesi yazma olabilir. İstek gövdesi en fazla 64 KB. Sınırı aşınca 429 gelir; Retry-After başlığındaki saniye kadar bekleyip devam edin. Değişiklikleri sık sık çekiyorsanız hepsini yeniden okumak yerine changedSince ile yalnızca son kontrolden beri değişenleri isteyin.

OpenAPI

Bütün uçlar ve alanlar OpenAPI 3.1 biçiminde de var. Postman ya da Insomnia'ya içe aktarın, ya da kendi dilinizde istemci üretin. Webhook olaylarının gövdeleri de belgenin webhooks bölümünde.

/api/v1/openapi.json

Bütün işleri tabloya aktarın

Excel ya da Google E-Tablolar için her işi tek bir CSV dosyasına yazın. Kaç sayfa olduğunu düşünmenize gerek yok; yardımcı hepsini sırayla getirir.

state=all ile açık ve kapanmış bütün işleri isteyin.
Her iş için istediğiniz alanları bir satıra yazın.
Dosyayı Excel'de açın; Türkçe karakterler için UTF-8 seçin.

import { writeFile } from "node:fs/promises";
import { all } from "./islemde.js";

const cell = (value) => `"${String(value ?? "").replaceAll('"', '""')}"`;
const rows = [["No", "Müşteri", "Cihaz", "Durum", "Açılış"]];

for await (const job of all("/jobs", { state: "all", limit: 100 })) {
  rows.push([
    job.number,
    job.customer.name,
    [job.item.brand, job.item.model].filter(Boolean).join(" "),
    job.status.label,
    job.createdAt.slice(0, 10),
  ]);
}

await writeFile("isler.csv", rows.map((row) => row.map(cell).join(",")).join("\n"));

isler.csv

No,Müşteri,Cihaz,Durum,Açılış
1057,"Nur Özkan","Apple iPhone 12","Teslime hazır",2026-09-24
1056,"Emre Kaya","Samsung Galaxy S21","Onarımda",2026-09-23

Hazır istemciyi kullanır.

Hazır olan işleri kendi sisteminize bildirin

Kendi SMS sağlayıcınız, CRM'iniz ya da ekip sohbetiniz için: birkaç dakikada bir, son kontrolden beri teslime hazır olan işleri alın.

status=ready ile yalnızca teslime hazır işleri isteyin.
changedSince ile son kontrolden beri durumu değişenleri alın; filtre bizim tarafımızda çalışır.
Kontrol zamanını saklayın ve betiği zamanlayıcıyla (cron) birkaç dakikada bir çalıştırın. İlk çalıştırmada hazır olan bütün işler gelir.

import { readFile, writeFile } from "node:fs/promises";
import { all } from "./islemde.js";

// Kendi SMS, e-posta ya da sohbet gönderiminiz.
const notify = async (text) => console.log(text);

const since = await readFile("son-kontrol.txt", "utf8").catch(() => undefined);
const now = new Date().toISOString();

for await (const job of all("/jobs", { status: "ready", changedSince: since })) {
  await notify(`#${job.number} ${job.customer.name} için hazır: ${job.trackingUrl}`);
}

await writeFile("son-kontrol.txt", now);

Çıktı

#1047 Nur Özkan için hazır: https://islemde.app/t/U7WX42A8

Hazır istemciyi kullanır.

Günün teslimlerini muhasebeye gönderin

Gün sonunda bugün teslim edilen işleri, tutarlarını, alınan ödemeyi ve kalan borcu çıkarın. Hepsi iş listesinde; işleri tek tek açmanız gerekmez.

state=done ve bugünün başlangıcıyla changedSince isteyin; yalnızca bugün kapananlar gelir.
deliveredAt boş olanlar iptal edilmiştir; onları atlayın.
Her işte chargeKurus tutarı, paidKurus alınanı, balanceKurus kalan borcu verir. Tutarlar kuruştur: 350000, ₺3.500,00 demektir.
Teslim edilmiş ama ödenmemiş işlerin tamamı için paymentStatus=owed ile listeleyin.
Müşteri başına toplam için /customers?owing=true isteyin; her müşterinin owedKurus alanı kalan borcudur.

import { all } from "./islemde.js";

const startOfDay = new Date(new Date().setHours(0, 0, 0, 0)).toISOString();
const lira = (kurus) =>
  new Intl.NumberFormat("tr-TR", { style: "currency", currency: "TRY" }).format(kurus / 100);
let paid = 0;
let owed = 0;

for await (const job of all("/jobs", { state: "done", changedSince: startOfDay })) {
  if (!job.deliveredAt) continue; // iptal edilen

  const left = Math.max(0, job.balanceKurus ?? 0); // ücretsizde 0, tutar yoksa null
  paid += job.paidKurus;
  owed += left;
  console.log(job.number, job.customer.name, lira(job.chargeKurus ?? 0), lira(job.paidKurus), lira(left));
}

console.log("Alınan", lira(paid), "· Kalan", lira(owed));

Çıktı

1047 Nur Özkan 3.500,00 TL 3.500,00 TL 0,00 TL
1041 Emre Kaya 1.250,00 TL 500,00 TL 750,00 TL
Alınan 4.000,00 TL · Kalan 750,00 TL

Hazır istemciyi kullanır.

İşleri listele

GET/api/v1/jobs

En yeniden eskiye, sayfa sayfa.

Parametreler

Ad	Açıklama
`state`metin	Açık işler, kapananlar ya da hepsi.`activedoneall` Varsayılan: active.
`status`metin	Yalnızca bu durumdakiler; durumun anahtarı.
`q`metin	İş numarası, müşteri adı, telefon ya da cihazda arar.
`changedSince`metin	Yalnızca durumu bu andan sonra değişenler; ISO 8601, örn. 2026-09-26T00:00:00Z. Değişiklikleri düzenli çekmek için.
`paymentStatus`metin	Ödeme durumuna göre: paid, partial, unpaid, waived, none; balance bakiyesi olanlar, owed teslim edilmiş ama ödenmemiş (veresiye) işler. owed ile state gönderilmezse all sayılır.`paidpartialunpaidwaivednonebalanceowed`
`limit`sayı	Sayfa başına kayıt, 1–100. Varsayılan: 25.
`cursor`metin	Önceki cevabın nextCursor değeri; ilk sayfada göndermeyin.

İstek

curl "https://islemde.app/api/v1/jobs?status=ready" \
  -H "x-api-key: $ISLEMDE_API_KEY"

Cevap

{
  "data": [
    {
      "number": 1047,
      "trackingCode": "U7WX42A8",
      "trackingUrl": "https://islemde.app/t/U7WX42A8",
      "status": {
        "key": "ready",
        "label": "Teslime hazır",
        "category": "open"
      },
      "item": {
        "category": "Telefon",
        "brand": "Apple",
        "model": "iPhone 12"
      },
      "problem": "Ekran değişimi.",
      "priority": "normal",
      "customer": {
        "name": "Nur Özkan",
        "phone": "+905321234567"
      },
      "assignee": "Burak Demir",
      "estimateKurus": 350000,
      "chargeKurus": 350000,
      "paidKurus": 100000,
      "balanceKurus": 250000,
      "paymentStatus": "partial",
      "dueAt": "2026-09-27T15:00:00.000Z",
      "createdAt": "2026-09-24T08:12:40.000Z",
      "statusChangedAt": "2026-09-25T13:02:11.000Z",
      "deliveredAt": null,
      "cancelledAt": null
    }
  ],
  "nextCursor": "1046"
}

data içindeki her kayıt

Alan	Açıklama
`number`sayı	İş numarası; panelde #1047 olarak görünür.
`trackingCode`metin	Müşterinin takip kodu (8 karakter).
`trackingUrl`metin	Müşteriye gönderebileceğiniz takip sayfası. Alan adınız bağlıysa o adreste, değilse islemde.app'te; API'de ve webhook'larda aynıdır.
`status`nesne	Güncel durum.
`status.key`metin	Durumun anahtarı: received, ready, delivered…
`status.label`metin	Panelde görünen adı.
`status.category`metin	Durumun türü.`openwaitingdonecancelled`
`item`nesne	Cihaz ya da ürün.
`item.category`metin · null olabilir	Tür, örn. Telefon.
`item.brand`metin · null olabilir	Marka.
`item.model`metin · null olabilir	Model.
`problem`metin	Müşterinin bildirdiği sorun.
`priority`metin	Öncelik.`lownormalhighurgent`
`customer`nesne	Müşteri.
`customer.name`metin	Ad soyad.
`customer.phone`metin · null olabilir	Telefon, +90 ile.
`assignee`metin · null olabilir	Atanan kişinin adı.
`estimateKurus`sayı · null olabilir	Teslim alırken verilen tahmini tutar, kuruş (185000 = ₺1.850,00).
`chargeKurus`sayı · null olabilir	İşin tutarı, kuruş: onaylanan teklifin KDV dahil toplamı, yoksa tahmini tutar. İptal edilen işte null.
`paidKurus`sayı	Alınan ödemeler eksi iadeler, kuruş. İptal edilen kayıtlar sayılmaz.
`balanceKurus`sayı · null olabilir	Kalan borç, kuruş: chargeKurus − paidKurus. Ücretsiz sayılan işte 0, tutar belli değilse null; fazla ödemede eksi olur.
`paymentStatus`metin	Ödeme durumu: paid ödendi, partial kısmen ödendi, unpaid ödenmedi, waived ücretsiz / garanti kapsamında, none tutar yok. CSV ile aktarılan işler ödeme alınmadıkça none olur.`paidpartialunpaidwaivednone`
`dueAt`tarih (ISO 8601) · null olabilir	Söz verilen teslim tarihi.
`createdAt`tarih (ISO 8601)	Teslim alındığı an.
`statusChangedAt`tarih (ISO 8601)	Durumun son değiştiği an.
`deliveredAt`tarih (ISO 8601) · null olabilir	Teslim edildiği an.
`cancelledAt`tarih (ISO 8601) · null olabilir	İptal edildiği an.

Tek iş

GET/api/v1/jobs/{number}

İş ve en yeni geçmiş sayfaları: en fazla 30 olay, 10 teklif ve 10 garanti. Timeline yalnızca müşteriye görünür olayları içerdiğinden boş olabilir. Her liste için pagination içindeki nextCursor veya prevCursor değerini ilgili sorgu parametresine gönderin; null o yönde başka sayfa olmadığını belirtir.

Parametreler

Ad	Açıklama
`number`yol, zorunlu	İş numarası.
`eventsCursor`metin	pagination.events içindeki nextCursor veya prevCursor; ilk sayfada göndermeyin. En fazla 2048 karakter.
`quotesCursor`metin	pagination.quotes içindeki nextCursor veya prevCursor; ilk sayfada göndermeyin. En fazla 2048 karakter.
`warrantiesCursor`metin	pagination.warranties içindeki nextCursor veya prevCursor; ilk sayfada göndermeyin. En fazla 2048 karakter.

İstek

curl "https://islemde.app/api/v1/jobs/1047" \
  -H "x-api-key: $ISLEMDE_API_KEY"

Cevap

{
  "pagination": {
    "events": {
      "nextCursor": null,
      "prevCursor": null
    },
    "quotes": {
      "nextCursor": null,
      "prevCursor": null
    },
    "warranties": {
      "nextCursor": null,
      "prevCursor": null
    }
  },
  "data": {
    "number": 1047,
    "trackingCode": "U7WX42A8",
    "trackingUrl": "https://islemde.app/t/U7WX42A8",
    "status": {
      "key": "ready",
      "label": "Teslime hazır",
      "category": "open"
    },
    "item": {
      "category": "Telefon",
      "brand": "Apple",
      "model": "iPhone 12"
    },
    "problem": "Ekran değişimi.",
    "priority": "normal",
    "customer": {
      "name": "Nur Özkan",
      "phone": "+905321234567",
      "email": null
    },
    "assignee": "Burak Demir",
    "estimateKurus": 350000,
    "chargeKurus": 350000,
    "paidKurus": 100000,
    "balanceKurus": 250000,
    "paymentStatus": "partial",
    "dueAt": "2026-09-27T15:00:00.000Z",
    "createdAt": "2026-09-24T08:12:40.000Z",
    "statusChangedAt": "2026-09-25T13:02:11.000Z",
    "deliveredAt": null,
    "cancelledAt": null,
    "serial": "356789104455120",
    "accessories": "Kılıf",
    "timeline": [
      {
        "type": "created",
        "at": "2026-09-24T08:12:40.000Z",
        "text": "Cihazınız teslim alındı"
      },
      {
        "type": "status_changed",
        "at": "2026-09-25T13:02:11.000Z",
        "text": "Teslime hazır"
      }
    ],
    "quotes": [
      {
        "number": 212,
        "status": "approved",
        "totalKurus": 350000,
        "validUntil": "2026-10-01T00:00:00.000Z"
      }
    ],
    "warranties": []
  }
}

data

Alan	Açıklama
`number`sayı	İş numarası; panelde #1047 olarak görünür.
`trackingCode`metin	Müşterinin takip kodu (8 karakter).
`trackingUrl`metin	Müşteriye gönderebileceğiniz takip sayfası. Alan adınız bağlıysa o adreste, değilse islemde.app'te; API'de ve webhook'larda aynıdır.
`status`nesne	Güncel durum.
`status.key`metin	Durumun anahtarı: received, ready, delivered…
`status.label`metin	Panelde görünen adı.
`status.category`metin	Durumun türü.`openwaitingdonecancelled`
`item`nesne	Cihaz ya da ürün.
`item.category`metin · null olabilir	Tür, örn. Telefon.
`item.brand`metin · null olabilir	Marka.
`item.model`metin · null olabilir	Model.
`problem`metin	Müşterinin bildirdiği sorun.
`priority`metin	Öncelik.`lownormalhighurgent`
`customer`nesne	Müşteri.
`customer.name`metin	Ad soyad.
`customer.phone`metin · null olabilir	Telefon, +90 ile.
`customer.email`metin · null olabilir	E-posta.
`assignee`metin · null olabilir	Atanan kişinin adı.
`estimateKurus`sayı · null olabilir	Teslim alırken verilen tahmini tutar, kuruş (185000 = ₺1.850,00).
`chargeKurus`sayı · null olabilir	İşin tutarı, kuruş: onaylanan teklifin KDV dahil toplamı, yoksa tahmini tutar. İptal edilen işte null.
`paidKurus`sayı	Alınan ödemeler eksi iadeler, kuruş. İptal edilen kayıtlar sayılmaz.
`balanceKurus`sayı · null olabilir	Kalan borç, kuruş: chargeKurus − paidKurus. Ücretsiz sayılan işte 0, tutar belli değilse null; fazla ödemede eksi olur.
`paymentStatus`metin	Ödeme durumu: paid ödendi, partial kısmen ödendi, unpaid ödenmedi, waived ücretsiz / garanti kapsamında, none tutar yok. CSV ile aktarılan işler ödeme alınmadıkça none olur.`paidpartialunpaidwaivednone`
`dueAt`tarih (ISO 8601) · null olabilir	Söz verilen teslim tarihi.
`createdAt`tarih (ISO 8601)	Teslim alındığı an.
`statusChangedAt`tarih (ISO 8601)	Durumun son değiştiği an.
`deliveredAt`tarih (ISO 8601) · null olabilir	Teslim edildiği an.
`cancelledAt`tarih (ISO 8601) · null olabilir	İptal edildiği an.
`serial`metin · null olabilir	Seri ya da IMEI numarası.
`accessories`metin · null olabilir	Cihazla birlikte bırakılanlar, örn. Kılıf, şarj aleti.
`timeline[]`liste	Müşterinin de gördüğü geçmiş, eskiden yeniye. İç notlar yer almaz.
`timeline[].type`metin	created, status_changed, quote_sent…
`timeline[].at`tarih (ISO 8601)	Olduğu an.
`timeline[].text`metin	Müşterinin takip sayfasında gördüğü cümle, örn. Teslime hazır.
`quotes[]`liste	Teklifler.
`quotes[].number`sayı	Teklif numarası.
`quotes[].status`metin	Durumu.`draftsentapprovedrejectedexpiredcancelled`
`quotes[].totalKurus`sayı	KDV dahil toplam, kuruş.
`quotes[].validUntil`tarih (ISO 8601) · null olabilir	Son geçerlilik tarihi.
`warranties[]`liste	Garanti belgeleri.
`warranties[].code`metin	Belge kodu.
`warranties[].status`metin	active ya da void.
`warranties[].months`sayı	Süre, ay.
`warranties[].endsAt`tarih (ISO 8601)	Bitiş tarihi.

İş aç

POST/api/v1/jobs

Kayıtlı bir müşteriye ya da yeni bir müşteriyle iş açar. Paneldeki gibi işlem hakkından düşer, müşteriye teslim SMS'i gider ve job.created olayı yayılır.

Okuma ve yazma yetkili anahtar gerekir. Idempotency-Key ile güvenle tekrar denenebilir.

Gövde (JSON)

Alan	Açıklama
`customerId`metin	Kayıtlı müşterinin kimliği. Ya customerId ya da customer gönderin.
`customer`nesne	Yeni müşteri. Aynı telefonla kayıtlı bir müşteri varsa yenisi açılmaz, iş ona bağlanır.
`customer.name`metin · zorunlu	Ad soyad ya da firma adı, 2–120 karakter.
`customer.phone`metin	Telefon; 0532 123 45 67, 5321234567 ya da +905321234567 yazılabilir.
`customer.email`metin	E-posta.
`customer.kind`metin	Bireysel ya da kurumsal. Varsayılan: individual.`individualcompany`
`customer.taxId`metin	Vergi no (10 hane) ya da T.C. kimlik no (11 hane). Geri okunmaz.
`customer.taxOffice`metin	Vergi dairesi.
`customer.city`metin	İl, Türkçe yazımıyla: İstanbul, İzmir…
`customer.district`metin	İlçe; il ile birlikte gönderin.
`customer.address`metin	Açık adres, en fazla 300 karakter.
`customer.notes`metin	Müşteri hakkında ekibe not. Geri okunmaz.
`item`nesne	Cihaz ya da ürün.
`item.category`metin	Tür, örn. Telefon.
`item.brand`metin	Marka.
`item.model`metin	Model.
`problem`metin · zorunlu	Müşterinin bildirdiği sorun, 3–2000 karakter.
`serial`metin	Seri ya da IMEI numarası.
`accessories`metin	Cihazla birlikte bırakılanlar.
`intakeCondition`metin	Teslim alındığındaki durumu: çizik, kırık…
`estimateKurus`sayı	Tahmini tutar, kuruş (185000 = ₺1.850,00).
`priority`metin	Öncelik. Varsayılan: normal.`lownormalhighurgent`
`dueAt`tarih (ISO 8601)	Söz verilen teslim tarihi; ISO 8601.
`privateNote`metin	Ekibe özel not. API ve webhook'lar bunu hiçbir zaman geri göndermez.

İstek

curl -X POST "https://islemde.app/api/v1/jobs" \
  -H "x-api-key: $ISLEMDE_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "customer": {
    "name": "Emre Kaya",
    "phone": "0544 111 22 33"
  },
  "item": {
    "category": "Telefon",
    "brand": "Samsung",
    "model": "Galaxy S23"
  },
  "problem": "Şarj olmuyor.",
  "priority": "normal"
}'

Cevap

{
  "data": {
    "number": 1058,
    "trackingCode": "K3PX9M2D",
    "trackingUrl": "https://islemde.app/t/K3PX9M2D",
    "status": {
      "key": "received",
      "label": "Teslim alındı",
      "category": "open"
    },
    "item": {
      "category": "Telefon",
      "brand": "Samsung",
      "model": "Galaxy S23"
    },
    "problem": "Şarj olmuyor.",
    "priority": "normal",
    "customer": {
      "name": "Emre Kaya",
      "phone": "+905441112233"
    },
    "assignee": null,
    "estimateKurus": null,
    "chargeKurus": null,
    "paidKurus": 0,
    "balanceKurus": null,
    "paymentStatus": "none",
    "dueAt": null,
    "createdAt": "2026-09-27T09:30:00.000Z",
    "statusChangedAt": "2026-09-27T09:30:00.000Z",
    "deliveredAt": null,
    "cancelledAt": null
  }
}

data

Alan	Açıklama
`number`sayı	İş numarası; panelde #1047 olarak görünür.
`trackingCode`metin	Müşterinin takip kodu (8 karakter).
`trackingUrl`metin	Müşteriye gönderebileceğiniz takip sayfası. Alan adınız bağlıysa o adreste, değilse islemde.app'te; API'de ve webhook'larda aynıdır.
`status`nesne	Güncel durum.
`status.key`metin	Durumun anahtarı: received, ready, delivered…
`status.label`metin	Panelde görünen adı.
`status.category`metin	Durumun türü.`openwaitingdonecancelled`
`item`nesne	Cihaz ya da ürün.
`item.category`metin · null olabilir	Tür, örn. Telefon.
`item.brand`metin · null olabilir	Marka.
`item.model`metin · null olabilir	Model.
`problem`metin	Müşterinin bildirdiği sorun.
`priority`metin	Öncelik.`lownormalhighurgent`
`customer`nesne	Müşteri.
`customer.name`metin	Ad soyad.
`customer.phone`metin · null olabilir	Telefon, +90 ile.
`assignee`metin · null olabilir	Atanan kişinin adı.
`estimateKurus`sayı · null olabilir	Teslim alırken verilen tahmini tutar, kuruş (185000 = ₺1.850,00).
`chargeKurus`sayı · null olabilir	İşin tutarı, kuruş: onaylanan teklifin KDV dahil toplamı, yoksa tahmini tutar. İptal edilen işte null.
`paidKurus`sayı	Alınan ödemeler eksi iadeler, kuruş. İptal edilen kayıtlar sayılmaz.
`balanceKurus`sayı · null olabilir	Kalan borç, kuruş: chargeKurus − paidKurus. Ücretsiz sayılan işte 0, tutar belli değilse null; fazla ödemede eksi olur.
`paymentStatus`metin	Ödeme durumu: paid ödendi, partial kısmen ödendi, unpaid ödenmedi, waived ücretsiz / garanti kapsamında, none tutar yok. CSV ile aktarılan işler ödeme alınmadıkça none olur.`paidpartialunpaidwaivednone`
`dueAt`tarih (ISO 8601) · null olabilir	Söz verilen teslim tarihi.
`createdAt`tarih (ISO 8601)	Teslim alındığı an.
`statusChangedAt`tarih (ISO 8601)	Durumun son değiştiği an.
`deliveredAt`tarih (ISO 8601) · null olabilir	Teslim edildiği an.
`cancelledAt`tarih (ISO 8601) · null olabilir	İptal edildiği an.

İşi düzelt

PATCH/api/v1/jobs/{number}

Yalnızca gönderdiğiniz alanlar değişir; null gönderdiğiniz alan temizlenir. İşin geçmişine ekip için kaydedilir; imzalı teslim fişi olduğu gibi kalır.

Okuma ve yazma yetkili anahtar gerekir.

Parametreler

Ad	Açıklama
`number`yol, zorunlu	İş numarası.

Gövde (JSON)

Alan	Açıklama
`item`nesne	Cihaz ya da ürün.
`item.category`metin	Tür, örn. Telefon.
`item.brand`metin	Marka.
`item.model`metin	Model.
`problem`metin	Müşterinin bildirdiği sorun, 3–2000 karakter.
`serial`metin · null temizler	Seri ya da IMEI numarası.
`accessories`metin · null temizler	Cihazla birlikte bırakılanlar.
`intakeCondition`metin · null temizler	Teslim alındığındaki durumu: çizik, kırık…
`estimateKurus`sayı · null temizler	Tahmini tutar, kuruş (185000 = ₺1.850,00).
`priority`metin	Öncelik. Varsayılan: normal.`lownormalhighurgent`
`dueAt`tarih (ISO 8601) · null temizler	Söz verilen teslim tarihi; ISO 8601.
`privateNote`metin · null temizler	Ekibe özel not. API ve webhook'lar bunu hiçbir zaman geri göndermez.

İstek

curl -X PATCH "https://islemde.app/api/v1/jobs/1047" \
  -H "x-api-key: $ISLEMDE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "item": {
    "model": "iPhone 12 Pro"
  },
  "estimateKurus": 420000,
  "dueAt": null
}'

Cevap

{
  "data": {
    "number": 1047,
    "trackingCode": "U7WX42A8",
    "trackingUrl": "https://islemde.app/t/U7WX42A8",
    "status": {
      "key": "ready",
      "label": "Teslime hazır",
      "category": "open"
    },
    "item": {
      "category": "Telefon",
      "brand": "Apple",
      "model": "iPhone 12 Pro"
    },
    "problem": "Ekran değişimi.",
    "priority": "normal",
    "customer": {
      "name": "Nur Özkan",
      "phone": "+905321234567"
    },
    "assignee": "Burak Demir",
    "estimateKurus": 420000,
    "chargeKurus": 350000,
    "paidKurus": 100000,
    "balanceKurus": 250000,
    "paymentStatus": "partial",
    "dueAt": null,
    "createdAt": "2026-09-24T08:12:40.000Z",
    "statusChangedAt": "2026-09-25T13:02:11.000Z",
    "deliveredAt": null,
    "cancelledAt": null
  }
}

data

Alan	Açıklama
`number`sayı	İş numarası; panelde #1047 olarak görünür.
`trackingCode`metin	Müşterinin takip kodu (8 karakter).
`trackingUrl`metin	Müşteriye gönderebileceğiniz takip sayfası. Alan adınız bağlıysa o adreste, değilse islemde.app'te; API'de ve webhook'larda aynıdır.
`status`nesne	Güncel durum.
`status.key`metin	Durumun anahtarı: received, ready, delivered…
`status.label`metin	Panelde görünen adı.
`status.category`metin	Durumun türü.`openwaitingdonecancelled`
`item`nesne	Cihaz ya da ürün.
`item.category`metin · null olabilir	Tür, örn. Telefon.
`item.brand`metin · null olabilir	Marka.
`item.model`metin · null olabilir	Model.
`problem`metin	Müşterinin bildirdiği sorun.
`priority`metin	Öncelik.`lownormalhighurgent`
`customer`nesne	Müşteri.
`customer.name`metin	Ad soyad.
`customer.phone`metin · null olabilir	Telefon, +90 ile.
`assignee`metin · null olabilir	Atanan kişinin adı.
`estimateKurus`sayı · null olabilir	Teslim alırken verilen tahmini tutar, kuruş (185000 = ₺1.850,00).
`chargeKurus`sayı · null olabilir	İşin tutarı, kuruş: onaylanan teklifin KDV dahil toplamı, yoksa tahmini tutar. İptal edilen işte null.
`paidKurus`sayı	Alınan ödemeler eksi iadeler, kuruş. İptal edilen kayıtlar sayılmaz.
`balanceKurus`sayı · null olabilir	Kalan borç, kuruş: chargeKurus − paidKurus. Ücretsiz sayılan işte 0, tutar belli değilse null; fazla ödemede eksi olur.
`paymentStatus`metin	Ödeme durumu: paid ödendi, partial kısmen ödendi, unpaid ödenmedi, waived ücretsiz / garanti kapsamında, none tutar yok. CSV ile aktarılan işler ödeme alınmadıkça none olur.`paidpartialunpaidwaivednone`
`dueAt`tarih (ISO 8601) · null olabilir	Söz verilen teslim tarihi.
`createdAt`tarih (ISO 8601)	Teslim alındığı an.
`statusChangedAt`tarih (ISO 8601)	Durumun son değiştiği an.
`deliveredAt`tarih (ISO 8601) · null olabilir	Teslim edildiği an.
`cancelledAt`tarih (ISO 8601) · null olabilir	İptal edildiği an.

Durumu değiştir

POST/api/v1/jobs/{number}/status

İşi başka bir adıma taşır. Müşterinin SMS ve e-postası panelden değiştirilmiş gibi gider; delivered teslim eder. Durum anahtarlarını Durumlar ucundan alın.

Okuma ve yazma yetkili anahtar gerekir. Idempotency-Key ile güvenle tekrar denenebilir.

Parametreler

Ad	Açıklama
`number`yol, zorunlu	İş numarası.

Gövde (JSON)

Alan	Açıklama
`status`metin	Durumun anahtarı, örn. ready. Ya status ya da statusId gönderin.
`statusId`metin	Durumun kimliği.

İstek

curl -X POST "https://islemde.app/api/v1/jobs/1047/status" \
  -H "x-api-key: $ISLEMDE_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "status": "ready"
}'

Cevap

{
  "data": {
    "number": 1047,
    "trackingCode": "U7WX42A8",
    "trackingUrl": "https://islemde.app/t/U7WX42A8",
    "status": {
      "key": "ready",
      "label": "Teslime hazır",
      "category": "open"
    },
    "item": {
      "category": "Telefon",
      "brand": "Apple",
      "model": "iPhone 12"
    },
    "problem": "Ekran değişimi.",
    "priority": "normal",
    "customer": {
      "name": "Nur Özkan",
      "phone": "+905321234567"
    },
    "assignee": "Burak Demir",
    "estimateKurus": 350000,
    "chargeKurus": 350000,
    "paidKurus": 100000,
    "balanceKurus": 250000,
    "paymentStatus": "partial",
    "dueAt": "2026-09-27T15:00:00.000Z",
    "createdAt": "2026-09-24T08:12:40.000Z",
    "statusChangedAt": "2026-09-25T13:02:11.000Z",
    "deliveredAt": null,
    "cancelledAt": null
  }
}

data

Alan	Açıklama
`number`sayı	İş numarası; panelde #1047 olarak görünür.
`trackingCode`metin	Müşterinin takip kodu (8 karakter).
`trackingUrl`metin	Müşteriye gönderebileceğiniz takip sayfası. Alan adınız bağlıysa o adreste, değilse islemde.app'te; API'de ve webhook'larda aynıdır.
`status`nesne	Güncel durum.
`status.key`metin	Durumun anahtarı: received, ready, delivered…
`status.label`metin	Panelde görünen adı.
`status.category`metin	Durumun türü.`openwaitingdonecancelled`
`item`nesne	Cihaz ya da ürün.
`item.category`metin · null olabilir	Tür, örn. Telefon.
`item.brand`metin · null olabilir	Marka.
`item.model`metin · null olabilir	Model.
`problem`metin	Müşterinin bildirdiği sorun.
`priority`metin	Öncelik.`lownormalhighurgent`
`customer`nesne	Müşteri.
`customer.name`metin	Ad soyad.
`customer.phone`metin · null olabilir	Telefon, +90 ile.
`assignee`metin · null olabilir	Atanan kişinin adı.
`estimateKurus`sayı · null olabilir	Teslim alırken verilen tahmini tutar, kuruş (185000 = ₺1.850,00).
`chargeKurus`sayı · null olabilir	İşin tutarı, kuruş: onaylanan teklifin KDV dahil toplamı, yoksa tahmini tutar. İptal edilen işte null.
`paidKurus`sayı	Alınan ödemeler eksi iadeler, kuruş. İptal edilen kayıtlar sayılmaz.
`balanceKurus`sayı · null olabilir	Kalan borç, kuruş: chargeKurus − paidKurus. Ücretsiz sayılan işte 0, tutar belli değilse null; fazla ödemede eksi olur.
`paymentStatus`metin	Ödeme durumu: paid ödendi, partial kısmen ödendi, unpaid ödenmedi, waived ücretsiz / garanti kapsamında, none tutar yok. CSV ile aktarılan işler ödeme alınmadıkça none olur.`paidpartialunpaidwaivednone`
`dueAt`tarih (ISO 8601) · null olabilir	Söz verilen teslim tarihi.
`createdAt`tarih (ISO 8601)	Teslim alındığı an.
`statusChangedAt`tarih (ISO 8601)	Durumun son değiştiği an.
`deliveredAt`tarih (ISO 8601) · null olabilir	Teslim edildiği an.
`cancelledAt`tarih (ISO 8601) · null olabilir	İptal edildiği an.

Not ekle

POST/api/v1/jobs/{number}/notes

İşe not ekler. Varsayılan olarak yalnızca ekip görür; customerVisible ile müşterinin takip sayfasında da görünür.

Okuma ve yazma yetkili anahtar gerekir. Idempotency-Key ile güvenle tekrar denenebilir.

Parametreler

Ad	Açıklama
`number`yol, zorunlu	İş numarası.

Gövde (JSON)

Alan	Açıklama
`body`metin · zorunlu	Not, 1–4000 karakter.
`customerVisible`evet/hayır	Müşteri de görsün. Varsayılan: false.

İstek

curl -X POST "https://islemde.app/api/v1/jobs/1047/notes" \
  -H "x-api-key: $ISLEMDE_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "body": "Parça siparişi verildi, perşembe gelecek.",
  "customerVisible": true
}'

Cevap

{
  "data": {
    "id": "0f9c2a64-7d0e-4b8f-a0f1-65e0b5d2c7a3",
    "body": "Parça siparişi verildi, perşembe gelecek.",
    "customerVisible": true,
    "author": "API · Muhasebe",
    "createdAt": "2026-09-27T10:05:00.000Z"
  }
}

data

Alan	Açıklama
`id`metin	Notun kimliği.
`body`metin	Not.
`customerVisible`evet/hayır	Müşterinin takip sayfasında da görünür.
`author`metin	Yazan; API'den gelenlerde anahtarın adı.
`createdAt`tarih (ISO 8601)	Eklendiği an.

İşin ödemeleri

GET/api/v1/jobs/{number}/payments

İşe kaydedilen ödemeler ve iadeler, yeniden eskiye; iptal edilenler voidedAt ile birlikte. Kalan borç işin balanceKurus alanında.

Parametreler

Ad	Açıklama
`number`yol, zorunlu	İş numarası.

İstek

curl "https://islemde.app/api/v1/jobs/1047/payments" \
  -H "x-api-key: $ISLEMDE_API_KEY"

Cevap

{
  "data": [
    {
      "id": "8d3f0c1e-54a2-4a71-9b7e-2f6a1c0d9e44",
      "kind": "payment",
      "amountKurus": 100000,
      "method": "cash",
      "note": "Kapora",
      "receivedAt": "2026-09-24T08:14:02.000Z",
      "receivedBy": "Selin Aydın",
      "atHandover": false,
      "voidedAt": null,
      "voidReason": null
    }
  ]
}

data içindeki her kayıt

Alan	Açıklama
`id`metin	Kaydın kimliği.
`kind`metin	payment alınan ödeme, refund müşteriye yapılan iade.`paymentrefund`
`amountKurus`sayı	Tutar, kuruş; her zaman artı.
`method`metin	cash nakit, card kart (işletmenin kendi POS'u), transfer havale / EFT, other diğer.`cashcardtransferother`
`note`metin · null olabilir	Not.
`receivedAt`tarih (ISO 8601)	Ödemenin alındığı an.
`receivedBy`metin · null olabilir	Kaydı giren; API'den gelenlerde anahtarın adı.
`atHandover`evet/hayır	Teslim sırasında alındı.
`voidedAt`tarih (ISO 8601) · null olabilir	İptal edildiyse o an; iptal edilen kayıt hesaba katılmaz.
`voidReason`metin · null olabilir	İptal nedeni.

Ödeme kaydet

POST/api/v1/jobs/{number}/payments

Ödeme ya da iade kaydeder; panelden alınmış gibi işin bakiyesi, kasa ve raporlar güncellenir, payment.recorded olayı yayılır. İşlemde para çekmez, yalnızca alınan ödemeyi kaydeder. Tekrar denerken aynı Idempotency-Key'i gönderin; 24 saat içinde ödeme iki kez yazılmaz.

Okuma ve yazma yetkili anahtar gerekir. Idempotency-Key ile güvenle tekrar denenebilir.

Parametreler

Ad	Açıklama
`number`yol, zorunlu	İş numarası.

Gövde (JSON)

Alan	Açıklama
`kind`metin	payment ya da refund. Varsayılan: payment.`paymentrefund`
`amountKurus`sayı · zorunlu	Tutar, kuruş; 1 ile 100000000 (₺1.000.000) arası.
`method`metin · zorunlu	Ödeme şekli.`cashcardtransferother`
`note`metin	Not, en fazla 300 karakter.

İstek

curl -X POST "https://islemde.app/api/v1/jobs/1047/payments" \
  -H "x-api-key: $ISLEMDE_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "amountKurus": 250000,
  "method": "card",
  "note": "Kalan ödeme"
}'

Cevap

{
  "data": {
    "payment": {
      "id": "c41b7a2e-0f3d-4e8a-9a55-7d21e6b0f913",
      "kind": "payment",
      "amountKurus": 250000,
      "method": "card",
      "note": "Kalan ödeme",
      "receivedAt": "2026-09-27T16:40:12.000Z",
      "receivedBy": "API · Muhasebe",
      "atHandover": false,
      "voidedAt": null,
      "voidReason": null
    },
    "job": {
      "number": 1047,
      "trackingCode": "U7WX42A8",
      "trackingUrl": "https://islemde.app/t/U7WX42A8",
      "status": {
        "key": "ready",
        "label": "Teslime hazır",
        "category": "open"
      },
      "item": {
        "category": "Telefon",
        "brand": "Apple",
        "model": "iPhone 12"
      },
      "problem": "Ekran değişimi.",
      "priority": "normal",
      "customer": {
        "name": "Nur Özkan",
        "phone": "+905321234567"
      },
      "assignee": "Burak Demir",
      "estimateKurus": 350000,
      "chargeKurus": 350000,
      "paidKurus": 350000,
      "balanceKurus": 0,
      "paymentStatus": "paid",
      "dueAt": "2026-09-27T15:00:00.000Z",
      "createdAt": "2026-09-24T08:12:40.000Z",
      "statusChangedAt": "2026-09-25T13:02:11.000Z",
      "deliveredAt": null,
      "cancelledAt": null
    }
  }
}

data

Alan	Açıklama
`payment`nesne	Kayıt.
`payment.id`metin	Kaydın kimliği.
`payment.kind`metin	payment alınan ödeme, refund müşteriye yapılan iade.`paymentrefund`
`payment.amountKurus`sayı	Tutar, kuruş; her zaman artı.
`payment.method`metin	cash nakit, card kart (işletmenin kendi POS'u), transfer havale / EFT, other diğer.`cashcardtransferother`
`payment.note`metin · null olabilir	Not.
`payment.receivedAt`tarih (ISO 8601)	Ödemenin alındığı an.
`payment.receivedBy`metin · null olabilir	Kaydı giren; API'den gelenlerde anahtarın adı.
`payment.atHandover`evet/hayır	Teslim sırasında alındı.
`payment.voidedAt`tarih (ISO 8601) · null olabilir	İptal edildiyse o an; iptal edilen kayıt hesaba katılmaz.
`payment.voidReason`metin · null olabilir	İptal nedeni.
`job`nesne	İşin kayıttan sonraki hâli; balanceKurus kalan borcu söyler.
`job.number`sayı	İş numarası; panelde #1047 olarak görünür.
`job.trackingCode`metin	Müşterinin takip kodu (8 karakter).
`job.trackingUrl`metin	Müşteriye gönderebileceğiniz takip sayfası. Alan adınız bağlıysa o adreste, değilse islemde.app'te; API'de ve webhook'larda aynıdır.
`job.status`nesne	Güncel durum.
`job.status.key`metin	Durumun anahtarı: received, ready, delivered…
`job.status.label`metin	Panelde görünen adı.
`job.status.category`metin	Durumun türü.`openwaitingdonecancelled`
`job.item`nesne	Cihaz ya da ürün.
`job.item.category`metin · null olabilir	Tür, örn. Telefon.
`job.item.brand`metin · null olabilir	Marka.
`job.item.model`metin · null olabilir	Model.
`job.problem`metin	Müşterinin bildirdiği sorun.
`job.priority`metin	Öncelik.`lownormalhighurgent`
`job.customer`nesne	Müşteri.
`job.customer.name`metin	Ad soyad.
`job.customer.phone`metin · null olabilir	Telefon, +90 ile.
`job.assignee`metin · null olabilir	Atanan kişinin adı.
`job.estimateKurus`sayı · null olabilir	Teslim alırken verilen tahmini tutar, kuruş (185000 = ₺1.850,00).
`job.chargeKurus`sayı · null olabilir	İşin tutarı, kuruş: onaylanan teklifin KDV dahil toplamı, yoksa tahmini tutar. İptal edilen işte null.
`job.paidKurus`sayı	Alınan ödemeler eksi iadeler, kuruş. İptal edilen kayıtlar sayılmaz.
`job.balanceKurus`sayı · null olabilir	Kalan borç, kuruş: chargeKurus − paidKurus. Ücretsiz sayılan işte 0, tutar belli değilse null; fazla ödemede eksi olur.
`job.paymentStatus`metin	Ödeme durumu: paid ödendi, partial kısmen ödendi, unpaid ödenmedi, waived ücretsiz / garanti kapsamında, none tutar yok. CSV ile aktarılan işler ödeme alınmadıkça none olur.`paidpartialunpaidwaivednone`
`job.dueAt`tarih (ISO 8601) · null olabilir	Söz verilen teslim tarihi.
`job.createdAt`tarih (ISO 8601)	Teslim alındığı an.
`job.statusChangedAt`tarih (ISO 8601)	Durumun son değiştiği an.
`job.deliveredAt`tarih (ISO 8601) · null olabilir	Teslim edildiği an.
`job.cancelledAt`tarih (ISO 8601) · null olabilir	İptal edildiği an.

Müşterileri listele

GET/api/v1/customers

En son iş getirenden başlayarak, sayfa sayfa.

Parametreler

Ad	Açıklama
`q`metin	Ad, telefon ya da e-postada arar.
`owing`metin	true ile yalnızca teslim edilmiş işlerden borcu kalan müşteriler.`truefalse` Varsayılan: false.
`limit`sayı	Sayfa başına kayıt, 1–100. Varsayılan: 25.
`cursor`metin	Önceki cevabın nextCursor değeri; ilk sayfada göndermeyin.

İstek

curl "https://islemde.app/api/v1/customers" \
  -H "x-api-key: $ISLEMDE_API_KEY"

Cevap

{
  "data": [
    {
      "id": "c30f5268-a5a7-4269-a9c0-bc135f6a90ae",
      "name": "Nur Özkan",
      "phone": "+905321234567",
      "email": null,
      "jobCount": 3,
      "lastJobAt": "2026-09-24T08:12:40.000Z",
      "owedKurus": 250000,
      "createdAt": "2026-06-02T10:40:00.000Z"
    }
  ],
  "nextCursor": null
}

data içindeki her kayıt

Alan	Açıklama
`id`metin	Müşterinin kimliği.
`name`metin	Ad soyad.
`phone`metin · null olabilir	Telefon, +90 ile.
`email`metin · null olabilir	E-posta.
`jobCount`sayı	Toplam iş sayısı.
`lastJobAt`tarih (ISO 8601) · null olabilir	Son işin açıldığı an.
`owedKurus`sayı	Teslim edilmiş ama ödenmemiş işlerden kalan borç (veresiye), kuruş. Ücretsiz sayılan ve CSV ile aktarılan işler sayılmaz; borç yoksa 0.
`createdAt`tarih (ISO 8601)	Kaydın açıldığı an.

Tek müşteri

GET/api/v1/customers/{id}

Müşterinin kaydı, iş sayısı ve teslim edilmiş işlerden kalan borcu.

Parametreler

Ad	Açıklama
`id`yol, zorunlu	Müşterinin kimliği.

İstek

curl "https://islemde.app/api/v1/customers/5b1e7f7a-0c1d-4a55-9d51-2f0c8f3b8a10" \
  -H "x-api-key: $ISLEMDE_API_KEY"

Cevap

{
  "data": {
    "id": "5b1e7f7a-0c1d-4a55-9d51-2f0c8f3b8a10",
    "kind": "individual",
    "name": "Emre Kaya",
    "phone": "+905441112233",
    "email": "emre@example.com",
    "city": "İzmir",
    "district": "Karşıyaka",
    "address": null,
    "smsOptOut": false,
    "createdAt": "2026-09-27T09:30:00.000Z",
    "jobCount": 2,
    "owedKurus": 0
  }
}

data

Alan	Açıklama
`id`metin	Müşterinin kimliği.
`kind`metin	Bireysel ya da kurumsal.`individualcompany`
`name`metin	Ad soyad ya da firma adı.
`phone`metin · null olabilir	Telefon, +90 ile.
`email`metin · null olabilir	E-posta.
`city`metin · null olabilir	İl.
`district`metin · null olabilir	İlçe.
`address`metin · null olabilir	Açık adres.
`smsOptOut`evet/hayır	Müşteri SMS almak istemiyor.
`createdAt`tarih (ISO 8601)	Kaydın açıldığı an.
`jobCount`sayı	Toplam iş sayısı.
`owedKurus`sayı	Teslim edilmiş ama ödenmemiş işlerden kalan borç (veresiye), kuruş. Ücretsiz sayılan ve CSV ile aktarılan işler sayılmaz; borç yoksa 0.

Müşteri ekle

POST/api/v1/customers

Yeni müşteri açar ve customer.created olayını yayar. Aynı telefonla kayıtlı bir müşteri varsa 409 döner; o müşteriyi Müşterileri listele ucunda telefonla arayın.

Okuma ve yazma yetkili anahtar gerekir. Idempotency-Key ile güvenle tekrar denenebilir.

Gövde (JSON)

Alan	Açıklama
`name`metin · zorunlu	Ad soyad ya da firma adı, 2–120 karakter.
`phone`metin	Telefon; 0532 123 45 67, 5321234567 ya da +905321234567 yazılabilir.
`email`metin	E-posta.
`kind`metin	Bireysel ya da kurumsal. Varsayılan: individual.`individualcompany`
`taxId`metin	Vergi no (10 hane) ya da T.C. kimlik no (11 hane). Geri okunmaz.
`taxOffice`metin	Vergi dairesi.
`city`metin	İl, Türkçe yazımıyla: İstanbul, İzmir…
`district`metin	İlçe; il ile birlikte gönderin.
`address`metin	Açık adres, en fazla 300 karakter.
`notes`metin	Müşteri hakkında ekibe not. Geri okunmaz.

İstek

curl -X POST "https://islemde.app/api/v1/customers" \
  -H "x-api-key: $ISLEMDE_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "Emre Kaya",
  "phone": "0544 111 22 33",
  "email": "emre@example.com",
  "city": "İzmir",
  "district": "Karşıyaka"
}'

Cevap

{
  "data": {
    "id": "5b1e7f7a-0c1d-4a55-9d51-2f0c8f3b8a10",
    "kind": "individual",
    "name": "Emre Kaya",
    "phone": "+905441112233",
    "email": "emre@example.com",
    "city": "İzmir",
    "district": "Karşıyaka",
    "address": null,
    "smsOptOut": false,
    "createdAt": "2026-09-27T09:30:00.000Z"
  }
}

data

Alan	Açıklama
`id`metin	Müşterinin kimliği.
`kind`metin	Bireysel ya da kurumsal.`individualcompany`
`name`metin	Ad soyad ya da firma adı.
`phone`metin · null olabilir	Telefon, +90 ile.
`email`metin · null olabilir	E-posta.
`city`metin · null olabilir	İl.
`district`metin · null olabilir	İlçe.
`address`metin · null olabilir	Açık adres.
`smsOptOut`evet/hayır	Müşteri SMS almak istemiyor.
`createdAt`tarih (ISO 8601)	Kaydın açıldığı an.

Müşteriyi düzelt

PATCH/api/v1/customers/{id}

Yalnızca gönderdiğiniz alanlar değişir; null gönderdiğiniz alan temizlenir. Kişisel verileri silinmiş müşteri değiştirilemez.

Okuma ve yazma yetkili anahtar gerekir.

Parametreler

Ad	Açıklama
`id`yol, zorunlu	Müşterinin kimliği.

Gövde (JSON)

Alan	Açıklama
`name`metin	Ad soyad ya da firma adı, 2–120 karakter.
`phone`metin · null temizler	Telefon; 0532 123 45 67, 5321234567 ya da +905321234567 yazılabilir.
`email`metin · null temizler	E-posta.
`kind`metin	Bireysel ya da kurumsal.`individualcompany`
`taxId`metin · null temizler	Vergi no (10 hane) ya da T.C. kimlik no (11 hane). Geri okunmaz.
`taxOffice`metin · null temizler	Vergi dairesi.
`city`metin · null temizler	İl, Türkçe yazımıyla: İstanbul, İzmir…
`district`metin · null temizler	İlçe; il ile birlikte gönderin.
`address`metin · null temizler	Açık adres, en fazla 300 karakter.
`notes`metin · null temizler	Müşteri hakkında ekibe not. Geri okunmaz.
`smsOptOut`evet/hayır	Müşteri SMS almak istemiyor.

İstek

curl -X PATCH "https://islemde.app/api/v1/customers/5b1e7f7a-0c1d-4a55-9d51-2f0c8f3b8a10" \
  -H "x-api-key: $ISLEMDE_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "email": "emre.kaya@example.com",
  "smsOptOut": true
}'

Cevap

{
  "data": {
    "id": "5b1e7f7a-0c1d-4a55-9d51-2f0c8f3b8a10",
    "kind": "individual",
    "name": "Emre Kaya",
    "phone": "+905441112233",
    "email": "emre.kaya@example.com",
    "city": "İzmir",
    "district": "Karşıyaka",
    "address": null,
    "smsOptOut": true,
    "createdAt": "2026-09-27T09:30:00.000Z"
  }
}

data

Alan	Açıklama
`id`metin	Müşterinin kimliği.
`kind`metin	Bireysel ya da kurumsal.`individualcompany`
`name`metin	Ad soyad ya da firma adı.
`phone`metin · null olabilir	Telefon, +90 ile.
`email`metin · null olabilir	E-posta.
`city`metin · null olabilir	İl.
`district`metin · null olabilir	İlçe.
`address`metin · null olabilir	Açık adres.
`smsOptOut`evet/hayır	Müşteri SMS almak istemiyor.
`createdAt`tarih (ISO 8601)	Kaydın açıldığı an.

Durumlar

GET/api/v1/statuses

İşletmenin iş akışındaki adımlar, sırasıyla. Durum değiştirirken ve işleri süzerken bu anahtarları kullanın; işletme adımları yeniden adlandırsa da anahtar değişmez.

İstek

curl "https://islemde.app/api/v1/statuses" \
  -H "x-api-key: $ISLEMDE_API_KEY"

Cevap

{
  "data": [
    {
      "id": "d2b8c1e0-2f4a-4c1b-9a77-1f5e3c9b0a11",
      "key": "received",
      "label": "Teslim alındı",
      "customerLabel": "Cihazınız teslim alındı",
      "category": "open",
      "isInitial": true
    },
    {
      "id": "8a3f6d52-6b1e-4f0d-8c3e-7e2a9b4c5d22",
      "key": "ready",
      "label": "Teslime hazır",
      "customerLabel": "Teslime hazır",
      "category": "open",
      "isInitial": false
    },
    {
      "id": "4c7e9a13-0d2b-4e6f-b1a8-3f5c7d9e1b33",
      "key": "delivered",
      "label": "Teslim edildi",
      "customerLabel": "Teslim edildi",
      "category": "done",
      "isInitial": false
    }
  ]
}

data içindeki her kayıt

Alan	Açıklama
`id`metin	Durumun kimliği.
`key`metin	Değişmeyen anahtar: received, repairing, ready, delivered, cancelled…
`label`metin	Panelde görünen adı.
`customerLabel`metin	Müşterinin takip sayfasında gördüğü adı.
`category`metin	Durumun türü.`openwaitingdonecancelled`
`isInitial`evet/hayır	Yeni işler bu durumla açılır.

Webhook'lar nasıl çalışır

Durum sorup durmak yerine olup biteni anında alın: bir iş açıldığında, durumu değiştiğinde ya da müşteri teklifi onayladığında İşlemde sizin adresinize bir POST isteği gönderir. Adresi Ayarlar → API → Webhook adresleri bölümünden ekleyin, hangi olayları istediğinizi seçin. İmza anahtarı (whsec_…) yalnızca bir kez gösterilir.

Adres https:// ile başlamalı; port 443 ya da 1024 ve üstü olmalı (örneğin 8443). Kullanıcı adı ve şifre içeremez; iç ağa, yerel ağa ya da ayrılmış IP adreslerine çıkan adresler kabul edilmez ve her gönderimde yeniden denetlenir.
Gövde, olayın türü ve REST API'deki kayıtların aynısıdır. Ekibe özel notlar, vergi numaraları ve onay bağlantıları hiçbir zaman gönderilmez.
Her gövdede apiVersion (şu an 2026-10-01) gelir. Alan eklemek sürümü değiştirmez; bir alan kalkar ya da anlamı değişirse yeni bir tarih alır.
Test gönder düğmesi adresinize bir ping olayı yollar; son gönderimleri, cevap kodlarını ve hataları aynı sayfada görürsünüz.

Örnek

{
  "id": "evt_3f9a1c2b7d8e4f60a1b2c3d4e5f60718",
  "type": "job.status_changed",
  "apiVersion": "2026-10-01",
  "createdAt": "2026-09-25T13:02:11.482Z",
  "data": {
    "job": {
      "number": 1047,
      "trackingCode": "U7WX42A8",
      "trackingUrl": "https://islemde.app/t/U7WX42A8",
      "status": {
        "key": "ready",
        "label": "Teslime hazır",
        "category": "open"
      },
      "item": {
        "category": "Telefon",
        "brand": "Apple",
        "model": "iPhone 12"
      },
      "problem": "Ekran değişimi.",
      "priority": "normal",
      "customer": {
        "name": "Nur Özkan",
        "phone": "+905321234567"
      },
      "assignee": "Burak Demir",
      "estimateKurus": 350000,
      "chargeKurus": 350000,
      "paidKurus": 100000,
      "balanceKurus": 250000,
      "paymentStatus": "partial",
      "dueAt": "2026-09-27T15:00:00.000Z",
      "createdAt": "2026-09-24T08:12:40.000Z",
      "statusChangedAt": "2026-09-25T13:02:11.000Z",
      "deliveredAt": null,
      "cancelledAt": null
    },
    "previousStatus": {
      "key": "repairing",
      "label": "Onarımda",
      "category": "open"
    }
  }
}

Başlık	Anlamı
`islemde-event`	Olayın türü, örn. job.status_changed. Test gönderiminde ping.
`islemde-delivery`	Bu gönderimin kimliği; tekrar denemelerde aynı kalır.
`islemde-signature`	t=<unix saniye>,v1=<imza>; anahtar yenilendikten sonraki 24 saatte iki v1 gelir. Doğrulama aşağıda.
`content-type`	application/json
`user-agent`	Islemde-Webhooks/1.0

Olaylar

data içindeki job, İşleri listele ucundaki iş kaydıyla aynıdır; customer, Müşteri ekle ucunun cevabıyla.

Olay	Ne zaman	data
`job.created`	Panelde, API'den ya da teslim fişiyle iş açıldığında.	job
`job.updated`	İşin bilgileri düzeltildiğinde. Yalnızca ekibe özel not değiştiyse gelmez.	job, changes (değişen alanlar)
`job.status_changed`	İş başka bir duruma geçtiğinde; teklif onayıyla kendiliğinden geçişler dahil.	job, previousStatus
`job.delivered`	Cihaz teslim edildiğinde. Teslim yeniden yapılırsa bir kez daha gelir.	job, handover (teslim alan, ödeme, ücretsiz mi, imza; durum değiştirerek teslimde null)
`job.note_added`	Müşteriye açık bir not eklendiğinde. Ekip içi notlar gönderilmez.	job, note
`quote.sent`	Teklif müşteriye gönderildiğinde.	job, quote
`quote.approved`	Müşteri teklifi imzalayıp onayladığında.	job, quote
`quote.rejected`	Müşteri teklifi reddettiğinde.	job, quote
`warranty.issued`	Garanti belgesi verildiğinde.	job, warranty
`payment.recorded`	Ödeme ya da iade kaydedildiğinde: kapora, teslimde ya da sonradan alınan, API'den gelen.	job (balanceKurus: kayıttan sonra kalan borç), payment
`payment.voided`	Yanlış girilen bir ödeme ya da iade kaydı iptal edildiğinde.	job, payment (voidedAt ve voidReason dolu)
`customer.created`	Panelde, iş kabulünde ya da API'den yeni müşteri açıldığında. CSV ile içe aktarılanlar için gelmez.	customer

İmzayı doğrulama

Her isteğin islemde-signature başlığı t=1790000000,v1=5f2b… biçimindedir. v1, imza anahtarınızla t + "." + gövde metninin HMAC-SHA256 özetidir (küçük harf onaltılık). Kendi hesapladığınızla sabit sürede karşılaştırın ve 5 dakikadan eski t değerlerini reddedin. Gövdeyi ayrıştırmadan, geldiği gibi kullanın: tek bir boşluk bile imzayı bozar.

// Node 18+ ve Express: npm install express
import crypto from "node:crypto";
import express from "express";

const app = express();
const secret = process.env.ISLEMDE_WEBHOOK_SECRET; // whsec_ ile başlar

// İmza ham gövde üzerinden hesaplanır: JSON'u ayrıştırmadan önce doğrulayın.
app.post("/islemde-webhook", express.raw({ type: "application/json" }), (req, res) => {
  const parts = (req.get("islemde-signature") ?? "").split(",").map((part) => part.split("="));
  const t = parts.find(([key]) => key === "t")?.[1];
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${t}.${req.body}`)
    .digest("hex");
  // Anahtar yenilendikten sonraki 24 saatte iki v1 gelir: biri tutması yeter.
  const valid = parts.some(
    ([key, value]) =>
      key === "v1" &&
      value.length === expected.length &&
      crypto.timingSafeEqual(Buffer.from(value), Buffer.from(expected)),
  );
  // 5 dakikadan eski imzaları reddedin: yakalanıp yeniden gönderilen istekler geçmez.
  const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;
  if (!valid || !fresh) return res.sendStatus(400);

  const event = JSON.parse(req.body);
  // Aynı olay birden fazla gelebilir: event.id'yi saklayıp tekrarları atlayın.
  res.sendStatus(200); // Önce cevap verin; uzun işleri sonra yapın.
  console.log(event.type, event.data.job?.number);
});

app.listen(3000);

Anahtarı yenilediğinizde olaylar 24 saat boyunca iki imzayla gelir: t=…,v1=<yeni>,v1=<eski>. Her v1 değerini deneyin, biri tutuyorsa istek geçerlidir; böylece sunucunuzu bu süre içinde kesintisiz güncelleyebilirsiniz.

Tekrar denemeler

2xx dışındaki her cevap, 5 saniyeyi aşan bekleme, bağlantı hatası ve yönlendirme (3xx) başarısız sayılır; yönlendirmeler izlenmez. Başarısız bir gönderim şu aralıklarla yeniden denenir: 1 dakika, 5 dakika, 30 dakika, 2 saat, 6 saat, 24 saat. Yedinci denemeden sonra vazgeçilir; Ayarlar → API'deki listeden elle yeniden gönderebilirsiniz.

Bir adrese yapılan gönderimler (tekrar denemeler dahil) art arda 20 kez başarısız olur ve 24 saattir hiçbir gönderim ulaşmamışsa adres kapatılır, işletme sahibine bildirim gider. Kısa kesintiler adresi kapatmaz. Adresi düzeltip aynı yerden yeniden açabilirsiniz; kapalıyken oluşan olaylar gönderilmez.

İyi uygulamalar

Önce imzayı doğrulayın, sonra hemen 200 dönün; uzun işleri kendi kuyruğunuzda yapın. 5 saniyeyi aşan cevaplar tekrar denenir.
Aynı olay birden fazla gelebilir. Olayın id değerini saklayın ve daha önce işlediklerinizi atlayın.
Olayların sırası garanti değildir. Güncel hâl için statusChangedAt alanına bakın ya da işi GET /api/v1/jobs/{number} ile yeniden okuyun.
Adresiniz uzun süre kapalı kaldıysa aradaki değişiklikleri changedSince ile toplayın.
İmza anahtarını da API anahtarı gibi saklayın; sızdığını düşünürseniz yenileyin.

Başka bir uca ihtiyacınız mı var? Panelde Destek bölümünden ya da destek@islemde.app adresinden yazın. Değişiklikler Yenilikler sayfasında duyurulur.