Token Developer Portal
Token AI Support
X Platform - Entegrasyon
X Platform - Entegrasyon
  • Token X Entegrasyon
  • Welcome
  • İş Akışları & Hazır Sepetler
  • Token X Connect (Wire)
    • Hızlı Başlangıç
    • Genel Tanıtım
    • Geliştirici Dokümanı
    • Örnek Uygulamalar
    • Sık Sorulan Sorular
    • Cihaz Bilgilendirme
    • Protokol Bilgileri
    • Sorun Tespit Aracı
  • Token X Connect (Cloud)
    • Genel Tanıtım (TR)
    • Geliştirici Dokümanı (TR)
    • TokenX API Integration (EN)
    • Automation Software Simulator
    • Sık Sorulan Sorular
  • Changelog
    • TokenX Connect
    • Backend
  • DESTEK
    • Geliştirici Destek
  • Test
    • Test Sürecimiz
  • APPSTORE
    • Tanıtım
Powered by GitBook
On this page
  • Fiş Oluşturulması
  • Fatura Oluşturulması
  • YN ÖKC Dışında Bir Sistemden Düzenlenen Faturanın Ödemesinin Alınması
  • YN ÖKC Üzerinde E-Belge Oluşturulması
  • Avans Bilgi Fişi- Fiş/Fatura Oluşturulmadan Önce Ödemenin Alınması
  • Cari Tahsilat Bilgi Fişi - Fiş/Fatura Oluşturulduktan Sonra Ödemenin Alınması
  • Eczane Akışları
  • Katkı payı(Matrahsız Tutar) nasıl tahsil ederim?
  • Katkı Payı ve Ürün Satış nasıl gönderebilirim?

İş Akışları & Hazır Sepetler

Bu bölüm ile amaçlanan, perakende sektöründe kullanılan temel satış iş akışları ve bu akışları Token X Connect kullanarak nasıl gerçekleneceği hakkında bilgi vermektir.

PreviousWelcomeNextHızlı Başlangıç

Last updated 12 days ago

Bu bölümde aktarılan iş akışları ve hazır sepetler hem kablolu hem de kablosuz entegrasyon için geçerlidir.

Bu kısımda bahsedilecek olan bilgi fişleri ile ilgili detaylara Gelir İdaresi Başkanlığı tarafından yayınlanan 'ndan erişebilirsiniz.

Fiş Oluşturulması

İlgili yıl için belirtilen Fatura Düzenleme Sınırı(2025 için 9900 TL) altındaki işlemler için YN ÖKC üzerinden fiş düzenlenerek mali ve ödeme akışları tamamlanabilir.

Temel bir fiş oluşturmak için sepette ürünleri iletmeniz yeterli olacaktır.

{
  "basketID": "15ced0b1-99f5-4e42-b0ca-bc781c778d69",
  "items": [
    {
      "name": "GIDA",
      "price": 500,
      "sectionNo": 1,
      "taxPercent": 1000,
      "quantity": 1000
    },
  ]
}

Fatura Oluşturulması

Satış miktarının ilgili yıl için belirtilen Fatura Düzenleme Sınırı'nın üstinde olması ya da gerekli başka durumlarda mali belge olarak fatura oluşturulmalıdır.

YN ÖKC Dışında Bir Sistemden Düzenlenen Faturanın Ödemesinin Alınması

YN ÖKC haricinde bir sistem üzerinden oluşturulan faturaların ödemesinin YN ÖKC üzerinden alınması için YN ÖKC üzerinde bilgi fişi oluşturulmalıdır. Bu durumda vergisel hususlar faturanın aslı ile çözülür, YN ÖKC üzerinden oluşturulan bilgi fişi vergi matrahına dahil olmaz.

E-Arşiv Bilgi Fişi

E-Arşiv fatura satış yapan işyerinin e-fatura mükellefi olması ancak alıcının e-fatura mükellefi olmadığı durumlarda oluşturulur. YN ÖKC harici bir sistemden E-Arşiv Fatura düzenlendiği durumda ödeme YN ÖKC üzerinden E-Arşiv Bilgi Fişi oluşturularak alınmalıdır.

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

  • "infoReceiptInfo" 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": "TKN2024000000002"
  },
  "items": [
    {
      "name": "İLAÇ",
      "price": 5500,
      "quantity": 1000,
      "sectionNo": 1,
      "taxPercent": 1000
    }
  ],
  "paymentItems": [
    {
      "amount": 5500,
      "type": 2
    }
  ]
}

E-Fatura Bilgi Fişi

