Ana içeriğe atla
PUT

Ne yapar?

status=false varsayılan POS ve firma tahsilat özelliğini pasifleştirir; başvuru veya Idempotency-Key gerekmez. Diğer çağrılarda Idempotency-Key ve OWNER_NAME,OWNER_SURNAME,OWNER_IDENTITY_NUMBER,GSM,BANK_NAME,IBAN zorunludur. Başvuru kabulünden sonra hesap onaysız/aktif duruma alınır. Sağlayıcı kabulü nihai POS onayı değildir. İşlem takibi: yanıttaki operation makbuzunu saklayın; replayed=true cevabı ilk yanıtın bütün içeriğini tekrar etmez.

Ön koşullar ve izin

Etkin API anahtarı ve muhasip:pos:write izni gerekir. İlişkili kayıtlar aynı firmaya ait olmalıdır. Erişim ayarları için kimlik ve izinler rehberini inceleyin. İşlem anahtarı: status=false dışındaki başvuru/etkinleştirmede zorunlu. Aynı işlem için aynı anahtarı kullanın; örnekler MUHASIP_IDEMPOTENCY_KEY ortam değişkenini kullanır. İstek ve cevap şemalarını indirin.

İstek örnekleri

Örnekler temsilîdir. Kimlikleri, belge tarihlerini ve iş verisini kendi yetkili kayıtlarınızla değiştirin. Node.js örnekleri Node.js 20 veya üzeri içindir; PHP örnekleri cURL uzantısını kullanır. Hiçbiri otomatik tekrar yapmaz.

Cevabı değerlendirin

Önce HTTP durumunu, ardından bu kaynağın status ve sonuç alanlarını değerlendirin. Bütün uçlar aynı sonuç zarfını veya oluşturma için 201 kodunu kullanmaz. Temsilî başarılı cevap; gerçek hizmet çağrısından alınmamıştır:

Hata durumunda

Ağ kesintisi, zaman aşımı veya JSON olmayan cevap mali etkinin oluşmadığını kanıtlamaz. Ham istek/cevapları genel loglara yazmayın. Hata yönetimi

Sonraki adım

İşlem makbuzunu saklayın; durum adresinden kontrol edin ve sonuç kimliklerini ilgili belge/tahsilat/siparişle eşleştirin. reviewRequired=true ise yeniden göndermeden manuel inceleyin. Kaynak akışı · İşlem takibi · Kapsam ve sınırlamalar

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

status=false dışındaki başvuru/etkinleştirmede zorunlu.

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

Sorgu Parametreleri

status
string

Yalnız false kapatır; yok/true başvuru/güncelleme yapar.

Gövde

application/json

status=false ile kapatmada gövde gerekmez. Başvuruda aşağıdaki altı alanın tamamı boş olmayan string olmalıdır.

OWNER_NAME
string

Yetkilinin adı.

Minimum string length: 1
OWNER_SURNAME
string

Yetkilinin soyadı.

Minimum string length: 1
OWNER_IDENTITY_NUMBER
string

Yetkili kimlik numarası; örnekte yer tutucu kullanılmıştır.

Minimum string length: 1
GSM
string

Telefon.

Minimum string length: 1
BANK_NAME
string

Banka adı.

Minimum string length: 1
IBAN
string

Tahsilat hesabı IBAN değeri.

Minimum string length: 1

Yanıt

İşlem sonucu.

İlk çağrı kaynağa özgü yanıtı ve işlem makbuzunu; tamamlanmış tekrar yalnız güvenli makbuzu ve uygun sonuç kimliklerini döndürür.

status
boolean
operation
object
operations
object[]
replayed
boolean