e-Defter SOAP Servis Entegrasyon Kılavuzu

EDefterSend

EDefterSend
Ad: EDefterSend
Açıklama: Hazırlanacak e-Defter'e ilişkin muhasebe / ERP yazılımınca uygun formatta üretilen ham veri çıktısının ePlatform sistemine yüklenebilmesine olanak sağlayan methottur. Format dökümanlarına buradan ulaşabilirsiniz.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 fileSource string Oluşturulan eDefter text dosyasının ziplenip base64 formatına dönüştürülmüş hali *
2 startDate string Yüklenen defterin verilerini kapsayan dönem başlangıç tarihi. 01.1.2015
3 endDate string Yüklenen defterin verilerini kapsayan dönem bitiş tarihi. 31.1.2015
4 splitSize int Defter bölümlendirme boyutu. 20 **
5 timeStamp bool Üretilecek deftere ait beratlarda zaman damgası istenip istenilmediğini belirleyen parametre bilgisi. true
Return (EDefterServiceResultModel)
1 IsSucceed bool İlgili işlem başarılı / başarısız değeri. true
2 Result string Başarılı durumda ilgili yüklemeye ilişkin periodId değeri, başarısız durumda hata açıklama değeri.
3 CustomerId string ePlatform tarafından üretilen unique müşteri ID bilgisi. F9A87EFF-9B41-46BB-8989-976672665A11
Notlar
* Oluşturulan eDefter text dosyasının ziplenip base64 formatına dönüştürülmüş hali
** İlgili bölümlendirme boyutu minimum 1 MB. ve maximum 100 MB. olabilir.

EDefterGetStatus

EDefterGetStatus
Ad: EDefterGetStatus
Açıklama: Spesifik bir döneme ait olarak sistemde üretilmeye başlanmış e-Defter'in mevcut durumunun sorgulanmasına olanak sağlayan methottur.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 userName string Mükellef kullanıcı adı bilgisi. admin
2 password string Mükellef şifre bilgisi. 123456
3 periodId int İlgili döneme ait unique dönem ID bilgisi. 1 *
Return (EDefterGetStatusModel)
1 ProgressType int İşlenmekte olan dönemin hangi durumda olduğu bilgisi (Durum Kodu). 60 **
2 ProgressName string İşlenmekte olan dönemin hangi durumda olduğu bilgisi (Durum Açıklaması). Şematron Kontrolü
3 TaskStatus int İşlenmekte olan dönem kapsamında çalışan görevin hangi durumda olduğu bilgisi. 3 ***
4 PeriodStatus int İşlenmekte olan dönem kapsamında çalışan görevin hangi durumda olduğu bilgisi. 0 ****
5 Error string Herhangi bir hata alınması durumunda görüntünebilecek hata mesajı değeri. Period bulunamadı.
6 Percent int Üzerinde çalışılan işlemin tamamlanma yüzde bilgisi. 98
7 TotalPartCount int İlgili dönem e-Defteri kapsamında belirlenen ve splitSize parametresine bağlı olarak üretilecek toplam defter parça sayısı. 8
Notlar
* EDefterUpload methodundan "Result" olarak dönen return değeridir.
** İlgili dönüşe ilişkin enumeration (ProgressType) aşağıda paylaşılmıştır.
*** İlgili dönüşe ilişkin enumeration (TaskStatus) aşağıda paylaşılmıştır.
**** İlgili dönüşe ilişkin enumeration (PeriodStatus) aşağıda paylaşılmıştır. ProgressType ve TaskStatus alanları ek bilgilendirme amacı taşıyıp, defterin şu anki nihai durumu için bu değer baz alınmalıdır.

ProgressType (Enums)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
 ProgressTypes
 {
     Undefined = 0,
     Controller = 10,
     Txt2Xml = 20,
     GeneralBooksGenarator = 30,
     GeneralBooksSigner = 40,
     GeneralBooksSchemaValidator = 50,
     GeneralBooksSchematronValidator = 60,
     LettersPattentsGenerator = 70,
     LettersPattentsSigner = 80,
     LettersPattentsSchemaValidator = 90,
     LettersPattentsSchematronValidator = 100,
     Done=110
 }

