Sonuçları ERP'ye Alma

İsteğe bağlı ek özellik. Muhasebe personeli mutabakatı panelden yürütür; sonuçlar (hangi firma mutabık, hangisi itiraz etti, ekstre karşılaştırmasında kaç satır eşleşmedi) panelde görünür. Bu sonuçların ERP'ye ya da raporlama sistemine kendiliğinden akması isteniyorsa BT ekibiniz aşağıdaki salt okuma uçlarını zamanlanmış bir görevle çağırır. Veri getirme yöntemi (talep ile aktarım / anlık bağlantı) bundan bağımsızdır.

Ne zaman kullanılır

• Mutabık olan/olmayan carileri ERP'de işaretlemek (ör. cari kartına "Ağustos mutabakatı: mutabık").
• İtiraz eden firmaların yanıtını ve yüklediği ekstreyi muhasebe iş listesine düşürmek.
• Ekstre karşılaştırma özetini (eşleşen / eşleşmeyen / fark toplamı) ya da Excel raporunu dosya sunucusuna almak.
• Yönetim raporuna "kaç firmaya gönderildi, kaçı yanıtladı" sayılarını çekmek.

Adımlar

Anahtarınızı MAI_API_KEY ortam değişkenine koyun; aşağıdaki istekler sonuçları uçtan uca okur.

1. 1

   Bağlantıyı doğrulayın

   GET /me

   Anahtarın firmasını, paketini ve kapsamlarını görün.

   curl https://mutabakat.ai/api/v1/me \
     -H "Authorization: Bearer $MAI_API_KEY"

2. 2

   Kampanyaları listeleyin

   GET /balance-campaigns

   Aktif ve tamamlanmış bakiye mutabakatı kampanyaları; her satırda durum sayıları (gönderildi, mutabık, itiraz, bekleyen).

   curl "https://mutabakat.ai/api/v1/balance-campaigns?status=active" \
     -H "Authorization: Bearer $MAI_API_KEY"

3. 3

   Yanıtları çekin

   GET /balance-campaigns/{id}/records

   Kampanya kayıtları: firma (counterparty.external_id = ERP kodu), beyan edilen bakiye, status (sent → viewed → agreed / disputed) ve response. updated_since ile yalnız son çağrıdan beri değişenleri alın; itirazda karşı taraf ekstre yüklediyse statement_job_id dolu gelir.

   curl "https://mutabakat.ai/api/v1/balance-campaigns/<kampanya-id>/records?updated_since=2026-09-01T00:00:00Z" \
     -H "Authorization: Bearer $MAI_API_KEY"

4. 4

   Ekstre karşılaştırma sonuçlarını okuyun

   GET /statement-jobs/{id}/results/summary

   İş listesinden completed işleri alın; results_available: true olduğunda özet (sayılar, toplamlar, dip bakiye), eşleşmeler, taraf bazında eşleşmeyenler, kullanıcı kararı bekleyen öneriler ve Excel raporu hazırdır (öncesinde sonuç uçları 409 results_not_ready döner).

   curl https://mutabakat.ai/api/v1/statement-jobs/<is-id>/results/summary \
     -H "Authorization: Bearer $MAI_API_KEY"

5. 5

   Excel dışa aktarımı alın

   POST /balance-campaigns/{id}/exports

   Kampanya için Excel dosyasını hazırlatın (202 + export_id), hazır olunca indirin; dosya tek indirmeliktir. Ekstre raporu doğrudan GET /statement-jobs/{id}/report ile iner.

   curl -X POST https://mutabakat.ai/api/v1/balance-campaigns/<kampanya-id>/exports \
     -H "Authorization: Bearer $MAI_API_KEY"

Kurallar

• Sorgulama sıklığı: 5–15 dakikada bir yeterlidir; updated_since + cursor ile yalnız değişenleri çekin. Anahtar başına dakikada 300 istek sınırı vardır.
• Sonuçlar paketinizin saklama süresi boyunca durur; süre dolunca iş/kampanya silinir ve uçlar 404 döner. Sonuçları kendi tarafınızda saklayın.
• Okuma uçları hiçbir şey yazmaz; kampanya gönderme, iş açma gibi işlemler panelden yapılır.

Uçların tamamı sol menüde servis gruplarına göre listelenir: Kampanya Kayıtları, Karşılaştırma Özeti, Excel Raporu.