Giden Fatura
Giden Fatura Request Örnekleri
On profil ile iptal, itiraz ve sorgulama işlemleri için JSON ve ByXml endpointlerine ayrılmış kopyalanabilir request örnekleri.
Senaryo Kapsamı
Miktar alanları ham sayı yerine { "UnitCode", "Value" } biçiminde nesne olarak gönderilir. Aşağıdaki her örnek, ilgili endpoint'e doğrudan gönderilebilen tam bir request gövdesidir.
Desteklenen 10 ProfileId değerinin her biri için tam, bağımsız ve doğrudan kopyalanabilir JSON request gövdesi verilmiştir. Her örnek ortak zorunlu alanlarla birlikte profile özgü alanları da içerir. EARSIVFATURA bu rehberin kapsamı dışındadır.
InvoiceExternalId kullanın.| Örnek | Profil | Ayırt Edici Nokta |
|---|---|---|
| 1 | TemelFatura (temsilci — Grup 1) | Tam gövde; tek kalem, KDV, ek koşul yok |
| 2 | Kamu | BuyerCustomerParty zorunlu, PaymentMeans.PayeeFinancialAccount IBAN + para birimi |
| 3 | HKS (Hal Kayıt Sistemi) | InvoiceLine.Item.AdditionalItemIdentification içinde 19 haneli KUNYENO |
| 4 | Enerji | InvoiceTypeCode yalnızca SARJ/SARJANLIK olabilir |
| 5 | İlaç/Tıbbi Cihaz | AdditionalItemIdentification.SchemeId = ILAC/TIBBICIHAZ/DIGER |
| 6 | Yatırım Teşvik | ContractDocumentReference içinde 6 haneli YTBNO, Item.CommodityClassification |
| 7 | İDİS | IdisSevkiyatNo (SE- veya ES- + 7 hane) ve kalem bazlı ETIKETNO |
| 8 | TicariFatura (temsilci — Grup 2) | Tam gövde; ReceiverIdentifier ile alıcı etiketi doğrulaması |
| 9 | İhracat | Delivery.DeliveryTerms (INCOTERMS), ShipmentStage.TransportModeCode, GoodsItem.RequiredCustomsId (GTİP), DeliveryAddress, alıcı PARTYTYPE=EXPORT |
| 10 | Yolcu Beraberinde Eşya | Alıcı PARTYTYPE=TAXFREE, Person.IdentityDocumentReference (pasaport no) |
Her örnek ilgili profile referans verir.
| # | Profil | Grup |
|---|---|---|
| 1 | TemelFatura | 1 — Tek başına gönderilebilen |
| 2 | Kamu | 1 |
| 3 | HKS | 1 |
| 4 | Enerji | 1 |
| 5 | İlaç/Tıbbi Cihaz | 1 |
| 6 | Yatırım Teşvik | 1 |
| 7 | İDİS | 1 |
| 8 | TicariFatura | 2 — Taraflar arası ek bilgi taşıyan |
| 9 | İhracat | 2 |
| 10 | Yolcu Beraberinde Eşya | 2 |
Örnek 1: TemelFatura (temsilci örnek)
Grup 1'in temsilci örneği. Diğer tek-başına-gönderilebilen profiller (Kamu, HKS, Enerji, İlaç/Tıbbi Cihaz, Yatırım Teşvik, İDİS) bu gövdeyi temel alır; tam ve bağımsız request gövdeleri sonraki örneklerde gösterilir.
Tek kalemli, KDV'li (TaxTypeCode=0015) bir SATIS tipi TemelFatura.
Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-001",
"ProfileId": "TEMELFATURA",
"InvoiceTypeCode": "SATIS",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"LineCountNumeric": 1,
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "C62",
"Value": 10
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "Danışmanlık Hizmeti"
},
"Price": 100,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-001</InvoiceExternalId>
<ProfileId>TEMELFATURA</ProfileId>
<InvoiceTypeCode>SATIS</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-10T09:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>C62</UnitCode>
<Value>10</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>Danışmanlık Hizmeti</Name>
</Item>
<Price>100</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 2: KAMU İade
ProfileId=KAMU ile InvoiceTypeCode=IADE birlikte kullanılabilir. KAMU profilinin BuyerCustomerParty, geçerli Türkiye IBAN'ı ve hesap para birimi zorunluluklarına ek olarak iade edilen belge BillingReference[].InvoiceDocumentReference içinde gösterilir.
Bu tam örnek KAMU alanları ile iade referansını birlikte taşır.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
ProfileId | Z | KAMU (veya kamu alıcılı TEMELFATURA) |
BuyerCustomerParty | Z | VBT e-Fatura API sözleşmesinde zorunludur |
PaymentMeans[].PayeeFinancialAccount.Id | Z | Geçerli Türkiye IBAN'ı (regex ile doğrulanır) |
PaymentMeans[].PayeeFinancialAccount.CurrencyCode | Z | Boş bırakılamaz |
BillingReference[].InvoiceDocumentReference | Z | DocumentTypeCode=IADE, tam 16 karakterli Id ve kaynak belge tarihi |
Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-002",
"ProfileId": "KAMU",
"InvoiceTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"LineCountNumeric": 1,
"BillingReference": [
{
"InvoiceDocumentReference": {
"Id": "ABC2026000000001",
"IssueDate": "2026-06-01T00:00:00",
"DocumentTypeCode": "IADE"
}
}
],
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "C62",
"Value": 10
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "Danışmanlık Hizmeti"
},
"Price": 100,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
],
"BuyerCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Kamu Kurumu"
}
},
"PaymentMeans": [
{
"PayeeFinancialAccount": {
"Id": "TR330006100519786457841326",
"CurrencyCode": "TRY"
}
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-002</InvoiceExternalId>
<ProfileId>KAMU</ProfileId>
<InvoiceTypeCode>IADE</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-10T09:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>C62</UnitCode>
<Value>10</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>Danışmanlık Hizmeti</Name>
</Item>
<Price>100</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<BillingReference>
<BillingReferenceRequestModel>
<InvoiceDocumentReference>
<Id>ABC2026000000001</Id>
<IssueDate>2026-06-01T00:00:00</IssueDate>
<DocumentTypeCode>IADE</DocumentTypeCode>
</InvoiceDocumentReference>
<IsUsedAsDespatchAdvice>false</IsUsedAsDespatchAdvice>
</BillingReferenceRequestModel>
</BillingReference>
<BuyerCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Kamu Kurumu</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</BuyerCustomerParty>
<PaymentMeans>
<PaymentMeansRequestModel>
<PaymentDueDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<PayeeFinancialAccount>
<Id>TR330006100519786457841326</Id>
<CurrencyCode>TRY</CurrencyCode>
<CurrencyId>0</CurrencyId>
</PayeeFinancialAccount>
</PaymentMeansRequestModel>
</PaymentMeans>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 3: HKS (Hal Kayıt Sistemi)
ProfileId değeri HKS iken her InvoiceLine, SchemeId değeri KUNYENO olan ve değeri 19 karakter uzunluğunda bir AdditionalItemIdentification içermelidir.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
InvoiceLine[].Item.AdditionalItemIdentification[].SchemeId | Z | KUNYENO |
InvoiceLine[].Item.AdditionalItemIdentification[].Value | Z | Tam olarak 19 karakter |
Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-003",
"ProfileId": "HKS",
"InvoiceTypeCode": "HKSSATIS",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"LineCountNumeric": 1,
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "KGM",
"Value": 500
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "Domates",
"AdditionalItemIdentification": [
{
"SchemeId": "KUNYENO",
"Value": "1234567890123456789"
}
]
},
"Price": 2,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-003</InvoiceExternalId>
<ProfileId>HKS</ProfileId>
<InvoiceTypeCode>HKSSATIS</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-10T09:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>KGM</UnitCode>
<Value>500</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>Domates</Name>
<AdditionalItemIdentification>
<IdRequestModel>
<SchemeId>KUNYENO</SchemeId>
<Value>1234567890123456789</Value>
</IdRequestModel>
</AdditionalItemIdentification>
</Item>
<Price>2</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 4: Enerji
ProfileId değeri ENERJI iken InvoiceTypeCode yalnızca SARJ veya SARJANLIK olabilir. Aşağıdaki örnek, yürürlükteki SARJ alanlarını içerir.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
ProfileId | Z | ENERJI |
InvoiceTypeCode | Z | SARJ veya SARJANLIK |
InvoicePeriod | Z | Başlangıç ve bitiş tarih/saatleri birlikte |
AdditionalDocumentReference[] | Z | SARJ için en az bir ESURaporID GUID/tarih referansı |
AccountingCustomerParty...PartyIdentifications[] | Z | Tam bir PLAKA kaydı |
Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-004",
"ProfileId": "ENERJI",
"InvoiceTypeCode": "SARJ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-09-14T09:00:00+03:00",
"LineCountNumeric": 1,
"InvoicePeriod": {
"StartDate": "2026-09-14T10:00:00+03:00",
"EndDate": "2026-09-14T11:00:00+03:00"
},
"AdditionalDocumentReference": [
{
"SchemeId": "ESURaporID",
"Id": "11111111-2222-3333-4444-555555555555",
"IssueDate": "2026-09-14T00:00:00+03:00"
}
],
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
},
{
"SchemeId": "PLAKA",
"Value": "34ABC123"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "C62",
"Value": 10
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "Danışmanlık Hizmeti"
},
"Price": 100,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-004</InvoiceExternalId>
<ProfileId>ENERJI</ProfileId>
<InvoiceTypeCode>SARJ</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-09-14T09:00:00+03:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
<IdRequestModel>
<SchemeId>PLAKA</SchemeId>
<Value>34ABC123</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>C62</UnitCode>
<Value>10</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>Danışmanlık Hizmeti</Name>
</Item>
<Price>100</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<InvoicePeriod>
<StartDate>2026-09-14T10:00:00+03:00</StartDate>
<EndDate>2026-09-14T11:00:00+03:00</EndDate>
</InvoicePeriod>
<AdditionalDocumentReference>
<DocumentReferenceRequestModel>
<Id>11111111-2222-3333-4444-555555555555</Id>
<SchemeId>ESURaporID</SchemeId>
<IssueDate>2026-09-14T00:00:00+03:00</IssueDate>
</DocumentReferenceRequestModel>
</AdditionalDocumentReference>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 5: İlaç/Tıbbi Cihaz
ProfileId değeri ILAC_TIBBICIHAZ iken her InvoiceLine, SchemeId değeri ILAC, TIBBICIHAZ veya DIGER olan en az bir AdditionalItemIdentification içermelidir; ayrıca InvoiceTypeCode yalnızca SATIS, ISTISNA, TEVKIFAT, TEVKIFATIADE, IADE veya IHRACKAYITLI olabilir.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
InvoiceLine[].Item.AdditionalItemIdentification[].SchemeId | Z | ILAC / TIBBICIHAZ / DIGER |
InvoiceTypeCode | Z | SATIS, ISTISNA, TEVKIFAT, TEVKIFATIADE, IADE, IHRACKAYITLI |
Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-005",
"ProfileId": "ILAC_TIBBICIHAZ",
"InvoiceTypeCode": "SATIS",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"LineCountNumeric": 1,
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "C62",
"Value": 100
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "Steril Enjektör",
"AdditionalItemIdentification": [
{
"SchemeId": "TIBBICIHAZ",
"Value": "TC-UTS-000123"
}
]
},
"Price": 10,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-005</InvoiceExternalId>
<ProfileId>ILAC_TIBBICIHAZ</ProfileId>
<InvoiceTypeCode>SATIS</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-10T09:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>C62</UnitCode>
<Value>100</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>Steril Enjektör</Name>
<AdditionalItemIdentification>
<IdRequestModel>
<SchemeId>TIBBICIHAZ</SchemeId>
<Value>TC-UTS-000123</Value>
</IdRequestModel>
</AdditionalItemIdentification>
</Item>
<Price>10</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 6: Yatırım Teşvik
ProfileId değeri YATIRIMTESVIK iken ContractDocumentReference içinde SchemeId=YTBNO olan, 6 haneli değer ve dolu IssueDate içeren kayıt zorunludur. Güncel GİB kılavuzuna göre InvoiceTypeCode yalnızca SATIS, ISTISNA veya IADE olmalıdır.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
ContractDocumentReference[].SchemeId | Z | YTBNO |
ContractDocumentReference[].Id | Z | 6 haneli YTB numarası |
ContractDocumentReference[].IssueDate | Z | Boş bırakılamaz |
InvoiceLine[].Item.CommodityClassification[].Value | Ş | 01/02/03/04 — kod ile InvoiceTypeCode uyumu ayrıca kontrol edilir |
Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-006",
"ProfileId": "YATIRIMTESVIK",
"InvoiceTypeCode": "SATIS",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"LineCountNumeric": 1,
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "C62",
"Value": 1
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "CNC Torna Tezgahı",
"CommodityClassification": [
{
"Value": "01"
}
]
},
"Price": 1000,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
],
"ContractDocumentReference": [
{
"SchemeId": "YTBNO",
"Id": "123456",
"IssueDate": "2026-01-15T00:00:00"
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-006</InvoiceExternalId>
<ProfileId>YATIRIMTESVIK</ProfileId>
<InvoiceTypeCode>SATIS</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-10T09:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>C62</UnitCode>
<Value>1</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>CNC Torna Tezgahı</Name>
<CommodityClassification>
<Value>01</Value>
</CommodityClassification>
</Item>
<Price>1000</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<ContractDocumentReference>
<DocumentReferenceRequestModel>
<Id>123456</Id>
<SchemeId>YTBNO</SchemeId>
<IssueDate>2026-01-15T00:00:00</IssueDate>
</DocumentReferenceRequestModel>
</ContractDocumentReference>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 7: İDİS
ProfileId değeri IDIS iken IdisSevkiyatNo alanı SE- veya ES- ön eki ve ardından tam 7 rakam içermeli; her InvoiceLine, SchemeId değeri ETIKETNO olan ve düzeni doğrulanan bir AdditionalItemIdentification içermelidir.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
IdisSevkiyatNo | Z | SE- veya ES- + tam 7 rakam |
InvoiceLine[].Item.AdditionalItemIdentification[].SchemeId | Z | ETIKETNO |
InvoiceLine[].Item.AdditionalItemIdentification[].Value | Z | İlk 2 karakter harf, sonraki 7 karakter rakam |
Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-007",
"ProfileId": "IDIS",
"InvoiceTypeCode": "SATIS",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"LineCountNumeric": 1,
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "C62",
"Value": 10
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "Karkas Et",
"AdditionalItemIdentification": [
{
"SchemeId": "ETIKETNO",
"Value": "AB1234567"
}
]
},
"Price": 100,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
],
"IdisSevkiyatNo": "SE-1234567"
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-007</InvoiceExternalId>
<ProfileId>IDIS</ProfileId>
<InvoiceTypeCode>SATIS</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-10T09:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>C62</UnitCode>
<Value>10</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>Karkas Et</Name>
<AdditionalItemIdentification>
<IdRequestModel>
<SchemeId>ETIKETNO</SchemeId>
<Value>AB1234567</Value>
</IdRequestModel>
</AdditionalItemIdentification>
</Item>
<Price>100</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<PartyGroupId>0</PartyGroupId>
<IdisSevkiyatNo>SE-1234567</IdisSevkiyatNo>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 8: TicariFatura (temsilci örnek)
Grup 2'nin temsilci örneği. Request ortak alanların tamamını taşır; ProfileId değeri TICARIFATURA olduğunda ve ReceiverIdentifier (alıcı GİB etiketi) doldurulduğunda VBT bu etiketin ilgili mükellef için geçerli olup olmadığını GİB kullanıcı listesinden doğrular. Bu kontrol TemelFatura, TicariFatura ve Kamu profilleri için geçerlidir.
ProfileId değeri ve isteğe bağlı ReceiverIdentifier alanının eklenmesidir; kalem/vergi yapısı aynıdır.Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-008",
"ProfileId": "TICARIFATURA",
"InvoiceTypeCode": "SATIS",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-11T10:00:00",
"LineCountNumeric": 1,
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "C62",
"Value": 10
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "Danışmanlık Hizmeti"
},
"Price": 100,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
],
"ReceiverIdentifier": "urn:mail:ornekfirma@vbt.com.tr"
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-008</InvoiceExternalId>
<ProfileId>TICARIFATURA</ProfileId>
<InvoiceTypeCode>SATIS</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-11T10:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>C62</UnitCode>
<Value>10</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>Danışmanlık Hizmeti</Name>
</Item>
<Price>100</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<ReceiverIdentifier>urn:mail:ornekfirma@vbt.com.tr</ReceiverIdentifier>
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 9: İhracat
ProfileId değeri IHRACAT iken InvoiceTypeCode yalnızca ISTISNA olabilir; BuyerCustomerParty.Party.PartyIdentifications içinde SchemeId=PARTYTYPE, Value=EXPORT olan bir kayıt, PartyLegalEntity.RegistrationName, tedarikçi tarafında PartyTaxScheme.TaxScheme.Name, kalemlerde pozitif InvoicedQuantity, teslimat bilgilerinde (fatura ya da kalem seviyesinde) DeliveryTerms altında SchemeId=INCOTERMS olan bir Id ile Shipment.ShipmentStage.TransportModeCode, fatura veya kalem seviyesinde en az bir Delivery.DeliveryAddress, ve her kalemde Delivery.Shipment.GoodsItem.RequiredCustomsId (GTİP, 12 haneli numerik) zorunludur.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
InvoiceTypeCode | Z | ISTISNA |
BuyerCustomerParty.Party.PartyIdentifications[] | Z | SchemeId=PARTYTYPE, Value=EXPORT |
BuyerCustomerParty.Party.PartyLegalEntity[].RegistrationName | Z | Boş bırakılamaz |
AccountingSupplierParty.Party.PartyTaxScheme.TaxScheme.Name | Z | Boş bırakılamaz |
InvoiceLine[].InvoicedQuantity | Z | Dolu ve > 0 |
Delivery[].DeliveryTerms[].Id | Z | SchemeId=INCOTERMS — fatura veya kalem seviyesinde en az bir tanesinde |
Delivery[].Shipment.ShipmentStage[].TransportModeCode | Z | Fatura veya kalem seviyesinde en az bir tanesinde dolu olmalı |
Delivery[].DeliveryAddress | Z | Fatura veya kalem seviyesinde en az bir tanesinde dolu olmalı |
InvoiceLine[].Delivery[].Shipment.GoodsItem[].RequiredCustomsId | Z | GTİP kodu — 12 haneli, yalnızca rakam |
InvoiceTypeCode ISTISNA'ya sabitlenir; BuyerCustomerParty, PartyLegalEntity, PartyTaxScheme ve Delivery (adres, INCOTERMS, taşıma şekli, GTİP) alanları eklenir.Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-009",
"ProfileId": "IHRACAT",
"InvoiceTypeCode": "ISTISNA",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"LineCountNumeric": 1,
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek İhracat A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
},
"PartyTaxScheme": {
"TaxScheme": {
"Name": "Kadıköy Vergi Dairesi"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "KGM",
"Value": 1000
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "Tekstil Ürünü"
},
"Price": 1,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
},
"Delivery": [
{
"Shipment": {
"GoodsItem": [
{
"RequiredCustomsId": "610910000000"
}
]
}
}
]
}
],
"ReceiverIdentifier": "urn:mail:ihracatpk@gtb.gov.tr",
"BuyerCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "PARTYTYPE",
"Value": "EXPORT"
}
],
"PartyName": "Foreign Buyer GmbH",
"PartyLegalEntity": [
{
"RegistrationName": "Foreign Buyer GmbH"
}
]
}
},
"Delivery": [
{
"DeliveryAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
},
"DeliveryTerms": [
{
"Id": {
"SchemeId": "INCOTERMS",
"Value": "FOB"
}
}
],
"Shipment": {
"ShipmentStage": [
{
"TransportModeCode": "1"
}
]
}
}
]
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-009</InvoiceExternalId>
<ProfileId>IHRACAT</ProfileId>
<InvoiceTypeCode>ISTISNA</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-10T09:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek İhracat A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<PartyTaxScheme>
<TaxScheme>
<Name>Kadıköy Vergi Dairesi</Name>
</TaxScheme>
</PartyTaxScheme>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>KGM</UnitCode>
<Value>1000</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>Tekstil Ürünü</Name>
</Item>
<Price>1</Price>
<Delivery>
<ActualDeliveryDate p5:nil="true" xmlns:p5="http://www.w3.org/2001/XMLSchema-instance" />
<ActualDeliveryTime p5:nil="true" xmlns:p5="http://www.w3.org/2001/XMLSchema-instance" />
<LatestDeliveryDate p5:nil="true" xmlns:p5="http://www.w3.org/2001/XMLSchema-instance" />
<LatestDeliveryTime p5:nil="true" xmlns:p5="http://www.w3.org/2001/XMLSchema-instance" />
<Shipment>
<InsuranceValueAmount>0</InsuranceValueAmount>
<DeclaredCustomsValueAmount>0</DeclaredCustomsValueAmount>
<DeclaredForCarriageValueAmount>0</DeclaredForCarriageValueAmount>
<DeclaredStatisticsValueAmount>0</DeclaredStatisticsValueAmount>
<FreeOnBoardValueAmount>0</FreeOnBoardValueAmount>
<GoodsItem>
<GoodsItemRequestModel>
<HazardousRiskIndicator>false</HazardousRiskIndicator>
<DeclaredCustomsValueAmount>0</DeclaredCustomsValueAmount>
<DeclaredForCarriageValueAmount>0</DeclaredForCarriageValueAmount>
<DeclaredStatisticsValueAmount>0</DeclaredStatisticsValueAmount>
<FreeOnBoardValueAmount>0</FreeOnBoardValueAmount>
<InsuranceValueAmount>0</InsuranceValueAmount>
<ValueAmount>0</ValueAmount>
<RequiredCustomsId>610910000000</RequiredCustomsId>
<CustomsImportClassifiedIndicator>false</CustomsImportClassifiedIndicator>
</GoodsItemRequestModel>
</GoodsItem>
</Shipment>
</Delivery>
</InvoiceLineRequestModel>
</InvoiceLine>
<BuyerCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>PARTYTYPE</SchemeId>
<Value>EXPORT</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Foreign Buyer GmbH</PartyName>
<PartyLegalEntity>
<PartyLegalEntityRequestModel>
<RegistrationName>Foreign Buyer GmbH</RegistrationName>
<RegistrationDate p6:nil="true" xmlns:p6="http://www.w3.org/2001/XMLSchema-instance" />
<SoleProprietorshipIndicator>false</SoleProprietorshipIndicator>
<CorporateStockAmount>0</CorporateStockAmount>
<FullyPaidSharesIndicator>false</FullyPaidSharesIndicator>
</PartyLegalEntityRequestModel>
</PartyLegalEntity>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</BuyerCustomerParty>
<Delivery>
<DeliveryRequestModel>
<ActualDeliveryDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<ActualDeliveryTime p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<LatestDeliveryDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<LatestDeliveryTime p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<DeliveryAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</DeliveryAddress>
<DeliveryTerms>
<DeliveryTermsRequestModel>
<Id>
<SchemeId>INCOTERMS</SchemeId>
<Value>FOB</Value>
</Id>
<Amount>0</Amount>
</DeliveryTermsRequestModel>
</DeliveryTerms>
<Shipment>
<InsuranceValueAmount>0</InsuranceValueAmount>
<DeclaredCustomsValueAmount>0</DeclaredCustomsValueAmount>
<DeclaredForCarriageValueAmount>0</DeclaredForCarriageValueAmount>
<DeclaredStatisticsValueAmount>0</DeclaredStatisticsValueAmount>
<FreeOnBoardValueAmount>0</FreeOnBoardValueAmount>
<ShipmentStage>
<TransportModeCode>1</TransportModeCode>
</ShipmentStage>
</Shipment>
</DeliveryRequestModel>
</Delivery>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<ReceiverIdentifier>urn:mail:ihracatpk@gtb.gov.tr</ReceiverIdentifier>
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 10: Yolcu Beraberinde Eşya
ProfileId değeri YOLCUBERABERFATURA iken InvoiceTypeCode yalnızca ISTISNA olabilir; BuyerCustomerParty.Party.PartyIdentifications içinde SchemeId=PARTYTYPE, Value=TAXFREE olan bir kayıt bulunmalı ve aynı tarafın Person.IdentityDocumentReference.Id alanı (pasaport numarası) boş bırakılmamalıdır.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
InvoiceTypeCode | Z | ISTISNA |
BuyerCustomerParty.Party.PartyIdentifications[] | Z | SchemeId=PARTYTYPE, Value=TAXFREE |
BuyerCustomerParty.Party.Person.IdentityDocumentReference.Id | Z | Pasaport numarası; boş bırakılamaz |
EXPORT/İhracat alanları yerine TAXFREE kimliği ve pasaport referansı kullanılır. Bu profil için zorunlu alanlar yukarıdaki tabloda verilen alıcı kimliği ve pasaport referansıdır.Endpoint: POST /api/VbtApi/AddOutgoingInvoice
Body: OutgoingInvoiceRequestModel (JSON)
{
"InvoiceExternalId": "ERP-EF-2026-010",
"ProfileId": "YOLCUBERABERFATURA",
"InvoiceTypeCode": "ISTISNA",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"LineCountNumeric": 1,
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Ticaret A.Ş.",
"PostalAddress": {
"CityName": "İstanbul",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "9876543210"
}
],
"PartyName": "Alıcı Firma Ltd. Şti."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000,
"TaxExclusiveAmount": 1000,
"TaxInclusiveAmount": 1200,
"PayableAmount": 1200
},
"TaxTotal": [
{
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
],
"InvoiceLine": [
{
"Id": "1",
"InvoicedQuantity": {
"UnitCode": "C62",
"Value": 2
},
"LineExtensionAmount": 1000,
"Item": {
"Name": "El Yapımı Halı"
},
"Price": 500,
"TaxTotal": {
"TaxAmount": 200,
"TaxSubtotal": [
{
"TaxableAmount": 1000,
"TaxAmount": 200,
"Percent": 20,
"TaxCategory": {
"TaxScheme": {
"Name": "KDV",
"TaxTypeCode": "0015"
}
}
}
]
}
}
],
"ReceiverIdentifier": "urn:mail:yolcuberaberpk@gtb.gov.tr",
"BuyerCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "PARTYTYPE",
"Value": "TAXFREE"
}
],
"PartyName": "John Traveler",
"Person": {
"FirstName": "John",
"FamilyName": "Traveler",
"NationalityId": "DE",
"IdentityDocumentReference": {
"Id": "P1234567"
}
}
}
}
}Endpoint: POST /api/VbtApi/AddOutgoingInvoiceByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<OutgoingInvoiceRequestModel>
<Id>0</Id>
<InvoiceExternalId>ERP-EF-2026-010</InvoiceExternalId>
<ProfileId>YOLCUBERABERFATURA</ProfileId>
<InvoiceTypeCode>ISTISNA</InvoiceTypeCode>
<DocumentCurrencyCode>TRY</DocumentCurrencyCode>
<CopyIndicator>false</CopyIndicator>
<IssueDate>2026-06-10T09:00:00</IssueDate>
<LineCountNumeric>1</LineCountNumeric>
<AccountingSupplierParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>1234567890</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Örnek Ticaret A.Ş.</PartyName>
<PostalAddress>
<CityName>İstanbul</CityName>
<Country>
<Name>Türkiye</Name>
</Country>
</PostalAddress>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingSupplierParty>
<AccountingCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>VKN</SchemeId>
<Value>9876543210</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>Alıcı Firma Ltd. Şti.</PartyName>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</AccountingCustomerParty>
<TaxTotal>
<TaxTotalRequestModel>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotalRequestModel>
</TaxTotal>
<LegalMonetaryTotal>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxExclusiveAmount>1000</TaxExclusiveAmount>
<TaxInclusiveAmount>1200</TaxInclusiveAmount>
<AllowanceTotalAmount>0</AllowanceTotalAmount>
<ChargeTotalAmount>0</ChargeTotalAmount>
<PayableRoundingAmount>0</PayableRoundingAmount>
<PayableAmount>1200</PayableAmount>
</LegalMonetaryTotal>
<InvoiceLine>
<InvoiceLineRequestModel>
<Id>1</Id>
<InvoicedQuantity>
<UnitCode>C62</UnitCode>
<Value>2</Value>
</InvoicedQuantity>
<LineExtensionAmount>1000</LineExtensionAmount>
<TaxTotal>
<TaxAmount>200</TaxAmount>
<TaxSubtotal>
<TaxSubtotalRequestModel>
<TaxableAmount>1000</TaxableAmount>
<TaxAmount>200</TaxAmount>
<CalculationSequenceNumeric>0</CalculationSequenceNumeric>
<TransactionCurrencyTaxAmount>0</TransactionCurrencyTaxAmount>
<Percent>20</Percent>
<PerUnitAmount>0</PerUnitAmount>
<TaxCategory>
<TaxScheme>
<Name>KDV</Name>
<TaxTypeCode>0015</TaxTypeCode>
</TaxScheme>
</TaxCategory>
</TaxSubtotalRequestModel>
</TaxSubtotal>
</TaxTotal>
<Item>
<Name>El Yapımı Halı</Name>
</Item>
<Price>500</Price>
</InvoiceLineRequestModel>
</InvoiceLine>
<BuyerCustomerParty>
<Party>
<Id>0</Id>
<PartyIdentifications>
<IdRequestModel>
<SchemeId>PARTYTYPE</SchemeId>
<Value>TAXFREE</Value>
</IdRequestModel>
</PartyIdentifications>
<PartyName>John Traveler</PartyName>
<Person>
<FirstName>John</FirstName>
<FamilyName>Traveler</FamilyName>
<NationalityId>DE</NationalityId>
<IdentityDocumentReference>
<Id>P1234567</Id>
<IssueDate>0001-01-01T00:00:00</IssueDate>
</IdentityDocumentReference>
</Person>
<OpenningBalanceDate p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<OpenningBalance>0</OpenningBalance>
<CategoryId>0</CategoryId>
<PartyTypeId>0</PartyTypeId>
</Party>
</BuyerCustomerParty>
<DatePosted p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<TryCount>0</TryCount>
<PutInvoiceNumberIntoQrCode p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
<ReceiverIdentifier>urn:mail:yolcuberaberpk@gtb.gov.tr</ReceiverIdentifier>
<PartyGroupId>0</PartyGroupId>
<IsOocumentNumberIncluded p2:nil="true" xmlns:p2="http://www.w3.org/2001/XMLSchema-instance" />
</OutgoingInvoiceRequestModel>Örnek 11: Giden Fatura İptali
İptal isteği yalnızca iptali desteklenen profiller için kullanılmalıdır. ETTN değeri, oluşturma yanıtından saklanan belge kimliğidir.
Endpoint: POST /api/Invoice/CancelOutgoingInvoice
Body: InvoiceCancelRequestModel (JSON)
{
"Ettn": "7f8c9726-5e6f-4dc4-a984-f3da76e2a912"
}
Örnek 12: Giden Fatura İtirazı
İtiraz belgesinin tarihi, numarası, yöntemi ve açıklaması ETTN ile birlikte gönderilir.
Endpoint: POST /api/Invoice/ObjectOutgoingInvoice
Body: DocumentObjectionRequestModel (JSON)
{
"UUId": "7f8c9726-5e6f-4dc4-a984-f3da76e2a912",
"ObjectingDocumentDate": "2026-07-31T10:30:00",
"ObjectingDocumentNumber": "KEP-2026-000184",
"ObjectingType": "KEP",
"ObjectingDescription": "İtiraz bildirimi KEP üzerinden iletilmiştir."
}
Örnek 13: Giden Fatura Sorgulama
Liste sorgusu sayfalama bilgisiyle birlikte bir Query nesnesi taşır. Aşağıdaki örnek tarih aralığı ve profil filtresi uygular.
Endpoint: POST /api/VbtApi/GetOutgoingInvoiceList
Body: SearchRequestModel<OutgoingInvoiceGetRequestModel> (JSON)
{
"Skip": 0,
"Take": 20,
"OrderByName": "IssueDate",
"OrderByType": "Descending",
"Query": {
"IssueDate": {
"StartDate": "2026-07-01T00:00:00",
"EndDate": "2026-07-31T23:59:59"
},
"ProfileId": "TICARIFATURA"
}
}Endpoint: POST /api/VbtApi/GetOutgoingInvoiceListByXml
Body: XmlRequestModel; aşağıdaki XML XmlModel alanına verilir.
<SearchRequestModel>
<Skip>0</Skip>
<Take>20</Take>
<OrderByName>IssueDate</OrderByName>
<OrderByType>Descending</OrderByType>
<Query>
<IssueDate>
<StartDate>2026-07-01T00:00:00</StartDate>
<EndDate>2026-07-31T23:59:59</EndDate>
</IssueDate>
<ProfileId>TICARIFATURA</ProfileId>
</Query>
</SearchRequestModel>