efaturan
Koçtaş logosuPazar yeri entegrasyonu

Koçtaş e-Fatura Entegrasyonu

Koçtaş'ın satıcı işlemleri Mirakl platformunda yürür. koctas.mirakl.net panelinden aldığınız API anahtarıyla bağlantı kurulduktan sonra Koçtaş siparişleri eşitleme sırasında panele gelir; uygun belge kesilir ve fatura PDF'i siparişin belgelerine eklenir.

Erken erişim talep etNasıl bağlanır?
Belge türleri
e-Fatura ve e-Arşiv Fatura
Faturanın iletimi
Koçtaş tarafına otomatik
Siparişler
15 dakikada bir kontrol
Duvarda düzenli asılmış el aletleri
Koçtaş siparişinin panelde faturalanmasını gösteren örnek görünüm: sipariş 20481736-A, tutar ₺2.180,00, e-Fatura.

Koçtaş ile otomatik faturalama

Koçtaş fatura yükleme ve sipariş akışı

  1. 01

    Güncellenen siparişler okunur

    Koçtaş'ın Mirakl panelinde son güncellenen siparişler düzenli aralıklarla sorgulanır ve tutarlar KDV dahil istenir. Durumu değişen sipariş sonraki çekimde güncellenir.

  2. 02

    Onay öncesi sipariş bekler

    Satıcı onayı ya da ödeme bekleyen Koçtaş siparişleri faturalanmaz. Sipariş onaylanıp ödemesi alındığında faturalanabilir hâle gelir.

  3. 03

    PDF siparişin belgelerine eklenir

    Fatura numarası kesinleşince PDF, Koçtaş'taki siparişe CUSTOMER_INVOICE belge türü koduyla yüklenir. Koçtaş farklı bir kod kullanıyorsa bağlantı ayarından değiştirilir.

  4. 04

    Promosyon ve kargo ayrı görünür

    Satır tutarından düşülen promosyon faturada iskonto olarak yer alır. Alıcıdan kargo ücreti alındıysa faturaya ayrı bir Kargo Bedeli satırı eklenir.

Kurulum

Koçtaş Mirakl entegrasyonu nasıl kurulur?

  1. 1

    Satıcı paneline geçin

    koctas.com.tr'deki satıcı sayfasında bulunan "Giriş Yap" bağlantısıyla koctas.mirakl.net adresindeki Mirakl satıcı paneline girin.

  2. 2

    API anahtarını oluşturun

    Sağ üstteki kullanıcı adınızın altında yer alan "API Key" bölümünden anahtarı oluşturup kopyalayın.

  3. 3

    Mağazayı panele ekleyin

    Mağaza Ayarları'nda Koçtaş'ı seçin. Mirakl adresi koctas.mirakl.net olarak hazır gelir, genellikle değiştirmeniz gerekmez. Anahtarı yapıştırıp "Bağlantıyı test et" ile doğrulayın.

  4. 4

    Gerekirse ek alanları doldurun

    Kullanıcınız birden çok Koçtaş mağazasına erişiyorsa Mağaza ID'yi girin. Sipariş satırında vergi oranı gelmiyorsa "KDV oranı (Mirakl göndermezse)" alanından bir oran seçin.

Koçtaş bağlantısı için panelde istenen bilgiler: Mirakl adresi, API Anahtarı (API Key), Mağaza ID (Shop ID), KDV oranı (Mirakl göndermezse), Fatura belge türü kodu.
Dizüstü bilgisayar, tablet ve akıllı telefon

Ayrıntılar

Koçtaş siparişlerinde fatura kuralları

