FATURA BİLGİLERİ

Fatura Bilgileri

Fatura Senaryo
Fatura Tipi
Gönderim Şekli
Müşteri Fatura Numarası
Düzenleme Tarihi / Fatura Saati
Doküman Para Birimi Bilgisi
Sipariş Bilgisi
İrsaliye Bilgisi
Ödeme Bilgisi
Doküman Bilgisi
Fatura Notu Bilgisi
Dönem Bilgisi
İnternet Satış

* ile işaretlenenler zorunludur.

Fatura Senaryo

XML şablonunda invoiceScript etiketi arasında gönderilen bilgidir.
Kabul edilen değerler :
- TEMELFATURA
  Eğer Alıcı GiB'e kayıtlı değilse TEMELFATURA gönderilemez.
- TICARIFATURA
  Eğer Alıcı GiB'e kayıtlı değilse TICARIFATURA gönderilemez.
- EARSIVFATURA
  Fatura Senaryo EARSIVFATURA ise, Gönderim Şekli mecburidir.
- IHRACAT
  Fatura Senaryo IHRACAT ise, Mal Alan Firma bilgileri girilmelidir.
  İstisna Fatura Sebebi, 301 değerini almalıdır.
- YOLCUBERABER
  Fatura Senaryo YOLCUBERABER ise, Turist bilgileri girilmelidir.
  İstisna Fatura Sebebi, 501 değerini almalıdır.
- KAMU
  Fatura Senaryo KAMU ise, Ödeme Bilgisi bilgileri girilmelidir.

Gönderim Şekli

sendType etiketi arasında gönderilen bilgidir. İki çeşit Gönderim Şekli vardır:

Elektronik - elektronik ( gönderilen veri )
Kağıt - kagit ( gönderilen veri )

Not: invoiceScript içinde gönderilen veri bitişik ve büyük harfle yazılmalıdır.

Fatura Tipi

XML şablonunda invoiceType etiketi arasında gönderilen bilgidir.
Kabul edilen değerler :
- SATIS
- IADE
- ISTISNA
- TEVKIFAT
- OZELMATRAH
- IHRACKAYITLIFATURA
- SGK

Not: invoiceType içinde gönderilen veri bitişik ve büyük harfle yazılmalıdır.

Müşteri Fatura Numarası

XML şablonunda custInvNo etiketi arasında gönderilen bilgidir.
Zorunlu alan değildir. Fatura gönderilirken de oluşturulabilir.

Fatura Düzenleme Tarihi / Saati

invoiceDate * - Düzenleme Tarihi
invoiceTime - Düzenleme Saati

Doküman Para Birimi Bilgisi

XML şablonunda documentCurrency etiketi arasında gönderilir.

XML Etiket Açıklamaları

currency - Para Birimi
rate - Kur

Sipariş Bilgisi

XML şablonunda orderInfo etiketi arasında gönderilir.

XML Etiket Açıklamaları

orderNumber - Sipariş Numarası
orderDate - Sipariş Tarihi

İrsaliye Bilgisi

XML şablonunda partyWaybill döngüsü oluşturulur ve döngüye wayBill etiketi ile başlanır.

wayBill etiketi altında:

wbNumber - İrsaliye Numarası
wbDate - İrsaliye Tarihi

Ödeme Bilgisi

XML şablonunda paymentInfo etiketi arasında gönderilir.

XML Etiket Açıklamaları

type - Ödeme Şekli
channel - Ödeme Kanalı
currency - Para Birimi
iban - IBAN
note - Ödeme Notu

Doküman Bilgisi

XML şablonunda partyDocumentInfo döngüsü oluşturulur ve döngüye documentInfo etiketi ile başlanır.

documentInfo etiketi altında:

note - Doküman Notu
date - Doküman Tarihi
type - Doküman Tipi

Fatura Notları

XML şablonunda invoiceNotes döngüsü oluşturulur ve döngüye note etiketi ile başlanır.

XML Etiket Açıklamaları

note - Fatura Notu

Dönem Bilgisi

XML şablonunda period etiketi arasında gönderilir.

XML Etiket Açıklamaları

periodStartDate - Dönem Başlangıç Tarihi
periodEndDate - Dönem Bitiş Tarihi

İnternet Satış

XML şablonunda internetSale etiketi arasında gönderilir.
Fatura Senaryosu EARSIVFATURA olduğunda veya Fatura Tipi Tevkifat olduğunda gönderilebilir.

XML Etiket Açıklamaları

type - Ödeme Şekli
channel - Ödeme Kanalı
currency - Para Birimi
iban - IBAN
note - Ödeme Notu

İstisna Fatura Sebebi

XML şablonunda invoiceExceptionReason etiketi arasında gönderilen bilgidir.
Sadece kod olarak kabul edilir. (101, 301, 501 vb.)
Fatura Senaryo YOLCUBERABER ise kod 501, IHRACAT ise kod 301 gönderilmelidir.

İhraç Kayıtlı Fatura

XML şablonunda issuedInvoiceReason etiketi arasında gönderilen bilgidir.
Sadece kod olarak kabul edilir. (701, 702, 703)

Özel Matrah

XML şablonunda taxAssessment etiketi arasında gönderilir.
Fatura Senaryosu EARSIVFATURA olduğunda veya Fatura Tipi Tevkifat olduğunda gönderilebilir.

XML Etiket Açıklamaları

value - Özel Matrah
percentage - Yüzde
amount - Miktar
reason - Özel Matrah Nedeni
Sadece kod kabul edilir. ( 801, 802, 803 vb. )

Fatura Bilgileri XML Örneği

<invoiceScript>TEMELFATURA</invoiceScript>

<invoiceType>ISTISNA</invoiceType>

<sendType></sendType>

<custInvNo></custInvNo>

<invoiceDate>01/01/2020</invoiceDate>
                                    <invoiceTime>23:59</invoiceTime>

<documentCurrency>
                                        <currency>USD</currency> 
                                        <rate>6,5948</rate> 
                                    </documentCurrency>

<orderInfo>
                                        <orderNumber>12365479123</orderNumber> 
                                        <orderDate>01/01/2020</orderDate> 
                                    </orderInfo>

<partyWaybill>
                                        <waybill>
                                            <wbNumber>147258369</wbNumber> 
                                            <wbDate>01/01/2020</wbDate> 
                                        </waybill>
                                        <waybill>
                                            <wbNumber>147258369</wbNumber> 
                                            <wbDate>01/01/2020</wbDate> 
                                        </waybill>
                                    </partyWaybill>

<paymentInfo>
                                        <type>20 - Çek</type> 
                                        <channel>Ödeme Kanalı</channel> 
                                        <currency>USD</currency> 
                                        <iban>iban</iban> 
                                        <note>not</note> 
                                    </paymentInfo>

<partyDocumentInfo>
                                        <documentInfo>
                                            <note>Doküman Notu</note>
                                            <date>01/01/2020</date>
                                            <type>Doküman Tipİ</type>
                                        </documentInfo>
                                    </partyDocumentInfo>

<invoiceNotes>
                                        <note>Fatura Notu API</note>
                                    </invoiceNotes>

<period>
                                        <periodStartDate>01/01/2020</periodStartDate>
                                        <periodEndDate>02/01/2020</periodEndDate>
                                    </period>

<internetSale>
                                        <internetSaleActive></internetSaleActive> 
                                        <shippingDate></shippingDate> 
                                        <shipperInfo> 
                                            <shipper></shipper> 
                                            <fullName></fullName> 
                                            <identifier></identifier> 
                                        </shipperInfo>
                                        <paymentMethod></paymentMethod> 
                                        <otherPaymentMethod></otherPaymentMethod> 
                                        <paymentDate></paymentDate> 
                                        <webSite></webSite> 
                                    </internetSale>

<invoiceExceptionReason>301</invoiceExceptionReason>

<issuedInvoiceReason></issuedInvoiceReason>

<taxAssessment>
                                        <value>Özel Matrah</value> 
                                        <percentage>12</percentage>
                                        <amount>120</amount>
                                        <reason>801</reason>
                                    </taxAssessment>

Mal Alan Firma

Turist Bilgileri