| Name | gib-esu JSON |
| Version |
1.0.9
JSON |
| download |
| home_page | None |
| Summary | GİB EŞÜ EKS servis istemcisi - Electroop |
| upload_time | 2024-12-30 13:11:30 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | # Released under MIT License Copyright (c) 2024 Electroop Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
gi̇b eşü eks
elektrikli şarj üniteleri
şarj ağı işletmecileri
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
pydantic
python-dotenv
requests
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# gib_esu
   [](https://electroop-engineering.github.io/gib-esu/reports/junit/report.html) [](https://electroop-engineering.github.io/gib-esu/reports/coverage/index.html) [](https://electroop-engineering.github.io/gib-esu/reports/flake8/index.html)   [](https://opensource.org/licenses/MIT)
## Amaç ve Kapsam
[Electroop](https://electroop.io) tarafından sağlanan açık kaynak kodlu *gib_esu* Python kütüphanesi ile Gelir İdaresi Başkanlığı'nın EŞÜ (Elektrikli Şarj Ünitesi) EKS (Elektronik Kayıt Sistemi) servisi üzerinden yapılan cihaz kayıt, mükellef bilgi/durum kaydetme/güncelleme, cihaz kapatma ve cihaz devir işlemleri gerçekleştirilebilir.
## Gerekli Python Sürümü
Python >= 3.8
(Çok çekirdekli işlemcilerle yazılım daha iyi performans gösterir.)
## Kurulum
```bash
pip install gib_esu
```
## Kullanım
_EsuServis_, kütüphanenin GİB EŞÜ EKS servisine istekler göndermekte kullanılan temel sınıfıdır.
Servis, çalışma parametrelerini projenin kök dizininde bulunan _.env_ dosyasından okur. Örnek bir .env dosyası içeriği aşağıda (ve ayrıca projenin GitHub reposundaki sample.env dosyası içinde) sunulmuştur.
### Örnek .env dosyası
```ini
###### ERİŞİM BİLGİLERİ - DEĞİŞTİRİLMELİ!! ######
GIB_FIRMA_KODU=J000
GIB_API_SIFRE=Abc123
###### ŞİRKET BİLGİLERİ - DEĞİŞTİRİLMELİ!! ######
FIRMA_UNVAN=ENERJİ ANONİM ŞİRKETİ
EPDK_LISANS_KODU=ŞH/12345-6/00789
FIRMA_VKN=1234567890
###### İSTEK PARAMETRELERİ - SEÇİLMELİ!! ######
PROD_API=1 # Test API kullanılacaksa PROD_API=0
SSL_DOGRULAMA=1 # SSL Doğrulama kullanılmayacaksa SSL_DOGRULAMA=0 (Canlı ortamda önerilmez)
TEST_FIRMA_KULLAN=0 #TEST_FIRMA_KULLAN=1 ise şirket VKN yerine 3900383669 (GİB test VKN) gönderilir
###### TEST VKN - GİB DEĞİŞTİRMEDİKÇE DEGİŞTİRİLMEMELİ ######
GIB_TEST_FIRMA_VKN=3900383669
```
## Servis Metotları
Elektrikli şarj ünitesinin (EŞÜ) kaydı, _ESUServis_ sınıfının *cihaz_kayit* metodu ile, ünitenin mükellef bilgisinin/durumunun GİB'e bildirimi ise yine aynı servis sınıfının *mukellef_kayit* metodu ile yapılmaktadır.
Bir EŞÜ'nün GİB EŞÜ EKS kaydının tamamlanmış olması için önce _cihaz_kayit_ metodu ile cihaz kaydının, ardından da _mukellef_kayit_ metodu ile mükellef kaydının gerçekleştirilmiş olması gerekmektedir.
Şarj ünitesi envanterlerini GİB'e ilk kez kaydettirecek olan şarj ağı işletmecileri, sisteme genellikle onlarca, hatta yüzlerce ünitenin bilgisini yüklemek durumunda kalmaktadırlar. Bu ihtiyacı karşılamak ve toplu envanter gönderimini kolaylaştırmak amacıyla servis sınıfına, paralel ya da ardışık modda çalıştırılabilen *toplu_kayit* metodu eklenmiştir. Toplu kayıt metodunun gerektirdiği .csv veri deseni, projenin GitHub sayfasındaki [örnek .csv dosyası](https://github.com/electroop-engineering/gib-esu/blob/main/sample.envanter.csv) içinde verilmiştir. Toplu gönderim sonuçları, isteğe bağlı olarak, json formatındaki bir dosyaya yazdırılarak raporlanabilir.
Not: Csv formatındaki giriş metin dosyasında _mukellef_vkn_ ve _mukellef_unvan_ alanları boş bırakılmış ise program, bu alanlar için .env dosyası içinde verilen _FIRMA_VKN_ ve FIRMA_UNVAN bilgilerini kullanır. GİB'in ilgili kılavuzlarında belirtilmiş olduğu üzere, _adres_no_, _koordinat_, _sertifika_no_, _sertifika_tarihi_ alanları boş bırakılabilir. Fatura ve mükellef bilgileri ile mülkiyet sahibi bilgileri birbirini dışlamak durumundadır. Diğer bir deyişle, _mukellef_vkn_ ile _mulkiyet_sahibi_vkn_tckn_ bilgileri aynı istekte dolu olarak gönderilemezler. Öte yandan, _mukellef_vkn_ verili ise _fatura_tarihi_ ve _fatura_ettn_ alanları da boş bırakılamaz. GİB EŞÜ servisinde tarih bilgilerinin tümünün YYYY-MM-DD (Örneğin 2024-11-28) biçiminde olması beklenmektedir. _gib_esu_ kütüphanesini kullandığınızda GİB tarafından belirlenmiş olan bu tür mantıksal ve biçimsel kurallar her isteğe ayrı ayrı uygulanarak istekler gönderimden önce doğrulanır. Şayet istek, mantık veya biçim bakımından hatalı ise, program, hata üreterek sorunlu isteklerin GİB'e gönderilmesinin önüne geçer.
Daha önce gönderilmiş cihaz ve/veya mükellef bilgilerinin yanlışlık ya da değişiklik nedeniyle güncellenmesi gerektiğinde _ESUServis_ sınıfının *kayit_guncelle* veya *toplu_guncelle* metotları kullanılabilir. Toplu güncelleme amacıyla kullanılacak olan .csv dosyasının veri deseni, toplu kayıt için yukarıda verilen dosyanınki ile aynıdır. GİB'in, EPDK Lisans No ve EŞÜ Seri No gibi bazı temel bilgilerin güncellenmesine izin vermediği bilinerek gönderimlerde bu hususa dikkat edilmelidir.
Mükellef tarafından devir ya da başka bir gerekçe ile artık kullanılmayacağı için envanterden çıkarılmak istenen şarj üniteleri, _ESUServis_ sınıfının *cihaz_kapatma* metodu ile GİB'e bildirilebilirler. Cihazın başka bir mükellefe devri durumunda *cihaz_kapatma* işleminin ardından *mukellef_kayit* metoduyla cihazın yeni mükellefinin bilgileri GİB'e temin edilmelidir.
EŞÜ EKS servisi ile ilgili açıklamalar, GİB'in yayımladığı ilgili teknik kılavuzlarda ve servisin kullanım kılavuzunda mevcuttur. Servise getirilen yenilikler ve yapılan değişiklikler nedeniyle sürümleri GİB tarafından zaman zaman güncellenen bu kılavuzların dikkatle takip edilmesi gerekir.
## İstek Örnekleri
<details open>
<summary>Cihaz Kayıt</summary>
```python
from gib_esu.models import ESU, ESUTipi, Soket, SoketTipi
from gib_esu.services import ESUServis
servis = ESUServis() # konfigürasyonda .env dosyası kullanılır
esu = ESU(
esu_seri_no="7001324500027",
esu_soket_tipi=ESUTipi.AC_DC,
esu_soket_sayisi="2",
esu_soket_detay=[
Soket(soket_no="Soket1", soket_tip=SoketTipi.AC),
Soket(soket_no="Soket2", soket_tip=SoketTipi.DC),
],
esu_markasi="Vestel",
esu_modeli="EVC04",
)
yanit = servis.cihaz_kayit(esu)
print(yanit.durum) # "success"
print(yanit.sonuc[0].mesaj) # "Basarili"
print(yanit.sonuc[0].kod) # "1000"
print(yanit.sonuc[0].esu_seri_no) # "7001324500027"
```
</details>
<details>
<summary>Mükellef Kayıt</summary>
```python
from gib_esu.models import Fatura, Lokasyon, Mukellef
from gib_esu.services import ESUServis
servis = ESUServis() # konfigürasyonda .env dosyası kullanılır
seri_no = "7001324500027"
lokasyon = Lokasyon(
il_kodu="034",
ilce="Sarıyer",
adres_numarası="2324516851",
koordinat="41°11'20.7528\"N, 29°2'51.0756\"E",
)
fatura = Fatura(fatura_tarihi="2024-11-29", fatura_ettn="G212024000000049")
mukellef = Mukellef(
mukellef_vkn="1234567890", mukellef_unvan="Yeşilçam Enerji Anonim Şirketi"
)
yanit = servis.mukellef_kayit(
esu=seri_no, lokasyon=lokasyon, fatura=fatura, mukellef=mukellef
)
print(yanit.durum) # "success"
print(yanit.sonuc[0].mesaj) # "Basarili"
print(yanit.sonuc[0].kod) # "1000"
print(yanit.sonuc[0].esu_seri_no) # "7001324500027"
```
</details>
<details>
<summary>Toplu Kayıt</summary>
```python
from time import time
from gib_esu.services import ESUServis
servis = ESUServis() # konfigürasyonda .env dosyası kullanılır
baslangic = time()
sonuc = servis.toplu_kayit(
giris_dosya_yolu="input.csv", # varsayılan "envanter.csv"
dosyaya_yaz=True, # varsayılan False
cikti_dosya_yolu="output.json", # varsayılan "gonderim_raporu.json"
paralel_calistir=True, # varsayılan False
istekleri_logla=True, # varsayılan False
)
bitis = time()
print(sonuc)
sure = bitis - baslangic
print(f"Süre: {sure:.2f} saniye")
```
</details>
<details>
<summary>Kayıt Güncelleme</summary>
```python
from gib_esu.models import Fatura, Lokasyon, Sertifika
from gib_esu.services import ESUServis
servis = ESUServis() # konfigürasyonda .env dosyası kullanılır
seri_no = "7001324500027"
lokasyon = Lokasyon(
il_kodu="034",
ilce="Sarıyer",
adres_numarası="2324516851",
koordinat="41°11'20.7528\"N, 29°2'51.0756\"E",
)
fatura = Fatura(fatura_tarihi="2024-11-29", fatura_ettn="G212024000000049")
sertifika = Sertifika(sertifika_no="SE2024013000012", sertifika_tarihi="2024-01-30")
yanit = servis.kayit_guncelle(
esu_seri_no=seri_no,
lokasyon=lokasyon,
fatura=fatura,
sertifika=sertifika,
)
print(yanit.durum) # "success"
print(yanit.sonuc[0].mesaj) # "Basarili"
print(yanit.sonuc[0].kod) # "1000"
print(yanit.sonuc[0].esu_seri_no) # "7001324500027"
```
</details>
<details>
<summary>Toplu Kayıt Güncelleme</summary>
```python
from time import time
from gib_esu.services import ESUServis
servis = ESUServis() # konfigürasyonda .env dosyası kullanılır
baslangic = time()
sonuc = servis.toplu_guncelle(
giris_dosya_yolu="input.csv", # varsayılan "envanter.csv"
dosyaya_yaz=True, # varsayılan False
cikti_dosya_yolu="output.json", # varsayılan "gonderim_raporu.json"
paralel_calistir=True, # varsayılan False
istekleri_logla=True, # varsayılan False
)
bitis = time()
print(sonuc)
sure = bitis - baslangic
print(f"Süre: {sure:.2f} saniye")
```
</details>
<details>
<summary>Cihaz Kapatma</summary>
```python
from gib_esu.services import ESUServis
servis = ESUServis() # konfigürasyonda .env dosyası kullanılır
seri_no = "7001324500027"
yanit = servis.cihaz_kapatma(esu_seri_no=seri_no)
print(yanit.durum) # "success"
print(yanit.sonuc[0].mesaj) # "Basarili"
print(yanit.sonuc[0].kod) # "1000"
print(yanit.sonuc[0].esu_seri_no) # "7001324500027"
```
</details>
<br>
## Kod Dokümantasyonu
Kod dokümantasyonuna [buradan](https://github.com/electroop-engineering/gib-esu/blob/main/doc.md) ulaşılabilir.
<br>
<br>
©Electroop, 2024
Raw data
{
"_id": null,
"home_page": null,
"name": "gib-esu",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "\u00d6zcan T\u00fcrkmen <ozcan@electroop.io>",
"keywords": "G\u0130B E\u015e\u00dc EKS, Elektrikli \u015farj \u00fcniteleri, \u015farj a\u011f\u0131 i\u015fletmecileri",
"author": null,
"author_email": "Electroop Engineering <dev@electroop.io>",
"download_url": "https://files.pythonhosted.org/packages/aa/3f/309679aac890adcaf2f25f5d95ce689c58f8dccf19baef35ed79aac12f9d/gib_esu-1.0.9.tar.gz",
"platform": null,
"description": "# gib_esu\n\n   [](https://electroop-engineering.github.io/gib-esu/reports/junit/report.html) [](https://electroop-engineering.github.io/gib-esu/reports/coverage/index.html) [](https://electroop-engineering.github.io/gib-esu/reports/flake8/index.html)   [](https://opensource.org/licenses/MIT)\n\n## Ama\u00e7 ve Kapsam\n\n[Electroop](https://electroop.io) taraf\u0131ndan sa\u011flanan a\u00e7\u0131k kaynak kodlu *gib_esu* Python k\u00fct\u00fcphanesi ile Gelir \u0130daresi Ba\u015fkanl\u0131\u011f\u0131'n\u0131n E\u015e\u00dc (Elektrikli \u015earj \u00dcnitesi) EKS (Elektronik Kay\u0131t Sistemi) servisi \u00fczerinden yap\u0131lan cihaz kay\u0131t, m\u00fckellef bilgi/durum kaydetme/g\u00fcncelleme, cihaz kapatma ve cihaz devir i\u015flemleri ger\u00e7ekle\u015ftirilebilir.\n\n## Gerekli Python S\u00fcr\u00fcm\u00fc\n\nPython >= 3.8\n(\u00c7ok \u00e7ekirdekli i\u015flemcilerle yaz\u0131l\u0131m daha iyi performans g\u00f6sterir.)\n\n## Kurulum\n\n```bash\npip install gib_esu\n```\n\n## Kullan\u0131m\n\n_EsuServis_, k\u00fct\u00fcphanenin G\u0130B E\u015e\u00dc EKS servisine istekler g\u00f6ndermekte kullan\u0131lan temel s\u0131n\u0131f\u0131d\u0131r.\nServis, \u00e7al\u0131\u015fma parametrelerini projenin k\u00f6k dizininde bulunan _.env_ dosyas\u0131ndan okur. \u00d6rnek bir .env dosyas\u0131 i\u00e7eri\u011fi a\u015fa\u011f\u0131da (ve ayr\u0131ca projenin GitHub reposundaki sample.env dosyas\u0131 i\u00e7inde) sunulmu\u015ftur.\n\n### \u00d6rnek .env dosyas\u0131\n\n```ini\n###### ER\u0130\u015e\u0130M B\u0130LG\u0130LER\u0130 - DE\u011e\u0130\u015eT\u0130R\u0130LMEL\u0130!! ######\nGIB_FIRMA_KODU=J000\nGIB_API_SIFRE=Abc123\n\n###### \u015e\u0130RKET B\u0130LG\u0130LER\u0130 - DE\u011e\u0130\u015eT\u0130R\u0130LMEL\u0130!! ######\nFIRMA_UNVAN=ENERJ\u0130 ANON\u0130M \u015e\u0130RKET\u0130\nEPDK_LISANS_KODU=\u015eH/12345-6/00789\nFIRMA_VKN=1234567890\n\n###### \u0130STEK PARAMETRELER\u0130 - SE\u00c7\u0130LMEL\u0130!! ######\nPROD_API=1 # Test API kullan\u0131lacaksa PROD_API=0\nSSL_DOGRULAMA=1 # SSL Do\u011frulama kullan\u0131lmayacaksa SSL_DOGRULAMA=0 (Canl\u0131 ortamda \u00f6nerilmez)\nTEST_FIRMA_KULLAN=0 #TEST_FIRMA_KULLAN=1 ise \u015firket VKN yerine 3900383669 (G\u0130B test VKN) g\u00f6nderilir\n\n###### TEST VKN - G\u0130B DE\u011e\u0130\u015eT\u0130RMED\u0130K\u00c7E DEG\u0130\u015eT\u0130R\u0130LMEMEL\u0130 ######\nGIB_TEST_FIRMA_VKN=3900383669\n```\n\n## Servis Metotlar\u0131\nElektrikli \u015farj \u00fcnitesinin (E\u015e\u00dc) kayd\u0131, _ESUServis_ s\u0131n\u0131f\u0131n\u0131n *cihaz_kayit* metodu ile, \u00fcnitenin m\u00fckellef bilgisinin/durumunun G\u0130B'e bildirimi ise yine ayn\u0131 servis s\u0131n\u0131f\u0131n\u0131n *mukellef_kayit* metodu ile yap\u0131lmaktad\u0131r.\n\nBir E\u015e\u00dc'n\u00fcn G\u0130B E\u015e\u00dc EKS kayd\u0131n\u0131n tamamlanm\u0131\u015f olmas\u0131 i\u00e7in \u00f6nce _cihaz_kayit_ metodu ile cihaz kayd\u0131n\u0131n, ard\u0131ndan da _mukellef_kayit_ metodu ile m\u00fckellef kayd\u0131n\u0131n ger\u00e7ekle\u015ftirilmi\u015f olmas\u0131 gerekmektedir.\n\n\u015earj \u00fcnitesi envanterlerini G\u0130B'e ilk kez kaydettirecek olan \u015farj a\u011f\u0131 i\u015fletmecileri, sisteme genellikle onlarca, hatta y\u00fczlerce \u00fcnitenin bilgisini y\u00fcklemek durumunda kalmaktad\u0131rlar. Bu ihtiyac\u0131 kar\u015f\u0131lamak ve toplu envanter g\u00f6nderimini kolayla\u015ft\u0131rmak amac\u0131yla servis s\u0131n\u0131f\u0131na, paralel ya da ard\u0131\u015f\u0131k modda \u00e7al\u0131\u015ft\u0131r\u0131labilen *toplu_kayit* metodu eklenmi\u015ftir. Toplu kay\u0131t metodunun gerektirdi\u011fi .csv veri deseni, projenin GitHub sayfas\u0131ndaki [\u00f6rnek .csv dosyas\u0131](https://github.com/electroop-engineering/gib-esu/blob/main/sample.envanter.csv) i\u00e7inde verilmi\u015ftir. Toplu g\u00f6nderim sonu\u00e7lar\u0131, iste\u011fe ba\u011fl\u0131 olarak, json format\u0131ndaki bir dosyaya yazd\u0131r\u0131larak raporlanabilir.\n\nNot: Csv format\u0131ndaki giri\u015f metin dosyas\u0131nda _mukellef_vkn_ ve _mukellef_unvan_ alanlar\u0131 bo\u015f b\u0131rak\u0131lm\u0131\u015f ise program, bu alanlar i\u00e7in .env dosyas\u0131 i\u00e7inde verilen _FIRMA_VKN_ ve FIRMA_UNVAN bilgilerini kullan\u0131r. G\u0130B'in ilgili k\u0131lavuzlar\u0131nda belirtilmi\u015f oldu\u011fu \u00fczere, _adres_no_, _koordinat_, _sertifika_no_, _sertifika_tarihi_ alanlar\u0131 bo\u015f b\u0131rak\u0131labilir. Fatura ve m\u00fckellef bilgileri ile m\u00fclkiyet sahibi bilgileri birbirini d\u0131\u015flamak durumundad\u0131r. Di\u011fer bir deyi\u015fle, _mukellef_vkn_ ile _mulkiyet_sahibi_vkn_tckn_ bilgileri ayn\u0131 istekte dolu olarak g\u00f6nderilemezler. \u00d6te yandan, _mukellef_vkn_ verili ise _fatura_tarihi_ ve _fatura_ettn_ alanlar\u0131 da bo\u015f b\u0131rak\u0131lamaz. G\u0130B E\u015e\u00dc servisinde tarih bilgilerinin t\u00fcm\u00fcn\u00fcn YYYY-MM-DD (\u00d6rne\u011fin 2024-11-28) bi\u00e7iminde olmas\u0131 beklenmektedir. _gib_esu_ k\u00fct\u00fcphanesini kulland\u0131\u011f\u0131n\u0131zda G\u0130B taraf\u0131ndan belirlenmi\u015f olan bu t\u00fcr mant\u0131ksal ve bi\u00e7imsel kurallar her iste\u011fe ayr\u0131 ayr\u0131 uygulanarak istekler g\u00f6nderimden \u00f6nce do\u011frulan\u0131r. \u015eayet istek, mant\u0131k veya bi\u00e7im bak\u0131m\u0131ndan hatal\u0131 ise, program, hata \u00fcreterek sorunlu isteklerin G\u0130B'e g\u00f6nderilmesinin \u00f6n\u00fcne ge\u00e7er.\n\nDaha \u00f6nce g\u00f6nderilmi\u015f cihaz ve/veya m\u00fckellef bilgilerinin yanl\u0131\u015fl\u0131k ya da de\u011fi\u015fiklik nedeniyle g\u00fcncellenmesi gerekti\u011finde _ESUServis_ s\u0131n\u0131f\u0131n\u0131n *kayit_guncelle* veya *toplu_guncelle* metotlar\u0131 kullan\u0131labilir. Toplu g\u00fcncelleme amac\u0131yla kullan\u0131lacak olan .csv dosyas\u0131n\u0131n veri deseni, toplu kay\u0131t i\u00e7in yukar\u0131da verilen dosyan\u0131nki ile ayn\u0131d\u0131r. G\u0130B'in, EPDK Lisans No ve E\u015e\u00dc Seri No gibi baz\u0131 temel bilgilerin g\u00fcncellenmesine izin vermedi\u011fi bilinerek g\u00f6nderimlerde bu hususa dikkat edilmelidir.\n\nM\u00fckellef taraf\u0131ndan devir ya da ba\u015fka bir gerek\u00e7e ile art\u0131k kullan\u0131lmayaca\u011f\u0131 i\u00e7in envanterden \u00e7\u0131kar\u0131lmak istenen \u015farj \u00fcniteleri, _ESUServis_ s\u0131n\u0131f\u0131n\u0131n *cihaz_kapatma* metodu ile G\u0130B'e bildirilebilirler. Cihaz\u0131n ba\u015fka bir m\u00fckellefe devri durumunda *cihaz_kapatma* i\u015fleminin ard\u0131ndan *mukellef_kayit* metoduyla cihaz\u0131n yeni m\u00fckellefinin bilgileri G\u0130B'e temin edilmelidir.\n\nE\u015e\u00dc EKS servisi ile ilgili a\u00e7\u0131klamalar, G\u0130B'in yay\u0131mlad\u0131\u011f\u0131 ilgili teknik k\u0131lavuzlarda ve servisin kullan\u0131m k\u0131lavuzunda mevcuttur. Servise getirilen yenilikler ve yap\u0131lan de\u011fi\u015fiklikler nedeniyle s\u00fcr\u00fcmleri G\u0130B taraf\u0131ndan zaman zaman g\u00fcncellenen bu k\u0131lavuzlar\u0131n dikkatle takip edilmesi gerekir.\n\n## \u0130stek \u00d6rnekleri\n\n<details open>\n\n<summary>Cihaz Kay\u0131t</summary>\n\n```python\nfrom gib_esu.models import ESU, ESUTipi, Soket, SoketTipi\nfrom gib_esu.services import ESUServis\n\nservis = ESUServis() # konfig\u00fcrasyonda .env dosyas\u0131 kullan\u0131l\u0131r\nesu = ESU(\n esu_seri_no=\"7001324500027\",\n esu_soket_tipi=ESUTipi.AC_DC,\n esu_soket_sayisi=\"2\",\n esu_soket_detay=[\n Soket(soket_no=\"Soket1\", soket_tip=SoketTipi.AC),\n Soket(soket_no=\"Soket2\", soket_tip=SoketTipi.DC),\n ],\n esu_markasi=\"Vestel\",\n esu_modeli=\"EVC04\",\n)\n\nyanit = servis.cihaz_kayit(esu)\n\nprint(yanit.durum) # \"success\"\nprint(yanit.sonuc[0].mesaj) # \"Basarili\"\nprint(yanit.sonuc[0].kod) # \"1000\"\nprint(yanit.sonuc[0].esu_seri_no) # \"7001324500027\"\n```\n\n</details>\n<details>\n\n<summary>M\u00fckellef Kay\u0131t</summary>\n\n```python\nfrom gib_esu.models import Fatura, Lokasyon, Mukellef\nfrom gib_esu.services import ESUServis\n\nservis = ESUServis() # konfig\u00fcrasyonda .env dosyas\u0131 kullan\u0131l\u0131r\n\nseri_no = \"7001324500027\"\n\nlokasyon = Lokasyon(\n il_kodu=\"034\",\n ilce=\"Sar\u0131yer\",\n adres_numaras\u0131=\"2324516851\",\n koordinat=\"41\u00b011'20.7528\\\"N, 29\u00b02'51.0756\\\"E\",\n)\n\nfatura = Fatura(fatura_tarihi=\"2024-11-29\", fatura_ettn=\"G212024000000049\")\n\nmukellef = Mukellef(\n mukellef_vkn=\"1234567890\", mukellef_unvan=\"Ye\u015fil\u00e7am Enerji Anonim \u015eirketi\"\n)\n\nyanit = servis.mukellef_kayit(\n esu=seri_no, lokasyon=lokasyon, fatura=fatura, mukellef=mukellef\n)\n\nprint(yanit.durum) # \"success\"\nprint(yanit.sonuc[0].mesaj) # \"Basarili\"\nprint(yanit.sonuc[0].kod) # \"1000\"\nprint(yanit.sonuc[0].esu_seri_no) # \"7001324500027\"\n```\n\n</details>\n\n<details>\n\n<summary>Toplu Kay\u0131t</summary>\n\n```python\nfrom time import time\n\nfrom gib_esu.services import ESUServis\n\nservis = ESUServis() # konfig\u00fcrasyonda .env dosyas\u0131 kullan\u0131l\u0131r\n\nbaslangic = time()\n\nsonuc = servis.toplu_kayit(\n giris_dosya_yolu=\"input.csv\", # varsay\u0131lan \"envanter.csv\"\n dosyaya_yaz=True, # varsay\u0131lan False\n cikti_dosya_yolu=\"output.json\", # varsay\u0131lan \"gonderim_raporu.json\"\n paralel_calistir=True, # varsay\u0131lan False\n istekleri_logla=True, # varsay\u0131lan False\n)\n\nbitis = time()\n\nprint(sonuc)\n\nsure = bitis - baslangic\nprint(f\"S\u00fcre: {sure:.2f} saniye\")\n```\n</details>\n\n<details>\n\n<summary>Kay\u0131t G\u00fcncelleme</summary>\n\n```python\nfrom gib_esu.models import Fatura, Lokasyon, Sertifika\nfrom gib_esu.services import ESUServis\n\nservis = ESUServis() # konfig\u00fcrasyonda .env dosyas\u0131 kullan\u0131l\u0131r\n\nseri_no = \"7001324500027\"\n\nlokasyon = Lokasyon(\n il_kodu=\"034\",\n ilce=\"Sar\u0131yer\",\n adres_numaras\u0131=\"2324516851\",\n koordinat=\"41\u00b011'20.7528\\\"N, 29\u00b02'51.0756\\\"E\",\n)\n\nfatura = Fatura(fatura_tarihi=\"2024-11-29\", fatura_ettn=\"G212024000000049\")\n\nsertifika = Sertifika(sertifika_no=\"SE2024013000012\", sertifika_tarihi=\"2024-01-30\")\n\nyanit = servis.kayit_guncelle(\n esu_seri_no=seri_no,\n lokasyon=lokasyon,\n fatura=fatura,\n sertifika=sertifika,\n)\n\nprint(yanit.durum) # \"success\"\nprint(yanit.sonuc[0].mesaj) # \"Basarili\"\nprint(yanit.sonuc[0].kod) # \"1000\"\nprint(yanit.sonuc[0].esu_seri_no) # \"7001324500027\"\n```\n\n</details>\n\n<details>\n\n<summary>Toplu Kay\u0131t G\u00fcncelleme</summary>\n\n```python\nfrom time import time\n\nfrom gib_esu.services import ESUServis\n\nservis = ESUServis() # konfig\u00fcrasyonda .env dosyas\u0131 kullan\u0131l\u0131r\n\nbaslangic = time()\n\nsonuc = servis.toplu_guncelle(\n giris_dosya_yolu=\"input.csv\", # varsay\u0131lan \"envanter.csv\"\n dosyaya_yaz=True, # varsay\u0131lan False\n cikti_dosya_yolu=\"output.json\", # varsay\u0131lan \"gonderim_raporu.json\"\n paralel_calistir=True, # varsay\u0131lan False\n istekleri_logla=True, # varsay\u0131lan False\n)\n\nbitis = time()\n\nprint(sonuc)\n\nsure = bitis - baslangic\nprint(f\"S\u00fcre: {sure:.2f} saniye\")\n```\n\n</details>\n<details>\n\n<summary>Cihaz Kapatma</summary>\n\n```python\nfrom gib_esu.services import ESUServis\n\nservis = ESUServis() # konfig\u00fcrasyonda .env dosyas\u0131 kullan\u0131l\u0131r\n\nseri_no = \"7001324500027\"\n\nyanit = servis.cihaz_kapatma(esu_seri_no=seri_no)\n\nprint(yanit.durum) # \"success\"\nprint(yanit.sonuc[0].mesaj) # \"Basarili\"\nprint(yanit.sonuc[0].kod) # \"1000\"\nprint(yanit.sonuc[0].esu_seri_no) # \"7001324500027\"\n```\n\n</details>\n<br>\n\n\n## Kod Dok\u00fcmantasyonu\nKod dok\u00fcmantasyonuna [buradan](https://github.com/electroop-engineering/gib-esu/blob/main/doc.md) ula\u015f\u0131labilir.\n<br>\n<br>\n©Electroop, 2024\n",
"bugtrack_url": null,
"license": "# Released under MIT License Copyright (c) 2024 Electroop Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "G\u0130B E\u015e\u00dc EKS servis istemcisi - Electroop",
"version": "1.0.9",
"project_urls": {
"documentation": "https://github.com/electroop-engineering/gib-esu/blob/main/doc.md",
"homepage": "https://github.com/electroop-engineering/gib-esu",
"repository": "https://github.com/electroop-engineering/gib-esu"
},
"split_keywords": [
"gi\u0307b e\u015f\u00fc eks",
" elektrikli \u015farj \u00fcniteleri",
" \u015farj a\u011f\u0131 i\u015fletmecileri"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c5849580360116a5f3bddb396179258cf75d54cde5638b063a05f27085131926",
"md5": "297521e1eef99177de50bc2221d6655d",
"sha256": "ef0afcd0c852d2d408945a3d2c98c332b5902d49a2bb9781244702675eead85d"
},
"downloads": -1,
"filename": "gib_esu-1.0.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "297521e1eef99177de50bc2221d6655d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18510,
"upload_time": "2024-12-30T13:11:28",
"upload_time_iso_8601": "2024-12-30T13:11:28.720834Z",
"url": "https://files.pythonhosted.org/packages/c5/84/9580360116a5f3bddb396179258cf75d54cde5638b063a05f27085131926/gib_esu-1.0.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "aa3f309679aac890adcaf2f25f5d95ce689c58f8dccf19baef35ed79aac12f9d",
"md5": "2329f0bfc89f09f62d566b9cb86d098b",
"sha256": "6665df2443c8961d1e28bb3c388e72b56d7d9c997bf9597b0e193d31eb2b27a0"
},
"downloads": -1,
"filename": "gib_esu-1.0.9.tar.gz",
"has_sig": false,
"md5_digest": "2329f0bfc89f09f62d566b9cb86d098b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 19791,
"upload_time": "2024-12-30T13:11:30",
"upload_time_iso_8601": "2024-12-30T13:11:30.170984Z",
"url": "https://files.pythonhosted.org/packages/aa/3f/309679aac890adcaf2f25f5d95ce689c58f8dccf19baef35ed79aac12f9d/gib_esu-1.0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-30 13:11:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "electroop-engineering",
"github_project": "gib-esu",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pydantic",
"specs": [
[
"==",
"2.9.2"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.32.3"
]
]
}
],
"lcname": "gib-esu"
}
