Implementation Notes
Bu API bir bayi için daha önceden yüklenmiş olan bir faturanın iptal etme işlemini gerçekleştirmektedir.
URL |
/cancelDDSInvoice |
Metot |
POST |
Versiyon |
1.0 |
Scope |
payment |
Yetkilendirme Yöntemi |
Authorization Code |
Alan Adı | Format | Açıklama | Zorunlu/Opsiyonel |
MainCompanyID |
Integer (19) | Bankanın ana firmaya verdiği tekil numara | Zorunlu |
MainCompanyDealerCode |
String (30) | Ana firmanın bayiye verdiği bayi kodu | Zorunlu |
InvoiceNumber |
String (20) | Ana firmanın faturaya verdiği numara | Zorunlu |
CurrencyCode |
String (3) |
Faturanın döviz cinsi DBS/BTS Servisleri sekmesinde açıklanmıştır |
Zorunlu |
Alan Adı | Format | Açıklama |
MainCompanyID |
Integer | Bankanın ana firmaya verdiği tekil numara |
MainCompanyDealerCode |
String | Ana firmanın bayiye verdiği bayi kodu |
InvoiceNumber |
Integer | Ana firmanın faturaya verdiği numara |
LastPaymentDate |
yyyy-MM-ddTHH24:mm:ss | Fatura son ödeme tarihi |
InvoiceAmount |
Decimal | Fatura tutarı |
CurrencyCode |
String | Faturanın döviz cinsi |
NameSurname |
String | Ana firma tarafından gönderilen bayi adı/ünvanı |
InvoiceType |
Integer |
Faturanın türü 1: Vadeli fatura, 2: Peşin fatura |
Description |
String | Açıklama |
InvoiceReleaseDate |
yyyy-MM-ddTHH24:mm:ss | Firmaların faturalarını kendi sistemlerinde oluşturdukları tarih |
CompanyName |
String | Ana Firma Adı |
GuaranteedAmountOriginal |
Decimal | Faturanın sisteme giriş anındaki garantili kısmı |
NonGuaranteedAmountOriginal |
Decimal | Faturanın sisteme giriş anındaki garantisiz kısmı |
AmountPaid |
Decimal | Faturanın ödenen kısmı |
OffsetAmount |
Decimal | Faturadan mahsup edilmiş tutarların toplamı |
TransactionId |
Integer | Sistem tarafından üretilen tekil işlem numarası |
InvoiceStatusCode |
Integer |
Faturanın durumu 1: Aktif, 2: Pasif |
InvoiceStatusDetailCode |
Integer |
DBS Durum Detay Kodları DBS/BTS Servisleri sekmesinde açıklanmıştır |
InvoiceStatus |
Integer |
Fatura Durum Kodları DBS/BTS Servisleri sekmesinde açıklanmıştır |
SystemEntryDate |
yyyy-MM-ddTHH24:mm:ss | Faturanın sisteme giriş tarihi |
Reference6 |
String | Firmalar için ayrılan özel alan |
Reference7 |
String | Firmalar için ayrılan özel alan |
Reference8 |
String | Firmalar için ayrılan özel alan |
Reference9 |
String | Firmalar için ayrılan özel alan |
Reference10 |
String | Firmalar için ayrılan özel alan |
Mesaj Kodu | Açıklama |
ACBH000027 |
Döviz kodu boş olamaz. |
ACBH000028 |
Döviz kodu alanına geçersiz bir değer girildi. |
ACBH000162 |
Ana firma id uygun formatta girilmelidir. |
ACBH000163 |
Bayi kodu uygun formatta girilmelidir. |
ACBH000164 |
Fatura numarası uygun formatta girilmelidir. |
ACBH000170 |
Bayi kodu boş bırakılamaz. |
ACBH000171 |
Fatura numarası boş bırakılamaz. |
ACBH000174 |
İlgili işlem bireysel müşteri numarası ile yapılamaz. |
İstek:
{ "MainCompanyID": 371004, "MainCompanyDealerCode": "apitest1", "InvoiceNumber": "1011012", "CurrencyCode": "TL" }
Cevap:
{ "Header": { "StatusCode": "APIGW000000", "StatusDescription": "Completed", "ObjectID": "4a887691-8852-4198-858f-325c44e2c4ea" }, "Data": { "InvoiceInfo": { "CurrencyCode": "TL", "InvoiceStatusCode": 2, "InvoiceStatusDetailCode": 10, "InvoiceNumber": 1011012, "MainCompanyID": 371004, "MainCompanyDealerCode": "apitest1" } } }
API URL : https://apigw.vakifbank.com.tr:8443