Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mlevent/ivd

Gelir İdaresi Başkanlığı İnteraktif Vergi Dairesi Sorgulamaları
https://github.com/mlevent/ivd

gib interaktif ivd php vergi

Last synced: 2 months ago
JSON representation

Gelir İdaresi Başkanlığı İnteraktif Vergi Dairesi Sorgulamaları

Awesome Lists containing this project

README

        

💸 İnteraktif Vergi Dairesi


https://ivd.gib.gov.tr


Bu Paket ile GİB İnteraktif Vergi Dairesi üzerinden bazı şifresiz/şifreli işlemleri gerçekleştirebilirsiniz.









## Kurulum

🛠️ Paketi composer ile projenize dahil edin;

```bash
composer require mlevent/ivd
```

## Örnek Kullanım

```php
use Mlevent\Ivd\IvdService;

// Şifresiz Giriş
$ivd = (new IvdService)->login();

// Vergi Numarası Doğrulama
$result = $ivd->taxIdVerification(
taxId : '1234567890',
province : '016',
taxOffice : '016252'
);

print_r($result);
```

### Gerçek Kullanıcı

Kullanıcı bilgilerinizi `setCredentials` ya da `login` metoduyla tanımlayabilirsiniz.

```php
use Mlevent\Ivd\IvdService;

// Kullanıcı Bilgileriyle Giriş
$ivd = (new IvdService)->login('TC Kimlik No', 'Parola');
```

> Not: Token değerini herhangi bir yerde kullanmanız gerekmeyecek.

## Şifresiz İşlemler

İnteraktif Vergi Dairesi üzerindeki bazı servisler şifresiz/giriş yapmadan kullanılabilir;

```php
/**
* Vergi Kimlik Numarası Sorgulama
* Kimlik bilgileriyle Vergi Kimlik numarası sorgulama. Tüm alanların gönderilmesi zorunludur.
*
* @param string $name · İsim
* @param string $lastName · Soyisim
* @param string $fatherName · Baba Adı
* @param string $province · İl
* @param string $dateOfBirth · Doğum Tarihi
* @return array
*/
$ivd->taxIdInquiry(
name : 'Mert',
lastName : 'Levent',
fatherName : 'Walter',
province : '016',
dateOfBirth : '19890511'
);

/**
* Yabancılar İçin Vergi Kimlik Numarasından Sorgulama
*
* @param string $taxId · Vergi Numarası
* @return array
*/
$ivd->taxIdInquiryForForeigners(
taxId : '1234567890'
);

/**
* Vergi Kimlik Numarası Doğrulama
* Sorgulanacak kişi ya da kurumun Vergi Kimlik ya da T.C. Kimlik numarasından sadece birini giriniz.
*
* @param string $taxId · Vergi Numarası
* @param string $trId · TcKN
* @param string $province · İl
* @param string $taxOffice · Vergi Dairesi
* @return array
*/
$ivd->taxIdVerification(
//taxId : '1234567890',
trId : '11111111111',
province : '016',
taxOffice : '016252'
);

/**
* Vergi Dairelerine ait liste çıktısını verir.
*
* @return array
*/
$ivd->getTaxOffices();

/**
* Vergileri ve vergi kodlarına ait liste çıktısını verir.
*
* @return array
*/
$ivd->getTaxList();

/**
* Ülkelere ait liste çıktısını verir.
*
* @return array
*/
$ivd->getCountries();

/**
* Türkiye'deki illere ait liste çıktısını verir.
*
* @return array
*/
$ivd->getProvinces();

/**
* Türkiye'deki iller ve ilçelere ait liste çıktısını verir.
*
* @return array
*/
$ivd->getProvincesAndDistricts();
```

## Şifreli İşlemler

İnteraktif Vergi Dairesinde kayıtlı TcKN ve şifre bilgileriyle oturum açılarak kullanılabilecek metodlar;

```php
/**
* Nüfus müdürlüğünde kayıtlı kimlik bilgileri.
*
* @return array
*/
$ivd->getIdInformation();

/**
* Vergi dairesi ve nüfus müdürlüğü sicil kaydı.
*
* @return array
*/
$ivd->getRegistry();

/**
* Şirketlerdeki ortaklık ve yöneticilik bilgileri.
*
* @return array
*/
$ivd->getPartnerships();

/**
* Borç Durumu
* Gelir İdaresi Başkanlığında kayıtlı borçlara ait liste çıktısını verir.
*
* @return array
*/
$ivd->getDebtStatus();

/**
* KYK Borç Durumu
*
* @return array
*/
$ivd->getKYKDebtStatus();

/**
* Banka Hesaplarına Uygulanan Elektronik Hacizler
*
* @return array
*/
$ivd->getGarnishmentsAppliedToBankAccounts();

/**
* Araçlara Uygulanan Elektronik Hacizler
*
* @return array
*/
$ivd->getGarnishmentsAppliedToVehicles();

/**
* Mevcut Araç Bilgileri
* Şu an sahibi olduğunuz araçlara ait bilgileri döndürür.
*
* @return array
*/
$ivd->getCurrentVehicles();

/**
* Geçmiş Araç Bilgileri
* Geçmişte sahibi olduğunuz, artık üzerinize kayıtlı olmayan araçlara ait bilgileri döndürür.
*
* @return array
*/
$ivd->getPreviousVehicles();

/**
* Vergi Ceza İhbarname Bilgileri
*
* @return array
*/
$ivd->getTaxPenaltyNoticeInformation();

/**
* Sanal Pos Ödemeleri
* Gelir İdaresi Başkanlığına sanal pos üzerinden yapılan ödemelerin listesini verir.
*
* @param int $year · Yıl
* @return array
*/
$ivd->getVirtualPosPayments(
year: 2018
);

/**
* E-Devlet Ödemeleri
* Gelir İdaresi Başkanlığına e-devlet üzerinden yapılan ödemelerin listesini verir.
*
* @param int $year · Yıl
* @return array
*/
$ivd->getEDevletPayments(
year: 2018
);

/**
* Diğer Ödemeler
*
* @param int $year · Yıl
* @return array
*/
$ivd->getOtherPayments(
year: 2018
);

/**
* Servis Mesajları
* İnteraktif Vergi Dairesi üzerinden yayınlanan servis mesajlarını döndürür.
*
* @return array
*/
$ivd->getServiceMessages();
```

## 📧İletişim

İletişim için [email protected] adresine e-posta gönderin.