Google e-fatura isteği

Bu dokümanda, Universal Business Language (UBL) 2.4 Fatura Şeması'na kapsamlı bir genel bakış sunulmaktadır. Bu şema, Google ile e-fatura sağlayıcıları arasında fatura verilerinin elektronik olarak değişimini kolaylaştırmak için özel olarak tasarlanmıştır. Tedarikçi firmaların faturaları işleyip devlet vergi yetkililerinin portallarına göndermesi için çok önemli olan fatura bilgilerinin standart şekilde iletilmesini kolaylaştırır.

Fatura isteği şeması öğeleri:

  1. Fatura üstbilgisi
  2. Tedarikçi bilgileri
  3. Alıcı bilgileri
  4. Yayınlama bilgileri
  5. Satır öğeleri
  6. Toplam vergi
  7. Stopaj vergileri
  8. Ödeme şartları ve yöntemleri
  9. Yasal parasal toplam

1. Fatura üstbilgisi

Fatura üstbilgisinde, kimlik numaraları, düzenleme tarihi ve saati, fatura türü, para birimleri ve döviz kurları gibi faturayla ilgili üst düzey bilgiler bulunur.

Öğe Açıklama Örnek
cbc:UBLVersionID UBL fatura standardı kullanılıyor 2.4
cbc:ID Fatura Numarası GCEMEAD0000000001
cbc:UUID Google Tedarikçi Firma İsteği Kimliği: Bu fatura isteği için yanıt mesajında yer alması gereken değer 123e4567-e89b-12d3-a456-426614174000
cbc:IssueDate Faturanın düzenlendiği tarih 2023-06-01
cbc:IssueTime Faturanın düzenlendiği saat (ABD Pasifik saat diliminde) 08:20:00-08:00
cbc:InvoiceTypeCode Faturanın türü. Desteklenen değerler: Fatura için 380 380
cbc:DocumentCurrencyCode Faturanın sunulduğu para birimi USD
cbc:TaxCurrencyCode TaxAmount değerinin dönüştürülmesi gereken para birimi 6,99
cac:TaxExchangeRate
cbc:SourceCurrencyCode Döviz kurunun kaynak para birimi USD
cbc:TargetCurrencyCode Döviz kuru için hedef para birimi 6,99
cbc:CalculationRate 2 ondalık basamak hassasiyetinde vergi hesaplaması için döviz kuru 0,84
cac:InvoicePeriod
cbc:StartDate Fatura döneminin başlangıç tarihi 2023-05-01
cbc:EndDate Fatura döneminin bitiş tarihi 2023-05-31
cbc:Note Faturayla ilgili ek notlar veya yorumlar Bu, faturaya ait örnek bir nottur.

Örnek

<Invoice>
  <cbc:UBLVersionID>2.4</cbc:UBLVersionID>
  <cbc:ID schemeID="Google">GCEMEAD0000000001</cbc:ID>
  <cbc:UUID>123e4567-e89b-12d3-a456-426614174000</cbc:UUID>
  <cbc:IssueDate>2023-06-01</cbc:IssueDate>
  <cbc:IssueTime>08:20:00-08:00</cbc:IssueTime>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  <cbc:DocumentCurrencyCode>USD</cbc:DocumentCurrencyCode>
  <cbc:TaxCurrencyCode>EUR</cbc:TaxCurrencyCode>
  <cac:TaxExchangeRate>
    <cbc:SourceCurrencyCode>USD</cbc:SourceCurrencyCode>
    <cbc:TargetCurrencyCode>EUR</cbc:TargetCurrencyCode>
    <cbc:CalculationRate>0.84</cbc:CalculationRate>
  </cac:TaxExchangeRate>
  <cac:InvoicePeriod>
    <cbc:StartDate>2023-05-01</cbc:StartDate>
    <cbc:EndDate>2023-05-31</cbc:EndDate>
  </cac:InvoicePeriod>
  <cbc:Note>This is a sample note for the invoice.</cbc:Note>
</Invoice>

2. Tedarikçi bilgileri

Bu bölümde satıcının vergi kimliği, adı, adresi ve iletişim bilgileri gibi ayrıntıları yer alır.

