Repair (service) records
/api/v1/servis-kayitlari/{kayit}/durum — PUT
Section titled “/api/v1/servis-kayitlari/{kayit}/durum — PUT”Sets the status of a repair record opened during a call: alindi (received), inceleniyor (diagnosing), onay_bekliyor (awaiting approval), parca_bekleniyor (waiting for parts), hazir (ready), teslim_edildi (delivered); optional tahmini_tarih. When the customer calls, the assistant tells them this status and date. kayit: the request id (UUID) or number (TLP-000012). Sending the same status and date again returns degisti: false. With teklif_tutari (and Automation rules on) the customer is asked to approve the repair price; no payment is taken.
- Authentication:
Authorization: Bearer rz_live_… - Scope:
servis:write - Plan feature: none (available on every plan)
- Idempotency-Key: optional (recommended for retries)
Parameters
Section titled “Parameters”| Name | In | Type | Limits | Meaning |
|---|---|---|---|---|
kayit * | path | string | The repair record’s request id (UUID) or number (TLP-000012). |
Request body (application/json)
Section titled “Request body (application/json)”Fields marked * are required. Unknown fields are rejected with 422.
ServiceStatusIn
| Field | Type | Limits | Meaning |
|---|---|---|---|
durum * | string | ||
tahmini_tarih | string (date) | null | ||
tarihi_kaldir | boolean | default false | |
teklif_tutari | number | string | null | ^(?!^[-+.]*$)[+-]?0*(?:\d{0,10}|(?=[\d.]{1,13}0*$)\d{0,10}\.\d{0,2}0*$) |
Example
Section titled “Example”curl -s -X PUT "$RZ_API/api/v1/servis-kayitlari/TLP-000012/durum" -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \ -d '{"durum": "parca_bekleniyor", "tahmini_tarih": "2026-11-05"}'Response 200
Section titled “Response 200”Error statuses: 401, 403, 404, 413, 422, 429 — see Errors and limits.
/api/v1/servis-kayitlari/{kayit}/onay — POST
Section titled “/api/v1/servis-kayitlari/{kayit}/onay — POST”Records the customer’s decision on the repair price (onaylandi approved / reddedildi declined), for decisions taken at the service desk or by phone. 409 no_quote if no quote is pending, 410 expired if it expired, 409 already_decided if a decision exists.
- Authentication:
Authorization: Bearer rz_live_… - Scope:
servis:write - Plan feature: Automation rules — if off, the endpoint answers 404
not_found - Idempotency-Key: optional (recommended for retries)
Parameters
Section titled “Parameters”| Name | In | Type | Limits | Meaning |
|---|---|---|---|---|
kayit * | path | string | The repair record’s request id (UUID) or number (TLP-000012). |
Request body (application/json)
Section titled “Request body (application/json)”Fields marked * are required. Unknown fields are rejected with 422.
ServiceApprovalIn
| Field | Type | Limits | Meaning |
|---|---|---|---|
karar * | string |
Example
Section titled “Example”curl -s -X POST "$RZ_API/api/v1/servis-kayitlari/TLP-000012/onay" -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \ -d '{"karar": "onaylandi"}'Response 200
Section titled “Response 200”Error statuses: 401, 403, 404, 413, 422, 429 — see Errors and limits.
© 2026 Erusoft