SAP, Oracle NetSuite/Fusion, Logo Tiger/Go3 veya Mikro ERP sistemlerinizden NetZero E.S. hesaplama verilerinizi otomatik olarak çekmek ve yakıt/elektrik tüketim verinizi doğrudan göndermek için kullanılan REST API.
Bu API, NetZero E.S.'in muhasebe/ERP sisteminizle otomatik veri alışverişi yapmasını sağlayan bir köprüdür — elle veri girmeden, sistemleriniz birbiriyle "konuşur".
Örneğin: muhasebe ekibiniz her ay elektrik/yakıt faturalarını NetZero'nun hesaplayıcısına elle girmek yerine, ERP'niz bu tüketim verilerini otomatik olarak gönderir; biz de IPCC/DEFRA metodolojisiyle bilimsel olarak doğru CO2e hesabını yaparız. Sonuç: daha az manuel iş, daha az insan hatası riski.
NetZero'da biriken hesaplamalarınızı ERP'nize otomatik olarak indirin.
ERP'nizdeki yakıt/elektrik tüketim verisini gönderin, biz hesaplayıp kaydedelim.
Kimin için: muhasebe/finans ekipleri, BT/entegrasyon ekipleri ve ERP danışmanları.
API'ye erişim, Enterprise planına özeldir. API anahtarınızı Profil → API & Entegrasyon sekmesinden oluşturabilirsiniz. Tüm istekler HTTPS üzerinden yapılmalı ve yanıtlar JSON formatındadır.
Her istek, Authorization başlığında bir Bearer token
olarak API anahtarınızı içermelidir. Anahtarlar nk_live_
önekiyle başlar ve yalnızca oluşturulduğu an tam olarak gösterilir — kaybederseniz yeni bir
anahtar oluşturmanız gerekir.
Limit aşıldığında API 429 durum kodu döner. Sayaç her gün UTC 00:00'da sıfırlanır.
| Plan | Günlük İstek Limiti |
|---|---|
| Pro | 500 |
| Enterprise | 5.000 |
/apiV1Hesaplamalar
API anahtarı sahibine ait en güncel 100 hesaplama kaydını, oluşturulma tarihine göre en yeniden en eskiye sıralı olarak döner.
İstek Örneği
Yanıt Örneği (200 OK)
/apiV1Hesaplamalar
Yakıt (Scope 1) ve elektrik (Scope 2) tüketim verinizi gönderin, NetZero E.S. IPCC/DEFRA metodolojisiyle hesaplayıp hesabınıza kaydetsin. Yalnızca Read-Write yetkili anahtarlarla kullanılabilir.
İstek Örneği
İstek Parametreleri
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
kalemler[].kategori | string |
Evet | "scope1" veya "scope2" |
kalemler[].tur | string |
Evet | Aşağıdaki tabloya bakın |
kalemler[].miktar | number |
Evet | Pozitif, sonlu bir sayı |
kalemler[].ulkeKodu | string |
Hayır | Yalnızca scope2 için; belirtilmezse "TR" varsayılır |
kalemler[].hariciReferansId | string |
Hayır (önerilir) | İdempotentlik anahtarı, en fazla 200 karakter |
kalemler[].aktiviteTarihi | string |
Hayır | ISO tarih (örn. fatura tarihi) |
Geçerli tur Değerleri
kategori |
Geçerli tur değerleri |
|---|---|
scope1 |
dogalgazM3, komurKg, lpgKg, motorinLitre,
fuelOilLitre, biyokutleKg, benzinLitre, dizelLitre,
lpgLitre, hibritLitre, agirTasitDizelLitre, forkliftLpgLitre |
scope2 |
elektrikKwh |
Geçerli ulkeKodu değerleri: TR (varsayılan), DE, FR,
ES, IT, NL, PL, GB, US,
CN, EU_Ortalama. Bir istekte en az 1, en fazla 100 kalem gönderilebilir.
Yanıt Örneği (200 OK)
Yanıt HTTP 200 dönse bile her kalem bağımsız
olarak başarılı veya başarısız olabilir — sonuclar dizisindeki her elemanın
durum alanını kontrol edin.
| Kod | Anlamı |
|---|---|
401 | Eksik, geçersiz veya iptal edilmiş API anahtarı |
403 | Anahtar salt-okunur, yazma yetkisi yok |
429 | Günlük istek limiti aşıldı |
405 | Desteklenmeyen HTTP metodu |
500 | Sunucu tarafında beklenmeyen bir hata |
Veri yazma/içe aktarma artık desteklenmektedir. Sıradaki: NetZero E.S.'ten ERP'nize giden olay bildirimleri (webhook) — yeni bir hesaplama oluştuğunda otomatik bildirim. Öncelik talepleriniz için help@netzeroes.com.tr adresinden bize ulaşabilirsiniz.