2.1 cac:AccountingSupplierParty/cac:Party

Bu öğe, satıcıyı (Google) temsil eder.

Yol Açıklama Örnek
cac:PartyTaxScheme
cbc:CompanyID Satıcının vergi kimlik numarası IE 9999999X
cbc:CompanyID/@schemeID Vergi planı tanımlayıcısı KDV
cac:PartyName
cbc:Name Satıcının adı Google Ireland Limited
cac:PostalAddress
cbc:AddressLine1 Satıcının adres satırı 1 Gordon House
cbc:AddressLine2 Satıcının adres satırı 2 Barrow Street
cbc:ŞehirAdı Satıcının bulunduğu şehir Dublin
cbc:PostalZone Satıcının posta kodu D04 V4X7
cac:Country/cbc:IdentificationCode Satıcının ülke kodu IE
cac:İletişim kişisi
cac:Contact/cbc:Telephone Satıcının iletişim telefonu 545-123-4567
cac:Contact/cbc:ElectronicMail Satıcının iletişim e-posta adresi invoice@google.com

Örnek

<Invoice>
  ...
    <cac:AccountingSupplierParty>
        <cac:Party>
            <cac:PartyTaxScheme>
                <cbc:CompanyID schemeID="VAT">IE 9999999X</cbc:CompanyID>
            </cac:PartyTaxScheme>
            <cac:PartyName>
                <cbc:Name>Google Ireland Limited</cbc:Name>
            </cac:PartyName>
            <cac:PostalAddress>
                <cbc:AddressLine>Gordon House</cbc:AddressLine>
                <cbc:AddressLine>Barrow Street</cbc:AddressLine>
                <cbc:CityName>Dublin</cbc:CityName>
                <cbc:PostalZone>D04 V4X7</cbc:PostalZone>
                <cac:Country>
                    <cbc:IdentificationCode>IE</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:Contact>
                <cbc:Telephone>545-123-4567</cbc:Telephone>
                <cbc:ElectronicMail>invoice@google.com</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:AccountingSupplierParty>
  ...
</Invoice>

3. Alıcı bilgileri

Bu bölümde, alıcıyla ilgili vergi kimliği, ad, adres ve iletişim bilgileri gibi ayrıntılar yer alır. Hem ajans hem de son alıcı bilgilerinin eklenmesi gerekiyorsa ajans bilgilerini (birincil alıcı) temsil etmek için cac:AccountingCustomerParty, son alıcı (ikincil alıcı) bilgileri için ise cac:BuyerCustomerParty kullanılır.

3.1 cac:AccountingCustomerParty/cac:Party

Bu öğe, muhasebe müşteri tarafını temsil eder. Ajans söz konusu olduğunda bu öğe, ajans bilgilerini göndermek için kullanılır.

Yol Açıklama Örnek
cac:PartyTaxScheme/cbc:CompanyID Alıcının vergi kimlik numarası 0987654321
cac:PartyTaxScheme/cbc:CompanyID/@schemeID Vergi şeması tanımlayıcısı (birden fazla vergi kimliği varsa tekrarlanabilir) TIN, NIP, SIREN, SIRET
cac:PartyLegalEntity/cbc:CompanyLegalFormCode Şirketin yasal şeklini belirten kod (olası değerler: Şahıs için 1, Kuruluş için 2) 1
cac:PartyLegalEntity/cbc:CompanyLegalForm Şirketin yasal şeklinin açıklaması (olası değerler: "Bireysel" veya "Kuruluş") Bireysel
cac:PartyName
cbc:Name Alıcının adı Ayşe İnşaat
cac:PostalAddress
cbc:AddressLine1 Alıcının adres satırı 1 456 Market St
cbc:AddressLine2 Alıcının adres satırı 2 4. Kat
cbc:ŞehirAdı Alıcının bulunduğu şehir New York
cbc:PostalZone Alıcının posta kodu 10001
cac:Country/cbc:IdentificationCode Alıcının ülke kodu ABD
cac:İletişim kişisi
cbc:Telephone Alıcının iletişim telefonu 987-654-3210
cbc:ElectronicMail Alıcının iletişim e-posta adresi j@construction.com