Koçtaş siparişleri Mirakl üzerinden geldiğinden bu kurallar uygulanır. Bekleyen bir Koçtaş siparişinin gerekçesini sipariş listesinde görürsünüz.

  • Fatura, Mirakl sipariş numarasına kesilir; bu numara satıcıya düşen siparişi gösterir ve genellikle sonu -A gibi bir harfle biter. Müşterinin gördüğü sipariş numarası da kayıtta tutulur.
  • Koçtaş fatura adresini sipariş onaylanıp kargo aşamasına geçmeden paylaşmayabilir. Adres gelene kadar sipariş bekletilir.
  • Koçtaş siparişinde Mirakl bir fatura gösteriyorsa, örneğin faturayı panelden elle yüklediyseniz, sipariş ikinci kez faturalanmaz.
  • İptal edilen ve reddedilen satırlar faturaya girmez. Kısmi iptal, iade, ek ücret ya da birden fazla vergi kalemi olan siparişler elle kontrol için ayrılır.
  • Vergi oranı satırda gelmezse bağlantıdaki KDV oranı ya da mağazanın tek tip KDV ayarı kullanılır; ikisi de boşsa sipariş faturalanmaz. %0, %1, %10 ve %20 dışındaki oranlar kontrole düşer.
  • Koçtaş'taki teklif SKU'nuz, Ürünler & Stok sayfasındaki ürün kodunuzla eşleştirilir; faturalanan miktar stoktan düşer.

Tek panel

Koçtaş faturalarınız diğer belgelerinizle aynı yerde

Entegrasyonlar

Diğer pazar yeri entegrasyonları

Tüm entegrasyonlar

Sık sorulan sorular

Koçtaş e-Arşiv fatura soruları

Kurulumla ilgili ayrıntılar için bağlantı adımlarına bakabilirsiniz.

Koçtaş bağlantısında hangi bilgileri girmeliyim?

Koçtaş'ın Mirakl panelinde oluşturduğunuz API anahtarı yeterlidir. Mirakl adresi hazır gelir; Mağaza ID yalnızca birden fazla mağazaya erişen kullanıcılar için gerekir.

Fatura Koçtaş'a nasıl ulaşıyor?

Fatura PDF'i Mirakl belge yükleme servisiyle siparişin belgelerine eklenir. Bu iletimi mağaza ayarlarından açarsınız; yükleme başarısız olursa sistem 7 gün boyunca aralıklı olarak yeniden dener.

Koçtaş belge türü kodunu kabul etmezse ne yapmalıyım?

Bağlantı bilgilerindeki "Fatura belge türü kodu" alanına Koçtaş'ın fatura için kullandığı kodu yazın. Alanın varsayılan değeri CUSTOMER_INVOICE olarak gelir.

Satıcı onayı bekleyen siparişler faturalanır mı?

Hayır. Onay ya da ödeme aşamasındaki Koçtaş siparişleri bekletilir. Sipariş onaylanıp ödemesi alındıktan sonraki eşitlemede faturalanır.

Promosyonlu ürünlerde fatura tutarı nasıl hesaplanır?

Mirakl satır tutarını promosyon düşülmüş olarak gönderir. Faturada birim fiyat ve aradaki fark iskonto olarak yer alır; satır toplamı Koçtaş'taki tutarla aynı kalır.

Koçtaş'ta sadece kargoya verilecek siparişleri çekebilir miyim?

Evet. Kayıtlı mağazanın ayarlarında "Durumları getir" ile Koçtaş sipariş durumları listelenir. "Kargoya verilecek" durumunu işaretlerseniz yalnızca o durumdaki siparişler çekilir.

Koçtaş siparişleri ne sıklıkla çekilir?

Koçtaş siparişleri 15 dakikalık varsayılan aralıkla sorgulanır. Hemen çekmek istediğinizde Otomasyon sayfasının "Şimdi çalıştır" bölümünü kullanın.

Koçtaş siparişlerinizi faturalamaya başlayın

efaturan şu an davetle kullanılıyor. Erken erişim talebinizi bırakın; hesabınız açıldığında ilk faturaları NES test ortamında, belgeler GİB'e gitmeden birlikte kontrol edelim.
Erken erişim talep etGiriş yap