Ana içeriğe atla
PATCH
Bu çağrı kayıt değiştirir. Idempotency-Key zorunludur. Güncel version değerini If-Match başlığında çift tırnakla gönderin. Zaman aşımından sonra yeni anahtarla tekrar başlatmadan işlem durumunu okuyun.

Ne yapar?

Yalnız gönderilen kart alanlarını günceller. Cari mali hareketleri ve bakiyeleri değişmez. Aktif ve varsayılan olmayan kart gerekir.

Ön koşullar ve izin

Gereken izin: muhasip:contacts:write. Bu kaynak için açık izin tanımlanmalıdır; genel erişim veya yönetici yetkisi bu iznin yerine geçmez. İlişkili bütün kimlikler aynı firma kapsamında olmalıdır. Yeni mali kayıt için kullanılan cari, kasa veya hesap aktif olmalıdır. Ürün/depo kimlikleri verilirse geçerli, aynı firmaya ait ve yeni işlem için aktif olmalıdır. Kimlik ve izinler · Muhasebe veri kuralları

İstek örnekleri

Kimlikleri kendi kayıtlarınızla değiştirin. Yazmada iş niyetine özel anahtarı istekten önce saklayın; örnek anahtarını farklı işler için yeniden kullanmayın. Alan ve cevap tanımları bu sayfanın API referansında yer alır.

Cevabı değerlendirin

Aşağıdaki cevap temsilîdir.
İlk başarılı çağrı result ile kayıt sonucunu ve operation ile makbuzu döndürür. Aynı iş anahtarıyla tamamlanmış tekrar 200 ve replayed:true döndürür; ilk ayrıntı gövdesi tekrarlanmaz. Sonuç kimliğiyle ilgili okuma ucunu kullanın. reviewRequired:true sonucunu başarılı mali işlem kabul etmeyin.

Hata durumunda

Hata yönetimi · İşlem takibi

Sonraki adım

Cari entegrasyonunu tamamlayın. Mali sonucu bakiye ve ekstre okumalarıyla kontrol edin.

Yetkilendirmeler

Authorization
string
header
gerekli

Kullanıcı adı apiUserId, parola secretKey. Aktif ve süresi geçmemiş API kullanıcısı ve uygun firma gerekir.

Başlıklar

Idempotency-Key
string
gerekli

Her yeni iş niyeti için kalıcı, farklı anahtar. Aynı anahtar+işlem+firma ve farklı içerik 409 üretir; tamamlanmış tekrar 200 replay makbuzu döner.

Required string length: 1 - 128
Pattern: ^[!-~]+$
If-Match
string
gerekli

Güncel version çift tırnakla gönderilir; örneğin "0". Açılış iptalinde açılış hareketinin, transfer iptalinde source hareketin sürümüdür.

Pattern: ^"[0-9]{1,10}"$

Yol Parametreleri

id
string
gerekli

Kaynak kimliği. Transferde kaynak hareket/transfer kimliği. 24 karakterli kayıt kimliği.

Pattern: ^[a-f0-9A-F]{24}$

Gövde

application/json
name
string

Cari unvanı veya adı.

Required string length: 1 - 250
code
string

Cari kodu.

Maximum string length: 150
type
enum<string>

Varsayılan company.

Mevcut seçenekler:
company,
person
isCustomer
boolean

Varsayılan true; müşteri/tedarikçi sınıflaması, işlem yönünü zorlamaz.

phone
string
Maximum string length: 150
email
string

Boş veya geçerli e-posta.

Maximum string length: 150
taxId
string

Boş veya 10/11 rakam; yabancı caride boş bırakılabilir.

Pattern: ^(?:|[0-9]{10,11})$
taxOffice
string
Maximum string length: 150
countryCode
string

Varsayılan TR.

Pattern: ^[A-Z]{2}$
country
string
Maximum string length: 150
stateCode
string
Maximum string length: 150
state
string
Maximum string length: 150
city
string
Maximum string length: 150
address
string
Maximum string length: 2000
isAbroad
boolean

Varsayılan false.

Yanıt

İşlem tamamlandı. Yazma cevabındaki operation makbuzunu saklayın.

status
enum<boolean>
gerekli
Mevcut seçenekler:
true
result
object
gerekli
operation
object
gerekli