Ana içeriğe atla
PUT

Ne yapar?

Siparişin bütün satırlarının durumunu Picking, Invoiced, Shipped, Delivered veya unsupplied olarak günceller. unsupplied için pozitif tam sayı reasonId zorunludur. Sağlayıcı reddinde 422, belirsiz sonuçta 502 döner. Fatura iptali yapmaz. Farklı durumlara geçiş ayrı işlemdir; aynı sipariş için eş zamanlı durum değişikliği 409 döndürebilir. İşlem makbuzunu saklayın; replayed=true ilk cevabın bütün içeriğini tekrarlamaz.

Ön koşullar ve izin

Etkin API anahtarı ve muhasip:marketplace:write izni gerekir. İlişkili kayıtlar aynı firmaya ait olmalıdır. Erişim ayarları için kimlik ve izinler rehberini inceleyin. İ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.

Yol Parametreleri

id
string
gerekli

İşlemin hedef kayıt kimliği. Muhasip kayıt kimliği; 24 onaltılık karakter.

Pattern: ^[a-fA-F0-9]{24}$

Sorgu Parametreleri

status
enum<string>
gerekli

Sağlayıcı durumu; unsupplied özel olarak tedarik edilememe isteği oluşturur.

Mevcut seçenekler:
Picking,
Invoiced,
Shipped,
Delivered,
unsupplied
reasonId
integer

status=unsupplied durumunda zorunlu pozitif tam sayı sağlayıcı neden kodu.

Gerekli aralık: x >= 1

Yanıt

İşlem tamamlandı.

İ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
gerekli

HTTP işleminin başarı durumu.

result
object
gerekli
operation
object
operations
object[]
replayed
boolean