İçeriğe geç
CariErp
Giriş yapÜcretsiz deneyin

WiseCP faturanız
kendiliğinden
e-Fatura.

Ödenen her WiseCP faturası CariErp’te e-Fatura ya da e-Arşiv olarak kesilir, GİB’e gider; GİB numarası ve PDF bağlantısı WiseCP’ye döner.

Eklentiyi indirinKurulum adımları

WiseCP 3 · PHP 7.4 ve üstü · ücretsiz

Fatura ödenir,
gerisi kendiliğinden.

  1. 1

    WiseCP faturası ödenir

    Ya da ayarınıza göre oluşturulduğu anda. Eklenti WiseCP’nin fatura durumu kancasıyla tetiklenir.

  2. 2

    Müşteri cari olur

    VKN/TCKN ya da e-postayla bulunur; yoksa açılır. Kurumsal hesap VKN ve vergi dairesiyle, bireysel hesap TCKN ile.

  3. 3

    Fatura kesilip GİB’e gider

    Alıcı e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv. Kupon, ödeme komisyonu ve taksit farkı dahil toplam WiseCP’dekiyle aynı.

  4. 4

    GİB no ve PDF WiseCP’ye döner

    Yönetici fatura sayfasında, yönetici notunda ve müşteri panelinde PDF düğmesi olarak.

Dört adımda kurulum

  1. 1

    CariErp’te API anahtarı üretin

    Panelde Entegrasyonlar › Hosting yazılımları › WiseCP › API anahtarı oluştur. Anahtar WHMCS / hosting faturalandırma izinleriyle açılır, dfk_ ile başlar ve bir kez gösterilir.

  2. 2

    Eklentiyi yükleyin

    Zip’i WiseCP kök klasörüne açın (coremio/modules/Addons/CariErp/). Araçlar › Eklentiler’de CariErp e-Fatura / e-Arşiv’i etkinleştirin.

  3. 3

    Ayarları girin

    API anahtarını yapıştırıp kaydedin; anahtar CariErp’e sorularak doğrulanır ve şifreli saklanır. Ardından Tahsilat hesabını listeden seçin; seri (ör. WSC) ve KDV eşlemesini girin.

  4. 4

    Bağlantıyı deneyin

    Eklenti sayfasında şirketiniz ve jeton bakiyeniz görünür; bir faturayı Elle aktar ile deneyin. CariErp panelindeki WiseCP kartı Bağlı olur.

carierp-wisecp.zipAPI anahtarı alın

Ayarlar

Fatura ne zaman kesilsin
Ödendiğinde (önerilen) ya da oluşturulduğunda. Oluşturulduğunda seçilirse ödeme gelince yalnız tahsilat işlenir.
GİB’e gönder
Açıkken fatura hemen e-Fatura / e-Arşiv olarak gider; kapalıysa yalnız kesilir.
Fatura serisi
3 karakter (ör. WSC). Boşsa CariErp’teki varsayılan seri.
KDV eşlemesi
Satır satır WiseCP oranı=CariErp oranı (ör. 18=20). Varsayılan oran ayrıca seçilir.
Vergisiz kalemler
Vergiden muaf kalem ve vergisiz fatura için KDV %0 (istisna kodu, varsayılan 351) ya da fiyat KDV dahil sayılsın.
Tahsilat hesabı
CariErp kasa ve banka hesaplarınız listeden seçilir. Boşsa ilk etkin banka hesabı, yoksa kasa.
Nota yaz · Müşteri PDF düğmesi
GİB numarası ve PDF bağlantısı yönetici notuna ve müşteri panelindeki fatura sayfasına eklenir.
İptali CariErp’e yansıt
WiseCP’de iptal ya da iade edilen fatura CariErp’te de iptal edilir (e-Arşiv iptal süresi içinde). Tahsilatı işlenmiş fatura iptal edilmez.

WiseCP çekirdeğine dokunmaz

Eklenti yalnız WiseCP’nin resmî kancalarını ve iç API’sini (Invoices/GetInvoice, Clients/GetClient) kullanır; WiseCP güncellemelerinde dosyalarınız değişmez.

Eklenti Açık API’yi kullanır; kendi faturalama sisteminizi bağlamak için API belgesine bakın. WHMCS eklentisi aynı kurallarla çalışır.

Kullanılan kancalar
action:invoice.status_changed      ödendi → kes · iptal/iade → iptal
action:invoice.created.any          “oluşturulduğunda” modu
action:cron.hour.run                GİB durumu, yeniden deneme
ui:admin.invoices_detail.header_actions
                                    GİB no ve PDF (yönetici)
ui:client.invoice_detail.top        PDF düğmesi (müşteri)

Sorun giderme

Aynı fatura iki kez kesilir mi?

Hayır. Her WiseCP faturası tek kayda bağlanır ve istek Idempotency-Key ile gider; kanca iki kez çalışsa da tek fatura kesilir. Bakiye yükleme faturaları hiç kesilmez; bakiyeyle ödenen hizmet faturası kesilir.

“GİB’e gönderilemedi” görüyorum.

Fatura CariErp’te kesilmiş ama gönderilememiştir; nedeni Aktarılan faturalar tablosundadır (jeton yetersiz, e-Belge aktivasyonu tamamlanmamış). Nedeni giderip Yeniden gönder’e tıklayın; saatlik cron da 6 kez yeniden dener.

Kupon, komisyon ve taksit farkı ne olur?

Kupon indirimi aynı KDV oranındaki en büyük kalemden düşülür; ödeme yöntemi komisyonu ve taksit farkı ayrı kalem olur. Fatura toplamı WiseCP genel toplamıyla aynı kalır.

Kurumsal müşterinin VKN’si nereden okunur?

WiseCP’de hesap türü Kurumsal olan müşterinin vergi numarası ve vergi dairesinden; bireysel müşteride T.C. Kimlik No’dan. Bilgiler faturanın kesildiği andaki fatura bilgisinden okunur. Numara yoksa fatura e-Arşiv olarak kesilir.

KDV dahil fiyatlarım var.

WiseCP’de vergilendirme türü “dahil” olan faturalar kendiliğinden tanınır ve KDV dahil fiyatlarla kesilir.

GİB durumu nasıl güncellenir?

WiseCP’nin saatlik cron’unda kesinleşmeyen faturalar sorgulanır. Otomasyon (cron) görevinin tanımlı olduğundan emin olun.

Eklentiyi kaldırırsam kayıtlar silinir mi?

Hayır. Eşleme tablosu (CariErp_faturalar) yasal iz için korunur.

Cariniz bugün
güncellensin.

14 gün ücretsiz deneyin. Kredi kartı istemiyoruz; kurulumda ve veri aktarımında ekibimiz yanınızda.

Hemen başlayınSatış ekibiyle görüşün