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:
- Fatura üstbilgisi
- Tedarikçi bilgileri
- Alıcı bilgileri
- Yayınlama bilgileri
- Satır öğeleri
- Toplam vergi
- Stopaj vergileri
- Ödeme şartları ve yöntemleri
- 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>
9. Yasal parasal toplam
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>