Hazır Örnek Sepetler

Bu sayfadaki örnek JSON'ları kullanarak kullanım senaryolarınızı hızlıca gerçekleyin.

Matrah Dışı Satış nasıl yapabilirim?

Matrah dışı satış için sepette

• "documentType": 9008 olarak

• Matrah dışı olmasını istediğini tutarı "taxFreeAmount" hanesinde

• "customerInfo" objesi içinde "taxID" hanesinde müşterinin TCKN'sini

göndermelisiniz.

{
  "documentType": 9008,
  "taxFreeAmount": 5000,
  "customerInfo": {
    "taxID": "11111111111"
  },
  "paymentItems": [
    {
      "amount": 5000,
      "description": "Nakit",
      "type": 1
    }
  ]
}

Matrah Dışı ve Ürün Satış nasıl gönderebilirim?

Hem matrah dışı satış hem de ürün satışı için sepette

• "documentType": 9008 olarak

• Matrah dışı olmasını istediğini tutarı "taxFreeAmount" olarak

• "customerInfo" objesi içinde "taxID" hanesinde müşterinin TCKN'sini

• Ürünü "items" arrayi içinde

göndermelisiniz.

{
  "basketID": "a123ca24-ca2c-401c-8134-f0de2ec25c25",
  "documentType": 9008,
  "customerInfo": {
    "taxID": "11111111111"
  },
  "items": [
    {
      "name": "İLAÇ",
      "price": 1000,
      "quantity": 1000,
      "sectionNo": 1,
      "taxPercent": 1000,
      "type": 0
    }
  ],
  "taxFreeAmount": 5000,
  "paymentItems": [
    {
      "amount": 6000,
      "description": "Cash",
      "type": 1
    }
  ]
}

Cari Tahsilat nasıl yapabilirim?

Daha önceden veresiye/Açık hesap gönderdiğiniz satışın tahsilatını yapmak için sepette

• "documentType": 9002

• "customerInfo" objesi içinde müşterinin ismi ve TCKN'si "name" ve "taxID"

• Veresiye satışın hangi tarihte yapıldığını ve o tarihteki satışın belge numarasını "infoReceiptInfo" objesi içinde "documentDate" ve "documentNo"

• Cari tahsilatın tutarını da "taxFreeAmount"

olarak göndermelisiniz.

{
  "basketID": "35bc5937-f8ef-4c21-8e44-b59d02c25a79",
  "documentType": 9002,
  "customerInfo": {
    "name": "AD SOYAD",
    "taxID": "11111111111"
  },
  "infoReceiptInfo": {
    "documentDate": "29-10-2024",
    "documentNo": "ABC123"
  },
  "taxFreeAmount": 10000,
    "paymentItems": [
    {
      "amount": 10000,
      "type": 1
    }
  ]
}

Fatura Bilgi Fişi nasıl oluşturabilirim?

Fatura bilgi fişi oluşturmak için sepette

• "documentType": 9005 olarak

• "customerInfo" objesi içinde "taxID" hanesinde müşterinin TCKN'sini

• "infoReceiptNo" objesi içinde "serialNo" olarak bilgi fişinin seri numarasını

göndermelisiniz.

{
  "basketID": "35bc5937-f8ef-4c21-8e44-b59d02c25a79",
  "documentType": 9005,
  "customerInfo": {
    "taxID": "11111111111"
  },
  "infoReceiptInfo": {
    "serialNo": "ABC123"
  },
    "items": [
    {
      "name": "YİYECEK",
      "price": 58300,
      "quantity": 1000,
      "sectionNo": 1,
      "taxPercent": 1000
    }
  ],
    "paymentItems": [
    {
      "amount": 58300,
      "type": 11
    }
  ]
}

E-arşiv Bilgi Fişi nasıl düzenlerim?

E-arşiv bilgi fişi oluşturmak için sepette

• "documentType": 9007 olarak

• irsaliye yerine geçip geçmeyeceğini "isWayBill" olarak

• "customerInfo" objesi içinde "taxID" hanesinde müşterinin TCKN'sini

