Örnekler
Request Örnekleri
SATIS ve IADE senaryolarına uyarlanacak JSON request şablonları ve alan açıklamaları.
Şablonları kendi verinize uyarlayın: ExternalId, taraf kimlikleri, telefon, sağlayıcı adı ve VKN, kargo bilgileri, tarihler ve belge referansları örnek değerlerdir. Bir request gönderilmeden önce bütün değerler gerçek işlem ve seçilen senaryoyla eşleştirilmelidir.
Her örnek ilgili senaryoya referans verir.
| # | Senaryo | Tip | Kargo | Vekalet | Belge Ref |
|---|---|---|---|---|---|
| 1 | S1 | SATIS | — | — | — |
| 2 | S3 | SATIS | — | — | — (Yabancı) |
| 3 | I1 | IADE | — | — | EARSIV_FATURA |
| 4 | I2 | IADE | — | — | SATIS_FISI |
| 5 | I3 | IADE | — | — | BELGESIZ |
| 6 | I4 | IADE | — | — | EARSIV_FATURA (Yabancı) |
| 7 | I5 | IADE | ✅ | — | EARSIV_FATURA |
| 8 | I6 | IADE | ✅ | — | EARSIV_FATURA (Yabancı) |
| 9 | I8 | IADE | — | ✅ | EARSIV_FATURA |
| 10 | I9 | IADE | — | ✅ (Yabancı vekil) | EARSIV_FATURA |
| 11 | I10 | IADE | ✅ | ✅ | EARSIV_FATURA |
| 12 | I10 varyant | IADE | ✅ | ✅ | BELGESIZ |
| 13 | I10 varyant | IADE | ✅ | ✅ | SATIS_FISI |
Örnek 1: SATIS — Normal Satın Alma, SMS ile
Request gövdesi, SATIS — Normal Satın Alma, SMS ile akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle S1
KDV mükellefi olmayan gerçek kişiden hizmet alımı. VerificationMethod=SMS.
{
"ExpenseVoucherExternalId": "ERP-2026-001",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "SATIS",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T12:00:00.000Z",
"VerificationMethod": "SMS",
"VerificationProvider": {
"ApplicationName": "NetGSM",
"Vkn": "1234567890"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "12345678901" }
],
"PartyName": "Mehmet Usta",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"VerificationInfo": {
"Code": "123456",
"PhoneNumber": "05321234567"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1000.00,
"TaxExclusiveAmount": 1000.00,
"TaxInclusiveAmount": 1200.00,
"PayableAmount": 1200.00
},
"TaxTotal": [
{
"TaxAmount": 200.00,
"TaxSubtotal": [
{
"TaxableAmount": 1000.00,
"TaxAmount": 200.00,
"Percent": 20.0,
"TaxCategory": { "TaxScheme": { "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 1000.00,
"Item": { "Name": "Klima tamiri hizmeti" },
"Price": 1000.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 200.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 200.00
}]
}
]
}Örnek 2: SATIS — Yabancı Uyruklu, SMS ile
Request gövdesi, SATIS — Yabancı Uyruklu, SMS ile akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle S3
Yabancı uyruklu kişiden hizmet alımı. SchemeId = PASAPORTNO.
{
"ExpenseVoucherExternalId": "ERP-2026-002",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "SATIS",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T14:00:00",
"VerificationMethod": "SMS",
"VerificationProvider": {
"ApplicationName": "NetGSM",
"Vkn": "1234567890"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "PASAPORTNO", "Value": "AB1234567" }
],
"PartyName": "John Smith",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"VerificationInfo": {
"Code": "789012",
"PhoneNumber": "05551234567"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 800.00,
"TaxExclusiveAmount": 800.00,
"TaxInclusiveAmount": 960.00,
"PayableAmount": 960.00
},
"TaxTotal": [
{
"TaxAmount": 160.00,
"TaxSubtotal": [
{
"TaxableAmount": 800.00, "TaxAmount": 160.00,
"Percent": 20.0,
"TaxCategory": { "TaxScheme": { "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 800.00,
"Item": { "Name": "Tercümanlık hizmeti" },
"Price": 800.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 160.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 160.00
}]
}
]
}💡 Fark: SchemeId =
PASAPORTNO, Value = ICAO pasaport no (max 9 karakter).Örnek 3: IADE — Yüz Yüze, e-Arşiv Fatura, İade Kodu
Request gövdesi, IADE — Yüz Yüze, e-Arşiv Fatura, İade Kodu akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I1
Müşteri kasada, iade kodu doğrulanmış. VerificationMethod=IADEKODU.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-041",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T15:00:00",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"VerificationInfo": {
"Code": "ABC123",
"PhoneNumber": "05441234567"
},
"ReturnedDocumentReference": {
"DocumentType": "EARSIV_FATURA",
"DocumentNumber": "GIB2026000000456",
"IssueDate": "2026-03-15"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 500.00,
"TaxExclusiveAmount": 500.00,
"TaxInclusiveAmount": 600.00,
"PayableAmount": 600.00
},
"TaxTotal": [
{
"TaxAmount": 100.00,
"TaxSubtotal": [
{
"TaxableAmount": 500.00, "TaxAmount": 100.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 500.00,
"Item": { "Name": "Spor ayakkabı" },
"Price": 500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 100.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 100.00
}]
}
]
}Örnek 4: IADE — Yüz Yüze, Satış Fişi ile
Request gövdesi, IADE — Yüz Yüze, Satış Fişi ile akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I2
Satış fişine karşılık yüz yüze iade. Örnek 3 ile aynı, sadece ReturnedDocumentReference farklı.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-044",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T15:30:00",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"VerificationInfo": {
"Code": "DEF456",
"PhoneNumber": "05441234567"
},
"ReturnedDocumentReference": {
"DocumentType": "SATIS_FISI",
"DocumentNumber": "SF2026001234",
"IssueDate": "2026-04-10"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 500.00,
"TaxExclusiveAmount": 500.00,
"TaxInclusiveAmount": 600.00,
"PayableAmount": 600.00
},
"TaxTotal": [
{
"TaxAmount": 100.00,
"TaxSubtotal": [
{
"TaxableAmount": 500.00, "TaxAmount": 100.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 500.00,
"Item": { "Name": "Spor ayakkabı" },
"Price": 500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 100.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 100.00
}]
}
]
}💡 Fark:
DocumentType = "SATIS_FISI", DocumentNumber = fiş numarası.Örnek 5: IADE — Yüz Yüze, Belgesiz
Request gövdesi, IADE — Yüz Yüze, Belgesiz akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I3
Karşılığında belge yoktur. DocumentNumber boş bırakılır; T.C. vatandaşı için gerçek TCKN, yabancı uyruklu kişi için gerçek PASAPORTNO gönderilmelidir.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-045",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T16:00:00",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"VerificationInfo": {
"Code": "GHI789",
"PhoneNumber": "05441234567"
},
"ReturnedDocumentReference": {
"DocumentType": "BELGESIZ",
"IssueDate": "2026-05-01"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 300.00,
"TaxExclusiveAmount": 300.00,
"TaxInclusiveAmount": 360.00,
"PayableAmount": 360.00
},
"TaxTotal": [
{
"TaxAmount": 60.00,
"TaxSubtotal": [
{
"TaxableAmount": 300.00, "TaxAmount": 60.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 300.00,
"Item": { "Name": "Tişört" },
"Price": 300.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 60.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 60.00
}]
}
]
}⚠️ Fark:
DocumentNumber alanı yoktur. BELGESIZ iadede T.C. vatandaşı için gerçek TCKN, yabancı uyruklu kişi için gerçek PASAPORTNO gönderilmelidir; kimliğin doğruluğu entegratörün sorumluluğundadır.Örnek 6: IADE — Yüz Yüze, Yabancı Uyruklu
Request gövdesi, IADE — Yüz Yüze, Yabancı Uyruklu akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I4
Yabancı uyruklu müşteri yüz yüze iade yapıyor. SchemeId = PASAPORTNO.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-046",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-26T10:00:00",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "PASAPORTNO", "Value": "CD9876543" }
],
"PartyName": "Elena Petrova",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"VerificationInfo": {
"Code": "XYZ999",
"PhoneNumber": "05331112233"
},
"ReturnedDocumentReference": {
"DocumentType": "EARSIV_FATURA",
"DocumentNumber": "GIB2026000000789",
"IssueDate": "2026-04-20"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 750.00,
"TaxExclusiveAmount": 750.00,
"TaxInclusiveAmount": 900.00,
"PayableAmount": 900.00
},
"TaxTotal": [
{
"TaxAmount": 150.00,
"TaxSubtotal": [
{
"TaxableAmount": 750.00, "TaxAmount": 150.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 750.00,
"Item": { "Name": "Deri çanta" },
"Price": 750.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 150.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 150.00
}]
}
]
}💡 Fark: SchemeId =
PASAPORTNO. Kargo/vekalet yok, yabancı uyruklu yüz yüze iade.Örnek 7: IADE — Kargo, Vekalet Yok
Request gövdesi, IADE — Kargo, Vekalet Yok akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I5
Kargo ile iade, vekil yok. VerificationMethod=IADEKODU + CargoCompanyCode.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-043",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T15:00:00",
"CargoCompanyCode": "YURTICI",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"VerificationInfo": {
"Code": "ABC123",
"PhoneNumber": "05441234567"
},
"ReturnedDocumentReference": {
"DocumentType": "EARSIV_FATURA",
"DocumentNumber": "GIB2026000000456",
"IssueDate": "2026-03-15"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 500.00,
"TaxExclusiveAmount": 500.00,
"TaxInclusiveAmount": 600.00,
"PayableAmount": 600.00
},
"TaxTotal": [
{
"TaxAmount": 100.00,
"TaxSubtotal": [
{
"TaxableAmount": 500.00, "TaxAmount": 100.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 500.00,
"Item": { "Name": "Spor ayakkabı" },
"Price": 500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 100.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 100.00
}]
}
]
}💡 Fark:
CargoCompanyCode dolu, DelegateReceiver yok. Kargo kuralları geçerli: VerificationMethod=IADEKODU zorunlu.Örnek 8: IADE — Kargo, Yabancı Uyruklu
Request gövdesi, IADE — Kargo, Yabancı Uyruklu akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I6
Kargo ile iade, alıcı yabancı. Kargo kuralları uyruğa bakılmaksızın geçerli.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-047",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-26T11:00:00",
"CargoCompanyCode": "YURTICI",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "PASAPORTNO", "Value": "EF4567890" }
],
"PartyName": "Hans Müller",
"PostalAddress": {
"CityName": "Antalya",
"Country": { "Name": "Türkiye" }
}
}
},
"VerificationInfo": {
"Code": "RET001",
"PhoneNumber": "05421119988"
},
"ReturnedDocumentReference": {
"DocumentType": "EARSIV_FATURA",
"DocumentNumber": "GIB2026000000999",
"IssueDate": "2026-05-01"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 1500.00,
"TaxExclusiveAmount": 1500.00,
"TaxInclusiveAmount": 1800.00,
"PayableAmount": 1800.00
},
"TaxTotal": [
{
"TaxAmount": 300.00,
"TaxSubtotal": [
{
"TaxableAmount": 1500.00, "TaxAmount": 300.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 1500.00,
"Item": { "Name": "Halı" },
"Price": 1500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 300.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 300.00
}]
}
]
}💡 Fark: SchemeId =
PASAPORTNO + CargoCompanyCode dolu. Kargo kuralı uyruğa bakmaz.Örnek 9: IADE — Vekalet, Kargo Yok
Request gövdesi, IADE — Vekalet, Kargo Yok akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I8
Yüz yüze vekalet ile iade. DelegateReceiver dolu, CargoCompanyCode yok.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-039",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T15:00:00",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"DelegateReceiver": {
"Identification": "55566677788",
"IdentificationType": "TCKN",
"Name": "Ayşe Çelik"
},
"VerificationInfo": {
"Code": "ABC123",
"PhoneNumber": "05441234567"
},
"ReturnedDocumentReference": {
"DocumentType": "EARSIV_FATURA",
"DocumentNumber": "GIB2026000000456",
"IssueDate": "2026-03-15"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 500.00,
"TaxExclusiveAmount": 500.00,
"TaxInclusiveAmount": 600.00,
"PayableAmount": 600.00
},
"TaxTotal": [
{
"TaxAmount": 100.00,
"TaxSubtotal": [
{
"TaxableAmount": 500.00, "TaxAmount": 100.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 500.00,
"Item": { "Name": "Spor ayakkabı" },
"Price": 500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 100.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 100.00
}]
}
]
}💡 Fark:
DelegateReceiver dolu, CargoCompanyCode yok. VerificationInfo vekilin telefonuna yönlendirilir.Örnek 10: IADE — Vekalet, Yabancı Vekil
Request gövdesi, IADE — Vekalet, Yabancı Vekil akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I9
Orijinal alıcı TC vatandaşı, vekil yabancı uyruklu. Yüz yüze.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-048",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-26T14:00:00",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"DelegateReceiver": {
"Identification": "GH1234567",
"IdentificationType": "PASAPORTNO",
"Name": "Maria Garcia"
},
"VerificationInfo": {
"Code": "VKL999",
"PhoneNumber": "05559876543"
},
"ReturnedDocumentReference": {
"DocumentType": "EARSIV_FATURA",
"DocumentNumber": "GIB2026000000456",
"IssueDate": "2026-03-15"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 500.00,
"TaxExclusiveAmount": 500.00,
"TaxInclusiveAmount": 600.00,
"PayableAmount": 600.00
},
"TaxTotal": [
{
"TaxAmount": 100.00,
"TaxSubtotal": [
{
"TaxableAmount": 500.00, "TaxAmount": 100.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 500.00,
"Item": { "Name": "Spor ayakkabı" },
"Price": 500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 100.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 100.00
}]
}
]
}💡 Fark:
DelegateReceiver.IdentificationType = "PASAPORTNO". Vekil yabancı, ICAO max 9 karakter. AccountingCustomerParty değişmiyor (orijinal alıcı).Örnek 11: IADE — Kargo + Vekalet + e-Arşiv Fatura
Request gövdesi, IADE — Kargo + Vekalet + e-Arşiv Fatura akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I10
En karmaşık kombinasyon: kargo + vekil + e-arşiv fatura.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-042",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T15:00:00",
"CargoCompanyCode": "YURTICI",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"DelegateReceiver": {
"Identification": "55566677788",
"IdentificationType": "TCKN",
"Name": "Ayşe Çelik"
},
"VerificationInfo": {
"Code": "ABC123",
"PhoneNumber": "05441234567"
},
"ReturnedDocumentReference": {
"DocumentType": "EARSIV_FATURA",
"DocumentNumber": "GIB2026000000456",
"IssueDate": "2026-03-15"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 500.00,
"TaxExclusiveAmount": 500.00,
"TaxInclusiveAmount": 600.00,
"PayableAmount": 600.00
},
"TaxTotal": [
{
"TaxAmount": 100.00,
"TaxSubtotal": [
{
"TaxableAmount": 500.00, "TaxAmount": 100.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 500.00,
"Item": { "Name": "Spor ayakkabı" },
"Price": 500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 100.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 100.00
}]
}
]
}⚠️ Kargo + vekalet birlikte:
VerificationMethod=IADEKODU zorunludur. DelegateReceiver doğrulama yöntemi taşımaz; yalnız vekilin kimlik ve ad belge oluşturma anında kaydedilen bilgisini taşır.Örnek 12: IADE — Kargo + Vekalet + Belgesiz
Request gövdesi, IADE — Kargo + Vekalet + Belgesiz akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I10 varyant
Kargo + vekil + belgesiz iade. DocumentNumber boş bırakılır; alıcı için vatandaşlığa uygun gerçek TCKN veya PASAPORTNO gönderilmelidir.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-043",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T15:00:00",
"CargoCompanyCode": "YURTICI",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"DelegateReceiver": {
"Identification": "55566677788",
"IdentificationType": "TCKN",
"Name": "Ayşe Çelik"
},
"VerificationInfo": {
"Code": "ABC123",
"PhoneNumber": "05441234567"
},
"ReturnedDocumentReference": {
"DocumentType": "BELGESIZ",
"IssueDate": "2026-03-15"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 500.00,
"TaxExclusiveAmount": 500.00,
"TaxInclusiveAmount": 600.00,
"PayableAmount": 600.00
},
"TaxTotal": [
{
"TaxAmount": 100.00,
"TaxSubtotal": [
{
"TaxableAmount": 500.00, "TaxAmount": 100.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 500.00,
"Item": { "Name": "Spor ayakkabı" },
"Price": 500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 100.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 100.00
}]
}
]
}Örnek 13: IADE — Kargo + Vekalet + Satış Fişi
Request gövdesi, IADE — Kargo + Vekalet + Satış Fişi akışını ayırt eden alanları öne çıkarır.
JSON örneğini görüntüle I10 varyant
Kargo + vekil + satış fişi referansı ile iade.
{
"ExpenseVoucherExternalId": "ERP-2026-IADE-033",
"ProfileId": "GIDERPUSULASI",
"ExpenseVoucherTypeCode": "IADE",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-05-25T15:00:00",
"CargoCompanyCode": "YURTICI",
"VerificationMethod": "IADEKODU",
"VerificationProvider": {
"ApplicationName": "İade360",
"Vkn": "9876543210"
},
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{ "SchemeId": "TCKN", "Value": "99988877766" }
],
"PartyName": "Hasan Çelik",
"PostalAddress": {
"CityName": "İstanbul",
"Country": { "Name": "Türkiye" }
}
}
},
"DelegateReceiver": {
"Identification": "55566677788",
"IdentificationType": "TCKN",
"Name": "Ayşe Çelik"
},
"VerificationInfo": {
"Code": "ABC123",
"PhoneNumber": "05441234567"
},
"ReturnedDocumentReference": {
"DocumentType": "SATIS_FISI",
"DocumentNumber": "EOA123456",
"IssueDate": "2026-03-15"
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 500.00,
"TaxExclusiveAmount": 500.00,
"TaxInclusiveAmount": 600.00,
"PayableAmount": 600.00
},
"TaxTotal": [
{
"TaxAmount": 100.00,
"TaxSubtotal": [
{
"TaxableAmount": 500.00, "TaxAmount": 100.00,
"CalculationSequenceNumeric": 1, "TransactionCurrencyTaxAmount": 0,
"Percent": 20.0, "PerUnitAmount": 0,
"TaxCategory": { "TaxScheme": { "Name": "KDV GERCEK", "TaxTypeCode": "0015" } }
}
]
}
],
"ExpenseVoucherLine": [
{
"Id": "1",
"CreditedQuantity": { "UnitCode": "C62", "Value": 1 },
"LineExtensionAmount": 500.00,
"Item": { "Name": "Spor ayakkabı" },
"Price": 500.00,
"TaxTotal": [{
"TaxSubtotal": [
{
"TaxCategory": { "TaxScheme": { "Name": "GV STOPAJI", "TaxTypeCode": "0003" } },
"TaxAmount": 100.00, "TaxableAmount": 1,
"CalculationSequenceNumeric": 1, "Percent": 1
}
],
"TaxAmount": 100.00
}]
}
]
}