Talep ile Aktarım Kurulumu

BT ekibiniz ERP sunucusunda (ya da başka bir makinede) çalışan bir program yazar. Program MutabakatAI'yı 20–30 saniyede bir yoklar, bekleyen talebi ERP'den doldurur ve veriyi aynı talebin complete ucuna teslim eder. Dışarıya açık bağlantı gerekmez. Toplam dört işlem vardır.

Kurulum adımları

1. 1
   Yöntemi seçin ve anahtar üretin

   Firma sahibi panelde Profil → Entegrasyon → "ERP'den veri getirme yöntemi" → Talep ile aktarım seçer (onay diyaloğu). Ardından "Yeni anahtar" → Tam erişim. Anahtar bir kez gösterilir; BT ekibine güvenli bir kanaldan iletilir.

2. 2
   Yoklayıcıyı yazın

   Döngü: GET /erp-requests → liste doluysa her talep için POST …/{id}/claim (isteğe bağlı; 200 değilse talebi atlayın) → veriyi ERP'den hazırlayın (hazırlanamıyorsa POST …/{id}/fail { reason }) → POST …/{id}/complete { counterparties | statement | balances }. 429, 5xx ve ağ hatasında fail çağırmayın; talep sonraki turda yeniden gelir. Node, C# ve Python örnekleri hazırdır; ERP sorgusunu yerleştirmeniz yeterlidir.

3. 3
   Çalıştırın

   Program bir Windows servisi, zamanlanmış görev ya da SAP CPI iFlow olabilir; yalnız dışarı çıkan HTTPS gerekir. Önce test ortamında mai_test_ anahtarıyla deneyin.

4. 4
   Kullanın

   Yoklayıcı çalışırken Entegrasyon sekmesinde "Bağlantı aktif" rozeti görünür. Muhasebe personeli panelde: Ekstre sihirbazı → "İki Ekstreyi de Ben Yüklerim" → çerçeve (ad, taraflar, para birimi) → Ekstreler adımında "Şirketiniz ekstresi" kartında ERP'den getir → rehberden cari (ilk kullanımda "Cari listesini ERP'den güncelle") → dönem → talep düşer, kart "ERP'den veri bekleniyor" der → veri gelince dosya karta oturur → karşı tarafın Excel dosyası → Başlat. Bakiye sihirbazı → dönem → Bakiyeleri getir → Geldi → Firmalar → Gönder. Rehberin her sabah güncel olması için yoklama kartındaki "Cari rehberini her gün ERP'den güncelle" anahtarını açın.

Yoklama döngüsü

Muhasebe personeli sihirbazda "ERP'den getir" deyince bir talep oluşur (cari listesi · bir carinin dönem ekstresi · dönem sonu bakiyeleri). ERP programınız GET /api/v1/erp-requests ile 20–30 saniyede bir sorar, bekleyen talebi alır, ERP'den veriyi çekip aynı talebin `complete` ucuna bırakır — başka uç gerekmez. Panel "Geldi" der ve muhasebe personeli devam eder (ekstre sihirbazın "Şirketiniz ekstresi" kartına dosya olarak oturur; iş personel karşı tarafı ekleyip başlatınca açılır). Talep 30 dakika geçerlidir.

1. GET /erp-requests → data[] boşsa bekle (poll_after_seconds). Yanıttaki fetch_mode request değilse firma bu yöntemi seçmemiştir (talep hiç gelmez) — günlükleyin, muhasebe ekibi Profil → Entegrasyon'dan yöntemi değiştirsin. Dolu ise her talep için:
2. POST /erp-requests/{id}/claim — "aldım, hazırlıyorum" (isteğe bağlı ama önerilir; panelde ara durum görünür, süre en az 10 dk uzar).
3. ERP'den veriyi hazırlayın: kind = counterparties → tüm cari listesi · kind = statement → params.counterparty (ERP kodu / VKN / ad) + params.period_start..period_end için ekstre satırları · kind = balances → params.period_date için tüm cari bakiyeleri.
4. Teslim edin: POST /erp-requests/{id}/complete gövdesi { counterparties: [...] } · { balances: { records: [...] } } · ekstrede önce satırlar POST …/{id}/statement/rows ile ≤20.000'lik parçalar hâlinde, sonra { statement: { total_parts } }. Sunucu rehbere işler / ekstreyi arka planda ayrıştırıp sihirbaz kartına koyar / taslak kampanyayı hazırlar ve talebi tamamlar; dönem ve cari talepten türetilir (başlık düşünmezsiniz). Yanıt 200 { data, delivery }.
5. Veri hazırlanamıyorsa (cari yok, ERP kapalı…) → POST /erp-requests/{id}/fail { reason }; sebep panelde görünür. `fail` yalnız verinin üretilemediği kalıcı iş hataları içindir. Teslimat 400/402/413/422 ile reddedilirse talep zaten failed olur ve sebep panelde görünür (aynı veriyi yeniden göndermeyin, fail çağırmaya gerek yok); 429/5xx ve ağ hatası gibi geçici durumlarda rezervasyon pending'e döner — fail ÇAĞIRMAYIN, aynı Idempotency-Key ile sonraki turda yeniden deneyin (Retry-After varsa ona uyun). Yoklama döngüsü ağ hatasından sonra yaşamaya devam etmeli; claim yanıtı 200 değilse (başka program aldı, süresi doldu) talebi atlayın.

Uçların tam tanımı bu gruptaki dört uç sayfasında (Bekleyen Talepleri Yoklama ile başlayın), gövde biçimleri Veri biçimleri sayfasındadır.

Akış