e-Fatura

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.

Kullanım: Her JSON bloğu ilgili endpoint'in gerçek request modeliyle uyumlu, bağımsız ve doğrudan kopyalanabilir tam bir gövdedir. Her gönderimde benzersiz bir InvoiceExternalId kullanın.
ÖrnekProfilAyırt Edici Nokta
1TemelFatura (temsilci — Grup 1)Tam gövde; tek kalem, KDV, ek koşul yok
2KamuBuyerCustomerParty zorunlu, PaymentMeans.PayeeFinancialAccount IBAN + para birimi
3HKS (Hal Kayıt Sistemi)InvoiceLine.Item.AdditionalItemIdentification içinde 19 haneli KUNYENO
4EnerjiInvoiceTypeCode yalnızca SARJ/SARJANLIK olabilir
5İlaç/Tıbbi CihazAdditionalItemIdentification.SchemeId = ILAC/TIBBICIHAZ/DIGER
6Yatırım TeşvikContractDocumentReference içinde 6 haneli YTBNO, Item.CommodityClassification
7İDİSIdisSevkiyatNo (SE- veya ES- + 7 hane) ve kalem bazlı ETIKETNO
8TicariFatura (temsilci — Grup 2)Tam gövde; ReceiverIdentifier ile alıcı etiketi doğrulaması
9İhracatDelivery.DeliveryTerms (INCOTERMS), ShipmentStage.TransportModeCode, GoodsItem.RequiredCustomsId (GTİP), DeliveryAddress, alıcı PARTYTYPE=EXPORT
10Yolcu Beraberinde EşyaAlıcı PARTYTYPE=TAXFREE, Person.IdentityDocumentReference (pasaport no)

Her örnek ilgili profile referans verir.

#ProfilGrup
1TemelFatura1 — Tek başına gönderilebilen
2Kamu1
3HKS1
4Enerji1
5İlaç/Tıbbi Cihaz1
6Yatırım Teşvik1
7İDİS1
8TicariFatura2 — Taraflar arası ek bilgi taşıyan
9İhracat2
10Yolcu Beraberinde Eşya2

Ö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"
              }
            }
          }
        ]
      }
    }
  ]
}

Ö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.

AlanZorunlulukDeğer/Kural
ProfileIdZKAMU (veya kamu alıcılı TEMELFATURA)
BuyerCustomerPartyZVBT e-Fatura API sözleşmesinde zorunludur
PaymentMeans[].PayeeFinancialAccount.IdZGeçerli Türkiye IBAN'ı (regex ile doğrulanır)
PaymentMeans[].PayeeFinancialAccount.CurrencyCodeZBoş bırakılamaz
BillingReference[].InvoiceDocumentReferenceZDocumentTypeCode=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"
      }
    }
  ]
}

Ö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.

AlanZorunlulukDeğer/Kural
InvoiceLine[].Item.AdditionalItemIdentification[].SchemeIdZKUNYENO
InvoiceLine[].Item.AdditionalItemIdentification[].ValueZTam 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"
              }
            }
          }
        ]
      }
    }
  ]
}

Ö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.

AlanZorunlulukDeğer/Kural
ProfileIdZENERJI
InvoiceTypeCodeZSARJ veya SARJANLIK
InvoicePeriodZBaşlangıç ve bitiş tarih/saatleri birlikte
AdditionalDocumentReference[]ZSARJ için en az bir ESURaporID GUID/tarih referansı
AccountingCustomerParty...PartyIdentifications[]ZTam 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"
              }
            }
          }
        ]
      }
    }
  ]
}

Ö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.

AlanZorunlulukDeğer/Kural
InvoiceLine[].Item.AdditionalItemIdentification[].SchemeIdZILAC / TIBBICIHAZ / DIGER
InvoiceTypeCodeZSATIS, 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"
              }
            }
          }
        ]
      }
    }
  ]
}

Ö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.

AlanZorunlulukDeğer/Kural
ContractDocumentReference[].SchemeIdZYTBNO
ContractDocumentReference[].IdZ6 haneli YTB numarası
ContractDocumentReference[].IssueDateZBoş 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"
    }
  ]
}

Ö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.

AlanZorunlulukDeğer/Kural
IdisSevkiyatNoZSE- veya ES- + tam 7 rakam
InvoiceLine[].Item.AdditionalItemIdentification[].SchemeIdZETIKETNO
InvoiceLine[].Item.AdditionalItemIdentification[].ValueZİ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"
}

Ö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.

Fark: Örnek 1'e göre tek değişiklik 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"
}

Ö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.

AlanZorunlulukDeğer/Kural
InvoiceTypeCodeZISTISNA
BuyerCustomerParty.Party.PartyIdentifications[]ZSchemeId=PARTYTYPE, Value=EXPORT
BuyerCustomerParty.Party.PartyLegalEntity[].RegistrationNameZBoş bırakılamaz
AccountingSupplierParty.Party.PartyTaxScheme.TaxScheme.NameZBoş bırakılamaz
InvoiceLine[].InvoicedQuantityZDolu ve > 0
Delivery[].DeliveryTerms[].IdZSchemeId=INCOTERMS — fatura veya kalem seviyesinde en az bir tanesinde
Delivery[].Shipment.ShipmentStage[].TransportModeCodeZFatura veya kalem seviyesinde en az bir tanesinde dolu olmalı
Delivery[].DeliveryAddressZFatura veya kalem seviyesinde en az bir tanesinde dolu olmalı
InvoiceLine[].Delivery[].Shipment.GoodsItem[].RequiredCustomsIdZGTİP kodu — 12 haneli, yalnızca rakam
Fark: Örnek 8'e göre 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"
          }
        ]
      }
    }
  ]
}

Ö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.

AlanZorunlulukDeğer/Kural
InvoiceTypeCodeZISTISNA
BuyerCustomerParty.Party.PartyIdentifications[]ZSchemeId=PARTYTYPE, Value=TAXFREE
BuyerCustomerParty.Party.Person.IdentityDocumentReference.IdZPasaport numarası; boş bırakılamaz
Fark: Örnek 9'daki 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"
        }
      }
    }
  }
}

Ö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"
  }
}