| Parametre | Açıklama | Tip | Zorunluluk |
|---|---|---|---|
| x-agentname | Entegratör ismi | string | Evet |
| x-executor-user | İşlemi yapan kişinin email bilgisi | string | Evet |
Trendyol sistemine ilettiğiniz ürünler ile planlanın butik sonrası 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.
NOT 1: Sipariş datası alınırken gelen orderNumber değeri o siparişin Trendyol sistemindeki ana sipariş numarasına karşılık gelmektedir. Aynı seviyede yer alan id değeri de o sipariş numarasına karşılık oluşturulmuş Sipariş Paketini temsil etmektedir.
NOT 2: Herhangi bir sipariş paketi içinde bir ya da birden fazla kalem İptal edilir ise, Sistem tarafından otomatik olarak orderNumber aynı kalmak koşuluyla sipariş paketi bozulur ve yeni bir id değeri ve kargo barkodu oluşturulur.
NOT 3: orderDate kısmında tarih bilgisini sizlere Timestamp (milliseconds) formatında verirken GMT +3 olarak çevirerek size iletiyoruz. Fakat createdDate bilgilerini ise size GMT formatında iletiyoruz. Bu nedenle convert işleminde bu bilgiye dikkat etmeniz gerekmektedir.
NOT 4:
amount alanında 2 adet alınmış barcode1234 barkodlu ürünün her bir tanesinin indirimden önceki fiyatı listelenir.
discount alanında 2 adet alınmış barcode1234 barkodlu ürünün her bir tanesine denk gelen ortalama indirim tutarı listelenir. (Fatura keserken kalem indirimi gösterimi yapan satıcılarımızın bu alanı kullanmaması tavsiye edilir. lineItemDiscount alanını kontrol ediniz.)
price alanında 2 adet alınmış barcode1234 barkodlu ürünün her bir tanesine denk gelen ortalama indirimden sonraki fiyatı listelenir. (Fatura keserken kalem indirimi gösterimi yapan satıcılarımızın bu alanı kullanmaması tavsiye edilir. listeItemPrices alanını kontrol ediniz. )
lineItemPrices alanında ise liste olarak barcode1234 barkodlu ürünün her bir tanesine denk gelen indirimden sonraki gerçek fiyatı listelenir.
lineItemDiscounts alanında ise liste olarak barcode1234 barkodlu ürünün her bir tanesine denk gelen gerçek indirim tutarı listelenir.
NOT 5: Sipariş paketlerinize herhangi bir statü(Picking, Invoiced) beslemeniz durumunda siparişlerinizi çekerken statülerine göre sorgulama yaparak yeni siparişlerinizi daha rahat görüntüleyebilirsiniz.
NOT 6: İptal olan siparişlerinizi çekerken status=Cancelled,UnSupplied parametresini ekleyerek işlem yapabilirsiniz.
NOT 7: Paketi bölünmüş olan siparişlerinizi çekerken status=UnPacked parametresini ekleyerek işlem yapabilirsiniz.
NOT 8: Adres bilgisi address1, address2, apartmentNumber, floor, doorNumber, district, city, addressDescription alanlarını kullanarak oluşturulabilir.
Endpoint : https://api.trendyol.com/integration/oms/instant/v2/sellers/{supplierId}/packages
https://api.trendyol.com/integration/oms/instant/v2/sellers/123456/packages?storeId=164&status=Shipped&status=Delivered&sortDirection=DESC
| Parametre | Parametre Değer | Açıklama | Tip |
|---|---|---|---|
| startDate | Belirli bir tarihten sonraki siparişleri getirir. Timestamp (milliseconds) olarak gönderilmelidir. | long | |
| endDate | Belirtilen tarihe kadar olan siparişleri getirir. Timestamp (milliseconds) 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 | |
| storeId | İlgili şube ID bilgisi gönderilmelidir | long | |
| status | Created, Picking, Invoiced, Shipped ,Cancelled, Delivered,Returned, UnPacked, UnSupplied | Siparişlerin statülerine göre bilgileri getirir. | string |
| sortDirection | ASC | Eskiden yeniye doğru sıralar. | string |
| sortDirection | DESC | Yeniden eskiye doğru sıralar. | string |
{
"totalElements": 779,
"totalPages": 779,
"page": 0,
"size": 1,
"content": [
{
"id": "1000017545775", // packageId
"orderId": "421301447",
"orderNumber": "65398325",
"sellerId": 12345,
"storeId": 156,
"customer": {
"id": 48413462,
"firstName": "Trendyol",
"lastName": "Müşterisi",
"note": "",
"email": "[email protected]"
},
"packageStatus": "Delivered",
"deliveryModel": "GO", // Model 1 için store dönecektir
"zoneId": "",
"scheduleType": "INSTANT",
"timeSlotId": "",
"eta": "20 - 35 dk",
"estimatedDeliveryStartDate": 1623222000000,
"estimatedDeliveryEndDate": 1623225600000,
"shipmentAddress": {
"firstName": "Trendyol",
"lastName": "Müşterisi",
"address1": "Büyükdere Caddesi No 20",
"address2": "",
"city": " İstanbul ",
"cityCode": 34,
"cityId": 133,
"district": "Şişli",
"districtId": 46,
"neighborhoodId": 28591,
"neighborhood": "Maslak Mahallesi",
"apartmentNumber": "7",
"floor": "5",
"doorNumber": "11",
"addressDescription": "bakkalın yanı",
"postalCode": "",
"countryCode": "tr",
"latitude": "40.9835",
"longitude": "28.711422",
"phone": "5555555555",
"identityNumber": "11111111111"
},
"invoiceAddress": {
"firstName": "Trendyol",
"lastName": "Müşterisi",
"address1": "Büyükdere Caddesi No 20",
"address2": "",
"city": " İstanbul ",
"cityCode": 34,
"cityId": 133,
"district": "Şişli",
"districtId": 46,
"neighborhoodId": 28591,
"neighborhood": "Maslak Mah",
"apartmentNumber": "7",
"floor": "5",
"doorNumber": "11",
"addressDescription": "bakkalın yanı",
"postalCode": "",
"countryCode": "tr",
"latitude": "40.9835",
"longitude": "28.711422",
"phone": "5555555555",
"identityNumber": "11111111111"
},
"cargoInfo": {
"trackingLink": "https://hizligonderitakip.trendyol.com/?uuid=84d5c739-6411-45c7-8b0c-eb207eeae9c6",
"providerName": "Trendyol Kurye"
},
"currencyCode": "TRY",
"grossAmount": 28.85,
"totalDiscount": 3.5,
"totalPrice": 25.35,
"lines": [
{
"salesCampaignId": 12345,
"merchantSku": "merchantSku",
"amount": 15.95,
"price": 15.95,
"barcode": "8681324039",
"vatBaseAmount": 8,
"product": {
"name": "Kaymaksız Yoğurt X212800, one size",
"code": 168161819,
"size": "Tek Ebat",
"color": ""
},
"items": [
{
"id": "1004969099", // lineItemId / claim servisinde kullanılır
"packageItemId": "1000055221991", //unsupplied servisinde kullanılır
"isCancelled": false,
"price": 15.95,
"discount": 1.75
}
]
},
{
"salesCampaignId": 12345,
"merchantSku": "MS1113D",
"amount": 12.9,
"price": 12.9,
"barcode": "8682588739",
"vatBaseAmount": 8,
"product": {
"name": "Erik Can 1 kg , one size",
"code": 179587040,
"size": "Tek Ebat",
"color": ""
},
"items": [
{
"id": "1004969098",
"packageItemId": "1000055221990",
"isCancelled": false,
"price": 12.9,
"discount": 1.75
}
]
}
],
"orderDate": 1623187064503,
"lastModifiedDate": 1623224882749
}
]
}
Endpoint: https://api.trendyol.com/integration/oms/instant/v2/sellers/{supplierId}/packages/ids?id={shipmentPackageId}
Endpoint: https://api.trendyol.com/integration/oms/instant/v2/sellers/{supplierId}/packages/order-number/{orderNumber}