Gümrük Borç Ödeme

Bu API müşterinin gümrük vergi borçlarını ödemektedir. Ettn numarası girilmezse belirtilen beyanname numarası altındaki gümrük vergilerinin tamamı ödenir.

API Bilgileri

URL

 /v2/customsTaxPayment

Metot

 POST

Versiyon

 2.0

Scope

 oob

Yetkilendirme Yöntemi

 Client Credentials


Girdi Bilgileri


Source

Alan Adı Format Açıklama Zorunlu/Opsiyonel

AccountNumber

 String Hesap numarası Zorunlu

CustomerNumber

 String Müşteri numarası Zorunlu


Payment

Alan Adı Format Açıklama Zorunlu/Opsiyonel

DeclarationNo

 String Beyanname numarası Zorunlu

CompanyReferenceNo

 String Kurum referans numarası Opsiyonel

AmountPayable

 Number (26,2) Ödenecek tutar Opsiyonel

EttnList

 List< EttnList > Ettn listesi Opsiyonel

Emails

 List< Emails > Dekontun gönderileceği e-posta listesi Opsiyonel


List< Emails >

Alan Adı Format Açıklama Zorunlu/Opsiyonel

EmailAddress

 String E-posta adresi Zorunlu


List< EttnList >

Alan Adı Format Açıklama Zorunlu/Opsiyonel

EttnNo

 String Evrensel tekil tanımlama numarası Opsiyonel


Çıktı Bilgileri


List< Documents >

Alan Adı Format Açıklama

TextDocument

 String Dekont ve ödeme alındı belgesi

Title

 String Ödeme başlığı


List< Results >

Alan Adı Format Açıklama

TotalAmount

 Decimal Toplam tutar

ResultCode

 String Sonuç kodu
(Başarılı ödeme sonuç kodu: VRGI000003)

DeclarationNo

 Number Beyanname numarası

ResultDescription

 String Ödeme sonucu

KMHUsingStatus

 String KMH kullanım durumu

EttnNo

 String Evrensel tekil tanımlama numarası

ReferenceNo

 Number Dekont numarası


List< TaxInfo >

Alan Adı Format Açıklama

SerialNo

 String Evrak seri numarası

SequenceNo

 String Evrak sıra numarası

EttnNo

 String Evrensel tekil tanımlama numarası


Mesaj Kodları

Mesaj Kodu Açıklama

ACBH000004

 Gümrük tahsilatında hata alındı. Hata: {0}

ACBH000005

 Belirttiğiniz ETTN numarasına ait borç bulunamadı.

ACBH000009

 Hesap Numarası boş olamaz.

ACBH000010

 Müşteri Numarası boş olamaz.

ACBH000016

 Beyanname Numarası boş olamaz.

ACBH000196

 Ödenecek tutar alanı toplam tutardan farklı olamaz.

ACBH000197

 E-posta uygun formatta girilmelidir.

Örnek

İstek:

{
    "Source": {
        "AccountNumber": "00000000000000000",
        "CustomerNumber": "111111111111"
    },
    "Payment": {
        "DeclarationNo": "00000000TT000000",
		"CompanyReferenceNo": "443322999",
        "AmountPayable": 6023.33,
        "Emails": [
            {
                "EmailAddress": ""
            },
            {
                "EmailAddress": ""
            }
        ],
        "EttnList": [
            {
                "EttnNo": ""
            },
			{
                "EttnNo": ""
            }
        ]
    }
}

Cevap:

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "338d35d5-dd93-4712-a829-948f6c2db8c5"
    },
    "Data": {
        "Documents": [
            {
                "TextDocument": "",
                "Title": "GUMRUK VERGI ALINDISI"
            },
            {
                "TextDocument": "",
                "Title": "Hesaptan Kurum Tahsilat Dekontu"
            },
			...
        ],
        "Results": [
            {
                "DeclarationNo": "00000000TT000000",
                "ResultDescription": "Basarili islem.",
                "TotalAmount": "5964.53",
                "EttnNo": "000A0000-AB00-0A0A-A000-0000000AAA0C",
                "ResultCode": "VRGI000003",
                "KMHUsingStatus": "1",
                "ReferenceNo": "0000000000000065"
            },
            {
                "DeclarationNo": "00000000TT000000",
                "ResultDescription": "Basarili islem.",
                "TotalAmount": "58.8",
                "EttnNo": "000A0000-AB00-0A0A-A000-0000000AAA0A",
                "ResultCode": "VRGI000003",
                "KMHUsingStatus": "1",
				"ReferenceNo": "0000000000000066"
            },
			...
        ],
        "TaxInfo": [
            {
                "SerialNo": "BM",
                "SequenceNo": "510",
                "EttnNo": "000A0000-AB00-0A0A-A000-0000000AAA0C"
            },
            {
                "SerialNo": "BM",
                "SequenceNo": "512",
                "EttnNo": "000A0000-AB00-0A0A-A000-0000000AAA0A"
            }
        ]
    }
}