ALICI BİLGİLERİ

Alıcı Kaydı Oluşturma

XML şablonunda receiver etiketleri arasında bulunan bilgiler doğrultusunda, kayıtlı alıcı oluşturur veya var olanı seçer.
Hesabınızda, belirttiğiniz kullanıcıya ait kayıt olup olmadığı, VKN/TCKN ile kontrol edilir.
Alıcı firma listenizde kayıtlı değilse; Kayıt Adı, Kayıtlı Alıcılar listesinde, alıcı firmanın unvanı olarak atanır.

Alıcı - XML Etiket Açıklamaları

* ile işaretlenenler zorunludur.

title * - Alıcı Unvan / Ad Soyad
identifier * - Alıcı Vergi Kimlik Numarası / T.C Kimlik Numarası
taxAdmin - Vergi Dairesi
alias - Alıcı Etiket Bilgisi
Eğer alıcı GiB'e kayıtlıysa bu alan zorunludur. Alıcının Posta Kutusu adresi girilmelidir.

Alıcı Adres Bilgileri

country * - Ülke
city * - Şehir
district - İlçe
quarter - Mahalle
street - Cadde / Sokak
town - Kasaba / Köy
buildingName - Bina Adı
buildingNumber - Bina Numarası
doorNumber - Kapı Numarası
postalCode - Posta Kodu
phoneNumber - Telefon Numarası
faxNumber - Faks Numarası
emailAddress - E-Posta Adresi
website - İnternet Sitesi

Alıcı Tanım Bilgileri

Alıcıya ait; Mersis No, Telefon No, Hizmet No gibi bilgileri kayıt edebilirsiniz.

descriptions - Tanımlar
Bu bölüm döngü içerisinde olmalıdır ve döngüye <description> ile başlanmalıdır.
name - Tanım Seçimi
Bu değer <description> etiketi içerisinde gönderilmelidir.
value - Tanım Değeri
Bu değer <description> etiketi içerisinde gönderilmelidir.

Bu değer için kabul edilen girdiler:
- MERSISNO
- HIZMETNO
- MUSTERINO
- TESISATNO
- TELEFONNO
- DISTRIBUTORNO
- TICARETSICILNO
- TAPDKNO
- BAYINO
- ABONENO
- SAYACNO
- URETICINO
- CIFTCINO
- IMALATCINO
- DOSYANO
- HASTANO
Not: value için gönderilecek olan veri bitişik ve büyük harfle yazılmalıdır.

                                        
                                            <!-- Örnek Yapı -->
                                            <descriptions>
                                                <description>
                                                    <name>MERSISNO</name>
                                                    <value>11111111111</value>
                                                </description>
                                                <description>
                                                    <name>TELEFONNO</name>
                                                    <value>05050505050</value>
                                                </description>
                                            </descriptions>

Alıcı İstisna Durumlar

Eğer, Fatura Senaryo (invoiceScript) IHRACAT ise Mal Alan Firma bilgileri girilmelidir.
Eğer, Fatura Senaryo (invoiceScript) YOLCUBERABER ise Turist bilgileri girilmelidir.

Alıcı XML Örneği

<?xml version='1.0'?>
                                    <ein> 
                                        
                                        <receiver>
                                            <title>YENİ KAYIT API</title> 
                                            <identifier>12345678977</identifier> 
                                            <country>TÜRKİYE</country> 
                                            <city>İSTANBUL</city> 
                                            <district>ilçe</district> 
                                            <quarter>mahalle</quarter> 
                                            <street>Cadde/Sokak</street> 
                                            <town>Kasba/Köy</town> 
                                            <buildingName>Bina Adı</buildingName> 
                                            <buildingNumber>12</buildingNumber> 
                                            <doorNumber>24</doorNumber> 
                                            <postalCode>34000</postalCode> 
                                            <taxAdmin>Vergi Dairesi</taxAdmin> 
                                            <phoneNumber>05050550505</phoneNumber> 
                                            <faxNumber>05050550505</faxNumber> 
                                            <emailAddress>eposta@eposta.com</emailAddress> 
                                            <website>website.com</website> 
                                            <alias>alici@etiket.com</alias>

<descriptions>
                                                <description>
                                                    <name>MERSISNO</name> 
                                                    <value>2131556</value> 
                                                </description>
                                            </descriptions>
                                        </receiver>

Mal Alan Firma Kaydı Oluşturma

XML şablonunda buyerCompany etiketleri arasında bulunan bilgiler doğrultusunda, kayıtlı firma oluşturur veya var olanı seçer.
Hesabınızda, belirttiğiniz firmaya ait kayıt olup olmadığı, Vergi Kodu taxCode ile kontrol edilir.
Alıcı firma listenizde kayıtlı değilse; Kayıt Adı alıcı firmanın unvanı olarak atanır.

