İş emri yazma ve tamamlama

Yazmalar kommuns uygulamasıyla aynı kurallara uyar ve aynı sonuçları doğurur: ilgili kişilere bildirimler, iş emrinin geçmişi, organizasyonun Log Kayıtları (<entegrasyon adı> (API) olarak). Yeniden deneyebileceğiniz her yazmada bir Idempotency-Key gönderin (ortak kurallar). Her yazma, kaydı okuma uçlarının gösterdiği gibi döner.

Geri bildirim — issues:write

POST /issues
{"inventory_id": "…", "subject": "Chiller 2: yüksek sıcaklık", "description": "15 dk boyunca 12,4 °C", "external_id": "BMS-ALARM-8841"}

Düğümde "geri bildirim: oluşturma" yetkisi gerekir. Bir bina otomasyon sistemi genellikle her alarm için bir tane, alarmın numarasını external_id olarak gönderir (aynı numarayla ikincisi 409 döner).

İş emirleri — work_orders:write

Oluşturma

POST /work-orders
{"inventory_id": "…", "title": "Üç aylık filtre değişimi", "description": "SAP PM 4711 numaralı emirden",
 "priority": "medium", "target_date": "2026-10-20T09:00:00Z", "form_id": "…",
 "assignees": ["…"], "consultants": [], "external_id": "SAP-4711"}

Düğümde "iş emri: oluşturma" yetkisi ve elle iş emrine izin veren bir paket gerekir. priority: none, low, medium ya da high; form_id: GET /forms'tan biri. Yetkililer düğüme bağlı olmalıdır: düğüme ya da üstlerine atanmış kimlikler (kişiler, takımlar, organizasyonlar, entegrasyonlar — bkz. GET /people, /teams), böyle bir takımın üyeleri ya da entegrasyonun kendisi. Yetkili verilmezse iş emri, uygulamadaki gibi düğümün envanter sorumlularına gider.

Değiştirme — PATCH /work-orders/{id}: title, description, priority, target_date, external_id'den istedikleriniz; yalnız gönderdikleriniz değişir. İş açık, devam ediyor ya da danışmandan dönmüşken, düğümde "iş emri: güncelleme" yetkisiyle.

Atama — POST /work-orders/{id}/assignees {"assignees": [...], "consultants": [...]} ("yönlendirme" yetkisi); DELETE /work-orders/{id}/assignees/{identity_id} (bir iş emrinde en az bir yetkili kalır). Müşterisinin iş emrini yönlendiren servis firması kendi kişilerini atar.

İptal — POST /work-orders/{id}/cancel {"reason": "…"} ("silme" yetkisi, iş sürerken).

Cevaplama ve tamamlama

POST /work-orders/{id}/answers formun cevaplarını kaydeder; "complete": true ile iş emrini tamamlar da.

POST /work-orders/{id}/answers
{"answers": [
   {"question_id": "…", "value": "<seçenek id>"},
   {"question_id": "…", "value": ["<seçenek id>", "<seçenek id>"]},
   {"question_id": "…", "value": 42},
   {"question_id": "…", "value": 3.75},
   {"question_id": "…", "value": "Kayış değiştirildi"}],
 "complete": true}

• Yalnız entegrasyon iş emrine (danışman olarak değil, yetkili olarak) atanmışsa ve iş açık, devam ediyor ya da danışmandan dönmüşse — uygulamada bir kişi için olduğu gibi.
• Değer sorunun türüne uyar (GET /work-orders/{id}/answers türleri ve seçenekleri gösterir). Göndermediğiniz sorular cevapsız kalır; tamamlamak için zorunlu sorular cevaplanmalıdır (422 rule_violation soruyu söyler).
• complete olmadan kaydetmek işi "devam ediyor"a alır. Tamamlamak işi tamamlanmış yapar — danışman atanmışsa danışman kontrolüne gönderir; değerlendirme kommuns'ta kalır.
• Süre kayıtları, ekler, yorumlar ve bekletme henüz API'de yok.

Salt okunur bir organizasyon (ödenmemiş paket), uygulamadaki gibi yeni iş emirlerini ve değişiklikleri reddeder (403 read_only), ama cevaplama ve tamamlama sürer.