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

WHMCS faturanız
kendiliğinden
e-Fatura.

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

Eklentiyi indirinKurulum adımları

WHMCS 8 · PHP 7.4 ve üstü · ücretsiz

Fatura ödenir,
gerisi kendiliğinden.

  1. 1

    WHMCS faturası ödenir

    Ya da ayarınıza göre oluşturulduğu anda. Eklenti WHMCS kancasıyla tetiklenir.

  2. 2

    Müşteri cari olur

    VKN/TCKN ya da e-postayla bulunur; yoksa açılır. VKN’li müşteri kurumsal, diğerleri bireysel.

  3. 3

    Fatura kesilip GİB’e gider

    Alıcı e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv. Toplam WHMCS’tekiyle kuruşu kuruşuna aynı.

  4. 4

    GİB no ve PDF WHMCS’e döner

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

Dört adımda kurulum

  1. 1

    CariErp’te API anahtarı üretin

    Panelde Entegrasyonlar › Hosting yazılımları › WHMCS › 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 WHMCS kök klasörüne açın (modules/addons/carierp/). Sistem Ayarları › Eklenti Modülleri’nde CariErp e-Fatura / e-Arşiv’i etkinleştirin.

  3. 3

    Ayarları girin

    API anahtarı, fatura serisi (ör. WHM), KDV eşlemesi ve “ödendiğinde / oluşturulduğunda” seçimi. Yönetici gruplarına erişim verin.

  4. 4

    Bağlantıyı deneyin

    Eklentiler › CariErp sayfasında şirketiniz ve jeton bakiyeniz görünür. Tahsilat hesabının kimliğini kopyalayıp ayarlara girin; bir faturayı Elle aktar ile deneyin. CariErp panelindeki WHMCS kartı Bağlı olur.

carierp-whmcs.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. WHM). Boşsa CariErp’teki varsayılan seri.
KDV eşlemesi
Satır satır WHMCS oranı=CariErp oranı (ör. 18=20). Varsayılan oran ayrıca seçilir.
Vergisiz kalemler
KDV %0 (istisna kodu, varsayılan 351) ya da fiyat KDV dahil sayılsın.
Tahsilat hesabı
Ödenen faturanın tahsilatının işleneceği CariErp kasa/banka hesabı. Boşsa ilk etkin banka hesabı, yoksa kasa.
VKN/TCKN ve vergi dairesi alanı
WHMCS’in Vergi Numarası alanı ya da müşteri özel alanlarınızdan biri; ayarlarda açılır listeden seçilir.
Nota yaz · Müşteri PDF düğmesi
GİB numarası ve PDF bağlantısı fatura notuna ve müşteri alanına eklenir.
İptali CariErp’e yansıt
WHMCS’te iptal edilen fatura CariErp’te de iptal edilir (e-Arşiv iptal süresi içinde).

Şablonda kendi düğmeniz

Müşteri fatura sayfasına PDF düğmesi kendiliğinden eklenir. Yerini siz belirlemek isterseniz viewinvoice.tpl şablonunda şu değişkenler hazırdır; ayarlardan “Müşteri alanında PDF düğmesi”ni kapatın.

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

viewinvoice.tpl
{if $carierpPdfUrl}
  <a href="{$carierpPdfUrl}" target="_blank" class="btn btn-default">
    {$carierpBelgeTuru} PDF ({$carierpGibNo})
  </a>
{/if}

Sorun giderme

Aynı fatura iki kez kesilir mi?

Hayır. Her WHMCS faturası tek kayda bağlanır ve istek Idempotency-Key ile gider; kanca iki kez çalışsa da tek fatura kesilir. Bakiye yükleme (Add Funds) ve toplu ödeme 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 hata sütunundadır (jeton yetersiz, e-Belge aktivasyonu tamamlanmamış). Nedeni giderip Yeniden gönder’e tıklayın; cron da 6 kez yeniden dener.

Promosyon ve indirim kalemleri ne olur?

Negatif kalemler aynı KDV oranındaki en büyük kalemden düşülür; fatura toplamı WHMCS’tekiyle aynı kalır.

Kurumsal müşterinin VKN’si nereden okunur?

WHMCS’in Vergi Numarası (Tax ID) alanından ya da ayarlarda belirttiğiniz müşteri özel alanından. 10 haneli VKN kurumsal, 11 haneli TCKN bireysel cari açar; vergi numarası yoksa fatura e-Arşiv olarak kesilir.

GİB durumu nasıl güncellenir?

WHMCS cron’unda (AfterCronJob) kesinleşmeyen faturalar sorgulanır. İsterseniz eklenti sayfasından webhook kaydedin; CariErp durum değişince anında bildirir.

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

Hayır. Eşleme tablosu (mod_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