3.2 cac:BuyerCustomerParty/cac:Party

Bu öğe yalnızca ajans bilgilerini göndermek için cac:AccountingCustomerParty kullanıldığında kullanılır. Bu 2 öğedeki tüm alt öğeler aynıdır.

Örnek

<Invoice>
  ...
    <cac:AccountingCustomerParty>
        <cac:Party>
            <cac:PartyTaxScheme>
                <cbc:CompanyID schemeID="VAT">0987654321</cbc:CompanyID>
                <cbc:CompanyID schemeID="SIREN">123456789</cbc:CompanyID>
                <cbc:CompanyID schemeID="SIRET">98765432100015</cbc:CompanyID>
            </cac:PartyTaxScheme>
            <cac:PartyLegalEntity>
                <cbc:CompanyLegalFormCode>2</cbc:CompanyLegalFormCode>
                <cbc:CompanyLegalForm>Organization</cbc:CompanyLegalForm>
            </cac:PartyLegalEntity>
            <cac:PartyName>
                <cbc:Name>Jane's Construction Company</cbc:Name>
            </cac:PartyName>
            <cac:PostalAddress>
                <cbc:AddressLine>99 pembroke square</cbc:AddressLine>
                <cbc:CityName>Dublin</cbc:CityName>
                <cbc:PostalZone>D04 P043</cbc:PostalZone>
                <cac:Country>
                    <cbc:IdentificationCode>IE</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:Contact>
                <cbc:Telephone>0439843234</cbc:Telephone>
                <cbc:ElectronicMail>advert@ads.com</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:AccountingCustomerParty>
    <cac:BuyerCustomerParty>
        <cac:Party>
            <cac:PartyTaxScheme>
                <cbc:CompanyID schemeID="VAT">0987654321</cbc:CompanyID>
                <cbc:CompanyID schemeID="SIREN">123456789</cbc:CompanyID>
            </cac:PartyTaxScheme>
            <cac:PartyName>
                <cbc:Name>Jane's Construction Company</cbc:Name>
            </cac:PartyName>
            <cac:PostalAddress>
                <cbc:AddressLine>456 Market St</cbc:AddressLine>
                <cbc:AddressLine>Floor 4</cbc:AddressLine>
                <cbc:CityName>New York</cbc:CityName>
                <cbc:PostalZone>10001</cbc:PostalZone>
                <cac:Country>
                    <cbc:IdentificationCode>US</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:Contact>
                <cbc:Telephone>987-654-3210</cbc:Telephone>
                <cbc:ElectronicMail>j@construction.com</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:BuyerCustomerParty>
  ...
</Invoice>

4. Teslimat bilgileri

Bu bölümde, ürün ve hizmet tedariki hakkında bilgiler yer almaktadır.

Yol Açıklama Örnek
cbc:ActualDeliveryDate Mal/hizmetin sağlandığı tarih 2023-05-17

5. Satır öğeleri

Satır öğeleri, faturada listelenen ayrı ürünler veya hizmetlerdir. Şema, fatura başına bir veya daha fazla satır öğesini destekler.

5.1 cac:InvoiceLine

Bu bölümde, benzersiz tanımlayıcıları, miktarları, birim fiyatları ve vergi öncesi ve sonrası toplam tutarlar da dahil olmak üzere faturadaki her öğe ayrıntılı olarak açıklanır. Faturalandırılan her öğeyle ilişkili maliyetlerin tam dökümünü sağlar.