TaskStatus (Enums)

1
2
3
4
5
6
7
8
9
 {
     //Test = 0,
     Waiting = 1,
     Queued = 2,
     Running = 3,
     Failed = 4,
     Succeed = 5,
     Deleted = 6
 }

PeriodStatus (Enums)

1
2
3
4
5
6
7
 {
     Running = 0,
     Completed = 1,
     Failed = 2,
     Archived = 3,
     Sending = 4
 }

EDefterRefreshTask

EDefterRefreshTask
Ad: EDefterRefreshTask
Açıklama: Geçici bir sebepten dolayı hata alan yüklemeye ilişkin sürecin tekrar denenmek üzere çalıştırılması için kullanılabilecek methottur.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 userName string Mükellef kullanıcı adı bilgisi. admin
2 password string Mükellef şifre bilgisi. 123456
3 periodId int İlgili döneme ait unique dönem ID bilgisi. 1
Return (EDefterServiceResultModel)
1 IsSucceed bool İlgili işlem başarılı / başarısız değeri. true
2 Result string Başarılı durumda ilgili yüklemeye ilişkin periodId değeri, başarısız durumda hata açıklama değeri.
3 CustomerId string ePlatform tarafından üretilen unique müşteri ID bilgisi. F9A87EFF-9B41-46BB-8989-976672665A11

EDefterDelete

EDefterDelete
Ad: EDefterDelete
Açıklama: Sistem üzerinde üretilen ve henüz arşivlenmemiş e-Defter'in silinmesine olanak sağlayan methottur.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 userName string Mükellef kullanıcı adı bilgisi. admin
2 password string Mükellef şifre bilgisi. 123456
3 periodId int İlgili döneme ait unique dönem ID bilgisi. 1
Return (EDefterServiceResultModel)
1 IsSucceed bool İlgili işlem başarılı / başarısız değeri. true
2 Result string Başarılı durumda ilgili yüklemeye ilişkin periodId değeri, başarısız durumda hata açıklama değeri.
3 CustomerId string ePlatform tarafından üretilen unique müşteri ID bilgisi. F9A87EFF-9B41-46BB-8989-976672665A11

EDefterGetGeneralBooks

EDefterGetGeneralBooks
Ad: EDefterGetGeneralBooks
Açıklama: Sisteme yüklenmiş ve üretimi başarıyla tamamlanmış spesifik bir döneme ait tüm defterlerin listelenmesine olanak sağlayan methottur.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 userName string Mükellef kullanıcı adı bilgisi. admin
2 password string Mükellef şifre bilgisi. 123456
3 periodId int İlgili döneme ait unique dönem ID bilgisi. 1 *
Return (List)
1 Id int Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait yevmiye ya da büyük defter ID bilgisi. 121
2 PartId int Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait ID bilgisi. 81
3 PartIndex int Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait indis bilgisi. 81
4 GeneralBookType int Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait defter tip bilgisi. 1 *
5 GeneralBookPath string Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait yevmiye ya da büyük deftere ait dosya yolu bilgisi. - **
6 LettersPatentPath string Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait imzasız berata ait dosya yolu bilgisi. - **
7 SignedLettersPatentPath string Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait imzalı berata ait dosya yolu bilgisi. - **
8 PeriodCoveredStart DateTime Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasında yer alan muhasebe kayıtlarının kapsadığı tarihe ilişkin başlangıç tarih bilgisi. 2015-01-01T00:00:00
9 PeriodCoveredEnd DateTime Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasında yer alan muhasebe kayıtlarının kapsadığı tarihe ilişkin bitiş tarih bilgisi. 2015-01-01T00:00:00
Notlar
* İlgili dönüşe ilişkin enumeration (GeneralBookTypes) aşağıda paylaşılmıştır.
** İlgili dönüş değerleri bir sonraki versiyonda yayından kaldırılacağından geliştirilmeye dahil edilmesi önerilmemektedir.

GeneralBookTypes (Enums)

1
2
3
4
5
 {
     UnDefined = 0,
     Journal = 1,
     Ledger = 2
 }

EDefterGetPreview

EDefterGetPreview
Ad: EDefterGetPreview
Açıklama: Sisteme yüklenmiş ve tamamlanmış defterlerin önizlemesinin görüntülenmesini sağlayan methottur.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 userName string Mükellef kullanıcı adı bilgisi. admin
2 password string Mükellef şifre bilgisi. 123456
3 generalBookId int Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait yevmiye ya da büyük defter ID bilgisi. 121
4 generalBookType int Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait defter tip bilgisi. (1-Defter, 3-GİB İmzasız Berat, 4-GİB İmzalı Berat) 1
Return (EDefterServiceResultModel)
1 IsSucceed bool İlgili işlem başarılı / başarısız değeri. true
2 Result string Başarılı durumda ilgili yüklemeye ilişkin periodId değeri, başarısız durumda hata açıklama değeri.
3 FileName string Önizleme methodu kapsamında boş dönüş yapacaktır.
4 FileSource string Sistemde üretilen spesifik bir e-Defter'in spesifik bir defter parçasına ait yevmiye, büyük defter ya da beratların XSLT giydirilmiş HTML BASE64 değeri. VEVTVF9CRVJBVF9JQ0VSSUdJX1NUUkVBTUk=

EDefterDownload

EDefterDownload
Ad: EDefterDownload
Açıklama: Sisteme yüklenen ve tamamlanan spesifik bir döneme ait defterlerin ve/veya beratların karşıdan yüklenilmesine olanak sağlayan methottur.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 userName string Mükellef kullanıcı adı bilgisi. admin
2 password string Mükellef şifre bilgisi. 123456
3 periodId int İlgili döneme ait unique dönem ID bilgisi. 121
4 type int Karşıdan yüklenmek istenen içeriğe ilişkin tip bilgisi (1-Tüm Çıktılar, 2-Sadece Beratlar) 1
Return (EDefterServiceResultModel)
1 IsSucceed bool İlgili işlem başarılı / başarısız değeri. true
2 Result string Başarılı durumda ilgili yüklemeye ilişkin periodId değeri, başarısız durumda hata açıklama değeri.
3 FileName string İlgili çıktıların derlenmiş ve zip formatında sıkıştırılmış haline ilişkin dosya adı.
4 FileSource string Sistemde üretilen spesifik bir döneme ait e-Defter'in (Tüm çıktılar veya sadece beratlar) çıktılarının zip formatında sıkıştırıldıktan sonra alınan BASE64 değeri. VEVTVF9CRVJBVF9JQ0VSSUdJX1NUUkVBTUk=

EdefterUploadLetterPatents

EdefterUploadLetterPatents
Ad: EdefterUploadLetterPatents
Açıklama: GİB tarafından imzalanarak teslim alınan beratların sisteme yüklenerek ilgili dönemin arşivlenmesine olanak sağlayan methottur.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 userName string Mükellef kullanıcı adı bilgisi. admin
2 password string Mükellef şifre bilgisi. 123456
3 periodId int İlgili döneme ait unique dönem ID bilgisi. 121
4 fileSource string GİB tarafından imzalanan beratların zip formatında sıkıştırıldıktan sonra alınan BASE64 değeri. VEVTVF9CRVJBVA==
Return (EDefterServiceResultModel)
1 IsSucceed bool İlgili işlem başarılı / başarısız değeri. true
2 Result string Başarılı durumda ilgili yüklemeye ilişkin periodId değeri, başarısız durumda hata açıklama değeri.
3 CustomerId string ePlatform tarafından üretilen unique müşteri ID bilgisi. F9A87EFF-9B41-46BB-8989-976672665A11

EdefterCustomerDetailUpdate

EdefterCustomerDetailUpdate
Ad: EdefterCustomerDetailUpdate
Açıklama: Mükellefe ait detay bilgilerin sisteme aktarılmasını veya sistem üzerinde güncellenmesini sağlayan methottur.
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 customerDetailUpdate EDefterCustomerDetailUpdateModel Mükellef detay bilgilerine dair detayları içeren model bilgisi 121
2 userName string Mükellef kullanıcı adı bilgisi. admin
3 password string Mükellef şifre bilgisi. 123456
Return (EDefterServiceResultModel)
1 IsSucceed bool İlgili işlem başarılı / başarısız değeri. true
2 Result string Başarılı durumda ilgili yüklemeye ilişkin periodId değeri, başarısız durumda hata açıklama değeri.
3 CustomerId string ePlatform tarafından üretilen unique müşteri ID bilgisi. F9A87EFF-9B41-46BB-8989-976672665A11

EDefterCustomerDetailUpdateModel (Enums)

1
2
3
4
5
6
 public class EDefterCustomerDetailUpdateModel {
 [DataMember]
 public List<EDefterCustomerAccountantModel> CustomerAccountList { get; set; }
 [DataMember]
 public EDefterCustomerDetailModel CustomerDetail { get; set; }
 }

EDefterCustomerAccountantModel (Enums)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
 public class EDefterCustomerAccountantModel {
     [DataMember] public string AccountantName { get; set; }
     [DataMember] public string AccountantEngagementType { get; set; }
     [DataMember] public string AccountantEngagementDescription { get; set; }
     [DataMember] public string AccountantEngagementDate { get; set; }
     [DataMember] public string AccountantEngagementNumber { get; set; }
     [DataMember] public string AccountantBuildingNumber { get; set; }
     [DataMember] public string AccountantStreet { get; set; }
     [DataMember] public string AccountantAddressStreet2 { get; set; }
     [DataMember] public string AccountantCity { get; set; }
     [DataMember] public string AccountantCountry { get; set; }
     [DataMember] public string AccountantZipOrPostalCode { get; set; }
     [DataMember] public string AccountantContactPhoneNumberDescription { get; set; }
     [DataMember] public string AccountantContactPhoneNumber { get; set; }
     [DataMember] public string AccountantContactFaxNumber { get; set; }
     [DataMember] public string AccountantContactEmailAddress { get; set; }
 }

EDefterCustomerDetailModel (Enums)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 public class EDefterCustomerDetailModel {
     [DataMember] public string OrganizationDescription { get; set; }
     [DataMember] public string OrganizationIdentifier { get; set; }
     [DataMember] public string BusinessDescription { get; set; }
     [DataMember] public string PhoneNumberDescription { get; set; }
     [DataMember] public string EntityPhoneNumber { get; set; }
     [DataMember] public string EntityFaxNumber { get; set; }
     [DataMember] public string EntityEmailAddress { get; set; }
     [DataMember] public string OrganizationBuildingNumber { get; set; }
     [DataMember] public string OrganizationAddressStreet { get; set; }
     [DataMember] public string OrganizationAddressStreet2 { get; set; }
     [DataMember] public string OrganizationAddressCity { get; set; }
     [DataMember] public string OrganizationAddressZipOrPostalCode { get; set; }
     [DataMember] public string OrganizationAddressCountry { get; set; }
     [DataMember] public string EntityWebSiteUrl { get; set; }
 }

CreateLettersPatent

CreateLettersPatent
Ad: CreateLettersPatent
Açıklama: Berat oluşturma bekleyen defterlerin beratlarının oluşturmasını sağlayan methottur.
Return (EDefterServiceResultModel)
No: Parametre Tip Açıklama Örnek Veri Ek Bilgi
1 IsSucceed bool İlgili işlem başarılı / başarısız değeri. true
2 Result string Başarısız durumda hata açıklama değeri.
3 CustomerId string ePlatform tarafından üretilen unique müşteri ID bilgisi. F9A87EFF-9B41-46BB-8989-976672665A11