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ı Girilmelidir0 For New Records, After Registration Reference Number Must Be Entered For Updates | - | ||||||||||
| ClientCode | string | Cari Hesap KoduClient Code | 16 | ||||||||||
| AccountType | int |
Cari Hesap Türü Account Type
|
|||||||||||
| ParentAccountCode | string | Grup Şirketi KoduGroup Company Code | - | ||||||||||
| EBusinessCode | string | E-İş KoduE-Business Code | - | ||||||||||
| ContactPerson | string | İlgili KişiContact Person | - | ||||||||||
| 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 | ||||||||||
| Description2 | string | Cari Hesap Unvanı 2Client Title 2 | 200 | ||||||||||
| TckNo | string | TC Kimlik NoTurkish Republic Identity Number | 15 | ||||||||||
| TaxOffice | string | Vergi DairesiTax Office | 30 | ||||||||||
| TradingGrp | string | Ticari İşlem GrubuCommercial Transaction Group | 30 | ||||||||||
| Name | string | Cari AdıName | 50 | ||||||||||
| Surname | string | Cari SoyadıSurname | 50 | ||||||||||
| Currency | string |
Döviz Tipi Currency Type
|
|||||||||||
| 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 | ||||||||||
| Email3 | string | E-Posta 3Email 3 | 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 | - |
Form Teslim Bilgileri | Form Submission Information
FormSubmissionInfo
| ParametreParameter | TipType | AçıklamaDescription | UzunlukLength | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| *Ortak/Common | int |
Gönderim Yöntemi Send Method
|
|||||||||||
| *Ortak/Common | int |
Gönderim Formatı Send Format
|
|||||||||||
| DispSendMode | int | İrsaliye Gönderim YöntemiDispatch Send Method | - | ||||||||||
| DispEmail | string | İrsaliye E-postaDispatch E-mail | - | ||||||||||
| DispFax | string | İrsaliye FaksDispatch Fax | - | ||||||||||
| DispSendFormat | int | İrsaliye Gönderim FormatıDispatch Send Format | - | ||||||||||
| OrdSendMode | int | Sipariş Gönderim YöntemiOrder Send Method | - | ||||||||||
| OrdEmail | string | Sipariş E-postaOrder E-mail | - | ||||||||||
| OrdFax | string | Sipariş FaksOrder Fax | - | ||||||||||
| OrdSendFormat | int | Sipariş Gönderim FormatıOrder Send Format | - | ||||||||||
| InvSendMode | int | Fatura Gönderim YöntemiInvoice Send Method | - | ||||||||||
| InvEmail | string | Fatura E-postaInvoice E-mail | - | ||||||||||
| InvFax | string | Fatura FaksInvoice Fax | - | ||||||||||
| InvSendFormat | int | Fatura Gönderim FormatıInvoice Send Format | - | ||||||||||
| RemSendMode | int | İhtar Gönderim YöntemiReminder Send Method | - | ||||||||||
| RemEmail | string | İhtar E-postaReminder E-mail | - | ||||||||||
| RemFax | string | İhtar FaksReminder Fax | - | ||||||||||
| RemSendFormat | int | İhtar Gönderim FormatıReminder Send Format | - | ||||||||||
| LtrSendMode | int | Mektup Gönderim YöntemiLetter Send Method | - | ||||||||||
| LtrEmail | string | Mektup E-postaLetter E-mail | - | ||||||||||
| LtrFax | string | Mektup FaksLetter Fax | - | ||||||||||
| LtrSendFormat | int | Mektup Gönderim FormatıLetter Send Format | - | ||||||||||
| FBSSendMode | int | FBS Mutabakat Gönderim YöntemiFBS Aggr Send Method | - | ||||||||||
| FBSEmail | string | FBS Mutabakat E-postaFBS Aggr E-mail | - | ||||||||||
| FBSSendFormat | int | FBS Mutabakat Gönderim FormatıFBS Aggr Send Format | - | ||||||||||
| FBASendMode | int | FBA Mutabakat Gönderim YöntemiFBA Aggr Send Method | - | ||||||||||
| FBAEmail | string | FBA Mutabakat E-postaFBA Aggr E-mail | - | ||||||||||
| FBASendFormat | int | FBA Mutabakat Gönderim FormatıFBA Aggr Send Format | - | ||||||||||
| OfrSendMode | int | Teklif/Sözleşme Gönderim YöntemiOffer/Contract Send Method | - | ||||||||||
| OfrEmail | string | Teklif/Sözleşme E-postaOffer/Contract E-mail | - | ||||||||||
| OfrFax | string | Teklif/Sözleşme FaksOffer/Contract Fax | - | ||||||||||
| OfrSendFormat | int | Teklif/Sözleşme Gönderim FormatıOffer/Contract Send Format | - | ||||||||||
| ExtSendMode | int | Ekstre Gönderim YöntemiExtract Send Method | - | ||||||||||
| ExtEmail | string | Ekstre E-postaExtract E-mail | - | ||||||||||
| ExtFax | string | Ekstre FaksExtract Fax | - | ||||||||||
| ExtSendFormat | int | Ekstre Gönderim FormatıExtract Send Format | - | ||||||||||
| ExmSendMode | int | ithalat/ihracat Gönderim YöntemiImport/Export Send Method | - | ||||||||||
| ExmEmail | string | ithalat/ihracat E-postaImport/Export E-mail | - | ||||||||||
| ExmFax | string | ithalat/ihracat FaksImport/Export Fax | - | ||||||||||
| ExmSendFormat | int | ithalat/ihracat Gönderim FormatıImport/Export Send Format | - | ||||||||||
Örnek (JSON) | Example (JSON)
Request
[
{
"FirmID": 2,
"PeriodNo": 1,
"MainParams":
[
{
"SourceID": "122",
"ClientRefNo": 0,
"AccountType": 3,
"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",
"Currency": "1",
"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
},
"FormSubmissionInfo": {
"DispSendMode": "0",
"DispEmail": "disp@disp.com",
"DispFax": "DispFax",
"DispSendFormat": "0",
"OrdSendMode": "0",
"OrdEmail": "OrdEmail@OrdEmail.com",
"OrdFax": "OrdFax",
"OrdSendFormat": "1",
"InvSendMode": "1",
"InvEmail": "InvEmail@InvEmail.com",
"InvFax": "InvFax",
"InvSendFormat": "2",
"RemSendMode": "2",
"RemEmail": "RemEmail@RemEmail.com",
"RemFax": "RemFax",
"RemSendFormat": "1",
"LtrSendMode": "99",
"LtrEmail": "LtrEmail@LtrEmail.com",
"LtrFax": "LtrFax",
"LtrSendFormat": "1",
"FBSSendMode": "0",
"FBSEmail": "FBSEmail@FBSEmail.com",
"FBSSendFormat": "2",
"FBASendMode": "99",
"FBAEmail": "FBAEmail@FBAEmail.com",
"FBASendFormat": "0",
"OfrSendMode": "0",
"OfrEmail": "OfrEmail@OfrEmail.com",
"OfrFax": "OfrFax",
"OfrSendFormat": "1",
"ExtSendMode": "1",
"ExtEmail": "ExtEmail@ExtEmail.com",
"ExtFax": "ExtFax",
"ExtSendFormat": "1",
"ExmSendMode": "0",
"ExmEmail": "ExmSendMode@ExmSendMode.com",
"ExmFax": "ExmFax",
"ExmSendFormat": "1"
}
}
]
}
]
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 |