Test siparişi türleri
| Senaryo | Gövdede ne değişir |
|---|---|
| Bireysel sipariş | Örnek gövde olduğu gibi gönderilir |
| Kurumsal faturalı sipariş | commercial: true; invoiceAddress altında company, invoiceTaxNumber ve invoiceTaxOffice doldurulur |
| Azerbaycan mikro ihracat | microRegion: AZ |
| Körfez (GULF) mikro ihracat | microRegion: GULF |
Test ortamına erişim IP yetkilendirmesi ister. Önce canlı ve test ortamı sayfasındaki adımları tamamlayın.
Uçtan uca test akışı
| Adım | İşlem | Servis |
|---|---|---|
| 1 | Test siparişi oluşturun | POST /integration/test/order/orders/core |
| 2 | Paketi çekin | GET /integration/order/sellers/{sellerId}/v2/orders |
| 3 | Toplamaya başlandı bildirin | PUT .../shipment-packages/{packageId} (status: Picking) |
| 4 | Fatura kesildi bildirin | PUT .../shipment-packages/{packageId} (status: Invoiced) |
| 5 | Kargo statülerini ilerletin | PUT /integration/test/order/sellers/{sellerId}/shipment-packages/{packageId}/status |
| 6 | İade testini hazırlayın | PUT /integration/test/order/sellers/{sellerId}/claims/waiting-in-action |
| 7 | İadeyi onaylayın ya da ret talebi açın | İade servisleri |
Test statü güncelleme kuralları
Test statü servisi siparişi Shipped, AtCollectionPoint, Delivered, UnDelivered ya da Returned durumuna taşır. Gövdede lines dizisi (lineId ve quantity), params nesnesi ve status alanı bulunur. Başlıkta SellerID gönderilir.
- Statüler sırayla ilerler; Delivered olan bir paket Shipped ya da AtCollectionPoint durumuna geri çekilemez.
- Servis yalnız stage ortamında çalışır.
- İade testinde, müşteri iadesi oluşturulduktan sonra waiting-in-action servisiyle iade WaitingInAction statüsüne çekilir. Onay ve ret yalnız bu statüde yapılabilir.
Test müşteri sorusu
Soru-cevap entegrasyonunu denemek için stage ortamında POST /integration/qna/sellers/{sellerId}/questions ile ürün sorusu açılabilir. Zorunlu alanlar text, contentId, userId ve showUserName'dir; userFullName ve channelId isteğe bağlıdır. Doküman channelId için 1 gönderilebileceğini belirtir.
Oluşan soruyu müşteri sorularını çekme servisiyle okuyup cevaplama akışını uçtan uca test edebilirsiniz.
Sık hatalar ve çözümleri
Test ortamındaki hataların çoğu erişim ve sıra kurallarından gelir. Aşağıdaki tablo en sık karşılaşılan durumları özetler.
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 503 Service Unavailable | Sunucu IP'si test ortamı için yetkili değil | IP'yi whitelist'e ekleyin ya da bildirim açın |
| 401 Unauthorized | Canlı anahtarlar ya da başka satıcının bilgileri kullanılmış | Test hesabının API bilgileriyle ve SellerID başlığıyla aynı satıcıyı kullanın |
| Statü güncellemesi reddediliyor | Statü geri alınmaya ya da atlanmaya çalışılıyor | Shipped, AtCollectionPoint, Delivered sırasını izleyin |
| İade onayı çalışmıyor | İade WaitingInAction statüsünde değil | Önce waiting-in-action test servisini çağırın |
| Canlıda test çağrısı hata veriyor | Test servisleri canlıda yok | Test çağrılarını yalnız stage yapılandırmasında çalıştırın |
Test senaryolarınızı her sürüm değişikliğinde yeniden koşun. Trendyol sipariş ve ürün modellerine sık alan ekliyor; örneğin 2026'da sipariş modeline paymentMethod alanı eklendi. Yeni alanlar test siparişlerinde de görünür.
Sık sorulanlar
Canlı ortamda test siparişi oluşturabilir miyim?
Hayır. Test siparişi servisi yalnız stage ortamında (stageapigw.trendyol.com) çalışır ve IP yetkilendirmesi gerektirir.
Test siparişinde SellerID nereye yazılır?
İsteğin başlığına (header) SellerID olarak yazılır. Değer, kullandığınız test satıcısının ID'si olmalıdır ve Basic Auth da aynı satıcının bilgileriyle yapılır.
Test paketini Delivered yaptıktan sonra geri alabilir miyim?
Hayır. Test statüleri sırayla ilerler; Delivered olan bir paket Shipped ya da AtCollectionPoint statüsüne geri çekilemez.
Kurumsal faturalı test siparişi nasıl oluşturulur?
Gövdede commercial alanını true gönderin ve invoiceAddress altında company, invoiceTaxNumber ve invoiceTaxOffice alanlarını doldurun.
Test iadesini nasıl onaylanabilir hâle getiririm?
İade oluşturulduktan sonra stage ortamındaki waiting-in-action test servisini çağırın. İade WaitingInAction statüsüne geçince onay ya da ret talebi servislerini deneyebilirsiniz.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı