Gümrük Borç Ödeme

Bu API müşterinin gümrük vergi borçlarını ödemektedir. Ettn bilgisi girilmezse belirtilen beyanname numarası altındaki tüm gümrük vergileri ö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

IdentityTaxNumber

String Kurum TCKN / VKN bilgisi Opsiyonel


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ı borçtan gelen toplam tutardan farklı olamaz. API İsteğinde İletilen Ödenecek Toplam Tutar: {0}. Kurumdan Gelen Toplam Tutar: {1}.

ACBH000197

E-posta uygun formatta girilmelidir.

Örnek

İstek:

{
  "Source": {
    "AccountNumber": "00150000000000000",
    "CustomerNumber": "111111111111",
    "IdentityTaxNumber": "11111111111"
  },
  "Payment": {
    "DeclarationNo": "00000000TT000000",
    "CompanyReferenceNo": "114477",
    "AmountPayable": 6023.33,
    "Emails": [
      {
        "EmailAddress": ""
      },
      {
        "EmailAddress": ""
      }
    ],
    "EttnList": [
      {
        "EttnNo": "000A0000-AB00-0A0A-A000-0000000AAA0C"
      },
      {
        "EttnNo": "000A0000-AB00-0A0A-A000-0000000AAA0A"
      }
    ]
  }
}

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"
      },
      {
        "TextDocument": "",
        "Title": "GUMRUK VERGI ALINDISI2"
      },
      {
        "TextDocument": "",
        "Title": "Hesaptan Kurum Tahsilat Dekontu2"
      }
    ],
    "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"
      }
    ]
  }
}