İşçilik Paketleri API Entegrasyonu
Licrus modülleriyle entegrasyon ve senkronizasyon sağlamak için bu dokümanda yer alan servisler kullanılır. Servisler JSON Web Servisleri olarak geliştirilmiştir
Servis Nesneleri
Servis üzerinden yayınlanan tüm metotlar, Request nesnesi alır ve Response nesnesi döner. Request ve Response nesneleri kullanıldığı metoda özgü alanlar içermekle birlikte ortak bazı alanlar da içerirler;
Request (İstek)
Alan | Açıklama | Değer |
AuthTicket | Kimlik doğrulaması için kullanılacak ticket | Zorunlu |
Id | İşlem yapılmak istenen kayda ait benzersiz numara. | Fonksiyon destekliyorsa kullanılır |
Entity | İşlem yapılmak istenen nesne. | Fonksiyon destekliyorsa kullanılır |
Response (Cevap)
Alan | Açıklama |
HasError | İşlem sonucunda bir hata oluştuysa true değer döner. Yapılan işlem başarılıysa false değer alır. |
HasMessage | İşlem sonucunda paylaşılan bir bilgi mesajı varsa true değer verir. |
MessageList | HasError veya HasMessage alanlarından herhangi bir true ise hata veya bilgi mesajı buradan alınabilir. |
Response (Cevap)
Response.MessageList
Mesaj nesnesini barındıran listedir ve içerisinde yer alan Message nesnesinin detayları aşağıdaki gibidir.
Alan | Açıklama |
Message | Hata veya Bilgi mesajı metin olarak buradan alınabilir. |
Url | https://customer.xyz/api/LaborPackage/save |
Type | Servis tarafından gönderilen mesajın tipini verir. ServiceResponseMessageType tipinde bir enum değeri taşır. Bu alan 3 tip değer alabilir, bunlar; Error: Hata Info: Bilgi Warning: Uyarı |
İşçilik Paketleri JSON Update Request Modeli
{ "Entity": { "Id":"7843", "Name": "Test", "Code": "Test", "VersionNumber":"0001", "Source":{ "Id":"2" }, "Brand":{ "Id":"16" }, "IsActive": true, "IsPrimePackage": false, "IsMaintancePackage": false, "IsWarrantyPackage": false, "IsMobilePackage": true, "Details": [ { "Labor":"13", "ServiceType":"13", "OperationGroup":"2", "AutomotiveSparePart":"1", "UnitOfMeasure":"1", "Quantity":"1", "UnitPrice":"1", "DetailType":"1" } ] }, "AuthTicket": "demodemodemodemodemodemo" }
İşçilik Paketleri JSON Update Response Modeli
{ "Results": [], "Entity": null, "HasResult": false, "Count": 0, "TotalCount": 0, "Id": 7843, "Meta": null, "MessageList": [ { "Type": 2, "Message": "Test kaydı güncellendi." } ], "HasError": false, "HasMessage": true, "RrpTag": null }
İşçilik Paketleri JSON Insert Modeli
{ "Entity": { "Name": "test", "Code": "test", "VersionNumber":"0001", "Source":{ "Id":"2" }, "Brand":{ "Id":"16" }, "IsActive": true, "IsPrimePackage": false, "IsMaintancePackage": false, "IsWarrantyPackage": false, "IsMobilePackage": true, "Details": [ { "Labor":"13", "ServiceType":"13", "OperationGroup":"2", "AutomotiveSparePart":"1", "UnitOfMeasure":"1", "Quantity":"1", "UnitPrice":"1", "DetailType":"1" } ] }, "AuthTicket": "demodemodemodemodemodemodemo" }
İşçilik Paketleri JSON Insert Response Modeli
{ "Results": [], "Entity": null, "HasResult": false, "Count": 0, "TotalCount": 0, "Id": 7843, "Meta": null, "MessageList": [ { "Type": 2, "Message": "Test kaydı yapıldı." } ], "HasError": false, "HasMessage": true, "RrpTag": null }