Etiket çıktısı

> Künye: TASK-395; REQ-021 KK-7, DEC-351, DEC-043, DEC-284, DEC-346.

BU UÇ PARA KESER

ve iş ortağı yüzeyindeki ikinci para kesen uçtur (birincisi PA-40 onayıdır). Ücret, taşıyıcının etiket çağrısından önce kesilir (strict-prepaid, DEC-043).

Amaç

Onaylanmış gönderinin taşıyıcı etiketini almak. format zorunlu sorgu parametresidir (pdf, zpl, png, jpeg); varsayılan biçim bilerek yoktur.

Aynı denetleyici

/api/v1in PA-06 ucuyla aynı denetleyiciye bağlıdır (DEC-351: kopyalama değil montaj); montaj satırı rota tablosunda tam iki kez geçer

Yetki

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

ONAYDAN SONRA ALINAN ETİKET İKİNCİ KEZ ÜCRET KESMEZ

PA-40 zaten bir ücret kesmişse etiket aynı kesintiyi yeniden kullanır; iş ortağı aynı etiketi defalarca isteyebilir ve hesap sahibinin cüzdanı bir kez daha eksilmez.

KENDİ HESABI GÖNDERİSİNDE BU UÇ HİÇ ÜCRET KESMEZ

(DEC-363) ve desi sorgu parametresini kabul etmez: gönderilirse değerine bakılmadan 422 errors.desi döner. Yanıttaki charge alanı null'dır. Gerekçe PA-06 ile birebir aynıdır: alanın buradaki tek işi ücreti üretmekti ve ücret yoktur.

Taşıyıcı etiket üretemezse ücret GERİ ALINIR

(net-sıfır, DEC-044): yalnız bu istekte kesilen ücret iade edilir; ayakta duran önceki bir kesinti iade edilmez.

Yetersiz bakiye FAIL-CLOSED'dır

422 döner, etiket üretilmez, taşıyıcıya sıfır istek gider ve cüzdan değişmez.

Başarı 200

data.format, data.content_base64, data.per_parcel ve data.charge (net ücret fee_minor, KDV bileşenleri, cüzdandan düşen total_minor, para birimi, tarife sürümü). Ücretin kesildiği fiilin kendi zarfında okunur.

Hatalar

422 (yetersiz bakiye, fiyatlanamaz gönderi, kapalı durum, geçersiz format), 404 (başka tenant'ın gönderisi), 502 (taşıyıcı etiket üretemedi - ücret iade edilmiştir); ayrıca 401, 403, 429.

Idempotency-Key

sözleşmesi yoktur; tekrarlanan çağrı ayakta duran kesintiyi yeniden kullandığı için zaten ikinci bir ücret doğurmaz.

Neden şimdi açıldı

DEC-284 bu ucu dışarıda bırakmıştı ve gerekçesi "etiket alıcı bilgisi taşır" idi. O gerekçe DEC-346 ile ölçümle çürüdü: aynı yedi alıcı alanı PA-30 listesinden ve PA-31 detayından zaten dönüyordu. Geriye kalan tek fark ucun para kesmesiydi ve PA-40 o eşiği geçti; aynı kelepçeler burada da uygulanır.

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