Trendyol API · Sipariş

Trendyol sipariş paket statüleri ve sipariş akışı

Trendyol'da her sipariş paketi bir statü taşır: yeni paket Created, toplanan paket Picking, faturası kesilen Invoiced, kargoya verilen Shipped, teslim edilen Delivered olur. Satıcı API ile yalnız Picking ve Invoiced statülerini besleyebilir; diğerlerini sistem otomatik atar. İptal, tedarik edememe ve paket bölme durumlarında paket bozulur ve aynı sipariş numarası altında yeni paket oluşur.

Statüler ve anlamları

StatüAnlamıKim atar
AwaitingPaket henüz kesinleşmedi; yalnız stok işlemi için kullanılmalıSistem
CreatedPaket oluştu, hazırlanmayı bekliyorSistem
PickingSatıcı toplamaya başladı; panelde "Sipariş İşleme Alınmıştır" görünürSatıcı
InvoicedFatura kesildi bilgisi beslendi (isteğe bağlı adım)Satıcı
ShippedPaket kargoya verildiSistem
AtCollectionPointPaket kargo firmasının dağıtım ya da teslim noktasındaSistem
DeliveredPaket teslim edildiSistem
UnDeliveredPaket teslim edilemedi, kargonun dağıtım merkezine döndüSistem
ReturnedPaket geri gönderildiSistem
CancelledPaket iptal edildiSistem
UnSuppliedSatıcı tedarik edemediğini bildirdiSistem, satıcının bildirimiyle
UnPackedPaket bölündü; yerine yeni paketler oluştuSistem
VerifiedStatü listesinde yer alır; dokümanda ayrıca açıklanmazSistem

Temel akış

Trendyol'un sipariş süreci akışına göre olağan yol şöyledir: paket oluşur (Created), satıcı paketi çeker, Picking besler, isteğe bağlı olarak Invoiced besler ve mevcut shipmentPackageId ile cargoTrackingNumber kullanarak gönderimi yapar. Sonraki statü değişikliklerini sipariş servisinden ya da webhook'tan izler.

TEX ya da Aras Kargo ile "Trendyol öder" gönderilerde etiket ortak etiket servisinden alınır. Diğer kargo firmalarında etiket ilgili kargo firmasından alınır.

Paketin bozulduğu üç durum

  • Kısmi iptal ya da kısmi tedarik edememe: mevcut paket Cancelled olur; aynı orderNumber altında yeni shipmentPackageId ve yeni kargo barkodu oluşur.
  • Paketin tamamı iptal: paket Cancelled olur, yeni paket oluşmaz.
  • Paket bölme: mevcut paket UnPacked olur; aynı orderNumber altında yeni paketler ve kargo numaraları oluşur.

Yeni paketin nereden geldiğini createdBy alanı söyler: order-creation doğrudan siparişten, cancel kısmi iptalden, split bölmeden, transfer ise Trendyol'un siparişi başka satıcıya yönlendirmesinden oluşan pakettir.

Bu yüzden paket kimliğini kalıcı anahtar gibi kullanmayın. Siparişleri orderNumber ile gruplayın, paketleri her değişiklikten sonra yeniden çekin.

Webhook'taki statü adları

Webhook aboneliğinde statüler büyük harfle ve alt çizgiyle yazılır: CREATED, PICKING, INVOICED, SHIPPED, CANCELLED, DELIVERED, UNDELIVERED, RETURNED, UNSUPPLIED, AWAITING, UNPACKED, AT_COLLECTION_POINT, VERIFIED. Sipariş servisindeki karşılıkları aynı statülerin büyük-küçük harfli yazımıdır.

Statü eşlemesini tek bir tabloda tutun ve bilinmeyen bir statü geldiğinde loglayın. Trendyol listeye yeni statü eklediğinde webhook aboneliğinize otomatik eklenir; kodunuz bunu sessizce yok saymamalıdır.

Sık sorulanlar

Trendyol'da hangi statüleri ben güncelleyebilirim?

Yalnız Picking ve Invoiced. Önce Picking, sonra isteğe bağlı olarak Invoiced beslenir. Diğer statüler sistem tarafından otomatik atanır.

Awaiting statüsündeki siparişi kargolayabilir miyim?

Hayır. Doküman Awaiting paketlerin yalnız stok işlemleri için kullanılmasını, kargoya verilmemesini ister; bu paketler iptal olabilir.

UnPacked ne demek?

Paketin bölündüğünü gösterir. Mevcut paket UnPacked olur ve aynı sipariş numarası altında yeni paketler oluşur.

Kısmi iptalden sonra neden yeni paket kimliği geldi?

Bir paketteki kalemlerden biri iptal edilirse orderNumber aynı kalır ama paket bozulur; yeni bir shipmentPackageId ve kargo barkodu oluşturulur.

İptal edilen siparişleri nasıl çekerim?

Sipariş paketlerini çekme servisinde status parametresine Cancelled ve UnSupplied değerlerini verin. Bölünen paketler için UnPacked kullanılır.

Kaynaklar

İlgili Trendyol API konuları

Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı

Trendyol entegrasyonunu kod yazmadan kurun

Saystok bu API'lerle stok, sipariş ve fiyatı sizin yerinize eşitler. 30 gün ücretsiz.