E-Fatura satış yapan işyerinin ve alıcının e-fatura mükellefi olması durumlarında oluşturulur. Harici bir sistemden E-Fatura düzenlendiği durumda ödeme YN ÖKC üzerinden E-Fatura Bilgi Fişi oluşturularak alınmalıdır.

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

  • "infoReceiptInfo" 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": "TKN2024000000001"
  },
    "items": [
    {
      "name": "YİYECEK",
      "price": 58300,
      "quantity": 1000,
      "sectionNo": 1,
      "taxPercent": 1000
    }
  ],
    "paymentItems": [
    {
      "amount": 58300,
      "type": 11
    }
  ]
}

Fatura Bilgi Fişi

Matbu faturalar satış yapan işyerinin e-fatura mükellefi olmaması durumunda oluşturulur. Matbu fatura düzenlendiği durumda ödeme YN ÖKC üzerinden Fatura Bilgi Fişi oluşturularak alınmalıdır.

Fatura Bilgi Fişi oluşturmak için sepette

  • "documentType": 9005 olarak

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

  • "infoReceiptInfo" objesi içinde "serialNo" olarak faturanın seri/sıra 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
    }
  ]
}

YN ÖKC Üzerinde E-Belge Oluşturulması

Geliştirme ve test süreçleri devam etmekte. Sonrasında doküman güncellenecek.

Avans Bilgi Fişi- Fiş/Fatura Oluşturulmadan Önce Ödemenin Alınması

Fiş/faturanın mal tesliminde oluşturulması esastır. Ancak depozito, kaparo ve çeyiz satın alma gibi bazı durumlarda ödemenin bir kısmının mal teslimi(fiş/fatura oluşturulması)nden önce yapılması gerekebilir . Mali regülasyonlar gereği mal teslimi/fatura oluşturmadan önce alınan ödemeler Avans Bilgi Fişi oluşturularak alınmalıdır.

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
}

Cari Tahsilat Bilgi Fişi - Fiş/Fatura Oluşturulduktan Sonra Ödemenin Alınması

Fiş/faturanın mal tesliminde oluşturulması esastır. Beyaz eşya taksiti ödeme gibi ödemenin bir kısmının mal teslimi(fiş/fatura oluşturulması)nden sonra yapıldığı durumlarda ödeme Cari Tahsilat Bilgi Fişi oluşturularak alınmalıdır. Bu durumda, sonradan ödenecek tutar fiş/fatura bilgi fişi üzerinde Açık Hesap ödeme türü ile gösterilmelidir. Açık hesap ödeme türüne sahip bir fiş oluşturmak için aşağıdak sepet gönderilebilir.

{
  "basketID": "93ced0be-99f5-4e42-b0ca-bc781c778d69",
  "createInvoice": false,
  "documentType": 0,
  "isVoid": false,
  "items": [
    {
      "name": "Su",
      "pluNo": 0,
      "price": 500,
      "sectionNo": 1,
      "quantity": 1000
    }
  ],
  "paymentItems": [
    {
      "amount": 500,
      "type": 17
    }
  ]
}

Cari Tahsilat Bilgi Fişi oluşturmak için sepette

  • "documentType": 9002

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

  • Açık hesap içeren satışın hangi tarihte yapıldığını ve o tarihteki satışın belge numarasını(Fiş No-Z No/Fatura Seri-Sıra No) "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": "01-02-2025",
    "documentNo": "GIB2025000000001"
  },
  "taxFreeAmount": 10000,
    "paymentItems": [
    {
      "amount": 10000,
      "type": 1
    }
  ]
}

Eczane Akışları

Eczanelerde tahsil edilen muayene katkı payları eczanelere özel olarak düzenlenen fiş formatında matrah dışı tutar olarak tahsil edilir. Bu özel fiş formatında alınan ödemeler Z raporunda ayrı olarak gösterilir ve KDV matrahına dahil edilmez.

Katkı payı(Matrahsız Tutar) nasıl tahsil ederim?

Katkı payı tahsil etmek 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
    }
  ]
}

Katkı Payı ve Ürün Satış nasıl gönderebilirim?

Hem katkı payı hem de ürünler için tek fiş oluşturulabilir.

Hem katkı payı hem de ürün satışı için sepette

  • "documentType": 9008 olarak

  • Katkı payı tutarını "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
    }
  ],
  "taxFreeAmount": 5000,
  "paymentItems": [
    {
      "amount": 6000,
      "description": "Cash",
      "type": 1
    }
  ]
}

Bilgi Fişleri Kılavuzu