İş ortağı yüzeyi sözleşmesi Gönderi işlemleri PA-41

Ölçü düzeltmesi

PATCH/api/partner/v1/shipments/{id}

> Künye: TASK-392; REQ-021 KK-7, DEC-345, DEC-316, DEC-350.

Amaç

Toplama öncesinde gönderinin ölçüsünü düzeltmek ve düzeltmeyi taşıyıcıya iletmek.

BU UÇ BİR KISMİ GÜNCELLEME DEĞİLDİR

ve adı yanıltabilir: alıcı, adres ya da içerik alanları burada değiştirilemez. Yalnız desi ve parcel_count okunur, ikisi de zorunludur, ve istek taşıyıcının updateShipment işlemine iner.

Onaydan SONRA çalışır

taşıyıcı hesabı olmayan bir taslakta 422 döner ("gönderinin taşıyıcı hesabı yok"). Yani entegrasyon sırası PA-38 -> PA-39 -> PA-40 -> PA-41'dir; taslağı düzenlemek isteyen iş ortağı onu iptal edip yeniden oluşturur. Bu sınır ölçüldü ve bilinçli olarak korundu (DEC-350): ucu taslakta da çalışır hâle getirmek /api/v1in yayımlanmış sözleşmesini değiştirirdi ve bugünkü tüketicileri etkilerdi.

Değerler koli tablosuyla mutabık olmak ZORUNDADIR (DEC-316)

gönderi desisi kolilerinden türer; çelişen değer sessizce yok sayılmaz, adıyla reddedilir.

Yetki

İki kademeli kimlik: X-App-Key + Authorization: Bearer. Hesap anahtarı partner-api yeteneği taşır ve tek başına /api/v1e giremez.

Başarı 200

güncellenmiş gönderi detayı.

Hatalar

404 (başka tenant'ın gönderisi), 422 (doğrulama, çelişen desi, toplama sonrası durum, taşıyıcı hesabı yok), 409 (taşıyıcı updateShipment desteklemiyor); ayrıca 401, 403, 429.

Idempotency-Key

sözleşmesi yoktur ve bu /api/v1 ile aynıdır; ölçü düzeltmesi bir para hareketi değildir.

kabuk

curl -X PATCH "{{host}}/api/partner/v1/shipments/GONDERI_ULID" \
  -H "Accept: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{"desi":2.5,"parcel_count":1}'