Enterprise Özelliği

NetZero E.S. REST API

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 Ne İşe Yarar?

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.

Veri Çekme

NetZero'da biriken hesaplamalarınızı ERP'nize otomatik olarak indirin.

Veri Gönderme

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ı.

Genel Bakış

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.

Temel URL: https://europe-west1-netzeroes.cloudfunctions.net

Kimlik Doğrulama

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.

Authorization: Bearer nk_live_XXXXXXXXXXXXXXXXXXXXXXXX

Hız Sınırları

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

Uç Noktalar

GET /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

curl https://europe-west1-netzeroes.cloudfunctions.net/apiV1Hesaplamalar \ -H "Authorization: Bearer nk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

Yanıt Örneği (200 OK)

{ "veri": [ { "id": "aB3xQ...", "moduleType": "scope1", "moduleAdi": "Scope 1 - Doğrudan Emisyonlar", "sonucKgCO2e": 10114, "sonucDeger": 10114, "sonucBirimi": "kg CO2e", "tesisId": null, "olusturmaTarihi": "2026-08-10T09:12:00.000Z" } ], "toplamKayit": 1 }

POST /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

curl -X POST https://europe-west1-netzeroes.cloudfunctions.net/apiV1Hesaplamalar \ -H "Authorization: Bearer nk_live_XXXXXXXXXXXXXXXXXXXXXXXX" \ -H "Content-Type: application/json" \ -d '{ "kalemler": [ { "kategori": "scope1", "tur": "dogalgazM3", "miktar": 1200, "hariciReferansId": "erp-fatura-88213" }, { "kategori": "scope2", "tur": "elektrikKwh", "miktar": 5000, "ulkeKodu": "TR" } ] }'

İ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)
`kalemler[].donem`	`object`	Hayır	Verinin ait olduğu dönem: `{"tur":"ay","yil":2026,"ay":3}` ya da `{"tur":"yil","yil":2026}`. Verilmezse `aktiviteTarihi` ayından türetilir
`kalemler[].sertifikaOrani`	`number`	Hayır	Yalnızca `scope2` için; iptal edilmiş yenilenebilir enerji sertifikasıyla karşılanan pay (0-100). Piyasa bazlı değeri belirler
`kalemler[].tedarikciKatsayi`	`number`	Hayır	Yalnızca `scope2` için; sertifikasız paya uygulanacak tedarikçiye özgü katsayı (kg CO2e/kWh, 0-2). Verilmezse şebeke ortalaması kullanılır
`kalemler[].yontem`	`string`	Hayır	Yalnızca `scope2` için; `"lokasyon"` (varsayılan) ya da `"piyasa"`. Toplamlara giren değeri seçer; yanıtta iki değer de döner

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.

{ "sonuclar": [ { "hariciReferansId": "erp-fatura-88213", "durum": "olusturuldu", "hesaplamaId": "aB3xQ...", "sonucKgCO2e": 2424.0 }, { "hariciReferansId": "erp-fatura-88214", "durum": "zaten_islendi" }, { "hariciReferansId": "erp-fatura-88215", "durum": "hata", "mesaj": "Geçersiz tur: 'dizelKg'" } ] }

Hata Kodları

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

Yol Haritası

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 [email protected] adresinden bize ulaşabilirsiniz.