Gönderi oluşturma

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

Amaç

Hesap sahibi adına bir gönderi taslağı yazmak. Kayıt hesap sahibinin tenant'ına düşer, iş ortağının değil.

Aynı denetleyici

Bu beş uç /api/v1in gönderi uçlarıyla aynı denetleyiciye bağlıdır (DEC-345: kopyalama değil montaj). İkinci bir iş mantığı yazılmadı ve bu mekanik olarak bağlıdır - gönderi oluşturma montaj satırı rota tablosunda tam iki kez geçer (biri v1, biri iş ortağı grubunda): Bir finansal uçta ikinci bir kod yolu açmak, iki yolun zamanla sessizce ayrışması demektir.

Yetki

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

Bu uç PARA HAREKETİ YAPMAZ

carrier_account_id alanı gövdede YOKKEN taşıyıcıya sıfır istek gider, ücret kesilmez ve gönderi DRAFT doğar; para yalnız onayda (PA-40) çıkar. Alan GÖNDERİLDİĞİNDE sözleşme /api/v1 PA-03 ile birebir aynıdır (aynı denetleyici): bayi taşıyıcıda İPUCU olarak okunur ve gönderi tek çağrıda CREATED doğar (ücret PA-43 etiket anında kesilir), kendi-hesap modeline açık taşıyıcıda ise AÇIK SEÇİMDİR ve gönderi hesap sahibinin kendi taşıyıcı hesabıyla çıkar - Sevkora hiçbir aşamada ücret almaz (DEC-363). Sevk edilemez (doğrulanmamış ya da devre dışı) bir satır 422 alır ve bayi yoluna DÜŞMEZ.

Başarı 201

oluşturulan gönderi. Alan kümesi ve doğrulama kuralları /api/v1 ile aynıdır (PA-01).

İstek

warehouse_id (hesabın kendi adresi olmalıdır - başka tenant'ın adresi 422 döner, çünkü kural tenant'a karşı sorgular), buyer_name, buyer_phone, buyer_address (asgari 10 karakter), buyer_city, buyer_district ve en az bir parcels satırı zorunlu.

KİŞİSEL VERİ

bu uç alıcı verisini yazar (buyer_name, buyer_phone, buyer_address ve şehir/ilçe). İş ortağı bu alanları PA-30 ve PA-31'den zaten okuyordu; dalga 1b yazma yönünü de açar. Veri sahibi hesap sahibi değil üçüncü taraftır; ayrıntı 10-security "İş ortağının eriştiği kişisel veri yüzeyi" bölümündedir.

Hatalar

422 (doğrulama; Idempotency-Key eksikse de 422), 409 (aynı anahtar farklı gövde); ayrıca 401, 403, 429.

Idempotency-Key

ZORUNLUDUR ve sözleşme /api/v1 ile aynıdır (PA-03, aynı ara katman). Anahtarın kapsamı tenant'tır, iş ortağı değil: aynı iş ortağının açtığı iki farklı müşteri aynı anahtarı kullanabilir ve biri ötekinin yanıtını almaz.

curl -X POST "{{host}}/api/partner/v1/shipments" \
  -H "Accept: application/json" \
  -H "X-App-Key: SEVKORA_UYGULAMA_ANAHTARINIZ" \
  -H "Authorization: Bearer SEVKORA_API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ISTEMCI_URETIMI_BENZERSIZ_DEGER" \
  -d '{"warehouse_id":"ADRES_ULID","buyer_name":"Ayşe Yılmaz","buyer_phone":"05321234567","buyer_address":"Örnek Mah. Deneme Sok. No:5","buyer_city":"İstanbul","buyer_district":"Kadıköy","parcels":[{"desi":2.5,"content":"Kitap"}]}'