İlgili Başvuruda Servis Talebi Oluşturma
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. |