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