e-Müstahsil Makbuzu

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

ÖrnekSenaryoAyırt Edici Nokta
1Normal Oluşturma — SMSGeçişten önce SMS kullanan entegratör: tek ürün ve tam SMS doğrulama verisi
2Tevkifatlı İşlemWithholdingTaxTotal ve net PayableAmount
3Çok Kalemli MakbuzAynı çiftçiden birden fazla ürün satırı
4GV StopajıTaxTotal.TaxSubtotal altında 0003
5Borsa TescilTaxTotal.TaxSubtotal altında 8001
6SGK PrimTaxTotal.TaxSubtotal altında SGK_PRIM
7Mera FonuTaxTotal.TaxSubtotal altında 9040
8Çoklu KesintiBirden fazla kesinti kodunun aynı belgede birlikte kullanılması
9İptalBelge içeriği yerine iptal modeli ve Signed ön koşulu

Her örnek ilgili senaryoya referans verir.

#SenaryoKalem SayısıKesinti/Tevkifat
1Normal Oluşturma — SMS1VerificationMethod=SMS
2Tevkifatlı İşlem1WithholdingTaxTotal
3Çok Kalemli Makbuz2WithholdingTaxTotal
4GV Stopajı10003
5Borsa Tescil18001
6SGK Prim1SGK_PRIM
7Mera Fonu19040
8Çoklu Kesinti1TaxTotal.TaxSubtotal[]
9İptal——

Taraf Kimliği

e-Müstahsil Makbuzunda AccountingSupplierParty makbuzu düzenleyen/alıcı firmayı, AccountingCustomerParty üretici/çiftçiyi taşır.

TarafKimlikAd kaynağı
AccountingSupplierPartyVKN veya TCKNPartyName veya Person
AccountingCustomerParty11 haneli TCKNÜretici/çiftçi ad soyadı
30 Haziran 2027 kuralı: SMS doğrulamalı belgede üretici/çiftçi AccountingCustomerParty altında TCKN ile gönderilmelidir. SMS kodu ve telefon bilgisi de aynı tarafın Contact alanına eşlenir.
Örnek sözleşmeleri: Örnek 1, 30 Haziran 2027 öncesinde erken kullanımda da gönderilebilen tam SMS doğrulama paketini gösterir. Planlanan sürümde tam SMS paketi UBL ve rapora yazılır. SMS kullanılmadığında raporda kod, telefon ve operatör bölümü oluşturulmaz. Örnek 2–8 SMS alanı bulunmayan gövdelerle kesinti çeşitlerini anlatır. Bu örneklerden biri SMS doğrulamasıyla veya 30 Haziran 2027 ve sonrası kullanılacaksa Örnek 1'deki 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.

Ekonomik içerik farkı: Normal belgeye 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.

💡 Fark: Örnek 2'den tek değişiklik 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.

AlanZorunlulukDeğer/Kural
TaxTotal[].TaxAmountZGV stopajı toplam tutarı
TaxSubtotal[].TaxableAmountZStopaja tabi matrah
TaxSubtotal[].TaxAmountZStopaj tutarı
TaxSubtotal[].PercentZStopaj oranı
TaxScheme.NameZGV STOPAJI
TaxScheme.TaxTypeCodeZ0003
LegalMonetaryTotal.PayableAmountZNet ö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.

AlanZorunlulukDeğer/Kural
TaxTotal[].TaxAmountZBorsa tescil toplam tutarı
TaxSubtotal[].TaxableAmountZKesintiye tabi matrah
TaxSubtotal[].TaxAmountZKesinti tutarı
TaxSubtotal[].PercentZKesinti oranı
TaxScheme.NameZBORSA TES.ÜC.
TaxScheme.TaxTypeCodeZ8001
LegalMonetaryTotal.PayableAmountZNet ö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.

AlanZorunlulukDeğer/Kural
TaxTotal[].TaxAmountZSGK prim toplam tutarı
TaxSubtotal[].TaxableAmountZKesintiye tabi matrah
TaxSubtotal[].TaxAmountZKesinti tutarı
TaxSubtotal[].PercentZKesinti oranı
TaxScheme.NameZSGK PRIM KESINTISI
TaxScheme.TaxTypeCodeZSGK_PRIM
LegalMonetaryTotal.PayableAmountZNet ö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.

AlanZorunlulukDeğer/Kural
TaxTotal[].TaxAmountZMera fonu toplam tutarı
TaxSubtotal[].TaxableAmountZKesintiye tabi matrah
TaxSubtotal[].TaxAmountZKesinti tutarı
TaxSubtotal[].PercentZKesinti oranı
TaxScheme.NameZMERA FONU
TaxScheme.TaxTypeCodeZ9040
LegalMonetaryTotal.PayableAmountZNet ö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.

AlanZorunlulukDeğer/Kural
TaxTotal[].TaxAmountZTüm kesinti satırlarının toplamı
TaxSubtotal[]ZHer kesinti için ayrı satır
TaxScheme.NameZKodla uyumlu ad
TaxScheme.TaxTypeCodeZ0003, 8001, SGK_PRIM, 9040
CreditNoteLine[].TaxTotalŞSatır seviyesinde izlenecekse aynı kod dağılımı
LegalMonetaryTotal.PayableAmountZNet ö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.

Fark: Bu örnek farklı bir endpoint (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"
}