EPDK'dan şarj ağı operatör lisansı alan firmaların EV şarj istasyonları aracılığı ile verdikleri hizmetten ortaya çıkan geliri beyan ettikleri elektronik rapordur.

Raporlar tamamen elektronik ortamda gönderildiği için geliştirmeleri kendiniz yapabilir veya bir entegratörden yardım alabilirsiniz. Entegratörden yardım alabilmeniz için öncelikle gönderilecek rapor içeriğinin hazırlanması gerekmektedir. Hazırladığınız içerik hem entegratör hem de sizin yapacağınız özel çözüm ile GİB'e gönderilebilir.

Gerekli entegrasyon bilgilerine buradan erişebilirsiniz.

Echargo ürünümüz doğrudan şarj ağı operatörü olan firmaların raporlarını güvenle gönderebilecekleri bir çözüm sunmaktadır. Cihaz seri numarası ve ÖKC bildirim sistemi olan EKS'nin (Elektronik Kayıt Sistemi) başvuru ve kayıt süreçlerinin yapılmasından sonra Echargo CPMS ile EPDK'ya yapılan bildirimler gibi GİB'e de tam otomatik bir entegrasyon yapılmış olur.

Echargo CPMS hem entegratörler aracılığı ile otomatik olarak ya da Echargo ekosisteminde olan firmalar için verilen bir imzalama aracı ile verilerini manuel olarak raporlayabilmektedirler.

Henüz bildirim yapmayan veya raporlama sürecinde sorun yaşan firmaların [email protected] veya [email protected] adreslerine yazması yeterlidir.

Raquun olarak sadece entegrasyon yapmak isteyen meslektaşlarımız için Open Source olarak buradan erişebileceğiniz bir repository mevcut. Kodları indirdikten sonra kendi geliştirme ihtiyaçlarına göre düzenleyip bildirimleri yapabilirsiniz.

Kullanım

Projeyi derledikten sonra çıkan jar dosyasını 3 farklı şekilde çağırabilirsiniz.

1. Raporun Hazırlanması

ESU raporunuzun imzalı hali aşağıdaki xml örneği halinde bir path'e yazılmalıdır.

<?xml version="1.0" encoding="utf-8"?>
<eArsivRaporu
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
  xmlns="http://earsiv.efatura.gov.tr">
  <baslik>
    <ds:SignedInfo>İmza Bilgisi</ds:SignedInfo>
    <versiyon>1.0</versiyon>
    <mukellef>
      <vkn>1234567890</vkn>
    </mukellef>
    <hazirlayan>
      <vkn>1234567890</vkn>
    </hazirlayan>
    <raporNo>d34512e8-8141-4c38-8c25-e86ef42f1bb5</raporNo>
    <donemBaslangicTarihi>2024-09-01</donemBaslangicTarihi>
    <donemBitisTarihi>2024-09-30</donemBitisTarihi>
    <bolumBaslangicTarihi>2024-09-01</bolumBaslangicTarihi>
    <bolumBitisTarihi>2024-09-30</bolumBitisTarihi>
    <bolumNo>1</bolumNo>
  </baslik>
  <esuRapor>
    <UUID>dbaacd1f-400d-4634-b628-3606ef6b91b9</UUID>
    <plakaNo>06ABC123</plakaNo>
    <hizmetMiktari unitCode="kWh">7.224</hizmetMiktari>
    <toplamTutar>57.07</toplamTutar>
    <paraBirimi>TRY</paraBirimi>
  </esuRapor>
  <esuRapor>
    <UUID>c40af62a-508e-4ea0-86ab-9a1112f8c1c6</UUID>
    <plakaNo>06ACD519</plakaNo>
    <hizmetMiktari unitCode="kWh">4.373</hizmetMiktari>
    <toplamTutar>34.55</toplamTutar>
    <paraBirimi>TRY</paraBirimi>
  </esuRapor>
</eArsivRaporu>

java -jar gibsigner.jar "convert" "123456" "imzaliesurapor.xml" "soap_message_to_send.xml"

2. Imzalı raporu gönderme

İmzalı raporu aynı isimde bir zip içine attıktan sonra zip dosyasının base64 çıktısını bir xml'de aşağıdaki gibi ayarlanır.

<soap:Envelope
  xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
  xmlns:web="http://earsiv.vedop3.ggm.gov.org/">
  <soap:Header>
    <wsse:Security>İmza Bilgisi</wsse:Security>
  </soap:Header>
  <soap:Body
    xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
    wsu:Id="id-raporid">
    <web:sendDocumentFile>
      <Attachment>
        <fileName>soap_message_to_send.zip</fileName>
        <binaryData>dosya base64 çıktısı</binaryData>
      </Attachment>
    </web:sendDocumentFile>
  </soap:Body>
</soap:Envelope>

SOAP mesajını da Gelir İdaresi Başkanlığı'na göndermek için aşağıdaki script dizi kullanılır. Cevap alınan bilgileri çıktı olarak yazılan dosyadan kontrol edebilirsiniz. Dosya kaydedildi cevabını görmeniz yeterli olacaktır.

 java -jar gibsigner.jar "send" "signed_soap_message.xml" "response_file.xml"

3. GİB'den İmza durumunu sorgulama

Dosyayı kaydedikten sonra başarılı olup olmadığını da yeniden sormak germektedir. Bunun için de imzalı bir istek atmanız için aşağıdaki script dizisi kullanılmalıdır.

java -jar gibsigner.jar "check" "123456" "report_id" "response_file.xml"

Alınan cevap sonrası Gelir İdaresi Başkanlığı'nın servisinden 30 kodunun gelmesi rapor gönderim sürecini tamamlayacaktır.

Ön Gereksinimler

Mali mühür

ÖKC Başvurusu

Java 8 SDK