DBS Fatura Güncelle
Bu API bir bayi için daha önceden yüklenmiş olan bir faturanın güncelleme işlemini gerçekleştirmektedir. Güncelleme işlemi sadece fatura tutarı ve son ödeme tarihi alanlarında yapılabilmektedir.
API Bilgileri
URL |
/updateDDSInvoice |
Metot |
POST |
Versiyon |
1.0 |
Scope |
payment |
Yetkilendirme Yöntemi |
B2B Credentials |
Girdi Bilgileri
| 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 |
LastPaymentDate |
yyyy-MM-ddTHH24:mm:ss | Fatura son ödeme tarihi | Zorunlu |
InvoiceAmount |
Decimal (9,2) | Fatura tutarı | Zorunlu |
CurrencyCode |
String (3) |
Faturanın döviz cinsi DBS/BTS Servisleri sekmesinde açıklanmıştır |
Zorunlu |
Çıktı Bilgileri
InvoiceInfo
| 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 |
RemainingAmount |
Decimal | Faturadan kalan tutar |
GuaranteedAmount |
Decimal | Faturadan kalan garantili tutar |
NonGuaranteedAmount |
Decimal | Faturadan kalan garantisiz tutar |
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 Kodları
| 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. |
ACBH000167 |
Son ödeme tarihi formatı hatalıdır. |
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. |
Örnek
İstek:
{
"MainCompanyID": 371004,
"MainCompanyDealerCode": "apitest1",
"InvoiceNumber": "1011012",
"CurrencyCode": "TL",
"InvoiceAmount": 4000,
"LastPaymentDate": "2021-07-01T00:00:00+03:00"
}
Cevap:
{
"Header": {
"StatusCode": "APIGW000000",
"StatusDescription": "Completed",
"ObjectID": "12db7391-8852-4198-858f-325c44e2c4ea"
},
"Data": {
"InvoiceInfo": {
"CurrencyCode": "TL",
"InvoiceStatusCode": 2,
"LastPaymentDate": "2021-07-01T00:00:00+03:00",
"InvoiceStatusDetailCode": 10,
"InvoiceNumber": 1011012,
"InvoiceAmount": 4000,
"MainCompanyID": 371004,
"MainCompanyDealerCode": "apitest1"
}
}
}
-
API URL : https://apigw.vakifbank.com.tr:8443
-
-
-