API Dokümantasyonu & Geliştirici Portalı

1. Kimlik Doğrulama (Bearer Token)

Tüm API istekleri TLS 1.3 üzerinden yapılmalı ve istek başlığında API anahtarınız (Bearer Token) gönderilmelidir. API anahtarınızı Mutabify Yönetim Paneli > Ayarlar > API Anahtarları sekmesinden oluşturabilirsiniz.

curl -X GET "https://api.mutabify.com.tr/v1/invoices" \
  -H "Authorization: Bearer mtb_live_9f8d2e1a4b7c6..." \
  -H "Content-Type: application/json"

2. Fatura Listesi Çekme

Tedarikçilerden gelen ve eşleştirme kuyruğunda bekleyen faturaları durum filtreleriyle sorgular.

GET /v1/invoices?status=discrepancy&limit=20

Örnek Yanıt (200 OK)

{
  "status": "success",
  "data": [
    {
      "invoice_id": "inv_88201",
      "supplier_tax_id": "1234567890",
      "supplier_name": "Örnek Tedarikçi A (Metal İşleme) A.Ş.",
      "invoice_no": "DMS2026000000193",
      "total_amount": 126940.50,
      "currency": "TRY",
      "match_status": "PRICE_MISMATCH",
      "discrepancy_amount": 1240.00,
      "created_at": "2026-10-14T11:20:00Z"
    }
  ],
  "pagination": { "page": 1, "total_records": 14 }
}

3. Manuel İnceleme & Onay Tetikleme

Fark tespit edilen bir faturayı tolerans dahilinde kabul ederek ERP'ye muhasebeleştirme onayı gönderir.

POST /v1/reconciliation/approve

İstek Gövdesi (Payload)

{ "invoice_id": "inv_88201", "approved_by": "[email protected]", "action": "ACCEPT_DISCREPANCY", "reason_code": "AUTHORIZED_PRICE_INCREASE", "erp_post": true }

4. Webhooks

Fatura eşleştiğinde, fark oluştuğunda veya mükerrer kayıt tespit edildiğinde ERP veya Slack/Teams sunucunuza anlık HTTP POST bildirimi gönderilir.

invoice.matched_automatically: Fatura sipariş ve irsaliyeyle tam uyuştu.
invoice.discrepancy_detected: Kalemlerde fiyat/miktar farkı tespit edildi.
invoice.duplicate_flagged: Mükerrer fatura yakalandı.