Örnekler
Request Örnekleri
Normal, kesintili, çok kalemli ve iptal senaryoları için kullanılabilir tam endpoint ve body sözleşmesiyle sunulan JSON request örnekleri.
Senaryo Kapsamı
Bu sayfa, her örnekte aynı okuma düzenini izler: önce senaryonun iş anlamı, sonra fark noktası, ardından doğrudan kullanılabilir JSON gövdesi verilir. Örnek seti MUSTAHSILMAKBUZ belge tipi, çiftçi/alıcı tarafları, ürün kalemleri, vergi/kesinti kodları, tevkifat ve iptal akışı etrafında toplanır.
| Örnek | Senaryo | Ayırt Edici Nokta |
|---|---|---|
| 1 | Normal Oluşturma — SMS | Geçişten önce SMS kullanan entegratör: tek ürün ve tam SMS doğrulama verisi |
| 2 | Tevkifatlı İşlem | WithholdingTaxTotal ve net PayableAmount |
| 3 | Çok Kalemli Makbuz | Aynı çiftçiden birden fazla ürün satırı |
| 4 | GV Stopajı | TaxTotal.TaxSubtotal altında 0003 |
| 5 | Borsa Tescil | TaxTotal.TaxSubtotal altında 8001 |
| 6 | SGK Prim | TaxTotal.TaxSubtotal altında SGK_PRIM |
| 7 | Mera Fonu | TaxTotal.TaxSubtotal altında 9040 |
| 8 | Çoklu Kesinti | Birden fazla kesinti kodunun aynı belgede birlikte kullanılması |
| 9 | İptal | Belge içeriği yerine iptal modeli ve Signed ön koşulu |
Her örnek ilgili senaryoya referans verir.
| # | Senaryo | Kalem Sayısı | Kesinti/Tevkifat |
|---|---|---|---|
| 1 | Normal Oluşturma — SMS | 1 | VerificationMethod=SMS |
| 2 | Tevkifatlı İşlem | 1 | WithholdingTaxTotal |
| 3 | Çok Kalemli Makbuz | 2 | WithholdingTaxTotal |
| 4 | GV Stopajı | 1 | 0003 |
| 5 | Borsa Tescil | 1 | 8001 |
| 6 | SGK Prim | 1 | SGK_PRIM |
| 7 | Mera Fonu | 1 | 9040 |
| 8 | Çoklu Kesinti | 1 | TaxTotal.TaxSubtotal[] |
| 9 | İptal | — | — |
Taraf Kimliği
e-Müstahsil Makbuzunda AccountingSupplierParty makbuzu düzenleyen/alıcı firmayı, AccountingCustomerParty üretici/çiftçiyi taşır.
| Taraf | Kimlik | Ad kaynağı |
|---|---|---|
AccountingSupplierParty | VKN veya TCKN | PartyName veya Person |
AccountingCustomerParty | 11 haneli TCKN | Üretici/çiftçi ad soyadı |
AccountingCustomerParty altında TCKN ile gönderilmelidir. SMS kodu ve telefon bilgisi de aynı tarafın Contact alanına eşlenir.Person, VerificationMethod, VerificationInfo ve VerificationProvider alanları aynı kurallarla eksiksiz eklenmelidir.Örnek 1: Normal Oluşturma — SMS ile
Request gövdesi, 30 Haziran 2027 ve sonrası tarihli doğrudan entegrasyon akışında normal belge alanlarıyla SMS doğrulama alanlarını birlikte gösterir.
KDV mükellefi olmayan bir çiftçiden, ek kesinti olmayan bir tarımsal ürün alımı için e-Müstahsil Makbuzu oluşturulur. SMS entegratörün kendi sağlayıcısı üzerinden gönderilmiş ve kod entegratörün uygulamasında doğrulanmıştır.
Endpoint: POST /api/CreditNoteApi/AddOutgoingCreditNote
Body: OutgoingCreditNoteRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-001",
"ProfileId": "EARSIVBELGE",
"CreditNoteTypeCode": "MUSTAHSILMAKBUZ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-11-04T09:00:00",
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "TCKN",
"Value": "12345678901"
}
],
"Person": {
"FirstName": "Ahmet",
"FamilyName": "Çiftçi"
},
"PostalAddress": {
"CityName": "Denizli",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Tarım Ürünleri A.Ş."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 5000,
"TaxExclusiveAmount": 5000,
"TaxInclusiveAmount": 5000,
"PayableAmount": 5000
},
"TaxTotal": [
{
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
],
"CreditNoteLine": [
{
"Id": "1",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 1000
},
"LineExtensionAmount": 5000,
"Item": {
"Name": "Yaş Sebze"
},
"Price": 5,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
}
],
"VerificationMethod": "SMS",
"VerificationInfo": {
"Code": "482193",
"PhoneNumber": "05551112233"
},
"VerificationProvider": {
"ApplicationName": "SMS_SAGLAYICI_ADI",
"Vkn": "1234567890"
}
}Örnek 2: Tevkifatlı İşlem
Request gövdesi, Tevkifatlı İşlem akışını ayırt eden alanları öne çıkarır.
GV STOPAJI tevkifatı uygulanan bir alım; WithholdingTaxTotal hem belge seviyesinde doldurulur, PayableAmount kesinti düşülmüş net tutarı yansıtır.
WithholdingTaxTotal eklenmiş; PayableAmount, tevkifat tutarı düşülerek hesaplanmıştır (5000 − 250 = 4750). İşlem ve belge tarihi 30 Haziran 2027 veya sonrasındaysa SMS alanları da Örnek 1'deki gibi eklenmelidir.Endpoint: POST /api/CreditNoteApi/AddOutgoingCreditNote
Body: OutgoingCreditNoteRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-002",
"ProfileId": "EARSIVBELGE",
"CreditNoteTypeCode": "MUSTAHSILMAKBUZ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "TCKN",
"Value": "12345678901"
}
],
"PartyName": "Ahmet Çiftçi",
"PostalAddress": {
"CityName": "Denizli",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Tarım Ürünleri A.Ş."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 5000,
"TaxExclusiveAmount": 5000,
"TaxInclusiveAmount": 5000,
"PayableAmount": 4750
},
"TaxTotal": [
{
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
],
"WithholdingTaxTotal": [
{
"TaxAmount": 250,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 250,
"Percent": 5,
"TaxCategory": {
"TaxScheme": {
"Name": "GV STOPAJI",
"TaxTypeCode": "0003"
}
}
}
]
}
],
"CreditNoteLine": [
{
"Id": "1",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 1000
},
"LineExtensionAmount": 5000,
"Item": {
"Name": "Yaş Sebze"
},
"Price": 5,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
},
"WithholdingTaxTotal": [
{
"TaxAmount": 250,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 250,
"Percent": 5,
"TaxCategory": {
"TaxScheme": {
"Name": "GV STOPAJI",
"TaxTypeCode": "0003"
}
}
}
]
}
]
}
]
}Örnek 3: Çok Kalemli Makbuz
Request gövdesi, Çok Kalemli Makbuz akışını ayırt eden alanları öne çıkarır.
Aynı çiftçiden birden fazla ürün kalemi tek makbuzda toplanır; CreditNoteLine dizisine her kalem ayrı eklenir.
CreditNoteLine dizisine ikinci bir kalem eklenmesi ve toplam tutarların buna göre büyümesidir; belge yapısı aynıdır.Endpoint: POST /api/CreditNoteApi/AddOutgoingCreditNote
Body: OutgoingCreditNoteRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-003",
"ProfileId": "EARSIVBELGE",
"CreditNoteTypeCode": "MUSTAHSILMAKBUZ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-11T10:30:00",
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "TCKN",
"Value": "98765432109"
}
],
"PartyName": "Fatma Üretici",
"PostalAddress": {
"CityName": "Antalya",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Tarım Ürünleri A.Ş."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 8000,
"TaxExclusiveAmount": 8000,
"TaxInclusiveAmount": 8000,
"PayableAmount": 7600
},
"TaxTotal": [
{
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 8000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
],
"WithholdingTaxTotal": [
{
"TaxAmount": 400,
"TaxSubtotal": [
{
"TaxableAmount": 8000,
"TaxAmount": 400,
"Percent": 5,
"TaxCategory": {
"TaxScheme": {
"Name": "GV STOPAJI",
"TaxTypeCode": "0003"
}
}
}
]
}
],
"CreditNoteLine": [
{
"Id": "1",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 500
},
"LineExtensionAmount": 5000,
"Item": {
"Name": "Domates"
},
"Price": 10,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
},
"WithholdingTaxTotal": [
{
"TaxAmount": 250,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 250,
"Percent": 5,
"TaxCategory": {
"TaxScheme": {
"Name": "GV STOPAJI",
"TaxTypeCode": "0003"
}
}
}
]
}
]
},
{
"Id": "2",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 600
},
"LineExtensionAmount": 3000,
"Item": {
"Name": "Biber"
},
"Price": 5,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 3000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
},
"WithholdingTaxTotal": [
{
"TaxAmount": 150,
"TaxSubtotal": [
{
"TaxableAmount": 3000,
"TaxAmount": 150,
"Percent": 5,
"TaxCategory": {
"TaxScheme": {
"Name": "GV STOPAJI",
"TaxTypeCode": "0003"
}
}
}
]
}
]
}
]
}Örnek 4: GV Stopajı
GV stopajı, kod bazında izlenecekse TaxTotal.TaxSubtotal altında 0003 koduyla gönderilir.
Bu senaryoda belge root alanları, taraflar ve ürün kalemi normal oluşturma ile aynıdır; fark vergi/kesinti alt toplamında GV STOPAJI satırının bulunmasıdır.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
TaxTotal[].TaxAmount | Z | GV stopajı toplam tutarı |
TaxSubtotal[].TaxableAmount | Z | Stopaja tabi matrah |
TaxSubtotal[].TaxAmount | Z | Stopaj tutarı |
TaxSubtotal[].Percent | Z | Stopaj oranı |
TaxScheme.Name | Z | GV STOPAJI |
TaxScheme.TaxTypeCode | Z | 0003 |
LegalMonetaryTotal.PayableAmount | Z | Net ödenecek tutar |
Endpoint: POST /api/CreditNoteApi/AddOutgoingCreditNote
Body: OutgoingCreditNoteRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-001",
"ProfileId": "EARSIVBELGE",
"CreditNoteTypeCode": "MUSTAHSILMAKBUZ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "TCKN",
"Value": "12345678901"
}
],
"PartyName": "Ahmet Çiftçi",
"PostalAddress": {
"CityName": "Denizli",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Tarım Ürünleri A.Ş."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 5000,
"TaxExclusiveAmount": 5000,
"TaxInclusiveAmount": 5000,
"PayableAmount": 4750
},
"TaxTotal": [
{
"TaxAmount": 250,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 250,
"Percent": 5,
"TaxCategory": {
"TaxScheme": {
"Name": "GV STOPAJI",
"TaxTypeCode": "0003"
}
}
}
]
}
],
"CreditNoteLine": [
{
"Id": "1",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 1000
},
"LineExtensionAmount": 5000,
"Item": {
"Name": "Yaş Sebze"
},
"Price": 5,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Örnek 5: Borsa Tescil
Borsa tescil kesintisi, TaxTotal.TaxSubtotal altında 8001 koduyla ayrı bir alt toplam olarak taşınır.
Bu örnekte yalnızca borsa tescil kesintisi gösterilir; başka kesinti varsa ayrı TaxSubtotal satırı eklenir.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
TaxTotal[].TaxAmount | Z | Borsa tescil toplam tutarı |
TaxSubtotal[].TaxableAmount | Z | Kesintiye tabi matrah |
TaxSubtotal[].TaxAmount | Z | Kesinti tutarı |
TaxSubtotal[].Percent | Z | Kesinti oranı |
TaxScheme.Name | Z | BORSA TES.ÜC. |
TaxScheme.TaxTypeCode | Z | 8001 |
LegalMonetaryTotal.PayableAmount | Z | Net ödenecek tutar |
Endpoint: POST /api/CreditNoteApi/AddOutgoingCreditNote
Body: OutgoingCreditNoteRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-001",
"ProfileId": "EARSIVBELGE",
"CreditNoteTypeCode": "MUSTAHSILMAKBUZ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "TCKN",
"Value": "12345678901"
}
],
"PartyName": "Ahmet Çiftçi",
"PostalAddress": {
"CityName": "Denizli",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Tarım Ürünleri A.Ş."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 5000,
"TaxExclusiveAmount": 5000,
"TaxInclusiveAmount": 5000,
"PayableAmount": 4950
},
"TaxTotal": [
{
"TaxAmount": 50,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 50,
"Percent": 1,
"TaxCategory": {
"TaxScheme": {
"Name": "BORSA TES.ÜC.",
"TaxTypeCode": "8001"
}
}
}
]
}
],
"CreditNoteLine": [
{
"Id": "1",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 1000
},
"LineExtensionAmount": 5000,
"Item": {
"Name": "Yaş Sebze"
},
"Price": 5,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Örnek 6: SGK Prim
SGK prim kesintisi SGK_PRIM koduyla TaxTotal.TaxSubtotal altında gönderilir.
Bu senaryo yalnızca SGK prim kesintisinin teknik alanlarını izole eder.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
TaxTotal[].TaxAmount | Z | SGK prim toplam tutarı |
TaxSubtotal[].TaxableAmount | Z | Kesintiye tabi matrah |
TaxSubtotal[].TaxAmount | Z | Kesinti tutarı |
TaxSubtotal[].Percent | Z | Kesinti oranı |
TaxScheme.Name | Z | SGK PRIM KESINTISI |
TaxScheme.TaxTypeCode | Z | SGK_PRIM |
LegalMonetaryTotal.PayableAmount | Z | Net ödenecek tutar |
Endpoint: POST /api/CreditNoteApi/AddOutgoingCreditNote
Body: OutgoingCreditNoteRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-001",
"ProfileId": "EARSIVBELGE",
"CreditNoteTypeCode": "MUSTAHSILMAKBUZ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "TCKN",
"Value": "12345678901"
}
],
"PartyName": "Ahmet Çiftçi",
"PostalAddress": {
"CityName": "Denizli",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Tarım Ürünleri A.Ş."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 5000,
"TaxExclusiveAmount": 5000,
"TaxInclusiveAmount": 5000,
"PayableAmount": 4970
},
"TaxTotal": [
{
"TaxAmount": 30,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 30,
"Percent": 0.6,
"TaxCategory": {
"TaxScheme": {
"Name": "SGK PRIM KESINTISI",
"TaxTypeCode": "SGK_PRIM"
}
}
}
]
}
],
"CreditNoteLine": [
{
"Id": "1",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 1000
},
"LineExtensionAmount": 5000,
"Item": {
"Name": "Yaş Sebze"
},
"Price": 5,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Örnek 7: Mera Fonu
Mera fonu kesintisi, TaxTotal.TaxSubtotal altında 9040 koduyla taşınır.
Bu örnek, mera fonu için gerekli alt toplam alanlarını diğer kesintilerden bağımsız gösterir.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
TaxTotal[].TaxAmount | Z | Mera fonu toplam tutarı |
TaxSubtotal[].TaxableAmount | Z | Kesintiye tabi matrah |
TaxSubtotal[].TaxAmount | Z | Kesinti tutarı |
TaxSubtotal[].Percent | Z | Kesinti oranı |
TaxScheme.Name | Z | MERA FONU |
TaxScheme.TaxTypeCode | Z | 9040 |
LegalMonetaryTotal.PayableAmount | Z | Net ödenecek tutar |
Endpoint: POST /api/CreditNoteApi/AddOutgoingCreditNote
Body: OutgoingCreditNoteRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-001",
"ProfileId": "EARSIVBELGE",
"CreditNoteTypeCode": "MUSTAHSILMAKBUZ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "TCKN",
"Value": "12345678901"
}
],
"PartyName": "Ahmet Çiftçi",
"PostalAddress": {
"CityName": "Denizli",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Tarım Ürünleri A.Ş."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 5000,
"TaxExclusiveAmount": 5000,
"TaxInclusiveAmount": 5000,
"PayableAmount": 4975
},
"TaxTotal": [
{
"TaxAmount": 25,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 25,
"Percent": 0.5,
"TaxCategory": {
"TaxScheme": {
"Name": "MERA FONU",
"TaxTypeCode": "9040"
}
}
}
]
}
],
"CreditNoteLine": [
{
"Id": "1",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 1000
},
"LineExtensionAmount": 5000,
"Item": {
"Name": "Yaş Sebze"
},
"Price": 5,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Örnek 8: Çoklu Kesinti
Birden fazla kesinti aynı makbuzda uygulanıyorsa her kesinti ayrı TaxSubtotal satırı olarak gönderilir.
Çoklu kesintide TaxTotal[].TaxAmount, alt satırlardaki TaxAmount toplamıyla uyumlu olmalıdır; PayableAmount tek net sonucu gösterir.
| Alan | Zorunluluk | Değer/Kural |
|---|---|---|
TaxTotal[].TaxAmount | Z | Tüm kesinti satırlarının toplamı |
TaxSubtotal[] | Z | Her kesinti için ayrı satır |
TaxScheme.Name | Z | Kodla uyumlu ad |
TaxScheme.TaxTypeCode | Z | 0003, 8001, SGK_PRIM, 9040 |
CreditNoteLine[].TaxTotal | Ş | Satır seviyesinde izlenecekse aynı kod dağılımı |
LegalMonetaryTotal.PayableAmount | Z | Net ödenecek tutar |
Endpoint: POST /api/CreditNoteApi/AddOutgoingCreditNote
Body: OutgoingCreditNoteRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-001",
"ProfileId": "EARSIVBELGE",
"CreditNoteTypeCode": "MUSTAHSILMAKBUZ",
"DocumentCurrencyCode": "TRY",
"IssueDate": "2026-06-10T09:00:00",
"AccountingCustomerParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "TCKN",
"Value": "12345678901"
}
],
"PartyName": "Ahmet Çiftçi",
"PostalAddress": {
"CityName": "Denizli",
"Country": {
"Name": "Türkiye"
}
}
}
},
"AccountingSupplierParty": {
"Party": {
"PartyIdentifications": [
{
"SchemeId": "VKN",
"Value": "1234567890"
}
],
"PartyName": "Örnek Tarım Ürünleri A.Ş."
}
},
"LegalMonetaryTotal": {
"LineExtensionAmount": 5000,
"TaxExclusiveAmount": 5000,
"TaxInclusiveAmount": 5000,
"PayableAmount": 4645
},
"TaxTotal": [
{
"TaxAmount": 355,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 250,
"Percent": 5,
"TaxCategory": {
"TaxScheme": {
"Name": "GV STOPAJI",
"TaxTypeCode": "0003"
}
}
},
{
"TaxableAmount": 5000,
"TaxAmount": 50,
"Percent": 1,
"TaxCategory": {
"TaxScheme": {
"Name": "BORSA TES.ÜC.",
"TaxTypeCode": "8001"
}
}
},
{
"TaxableAmount": 5000,
"TaxAmount": 30,
"Percent": 0.6,
"TaxCategory": {
"TaxScheme": {
"Name": "SGK PRIM KESINTISI",
"TaxTypeCode": "SGK_PRIM"
}
}
},
{
"TaxableAmount": 5000,
"TaxAmount": 25,
"Percent": 0.5,
"TaxCategory": {
"TaxScheme": {
"Name": "MERA FONU",
"TaxTypeCode": "9040"
}
}
}
]
}
],
"CreditNoteLine": [
{
"Id": "1",
"CreditedQuantity": {
"UnitCode": "KGM",
"Value": 1000
},
"LineExtensionAmount": 5000,
"Item": {
"Name": "Yaş Sebze"
},
"Price": 5,
"TaxTotal": {
"TaxAmount": 0,
"TaxSubtotal": [
{
"TaxableAmount": 5000,
"TaxAmount": 0,
"Percent": 0,
"TaxCategory": {
"TaxScheme": {
"TaxTypeCode": "0015"
}
}
}
]
}
}
]
}Örnek 9: İptal
Request gövdesi, İptal akışını ayırt eden alanları öne çıkarır.
Yalnızca Signed durumundaki bir makbuz için geçerlidir.
CancelOutgoingCreditNote) ve model (CreditNoteCancelRequestModel) kullanır; CreditNoteLine/LegalMonetaryTotal gibi belge içeriği alanları burada yer almaz.Endpoint: POST /api/CreditNoteApi/CancelOutgoingCreditNote
Body: CreditNoteCancelRequestModel (JSON)
{
"CreditNoteExternalId": "ERP-MM-2026-001",
"Ettn": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"CreditNoteNumber": "MMB2026000000001",
"EArchiveStatus": 2,
"EArchiveCancelDescription": "Mükerrer kayıt"
}