Cari Kart | Client Card
POST
http://yourdomain/MaxiApi/Client/ClientTransfer
Logo Firma Bilgileri | Logo Company Information
Birden Fazla Firmaya Gönderim Yapılabilir. Renkli Parametreler Zorunlu Alanlardır
| ParametreParameter | TipType | AçıklamaDescription |
|---|---|---|
| FirmID | int | Logo Firma NumarasıLogo Firm Number |
| PeriodNo | int | Logo Firma Dönem NumarasıLogo Firm Term Number |
MainParams Parametreleri | MainParams Parameters
Çoklu Gönderim Yapılabilir. Renkli Parametreler Zorunlu Alanlardır
| ParametreParameter | TipType | AçıklamaDescription | UzunlukLength | ||||||
|---|---|---|---|---|---|---|---|---|---|
| SourceID | string | Cari Kaynak ParametresiClient Source parameter | 8 | ||||||
| ClientRefNo | int | Yeni Kayıtlar İçin 0, Güncellemeler için Kayıt Sonrası Geri Bildirimi Yapılan Referans Numarası Girilmelidir (Sabit 0)0 For New Records, After Registration Reference Number Must Be Entered For Updates (Fixed 0) | - | ||||||
| ClientCode | string | Cari Hesap KoduClient Code | 16 | ||||||
| GLCode | string | Cari Muhasebe Hesap KoduClient Accounting Code | 100 | ||||||
| ClientType | int |
Şahıs Şirketi Sole Proprietorship
|
|||||||
| EInvoiceClient | string |
E-Fatura Carisi EInvoice Client
|
|||||||
| ClientProfile | string |
Senaryo (eFatura Carisi için Belirtilmelidir) Scenario (Must Be Specified for eInvoice Current)
|
|||||||
| PostLabel | string | Posta Kutusu Etiketi (eFatura Carisi için Belirtilmelidir)Mailbox Label (Must Be Specified for eInvoice Current) | 50 | ||||||
| SenderLabel | string | Gönderici Birim Etiketi (eFatura Carisi için Belirtilmelidir) Sender Unit Label (Must Be Specified for eInvoice Current) | 50 | ||||||
| ClientCountryType | int |
Yabancı Uyruklu Foreign Citizen
|
|||||||
| TaxNr | string | Vergi NumarasıTax Number | 15 | ||||||
| Description | string | Cari Hesap UnvanıClient Title | 200 | ||||||
| TckNo | string | TC Kimlik NoTurkish Republic Identity Number | 15 | ||||||
| TaxOffice | string | Vergi DairesiTax Office | 30 | ||||||
| Name | string | Cari AdıName | 50 | ||||||
| Surname | string | Cari SoyadıSurname | 50 | ||||||
| Addr1 | string | Adres 1Address 1 | 200 | ||||||
| Addr2 | string | Adres 2Address 2 | 200 | ||||||
| CityCode | string | İl KoduCity Code | 12 | ||||||
| City | string | İlCity | 20 | ||||||
| CountryCode | string | Ülke KoduCountry Code | 12 | ||||||
| Country | string | ÜlkeCountry | 20 | ||||||
| District | string | SemtDistrict | 50 | ||||||
| Town | string | İlçeTown | 50 | ||||||
| Phone1 | string | Telefon No 1Phone 1 | 50 | ||||||
| Phone2 | string | Telefon No 2Phone 2 | 50 | ||||||
| string | E-Posta 1Email | 250 | |||||||
| Email2 | string | E-Posta 2Email 2 | 250 | ||||||
| PostalCode | string | Posta KoduPostal Code | 10 | ||||||
| PaymentCode | string | Cari Ödeme KoduPayment Code | 16 | ||||||
| CostCenterCode | string | Masraf Merkezi KoduCost Center Code | 50 | ||||||
| AuthorizationCode | string | Yetki KoduAuthorization Code | - | ||||||
| DataTransferNumber | string | Veri Aktarım NoData Transfer Number | - | ||||||
| ProjectCode | string | Proje KoduProject Code | - | ||||||
| SpecialCode | string | Özel KodSpecial Code | - | ||||||
| SpecialCode2 | string | Özel Kod 2Special Code 2 | - | ||||||
| SpecialCode3 | string | Özel Kod 3Special Code 3 | - | ||||||
| SpecialCode4 | string | Özel Kod 4Special Code 4 | - | ||||||
| SpecialCode5 | string | Özel Kod 5Special Code 5 | - | ||||||
| RiskTracCalcCurrency | string |
Risk Takibi Hesaplama Para Birimi Risk Tracking Calculation Currency
|
|||||||
| RiskType | string |
Risk Tipi Risk Type
|
|||||||
| DeductCstChqPromNt | string |
Müşteri Çek Senetleri Açık Hesaptan Düşülsün Deduct Customer Cheque Promissory Notes From Open Account
|
|||||||
| DeductTurnoverCstChqPromNt | string |
Müşteri Ciro Çek Senetleri Açık Hesaptan Düşülsün Deduct Customer Turnover Cheque Promissory Notes From Open Account
|
|||||||
| IsDespClient | string |
e-İrsaliye Kullanıcısı e-Dispatch User
|
|||||||
| DespPostLabelCode | string | e-İrsaliye Posta Kutusu Etiketie-Dispatch Mailbox Label | - | ||||||
| DespSenderLabelCode | string | e-İrsaliye Gönderici Birim Etiketie-Dispatch Sender Unit Label | - | ||||||
Banka Bilgileri | Bank information
BankInfoList[]
Çoklu Gönderim Yapılabilir. Renkli Parametreler Zorunlu Alanlardır
Çoklu Gönderim Yapılabilir. Renkli Parametreler Zorunlu Alanlardır
| ParametreParameter | TipType | AçıklamaDescription | UzunlukLength | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BankCodeBranch | string | Banka Kodu ve Şube KoduBank Code and Branch Code | - | ||||||||||
| BankName | string | Banka AdıBank Name | - | ||||||||||
| BankAccount | string | Banka Hesap NoBank Account Number | - | ||||||||||
| BankIBAN | string | IBANIBAN | - | ||||||||||
| BankBICode | string | Banka BI KoduBank BI Code | - | ||||||||||
| BankAccountCurrency | int |
Banka Hesabı Döviz Türü Bank Account Currency Code
|
|||||||||||
| IsEBank | bool | E-BankacılıkE-Banking | - | ||||||||||
Risk Takibi Yapılacak İşaretleri | Signs to Tracking Risk
RiskTrackingSign
Sadece Bu Değerleri Alabilir / Can Only Take These Values 0: Hayır / No, 1: Evet / Yes
| ParametreParameter | TipType | AçıklamaDescription | UzunlukLength |
|---|---|---|---|
| OpenAccount | string | Açık HesapOpen Account | 1 |
| OurOwnCheqPromNts | string | Kendi Çek/SenetlerimizOur Own Cheques/Promissory Notes | 1 |
| CstOwnCheqPromNts | string | Müşteri Çek/SenetleriCustomer Cheques/Promissory Notes | 1 |
| Waybill | string | İrsaliyeWaybill | 1 |
| OrderCanBeShipped | string | Sipariş (Sevk Edilebilir)Order (Can Be Shipped) | 1 |
| OrderSuggestion | string | Sipariş (Öneri)Order(Suggestion) | 1 |
| TurnoverCheqPromNts | string | Ciro Çek/SenetleriTurnover Cheques/Promissory Notes | 1 |
| WaybillSuggestion | string | İrsaliye ÖneriWaybill Suggestion | 1 |
Çek Senet Risk Oranları | Cheque And Promissory Note Risk Rates
ChequeAndPromissoryNoteRiskRates
| ParametreParameter | TipType | AçıklamaDescription | UzunlukLength |
|---|---|---|---|
| OwnChequeRate | double | Kendi Çek OranOwn Cheque Rate | - |
| OwnPromNtRate | double | Kendi Senet OranOwn Promissory Note Rate | - |
| CstChequeRate | double | Müşteri Çek OranCustomer Cheque Rate | - |
| CstPromNtRate | double | Müşteri Senet OranCustomer Promissory Note Rate | - |
| CstTurnoverChequeRate | double | Müşteri Ciro Çek OranCustomer Turnover Cheque Rate | - |
| CstTurnoverPromNtRate | double | Müşteri Ciro Senet OranCustomer Turnover Promissory Note Rate | - |
Risk Limiti Aşıldığında | When Risk Limit Is Exceeded
WhenRiskLimitIsExceeded
Sadece Aşağıdaki Değerleri Alabilir | Can Only Take the Following Values
(0) İşlem Yapılmayacak | No Action Will Be Taken
(1) Kullanıcı Uyarılacak | User Will Be Warned
(2) İşlem Durdurulacak | Transaction Will Be Stopped
| ParametreParameter | TipType | AçıklamaDescription | UzunlukLength |
|---|---|---|---|
| InOpenAccount | int | Açık HesaptaIn Open Account | - |
| InCstChqPromNts | int | Müşteri Çek SenetlerindeIn Customer Cheque Promissory Notes | - |
| InOwnChqPromNts | int | Kendi Çek SenetlerimizdeIn Own Cheque Promissory Notes | - |
| InCstTurnoverChqPromNts | int | Müşteri Ciro Çek SenetlerindeIn Customer Turnover Cheque Promissory Notes | - |
| SuggOnTheWaybill | int | İrsaliyede ÖneriSuggestion On The Waybill | - |
| OnTheWaybill | int | İrsaliyedeOn The Waybill | - |
| SuggOnOrder | int | Siparişte ÖneriSuggestion on Order | - |
| OnOrder | int | SiparişteOn Order | - |
Risk Limitleri | Risk Limits
RiskLimits
| ParametreParameter | TipType | AçıklamaDescription | UzunlukLength |
|---|---|---|---|
| OpenAccountLimit | double | Açık Hesap LimitiOpen Account Limit | - |
| OwnChqPromNtRiskLimit | double | Kendi Çek Senetlerimiz Risk LimitiOwn Cheque Promissory Notes Risk Limit | - |
| CstChqPromNtRiskLimit | double | Müşteri Çek Senetleri Risk LimitiCustomer Cheque Promissory Notes Risk Limit | - |
| CstTurnoverChqPromNtRiskLimit | double | Müşteri Ciro Çek Senetleri Risk LimitiCustomer Turnover Cheque Promissory Notes Risk Limit | - |
| WaybillRiskLimit | double | İrsaliye Risk LimitiWaybill Risk Limit | - |
| WaybillRiskLimitSugg | double | İrsaliye Risk Limiti ÖneriWaybill Risk Limit Suggestion | - |
| OrderRiskLimitCanBeShipped | double | Sipariş Risk Limiti Sevk EdilebilirOrder Risk Limit Can Be Shipped | - |
| OrderRiskLimitSugg | double | Sipariş Risk Limiti ÖneriOrder Risk Limit Suggestion | - |
Kapanan Riskler | Closed Risks
ClosedRisks
| ParametreParameter | TipType | AçıklamaDescription | UzunlukLength |
|---|---|---|---|
| OpenAccount | double | Açık HesapOpen Account | - |
| OwnChqPromNts | double | Kendi Çek SenetlerimizOwn Cheque Promissory Notes | - |
| CstChqPromNts | double | Müşteri Çek SenetlerimizCustomer Cheque Promissory Notes | - |
| CstTurnoverChqPromNts | double | Müşteri Ciro Çek SenetlerimizCustomer Turnover Cheque Promissory Notes | - |
| Waybill | double | İrsaliyeWaybill | - |
| WaybillSuggestion | double | İrsaliye ÖneriWaybill Suggestion | - |
| OrderCanBeShipped | double | Sipariş Sevk EdilebilirOrder Can Be Shipped | - |
| OrderSuggestion | double | Sipariş ÖneriOrder Suggestion | - |
Örnek (JSON) | Example (JSON)
Request
[
{
"FirmID": 2,
"PeriodNo": 1,
"MainParams":
[
{
"SourceID": "122",
"ClientRefNo": 0,
"ClientCode": "120.01.01.001",
"GLCode": "120.01.01.001",
"ClientType": 1,
"EInvoiceClient": "1",
"ClientProfile": "0",
"PostLabel": "urn:mail:defaultpk@xxxxxx.com",
"SenderLabel": "urn:mail:defaultgb@xxxxx.com",
"ClientCountryType": 0,
"TaxNr": "VG12345678",
"Description": "Test Carisi",
"TckNo": "12345678910",
"TaxOffice": "TUZLA",
"Name": "TestAdi",
"Surname": "Soyadi",
"Addr1": "Adres 1 ",
"Addr2": "Adres 2",
"CityCode": "",
"City": "İstanbul",
"CountryCode": "TR",
"Country": "Türkiye",
"District": "",
"Town": "Pendik",
"Phone1": "5011234567",
"Phone2": "5551234567",
"Email": "posta@posta.com",
"Email2": "posta2@posta.com",
"PostalCode": "34001",
"PaymentCode": "OD15",
"CostCenterCode": "",
"RiskTracCalcCurrency":0,
"RiskType":2,
"DeductCstChqPromNt": "1",
"DeductTurnoverCstChqPromNt": "1",
"IsDespClient": "0",
"DespPostLabelCode": "",
"DespSenderLabelCode": "",
"BankInfoList":[
{
"BankCodeBranch": "0001-0001",
"BankName": "testbanka",
"BankAccount": "12345",
"BankIBAN": "TR800006275673648672926418",
"BankBICode": "BC001",
"BankAccountCurrency": "1",
"IsEBank": "false"
},
{
"BankCodeBranch": "0001-0001",
"BankName": "testbanka",
"BankAccount": "12345",
"BankIBAN": "TR170006224764855856179292",
"BankBICode": "BC001",
"BankAccountCurrency": "160",
"IsEBank": "true"
}
],
"RiskTrackingSign": {
"OpenAccount": "0",
"OurOwnCheqPromNts": "1",
"CstOwnCheqPromNts": "0",
"Waybill": "1",
"OrderCanBeShipped": "0",
"OrderSuggestion": "1",
"TurnoverCheqPromNts": "0",
"WaybillSuggestion": "1"
},
"ChequeAndPromissoryNoteRiskRates": {
"OwnChequeRate": 1.1,
"OwnPromNtRate": 1.2,
"CstChequeRate": 1.3,
"CstPromNtRate": 1.4,
"CstTurnoverChequeRate": 1.5,
"CstTurnoverPromNtRate": 1.6
},
"WhenRiskLimitIsExceeded": {
"InOpenAccount": 0,
"InCstChqPromNts": 1,
"InOwnChqPromNts": 2,
"InCstTurnoverChqPromNts": 0,
"SuggOnTheWaybill": 1,
"OnTheWaybill": 2,
"SuggOnOrder": 0,
"OnOrder": 1
},
"RiskLimits": {
"OpenAccountLimit": "100.1",
"OwnChqPromNtRiskLimit": "100.2",
"CstChqPromNtRiskLimit": "100.3",
"CstTurnoverChqPromNtRiskLimit": "100.4",
"WaybillRiskLimit": "100.5",
"WaybillRiskLimitSugg": "100.6",
"OrderRiskLimitCanBeShipped": "100.7",
"OrderRiskLimitSugg": "100.8"
},
"ClosedRisks": {
"OpenAccount": 200.1,
"OwnChqPromNts": 200.2,
"CstChqPromNts": 200.3,
"CstTurnoverChqPromNts": 200.4,
"Waybill": 200.5,
"WaybillSuggestion": 200.6,
"OrderCanBeShipped": 200.7,
"OrderSuggestion": 200.8
}
}
]
}
]
Response
{
"TransferStatus": true,
"TransferMessage": "Transfer Completed!",
"Responseline": [
{
"SourceID": 122,
"Isucceed": true,
"RecordRef": "1231",
"RecordFicheNo": null,
"ResponseMsg": "Cari aktarımı başarılı."
}
]
}
Geri Dönüş Parametreleri | Response Parameters
| ParametreParameter | TipType | AçıklamaDescription |
|---|---|---|
| TransferStatus | bool | API Erişim DurumuApi Access Status |
| TransferMessage | string | Aktarım Genel Bilgi MesajıTransfer Information Message |
| SourceID | string | Cari Kaynak ParametresiClient Source Parameter |
| Isucceed | bool | Cari Kart Aktarım Durum BilgisiClient Card Transfer Status Information |
| RecordRef | string | Aktarılan Cari Kart Hedef Kayıt NoTransferred Client Card Destination Registration Number |
| RecordFicheNo | string | Aktarılan Cari Kart NoTransferred Client Card Number |
| ResponseMsg | string | Cari Kart Aktarım MesajıClient Card Transfer Message |