• "infoReceiptNo" objesi içinde "serialNo" olarak bilgi fişinin seri numarasını

göndermelisiniz.

Sepette kısım satışı varsa fiş irsaliye yerine geçemez.

{
  "basketID": "35bc5937-f8ef-4c21-8e44-b59d02c25a79",
  "documentType": 9007,
  "isWayBill": false,
  "customerInfo": {
    "taxID": "11111111111"
  },
  "infoReceiptInfo": {
    "serialNo": "TKN20240000000002"
  },
  "items": [
    {
      "name": "İLAÇ",
      "price": 5500,
      "quantity": 1000,
      "sectionNo": 1,
      "taxPercent": 1000
    }
  ],
  "paymentItems": [
    {
      "amount": 5500,
      "type": 2
    }
  ]
}

E-fatura Bilgi Fişi nasıl oluşturabilirim?

E-fatura bilgi fişi oluşturmak için sepette

• "documentType": 9006 olarak

• irsaliye yerine geçip geçmeyeceğini "isWayBill" olarak

• "customerInfo" objesi içinde "taxID" hanesinde müşterinin TCKN'sini

• "infoReceiptNo" objesi içinde "serialNo" olarak bilgi fişinin seri numarasını

göndermelisiniz.

Sepette kısım satışı varsa fiş irsaliye yerine geçemez.

{
  "basketID": "35bc5937-f8ef-4c21-8e44-b59d02c25a79",
  "documentType": 9006,
  "isWayBill":false,
  "customerInfo": {
    "taxID": "11111111111"
  },
  "infoReceiptInfo": {
    "serialNo": "TKN20240000000001"
  },
    "items": [
    {
      "name": "YİYECEK",
      "price": 58300,
      "quantity": 1000,
      "sectionNo": 1,
      "taxPercent": 1000
    }
  ],
    "paymentItems": [
    {
      "amount": 58300,
      "type": 11
    }
  ]
}

Avans bilgi fişi nasıl düzenlenir?

Avans bilgi fişi, satış işlemi gerçekleşmeden önce depozito veya kaparonun alındığı durumlarda (çeyiz alımı gibi) oluşturulabilir.

Avans bilgi fişi oluşturmak için sepette

• "documentType":9000 olarak

• "customerInfo" objesi içinde "taxID" hanesinde müşterinin TCKN'sini ve "name" hanesinde müşteri adı soyadını

• "taxFreeAmount" hanesinde tutarı

göndermelisiniz.

{
  "basketID": "1c386acc-2f1e-49ae-8531-4ed56f6b0030",
  "documentType": 9000,
  "isVoid": false,
  "customerInfo": {
    "name": "AD SOYAD",
    "taxID": "11111111111"
  },
  "taxFreeAmount": 10000
}

Fatura tahsilatı nasıl yaparım?

Başka kurum veya kuruluşlara ait faturaların tahsilatının gerçekleştirilmesi durumunda fatura tahsilatı bilgi fişi oluşturulabilir.

Fatura tahsilatı yapmak için sepette

• "documentType": 9001 olarak

• "infoReceiptInfo" objesi içinde "companyName" hanesinde kurum ismi, "documentDate" hanesinde belge tarihi, "documentNo" hanesinde fatura no, "subscriberNo" hanesinde abone no bilgisini

• tahsilat tutarını "taxFreeAmount" hanesinde

• kullanım şeklinize bağlı olarak komisyon türünün kısmı ve tutarını "items" arrayi içinde

göndermelisiniz.

{
  "basketID": "95f24337-46dc-4bd2-bc90-66a2b670f4de",
  "documentType": 9001,
  "isVoid": false,
  "infoReceiptInfo": {
    "companyName": "KURUM",
    "documentDate": "03-04-2025",
    "documentNo": "FATURANO",
    "subscriberNo": "ABONENO"
  },
  "items": [
    {
      "name": "Yiyecek",
      "limit": 10000,
      "price": 10000,
      "quantity": 1000,
      "sectionNo": 1,
      "taxPercent": 1000,
      "type": 0
    }
  ],
  "taxFreeAmount": 10000
}