DBS Fatura Yükle

Bu API bir bayinin yeni bir fatura kaydetme işlemini gerçekleştirmektedir.

API Bilgileri

URL

 /uploadDDSInvoice

Metot

 POST

Versiyon

 1.0

Scope

 payment

Yetkilendirme Yöntemi

 Authorization Code


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

InvoiceAmount

 Decimal (9,2) Fatura tutarı Zorunlu

CurrencyCode

 String (3) Faturanın döviz cinsi
DBS/BTS Servisleri sekmesinde açıklanmıştır 		Zorunlu

AreaCode

 String Firma tarafından bayileri bölgeye göre farklılaşması durumunda bayinin bölge kodu/adı bu alanda gönderilebilir. Opsiyonel

NameSurname

 String (80) Ana firma tarafından gönderilen bayi adı/ünvanı Opsiyonel

LastPaymentDate

 yyyy-MM-ddTHH24:mm:ss Fatura son ödeme tarihi Zorunlu

InvoiceType

 Integer (1) Faturanın türü
1: Vadeli fatura, 2: Peşin fatura 		Zorunlu

Description

 String (200) Açıklama Opsiyonel

InvoiceReleaseDate

 yyyy-MM-ddTHH24:mm:ss Faturanın kurumdan çıktığı tarih, saat ve dakika Opsiyonel

Reference6

String (100) Firmalar için ayrılan özel alan Opsiyonel

Reference7

String (100) Firmalar için ayrılan özel alan Opsiyonel

Reference8

String (100) Firmalar için ayrılan özel alan Opsiyonel

Reference9

String (100) Firmalar için ayrılan özel alan Opsiyonel

Reference10

String (100) Firmalar için ayrılan özel alan Opsiyonel


Çı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

AreaCode

 String Firma tarafından bayileri bölgeye göre farklılaşması durumunda bayinin bölge kodu/adı bu alanda gönderilebilir.

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

InvoiceReleaseDate

 yyyy-MM-ddTHH24:mm:ss Firmaların faturalarını kendi sistemlerinde oluşturdukları tarih

InvoiceStatus

Integer Fatura Durum Kodları
DBS/BTS Servisleri sekmesinde açıklanmıştır

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

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

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.

ACBH000168

Fatura çıkış tarihi formatı hatalıdır.

ACBH000169

Fatura türü alanına geçersiz değer girildi.

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.

ACBH000243

Son ödeme tarihi boş olamaz.

Örnek

İstek:

{
	"MainCompanyID": 371004,
	"MainCompanyDealerCode": "apitest1",
	"InvoiceNumber": "1011012",
	"InvoiceAmount": 100,
	"CurrencyCode": "TL",
	"LastPaymentDate": "2021-03-01T00:00:00+03:00",  
	"InvoiceType": 1,
	"AreaCode": "",    
	"NameSurname": "",  
	"Description": "",
	"InvoiceReleaseDate": "",    
	"Reference6": "",
	"Reference7": "",
	"Reference8": "",
	"Reference9": "",    
	"Reference10": ""
}

Cevap:

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Completed",
        "ObjectID": "436874cd-3d26-4bcb-aadb-c01e3a4c610e"
    },
    "Data": {
        "InvoiceInfo": {
            "CurrencyCode": "TL",
            "InvoiceStatusCode": 2,
            "LastPaymentDate": "2021-03-01T00:00:00+03:00",
            "InvoiceStatusDetailCode": 21,
            "InvoiceNumber": 1011012,
            "InvoiceAmount": 100,
            "MainCompanyID": 371004,
            "MainCompanyDealerCode": "apitest1",
            "InvoiceType": 1
        }
    }
}