Talep ile Aktarım
Bekleyen Talepleri Yoklama(listErpRequests)
GET/erp-requests
Bekleyen talepleri yokla
Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0
ERP programınız 20–30 saniyede bir çağırır. Açık talepler (pending + in_progress, süresi geçmemiş) en eski önce; anahtarın kapsam ailesine göre süzülür (ör. yalnız statements:* kapsamı olan anahtar statement taleplerini görür). Firma yöntemi "Talep ile aktarım" değilse boş liste; fetch_mode firmanın seçili yöntemini söyler (request değilse talep hiç gelmez — panelden değiştirilmeli). ?status=all son talepleri de verir. Anahtar başına dakikada 12 çağrı üstü 429 (Retry-After).
Servis
| Metot | GET |
| Adres | https://mutabakat.ai/api/v1/erp-requests |
| Kapsam | Geçerli bir anahtar yeterlidir |
| Idempotency-Key | Kullanılmaz |
| dry_run | Yok |
İstek Parametreleri
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| status (sorgu) | "open" | "all" | Hayır | open (varsayılan) | all |
| limit (sorgu) | integer | Hayır | all için ≤100 |
Yanıt
200Talepler
| Alan | Tür | Açıklama |
|---|---|---|
| data | ErpRequest[] | |
| data[].id | string | Talep kimliği (uuid). claim / complete / fail yollarında kullanılır. |
| data[].kind | "counterparties" | "statement" | "balances" | counterparties: tüm cari listesi · statement: bir carinin dönem ekstresi · balances: dönem sonu bakiyeleri |
| data[].status | "pending" | "in_progress" | "completed" | "failed" | "expired" | "cancelled" | pending → in_progress (claim) → completed | failed; süresi dolan expired, panelden iptal cancelled |
| data[].params | object | Türe göre: statement → { counterparty: { external_id, name, tax_number }, period_start, period_end, currency } · balances → { period_date, currency } · counterparties → {} |
| data[].created_at | string (date-time) | |
| data[].expires_at | string (date-time) | Oluşturma + 30 dk; claim ile en az +10 dk uzar. Süresi geçmiş talebe gönderim 409. |
| data[].claimed_at | string | null (date-time) | |
| data[].completed_at | string | null (date-time) | |
| data[].fail_reason | string | null | ERP'nin fail ile bildirdiği metin (≤300 karakter) |
| data[].scheduled | boolean | true: panelde "cari rehberini her gün ERP'den güncelle" açık olduğu için 02:00 sonrası ilk yoklamada kendiliğinden açılan counterparties talebi. İşleyiş aynıdır: claim → complete { counterparties }. |
| data[].result | object | null | completed: cari ve ekstre → { count } (işlenen cari / satır sayısı; ekstre işi muhasebe personeli sihirbazda açar) · bakiye → { campaign_id }; taslak silinmişse null |
| fetch_mode | "request" | "live" | null | Firmanın seçili "ERP'den veri getirme yöntemi": request (Talep ile aktarım — talepler bu listeye düşer) | live (Anlık bağlantı — liste hep boş) | null (henüz seçilmedi). |
| poll_after_seconds | integer | Önerilen yoklama aralığı (sn) |
| request_id | RequestId |
Hata Kodları
Bu uç için dönebilecek HTTP durumları: 400 · 401 · 403 · 429 · 500 · 503. Zarf biçimi ve kod listesi için Hata Kodları sayfasına bakın.
Örnek İstek
curl -X GET https://mutabakat.ai/api/v1/erp-requests \
-H "Authorization: Bearer $MAI_API_KEY"