Dört bölme servisi
| Servis | Alt yol | Gövde | Ne yapar |
|---|---|---|---|
| splitShipmentPackage | /split | orderLineIds: [kalem kimlikleri] | Verilen kalemleri ayrı pakete alır |
| multiSplitShipmentPackage | /multi-split | splitGroups: her grupta orderLineIds | Tek istekte birden çok paket oluşturur |
| splitShipmentPackageByQuantity | /quantity-split | quantitySplit: orderLineId ve quantities dizisi | Bir kalemin adetlerini paketlere böler |
| splitMultiPackageByQuantity | /split-packages | splitPackages: her pakette packageDetails (orderLineId, quantities) | Kalem ve adeti birlikte vererek paket kurar |
Gövde örnekleri
- split: orderLineIds: [KALEM_1]. Belirtilen kalem yeni pakete taşınır.
- multi-split: splitGroups içinde [3, 5, 6] ve [7, 8, 9] kalem grupları. Doküman örneğinde bu istek üç paket üretir: iki grup için birer paket ve kalan kalemler için bir paket.
- quantity-split: quantitySplit içinde orderLineId: KALEM_1, quantities: [2, 2]. Dört adetlik kalem ikişer adetlik iki pakete bölünür.
- split-packages: splitPackages içinde packageDetails ile orderLineId ve quantities çiftleri. İstekte dışarıda bıraktığınız ürünler ayrı ve yeni bir pakette oluşur.
multi-split kullanırken paketteki bütün kalemleri gruplara yazmayın. Kalan kalemler için sistem zaten otomatik bir paket oluşturur.
Bölmeden sonra
Bölme asenkron çalışır. İstek başarılı döndükten hemen sonra yeni paketler hazır olmayabilir. Mevcut paket UnPacked statüsüne geçer; aynı orderNumber altında yeni shipmentPackageId ve cargoTrackingNumber değerleri oluşur. Yeni paketlerin createdBy alanı split olarak gelir.
Yeni paket bilgilerini sipariş paketlerini çekme servisinden (status=UnPacked ile eski paketi, orderNumber ile yenileri) ya da webhook'tan alın. Statü, etiket ve fatura işlemlerini yeni paket kimlikleriyle yapın; eski kimliğe istek göndermeyin.
Ne zaman bölmeli?
- Ürünler farklı depolardan çıkıyorsa her depo için ayrı paket.
- Bir ürün hazır, diğeri birkaç gün sonra gelecekse hazır olanı hemen göndermek için.
- Koli boyutu ya da ağırlığı tek pakete sığmıyorsa.
Bir ürünü hiç gönderemeyecekseniz bölme yerine tedarik edememe bildirimi doğru işlemdir. Bölme yalnız gönderimi parçalara ayırır; ürünü iptal etmez. Her yeni paket ayrı bir kargo gönderisi olduğu için kargo maliyetini de hesaba katın.
Limit ve sık hatalar
Her bölme yolu ayrı limitlenir: en düşük iki kademede dakikada 100, 150.000 ürün kademesinde 200 istek; 500.000 ürün ve üzerinde sınır yoktur.
| Belirti | Neden | Çözüm |
|---|---|---|
| 400 | Kalem kimliği pakette yok | orderLineId değerlerini paketin lines dizisinden alın |
| Yeni paket görünmüyor | Bölme asenkron | Kısa süre sonra siparişi yeniden çekin |
| Statü isteği eski pakette hata veriyor | Paket UnPacked oldu | Yeni paket kimliğini kullanın |
Sık sorulanlar
Trendyol'da sipariş paketi nasıl bölünür?
Kalemleri ayırmak için POST .../shipment-packages/{packageId}/split servisine orderLineIds gönderin. Birden çok paket için multi-split, adet bölmek için quantity-split ya da split-packages kullanılır.
Bölmeden sonra eski paket ne olur?
Mevcut paket UnPacked statüsüne geçer. Aynı sipariş numarası altında yeni paket kimlikleri ve kargo numaraları oluşur.
Bölme sonucu hemen görünür mü?
Hayır. Yeni paketler asenkron oluşur. Kısa bir süre sonra sipariş servisinden ya da webhook'tan yeni paketleri okuyun.
Bir kalemin adetlerini iki pakete ayırabilir miyim?
Evet. quantity-split servisinde orderLineId ve quantities dizisi gönderin; örneğin [2, 2] dört adetlik kalemi ikişer adetlik iki pakete böler.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı