Fiyat teklifi

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

Amaç

Taslak için taşıyıcı adaylarının fiyatlarını okumak. Onaydan önceki karar adımıdır.

Yetki

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

Yan etkisizdir (CQS)

okuma hiçbir şey değiştirmez, ücret kesmez.

Başarı 200

aday listesi PA-18 ile AYNI gövdedir (aynı projeksiyon): her aday (carrier_code, account_model) çiftidir; fiyatlı bayi adayları ucuzdan pahalıya (her biri vat_rate_percent ve price_incl_vat_minor ile: KDV dahil toplam sunucuda türetilir, TASK-442), ardından hesap sahibinin kendi-hesap adayları (account_model=own_account, price_minor/currency/policy_version/ vat_rate_percent/price_incl_vat_minor null, billing_mode=carrier_direct, carrier_account_id dolu - DEC-363/365); meta.cheapest_carrier_code fiyatlı sıranın başını verir, fiyatlı aday yoksa null'dır ve PA-40 auto o an seçilemez.

Teklif bir GÖSTERGEDİR, otorite onaydadır

PA-40'ın auto seçimi fiyatı sunucuda taze hesaplar; iki çağrı arasında tarife değişirse kesilen ücret teklifte görülenden farklı olabilir.

Yalnız TASLAK gönderi için

onaylanmış gönderinin fiyatı artık bir teklif değil kesilmiş bir ücrettir; bu durumda uç 422 döner.

Hatalar

404 (başka tenant'ın gönderisi de biçimsiz kimlik de 404'tür; IDOR - varlık sızdırılmaz), 422 (taslak olmayan gönderi ya da hiçbir adayın fiyatlanamaması); ayrıca 401, 403, 429.

Idempotency-Key

sözleşmesi yoktur (salt-okuma).

curl -X GET "{{host}}/api/partner/v1/shipments/GONDERI_ULID/quotes" \
  -H "Accept: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ"