Download OpenAPI specification:Download
Turkcell e-Şirket Muhasebe API uç noktalarını, kullanıcı yönetiminden entegrasyon kullanıcısı oluşturarak kullanamaya başlayabilirsiniz. API kullanımı ve entegrasyon sürecinizdeki sorular için, destek@eplatform.com.tr adresinden iletişime geçebilirsiniz. Turkcell e-Şirket bünyesindeki yer alan diğer uygulamaların dökümantasyonlarına https://developer.turkcellesirket.com adresinden ulaşabilirsiniz. Servis uç noktalarımız authentication mekanizması olarak Auth 2.0
kullanmaktadır.
Test ortamı Auth
servis adresi; https://coretest.isim360.com/v1/token
Auth
servis adresi; https://core.turkcellesirket.com/v1/token
Entegrasyon çalışmalarında yaptığınız işlemlerin sonuçlarını, test portalimizi kullanarak gözlemleyebilirsiniz.
Test arayüz
adresi; https://maintest.isim360.com/
Örnek token isteği;
{
-X POST https://core.turkcellesirket.com/v1/token /
-H 'Cache-Control: no-cache' /
-H 'Content-Type: application/x-www-form-urlencoded' /
-d 'username=yourUserName&password=yourPassword&client_id=serviceApi'
}
Muhasebe canlı servis adresi: https://bsservice.turkcellesirket.com
Muhasebe test servis adresi: https://bsservicetest.isim360.com
Muhasebe servislerini kullanarak işlem yapmak için, bu adresleri baz alarak işlem gerçekleştirmelisiniz.
Carilerin sayfalı yapıda listelenmesi için kullanılır.
pageIndex | integer Başlangıç sayfasının indis bilgisi. |
pageSize | integer Çekmek istediğiniz sayfada kaç adet kayıt olması gerektiğini belirtir. Tek seferde max 500 kayıttır. |
sortedColumn | string Kayıtlar belirteceğiniz alan adına göre sıralanır. |
filterQuery | string Arayüzlerde bulunan filtreleme fonksiyonlarını kullanmak için bu alan kullanılır. örnek kullanım olarak filterQuery: [{"category":"Identifier","operator":"eşittir","value":"9874562105"}] category için aramak istediğiniz alan adı, operator için (eşittir, eşittir değildir, içeren, içermeyen, ile başlayan, ile başlamayan) gibi seçenekleriniz bulunuyor. value içinde aramak istediğiniz değeri yazınız. filterQuery arayüz için tasarlanmış fakat basit seviyede ve bazı alanlar için servis desteği vermektedir. Alanları mutlaka test ederek canlı ortamda kullanmalısınız. |
isDesc | bool Sıralama büyükten küçüğe ise true, küçükten büyüğe ise false olarak gönderebilirsiniz. |
{- "pageIndex": 0,
- "pageSize": 0,
- "totalCount": 0,
- "totalPages": 0,
- "hasNextPage": null,
- "hasPreviousPage": null,
- "items": [
- {
- "id": null,
- "branchId": null,
- "name": "string",
- "identifier": "string",
- "surname": "string",
- "totalBalance": null,
- "status": "Aktif : 1"
}
]
}
Cari hesap ait bilgileri, cari hesap Id bilgisi ile getiren uç noktasıdır .
id required | long Cari kaydınızın Id bilgisi. |
{- "id": null,
- "name": "string",
- "surname": "string",
- "identifier": "string",
- "taxOffice": "string",
- "maturity": 0,
- "mersisNumber": "string",
- "registrationNumber": "string",
- "professionalChamber": "string",
- "chamberRegistrationNumber": "string",
- "isUsed": null
}
Cari hesap kaydetmek için kullanılır.
name required | string <= 500 characters Cari ünvan/isim bilgisi. |
identifier required | string [ 10 .. 11 ] characters Cari VKN/TCKN bilgisi, 10 veya 11 haneli olmalıdır, aynı VKN/TCKN bilgisine sahip. Sadece rakamlardan oluşmalıdır. |
code | string <= 50 characters Aynı VKN/TCKN'yi birden fazla kez kaydetmek istiyorsanız, her VKN/TCKN değerini birbirinden ayırt edebilmek için bu alana unique(benzersiz) bir değer girmelisiniz. Bu alanın girildiği cari kartlar, fatura,irsaliye vb modüllerde kullanılırken, mutlaka code alanı ile birlikte kullanılmalıdır. |
surname | string <= 250 characters Soyisim ,VKN/TCKN durumunun 11 haneli olduğu koşulda zorunludur. |
taxOffice | string <= 150 characters Vergi dairesi bilgisi. |
maturity | integer Vade bilgisi. |
mersisNumber | string <= 50 characters Mersis numarası bilgisi. |
registrationNumber | string <= 50 characters Ticaret Sicil Numarası bilgisi. |
professionalChamber | string <= 250 characters Meslek Odası bilgisi. |
chamberRegistrationNumber | string <= 50 characters Oda Sicil Numarası bilgisi. |
object Cari adres bilgisidir. Burada dolduracağınız bilgiler, cariye keseceğiniz faturadaki adres bilgisi kısmında kullanıldığı için, eksiksiz doldurmaya özen gösterilmelidir. Adres bilgisini, cariyi ilk oluştururken veya cariyi oluşturduktan sonra ekleyebilirsiniz. |
{- "name": "string",
- "identifier": "stringstri",
- "code": "string",
- "surname": "string",
- "taxOffice": "string",
- "maturity": 0,
- "mersisNumber": "string",
- "registrationNumber": "string",
- "professionalChamber": "string",
- "chamberRegistrationNumber": "string",
- "currentAccountAddress": {
- "currentAccountId": null,
- "branchId": null,
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "stringstri",
- "phoneNumber": "stringstri",
- "postalZone": "string",
- "webSite": "string"
}
}
{- "id": null,
- "name": "string",
- "surname": "string",
- "identifier": "string",
- "taxOffice": "string",
- "maturity": 0,
- "mersisNumber": "string",
- "registrationNumber": "string",
- "professionalChamber": "string",
- "chamberRegistrationNumber": "string",
- "isUsed": null,
- "currentAccountAddress": {
- "currentAccountId": null,
- "branchId": null,
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "stringstri",
- "phoneNumber": "stringstri",
- "postalZone": "string",
- "webSite": "string"
}
}
Cari hesap güncelleme için kullanılır. Update işlemlemin id alanı da doldurulmak zorundadır.
VKN/TCKN alanı 11 karakter girildiği taktirde (TCKN) Soyisim alanı zorunlu alandır.
id required | long Cari kaydınızın Id bilgisi. |
name required | string <= 500 characters Cari ünvan/isim bilgisi. |
identifier required | string [ 10 .. 11 ] characters Cari VKN/TCKN bilgisi, 10 veya 11 haneli olmalıdır, aynı VKN/TCKN bilgisine sahip, birden fazla cari kayıt edemezsiniz. Sadece rakamlardan oluşmalıdır. |
code | string <= 50 characters Aynı VKN/TCKN'yi birden fazla kez kaydetmek istiyorsanız, her VKN/TCKN değerini birbirinden ayırt edebilmek için bu alana unique(benzersiz) bir değer girmelisiniz. Bu alanın girildiği cari kartlar, fatura,irsaliye vb modüllerde kullanılırken, mutlaka code alanı ile birlikte kullanılmalıdır. |
surname | string <= 250 characters Soyisim ,VKN/TCKN durumunun 11 haneli olduğu koşulda doldurulur. |
taxOffice | string <= 150 characters Vergi dairesi bilgisi. |
maturity | integer Vade bilgisi. |
mersisNumber | string <= 50 characters Mersis numarası bilgisi. |
registrationNumber | string <= 50 characters Ticaret Sicil Numarası bilgisi. |
professionalChamber | string <= 250 characters Meslek Odası bilgisi. |
chamberRegistrationNumber | string <= 50 characters Oda Sicil Numarası bilgisi. |
{- "name": "string",
- "identifier": "stringstri",
- "code": "string",
- "surname": "string",
- "taxOffice": "string",
- "maturity": 0,
- "mersisNumber": "string",
- "registrationNumber": "string",
- "professionalChamber": "string",
- "chamberRegistrationNumber": "string"
}
{- "id": null,
- "name": "string",
- "surname": "string",
- "identifier": "string",
- "taxOffice": "string",
- "maturity": 0,
- "mersisNumber": "string",
- "registrationNumber": "string",
- "professionalChamber": "string",
- "chamberRegistrationNumber": "string",
- "isUsed": null
}
İlgili cariye bağlı hesapları listelenmesi için kullanılır.
branchId | long Eğer şubeli yapı kullanıyorsanız, şube Id bilgisini girmelisiniz, aksi durumunda bu alanı query üzerinde belirtmenize gerek yok. |
currentAccountId required | long Cari kaydınızın Id bilgisi. |
pageIndex | int Başlangıç sayfasının indis bilgisi. |
pageSize | int Çekmek istediğiniz sayfada kaç adet kayıt olması gerektiğini belirtir. Tek seferde max 500 kayıttır. |
{- "pageIndex": null,
- "pageSize": null,
- "totalCount": null,
- "totalPages": null,
- "hasNextPage": null,
- "hasPreviousPage": null,
- "items": [
- {
- "id": null,
- "name": "string",
- "branchId": null,
- "currentAccountId": null,
- "accountId": null,
- "accountCode": "string",
- "accountName": "string",
- "adjunctAccount": "string",
- "baseAccount": null,
- "isBundleAccount": "true : Havuz (torba) hesap",
- "accountCurrencyCodeId": null,
- "status": "Aktif : 1"
}
]
}
Carinizin hangi hesap/hesaplar ile çalışmasını istiyorsanız, eşleşmesini bu uç noktasında yapabilirsiniz.
currentAccountId required | long Cari kaydınızın Id bilgisi. |
accountId required | long Eşleştirmek istediğiniz alt (muavin) hesabın Id bilgisi. Eğer eşletireceğiniz hesap havuz(torba) hesap değil ise, sadece bir cari ile eşleşebilir. Havuz hesap birden fazla cari ile eşleşebilir, lakin hiç bir hesap aynı cari ile birden fazla eşleşemez. |
branchId | long Eğer şubeli yapı kullanıyorsanız, bu eşleştirmeyi hangi şube için yapacaksanız, o şubenin Id bilgisini gönderilmeli. Eşleştirme yapacağınız cari bilginizinde , bu alanda yazdığınız şubeye ait olması gerekmektedir.Hesap bilginiz sadece merkeze ait olduğu için, o alan adına işlem yapmanıza gerek bulunmuyor. |
name | string <= 250 characters Cari ve hesap eşleştirmesine vereceğiniz isim/tanım bilgisidir. Zorun alan değildir ama doldurulması tavsiye edilir. |
{- "currentAccountId": null,
- "accountId": null,
- "branchId": null,
- "name": "string"
}
{- "id": null,
- "currentAccountId": null,
- "accountId": null,
- "name": "string",
- "account": {
- "code": "string",
- "name": "string",
- "isBundleAccount": "true : Havuz (torba) hesap"
}
}
Cariye bağlı hesabı silmek için kullanılır. Eğer bu eşleşme, herhangi bir işlemde kullanılmış ise silinemez, önce kullanıldığı kaydın silinmesi gerekmektedir.
id required | long Eşleşmeye ait kaydınızın Id bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, şube Id bilgisini girmelisiniz, aksi durumunda bu alanı query üzerinde belirtmenize gerek yok. |
{- "Error": "string"
}
Cariye bağlı hesapların güncellemesi için kullanılan uç noktasıdır.
id required | long Eşleşmeye ait kaydınızın Id bilgisi. |
currentAccountId required | long Cari kaydınızın Id bilgisi. |
accountId required | long Eşleştirmek istediğiniz alt (muavin) hesabın Id bilgisi. Eğer eşletireceğiniz hesap havuz(torba) hesap değil ise, sadece bir cari ile eşleşebilir. Havuz hesap birden fazla cari ile eşleşebilir, lakin hiç bir hesap aynı cari ile birden fazla eşleşemez. |
branchId | long Eğer şubeli yapı kullanıyorsanız, bu eşleştirmeyi hangi şube için yapacaksanız, o şubenin Id bilgisini gönderilmeli. Eşleştirme yapacağınız cari bilginizinde , bu alanda yazdığınız şubeye ait olması gerekmektedir.Hesap bilginiz sadece merkeze ait olduğu için, o alan adına işlem yapmanıza gerek bulunmuyor. |
name | string <= 250 characters Cari ve hesap eşleştirmesine vereceğiniz isim/tanım bilgisidir. Zorun alan değildir ama doldurulması tavsiye edilir. |
{- "currentAccountId": null,
- "accountId": null,
- "branchId": null,
- "name": "string"
}
{- "id": null,
- "customerId": null,
- "currentAccountId": null,
- "accountId": null,
- "name": "string",
- "accountType": null,
- "status": null,
- "createDate": "2019-08-24T14:15:22Z",
- "updateDate": "2019-08-24T14:15:22Z",
- "account": { },
- "currentAccount": { },
- "receiveInvoice": { },
- "sendInvoice": { }
}
İlgili cariye bağlı adresleri listelenmesi için kullanılır.
currentAccountId required | long Cari kaydınızın Id bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, şube Id bilgisini girmelisiniz, aksi durumunda bu alanı query üzerinde belirtmenize gerek yok. |
[- {
- "id": null,
- "currentAccountId": null,
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "string",
- "phoneNumber": "string",
- "postalZone": "string",
- "webSite": "string"
}
]
Cari adres bilgisidir. Burada dolduracağınız bilgiler, cariye keseceğiniz faturadaki adres bilgisi kısmında kullanıldığı için, eksiksiz doldurmaya özen gösterilmelidir. Aksi durumlarda fatura üzerindeki adres bilgisi eksik olacaktır.
currentAccountId | long Cari Id bilgisidir. Eğer cariyi eklediğiniz model içerisinde adres bilgisi gönderiyorsanız bu alan gönderilmez. Eğer cariyi ekledikten sonra adresi ekleyecekseniz, bu alanı göndermeniz zorunludur. |
branchId | long Eğer şubeli yapı kullanıyorsanız, bu eşleştirmeyi hangi şube için yapacaksanız, o şubenin Id bilgisini gönderilmeli. Eşleştirme yapacağınız cari bilginizinde , bu alanda yazdığınız şubeye ait olması gerekmektedir. |
isDefault | bool Gireceğiniz adres, carinin varsayılan, yani öncelikli adresi ise bu alan true gönderilmelidir. Cariye ekleyeceğiniz ilk adres için bu alanı true göndermeliniz. Eğer isDefault'u true olan adresiniz yok ise, faturanız kaydedilirken adres uyarısı verecektir. Ekleyeceğiniz yeni adreslerde bu alan true olarak gönderilirse, diğer adreslerin isDefault bilgisi sistem tarafından false olarak güncellenir. Aynı anda sadece bir tane adres isDefault true olabilir. |
addressName required | string <= 250 characters Adres adı bilgisidir. Örneğin : Ev, İş adresi gibi bilgiler girebilirsiniz. |
subDivisionName required | string <= 100 characters Mahalle/Semt/İlçe bilgisi. |
city required | string <= 100 characters Şehir bilgisi. |
country required | string <= 100 characters Ülke isim bilgisi. |
region | string <= 100 characters Bölge bilgisi. |
streetName | string <= 100 characters Cadde/Sokak bilgisi. |
buildingName | string <= 100 characters Bina adı bilgisi. |
buildingNumber | string <= 100 characters Bina numarası bilgisi. |
doorNumber | string <= 100 characters Kapı numarası bilgisi. |
emailAddress | string <email> <= 250 characters E-mail bilgisi. |
faxNumber | string [ 10 .. 11 ] characters Fax numarası bilgisi. |
phoneNumber | string [ 10 .. 11 ] characters Telefon numarası bilgisi. |
postalZone | string <= 100 characters Posta kodu bilgisi. |
webSite | string <url> <= 250 characters Web sitesi bilgisi. |
{- "currentAccountId": null,
- "branchId": null,
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "stringstri",
- "phoneNumber": "stringstri",
- "postalZone": "string",
- "webSite": "string"
}
{- "id": null,
- "currentAccountId": null,
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "string",
- "phoneNumber": "string",
- "postalZone": "string",
- "webSite": "string"
}
Cariye bağlı adresi silmek için kullanılır. Varsayılan olarak belirlenen adresi silemezsiniz.
id required | long Cariye ait adres kaydının Id bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, şube Id bilgisini girmelisiniz, aksi durumunda bu alanı query üzerinde belirtmenize gerek yok. |
{- "Error": "string"
}
Cariye bağlı adreslerinizi güncellemek için bu uç noktasını kullanmalısınız. Güncelleme işlemi sırasında Id bilgisi zorunlu alanlardandır.
id required | long Cariye ait adres kaydınızın Id bilgisi. |
currentAccountId | long Cari Id bilgisidir. Eğer cariyi eklediğiniz model içerisinde adres bilgisi gönderiyorsanız bu alan gönderilmez. Eğer cariyi ekledikten sonra adresi ekleyecekseniz, bu alanı göndermeniz zorunludur. |
branchId | long Eğer şubeli yapı kullanıyorsanız, bu eşleştirmeyi hangi şube için yapacaksanız, o şubenin Id bilgisini gönderilmeli. Eşleştirme yapacağınız cari bilginizinde , bu alanda yazdığınız şubeye ait olması gerekmektedir. |
isDefault | bool Gireceğiniz adres, carinin varsayılan, yani öncelikli adresi ise bu alan true gönderilmelidir. Cariye ekleyeceğiniz ilk adres için bu alanı true göndermeliniz. Eğer isDefault'u true olan adresiniz yok ise, faturanız kaydedilirken adres uyarısı verecektir. Ekleyeceğiniz yeni adreslerde bu alan true olarak gönderilirse, diğer adreslerin isDefault bilgisi sistem tarafından false olarak güncellenir. Aynı anda sadece bir tane adres isDefault true olabilir. |
addressName required | string <= 250 characters Adres adı bilgisidir. Örneğin : Ev, İş adresi gibi bilgiler girebilirsiniz. |
subDivisionName required | string <= 100 characters Mahalle/Semt/İlçe bilgisi. |
city required | string <= 100 characters Şehir bilgisi. |
country required | string <= 100 characters Ülke isim bilgisi. |
region | string <= 100 characters Bölge bilgisi. |
streetName | string <= 100 characters Cadde/Sokak bilgisi. |
buildingName | string <= 100 characters Bina adı bilgisi. |
buildingNumber | string <= 100 characters Bina numarası bilgisi. |
doorNumber | string <= 100 characters Kapı numarası bilgisi. |
emailAddress | string <email> <= 250 characters E-mail bilgisi. |
faxNumber | string [ 10 .. 11 ] characters Fax numarası bilgisi. |
phoneNumber | string [ 10 .. 11 ] characters Telefon numarası bilgisi. |
postalZone | string <= 100 characters Posta kodu bilgisi. |
webSite | string <url> <= 250 characters Web sitesi bilgisi. |
{- "currentAccountId": null,
- "branchId": null,
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "stringstri",
- "phoneNumber": "stringstri",
- "postalZone": "string",
- "webSite": "string"
}
{- "id": null,
- "currentAccountId": null,
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "string",
- "phoneNumber": "string",
- "postalZone": "string",
- "webSite": "string"
}
İlgili cariye bağlı bankaları listelenmesi için kullanılır.
currentAccountId required | long Cari kaydınızın Id bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, şube Id bilgisini girmelisiniz, aksi durumunda bu alanı query üzerinde belirtmenize gerek yok. |
[- {
- "id": null,
- "currentAccountId": null,
- "isDefault": null,
- "name": "string",
- "bankAccountNumber": "string",
- "bankName": "string",
- "bankBranchName": "string",
- "ibanNumber": "string",
- "receiverName": "string",
- "type": "string"
}
]
Cariye bağlı banka kaydetmek için kullanılır.
currentAccountId required | long Cari Id bilgisidir. |
name required | string <= 100 characters Hesap adı bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, bu eşleştirmeyi hangi şube için yapacaksanız, o şubenin Id bilgisini gönderilmeli. Eşleştirme yapacağınız cari bilginizinde , bu alanda yazdığınız şubeye ait olması gerekmektedir. |
isDefault | bool Gireceğiniz banka bilgisi, carinin varsayılan, yani öncelikli banka bilgisi ise bu alan true gönderilmelidir. Cariye ekleyeceğiniz ilk banka için bu alanı true göndermeliniz. Ekleyeceğiniz yeni banka bilgisinde bu alan true olarak gönderilirse, diğer bankanın isDefault bilgisi sistem tarafından false olarak güncellenir. Aynı anda sadece bir tane banka bilgisi isDefault true olabilir. |
bankName | string <= 100 characters Banka adı bilgisi. |
bankBranchName | string <= 100 characters Şube bilgisi. |
bankAccountNumber | string <= 50 characters Hesap numarası bilgisi. |
ibanNumber | string <= 26 characters IBAN bilgisi. |
receiverName | string <= 100 characters Alıcı adı bilgisi. |
type | string <= 100 characters Hesap tipi bilgisi. |
{- "currentAccountId": null,
- "name": "string",
- "branchId": null,
- "isDefault": null,
- "bankName": "string",
- "bankBranchName": "string",
- "bankAccountNumber": "string",
- "ibanNumber": "string",
- "receiverName": "string",
- "type": "string"
}
{- "id": null,
- "currentAccountId": null,
- "isDefault": null,
- "name": "string",
- "bankAccountNumber": "string",
- "bankName": "string",
- "bankBranchName": "string",
- "ibanNumber": "string",
- "receiverName": "string",
- "type": "string"
}
Cariye bağlı banka silmek için kullanılır. Varsayılan olarak belirlenen bankayı silemezsiniz.
id required | long Cariye ait banka kaydının Id bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, şube Id bilgisini girmelisiniz, aksi durumunda bu alanı query üzerinde belirtmenize gerek yok. |
{- "Error": "string"
}
Cariye bağlı bankaları güncellemek için kullanılır. Güncelleme işlemi sırasında Id bilgisi zorunlu alanlardandır.
id required | long Cariye ait banka kaydınızın Id bilgisi. |
currentAccountId required | long Cari Id bilgisidir. |
name required | string <= 100 characters Hesap adı bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, bu eşleştirmeyi hangi şube için yapacaksanız, o şubenin Id bilgisini gönderilmeli. Eşleştirme yapacağınız cari bilginizinde , bu alanda yazdığınız şubeye ait olması gerekmektedir. |
isDefault | bool Gireceğiniz banka bilgisi, carinin varsayılan, yani öncelikli banka bilgisi ise bu alan true gönderilmelidir. Cariye ekleyeceğiniz ilk banka için bu alanı true göndermeliniz. Ekleyeceğiniz yeni banka bilgisinde bu alan true olarak gönderilirse, diğer bankanın isDefault bilgisi sistem tarafından false olarak güncellenir. Aynı anda sadece bir tane banka bilgisi isDefault true olabilir. |
bankName | string <= 100 characters Banka adı bilgisi. |
bankBranchName | string <= 100 characters Şube bilgisi. |
bankAccountNumber | string <= 50 characters Hesap numarası bilgisi. |
ibanNumber | string <= 26 characters IBAN bilgisi. |
receiverName | string <= 100 characters Alıcı adı bilgisi. |
type | string <= 100 characters Hesap tipi bilgisi. |
{- "currentAccountId": null,
- "name": "string",
- "branchId": null,
- "isDefault": null,
- "bankName": "string",
- "bankBranchName": "string",
- "bankAccountNumber": "string",
- "ibanNumber": "string",
- "receiverName": "string",
- "type": "string"
}
{- "id": null,
- "currentAccountId": null,
- "isDefault": null,
- "name": "string",
- "bankAccountNumber": "string",
- "bankName": "string",
- "bankBranchName": "string",
- "ibanNumber": "string",
- "receiverName": "string",
- "type": "string"
}
İlgili cariye bağlı iletişim bilgilerinin listelenmesi için kullanılır.
currentAccountId required | long Cari kaydınızın Id bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, şube Id bilgisini girmelisiniz, aksi durumunda bu alanı query üzerinde belirtmenize gerek yok. |
[- {
- "id": null,
- "currentAccountId": null,
- "fullName": "string",
- "phoneNumber": "string",
- "emailAddress": "string"
}
]
Cariye bağlı iletişim bilgilerini kaydetmek için kullanılır.
currentAccountId required | long Cari Id bilgisidir. |
fullName required | string <= 100 characters Ad soyad bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, bu eşleştirmeyi hangi şube için yapacaksanız, o şubenin Id bilgisini gönderilmeli. Eşleştirme yapacağınız cari bilginizinde , bu alanda yazdığınız şubeye ait olması gerekmektedir. |
phoneNumber | string [ 10 .. 11 ] characters Telefon numarası bilgisi. |
emailAddress | string <= 250 characters E-posta bilgisi. |
{- "currentAccountId": null,
- "fullName": "string",
- "branchId": null,
- "phoneNumber": "stringstri",
- "emailAddress": "string"
}
{- "id": null,
- "currentAccountId": null,
- "fullName": "string",
- "phoneNumber": "string",
- "emailAddress": "string"
}
Cariye bağlı iletişim bilgilerini silmek için kullanılır.
id required | long Cariye ait iletişim kaydının Id bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, şube Id bilgisini girmelisiniz, aksi durumunda bu alanı query üzerinde belirtmenize gerek yok. |
{- "Error": "string"
}
Cariye bağlı iletişim bilgilerini güncellemek için kullanılır. Update işleminde id alanı doldurulması zorunlu alandır.
id required | long Cariye ait iletişim kaydınızın Id bilgisi. |
currentAccountId required | long Cari Id bilgisidir. |
fullName required | string <= 100 characters Ad soyad bilgisi. |
branchId | long Eğer şubeli yapı kullanıyorsanız, bu eşleştirmeyi hangi şube için yapacaksanız, o şubenin Id bilgisini gönderilmeli. Eşleştirme yapacağınız cari bilginizinde , bu alanda yazdığınız şubeye ait olması gerekmektedir. |
phoneNumber | string [ 10 .. 11 ] characters Telefon numarası bilgisi. |
emailAddress | string <= 250 characters E-posta bilgisi. |
{- "currentAccountId": null,
- "fullName": "string",
- "branchId": null,
- "phoneNumber": "stringstri",
- "emailAddress": "string"
}
{- "id": null,
- "currentAccountId": null,
- "fullName": "string",
- "phoneNumber": "string",
- "emailAddress": "string"
}
Gelen faturaların listelenmesi için kullanılır.
pageIndex required | integer Başlangıç sayfasının indis bilgisi. |
pageSize required | integer Sayfa içerisinde bulunan fatura sayısı |
sortedColumn | string Hangi alana göre sıralama yapılsın |
filterQuery | string Ek olarak yapılmak istenen filtre alanı |
{- "pageIndex": 0,
- "pageSize": 0,
- "totalCount": 0,
- "totalPages": 0,
- "hasNextPage": null,
- "hasPreviousPage": null,
- "items": [
- {
- "ettn": null,
- "branchId": null,
- "invoiceNumber": "string",
- "profile": "Temel : 0",
- "type": "Satış : 1",
- "recordType": "e-Fatura : 1",
- "invoiceProcessStatus": "Faturalaştırılmamış : 0",
- "recordStatus": "Muhasebelesmedi : 0",
- "invoiceStatus": "Hata : 40",
- "issueDate": "2019-08-24T14:15:22Z",
- "lineCount": null,
- "targetAlias": "string",
- "targetTitle": "string",
- "targetVknTckn": "string",
- "currencyId": null,
- "exchangeRate": null,
- "exchangeRateComment": "string",
- "exchangeRateSource": "string",
- "payableAmount": null,
- "taxExclusiveAmount": null,
- "taxTotal": null,
- "totalAmount": null,
- "createDateUtc": "2019-08-24T14:15:22Z",
- "updateDateUtc": "2019-08-24T14:15:22Z"
}
]
}
Giden faturaların listelenmesi için kullanılır.
pageIndex required | integer Başlangıç sayfasının indis bilgisi. |
pageSize required | integer Sayfa içerisinde bulunan fatura sayısı |
sortedColumn | string Hangi alana göre sıralama yapılsın |
filterQuery | string Ek olarak yapılmak istenen filtre alanı |
{- "pageIndex": 0,
- "pageSize": 0,
- "totalCount": 0,
- "totalPages": 0,
- "hasNextPage": null,
- "hasPreviousPage": null,
- "items": [
- {
- "ettn": null,
- "branchId": null,
- "invoiceNumber": "string",
- "profile": "Temel : 0",
- "type": "Satış : 1",
- "recordType": "e-Arşiv Fatura : 0",
- "recordStatus": "Muhasebelesmedi : 0",
- "invoiceStatus": "Taslak : 0",
- "issueDate": "2019-08-24T14:15:22Z",
- "lineCount": 0,
- "targetAlias": "string",
- "targetTitle": "string",
- "targetVknTckn": "string",
- "currencyId": null,
- "exchangeRate": null,
- "exchangeRateComment": "string",
- "exchangeRateSource": "string",
- "payableAmount": null,
- "taxExclusiveAmount": null,
- "taxTotal": null,
- "totalAmount": null,
- "createDateUtc": "2019-08-24T14:15:22Z",
- "updateDateUtc": "2019-08-24T14:15:22Z"
}
]
}
İlgili faturayı getirmek için kullanılır.
guid required | guid Fatura ettn'si |
isSend | bool Gelen/Giden fatura ayrımını yapar |
{- "branchId": null,
- "isSend": "Giden Fatura : true",
- "recordType": "e-Arşiv Fatura : 0",
- "recordStatus": "Muhasebelesmedi : 0",
- "invoiceStatus": "Taslak : 0",
- "invoiceProcessStatus": "Faturalaştırılmamış : 0",
- "description": "string",
- "currentAccountAlias": "string",
- "currentAccountIdentifier": "string",
- "currentAccountName": "string",
- "currentAccountAccountName": "string",
- "curAccAccCode": "string",
- "notes": [
- {
- "note": "string"
}
], - "generalInfoModel": {
- "ettn": "string",
- "prefix": "string",
- "invoiceNumber": "string",
- "invoiceProfileType": "Temel : 0",
- "issueDate": "2019-08-24T14:15:22Z",
- "issueTime": "2019-08-24T14:15:22Z",
- "type": "Satış : 1",
- "returnInvoiceNumber": "string",
- "returnInvoiceDate": "2019-08-24T14:15:22Z",
- "currencyCode": "TRY",
- "exchangeRate": null
}, - "invoiceLines": {
- "amount": null,
- "unitCode": "string",
- "unitPrice": null,
- "lineExtensionAmount": null,
- "discountRate": null,
- "discountAmount": null,
- "vatRate": null,
- "vatAmount": null,
- "vatExemptionReasonCode": "string",
- "vatExemptionReason": "string",
- "inventoryCard": "string",
- "inventoryServiceCode": "string",
- "warehouseCode": "string",
- "taxes": [
- {
- "taxName": "string",
- "taxTypeCode": "string",
- "taxRate": null,
- "taxAmount": null,
- "withHoldingCode": "string",
- "vatExemptionReasonCode": "string"
}
]
}, - "invoiceTotalsModel": {
- "lineExtensionAmount": "string",
- "taxExclusiveAmount": "string",
- "taxInclusiveAmount": "string",
- "allowanceTotalAmount": "string",
- "payableAmount": "string"
}, - "paymentMeansModel": {
- "paymentMeansCode": "1:Ödeme Aracısı",
- "paymentDueDate": null,
- "paymentChannelCode": "string",
- "instructionNote": "string",
- "payeeFinancialAccountId": "string",
- "payeeFinancialAccountCurrencyCode": "string"
}
}
Gelen/Giden Fatura kaydetmek için kullanılır. Özel Durumlar: 1)Giden Fatura kaydedileceği zaman Fatura Numarası girilmemelidir gib tarafından gönderilen numara kaydedilmektedir. 2)Giden Fatura kaydedileceği zaman Senaryo (generalInfoModel.invoiceProfileType) seçilen müşteri e-arşiv veya e-fatura kullanıcısı ise ona göre belirlenmektedir. 3)Giden/Gelen Fatura kaydedileceği zaman döviz kuru (generalInfoModel.exchangeRate), Döviz kuru kaynağı (generalInfoModel.exchangeRateSource), döviz kuru açıklaması (generalInfoModel.exchangeRateComment) alanları Tanım (currentAccAccId) alanının para biriminin TL olmadığı durumlarda doldurulması zorunludur. 4)Giden Fatura kaydedileceği zaman Ön Ek(generalInfoModel.prefix) alanı doldurulması zorunlu alandır. 5)VKN/TCKN (currentAccountIdentifier) girildiği zaman Müşteri Id (currentAccountId) ve Müşteri Adı (currentAccountName) doldurulmasına gerek yoktur.
description required | string Açıklama |
currentAccountAlias | string Posta kutusu (E-Fatura durumunda zorunludur) |
currentAccountIdentifier required | string Alıcı firma VKN/TCKN bilgisi. 10 veya 11 karakter olarak, rakamlardan oluşacak şekilde girmelisiniz. |
currentAccountCode | string Aynı VKN/TCKN ye sahip birden fazla cari oluşturduysanız, bu carileri oluştururken vermiş olduğunuz kodu, bu alan ile göndererek, faturada hangi cariyi kullanmak istediğinizi seçebilirsiniz. |
isSend | bool Giden faturalar için bu alan true olarak gönderilmelidir. |
recordType | integer Enum: "e-Arşiv Fatura : 0" "e-Fatura : 1" Fatura türü |
note | string Not alanıdır, eğer notes içinde not gönderimi yaparsanız, bu alan ile gönderecekleriniz geçersiz olup, faturaya yazılmayacaktır. |
Array of objects Fatura içerisinde birden fazla not girildiğinde bu alan liste şeklinde not alanlarını getirir. | |
object Fatura içerisinde cari daha önce sistemde bulunmuyorsa, fatura modelinin içerisindeki bu alanı doldurarak gönderebilirsiniz. Bu model ile oluşan carinin hesap eşleştirmesini muhasebe arayüzünden yapmalısınız. Aksi durumda muhasebeleştirme adımında hata alırsınız. | |
object Faturaya ait genel bilgilerin bulunduğu alandır. | |
Array of objects Fatura kalemleri | |
object Fatura tipi E-arşiv seçildiği durumda doldurulan alandır. | |
object Bu elemana ödeme şekli ile ilgili bilgiler yazılabilecektir. |
{- "description": "string",
- "currentAccountAlias": "string",
- "currentAccountIdentifier": "string",
- "currentAccountCode": "string",
- "isSend": null,
- "recordType": "e-Arşiv Fatura : 0",
- "note": "string",
- "notes": [
- {
- "note": "string"
}
], - "currentAccount": {
- "name": "string",
- "identifier": "stringstri",
- "code": "string",
- "surname": "string",
- "taxOffice": "string",
- "maturity": 0,
- "mersisNumber": "string",
- "registrationNumber": "string",
- "professionalChamber": "string",
- "chamberRegistrationNumber": "string",
- "currentAccountAddress": {
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "stringstri",
- "phoneNumber": "stringstri",
- "postalZone": "string",
- "webSite": "string"
}
}, - "generalInfoModel": {
- "ettn": "string",
- "invoiceNumber": "string",
- "invoiceProfileType": "Temel : 0",
- "type": "Satış : 1",
- "currencyCode": "TRY",
- "issueDate": "2019-08-24T14:15:22Z",
- "exchangeRate": 5.7,
- "exchangeRateSource": "string",
- "exchangeRateComment": "string",
- "returnInvoiceNumber": "string",
- "returnInvoiceDate": "2019-08-24T14:15:22Z"
}, - "invoiceLines": [
- {
- "inventoryServiceCode": "string",
- "warehouseCode": "string",
- "lineExtensionAmount": null,
- "amount": null,
- "unitPrice": null,
- "unitCode": "string",
- "vatAmount": null,
- "vatRate": null,
- "vatExemptionReasonCode": "string",
- "discountAmount": null,
- "discountRate": null,
- "taxes": [
- {
- "invoiceTaxSettingId": null,
- "withHoldingName": "string",
- "taxTypeCode": "string",
- "taxName": "string",
- "taxRate": null,
- "taxAmount": null,
- "vatExemptionReasonCode": "string",
- "vatExemptionReason": "string",
- "isWithHolding": null,
- "isNegative": null,
- "withHoldingId": null
}
], - "invoiceLineDeliveryInfoModel": {
- "deliveryTermsId": "string",
- "packagingTypeCode": "string",
- "packagingId": "string",
- "quantity": "string",
- "transportModeCode": "string",
- "requiredCustomsId": "string",
- "deliveryCountry": "string",
- "deliveryCity": "string",
- "deliveryDistrict": "string",
- "deliveryStreetName": "string",
- "deliveryBuildingNumber": "string",
- "deliveryBuildingName": "string",
- "deliveryPostalZone": "string",
- "airTransportId": "string",
- "roadTransportId": "string",
- "railTransportId": "string",
- "maritimeTransportId": "string"
}, - "serialNumberList": null
}
], - "archiveInfoModel": {
- "isInternetSale": null,
- "websiteUrl": "string",
- "shipmentSenderTcknVkn": "string",
- "shipmentSendType": "ELEKTRONIK",
- "shipmentSenderName": "string",
- "shipmentSenderSurname": "string",
- "shipmentDate": null,
- "hideDespatchMessage": null,
- "subscriptionType": "HIZMETNO:Hizmet No",
- "subscriptionTypeNumber": "string"
}, - "paymentMeansModel": {
- "paymentMeansCode": { },
- "paymentDueDate": "2019-08-24T14:15:22Z",
- "paymentChannelCode": "string",
- "instructionNote": "string",
- "payeeFinancialAccountId": "string"
}
}
{- "branchId": null,
- "isSend": null,
- "recordType": "e-Arşiv Fatura : 0",
- "recordStatus": "Muhasebelesmedi : 0",
- "invoiceStatus": "Taslak : 0",
- "invoiceProcessStatus": "Faturalaştırılmamış : 0",
- "description": "string",
- "currentAccountIdentifier": "string",
- "currentAccountName": "string",
- "note": "string",
- "generalInfoModel": {
- "exchangeRateSource": "string",
- "exchangeRateComment": "string",
- "ettn": "string",
- "prefix": "string",
- "invoiceNumber": "string",
- "invoiceProfileType": { },
- "issueDate": "2019-08-24T14:15:22Z",
- "type": { },
- "returnInvoiceNumber": "string",
- "returnInvoiceDate": "2019-08-24T14:15:22Z",
- "currencyCode": "TRY",
- "exchangeRate": null
}, - "invoiceLines": [
- {
- "inventoryServiceId": null,
- "inventoryServiceCode": "string",
- "inventoryServiceType": null,
- "inventoryCard": "string",
- "inventoryInputUnitCodeId": null,
- "inventoryInputUnitCodeName": "string",
- "inventoryOutputUnitCodeId": null,
- "inventoryOutputUnitCodeName": "string",
- "warehouseId": null,
- "warehouseCode": "string",
- "warehouseName": "string",
- "expenseAccountId": null,
- "unitCode": "string",
- "unitCodeId": null,
- "unitPrice": null,
- "lineAmount": null,
- "taxes": [
- {
- "invoiceTaxSettingId": null,
- "withHoldingName": "string",
- "taxTypeCode": "string",
- "taxName": "string",
- "taxRate": null,
- "taxAmount": null,
- "vatExemptionReasonCode": "string",
- "vatExemptionReason": "string",
- "isWithHolding": null,
- "isNegative": null,
- "withHoldingId": null
}
], - "invoiceTaxSettingId": null,
- "despatchItemId": null,
- "despatchId": null,
- "despatchAmount": null,
- "despatchSerialNumbers": null,
- "serialNoEnabled": null,
- "amount": null,
- "discountRate": null,
- "discountAmount": null,
- "vatRate": null,
- "vatAmount": null,
- "vatExemptionReasonCode": "string",
- "vatExemptionReason": "string",
- "invoiceLineDeliveryInfoModel": {
- "deliveryTermsId": "string",
- "packagingTypeCode": "string",
- "packagingId": "string",
- "quantity": "string",
- "transportModeCode": "string",
- "requiredCustomsId": "string",
- "deliveryCountry": "string",
- "deliveryCity": "string",
- "deliveryDistrict": "string",
- "deliveryStreetName": "string",
- "deliveryBuildingNumber": "string",
- "deliveryBuildingName": "string",
- "deliveryPostalZone": "string",
- "airTransportId": "string",
- "roadTransportId": "string",
- "railTransportId": "string",
- "maritimeTransportId": "string"
}, - "serialNumberList": null
}
], - "paymentMeansModel": {
- "paymentMeansCode": { },
- "paymentDueDate": "2019-08-24T14:15:22Z",
- "paymentChannelCode": "string",
- "instructionNote": "string",
- "payeeFinancialAccountId": "string"
}, - "archiveInfoModel": {
- "isInternetSale": null,
- "websiteUrl": "string",
- "shipmentSenderTcknVkn": "string",
- "shipmentSendType": "string",
- "shipmentSenderName": "string",
- "shipmentSenderSurname": "string",
- "shipmentDate": "2019-08-24T14:15:22Z",
- "hideDespatchMessage": null,
- "subscriptionType": "string",
- "subscriptionTypeNumber": "string"
}
}
Gelen/Giden Fatura güncellemek için kullanılır. Özel Durumlar: 1)Giden Fatura kaydedileceği zaman tipi eFatura veya eArşiv ise Fatura Numarası otomatik olarak atanmaktadır. 2)Giden Fatura kaydedileceği zaman tipi eFatura olduğunda Senaryo (generalInfoModel.invoiceProfileType) alanı doldurulmalıdır. 3)Giden/Gelen Fatura kaydedileceği zaman döviz kuru (generalInfoModel.exchangeRate), Döviz kuru kaynağı (generalInfoModel.exchangeRateSource), döviz kuru açıklaması (generalInfoModel.exchangeRateComment) alanları Tanım (currentAccAccId) alanının para biriminin TL olmadığı durumlarda doldurulması zorunludur. 4)Giden Fatura kaydedileceği zaman tipi eFatura veya eArşiv ise Ön Ek(generalInfoModel.prefix) alanı doldurulması zorunlu alandır. 5)Gelen/Giden Fatura güncellemek için faturanın muhasebeleştirilmemiş olması gerekmektedir. 6)Fatura güncellemede ettn alanı aynı şekilde gönderildiğinde fatura güncellenecektir.
description required | string Açıklama |
currentAccountAlias | string Posta kutusu (E-Fatura durumunda zorunludur) |
currentAccountIdentifier required | string Alıcı firma VKN/TCKN bilgisi. 10 veya 11 karakter olarak, rakamlardan oluşacak şekilde girmelisiniz. |
currentAccountCode | string Aynı VKN/TCKN ye sahip birden fazla cari oluşturduysanız, bu carileri oluştururken vermiş olduğunuz kodu, bu alan ile göndererek, faturada hangi cariyi kullanmak istediğinizi seçebilirsiniz. |
isSend | bool Giden faturalar için bu alan true olarak gönderilmelidir. |
recordType | integer Enum: "e-Arşiv Fatura : 0" "e-Fatura : 1" Fatura türü |
note | string Not alanıdır, eğer notes içinde not gönderimi yaparsanız, bu alan ile gönderecekleriniz geçersiz olup, faturaya yazılmayacaktır. |
Array of objects Fatura içerisinde birden fazla not girildiğinde bu alan liste şeklinde not alanlarını getirir. | |
object Fatura içerisinde cari daha önce sistemde bulunmuyorsa, fatura modelinin içerisindeki bu alanı doldurarak gönderebilirsiniz. Bu model ile oluşan carinin hesap eşleştirmesini muhasebe arayüzünden yapmalısınız. Aksi durumda muhasebeleştirme adımında hata alırsınız. | |
object Faturaya ait genel bilgilerin bulunduğu alandır. | |
Array of objects Fatura kalemleri | |
object Fatura tipi E-arşiv seçildiği durumda doldurulan alandır. | |
object Bu elemana ödeme şekli ile ilgili bilgiler yazılabilecektir. |
{- "description": "string",
- "currentAccountAlias": "string",
- "currentAccountIdentifier": "string",
- "currentAccountCode": "string",
- "isSend": null,
- "recordType": "e-Arşiv Fatura : 0",
- "note": "string",
- "notes": [
- {
- "note": "string"
}
], - "currentAccount": {
- "name": "string",
- "identifier": "stringstri",
- "code": "string",
- "surname": "string",
- "taxOffice": "string",
- "maturity": 0,
- "mersisNumber": "string",
- "registrationNumber": "string",
- "professionalChamber": "string",
- "chamberRegistrationNumber": "string",
- "currentAccountAddress": {
- "isDefault": null,
- "addressName": "string",
- "subDivisionName": "string",
- "city": "string",
- "country": "string",
- "region": "string",
- "streetName": "string",
- "buildingName": "string",
- "buildingNumber": "string",
- "doorNumber": "string",
- "emailAddress": "user@example.com",
- "faxNumber": "stringstri",
- "phoneNumber": "stringstri",
- "postalZone": "string",
- "webSite": "string"
}
}, - "generalInfoModel": {
- "ettn": "string",
- "invoiceNumber": "string",
- "invoiceProfileType": "Temel : 0",
- "type": "Satış : 1",
- "currencyCode": "TRY",
- "issueDate": "2019-08-24T14:15:22Z",
- "exchangeRate": 5.7,
- "exchangeRateSource": "string",
- "exchangeRateComment": "string",
- "returnInvoiceNumber": "string",
- "returnInvoiceDate": "2019-08-24T14:15:22Z"
}, - "invoiceLines": [
- {
- "inventoryServiceCode": "string",
- "warehouseCode": "string",
- "lineExtensionAmount": null,
- "amount": null,
- "unitPrice": null,
- "unitCode": "string",
- "vatAmount": null,
- "vatRate": null,
- "vatExemptionReasonCode": "string",
- "discountAmount": null,
- "discountRate": null,
- "taxes": [
- {
- "invoiceTaxSettingId": null,
- "withHoldingName": "string",
- "taxTypeCode": "string",
- "taxName": "string",
- "taxRate": null,
- "taxAmount": null,
- "vatExemptionReasonCode": "string",
- "vatExemptionReason": "string",
- "isWithHolding": null,
- "isNegative": null,
- "withHoldingId": null
}
], - "invoiceLineDeliveryInfoModel": {
- "deliveryTermsId": "string",
- "packagingTypeCode": "string",
- "packagingId": "string",
- "quantity": "string",
- "transportModeCode": "string",
- "requiredCustomsId": "string",
- "deliveryCountry": "string",
- "deliveryCity": "string",
- "deliveryDistrict": "string",
- "deliveryStreetName": "string",
- "deliveryBuildingNumber": "string",
- "deliveryBuildingName": "string",
- "deliveryPostalZone": "string",
- "airTransportId": "string",
- "roadTransportId": "string",
- "railTransportId": "string",
- "maritimeTransportId": "string"
}, - "serialNumberList": null
}
], - "archiveInfoModel": {
- "isInternetSale": null,
- "websiteUrl": "string",
- "shipmentSenderTcknVkn": "string",
- "shipmentSendType": "ELEKTRONIK",
- "shipmentSenderName": "string",
- "shipmentSenderSurname": "string",
- "shipmentDate": null,
- "hideDespatchMessage": null,
- "subscriptionType": "HIZMETNO:Hizmet No",
- "subscriptionTypeNumber": "string"
}, - "paymentMeansModel": {
- "paymentMeansCode": { },
- "paymentDueDate": "2019-08-24T14:15:22Z",
- "paymentChannelCode": "string",
- "instructionNote": "string",
- "payeeFinancialAccountId": "string"
}
}
{- "branchId": null,
- "isSend": null,
- "recordType": "e-Arşiv Fatura : 0",
- "recordStatus": "Muhasebelesmedi : 0",
- "invoiceStatus": "Taslak : 0",
- "invoiceProcessStatus": "Faturalaştırılmamış : 0",
- "description": "string",
- "currentAccountIdentifier": "string",
- "currentAccountName": "string",
- "note": "string",
- "generalInfoModel": {
- "exchangeRateSource": "string",
- "exchangeRateComment": "string",
- "ettn": "string",
- "prefix": "string",
- "invoiceNumber": "string",
- "invoiceProfileType": { },
- "issueDate": "2019-08-24T14:15:22Z",
- "type": { },
- "returnInvoiceNumber": "string",
- "returnInvoiceDate": "2019-08-24T14:15:22Z",
- "currencyCode": "TRY",
- "exchangeRate": null
}, - "invoiceLines": [
- {
- "inventoryServiceId": null,
- "inventoryServiceCode": "string",
- "inventoryServiceType": null,
- "inventoryCard": "string",
- "inventoryInputUnitCodeId": null,
- "inventoryInputUnitCodeName": "string",
- "inventoryOutputUnitCodeId": null,
- "inventoryOutputUnitCodeName": "string",
- "warehouseId": null,
- "warehouseCode": "string",
- "warehouseName": "string",
- "expenseAccountId": null,
- "unitCode": "string",
- "unitCodeId": null,
- "unitPrice": null,
- "lineAmount": null,
- "taxes": [
- {
- "invoiceTaxSettingId": null,
- "withHoldingName": "string",
- "taxTypeCode": "string",
- "taxName": "string",
- "taxRate": null,
- "taxAmount": null,
- "vatExemptionReasonCode": "string",
- "vatExemptionReason": "string",
- "isWithHolding": null,
- "isNegative": null,
- "withHoldingId": null
}
], - "invoiceTaxSettingId": null,
- "despatchItemId": null,
- "despatchId": null,
- "despatchAmount": null,
- "despatchSerialNumbers": null,
- "serialNoEnabled": null,
- "amount": null,
- "discountRate": null,
- "discountAmount": null,
- "vatRate": null,
- "vatAmount": null,
- "vatExemptionReasonCode": "string",
- "vatExemptionReason": "string",
- "invoiceLineDeliveryInfoModel": {
- "deliveryTermsId": "string",
- "packagingTypeCode": "string",
- "packagingId": "string",
- "quantity": "string",
- "transportModeCode": "string",
- "requiredCustomsId": "string",
- "deliveryCountry": "string",
- "deliveryCity": "string",
- "deliveryDistrict": "string",
- "deliveryStreetName": "string",
- "deliveryBuildingNumber": "string",
- "deliveryBuildingName": "string",
- "deliveryPostalZone": "string",
- "airTransportId": "string",
- "roadTransportId": "string",
- "railTransportId": "string",
- "maritimeTransportId": "string"
}, - "serialNumberList": null
}
], - "paymentMeansModel": {
- "paymentMeansCode": { },
- "paymentDueDate": "2019-08-24T14:15:22Z",
- "paymentChannelCode": "string",
- "instructionNote": "string",
- "payeeFinancialAccountId": "string"
}, - "archiveInfoModel": {
- "isInternetSale": null,
- "websiteUrl": "string",
- "shipmentSenderTcknVkn": "string",
- "shipmentSendType": "string",
- "shipmentSenderName": "string",
- "shipmentSenderSurname": "string",
- "shipmentDate": "2019-08-24T14:15:22Z",
- "hideDespatchMessage": null,
- "subscriptionType": "string",
- "subscriptionTypeNumber": "string"
}
}
Gelen/Giden Faturaları silmek için kullanılır. Muhasebeleştirilmiş faturalar ve e-faturalar silinemez.
ettn required | string Fatura ettn'si. |
isSend required | bool Enum: "Giden - true" "Gelen - false" Gelen/Giden Fatura kontrolü |
[- null
]
{- "Error": "string"
}
Gelen/Giden Fatura Muhasebeleştirmek için kullanılır. Kalemi bulunmayan veya iptal edilen Faturalar muhasebeleştirilemez.
ettn required | string Fatura ettn'si. |
isSend required | bool Enum: "Giden - true" "Gelen - false" Gelen/Giden Fatura kontrolü |
[- {
- "ettn": "string",
- "isSend": "Giden - true"
}
]
{- "Error": "string"
}
Gelen/Giden Fatura Ters Kayıt için kullanılır. Ters kayıt alınması için muhasebeleştirilmiş fatura olması gerekmektedir.
ettn required | string Fatura ettn'si. |
isSend required | bool Enum: "Giden - true" "Gelen - false" Gelen/Giden Fatura kontrolü |
[- {
- "ettn": "string",
- "isSend": "Giden - true"
}
]
{- "Error": "string"
}
Gelen/Giden ÖKC/Kasa fişi işlemleri. İhtiyaç duyulması durumunda dokümanda ekleme yapılacaktır.
Hizmet/Masraf kart işlemleri. İhtiyaç duyulması durumunda dokümanda ekleme yapılacaktır.
Muhasebe işlemlerinin kaydedilmesinde kullanılan, belirli bir sisteme göre hazırlanmış hesapların yer aldığı listedir. Tek Düzen Hesap Planına göre çalışmaktadır.
Hesapların sayfalı yapıda listelenmesi için kullanılır.
pageIndex | integer Başlangıç sayfasının indis bilgisi. |
pageSize | integer Çekmek istediğiniz sayfada kaç adet kayıt olması gerektiğini belirtir. Tek seferde max 500 kayıttır. |
sortedColumn | string Kayıtlar belirteceğiniz alan adına göre sıralanır. |
filterQuery | string Arayüzlerde bulunan filtreleme fonksiyonlarını kullanmak için bu alan kullanılır. örnek kullanım olarak filterQuery: [{"category":"Code","operator":"eşittir","value":"120.10.100"}] category için aramak istediğiniz alan adı, operator için (eşittir, eşittir değildir, içeren, içermeyen, ile başlayan, ile başlamayan) gibi seçenekleriniz bulunuyor. value içinde aramak istediğiniz değeri yazınız. filterQuery arayüz için tasarlanmış fakat basit seviyede ve bazı alanlar için servis desteği vermektedir. Alanları mutlaka test ederek canlı ortamda kullanmalısınız. |
isDesc | bool Sıralama büyükten küçüğe ise true, küçükten büyüğe ise false olarak gönderebilirsiniz. |
{- "pageIndex": 0,
- "pageSize": 0,
- "totalCount": 0,
- "totalPages": 0,
- "hasNextPage": null,
- "hasPreviousPage": null,
- "items": [
- {
- "id": null,
- "parentId": null,
- "type": "Kebir (Ana hesap) - 0",
- "name": "string",
- "code": "string",
- "unitCode": "string",
- "isBundleAccount": "Hayır : 0",
- "currencyCodeId": "string",
- "hasChild": null
}
]
}
Hesap eklemek için kullanılan uç noktasıdır. Eklenen hesap , tekrardan eklenemez.
baseCode required | string Ana hesap kod bilgisidir. |
name required | string Hesap adı bilgisi. |
type required | byte Enum: "Kebir (Ana hesap) - 0" "Grup (Ara hesap) - 1" "Muavin (Alt hesap) - 2" Hesap tipi bilgisi. |
parentId | long Bağlı olduğu hesabın Id bilgisi. |
code | string Hesap kod bilgisi, ara ve alt hesap işlemleri için zorunludur. Eklemeye çalıştığınız hesabın , bir üst hesap kod bilgisi yazılır. Örnek : 120.10.100 alt hesabını ekleme işlemi yapın, bu hesabı 120.10 ara hesabına bağlanacak olsun, code bilgisine 120.10 yazılır. |
unitCode | string Hesabın , bağlı olduğu hesaptan , ayıran kod bilgisidir. Örnek: 120 ana hesabına bağlı 120.10 ara hesabının unitCode bilgisi 10 'dur, veya 120.10 ara hesabına bağlı, 120.10.100 alt hesabının unitCode bilgisi 100'dür. |
isBundleAccount | bool Enum: "Hayır : 0" "Evet : 1" Hesabın havuz (torba) hesap bilgisi, sadece alt (muavin) hesaplarda bu seçim yapılmaktadır. Havuz hesaplar, birden fazla cari ile eşleştirilebilirler. Havuz olmayan hesaplar, sadece bir tane cari ile ilişkilendirilebilirler. |
currencyCodeId | int Hesabın para birimi bilgisi. Alt hesaplar için zorunlu bir alandır. |
{- "baseCode": "string",
- "name": "string",
- "type": "Kebir (Ana hesap) - 0",
- "parentId": null,
- "code": "string",
- "unitCode": "string",
- "isBundleAccount": "Hayır : 0",
- "currencyCodeId": null
}
{- "id": null,
- "parentId": null,
- "type": "Kebir (Ana hesap) - 0",
- "name": "string",
- "code": "string",
- "unitCode": "string",
- "isBundleAccount": "Hayır : 0",
- "currencyCodeId": "string",
- "hasChild": null
}
Hesap güncellemek için kullanılan uç noktasıdır.Kullanılan bir hesap güncellenemez.Birden fazla cari ile ilişkilendirilen hesap , havuz hesap (torba hesap) değil olarak güncellenemez.
id required | long Hesap kaydınıza ait Id bilgisi. |
code | string Hesap kod bilgisi, Ana hesap güncellemesi yapılıyor ise zorunludur. Ara ve alt hesaplar için doldurulmasına gerek yoktur. |
baseCode | string Bağlı olduğu hesap kod bilgisidir. Ara ve Alt hesap güncellemesi yapılıyor zorunludur, Ana hesap için doldurulmasına gerek yoktur. |
unitCode | string Hesabın , bağlı olduğu hesaptan , ayıran kod bilgisidir. Ara ve Alt hesap güncellemesi yapılıyor zorunludur, Ana hesap için doldurulmasına gerek yoktur. Örnek: 120 ana hesabına bağlı 120.10 ara hesabının unitCode bilgisi 10 'dur, veya 120.10 ara hesabına bağlı, 120.10.100 alt hesabının unitCode bilgisi 100'dür. |
name | string Hesap adı bilgisi. |
type | byte Enum: "Kebir (Ana hesap) - 0" "Grup (Ara hesap) - 1" "Muavin (Alt hesap) - 2" Hesap tipi bilgisi. Ara ve Alt hesap güncellemesi yapılıyor zorunludur, Ana hesap için doldurulmasına gerek yoktur. |
isBundleAccount | bool Enum: "Hayır : 0" "Evet : 1" Hesabın havuz (torba) hesap bilgisi, sadece alt (muavin) hesaplarda bu seçim yapılmaktadır. Havuz hesaplar, birden fazla cari ile eşleştirilebilirler. Havuz olmayan hesaplar, sadece bir tane cari ile ilişkilendirilebilirler. |
currencyCodeId | int Hesabın para birimi bilgisi. Alt hesaplar için zorunlu bir alandır. |
{- "code": "string",
- "baseCode": "string",
- "unitCode": "string",
- "name": "string",
- "type": "Kebir (Ana hesap) - 0",
- "isBundleAccount": "Hayır : 0",
- "currencyCodeId": null
}
{- "id": null,
- "parentId": null,
- "type": "Kebir (Ana hesap) - 0",
- "name": "string",
- "code": "string",
- "unitCode": "string",
- "isBundleAccount": "Hayır : 0",
- "currencyCodeId": "string",
- "hasChild": null
}
Fiş Hareketi Listeleme
pageIndex | integer Başlangıç sayfasının indis bilgisi. |
pageSize | integer Çekmek istediğiniz sayfada kaç adet kayıt olması gerektiğini belirtir. Tek seferde max 500 kayıttır. |
sortedColumn | string Kayıtlar belirteceğiniz alan adına göre sıralanır. |
filterQuery | string Arayüzlerde bulunan filtreleme fonksiyonlarını kullanmak için bu alan kullanılır. örnek kullanım olarak filterQuery: [{"category":"EntryComment","operator":"içeren","value":"fatura"}] veya filterQuery: [{"category":"Type","operator":"eşittir","value":"3"}] category için aramak istediğiniz alan adı, operator için (eşittir, eşittir değildir, içeren, içermeyen, ile başlayan, ile başlamayan) gibi seçenekleriniz bulunuyor. value içinde aramak istediğiniz değeri yazınız. filterQuery arayüz için tasarlanmış fakat basit seviyede ve bazı alanlar için servis desteği vermektedir. Alanları mutlaka test ederek canlı ortamda kullanmalısınız. |
isDesc | bool Sıralama büyükten küçüğe ise true, küçükten büyüğe ise false olarak gönderebilirsiniz. |
{- "pageIndex": 0,
- "pageSize": 0,
- "totalCount": 0,
- "totalPages": 0,
- "hasNextPage": null,
- "hasPreviousPage": null,
- "items": [
- {
- "id": null,
- "branchId": null,
- "enteredDate": null,
- "entryComment": "string",
- "entryNumber": null,
- "recordStatus": "Muhasebelesmedi : 0",
- "totalCredit": null,
- "totalDebit": null,
- "type": "Mahsup : 0",
- "createDate": null,
- "entryTransaction": [
- {
- "id": null,
- "accountCode": "string",
- "currentAccountIdentifier": "string",
- "credit": null,
- "debit": null,
- "documentDate": null,
- "documentNumber": "string",
- "documentType": "Çek : 0",
- "documentTypeDescription": "string",
- "detailComment": "string",
- "expirationDate": null
}
]
}
]
}
Fiş Hareketi oluşturmak için en az 2 Fiş Kalemi eklenmelidir. İlgili Mali Dönem içinde sadece 1 kere Açılış ve Kapanış Fişi atanabilir.
enteredDate required | datetime <datetime> Fiş tarihi |
entryComment | string <string> Fiş açıklaması |
type required | byte Enum: "Mahsup : 0" "Tediye : 1" "Tahsil : 2" "Açılış : 3" "Kapanış :4" Fiş tipi |
Array of objects Fiş kalemleri |
{- "enteredDate": null,
- "entryComment": "string",
- "type": "Mahsup : 0",
- "entryTransactions": [
- {
- "accountCode": "string",
- "currentAccountIdentifier": "string",
- "currentAccountCode": "string",
- "credit": null,
- "debit": null,
- "documentDate": null,
- "documentNumber": "string",
- "documentType": "Çek : 0",
- "documentTypeDescription": "string",
- "detailComment": "string",
- "amountOriginalCurrencyCode": null,
- "amountOriginalExchangeRate": null,
- "amountOriginalExchangeRateComment": "string",
- "amountOriginalExchangeRateDate": null,
- "expirationDate": null,
- "lineNumber": null
}
]
}
{- "id": null,
- "branchId": null,
- "branchName": "string",
- "callType": null,
- "createDate": null,
- "customerId": null,
- "documentNumber": "string",
- "documentType": "Çek",
- "enteredBy": null,
- "enteredName": "string",
- "enteredDate": null,
- "enteredTransactionCode": "string",
- "entryTransactions": [
- {
- "accountCode": "string",
- "currentAccountIdentifier": "string",
- "currentAccountCode": "string",
- "credit": null,
- "debit": null,
- "documentDate": null,
- "documentNumber": "string",
- "documentType": "Çek : 0",
- "documentTypeDescription": "string",
- "detailComment": "string",
- "amountOriginalCurrencyCode": null,
- "amountOriginalExchangeRate": null,
- "amountOriginalExchangeRateComment": "string",
- "amountOriginalExchangeRateDate": null,
- "expirationDate": null,
- "lineNumber": null
}
], - "entryComment": "string",
- "entryNumber": null,
- "recordStatus": null,
- "otoUpdateEditMode": null,
- "relatedObjectId": null,
- "relatedObjectType": null,
- "reverseDebitCredit": null,
- "totalCredit": null,
- "totalDebit": null,
- "type": "Mahsup",
- "typeName": "string",
- "status": null,
- "createDateUtc": null,
- "updateDateUtc": null
}