Mal Alan Firma - XML Etiket Açıklamaları

companyType - Firma Türü
Gerçek / Tüzel
companyFirstName - Ad
Firma Türü Gerçek ise
companyLastName - Soyad
Firma Türü Gerçek ise
companyTitle - Unvan
Firma Türü Tüzel ise
companyOfficialTitle - Resmi Unvan
taxCode - Vergi Numarası

Mal Alan Firma Adres Bilgileri

country * - Ülke
city * - Şehir
district - İlçe
quarter - Mahalle
street - Cadde / Sokak
town - Kasaba / Köy
buildingName - Bina Adı
buildingNumber - Bina Numarası
doorNumber - Kapı Numarası
postalCode - Posta Kodu
phoneNumber - Telefon Numarası
faxNumber - Faks Numarası
emailAddress - E-Posta Adresi
website - İnternet Sitesi

Mal Alan Firma - XML Örneği

<buyerCompany>
                                <companyType>gercek</companyType> 
                                <companyFirstName>Mücahit</companyFirstName> 
                                <companyLastName>Karaman</companyLastName> 
                                <companyTitle></companyTitle> 
                                <companyOfficialTitle>MK</companyOfficialTitle> 
                                <taxCode>12345678922</taxCode> 
                                <country>TÜRKİYE</country> 
                                <city>ANKARA</city> 
                                <district>YENİMAHALLE</district> 
                                <quarter></quarter> 
                                <street></street> 
                                <town></town> 
                                <buildingName></buildingName> 
                                <buildingNumber></buildingNumber> 
                                <doorNumber></doorNumber> 
                                <postalCode></postalCode> 
                                <phoneNumber></phoneNumber> 
                                <faxNumber></faxNumber> 
                                <emailAddress></emailAddress> 
                                <website></website> 
                            </buyerCompany>

Turist Kaydı Oluşturma

XML şablonunda touristInfo etiketleri arasında bulunan bilgiler doğrultusunda, turist oluşturur

Turist - XML Etiket Açıklamaları

firstName * - Ad
Gerçek / Tüzel
lastName * - Soyad
Firma Türü Gerçek ise
passportNumber * - Pasaport Numarası
Firma Türü Gerçek ise
passportDate * - Pasaport Veriliş Tarihi
citizen - Uyruk
instution - Aracı Kurum
Sadece Kod girilmelidir. (1, 2, 3)
1. DSD TURİSTİK ARACILIK VE DANIŞMANLIK HİZMETLERİ A.Ş.
2. Global Blue Turistik Hizmetler A.Ş.
3. VERGİ İADE ARACILIK A.Ş
taxCode - Vergi Numarası

Turist Adres Bilgileri

country * - Ülke
city * - Şehir
district - İlçe
quarter - Mahalle
street - Cadde / Sokak
town - Kasaba / Köy
buildingName - Bina Adı
buildingNumber - Bina Numarası
doorNumber - Kapı Numarası
postalCode - Posta Kodu
phoneNumber - Telefon Numarası
faxNumber - Faks Numarası
emailAddress - E-Posta Adresi
website - İnternet Sitesi

Turist Banka Hesap Bilgileri

touristInfo etiketi altında bankAccount etiketleri arasında bulunan bilgiler doğrultusunda turist oluşturur.

Banka Bilgileri - XML Etiket Açıklamaları

bankName * - Banka Adı
departmentName - Şube Adı
bankAccountNumber - Hesap Numaras
currency - Para Birimi
description - Açıklama

Turist Bilgileri - XML Örneği

<touristInfo>
                                <firstName>Turist Adı API</firstName> 
                                <lastName>Turist Soyadı API</lastName> 
                                <passportNumber>Pass no</passportNumber> 
                                <passportDate>01/01/2020</passportDate> 
                                <citizen>TÜRK</citizen> 
                                <country>TÜRKİYE</country> 
                                <city>ANKARA</city> 
                                <district>YENİMAHALLE</district> 
                                <quarter></quarter> 
                                <street></street> 
                                <town></town> 
                                <buildingName></buildingName> 
                                <buildingNumber></buildingNumber> 
                                <doorNumber></doorNumber> 
                                <postalCode></postalCode> 
                                <phoneNumber></phoneNumber> 
                                <faxNumber></faxNumber> 
                                <emailAddress></emailAddress> 
                                <website></website> 
                                <instution>1</instution>

<bankAccount>
                                    <bankName>Banka hesap adı API</bankName> 
                                    <departmentName>Şube</departmentName> 
                                    <bankAccountNumber>1111115981</bankAccountNumber> 
                                    <currency>USD</currency> 
                                    <description>API Açıklama</description> 
                                </bankAccount>
                            </touristInfo>