Claim

Register / Lead endpoint'i ile oluşturulan başvuru satışa dönüştükten sonra iş ortağının cihazı için arıza, malzeme, versiyon talebi olduğu durumda servis talebi oluşturabilmesi bu endpoint ile sağlanır.

İstek gönderildiğinde response içerisinde isteğin durumunu gösteren status, açıklama ve claimId değeri dönecektir. İsteğin gönderilmesinde bir sorun ile karşılaşırsa açıklama alanında bunun nedeni iletilir.

Response içerisinde ClaimId bilgisi dönmektedir. Bu bilgi ile daha sonra servis talebinizin durumunu sorgulayabilirsiniz.

Notlar

İlgili satışı bulabilmek adına registerRefCode veya externalRegistrationId ‘ den birinin dolu gönderilmesi gerekmektedir. İkisi aynı anda boş gönderilemez.
Talep tipi MALZEME girilmesi durumunda quantity alanının doldurulması gerekmektedir.
Talep tipi ARIZA girilmesi durumunda quantity boş gönderilmelidir.
Type Detail alanına seçilen talep tipi ARIZA olması durumunda ARIZA TİPİ ID’ leri , MALZEME olması durumunda MALZEME TÜRÜ ID’leri gönderilmelidir. Hatalı ID gönderilmesi status false olacaktır.
Geçersiz malzeme türü veya ariza tipi ID’si girilmesi durumunda servis talebi oluşturulmaz. Status sorgulandığında açıklama ile beraber status FALSE olarak görünmektedir.
ExternalClaimId isteğe bağlıdır. Boş gönderilmesi durumunda Ödeal tarafındaki claimId ile işlemlere devam edilecektir.
Payload’ın sorunsuz girilmesi durumunda talep hakkındaki bilgi için status sorgulanmalıdır.

Arıza Tipi Açıklamaları

ID	ARIZA TİPİ
16	Tekrar Deneyin Hatası
24	Diğer
33	Manyetik Kart Okumuyor
60	Dokunmatik Ekran Çalışmıyor
62	Parametre Hatası
63	Günsonu Hatası
64	C1/C7/C9 Hatası
65	Slip/Rulo Hatası
66	Arıza 96_Kartı Çıkarın Hatası
67	Bağlantı Hatası
68	Temassız İşlem Hatası
69	İşlem Alamama
70	Versiyon Hatası
71	Cihaz Açılmıyor, Kitleniyor

ID	MALZEME TÜRÜ
1	Rulo

Örnek Request

HttpStatusCode	Request	Response
200	{ "registerRefCode": "084f727c-8a3c-45ea-8eb7-6b32e998feca", "terminalSerialNumber": "PAX710011981", "externalClaimId": "1202", "type": "VERSIYON", "city": "İstanbul", "town": "Kağıthane", "address": "Test", "description":"Versiyon Test Kaydı ", "externalRegistrationId":"100012" }	{ "status": true, "reason": "Talebiniz alındı", "claimId": "084f727c-8a3c-45ea-8eb7-6b32e998feca" }
422	{ "registerRefCode": "474835ab-2e88-4612-becc-95495986e3e6", "terminalSerialNumber": "PAX710011981", "externalClaimId": "1202", "type": "VERSIYON", "city": "İstanbul", "town": "Kağıthane", "address": "Test", "description":"Versiyon Test Kaydı ", "externalRegistrationId":"100012" }	{ "error": { "code": "CLAIM-13", "message": "Lütfen geçerli RegisterRefCode giriniz" } }
422	{ "registerRefCode": "084f727c-8a3c-45ea-8eb7-6b32e998feca", "terminalSerialNumber": "PAX710011981", "externalClaimId": "1202", "type": "VERSIYON", "city": "İstanbul", "town": "Kağıthane", "address": "Test", "description":"Versiyon Test Kaydı ", "externalRegistrationId":"100012" }	{ "error": { "code": "CLAIM-26", "message": "Geçersiz terminalSerialNumber" } }

Hata Kodları

Kodu	Açıklama
GENE1	Beklenmedik bir hata oluştu
CLAIM-1	Claim talep isteği boş bırakılamaz
CLAIM-2	TerminalSerialNumber boş bırakılamaz.
CLAIM-3	RegisterRefCode ya da ExternalRegistrationId dolu gönderilmelidir
CLAIM-4	İl boş bırakılamaz.
CLAIM-5	Adres boş bırakılamaz.
CLAIM-6	İlçe boş bırakılamaz.
CLAIM-7	Type boş bırakılamaz. Bu alana istenilen servis talebinin değeri verilmelidir . Arıza, Malzeme, Versiyon
CLAIM-8	Desteklenmeyen type alanı.
CLAIM-9	ExternalClaimId ile kayıtlı iş emriniz bulunuyor. Yeni bir externalCalimId değeri girilerek işleme devam edilmelidir.
CLAIM-10	RegisterRefCode ile iş emriniz bulunmuyor. Başvuru esnasında dönen refcode bilgisi kullanılmalıdır.
CLAIM-11	Girmiş olduğunuz il kayıtlarımızda bulunmuyor.
CLAIM-12	Girmiş olduğunuz ilçe kayıtlarımızda bulunmuyor.
CLAIM-13	Lütfen geçerli RegisterRefCode giriniz. Başvuru esnasında dönen refcode bilgisi kullanılmalıdır.
CLAIM-14	Talep detayı boş bırakılamaz.
CLAIM-15	Miktar boş bırakılamaz. Malzeme iş emri gönderilmesi durumda bu alan zorunludur. Sayı formatında istenilen miktar yazılmalıdır.
CLAIM-16	Talep tipi malzeme ise miktar dolu gönderilmelidir
CLAIM-17	Talep tipi versiyon ise talep detayı gönderilemez
CLAIM-18	Başvurunuz satışa dönüşmediği için servis talebi oluşturamazsınız.
CLAIM-19	Satış bilgileri kontrol edildiği için servis talebi oluşturamazsınız
CLAIM-20	Satış iptal edildiği için servis talebi oluşturamazsınız
CLAIM-21	Cihaz kurulumu tamamlanmadığı için servis talebi oluşturamazsınız
CLAIM-22	Hatalı başvuru Girilen başvuru mevcut değil ise gösterilen hatadır.
CLAIM-23	Başvuru altında kayıtlı cihaz bulunamadı
CLAIM-24	Hatalı Terminal Serial Number, başvuru sorgulama aşamasında response içerisinde cihazın seri numarası bilgisi bulunur. Bu bilgi kullanılarak istek atılmalıdır.
CLAIM-25	Başvurunuz iptal edildiği için servis talebi oluşturamazsınız
CLAIM-26	Geçersiz terminalSerialNumber, başvuru sorgulama aşamasında response içerisinde cihazın seri numarası bilgisi bulunur. Bu bilgi kullanılarak istek atılmalıdır.