Alıcı Müşteri Hareket Listesi

Bu API müşterinin alacaklı olduğu Vinov işlemlerini listelemektedir. Tarih aralığı ile maksimum 90 gün listelenebilir.

API Bilgileri

URL

/vinov/receiverTransactionList

Metot

POST

Versiyon

1.0

Scope

payment

Yetkilendirme Yöntemi

b2b_credentials


Girdi Bilgileri

Alan Adı Format Açıklama Zorunlu/Opsiyonel

Id

Integer (19) Vinov numarası ile sorgulamak istenirse kullanılabilir. Opsiyonel

ExpiryStartDate

yyyy-MM-ddTHH24:mm:ss Vade tarihi filtresi için kullanılmaktadır.
Id alanı ile sorgulama yapılmayacak ise zorunludur.
Koşullu Zorunlu

ExpiryEndDate

yyyy-MM-ddTHH24:mm:ss Vade tarihi filtresi için kullanılmaktadır.
Id alanı ile sorgulama yapılmayacak ise zorunludur.
Koşullu Zorunlu

EntryStartDate

yyyy-MM-ddTHH24:mm:ss Kayıt giriş tarihi filtresi için kullanılmaktadır.
Id alanı ile sorgulama yapılmayacak ise ve VadeTarihi koşulu girilmedi ise zorunludur.
Koşullu Zorunlu

EntryEndDate

yyyy-MM-ddTHH24:mm:ss Kayıt giriş tarihi filtresi için kullanılmaktadır.
Id alanı ile sorgulama yapılmayacak ise ve VadeTarihi koşulu girilmedi ise zorunludur.
Koşullu Zorunlu

IdentityTaxNumber

String (11) Alacaklar sorgulanırken hangi borçlulardan olduğu filtrenebilir. Opsiyonel


Çıktı Bilgileri

List < TransactionList >

Alan Adı Format Açıklama

DebtorNameSurnameTitle

String Borçlu ad soyad unvanı

DebtorIdentityTaxNumber

String Borçlu TCKN / VKN

DebtorAccountNumber

String Borçlu maskeli hesap numarası

ReceiverNameSurnameTitle

String Alıcı ad soyad unvanı

ReceiverCustomerNumber

String Alıcı müşteri numarası

ReceiverIdentityTaxNumber

String Alıcı TCKN / VKN

ReceiverAccountNumber

String Alıcı hesap numarası

ReceiverMobileNumber

String Alıcı cep numarası

ReceiverEmailAddress

String Alıcı E-Posta adresi

ReceiverDescription

String Alıcı açıklaması

QRCodeReferenceNumber

String Karekod referans numarası

QRCodeText

String Karekod içerik metni

CurrencyType

String Döviz cinsi

EarlyPayableAmount

Decimal Erken ödenecek tutar

Id

Integer Vinov numarası

VinovAmount

Decimal Vinov tutarı

TransactionId

String İşlem numarası

TransferType

Integer İşlem tipi
0: None, 1: Havale, 2: Eft, 3: KolayAdres, 4: IsmeHavale

ReceivableAmount

Decimal Alacak tutarı

ReceivableStatusCode

Integer Alacak durum kodu
0: None, 1: VadesiGelmemis, 2: Odendi, 3: IptalEdildi, 4: Devredildi, 5: IskontoEttirildi, 6: SubedeBasvuruBekliyor, 7: FastMesajiOlusturuldu

EffectiveDate

yyyy-MM-ddTHH24:mm:ss Valor tarihi

EntryDate

yyyy-MM-ddTHH24:mm:ss Giriş tarihi

ExpiryDate

yyyy-MM-ddTHH24:mm:ss Vade tarihi

DealerNumber

String Bayi numarası

InvoiceNumber

String Fatura numarası

ChannelCode

Integer Kanal kodu
1: şube, 4: internet, 6: mobil, 10: birim, 58: web kanalları, 51: Schedule,71: vgo


Mesaj Kodları

Mesaj Kodu Açıklama

ACBH000025

Başlangıç tarihi formatı hatalıdır.

ACBH000026

Bitiş tarihi formatı hatalıdır.

ACBH000100

Başlangıç tarihi bitiş tarihinden büyük olamaz.

ACBH000248

Başlangıç tarihi boş olamaz.

ACBH000249

Bitiş tarihi boş olamaz.

ACBH000512

Tarih aralığı maksimum 90 gün olmalıdır.

ACBH000513

Tarih veya vinov no alanlarından yalnızca biri girilmelidir.

ACBH000514

T.C. kimlik numarası / Vergi numarası uygun formatta girilmelidir.

Örnek

İstek:

{
    "ExpiryStartDate": "2022-03-20T00:00:00+03:00",
    "ExpiryEndDate": "2022-06-20T00:00:00+03:00"
}

Cevap:

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "4c5178d8-450f-4494-96f1-da65acad5887"
    },
    "Data": {
        "TransactionList": [
            {
                "ExpiryDate": "2022-05-06T00:00:00",
                "ChannelCode": 1,
                "DebtorAccountNumber": "",
                "DebtorCustomerNumber": "",
                "DealerNumber": "",
                "InvoiceNumber": "",
                "ReceiverMobileNumber": "",
                "ReceiverEmailAddress": "f@gmail.com",
                "ReceiverCustomerNumber": "",
                "ReceiverNameSurnameTitle": "CAHİT UYSAL",
                "VinovAmount": 200,
                "ReceiverAccountNumber": "",
                "ReceiverDescription": "AA",
                "EarlyPayableAmount": 200,
                "TransferType": 1,
                "TransactionId": "2022000006404027",
                "ReceiverIdentityTaxNumber": "",
                "DebtorIdentityTaxNumber": "",
                "ReceivableAmount": 200,
                "EntryDate": "2022-04-04T00:00:00",
                "Id": 200119,
                "CurrencyType": "TL",
                "DebtorNameSurnameTitle": "",
                "ReceivableStatusCode": 1,
                "EffectiveDate": "2022-05-06T00:00:00"
            },
            {
                "ExpiryDate": "2022-04-28T00:00:00",
                "ChannelCode": 1,
                "DebtorAccountNumber": "",
                "DebtorCustomerNumber": "",
                "DealerNumber": "",
                "InvoiceNumber": "",
                "ReceiverMobileNumber": "",
                "ReceiverEmailAddress": "",
                "ReceiverCustomerNumber": "",
                "ReceiverNameSurnameTitle": "CAHİT UYSAL",
                "VinovAmount": 15,
                "ReceiverAccountNumber": "",
                "ReceiverDescription": "BB",
                "EarlyPayableAmount": 15,
                "TransferType": 2,
                "TransactionId": "2022000006129532",
                "ReceiverIdentityTaxNumber": "",
                "DebtorIdentityTaxNumber": "",
                "ReceivableAmount": 15,
                "EntryDate": "2022-03-29T00:00:00",
                "Id": 195129,
                "CurrencyType": "TL",
                "DebtorNameSurnameTitle": "",
                "ReceivableStatusCode": 1,
                "EffectiveDate": "2022-04-28T00:00:00"
            }
        ]
    }
}