biHesapbiHesap
Endpoint'ler

Hangi olayları gönderirsiniz, hangi referansı okursunuz?

Ingestion: satış, ödeme, satın alma, gider gönderir. Read: ürün, müşteri, tedarikçi, hesap eşleştirmelerinizi okur.

Tam OpenAPI referansı

Ingestion · POST

Olayları biHesap'a gönderirsiniz

Bu uç noktalar mutating'dir — biHesap-api'de invoice / stock movement / cari hareketi / kasa hareketi yaratırlar. Hepsi idempotent: (sourceId, externalId) çifti DB-unique.

  • POST/api/integrations/v1/sales
    Satış kaydet
    → partner.sale.recorded

    Satış event'ini partner sisteminden biHesap'a gönderir. lines + customerExternalId zorunlu, amount minor unit.

  • POST/api/integrations/v1/payments
    Ödeme kaydet
    → partner.payment.recorded

    Tahsilat veya ödeme event'i. INBOUND/OUTBOUND yön, accountId hedef hesap, customerId/supplierId karşı taraf.

  • POST/api/integrations/v1/purchases
    Alış faturası kaydet
    → partner.purchase.recorded

    Tedarikçiden gelen alış event'i. supplierExternalId + lines (ürün/miktar/birim fiyat).

  • POST/api/integrations/v1/expenses
    Gider kaydet
    → partner.expense.recorded

    Kira, fatura, yakıt gibi gider event'leri. Ürün kataloğu bağı yok; description + amount + opsiyonel kategori.

Read · GET

Referans verisi ve eşleştirmeler

Ürün, müşteri, tedarikçi ve hesap kataloğunu okuyarak event payload'larında doğru biHesap kimliklerini kullanırsınız. Event audit'i de bu yüzeyden gelir.

  • GET/api/integrations/v1/products
    Ürünler

    biHesap'ta tanımlı ürünlerin partner-side eşleşmeleri. productId değerlerini bu listeden alın.

  • GET/api/integrations/v1/customers
    Müşteri eşleştirmeleri

    customerExternalId ↔ biHesap customerId eşlemesi. Yeni müşteri görüldükçe partner-api otomatik kayıt ve eşleştirme yapar.

  • GET/api/integrations/v1/suppliers
    Tedarikçi eşleştirmeleri

    supplierExternalId ↔ biHesap supplierId eşlemesi. Alış ve gider event'leri için referans.

  • GET/api/integrations/v1/accounts
    Kasa / banka hesapları

    Ödeme event'lerinde accountId değeri olarak kullanılan biHesap hesap kataloğu.

  • GET/api/integrations/v1/events
    Event audit (90g)

    Gönderdiğiniz event'lerin durumunu (queued, published, dead) ve gecikmesini izleyin. 90 günlük retention.

Önceki: Kimlik doğrulamaSonraki: Event kataloğu