Innova E-Fatura Servisi Kullanımı PHP Örnekleri

Açıklamalar

Bu örnek uygulama İnnova E-Fatura servislerine yönelik olarak hazırlanmıştır.
Uygulama https://efatura.innova.com.tr/ClientInterfaceService adresinden, WSDL şeması kullanılarak, otomatik olarak oluşturulan sınıflar kullanarak gerçekleştirilmiştir .
Sınıflar 23.06.2021 tarihinde oluşturulmuş olup, serviste versiyon güncellemeleri yapılırsa yeniden oluşturulmalıdır.
Sınıfları oluşturmak için wsdl2php aracı kullanılmıştır.
wsdl2php aracı aynı zamanda, bu örnek uygulama paketine eklenmiştir. (wsdl2php-master.zip dosyası)
wsdl2php aracı indirildikten sonra şu şekilde kullanılarak sınıflar yeniden oluşturulabilir:
php wsdl2php.php https://efatura.innova.com.tr/ClientInterfaceService
Araç; Services isimli bir klasör oluşturmaktadır. Bu oluşturulan klasör örnek projedeki Services klasörü ile değiştirilebilir.
Sınıfları otomatik olarak yüklemek için autoloader.php dosyası oluşturulmuş ve Services klasörüne eklenmiştir.
Güncelleme sırasında bu dosyayı tekrar aynı yere eklemeyi unutmayınız.
Müstahsil için; https://efatura.innova.com.tr/EArsivClientInterfaceService adresinden sınıflar olşturulmuş ve Services4EArchive klasörüne kaydedilmiştir. Bu sınıflar için de autoloader.php eklenmiş ve ilgili bölümlerde çağırılmıştır.
Uygulama Apache 2.4.46 web server üzerinde, PHP 7.4.12 sürümünde geliştirimiştir.
PHP'de SOAP aktif olmalıdır.

Genel Kullanım

Servis erişim bilgileri (adres, kullanıcı adı, şifre...) constant.php dosyasında tanımlanmıştır, kendi bilgileriniz ile değiştiriniz.
Servisi kullanmadan önce sınıflar ve servis erişim bilgileri dahil edilmelidir.
```
require_once "./Services/autoloader.php";
require_once "./constants.php";
```

Servis bağlantısı oluşturulur, bağlantı sağlanamadıysa istisna oluşturulur:

try {
    $ws = new \ClientInterfaceService(WS_URL);
    $connected = true;
} catch (Exception $exception) {
    echo "<p class='sRed'>Bağlantı hatası!<br/>Lütfen bağlantı tanımları ve internet bağlantınızı kontrol ediniz.<br/>";
    echo "( ".$exception->getMessage()." ) </p>";
    $connected = false;
}

Eğer bağlantı sağlandıysa ( if ($connected) { ):
1. RequiestHeader sınıfından nesne oluşturulup, servis erişim bilgileri atanır:
```
$reqHeader = new \ClientInterfaceService_RequestHeader();
$reqHeader->InstitutionId = WS_INSTITUTION_ID;
$reqHeader->Username = WS_USERNAME;
$reqHeader->Password = WS_PASSWORD;
```
2. Hangi servis kullanılacaksa o servisin Request sınıfından nesne oluşturulur Örnek kodda CustomerInquiryRequest yani e-fatura mükellefi olup olmadığını sorgulama:
```
$wsRequest = new \ClientInterfaceService_CustomerInquiryRequest();
```
3. Oluşturulan request nesnesine, oluşturulan header bilgisi atanır. (Not: Header otomatik oluşturulan request class'ta tanımlı değil ama olması gerekiyor):
```
$wsRequest->Header = $reqHeader;
```
4. Request nesnesine, ilgili request için gerekli özelliklerin tümü eklenir. Örnekte vergi numaraları dizi olarak eklenmiştir. Diğer kullanım örneklerinde gerektiğinde başka sınıflardan nesneler oluşturulup request özelliklerine eklenmiştir. Hangi request'e hangi özellikler ekleneceği servis dökümantasyonunda belirtilmiştir veya WSDL şeması ya da oluşturulan sınıf hiyerarşisinden tespit edilebilir:
```
$wsRequest->IdentityNumbers = array($vergino1, $vergino2);
```
5. Kullanılacak olan web servisi sınıfından yeni nesne oluşturulup, request özelliğine 2. adımda oluşturulan request nesnesi atanır:
```
$request = new \ClientInterfaceService_CustomerInquiry();
$request->request = $wsRequest;
```
6. Web servisi çağrılıp, hata oluşup oluşmadığı kontrol edilir:
```
try {
    $response = $ws->CustomerInquiry($request);
} catch (Exception $exception) {
    echo "<p class='sRed'>Hata oluştu: <br/>";
    echo $exception->getMessage() ."</p>";
    $response = false;
}
```
7. Yanıt alındıysa response nesnesinin ilgili servis yanıtı (örnekte CustomerInquiryResult) alınıp, anahtarlı diziye çevrilebilir veya istenilirse direkt nesne olarak kullanılabilir.
  Her serviste ortak olarak Header özelliği bulunmaktadır. Burada hata kodları ve mesajlarından faydalanılabilir. ResponseCode='0000' olması işlemin başarılı olduğunu gösterir.
  Response nesnesi her serviste farklı içeriğe sahiptir, bunun için servis dökümanı, WSDL şeması veya sınıf hiyerarşisinden faydalanılabilir.
```
        if ($response) {
            //yanıt alındıysa...
            $result = json_decode(json_encode($response->CustomerInquiryResult), true);
            echo "<h3>Servis Yanıtı</h3>";
            if ($result['Header']) {
                echo "<p>Message: " . $result['Header']['Message'];
                echo "<br>Response Code: " . $result['Header']['ResponseCode'];
                echo "<br>Status: " . $result['Header']['Status'];
                echo "</p>";
        } else {
            //yanıt alınamadıysa...
        }
```
Servislerin örnek kullanımlarında, servis yanıtı JSON formatında sayfaya eklenmiştir.