Sipariş Paketlerini Çekme (getShipmentPackages)
Trendyol sistemine ilettiğiniz ürünler ile müşteriler tarafından verilen ve ödeme kontrolünde olan her siparişin bilgisini bu method yardımıyla alabilirsiniz. Sistem tarafından ödeme kontrolünden sonra otomatik paketlenerek sipariş paketleri oluşturulur.
Sipariş Sorgulama ve Sıralama:
- Bu servise 1 dakika içinde en fazla 1000 adet istek atabilirsiniz.
- Servise atılan isteklerde, PackageLastModifiedDate sıralamasına göre bir response alırsınız.
- suppliers/(supplierid)/orders?status=Created gibi bir query ile paket statülerine göre sorgulama yapılabilir. Kullanılabilen statüler: Created, Picking, Invoiced, Shipped, Cancelled, Delivered, UnDelivered, Returned, Repack, UnSupplied.
- Sipariş bilgilerini çekerken, ürünün createProducts ile gönderilen Barkod değerlerine göre paketleme ve işlemler yapılmalıdır.
- Maksimum 3 aylık geçmişe dönük sipariş sorgularını bu servis üzerinden yapabilirsiniz.
- Sipariş paketlerini çekme servisi üzerinden dönen "merchantSku" alanı, Product yaratma servisinde bulunan "stockCode" alanından gelmektedir. filterProducts servisi üzerinden kontrol edilebilir.
Alanlar, Veri Tipleri ve Karakter Sayıları:
- Body içindeki değerlerin karakter sayıları ve veri tipleri, sipariş sayısının doğal artışıyla birlikte değişebilir. Sisteminizi buna uygun şekilde kurmanız önerilir.
- Sipariş datasında bulunan orderNumber, Trendyol sistemindeki ana sipariş numarasını temsil eder. İlgili seviyede yer alan id değeri, oluşturulmuş Sipariş Paketini temsil eder.
- customerId, Trendyol müşteri hesabına tanımlı unique bir değerdir.
- deliveryAddressType, "Shipment" veya "CollectionPoint" olarak dönebilir. "CollectionPoint" ise sipariş teslimat noktası siparişidir.
- orderDate, Timestamp (milliseconds) formatında GMT +3 olarak iletilir. createdDate bilgileri ise GMT formatında iletilir. Convert işlemi yaparken bu bilgiye dikkat edilmelidir.
- Hızlı teslimat bilgisi için kullanılan fastDeliveryType alanı, "TodayDelivery", "SameDayShipping", "FastDelivery" değerlerini alabilir.
- Trendyol Satıcı Panelinde cargoTrackingNumber değeri için kullanılan barkod CODE128 formatındadır.
- Trendyol İhracat Partnerliği kapsamında sipariş paketlerini çekme servisimize yeni bir alan olarak 3pByTrendyol alanını ekledik. Alan boolean bir alandır. Alan değeri true olduğunda ;
- micro alanı false değer alacaktır.
- invoiceAddress datasında Trendyol’a ait şirket bilgileri yer alacak olup faturalar da buradaki bilgilere göre kesilecektir.
Sipariş Statüleri İle İlgili Bilgiler:
- Awaiting statüsündeki siparişleri sadece stok işlemleri için kullanabilirsiniz. Bu statüdeki siparişler ile ilgili farklı bir işlem yapmamanız gerekmektedir. Şu an bu statüdeki siparişler için sizlere servis cevabında gerekli veriler iletilmektedir. İlerleyen günlerde bu veriler sizlere dönmeyecektir.Bu statüdeki siparişleri kargoya teslim ettiğinizde, yaşanabilecek sipariş iptali işlemlerinin olabileceğini ve Trendyol olarak bu konuda bir sorumluluk kabul etmediklerini belirtmek isteriz.
- İptal olan siparişler için status=Cancelled,UnSupplied parametresi kullanılabilir.
- Bölünmüş siparişler için status=UnPacked parametresi kullanılabilir.
- Bir sipariş paketi içindeki bir ya da birden fazla kalem iptal edilirse, orderNumber aynı kalarak sipariş paketi bozulur ve yeni bir id değeri ve kargo barkodu oluşturulur.
Adres Bilgilerine Erişim:
-
Sipariş paketlerini çekme servisi tarafından dönen Türkiye, Azerbaycan ve GULF bölgelerinin adres alanlarının id değerlerine (city, district, neighbourhood) Adres Bilgileri Servislerinden ulaşabilirsiniz.
-
GULF Bölgesi(Suudi Arabistan, Bahreyn, Katar, Kuveyt, Birleşik Arap Emirlikleri ve Umman) siparişlerindeki adres alanları bazı durumlarda boş dönebilir. Özellikle ilçe bilgisi ile ilgili sistemlerinizde kontroller varsa kaldırmanızı rica ederiz.
Menşei Bilgisi:
- Mikro ihracat siparişlerinde oluşan paketlerde faturalara menşei bilgisi eklenmesi gerekmektedir. Menşei bilgisi “lines” alanı altından "productOrigin" datası üzerinden dönecektir.
Altın, Gübre ve Yüksek Tutarlı Siparişler:
- Altın, gübre veya 5000₺ üzeri siparişlere ait TCKN numarası "IdentityNumber" alanında iletilir.
Kurumsal Faturalı Siparişler
-
Siparişin kurumsal olup olmadığını belirlemek için sipariş datasındaki commercial değerini kontrol ediniz.
-
Eğer "commercial" değeri "true" olarak dönerse, kurumsal bir sipariş olduğunu belirtir.
-
Eğer "commercial" değeri "false" olarak dönerse, siparişin bireysel bir müşteriye ait olduğunu belirtir.
-
Kurumsal Fatura Bilgileri: Eğer sipariş kurumsal bir müşteriye aitse (commercial=true), aşağıdaki bilgileri invoiceAddress alanından alabilirsiniz:
-
"company": Kurumun adı
-
"taxNumber": Kurumun vergi numarası
-
"taxOffice": Kurumun bağlı olduğu vergi dairesi
-
E-Fatura Mükellefi Kontrolü: Kurumsal müşterinin e-fatura mükellefi olup olmadığını kontrol etmek için invoiceAddress alanındaki eInvoiceAvailable değerini kullanabilirsiniz.
-
Eğer "eInvoiceAvailable" değeri "true" ise, müşteri e-fatura mükellefidir.
-
Eğer "eInvoiceAvailable" değeri "false" ise, müşteri e-fatura mükellefi değildir.
"createdBy" aşağıdaki değerleri alabilir:
- "order-creation" -> Paket, gelen siparişle doğrudan oluşturulur
- "cancel" -> Paket, kısmi iptalden sonra oluşturulur
- "split" -> Paket, paket bölünmesine göre oluşturulur
- "transfer" -> Siparişi alan satıcının ürünü olmaması nedeniyle Trendyol tarafından başka bir satıcıya yönlendirilen siparişler.
GET getShipmentPackages
Herhangi bir tarih parametresi vermeden aşağıdaki endpoint ile istek atmanız halinde son bir hafta içerisindeki siparişleriniz sizlere gösterilecektir. startDate ve endDate parametrelerini eklemeniz halinde verilebilecek maksimum aralık iki hafta olacaktır.
Önerilen Endpoint
Servis Parametreleri
| Parametre | Parametre Değer | Açıklama | Tip |
|---|---|---|---|
| startDate | Belirli bir tarihten sonraki siparişleri getirir. Timestamp (milliseconds) ve GMT +3 olarak gönderilmelidir. | long | |
| endDate | Belirtilen tarihe kadar olan siparişleri getirir. Timestamp (milliseconds) ve GMT +3 olarak gönderilmelidir. | long | |
| page | Sadece belirtilen sayfadaki bilgileri döndürür | int | |
| size | Maksimum 200 | Bir sayfada listelenecek maksimum adeti belirtir. | int |
| supplierId | İlgili tedarikçinin ID bilgisi gönderilmelidir | long | |
| orderNumber | Sadece belirli bir sipariş numarası verilerek o siparişin bilgilerini getirir | string | |
| status | Created, Picking, Invoiced, Shipped ,Cancelled, Delivered, UnDelivered, Returned, AtCollectionPoint, UnPacked, UnSupplied | Siparişlerin statülerine göre bilgileri getirir. | string |
| orderByField | PackageLastModifiedDate | Son güncellenme tarihini baz alır. | string |
| orderByDirection | ASC | Eskiden yeniye doğru sıralar. | string |
| orderByDirection | DESC | Yeniden eskiye doğru sıralar. | string |
| shipmentPackageIds | Paket numarasıyla sorgu atılır. | lon |
Örnek Servis Cevabı
{
"totalElements": 1,
"totalPages": 1,
"page": 0,
"size": 1,
"content": [
{
"shipmentAddress": {
"id": 11111111,
"firstName": "Trendyol",
"lastName": "Customer",
"company": "",
"address1": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul",
"address2": "",
"city": "İstanbul",
"cityCode": 34,
"district": "Sarıyer",
"districtId": 54,
"countyId": 0, // CEE bölgesi için gelecektir.
"countyName": "", // CEE bölgesi için gelecektir.
"shortAddress": "", // GULF bölgesi için gelecektir.
"stateName": "", // GULF bölgesi için gelecektir.
"addressLines": {
"addressLine1": "",
"addressLine2": ""
},
"postalCode": "34200",
"countryCode": "TR",
"neighborhoodId": 21111,
"neighborhood": "Maslak Mahallesi",
"phone": null,
"fullAddress": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul",
"fullName": "Trendyol Customer"
},
"orderNumber": "10654411111",
"grossAmount": 498.90,
"packageGrossAmount": 498.90,
"totalDiscount": 0.00,
"packageSellerDiscount": 0.00,
"totalTyDiscount": 0.00, // commercial true olduğu durumda dolu gelebilir, false olduğu durumda 0 dönecektir.
"packageTyDiscount": 0.00, // commercial true olduğu durumda dolu gelebilir, false olduğu durumda 0 dönecektir.
"packageTotalDiscount": 0.00,
"discountDisplays": [
{
"displayName": "Sepette %20 İndirim",
"discountAmount": 100
},
{
"displayName": "Trendyol Plus'a Özel Fiyat",
"discountAmount": 67.2
},
{
"displayName": "Sepette %50 İndirim",
"discountAmount": 500
},
{
"displayName": "Sepette %30 İndirim",
"discountAmount": 60
}
],
"taxNumber": null,
"invoiceAddress": {
"id": 11111112,
"firstName": "Trendyol",
"lastName": "Customer",
"company": "", // GULF bölgesi siparişlerinde boş gelebilir.
"address1": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul",
"address2": "",
"city": "İstanbul",
"cityCode": 0,
"district": "Sarıyer", // GULF bölgesi siparişlerinde boş gelebilir.
"districtId": 54,
"countyId": 0, // CEE bölgesi için gelecektir.
"countyName": "", // CEE bölgesi için gelecektir.
"shortAddress": "", // GULF bölgesi için gelecektir.
"stateName": "", // GULF bölgesi için gelecektir.
"addressLines": {
"addressLine1": "",
"addressLine2": ""
},
"postalCode": "", // GULF bölgesi siparişlerinde boş gelebilir.
"countryCode": "TR",
"neighborhoodId": 0,
"phone": null,
"latitude": "11.111111",
"longitude": "22.222222",
"fullAddress": "DSM Grup Danışmanlık İletişim ve Satış Ticaret A.Ş. Maslak Mahallesi Saat Sokak Spine Tower No:5 İç Kapı No:19 Sarıyer/İstanbul",
"fullName": "Trendyol Customer",
"taxOffice": "Company of OMS's Tax Office", // Kurumsal fatura olmadığı durumda (commercial=false ise) body içerisinde dönmeyecektir.
"taxNumber": "Company of OMS's Tax Number" // Kurumsal fatura olmadığı durumda (commercial=false ise)) body içerisinde dönmeyecektir.
},
"customerFirstName": "Trendyol",
"customerEmail": "[email protected]",
"customerId": 1451111111,
"supplierId": 2738,
"customerLastName": "Customer",
"id": 33301111111,
"shipmentPackageId": 3330111111,
"cargoTrackingNumber": 7280027504111111,
"cargoTrackingLink": "https://tracking.trendyol.com/?id=111111111-1111-1111-1111-11111111",
"cargoSenderNumber": "210090111111",
"cargoProviderName": "Trendyol Express",
"lines": [
{
"quantity": 1,
"salesCampaignId": 11,
"productSize": "Tek Ebat",
"merchantSku": "111111",
"sku": "8683771111111",
"stockCode": "111111",
"productName": "Kuş ve Çiçek Desenli Tepsi - Yeşil / Altın Sarısı - 49 cm, 01SYM134, Tek Ebat",
"productCode": 1239111111,
"contentId": 1239111111,
"productOrigin": "TR",
"merchantId": 2738,
"sellerId": 2738,
"amount": 498.90,
"lineGrossAmount": 498.90,
"discount": 0.00,
"lineTotalDiscount": 0.00,
"lineSellerDiscount": 0.00,
"tyDiscount": 0.00,
"lineTyDiscount": 0.00,
"discountDetails": [
{
"lineItemPrice": 498.90,
"lineItemDiscount": 0.00,
"lineItemSellerDiscount": 0.00,
"lineItemTyDiscount": 0.00
}
],
"currencyCode": "TRY",
"productColor": "Yeşil",
"id": 4765111111,
"lineId": 4765111111,
"vatBaseAmount": 20.00,
"vatRate": 20.00,
"barcode": "8683772071724",
"orderLineItemStatusName": "Delivered",
"price": 498.90,
"lineUnitPrice": 498.90,
"fastDeliveryOptions": [],
"productCategoryId": 2710,
"commission": 13
"cancelledBy": "",
"cancelReason": "",
"cancelReasonCode":
}
],
"orderDate": 1762253333685,
"identityNumber": "11111111111",
"currencyCode": "TRY",
"packageHistories": [
{
"createdDate": 1762242537624,
"status": "Awaiting"
},
{
"createdDate": 1762242543616,
"status": "Created"
},
{
"createdDate": 1762246983623,
"status": "Invoiced"
},
{
"createdDate": 1762246983623,
"status": "Picking"
},
{
"createdDate": 1762352727000,
"status": "Shipped"
},
{
"createdDate": 1762860180000,
"status": "Delivered"
}
],
"shipmentPackageStatus": "Delivered",
"status": "Delivered",
"whoPays": 1, // Eğer satıcı anlaşması ise 1 gelir, trendyol anlaşması ise alan gelmez
"deliveryType": "normal",
"timeSlotId": 0,
"estimatedDeliveryStartDate": 1762858136000,
"estimatedDeliveryEndDate": 1763030936000,
"totalPrice": 498.90,
"packageTotalPrice": 498.90,
"deliveryAddressType": "Shipment",
"agreedDeliveryDate": 1762376340000,
"fastDelivery": false,
"originShipmentDate": 1762242537619,
"lastModifiedDate": 1762865408581,
"commercial": false,
"fastDeliveryType": "",
"deliveredByService": false,
"warehouseId": 372389,
"invoiceLink": "https://efatura01.evidea.com/11111111111",
"micro": true,
"giftBoxRequested": false,
"3pByTrendyol": false,
"etgbNo": "25341453EX025864", // micro true olduğunda etgbNo alanı için bilgi dönecektir.
"etgbDate": 1762646400000, // micro true olduğunda etgbDate alanı için bilgi dönecektir.
"containsDangerousProduct": false, // micro ihracat siparişlerinde satıcıya gelen siparişte paket içerisinde herhangi bir tehlikeli ürün varsa pil, parfüm vb. gibi, true dönecektir.
"cargoDeci": 10,
"isCod": false,
"createdBy": "order-creation", // Paketin nasıl oluşturulduğunu gösterir, "order-creation", "split", "cancel" veya "transfer" olabilir
"originPackageIds": null, // Bu alan iptal veya bölme işlemlerinden sonra doldurulur ve bu işlemlerden sonra ilk paketin packageid'sini verir.
"hsCode": "711111000000" // Bu alan mikro siparişler için string olarak dönecektir.
}
]
}
Paket Statüleri
| Statü | Açıklama |
|---|---|
| orderDate | Müşterinin trendyol.com üzerinde siparişi oluşturduğu zaman dönmektedir. |
| Awaiting | Müşterinin trendyol.com üzerinde siparişi oluşturduktan sonra ödeme onayından bekleyen siparişler için bu statü dönmektedir. (Bu statüdeki siparişler "Created" statüsüne geçene kadar herhangi bir işlem yapmamanız gerekmektedir. Sadece stok güncellemeleri için bu statüyü kullanabilirsiniz.) |
| Created | Sipariş gönderime hazır statüsünde olduğu zaman dönmektedir. |
| Picking | Sizin tarafınızdan iletilebilecek bir statüdür. Siparişi toplamaya başladığınız zaman veya paketi hazırlamaya başladığınız zaman iletebilirsiniz. |
| Invoiced | Siparişin faturasını kestiğiniz zaman bize iletebileceğiniz statüdür. |
| Shipped | Taşıma durumuna geçen siparişler bu statüde belirtilmektedir. |
| AtCollectionPoint | Ürün ilgili PUDO teslimat noktasındadır. Müşterinin PUDO noktasına giderek teslim alması beklenmektedir. |
| Cancelled | İptal edilen siparişlerdir. Unsupplied siparişleri de kapsar. |
| UnPacked | Paketi bölünmüş olan siparişlerdir. |
| Delivered | Teslim edilen siparişlerdir. Bu statüden sonra herhangi bir statü değişikliği yapılamaz. |
| UnDelivered | Sipariş müşteriye ulaştırılamadığı zaman dönen bilgisidir. |
| Returned | Müşteriye ulaşmayan siparişin tedarikçiye geri döndüğü bilgisidir. Bu statüden sonra herhangi bir statü değişikliği yapılamaz |
Sipariş servisinin cevabında bulunan "cargoTrackingNumber" alanındaki sayının ilk 3 rakamı ile ya da "cargoProviderName" alanı ile kargo şirketlerinin ayrımını yapabilirsiniz. İlgili değerlere aşağıdaki tablodan ulaşabilirisiniz.
| Kargo Şirketi | İlk 3 Rakam |
|---|---|
| Trendyol Express | 733 |
| Yurtiçi Kargo | 725 |
| Alternatif Teslimat | 732 |
| PTT Kargo | 734 |
| Horoz Lojistik | 984 -> 16.12.2021 itibari ile 884 olarak dönecektir |
Mikro ihracat siparişleri için ülke kodu bilgileri
| Ülke | Ülke Kodu |
|---|---|
| Suudi Arabistan | SA |
| Birleşik Arap Emirlikleri | AE |
| Katar | QA |
| Kuveyt | KW |
| Umman | OM |
| Bahreyn | BH |
| Azerbaycan | AZ |
| Slovakya | SK |
| Romanya | RO |
| Çekya | CZ |
Updated 2 days ago