Yol Açıklama Örnek
cbc:ID Bu satır öğesinin tanımlayıcısıdır. Toplu bir satır öğesi faturası için değer 1'dir. 1
cbc:InvoicedQuantity Faturalandırılan öğenin miktarı; birleştirilmiş bir satır öğesi faturası için değer 1'dir 1
cbc:LineExtensionAmount @currencyID Satır öğesinin orijinal para birimi cinsinden toplam tutarı (vergiler hariç) 1000
cac:Öğe/cbc:Ad Öğenin adı Google Cloud
cac:Price/cbc:PriceAmount @currencyID Öğenin orijinal para birimi cinsinden birim fiyatı 1000
cac:TaxTotal
cbc:TaxAmount @currencyID Satır öğesinin orijinal para biriminde toplam vergi tutarı 70
cac:TaxSubtotal/cbc:TaxableAmount @currencyID Satır öğesinin orijinal para biriminde vergiye tabi tutar 1000
cac:TaxSubtotal/cbc:TaxAmount @currencyID Satır öğesinin orijinal para biriminde vergi tutarı 70
cac:TaxSubtotal/cac:TaxCategory/cbc:Percent Satır öğesine uygulanan vergi oranı 7,00
cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID Bu alt toplamın vergi türü KDV

Örnek

<Invoice>
...
<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <cbc:InvoicedQuantity>1</cbc:InvoicedQuantity>
  <cbc:LineExtensionAmount currencyID="USD">1000</cbc:LineExtensionAmount>
  <cac:Item>
    <cbc:Name>Google Cloud</cbc:Name>
  </cac:Item>
  <cac:Price>
    <cbc:PriceAmount currencyID="USD">1000</cbc:PriceAmount>
  </cac:Price>
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:Percent>23.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
</cac:InvoiceLine>
...
</Invoice>

6. Toplam vergiler

Bu bölümde, fatura için geçerli olan toplam vergiler yer alır.

6.1 cac:TaxTotal

Bu öğe, fatura için geçerli olan toplam vergiyi temsil eder. Bu öğe, hem orijinal hem de yerel para biriminin gösterilmesi gerektiğinde tekrarlanır.

Yol Açıklama Örnek
cac:TaxTotal/cbc:TaxAmount Fatura için geçerli toplam vergi 70,00
cac:TaxTotal/cbc:TaxAmount/@currencyID Vergi tutarının para birimi kimliği USD

6.2 cac:TaxSubtotal

Bu öğe, tek bir vergi kategorisi için döküm sağlar. Bu öğe, farklı vergi türlerini temsil etmek için tekrarlanabilir.

Yol Açıklama Örnek
cac:TaxTotal/cac:TaxSubtotal/cbc:TaxableAmount @currencyID Orijinal para biriminde toplam vergiye tabi tutar 1.000,00
cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount @currencyID Vergiye tabi tutarın orijinal para birimi cinsinden vergi tutarı 70,00
cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:Percent Vergiye tabi tutara uygulanan vergi yüzdesi 7
cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID Ülkeye özgü vergi kodlarının listesini destekleyen vergi şeması adı, enum KDV

Örnek

<Invoice>
  ...
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:Percent>23.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  <cac:TaxTotal>
    <cac:TaxSubtotal>
      <cbc:TaxAmount currencyID="PLN">920</cbc:TaxAmount>
      <cbc:TaxableAmount currencyID="PLN">4000</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="PLN">920</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:Percent>23.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  ...
</Invoice>

7. Stopaj vergileri

Faturaya stopaj vergileri uygulanır. Stopaj, bir gelir öğesinin ödeyeninin ödemeden vergi stopajı veya kesintisi yapması ve bu vergiyi devlete ödemesi için devlet tarafından zorunlu kılınan bir işlemdir.

7.1 cac:WithholdingTaxTotal

Bu öğe, fatura için geçerli olan toplam stopaj vergisini temsil eder. Tüm cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount öğelerinin toplamı olmalıdır.

Yol Açıklama Örnek
cac:WithholdingTaxTotal/cbc:TaxAmount @currencyID Stopaj vergisinin toplam tutarı 6.5

7.2 cac:TaxSubtotal

Bu öğe, tek bir stopaj vergisi kategorisi için döküm sağlar.

Yol Açıklama Örnek
cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxableAmount @currencyID Stopaj vergisi kategorisi için vergiye tabi (vergi öncesi) tutar 1000
cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount @currencyID Stopaj vergisi kategorisinin vergi tutarı 6.5
cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:Percent Stopaj vergisi kategorisi için vergi yüzdesi 0,65
cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID Stopaj vergisi kategorisi için vergi türü PIS_WTH

Örnek

<Invoice>
  ...
  <cac:WithholdingTaxTotal>
    <cbc:TaxAmount currencyID="USD">6.5</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="USD">6.5</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:Percent>6.5</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>PIS_WTH</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:WithholdingTaxTotal>
  ...
</Invoice>

8. Ödeme şartları ve yöntemleri

Ödeme Şartları ve Yöntemleri bölümünde, beklenen ödeme yöntemi, ödeme kanalı ve ödeme tarihi gibi ödeme beklentileri özetlenmiştir.

8.1 cac:PaymentMeans/cbc:PaymentMeansCode

Bu öğe, ödeme yöntemini açıklar. PaymentMeansCode, UN/ECE 4461 kod listesine uyar. Not: PaymentMeansCode, UN/ECE 4461 kod listesini takip eder. Bu listede 31, banka havalesini ifade eder.

Yol Açıklama Örnek
cbc:PaymentMeansCode Ödeme yöntemi Kredi aktarımı için 30, banka havalesi için 31
cbc:PaymentDueDate Ödemenin son tarihi 2023-08-01
cac:PayeeFinancialAccount/cbc:ID Google'ın finansal hesap kimliği (Fatura şemasında kullanılır) GB99DEMO12345678901
cac:PayerFinancialAccount
cbc:ID Google'ın finansal hesap kimliği (Alacak notu şemasında kullanılır) GB99DEMO12345678901
cbc:Name Google banka hesabının adı Google Bank
cbc:AccountTypeCode Google banka hesabının türünü belirten bir kod UNKNOWN_ACCOUNT_TYPE = 0; CHECKING = 1; SAVINGS = 2; CURRENT = 3

8.2 cac:PaymentTerms/cbc:Note

Bu öğe, ek ödeme şartları bilgilerini metin biçiminde sağlar.

Yol Açıklama Örnek
cac:PaymentTerms/cbc:Note Diğer ödeme şartlarıyla ilgili bilgiler Net 30 terimleri

Örnek

<Invoice>
  ...
    <cac:PaymentMeans>
        <cbc:PaymentMeansCode>30</cbc:PaymentMeansCode>
        <cbc:PaymentDueDate>2023-08-01</cbc:PaymentDueDate>
        <cac:PayerFinancialAccount>
            <cbc:ID>GB99DEMO12345678901</cbc:ID>
        </cac:PayerFinancialAccount>
    </cac:PaymentMeans>
    <cac:PaymentTerms>
        <cbc:Note>Net 30 terms</cbc:Note>
    </cac:PaymentTerms>
  ...
</Invoice>

Yasal Parasal Toplam bölümünde, uygulanan tüm izinler veya ücretler, vergi, stopaj ve ödenmesi gereken nihai tutar dahil olmak üzere faturada ödenmesi gereken toplam tutar özetlenmiştir.

9.1 cac:LegalMonetaryTotal

Yol Açıklama Örnek
cbc:LineExtensionAmount @currencyID Herhangi bir indirim veya ödeme uygulanmadan önce tüm fatura satırlarının toplam tutarı. 1.000,00
cbc:AllowanceTotalAmount @currencyID Fatura için toplam izinler 0,00
cbc:TaxExclusiveAmount @currencyID Tüm fatura satırlarının, tüm indirimler veya ücretler uygulandıktan sonra ancak vergi uygulanmadan önceki toplam tutarı 950,00
cbc:TaxInclusiveAmount @currencyID Tüm fatura satırlarının, tüm izinler, ücretler ve vergiler uygulandıktan sonraki toplam tutarı 1071,50
cbc:PayableAmount @currencyID Alıcının ödeyeceği toplam tutar 1065,00

Örnek

<Invoice>
  ...
  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="USD">1000.00</cbc:LineExtensionAmount>
    <cbc:AllowanceTotalAmount currencyID="USD">0.00</cbc:AllowanceTotalAmount>
    <cbc:TaxExclusiveAmount currencyID="USD">1000.00</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="USD">1230.00</cbc:TaxInclusiveAmount>
    <cbc:PayableAmount currencyID="USD">1230.00</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>
  ...
</Invoice>